Learn365 Cloud API セクション：概要と機能

更新 2025年07月02日 05:21

Learn365 Cloud API は、他のアプリケーションとの統合を可能にし、組織のプロセスの合理化とビジネスパフォーマンスの向上を可能にします。Learn365 API エンドポイントは、その目的と機能に応じてセクションに分類されています。

ここでは、Learn365 Cloud API の各セクションについてご説明します。

参考 💡

セクションはアルファベット順に表示されます。各セクションの説明は、そのセクションに含まれる API の一般的な機能に基づいており、クエリオプションパラメータは設定されていません。

Learn365 API を利用するためには、最初にログインが必要です。

重要！

新しいスキルエンドポイントが実装されました。従来のコンピテンシーエンドポイントは、現在 2025 年 8 月 18 日 (月) に予定されている Learn365（v.3.64）リリースで非推奨になり、最終的に廃止され、スキルエンドポイントに置き換わります。

Microsoft power app などでコンピテンシーエンドポイントを使用されている場合、エンドポイントが廃止される前に新しいスキルエンドポイントへの移行をお勧めします。

API セクションリストの表示

Apps

Apps セクションには、個別のアプリケーションとして使用されていないが、Learn365 ソリューションの組み込みの一部である API が含まれています。これらの API を使用すると、テナント上のすべてのアプリケーションのリストと ID を取得できます。

API sections1.png

Assessments

Assessments セクションには、テナント上の「評価」に関連する情報を取得するための API エンドポイントが含まれます。

この情報には評価の ID、およびその一部であるコース、評価のタイトル、説明、監督者および設定が含まれます。

このセクションの API では、テナント上の評価のリストの取得、評価の作成、更新、削除、承認をすることができます。

API sections2.png

Assets

Assets セクションの API では、アセットのダウンロードとアップロードができるます。

アセットとは、例えばトレーニングやラーニングモジュールの説明など、リッチテキストエディタを通して Learn365 管理センターに置くことができるドキュメント、ビデオ、画像を指します。

API によるコースカタログアセットの閲覧とダウンロード

Assignments

Assignments セクションには、新しい課題を作成したり、テナント上の課題のリストと ID の取得、課題を完了としてマークするための API エンドポイントが含まれています。

API sections3.png

CertificateTemplates

CertificateTemplates セクションには、テナント上のすべての認定証テンプレートのリストの取得、認定証テンプレートを作成、更新、削除するための API エンドポイントが含まれています。

API sections4.png

Certificates

Certificates セクションの API エンドポイントでは、次のことができます。

テナント上の ID、画像、およびこれらの認定証を付与されたユーザーを含む、認定証に関する情報の取得
認定証の作成
認定証を再発行
認定証の画像のアップロード
認定証のステータス、発行日、有効期限の更新

API sections5.png

注記：

Competencies は、2025 年 8 月 18 日 (月) に非推奨になる予定です。新しい Skills エンドポイントに移行することをお勧めします。

Competencies セクションには、テナント上のすべてのスキルのリストの取得と、スキルを作成、更新、削除するための APIエンドポイントが含まれています。

API sections6.png

CompetencyCategories

注記：

CompetencyCategories は、2025 年 8 月 18 日 (月) に非推奨になる予定です。新しい SkillCategories エンドポイントに移行することをお勧めします。

CompetencyCategories セクションには、テナント上のスキルカテゴリーのリストの取得、スキルのカテゴリを作成、更新、削除するための APIエンドポイントが含まれています。

API sections7.png

CompetencyScaleSets

注記：

CompetencyScaleSets は、2025 年 8 月 18 日 (月) に非推奨になる予定です。新しい SkillScaleSets エンドポイントに移行することをお勧めします。

CompetencyScaleSets セクションには、テナント上のスキルレベルセットのリストの取得、スキルレベルセットを作成、更新、削除するための APIエンドポイントが含まれています。

API sections8.png

CompetencyTags

注記：

CompetencyTags は、2025 年 8 月 18 日 (月) に非推奨になる予定です。新しい SkillTags エンドポイントに移行することをお勧めします。

CompetencyTags セクションには、テナント上のスキルタグのリストの取得、スキルタグを作成、更新、削除するための API エンドポイントが含まれます。

API sections9.png

CourseCatalogs

CourseCatalogs セクションにある API エンドポイントでは次のことができます。

新しいコースカタログの作成
既存のコースカタログまたはその一部の更新
テナント上のコースカタログのリストとその ID の取得
コースカタログにユーザーの追加 /コースカタログからユーザを削除
コースカタログからアセットのダウンロード

API sections10.png

CourseCategories

CourseCategories セクションには、テナント上のカテゴリーリストの取得、カテゴリーを作成、更新、削除するための API エンドポイントが含まれています。

API sections11.png

API によるコースカタログからのカテゴリーの削除

CourseCompletionSets

CourseCompletionSets セクションには、テナント上のコース完了セットのリストの取得、およびコース完了セットを作成、更新、削除するための API エンドポイントが含まれています。

API sections12.png

CourseImages

