learningCourseActivity 资源类型

命名空间：microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

表示属于员工学习课程的一部分的活动。

learningAssignment 和 learningSelfInitiated 类型的基类型。

继承自 entity。

Methods

方法	返回类型	说明
列出 learningCourseActivities	learningCourseActivity 集合	获取 (用户分配或自启动) 的 learningCourseActivity 对象列表。
创建 learningCourseActivity	learningCourseActivity	创建新的 learningCourseActivity 对象。
获取 learningCourseActivity	learningCourseActivity	使用学习提供程序的 ID 或 externalCourseActivityId 或用户的 courseActivityId 获取指定的 learningCourseActivity 对象。
更新 learningCourseActivity	learningCourseActivity	更新 learningCourseActivity 对象的属性。
删除 learningCourseActivity	无	使用作业或自启动的活动的课程活动 ID 删除 learningCourseActivity 对象。

属性

属性	类型	说明
assignedDateTime	DateTimeOffset	作业完成的日期和时间。 可选。
assignerUserId	String	分配器的用户 ID。 可选。
assignmentType	assignmentType	课程活动的作业类型。 可取值为：required、recommended、unknownFutureValue。 必填。
completedDateTime	DateTimeOffset	作业完成的日期和时间。 可选。
completionPercentage	Int32	课程活动的完成百分比值。 可选。
dueDateTime	DateTimeTimeZone	课程活动的截止日期。 可选。
externalcourseActivityId	String	提供商生成的课程活动 ID。 可选。
id	String	可以与其他课程活动 API 一起使用的生成 ID。
learnerUserId	String	活动分配到的学习者的用户 ID。 必填。
learningContentId	String	在 Viva Learning 中创建的学习内容的 ID。 必填。
learningProviderId	String	提供程序的注册 ID。 必填。
startedDateTime	DateTimeOffset	学习者启动自启动课程的日期和时间。 可选。
status	courseStatus	课程活动的状态。 可取值为：notStarted、inProgress、completed。 必填。

注意：当 isCourseAcitvitySyncEnabled 设置为 true时，提供程序可以引入课程活动。 若要更新值，请使用 Update learningProvider 方法。

关系

无。

JSON 表示形式

下面是资源的 JSON 表示形式。

{
  "assignedDateTime": "String (timestamp)",
  "assignerUserId": "String",
  "assignmentType": "String",
  "completedDateTime": "String (timestamp)",
  "completionPercentage": "Int32",
  "dueDateTime": "String (timestamp)",
  "externalCourseActivityId": "String",
  "id": "String (identifier)",
  "learnerUserId": "String",
  "learningContentId": "String",
  "learningProviderId": "String",
  "startedDateTime": "String (timestamp)",
  "status": "String"
}