Mettre à jour learningContent

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

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. Dans le cas contraire, cette opération remplace les métadonnées du contenu existant.

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

Service global Gouvernement américain L4 Gouvernement américain L5 (DOD) Chine exploitée par 21Vianet

Autorisations

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

Type d’autorisation Autorisations les moins privilégiées Autorisations à privilèges plus élevés
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 en fonction de son ID (clé primaire) :

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

Pour un contenu d’apprentissage spécifique en fonction de 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 les autorisations.
Content-Type application/json. Obligatoire.

Corps de la demande

Dans le corps de la demande, fournissez uniquement les valeurs des propriétés à mettre à 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. Facultatif.
contentWebUrl String URL web du contenu d’apprentissage. Obligatoire.
contributeurs String collection Les auteurs, les créateurs ou les contributeurs du contenu d’apprentissage. Facultatif.
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. Facultatif.
description String Description ou résumé du contenu d’apprentissage. Facultatif.
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. Facultatif.
externalId String ID de contenu externe unique pour le contenu d’apprentissage. Obligatoire.
format String Format du contenu d’apprentissage. Par exemple, Course, , Video, Book SummaryBook, , Audiobook Summary. Facultatif.
Level (Niveau) Level Niveau de difficulté du contenu d’apprentissage. Les valeurs possibles sont Beginner, Intermediate, Advanced. Facultatif.
isActive Booléen 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. Facultatif.
isPremium Booléen Indique si le contenu d’apprentissage nécessite ou non la connexion de l’utilisateur sur la plateforme du fournisseur d’apprentissage. La valeur par défaut est false. Facultatif.
is_searchable Booléen Indique si le contenu d’apprentissage peut faire l’objet d’une recherche ou non. La valeur par défaut est true. Facultatif.
balise de langue String 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. Facultatif.
numberOfPages Int32 Nombre de pages du contenu d’apprentissage, par exemple. 9 Facultatif.
Étiquettes de compétence String collection Balises de compétences associées au contenu d’apprentissage. Facultatif.
sourceName String Nom de la source du contenu d’apprentissage, par exemple ou LinkedIn LearningCoursera. Facultatif.
thumbnailWebUrl String URL de l’image miniature du contenu d’apprentissage. Facultatif.
title String Titre du contenu d’apprentissage. Obligatoire.

Réponse

En cas de réussite, 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 demande 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/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
}

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/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
}

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

L’exemple suivant montre une demande 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/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
}

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/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
}