従業員の学習 API を使用してViva Learningと統合する
重要
Microsoft Graph の /beta
バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
Viva Learningは、Microsoft Teams の一元的な従業員学習ハブであり、従業員は学習スキルとスキルの構築を仕事の日に統合できます。 Viva Learningでは、チームは、organizationとパートナーの両方によって提供されるコンテンツ ライブラリを検出、共有、推奨、学習できます。 割り当て済みまたは最近完了した学習コンテンツにすばやくアクセスし、Microsoft Teams を離れずにこのすべてを行うことができます。
Microsoft Graph の従業員向け学習 API を使用すると、アプリは、学習管理システム (LMS) または学習プロバイダーからコンテンツをViva Learningで利用できるようになります。 Viva Learningと統合するには、次のリソースを使用します。
- プロバイダー の登録と削除など、学習プロバイダーを管理するための学習プロバイダー。
- Viva Learningで LMS またはラーニング プロバイダーから学習コンテンツ メタデータをアップロードおよび管理するための学習コンテンツ。
- Viva Learningで LMS またはラーニング プロバイダーから学習者のコース アクティビティ レコードをアップロードおよび管理するための学習コース アクティビティ。
統合のしくみ
管理者は、LMS またはラーニング プロバイダーのコンテンツと学習者レコード (従業員の割り当てと完了したコース レコード) をViva Learningと統合できます。この統合は、Viva Learningが LMS またはラーニング プロバイダーからコンテンツ メタデータと学習レコードをプルできる、すぐに利用できる統合を使用します。 また、Microsoft Graph の従業員学習 API を使用して、LMS または学習プロバイダーからコンテンツ メタデータをViva Learningにプッシュすることもできます。
コンテンツ メタデータ、従業員の割り当て、および完了したコース レコードがViva Learningにアップロードされると、次の場所のViva Learningに表示されます。
- コンテンツ メタデータが同期されると、コンテンツがホーム ページの [ コースの参照 - プロバイダー] セクション に 表示されます。
- 学習コースのアクティビティが同期されると、[ マイ ラーニング ] タブに課題、推奨事項、自己学習コースレコードが表示されます。進行状況に基づいて、状態は [進行中] から [完了] に移動します。
学習者の学習コースアクティビティは、API を介してViva Learningの外部で検出できます。
Authorization
適切な委任された従業員またはアプリケーション の従業員の学習アクセス許可を使用すると、アプリは従業員の学習 API を使用して、テナント内の学習ハブの学習プロバイダーとそのコンテンツを管理できます。 アクセス トークン、アプリの登録、委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 認証と承認の基本」を参照してください。
Microsoft Graph の従業員学習 API のユース ケース
従業員の学習 API を使用して、次の操作を行います。
- 学習プロバイダーを管理する:
- プロバイダーをViva Learningに登録し、表示名、学習コンテンツ カードに表示される正方形のロゴ、およびプロバイダー コンテンツをViva Learningに表示するために必要な [詳細] ページに表示される長いロゴを指定します。 返された登録 ID を使用して、コンテンツ インジェストの後続の呼び出しを行うことができます。
- 特定の registrationIdのViva Learningのプロバイダーに関する詳細を取得します。
- テナントのViva Learningでプロバイダー登録の一覧を取得します。
- Viva Learningでプロバイダーの登録を削除します。
- 学習コンテンツのCreateと管理:
- コンテンツ メタデータを Viva Learning にプッシュして、ユーザーが使用できるようにViva Learning内でコンテンツを使用できるようにします。
- プロバイダーの registrationId を使用して、プロバイダーの取り込まれたコンテンツのメタデータの一覧を取得します。
- Viva Learningで取り込まれたプロバイダーのコンテンツの指定されたメタデータを取得します。
- プロバイダーの取り込まれたコンテンツの指定されたメタデータを削除します。
- ラーニング コースアクティビティをCreateして管理する:
- ユーザーのコースの一覧を取得する
- Viva Learningの新しいラーニング コース アクティビティをCreateします。
- learningCourseActivityId を使用して、学習コースアクティビティの詳細を取得します。
- learningCourseActivityId を使用して、学習コースアクティビティの詳細を更新します。
- 学習コースのアクティビティを削除する
次の手順
- Teams のコラボレーション機能を使用して従業員の学習を有効にします。
- Graph エクスプローラーで従業員の学習 API を試してください。