CourseImages セクションには、コースやコースのバナーに使用する画像をアップロードするための API エンドポイントが含まれています。

API sections13.png

CourseLayouts

CourseLayoutsセクションの API エンドポイントは廃止されました。

Courses

Courses セクションには、コースのリスト（一般的なものとパラメータが設定されたもの）と各種詳細情報の取得、コースを作成、更新、削除するための API エンドポイントが含まれます。

コースへの登録、コースからの登録解除、コース評価の管理、コース完了設定を管理する API も用意されています。また、コースセッションの追加、更新、削除もできます。

API sections14.png

CourseSessions

CourseSessions セクションには、テナント上のすべての単独のセッションおよびセッショングループのリストを取得するための API エンドポイントが含まれます。

API sections15.png

API にるセッション開始日と終了日の取得

CourseSessionRequests

CourseSessionRequests セクションには、設定されたパラメータに基づいて、テナント上のすべてのセッションリクエストリストの取得、コースセッションリクエストの追加、削除するための API エンドポイントが含まれます。

API sections16.png

CourseTags

CourseTags セクションには、テナント上のすべてのコースタグのリストの取得、コースタグの作成、更新、削除するための API エンドポイントが含まれます。

API sections17.png

EmailNotifications

必要なロール：カタログ管理者

EmailNotifications セクションには、メール通知を管理するための API エンドポイントが含まれています。

ID によるメール通知テンプレートの取得
メール通知テンプレートの更新
特定のコースカタログのすべての通知テンプレートリストの取得
カタログレベルでメール通知テンプレートを有効/無効にする
Microsoft 365 接続設定を有効/無効にする
カスタマイズした通知テンプレートのリセット
Eメール通知テンプレートにおけるコース通知のリストの取得
E メール通知テンプレートにおける特定のコース通知の取得
コースレベルでメール通知テンプレートを有効/無効にする
すべての Eメール通知テンプレートにおけるコース通知のリストの取得

EmailNotifications API.png

EnrollmentFlows

EnrollmentFlows セクションには、テナント上の登録フローに関連する情報を取得する API エンドポイントが含まれています。

API sections18.png

Enrollments

Enrollments セクションには、新規登録、復帰、取り消し、承認、却下、消去、およびその他のアクションを行うための API エンドポイントが含まれています。

API sections19.png

ExternalApps

ExternalApps セクションには、テナント上の外部アプリのリストの取得、外部アプリの追加、置換、削除するための API エンドポイントが含まれます。

また、コース内の外部アプリの配置を変更することもできます。

API sections20.png

ExternalTrainings

ExternalTrainings セクションには、テナントにコース、コースの完了、および認定証をインポートするための API エンドポイントが含まれています。

API sections21.png

API による外部コースレコードとその認定証のインポート

GroupRestrictions

GroupRestrictions セクションには、Learn365 管理センターで Microsoft Entra（Azure Active Directory）グループのユーザーの可視性を制限するための API が含まれています。

例えば、グループ制限がオンの場合、受講者をトレーニングに登録する際に、特定の Microsoft Entra （Azure Active Directory）グループのユーザーのみが表示されます。

API group restrictions section.png

API による Microsoft Entra / カスタムユーザーグループの可視性の制限

Groups

Groups セクションには、カスタムユーザーグループの作成と削除、カスタムグループへのユーザーの追加と削除、グループリストの表示、グループ内のユーザーリストの表示をするための API が含まれています。

カスタムユーザーグループは、Learn365 API を通じて作成および管理できるグループです。Microsoft Entra グループとは異なり、カスタムユーザーグループには、Learn365 とFlow365 のあらゆるタイプのユーザーを含むことができます。

API GroupsSection.png

LearningModuleAttempts

LearningModuleAttempts セクションには、テナント上のラーニングモジュールにおけるユーザーの試行リストの取得、ユーザーの試行の更新、削除、また新しい試行を生成するための API エンドポイントが含まれています。

API sections22.png

LearningModules

LearningModules セクションには、テナント上のすべてのコースのラーニングモジュールのリストの取得、およびラーニングモジュールの作成、更新、削除するための API エンドポイントが含まれています。

API sections23.png

QuestionPoolCategories

QuestionPoolCategories セクションには、テナント上の問題集のカテゴリリストの取得、および問題集に新しいカテゴリを作成するための API エンドポイントが含まれています。

API sections24.png

QuizAttempts

QuizAttempts セクションには、テナントでの受講者のクイズの試行リスト（受講者のクイズの解答を含む）を取得できる API エンドポイントが含まれています。

API sections25.png

QuizQuestionPools

QuizQuestionPools セクションには、テナント上の問題集のリストを取得し、新しい問題集を作成するための API エンドポイントが含まれています。

API sections26.png

Quizzes

Quizzes セクションには、テナント上のクイズのリストと関連するクイズデータの取得、クイズの更新、削除、新しいクイズを作成するための API エンドポイントが含まれています。

API sections27.png

RoleAssignments

