更新 learningContent

2024-04-25

命名空间：microsoft.graph

更新指定的 learningContent 资源。

由学习提供程序用来引入或更新Viva Learning中内容的元数据。如果指定提供程序的指定学习内容尚不存在，此操作会为新内容创建元数据。否则，此操作将替换现有内容的元数据。

全局服务	美国政府 L4	美国政府 L5 (DOD)	由世纪互联运营的中国
✅	❌	❌	❌

权限

为此 API 选择标记为最低特权的权限。只有在应用需要它时，才使用更高的特权权限。有关委派权限和应用程序权限的详细信息，请参阅权限类型。要了解有关这些权限的详细信息，请参阅权限参考。

权限类型	最低特权权限	更高特权权限
委派（工作或学校帐户）	不支持。	不支持。
委派（个人 Microsoft 帐户）	不支持。	不支持。
应用程序	LearningContent.ReadWrite.All	不可用。

HTTP 请求

对于基于其 ID 的特定学习内容 (主键) ：

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

对于基于其外部 ID 的特定学习内容 (辅助密钥) ：

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

请求标头

名称	说明
Authorization	持有者 {token}。必填。详细了解身份验证和授权。
Content-Type	application/json. 必需。

请求正文

在请求正文中，仅提供要更新的属性的值。请求正文中未包含的现有属性会保留其以前的值，或者根据对其他属性值的更改重新计算。

下表指定可更新的属性。

属性	类型	说明
additionalTags	字符串集合	与学习内容关联的关键字、主题和其他标记。可选。
contentWebUrl	String	学习内容的内容 Web URL。必填。
参与者	字符串集合	学习内容的作者、创建者或参与者。可选。
createdDateTime	DateTimeOffset	创建学习内容的日期和时间。时间戳类型表示采用 ISO 8601 格式的日期和时间信息，始终采用 UTC 时区。例如，2014 年 1 月 1 日午夜 UTC 为 `2014-01-01T00:00:00Z`。可选。
说明	String	学习内容的说明或摘要。可选。
duration	持续时间	学习内容的持续时间（以秒为单位）。该值在持续时间内以 ISO 8601 格式表示。可选。
externalId	String	学习内容的唯一外部内容 ID。必填。
format	String	学习内容的格式。例如， `Course`、 `Video`、 `Book`、 `Book Summary`、 `Audiobook Summary`。可选。
水平	级别	学习内容的难度级别。可取值为：`Beginner`、`Intermediate`、`Advanced`。可选。
isActive	布尔值	指示内容是否处于活动状态。非活动内容不会显示在 UI 中。默认值为 `true`。可选。
isPremium	布尔值	指示学习内容是否要求用户在学习提供程序平台上登录。默认值为 `false`。可选。
isSearchable	布尔值	指示学习内容是否可搜索。默认值为 `true`。可选。
languageTag	String	学习内容的语言，例如 `en-us` 或 `fr-fr`。必需。
lastModifiedDateTime	DateTimeOffset	上次修改学习内容的日期和时间。时间戳类型表示采用 ISO 8601 格式的日期和时间信息，始终采用 UTC 时区。例如，2014 年 1 月 1 日午夜 UTC 为 `2014-01-01T00:00:00Z`。可选。
numberOfPages	Int32	学习内容的页数，例如 `9`。可选。
skillTags	字符串集合	与学习内容关联的技能标记。可选。
sourceName	String	学习内容的源名称，例如 `LinkedIn Learning` 或 `Coursera`。可选。
thumbnailWebUrl	String	学习内容缩略图图像的 URL。可选。
title	String	学习内容的标题。必填。

响应

如果成功，此方法在响应正文中返回响应 202 Accepted 代码和更新的 learningContent 对象。

示例

示例 1：根据学习内容的 ID 更新其元数据

以下示例显示了一个请求，该请求根据学习内容的 ID (主键) 更新其元数据。

请求

下面为请求示例。

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
}


// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Models;

