Atualizar learningContent

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Atualize o recurso learningContent especificado.

Utilizado por um fornecedor de aprendizagem para ingerir ou atualizar os metadados dos respetivos conteúdos no Viva Learning. Se o conteúdo de aprendizagem especificado ainda não existir para o fornecedor especificado, esta operação cria os metadados para o novo conteúdo. Caso contrário, esta operação substitui os metadados do conteúdo existente.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global US Government L4 US Government L5 (DOD) China operada pela 21Vianet

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão Permissões com menos privilégios Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante) Sem suporte. Sem suporte.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application LearningContent.ReadWrite.All Indisponível.

Solicitação HTTP

Para um conteúdo de aprendizagem específico com base no respetivo ID (chave primária):

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

Para um conteúdo de aprendizagem específico com base no respetivo ID externo (chave secundária):

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

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type application/json. Obrigatório.

Corpo da solicitação

No corpo do pedido, forneça apenas os valores das propriedades a atualizar. As propriedades existentes que não estão incluídas no corpo do pedido mantêm os valores anteriores ou são recalculadas com base em alterações a outros valores de propriedade.

A tabela a seguir especifica as propriedades que podem ser atualizadas.

Propriedade Tipo Descrição
additionalTags Coleção String Palavras-chave, tópicos e outras etiquetas associadas ao conteúdo de aprendizagem. Opcional.
contentWebUrl Cadeia de caracteres O URL web de conteúdo para o conteúdo de aprendizagem. Obrigatório.
colaboradores Coleção String Os autores, criadores ou contribuidores do conteúdo de aprendizagem. Opcional.
createdDateTime DateTimeOffset A data e hora em que o conteúdo de aprendizagem foi criado. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z. Opcional.
description Cadeia de caracteres A descrição ou resumo do conteúdo de aprendizagem. Opcional.
duração Duração A duração do conteúdo de aprendizagem em segundos. O valor é representado no formato ISO 8601 durante durações. Opcional.
externalId Cadeia de caracteres ID de conteúdo externo exclusivo para o conteúdo de aprendizagem. Obrigatório.
format Cadeia de caracteres O formato do conteúdo de aprendizagem. Por exemplo, Course, Video, Book, Book Summary, Audiobook Summary. Opcional.
nível Nível O nível de dificuldade do conteúdo de aprendizagem. Os valores possíveis são: Beginner, Intermediate, Advanced. Opcional.
isActive Booliano Indica se o conteúdo está ativo ou não. Os conteúdos inativos não são apresentados na IU. O valor padrão é true. Opcional.
isPremium Booliano Indica se o conteúdo de aprendizagem requer ou não que o utilizador inicie sessão na plataforma do fornecedor de aprendizagem. O valor padrão é false. Opcional.
isSearchable Booliano Indica se o conteúdo de aprendizagem é pesquisável ou não. O valor padrão é true. Opcional.
languageTag Cadeia de caracteres O idioma do conteúdo de aprendizagem, por exemplo, en-us ou fr-fr. Obrigatório.
lastModifiedDateTime DateTimeOffset A data e hora em que o conteúdo de aprendizagem foi modificado pela última vez. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z. Opcional.
numberOfPages Int32 O número de páginas do conteúdo de aprendizagem, por exemplo, 9. Opcional.
skillTags Coleção String As etiquetas de competências associadas ao conteúdo de aprendizagem. Opcional.
sourceName Cadeia de caracteres O nome de origem do conteúdo de aprendizagem, como LinkedIn Learning ou Coursera. Opcional.
thumbnailWebUrl Cadeia de caracteres O URL da imagem em miniatura de conteúdo de aprendizagem. Opcional.
title Cadeia de caracteres O título do conteúdo de aprendizagem. Obrigatório.

Resposta

Se for bem-sucedido, este método devolve um 202 Accepted código de resposta e um objeto learningContent atualizado no corpo da resposta.

Exemplos

Exemplo 1: Atualizar os metadados de um conteúdo de aprendizagem com base no respetivo ID

O exemplo seguinte mostra um pedido que atualiza os metadados de um conteúdo de aprendizagem com base no respetivo ID (chave primária).

Solicitação

O exemplo a seguir mostra a solicitação.

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://video2.skills-academy.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
}

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

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://video2.skills-academy.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
}

Exemplo 2: Atualizar os metadados de um conteúdo de aprendizagem com base no respetivo ID externo

O exemplo seguinte mostra um pedido que atualiza os metadados de um conteúdo de aprendizagem com base no respetivo ID externo (chave secundária).

Solicitação

O exemplo a seguir mostra a solicitação.

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://video2.skills-academy.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
}

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

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://video2.skills-academy.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
}