Microsoft Learn Catalog API についてよく寄せられる質問
この記事では、Microsoft Learn Catalog API についてよく寄せられる質問の一覧をその回答と共に示し、必要に応じて詳細情報へのリンクも示します。
全般
Q: Learn Catalog API を使用するための料金はどれくらいですか?
Learn Catalog API は無料で使用できます。 詳細については、Learn Catalog API の機能の概要の記事の「可用性と価格」のセクションを参照してください。
Q: Learn Catalog API の使用に関して、どのようなルールがありますか?
Microsoft Learn と Microsoft API の使用条件を参照してください。
Q: Learn Catalog API を使用するには、オンボードまたはキーの取得が必要ですか?
いいえ。 この API は一般公開されています。 cURL と Visual Studio Code を利用して Learn Catalog API の使用を開始することに関する記事と Learn Catalog API 開発者リファレンスの記事を参照してください。
Q: この API を使えば、私たちユーザーは私たちのプラットフォームで Learn のコンテンツを利用できるようになるのでしょうか?
いいえ。 Learn Catalog API によって提供されるのは、コンテンツに関するメタデータと、そのコンテンツへの直接リンクです。 ユーザーは、Microsoft API の使用条件に従って、これらのリンクを任意の LMS または Web エクスペリエンスに統合できます。
Q: Learn Catalog API から返されるデータは静的なままですか、それとも変更されますか?
データの変更は、新しいコンテンツの追加、変更、または削除のたびに行われ、通常は毎日行われます。
API 応答
Q: すべてのデータを一度に取得できますか?
はい。 ベース エンドポイント learn.microsoft.com/api/catalog を使用すると、完全な応答を取得できます。 API 要求の詳細については、Learn Catalog API 開発者リファレンスの記事を参照してください。
Q: 応答を事前にフィルター処理できますか?
はい。 使用できるクエリ フィルターについては、Learn Catalog API 開発者リファレンスの記事を参照してください。
Q: UID はコンテンツ オブジェクトごとに一意ですか?
はい。 UID は "Unique ID" の略で、各コンテンツ オブジェクトに対して一意となるものです。 UID が変更されると、たとえタイトルや他のメタデータが同じであっても、そのコンテンツは新しいオブジェクトとみなされます。
Q: モジュールの概要に HTML タグがある理由は何ですか?
通常、概要の書式はできるだけそのままにしますが、時には特定のテキストを強調したり、リンクさせたりする必要があります。
Q: 個々のユニットのリンクが表示されない理由は何ですか?
各ユニットは独立したコンテンツとして書かれているわけではありません。 それらは、モジュールの特定の順序で実施されることが意図されています。 このため、モジュール詳細ページと最初のユニットへのリンクが含まれており、ユーザーはそこから始めてコンテンツを進めることができます。
Q: 新しいコンテンツはどのように見分けるのですか?
last_modified の値から、そのレコードが最後に変更されたのがいつであるかがわかります。
Q: コンテンツのリンクに対してシングル サインオン (SSO) は有効になっていますか?
現時点ではありません。 SSO を将来有効にできるようにする予定です。
コンテンツ
Q: UID はコンテンツに対して一意ですか?
正解です。 UID は "Unique ID" の略で、各コンテンツ オブジェクトに対して一意となるものです。 UID が変更されると、たとえタイトルや他のメタデータが同じであっても、そのコンテンツは新しいオブジェクトとみなされます。
Q: すべてのモジュールは、ラーニング パスの一部ですか?
いいえ。 モジュールはすべて、シナリオまたは概念をその中で端から端まで教えるという意味で、単独で機能します。前提条件となるモジュールを受講する必要はありません。 中には、これだけで、ラーニング パスの一部ではないものもあります。 また、より高度なコンセプトを構築するために、1 つまたは複数のラーニング パスにまとめられている場合もあります。 モジュールはラーニング パスの一部である必要はなく、1 つまたは複数のラーニング パスの一部であることもあり得ます。
Q: コンテンツがいつ追加、最新の情報に更新、または削除されたかを知る方法を教えてください。
新しいコンテンツ オブジェクトが追加されると、それらは応答に新しいオブジェクト (UID で識別) として表示されます。 コンテンツに変更が加えられたときは、その last_modified の値で判別できます。 コンテンツが削除されると、応答から削除されます。 API 応答の中のコンテンツが更新されるのは少し遅れることもありますが、ユーザーはそのコンテンツへの URL をたどれば、常に最新の情報を見ることができます。 コンテンツが削除された場合は、古い URL から新しいコンテンツまたはエクスペリエンスにリダイレクトされます。
注目すべきは、コンテンツが常に更新されていることです。 通常、更新情報は 1 日に 2 回発行されます。 ちょっとしたテキストの変更などのマイナーなものから、大幅な改訂、追加、削除などのメジャーなものまであります。 一般的に、コンテンツ ポートフォリオは、何千人もの共同作成者を擁する大規模で高度に管理されたオープンソース プロジェクトとして管理されており、そのため、常に変更が行われています。 Learn Catalog API を運用システムで使用する場合は、コンテンツのバージョン管理のしくみを認識して、システムが対応できるようにしてください。
Q: ドキュメント、ビデオ、コード サンプルのカタログにアクセスする方法を教えてください。
現時点では、これらのカタログにプログラムでアクセスする方法はありません。 将来、これらのカタログにプログラムでアクセスできるようにする予定です。
ローカライズ
Q: Microsoft Learn で利用できる言語は何ですか?
Microsoft Learn では、65 を超えるロケールを利用できます。 完全な一覧をサイト フッターから確認できます (表示している言語を選択すると、完全な一覧が表示されます)。
Q: コンテンツは他の言語でも利用できますか?
一概には言えません。 Microsoft は、コンテンツで教えられている製品を利用可能なすべての言語においてそのコンテンツを利用できるようにすることを目指しています。 学習者があるロケールで Microsoft Learn サイトにアクセスしたときに、そのコンテンツがそのロケールでは用意されていない場合は、ヘッダーとフッターはユーザーの目的のロケールで表示されますが、中核的なコンテンツはローカライズ版が使用可能になるまで、既定の英語に戻ります。
Q: あるコンテンツ オブジェクトの内容が、どの言語で見るかによって異なることはありますか?
その可能性はあります。 英語のコンテンツの更新が公開されると、Microsoft のローカライズ パイプラインは、できるだけ早く、通常は元の変更から数日以内にローカライズ版を更新できるように作業します。
その他
Q: 閲覧数、クリック数、修了などのデータを取得するためのレポート用 API または機能はありますか?
現時点では、レポート用 API はありません。 組織用のレポート機能はあり、これを使用すると組織のユーザーの修了状況をレポートすることができます。
次のステップ
以下のリンクにアクセスして、Learn Catalog API についてさらに学ぶことができます。