RoleAssignments セクションには、ユーザーやグループに割り当てられたロールのリストを取得するための API エンドポイントが含まれています。

API によるユーザーのロールリストの取得

Reports

Reports セクションには、テナント上のセッションのユーザーあたりのコストに関する情報の取得と、受講者のトレーニング所要時間レポートを生成するための API エンドポイントが含まれています。

API sections28.png

ScormAttempts

ScormAttempts セクションには、テナント上のすべての SCORM における、すべてのユーザーの試行リストの取得、およびSCORMの作成、更新するための API エンドポイントが含まれています。

API sections29.png

API によるSCORM コンテンツパッケージの完了

Scorms

Scorms セクションには、テナントに .zipファイルをアップロードし、それに基づいてコンテンツパッケージを作成するための API エンドポインが含まれています。また、SCORMとその ID、 SCORM コンテンツ、コンテンツ URL のリストの取得、コースの学習項目における SCORM の配置の変更、コンテンツパッケージの削除など、既存の SCORM を管理することもできます。

API sections30.png

SkillCategories

SkillCategories セクションには、テナント上のスキルカテゴリのリストを取得、スキルカテゴリの作成、更新、削除するための API エンドポイントが含まれています。

Skills

Skills セクションには、テナント上のすべてのスキルのリストの取得、スキルの作成、更新、削除するための API エンドポイントが含まれています。

SkillScaleSets

SkillScaleSets セクションには、テナント上のスキルレベルセットのリストの取得、スキルレベルセットの作成、更新、削除するための API エンドポイントが含まれています。

SkillTags

SkillTags セクションには、テナント上のスキルタグのリストの取得、スキルタグの作成、更新、削除するための API エンドポイントが含まれています。

TargetSkills

TargetSkills セクションには、テナント上の目標スキルの定義のリストの取得、単一の定義に関する情報や特定の受講者に適用された定義のリストの取得、目標スキルの定義の作成、更新、削除するための API エンドポイントが含まれています。

API による目標スキルの定義の取得

TrainingPlans

TrainingPlans セクションには、トレーニングプランのリスト（一般的なものとパラメータが設定されたもの）の取得、およびトレーニングプランへのコースの追加、トレーニングプランからのコースの削除、トレーニングプランを更新するための API エンドポイントが含まれています。

API sections31.png

注記：

UserCompetencies エンドポイントは、2025 年 8 月 18 日 (月) に非推奨になる予定です。新しい UserSkills エンドポイントに移行することをお勧めします。

UserCompetencie セクションには、テナント内のすべてのユーザーの、すべてのスキルのリストを取得する API エンドポイントが含まれています。

API sections32.png

API によるスキルとそのレベルの ID の取得

UserFields

UserFields セクションには、テナント内で Learn365 管理センターのユーザーページに表示される情報の取得、情報の更新、削除と、新しい列を作成するための API エンドポイントが含まれています。

API sections33.png

API によるユーザーページカスタム列の作成

UserRanks

UserRanks セクションには、テナント内での獲得したCEU数によるユーザーのランキングに関連する情報を取得するための API エンドポイントが含まれています。

API sections34.png

Users

Users セクションには、テナント上のユーザーリスト、ユーザー情報の取得、消去、統合、更新するための API エンドポイントが含まれています。

注記：

次の Users エンドポイントは、2025 年 8 月 18 日 (月) に非推奨になる予定です。

POST /odata/v2/Users('{LoginName}')/GrantCompetency

POST /odata/v2/Users('{LoginName}')/RevokeCompetency

POST /odata/v2/Users('{LoginName}')/PurgeCompetency

それぞれ、次の新しい UserSkills エンドポイントに移行することをお勧めします。

POST /services/skills/catalog/{courseCatalogId}/UserSkills/User/{userLoginName}/GrantSkill

POST /services/skills/catalog/{courseCatalogId}/UserSkills/User/{userLoginName}/RevokeSkill

POST /services/skills/catalog/{courseCatalogId}/UserSkills/User/{userLoginName}/PurgeSkill

API sections35.png

UserSkillRequest

UserSkillRequest セクションには、現在サインインしているユーザーのすべてのスキルリクエストのリストの取得、テナント上の任意のユーザーの1つのスキルリクエストに関する情報を取得するための API エンドポイントが含まれています。

UserSkills

UserSkills セクションには、テナント上のすべてのユーザーのスキルのリストの取得、ユーザーに対するスキルの付与、取り消し、削除するためのAPIが含まれています。

API によるスキルとそのレベルの ID の取得

WaitingListRequests

WaitingListRequests セクションには、ユーザーのキャンセル待ち（ウエイトリスト）に関する情報の取得、およびウエイトリストへの追加や、ウエイトリストから削除するための API エンドポイントが含まれています。

API sections36.png

WebHookRegistrations

WebHookRegistrations セクションには、テナント上の WebHook へのサブスクライブと WebHookからのサブスクライブ解除、ユーザーの WebHook に関する情報の取得、新しいWebHookの登録、およびWebHook の登録の更新、削除するための API エンドポイントが含まれています。

API sections37.png