Aktualisieren von learningContent

Namespace: microsoft.graph

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 ersetzt dieser Vorgang die Metadaten des vorhandenen Inhalts.

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

Globaler Dienst US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

Berechtigungen

Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. 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
Anwendung LearningContent.ReadWrite.All Nicht verfügbar.

HTTP-Anforderung

Für einen bestimmten Lerninhalt basierend auf 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 die Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext nur die Werte für die Eigenschaften an, die aktualisiert werden sollen. 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 Zeichenfolgensammlung Schlüsselwörter, Themen und andere Tags, die den Lerninhalten zugeordnet sind. Optional.
contentWebUrl String Die Inhaltsweb-URL für die Lerninhalte. Erforderlich.
Mitwirkende String-Sammlung Die Autoren, Ersteller oder Mitwirkenden der Lerninhalte. Optional.
createdDateTime DateTimeOffset Das Datum und die Uhrzeit der Erstellung des Lerninhalts. 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 String Die Beschreibung oder Zusammenfassung für den Lerninhalt. Optional.
Dauer Dauer Die Dauer des Lerninhalts in Sekunden. Der Wert wird für die Dauer im ISO 8601-Format dargestellt. Optional.
externalId String Eindeutige externe Inhalts-ID für die Lerninhalte. Erforderlich.
Format String Das Format des Lerninhalts. Beispiel: Course, Video, Book, Book Summary, , . Audiobook Summary Optional.
Ebene Ebene Der Schwierigkeitsgrad der Lerninhalte. Mögliche Werte sind: Beginner, Intermediate und Advanced. Optional.
isActive Boolesch Gibt an, ob der Inhalt aktiv ist oder nicht. Inaktive Inhalte werden auf der Benutzeroberfläche nicht angezeigt. Der Standardwert ist true. Optional.
isPremium Boolesch Gibt an, ob sich der Benutzer für die Lerninhalte bei der Lernanbieterplattform anmelden muss oder nicht. Der Standardwert ist false. Optional.
isSearchable Boolesch Gibt an, ob die Lerninhalte durchsuchbar sind oder nicht. Der Standardwert ist true. Optional.
languageTag String Die Sprache des Lerninhalts, z. B en-us . oder fr-fr. Erforderlich.
lastModifiedDateTime DateTimeOffset Datum und Uhrzeit der letzten Änderung des Lerninhalts. 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 9, z. B. . Optional.
skillTags String collection Die dem Lerninhalt zugeordneten Qualifikationstags. Optional.
Sourcename String Der Quellname des Lerninhalts, z LinkedIn Learning . B. oder Coursera. Optional.
thumbnailWebUrl String Die URL der Miniaturansicht des Lerninhalts. Optional.
title String Der Titel des Lerninhalts. Erforderlich.

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 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/v1.0/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": [
      "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
}

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/v1.0/$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 basierend auf seiner externen ID

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

Anforderung

Das folgende Beispiel zeigt die Antwort.

PATCH  https://graph.microsoft.com/v1.0/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",
    "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
}

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/v1.0/$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
}