learningContent aktualisieren

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Aktualisieren Sie die angegebene learningContent-Ressource .

Wird von einem Lernanbieter verwendet, um die Metadaten für seine Inhalte in Viva Learning zu erfassen oder zu aktualisieren. Wenn der angegebene Lerninhalt für den angegebenen Anbieter noch nicht vorhanden ist, erstellt dieser Vorgang die Metadaten für den neuen Inhalt. Andernfalls werden durch diesen Vorgang die Metadaten des vorhandenen Inhalts ersetzt.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Weltweiter Service US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) Nicht unterstützt Nicht unterstützt
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Application LearningContent.ReadWrite.All Nicht verfügbar.

HTTP-Anforderung

Für einen bestimmten Lerninhalt anhand seiner ID (Primärschlüssel):

PATCH /employeeExperience/learningProviders/{learningProviderId}/learningContents/{learningContentId}

Für einen bestimmten Lerninhalt basierend auf seiner externen ID (sekundärer Schlüssel):

PATCH /employeeExperience/learningProviders/{learningProviderId}/learningContents(externalId='{externalId}') 

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext nur die Werte für die zu aktualisierenden Eigenschaften an. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte bei oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet.

In der folgenden Tabelle sind die Eigenschaften angegeben, die aktualisiert werden können.

Eigenschaft Typ Beschreibung
additionalTags String collection Schlüsselwörter, Themen und andere Tags, die dem Lerninhalt zugeordnet sind. Optional.
contentWebUrl Zeichenfolge Die Inhaltsweb-URL für den Lerninhalt. Erforderlich.
Mitwirkende String collection Die Autoren, Ersteller oder Mitwirkenden der Lerninhalte. Optional.
createdDateTime DateTimeOffset Das Datum und die Uhrzeit, zu der der Lerninhalt erstellt wurde. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z. Optional.
description Zeichenfolge Die Beschreibung oder Zusammenfassung des Lerninhalts. Optional.
Dauer Dauer Die Dauer des Lerninhalts in Sekunden. Der Wert wird im ISO 8601-Format für die Dauer dargestellt. Optional.
externalId Zeichenfolge Eindeutige externe Inhalts-ID für den Lerninhalt. Erforderlich.
Format Zeichenfolge Das Format des Lerninhalts. Beispielsweise Course, Video, , Book, Book Summary. Audiobook Summary Optional.
Ebene Ebene Der Schwierigkeitsgrad des Lerninhalts. Die möglichen Werte sind: Beginner, Intermediate, Advanced. Optional.
isActive Boolean Gibt an, ob der Inhalt aktiv ist oder nicht. Inaktive Inhalte werden nicht auf der Benutzeroberfläche angezeigt. Der Standardwert ist true. Optional.
isPremium Boolean Gibt an, ob der Benutzer sich für den Lerninhalt auf der Lernanbieterplattform anmelden muss. Der Standardwert ist false. Optional.
isSearchable Boolean Gibt an, ob der Lerninhalt durchsuchbar ist. Der Standardwert ist true. Optional.
languageTag Zeichenfolge Die Sprache des Lerninhalts zum Beispiel, en-us oder fr-fr. Erforderlich.
lastModifiedDateTime DateTimeOffset Das Datum und die Uhrzeit, zu der der Lerninhalt zuletzt geändert wurde. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z. Optional.
numberOfPages Int32 Die Anzahl der Seiten des Lerninhalts, z. B 9. Optional.
skillTags String collection Die Skills-Tags, die dem Lerninhalt zugeordnet sind. Optional.
sourceName Zeichenfolge Der Quellenname des Lerninhalts, z. B LinkedIn Learning . oder Coursera. Optional.
thumbnailWebUrl Zeichenfolge Die URL des Miniaturbilds des Lerninhalts. Optional.
title String Der Titel des Lerninhalts. Erforderlich.

Antwort

Bei erfolgreicher Ausführung gibt diese Methode einen 202 Accepted Antwortcode und ein aktualisiertes learningContent-Objekt im Antworttext zurück.

Beispiele

Beispiel 1: Aktualisieren der Metadaten eines Lerninhalts basierend auf seiner ID

Das folgende Beispiel zeigt eine Anforderung, die die Metadaten eines Lerninhalts basierend auf seiner ID (Primärschlüssel) aktualisiert.

Anforderung

Das folgende Beispiel zeigt die Antwort.

PATCH https://graph.microsoft.com/beta/employeeExperience/learningProviders/13727311-e7bb-470d-8b20-6a23d9030d70/learningContents/77029588-a660-46b6-ba58-3ce4d21d5678
Content-Type: application/json

