Freigeben über


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.

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 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 Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext nur die Werte für zu aktualisierende 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 den Lerninhalten zugeordnet sind. Optional.
contentWebUrl Zeichenfolge Die Inhaltsweb-URL für die Lerninhalte. Erforderlich.
Mitwirkende String collection 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 Zeichenfolge 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 Zeichenfolge Eindeutige externe Inhalts-ID für die Lerninhalte. Erforderlich.
Format Zeichenfolge Das Format des Lerninhalts. Beispiel: Course, Video, Book, Book Summary, , . Audiobook Summary Optional.
Niveau Ebene Der Schwierigkeitsgrad der Lerninhalte. Die möglichen Werte sind: Beginner, Intermediate, Advanced. Optional.
isActive Boolean Gibt an, ob der Inhalt aktiv ist oder nicht. Inaktive Inhalte werden auf der Benutzeroberfläche nicht angezeigt. Der Standardwert ist true. Optional.
isPremium Boolean Gibt an, ob sich der Benutzer für die Lerninhalte bei der Lernanbieterplattform anmelden muss oder nicht. Der Standardwert ist false. Optional.
isSearchable Boolean Gibt an, ob die Lerninhalte durchsuchbar sind oder nicht. Der Standardwert ist true. Optional.
languageTag Zeichenfolge 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 Zeichenfolge Der Quellname des Lerninhalts, z LinkedIn Learning . B. oder Coursera. Optional.
thumbnailWebUrl Zeichenfolge 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
}