次の方法で共有

Microsoft Learn カタログ API 機能の概要

  • [アーティクル]

Microsoft Learn Catalog API は REST ベースの Web API であり、Web ベースのクエリを Microsoft Learn に送信し、タイトル、製品、レベル、トレーニングへのリンク、その他のメタデータなど、利用可能なトレーニング コンテンツと認定試験に関する詳細を取得し、情報を含む JSON エンコード応答を返すことができます。

一般公開されているすべての情報が返されます。

  • モジュール
  • 単位
  • 学習の道筋
  • 適用されたスキル
  • 認証
  • 試験
  • Instructor-Led コース

手記

Microsoft Learn サイトの最近の更新の一環として、learn.microsoft.com ドメインで新しいカタログ API エンドポイントを使用できます。 古いエンドポイントは引き続き期待どおりに動作しますが、新しいエンドポイントに切り替える利点は、追加のクエリ パラメーターなどの強化された機能を提供することです。

使用事例

  • Microsoft Learn のトレーニングや認定オファリングに関するメタデータを表示する
  • Microsoft Learn のトレーニングや認定オファリングの一覧を取得して、独自のオンライン エクスペリエンスからリンクを作成します。

Learn Catalog API のしくみ

API は、JSON でエンコードされた応答を返す REST ベースの Web API です。 完全なカタログを要求するには、GET 要求を次の送信先に送信します。

https://learn.microsoft.com/api/catalog/

出力は次のスクリーンショットのようになります。 2022 年 11 月の時点で、完全な応答は約 13 MB です。

Visual Studio Code の Learn Catalog API 出力のスクリーンショット。

各学習カタログ項目はオブジェクトであり、それぞれに使用できる一連のメタデータがあります。 完全なデータ ディクショナリとその他のオプションは、Microsoft Learn Catalog API 開発者向けドキュメントに記載されています。 また、最新の更新プログラムの内容を確認するためのリリース ノート (リンク) と、ベスト プラクティス 情報 用意されています。

使用に興味があるならば、cURL と Visual Studio Code を用いて Microsoft Learn Catalog API を始める記事 をご覧ください。

必要条件

Microsoft Learn Catalog API にアクセスするために認証は必要ありません。 ユーザーは、cURL、Postman などの任意の API 要求メソッドを使用できます。

例文

Learn Catalog API を使用してユーザーに表示されるさまざまな方法を次に示します。

  • Viva Learning では、Learn カタログ API を使用して、コア エクスペリエンスの一部として Microsoft Learn カタログを提供しています。
  • 組織や教育機関は Learn Catalog API を使用してカタログ情報を取得し、内部学習管理システム (LMS) に投稿することで、従業員と学生が簡単にアクセスできるようにします。
  • 学習プロバイダーは、Learn Catalog API を使用してカタログ情報を取得し、カスタマー ラーニング エクスペリエンスに投稿します。

可用性と価格

Microsoft Learn Catalog API は、Microsoft API 使用条件の条件に基づき、一般公開され、提供されます。 API の使用に料金はかかりません。

制限

  • この API には、公開されているモジュール、ユニット、ラーニング パス、インストラクター主導のコース、試験、認定が含まれています。 現時点では、ドキュメント、コード サンプル、ショー、イベントは出力されません。
  • API は、1 日に少なくとも 1 回更新されます。
  • API バージョンの更新は、Learn Catalog API リリース ノートの更新によって伝達されます。

次の手順

Learn Catalog API の詳細については、次の記事を参照してください。