{
    "title": "Manage classes, resources, assessment, and planning in Microsoft Teams with Beedle",
    "description": "A module to guide users through the various teaching and learning enhancements that Beedle provides within Microsoft Teams, with many examples of everyday application.",
    "contentWebUrl": "https://learn.microsoft.com/learn/modules/manage-classes-resources-assessment-planning-beedle/",
    "sourceName": "MsLearn",
    "thumbnailWebUrl": "https://syndetics.com/index.aspx?isbn=9783319672175/LC.GIF",
    "languageTag": "en-us",
    "numberOfPages": 9,
    "duration": "PT20M",
    "format": "Book",
    "level": "Beginner",
    "createdDateTime": "2018-01-01T00:00:00Z",
    "lastModifiedDateTime": "2021-04-01T04:26:06.1995367Z",
    "contributors": ["Scott Simpson"],
    "additionalTags": [
        "Create private or public teams",
        "Add members to teams"
    ],
    "skillTags": [
        "Create teams",
        "Teams channels",
        "Teams members"
    ],
    "isActive": true,
    "isPremium": false,
    "isSearchable": true
}

Antwort

Das folgende Beispiel zeigt die Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 202 Accepted
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#learningProviders('13727311-e7bb-470d-8b20-6a23d9030d70')/learningContents/$entity",
    "id": "77029588-a660-46b6-ba58-3ce4d21d5678",
    "externalId": "LP4471",
    "title": "Manage classes, resources, assessment, and planning in Microsoft Teams with Beedle",
    "description": "A module to guide users through the various teaching and learning enhancements that Beedle provides within Microsoft Teams, with many examples of everyday application.",
    "contentWebUrl": "https://learn.microsoft.com/learn/modules/manage-classes-resources-assessment-planning-beedle/",
    "sourceName": "MsLearn",
    "thumbnailWebUrl": "https://syndetics.com/index.aspx?isbn=9783319672175/LC.GIF",
    "languageTag": "en-us",
    "numberOfPages": 9,
    "duration": "PT20M",
    "format": "Book",
    "level": "Beginner",
    "createdDateTime": "2018-01-01T00:00:00",
    "lastModifiedDateTime": "2021-04-01T04:26:06.1995367Z",
    "contributors": [
      "Lina Wagner",
      "Lisa Richter"
    ],
    "additionalTags": [
        "Create private or public teams",
        "Add members to teams"
    ],
    "skillTags": [
        "Create teams",
        "Teams channels",
        "Teams members"
    ],
    "isActive": true,
    "isPremium": false,
    "isSearchable": true
}

Beispiel 2: Aktualisieren der Metadaten eines Lerninhalts auf der Grundlage seiner externen ID

Das folgende Beispiel zeigt eine Anforderung, die die Metadaten eines Lerninhalts basierend auf seiner externen ID (sekundärem Schlüssel) aktualisiert.

Anforderung

Das folgende Beispiel zeigt die Antwort.

PATCH https://graph.microsoft.com/beta/employeeExperience/learningProviders/13727311-e7bb-470d-8b20-6a23d9030d70/learningContents(externalId='LP4471') 
Content-Type: application/json

{
    "title": "Manage classes, resources, assessment, and planning in Microsoft Teams with Beedle",
    "description": "A module to guide users through the various teaching and learning enhancements that Beedle provides within Microsoft Teams, with many examples of everyday application.",
    "contentWebUrl": "https://learn.microsoft.com/learn/modules/manage-classes-resources-assessment-planning-beedle/",
    "sourceName": "MsLearn",
    "thumbnailWebUrl": "https://syndetics.com/index.aspx?isbn=9783319672175/LC.GIF",
    "languageTag": "en-us",
    "numberOfPages": 9,
    "duration": "PT20M",
    "format": "Book",
    "level": "Beginner",
    "createdDateTime": "2018-01-01T00:00:00",
    "lastModifiedDateTime": "2021-04-01T04:26:06.1995367Z",
    "contributor": "Scott Simpson",
    "additionalTags": [
        "Create private or public teams",
        "Add members to teams"
    ],
    "skillTags": [
        "Create teams",
        "Teams channels",
        "Teams members"
    ],
    "isActive": true,
    "isPremium": false,
    "isSearchable": true
}

Antwort

Das folgende Beispiel zeigt die Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 202 Accepted
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#learningProviders('13727311-e7bb-470d-8b20-6a23d9030d70')/learningContents/$entity",
    "id": "77029588-a660-46b6-ba58-3ce4d21d5678",
    "externalId": "LP4471",
    "title": "Manage classes, resources, assessment, and planning in Microsoft Teams with Beedle",
    "description": "A module to guide users through the various teaching and learning enhancements that Beedle provides within Microsoft Teams, with many examples of everyday application.",
    "contentWebUrl": "https://learn.microsoft.com/learn/modules/manage-classes-resources-assessment-planning-beedle/",
    "sourceName": "MsLearn",
    "thumbnailWebUrl": "https://syndetics.com/index.aspx?isbn=9783319672175/LC.GIF",
    "languageTag": "en-us",
    "numberOfPages": 9,
    "duration": "PT20M",
    "format": "Book",
    "level": "Beginner",
    "createdDateTime": "2018-01-01T00:00:00",
    "lastModifiedDateTime": "2021-04-01T04:26:06.1995367Z",
    "contributors": [
        "Lina Wagner",
        "Lisa Richter"
    ],
    "additionalTags": [
        "Create private or public teams",
        "Add members to teams"
    ],
    "skillTags": [
        "Create teams",
        "Teams channels",
        "Teams members"
    ],
    "isActive": true,
    "isPremium": false,
    "isSearchable": true
}