learningCourseActivity を更新する

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

learningCourseActivity オブジェクトのプロパティを更新します。

注: isCourseAcitvitySyncEnabled が true に設定されている場合にのみ、学習コース アクティビティがプロバイダーによって管理できます。 値を更新するには、 Update learningProvider メソッドを使用します。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国
✅ ❌ ❌ ❌

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

アクセス許可の種類 最小特権アクセス許可 より高い特権のアクセス許可
委任 (職場または学校のアカウント) サポートされていません。 サポートされていません。
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション LearningAssignedCourse.ReadWrite.All LearningSelfInitiatedCourse.ReadWrite.All

HTTP 要求

PATCH /employeeExperience/learningProviders/{registrationId}/learningCourseActivities/{learningCourseActivityId}

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。
Content-Type application/json. 必須です。

要求本文

要求本文で、 @odata.type を使用して learningCourseActivity リソースの種類 (learningAssignment または learningSelfInitiated) を指定し、更新するその種類のプロパティを含めます。

次の表は、割り当てられた学習コース アクティビティ (learningAssignment) に対して変更できるプロパティの一覧です。

プロパティ 型 説明
assignedDateTime DateTimeOffset コース アクティビティの割り当て日。 省略可能。
assignmentType assignmentType コース アクティビティの課題の種類。 使用可能な値: required、recommended、unknownFutureValue。 必須です。
CompletedDateTime DateTimeOffset 課題が完了した日時。 省略可能。
completionPercentage Int32 ユーザーが完了したコースの割合。 値を指定する場合は、 0 から 100 (両端を含む) の間である必要があります。 省略可能。
dueDateTime DateTimeOffset コース アクティビティの期限。 省略可能。
notes String コース アクティビティのメモ。 省略可能。
status courseStatus コース アクティビティの状態。 使用可能な値は、notStarted、inProgress、completed です。 必須です。

次の表は、自己開始学習コース アクティビティ (learningSelfInitiated) で変更できるプロパティの一覧です。

プロパティ 型 説明
CompletedDateTime DateTimeOffset 課題が完了した日時。 省略可能。
completionPercentage Int32 ユーザーが完了したコースの割合。 値を指定する場合は、 0 から 100 (両端を含む) の間である必要があります。 省略可能。
status courseStatus コース アクティビティの状態。 使用可能な値: notStarted、inProgress、completed。 必須です。
startedDateTime DateTimeOffset 学習者が自己開始コースを開始した日時。

応答

成功した場合、このメソッドは 204 No Content 応答コードを返します。

例

例 1: 割り当てられた学習コース アクティビティを更新する

要求

次の例は要求を示しています。

PATCH https://graph.microsoft.com/beta/employeeExperience/learningProviders/01e8f81b-3060-4dec-acf0-0389665a0a38/learningCourseActivities/8ba2228a-e020-11ec-9d64-0242ac120003
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.learningAssignment",
  "assignedDateTime": "2021-05-11T22:57:17+00:00",
  "assignmentType": "required",
  "assignerUserId": "cea1684d-57dc-438d-a9d1-e666ec1a7f3d",
  "completedDateTime": null,
  "completionPercentage": 20,
  "learningProviderId": "01e8f81b-3060-4dec-acf0-0389665a0a38",
  "dueDateTime": {
    "dateTime": "2022-09-22T16:05:00.0000000",
    "timeZone": "UTC"
  },
  "externalCourseActivityId": "12a2228a-e020-11ec-9d64-0242ac120002",
  "learningContentId": "57baf9dc-e020-11ec-9d64-0242ac120002",
  "learnerUserId": "7ba2228a-e020-11ec-9d64-0242ac120002",
  "notes": {
    "contentType": "text",
    "content": "required assignment added for user"
  },
  "status": "inProgress"
}

応答

次の例は応答を示しています。

HTTP/1.1 204 No Content

例 2: 自己開始の学習コース アクティビティを更新する

要求

次の例は要求を示しています。

PATCH https://graph.microsoft.com/beta/employeeExperience/learningProviders/01e8f81b-3060-4dec-acf0-0389665a0a38/learningCourseActivities/8ba2228a-e020-11ec-9d64-0242ac120003
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.learningSelfInitiatedCourse",
  "completedDateTime": null,
  "completionPercentage": 30,
  "externalCourseActivityId": "12a2228a-e020-11ec-9d64-0242ac120002",
  "learningContentId": "57baf9dc-e020-11ec-9d64-0242ac120002",
  "learningProviderId": "01e8f81b-3060-4dec-acf0-0389665a0a38",
  "startedDateTime": "2021-05-11T22:57:17+00:00",
  "status": "inProgress"
}

応答

次の例は応答を示しています。

HTTP/1.1 204 No Content