Mettre à jour learningContent

Espace de noms: microsoft.graph

Mettez à jour la ressource learningContent spécifiée.

Utilisé par un fournisseur d’apprentissage pour ingérer ou mettre à jour les métadonnées de son contenu dans Viva Learning. Si le contenu d’apprentissage spécifié n’existe pas encore pour le fournisseur spécifié, cette opération crée les métadonnées du nouveau contenu. Sinon, cette opération remplace les métadonnées du contenu existant.

Cette API est disponible dans les déploiements de cloud national suivants.

Service global Gouvernement des États-Unis L4 Us Government L5 (DOD) Chine gérée par 21Vianet

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.

Type d’autorisation Autorisations avec privilèges minimum Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire) Non prise en charge. Non prise en charge.
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application LearningContent.ReadWrite.All Non disponible.

Requête HTTP

Pour un contenu d’apprentissage spécifique basé sur son ID (clé primaire) :

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

Pour un contenu d’apprentissage spécifique basé sur son ID externe (clé secondaire) :

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

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.
Content-Type application/json. Obligatoire.

Corps de la demande

Dans le corps de la demande, fournissez uniquement les valeurs des propriétés qui doivent être mises à jour. Les propriétés existantes qui ne sont pas incluses dans le corps de la demande conservent leurs valeurs précédentes ou sont recalculées en fonction des modifications apportées à d’autres valeurs de propriété.

Le tableau suivant spécifie les propriétés qui peuvent être mises à jour.

Propriété Type Description
additionalTags String collection Mots clés, rubriques et autres balises associés au contenu d’apprentissage. Optional.
contentWebUrl Chaîne URL web de contenu pour le contenu d’apprentissage. Obligatoire.
contributeurs String collection Les auteurs, les créateurs ou les contributeurs du contenu d’apprentissage. Optional.
createdDateTime DateTimeOffset Date et heure de création du contenu d’apprentissage. Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z. Optional.
description Chaîne Description ou résumé du contenu d’apprentissage. Optional.
durée Durée Durée du contenu d’apprentissage en secondes. La valeur est représentée au format ISO 8601 pour les durées. Optional.
externalId Chaîne ID de contenu externe unique pour le contenu d’apprentissage. Obligatoire.
format Chaîne Format du contenu d’apprentissage. Par exemple, Course, Video, Book, Book Summary, Audiobook Summary. Optional.
Niveau Niveau Niveau de difficulté du contenu d’apprentissage. Les valeurs possibles sont Beginner, Intermediate et Advanced. Optional.
isActive Valeur booléenne Indique si le contenu est actif ou non. Le contenu inactif n’apparaît pas dans l’interface utilisateur. La valeur par défaut est true. Optional.
isPremium Valeur booléenne Indique si le contenu d’apprentissage exige que l’utilisateur se connecte ou non à la plateforme du fournisseur d’apprentissage. La valeur par défaut est false. Optional.
isSearchable Valeur booléenne Indique si le contenu d’apprentissage peut faire l’objet d’une recherche ou non. La valeur par défaut est true. Optional.
languageTag Chaîne Langue du contenu d’apprentissage, par exemple, en-us ou fr-fr. Obligatoire.
lastModifiedDateTime DateTimeOffset Date et heure de la dernière modification du contenu d’apprentissage. Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z. Optional.
numberOfPages Int32 Nombre de pages du contenu d’apprentissage, par exemple . 9 Optional.
skillTags String collection Étiquettes de compétences associées au contenu d’apprentissage. Optional.
Sourcename Chaîne Nom source du contenu d’apprentissage, par LinkedIn Learning exemple ou Coursera. Optional.
thumbnailWebUrl Chaîne URL de l’image miniature du contenu d’apprentissage. Optional.
title Chaîne Titre du contenu d’apprentissage. Obligatoire.

Réponse

Si elle réussit, cette méthode renvoie un 202 Accepted code de réponse et un objet learningContent mis à jour dans le corps de la réponse.

Exemples

Exemple 1 : Mettre à jour les métadonnées d’un contenu d’apprentissage en fonction de son ID

L’exemple suivant montre une requête qui met à jour les métadonnées d’un contenu d’apprentissage en fonction de son ID (clé primaire).

Demande

L’exemple suivant illustre la demande.

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
}

Réponse

L’exemple suivant illustre la réponse.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

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
}

Exemple 2 : Mettre à jour les métadonnées d’un contenu d’apprentissage en fonction de son ID externe

L’exemple suivant montre une requête qui met à jour les métadonnées d’un contenu d’apprentissage en fonction de son ID externe (clé secondaire).

Demande

L’exemple suivant illustre la demande.

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
}

Réponse

L’exemple suivant illustre la réponse.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

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
}