var requestBody = new LearningContent
{
	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 = TimeSpan.Parse("PT20M"),
	Format = "Book",
	Level = Level.Beginner,
	CreatedDateTime = DateTimeOffset.Parse("2018-01-01T00:00:00Z"),
	LastModifiedDateTime = DateTimeOffset.Parse("2021-04-01T04:26:06.1995367Z"),
	Contributors = new List<string>
	{
		"Lina Wagner",
		"Lisa Richter",
	},
	AdditionalTags = new List<string>
	{
		"Create private or public teams",
		"Add members to teams",
	},
	SkillTags = new List<string>
	{
		"Create teams",
		"Teams channels",
		"Teams members",
	},
	IsActive = true,
	IsPremium = false,
	IsSearchable = true,
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.EmployeeExperience.LearningProviders["{learningProvider-id}"].LearningContents["{learningContent-id}"].PatchAsync(requestBody);



mgc employee-experience learning-providers learning-contents patch --learning-provider-id {learningProvider-id} --learning-content-id {learningContent-id} --body '{\
    "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\
}\
'



// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  "time"
	  abstractions "github.com/microsoft/kiota-abstractions-go"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
	  //other-imports
)

requestBody := graphmodels.NewLearningContent()
title := "Manage classes, resources, assessment, and planning in Microsoft Teams with Beedle"
requestBody.SetTitle(&title) 
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."
requestBody.SetDescription(&description) 
contentWebUrl := "https://learn.microsoft.com/learn/modules/manage-classes-resources-assessment-planning-beedle/"
requestBody.SetContentWebUrl(&contentWebUrl) 
sourceName := "MsLearn"
requestBody.SetSourceName(&sourceName) 
thumbnailWebUrl := "https://syndetics.com/index.aspx?isbn=9783319672175/LC.GIF"
requestBody.SetThumbnailWebUrl(&thumbnailWebUrl) 
languageTag := "en-us"
requestBody.SetLanguageTag(&languageTag) 
numberOfPages := int32(9)
requestBody.SetNumberOfPages(&numberOfPages) 
duration , err := abstractions.ParseISODuration("PT20M")
requestBody.SetDuration(&duration) 
format := "Book"
requestBody.SetFormat(&format) 
level := graphmodels.BEGINNER_LEVEL 
requestBody.SetLevel(&level) 
createdDateTime , err := time.Parse(time.RFC3339, "2018-01-01T00:00:00Z")
requestBody.SetCreatedDateTime(&createdDateTime) 
lastModifiedDateTime , err := time.Parse(time.RFC3339, "2021-04-01T04:26:06.1995367Z")
requestBody.SetLastModifiedDateTime(&lastModifiedDateTime) 
contributors := []string {
	"Lina Wagner",
	"Lisa Richter",
}
requestBody.SetContributors(contributors)
additionalTags := []string {
	"Create private or public teams",
	"Add members to teams",
}
requestBody.SetAdditionalTags(additionalTags)
skillTags := []string {
	"Create teams",
	"Teams channels",
	"Teams members",
}
requestBody.SetSkillTags(skillTags)
isActive := true
requestBody.SetIsActive(&isActive) 
isPremium := false
requestBody.SetIsPremium(&isPremium) 
isSearchable := true
requestBody.SetIsSearchable(&isSearchable) 

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
learningContents, err := graphClient.EmployeeExperience().LearningProviders().ByLearningProviderId("learningProvider-id").LearningContents().ByLearningContentId("learningContent-id").Patch(context.Background(), requestBody, nil)


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

LearningContent learningContent = new LearningContent();
learningContent.setTitle("Manage classes, resources, assessment, and planning in Microsoft Teams with Beedle");
learningContent.setDescription("A module to guide users through the various teaching and learning enhancements that Beedle provides within Microsoft Teams, with many examples of everyday application.");
learningContent.setContentWebUrl("https://learn.microsoft.com/learn/modules/manage-classes-resources-assessment-planning-beedle/");
learningContent.setSourceName("MsLearn");
learningContent.setThumbnailWebUrl("https://syndetics.com/index.aspx?isbn=9783319672175/LC.GIF");
learningContent.setLanguageTag("en-us");
learningContent.setNumberOfPages(9);
PeriodAndDuration duration = PeriodAndDuration.ofDuration(Duration.parse("PT20M"));
learningContent.setDuration(duration);
learningContent.setFormat("Book");
learningContent.setLevel(Level.Beginner);
OffsetDateTime createdDateTime = OffsetDateTime.parse("2018-01-01T00:00:00Z");
learningContent.setCreatedDateTime(createdDateTime);
OffsetDateTime lastModifiedDateTime = OffsetDateTime.parse("2021-04-01T04:26:06.1995367Z");
learningContent.setLastModifiedDateTime(lastModifiedDateTime);
LinkedList<String> contributors = new LinkedList<String>();
contributors.add("Lina Wagner");
contributors.add("Lisa Richter");
learningContent.setContributors(contributors);
LinkedList<String> additionalTags = new LinkedList<String>();
additionalTags.add("Create private or public teams");
additionalTags.add("Add members to teams");
learningContent.setAdditionalTags(additionalTags);
LinkedList<String> skillTags = new LinkedList<String>();
skillTags.add("Create teams");
skillTags.add("Teams channels");
skillTags.add("Teams members");
learningContent.setSkillTags(skillTags);
learningContent.setIsActive(true);
learningContent.setIsPremium(false);
learningContent.setIsSearchable(true);
LearningContent result = graphClient.employeeExperience().learningProviders().byLearningProviderId("{learningProvider-id}").learningContents().byLearningContentId("{learningContent-id}").patch(learningContent);


