Compartir a través de

Actualizar learningContent

  • Artículo

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Actualice el recurso learningContent especificado.

Lo usa un proveedor de aprendizaje para ingerir o actualizar los metadatos de su contenido en Viva Learning. Si el contenido de aprendizaje especificado aún no existe para el proveedor especificado, esta operación crea los metadatos para el nuevo contenido. De lo contrario, esta operación reemplaza los metadatos del contenido existente.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet
✅ ❌ ❌ ❌

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) No admitida. No admitida.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación LearningContent.ReadWrite.All No disponible.

Solicitud HTTP

Para un contenido de aprendizaje específico basado en su identificador (clave principal):

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

Para un contenido de aprendizaje específico basado en su identificador externo (clave secundaria):

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

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Content-Type application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione solo los valores de las propiedades que se van a actualizar. Las propiedades existentes que no se incluyen en el cuerpo de la solicitud mantienen sus valores anteriores o se recalculan en función de los cambios realizados en otros valores de propiedad.

En la tabla siguiente se especifican las propiedades que se pueden actualizar.

Propiedad Tipo Descripción
additionalTags Colección string Palabras clave, temas y otras etiquetas asociadas al contenido de aprendizaje. Opcional.
contentWebUrl Cadena Dirección URL web de contenido del contenido de aprendizaje. Obligatorio.
colaboradores Colección de cadenas Los autores, creadores o colaboradores del contenido de aprendizaje. Opcional.
createdDateTime DateTimeOffset Fecha y hora en que se creó el contenido de aprendizaje. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y está siempre en hora UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z. Opcional.
description Cadena Descripción o resumen del contenido de aprendizaje. Opcional.
duration Duración Duración del contenido de aprendizaje en segundos. El valor se representa en formato ISO 8601 para las duraciones. Opcional.
externalId Cadena Identificador de contenido externo único para el contenido de aprendizaje. Obligatorio.
format Cadena Formato del contenido de aprendizaje. Por ejemplo, Course, Video, Book, , Book Summary, Audiobook Summary. Opcional.
nivel Nivel Nivel de dificultad del contenido de aprendizaje. Los valores posibles son: Beginner, Intermediate y Advanced. Opcional.
isActive Booleano Indica si el contenido está activo o no. El contenido inactivo no aparece en la interfaz de usuario. El valor predeterminado es true. Opcional.
isPremium Booleano Indica si el contenido de aprendizaje requiere que el usuario inicie sesión en la plataforma del proveedor de aprendizaje o no. El valor predeterminado es false. Opcional.
isSearchable Booleano Indica si el contenido de aprendizaje se puede buscar o no. El valor predeterminado es true. Opcional.
languageTag Cadena Idioma del contenido de aprendizaje, por ejemplo, en-us o fr-fr. Obligatorio.
lastModifiedDateTime DateTimeOffset Fecha y hora en que se modificó por última vez el contenido de aprendizaje. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y está siempre en hora UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z. Opcional.
numberOfPages Int32 Número de páginas del contenido de aprendizaje, por ejemplo, 9. Opcional.
skillTags Colección de cadenas Etiquetas de aptitudes asociadas al contenido de aprendizaje. Opcional.
sourceName Cadena Nombre de origen del contenido de aprendizaje, como LinkedIn Learning o Coursera. Opcional.
thumbnailWebUrl Cadena Dirección URL de la imagen en miniatura del contenido de aprendizaje. Opcional.
title Cadena Título del contenido de aprendizaje. Obligatorio.

Respuesta

Si se ejecuta correctamente, este método devuelve un 202 Accepted código de respuesta y un objeto learningContent actualizado en el cuerpo de la respuesta.

Ejemplos

Ejemplo 1: Actualización de los metadatos de un contenido de aprendizaje en función de su identificador

En el ejemplo siguiente se muestra una solicitud que actualiza los metadatos de un contenido de aprendizaje en función de su identificador (clave principal).

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

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
}

Ejemplo 2: Actualización de los metadatos de un contenido de aprendizaje en función de su identificador externo

En el ejemplo siguiente se muestra una solicitud que actualiza los metadatos de un contenido de aprendizaje en función de su identificador externo (clave secundaria).

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

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
}