const options = {
	authProvider,
};

const client = Client.init(options);

const learningContent = {
    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
};

await client.api('/employeeExperience/learningProviders/13727311-e7bb-470d-8b20-6a23d9030d70/learningContents/77029588-a660-46b6-ba58-3ce4d21d5678')
	.update(learningContent);


<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\LearningContent;
use Microsoft\Graph\Generated\Models\Level;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new LearningContent();
$requestBody->setTitle('Manage classes, resources, assessment, and planning in Microsoft Teams with Beedle');
$requestBody->setDescription('A module to guide users through the various teaching and learning enhancements that Beedle provides within Microsoft Teams, with many examples of everyday application.');
$requestBody->setContentWebUrl('https://learn.microsoft.com/learn/modules/manage-classes-resources-assessment-planning-beedle/');
$requestBody->setSourceName('MsLearn');
$requestBody->setThumbnailWebUrl('https://syndetics.com/index.aspx?isbn=9783319672175/LC.GIF');
$requestBody->setLanguageTag('en-us');
$requestBody->setNumberOfPages(9);
$requestBody->setDuration(new \DateInterval('PT20M'));
$requestBody->setFormat('Book');
$requestBody->setLevel(new Level('beginner'));
$requestBody->setCreatedDateTime(new \DateTime('2018-01-01T00:00:00Z'));
$requestBody->setLastModifiedDateTime(new \DateTime('2021-04-01T04:26:06.1995367Z'));
$requestBody->setContributors(['Lina Wagner', 'Lisa Richter', 	]);
$requestBody->setAdditionalTags(['Create private or public teams', 'Add members to teams', 	]);
$requestBody->setSkillTags(['Create teams', 'Teams channels', 'Teams members', 	]);
$requestBody->setIsActive(true);
$requestBody->setIsPremium(false);
$requestBody->setIsSearchable(true);

$result = $graphServiceClient->employeeExperience()->learningProviders()->byLearningProviderId('learningProvider-id')->learningContents()->byLearningContentId('learningContent-id')->patch($requestBody)->wait();


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.learning_content import LearningContent
from msgraph.generated.models.level import Level
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = LearningContent(
	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.",
	content_web_url = "https://learn.microsoft.com/learn/modules/manage-classes-resources-assessment-planning-beedle/",
	source_name = "MsLearn",
	thumbnail_web_url = "https://syndetics.com/index.aspx?isbn=9783319672175/LC.GIF",
	language_tag = "en-us",
	number_of_pages = 9,
	duration = "PT20M",
	format = "Book",
	level = Level.Beginner,
	created_date_time = "2018-01-01T00:00:00Z",
	last_modified_date_time = "2021-04-01T04:26:06.1995367Z",
	contributors = [
		"Lina Wagner",
		"Lisa Richter",
	],
	additional_tags = [
		"Create private or public teams",
		"Add members to teams",
	],
	skill_tags = [
		"Create teams",
		"Teams channels",
		"Teams members",
	],
	is_active = True,
	is_premium = False,
	is_searchable = True,
)

result = await graph_client.employee_experience.learning_providers.by_learning_provider_id('learningProvider-id').learning_contents.by_learning_content_id('learningContent-id').patch(request_body)

响应

以下示例显示了相应的响应。

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
}

示例 2：根据学习内容的外部 ID 更新其元数据

以下示例演示一个请求，该请求基于学习内容的外部 ID (辅助密钥) 更新其元数据。

请求