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:ブックマーク登録済みのリンクからコンテンツにアクセスしたのですが、予想と異なるコンテンツが表示されています。 なぜですか?
当サイトへのリンクで行き詰まること (404) がないよう取り組んでいます。 コンテンツが変更または置き換えられた場合、自動的に新しいコンテンツに移動する古いリンクのリダイレクトを実装します。 さまざまな理由でコンテンツが非推奨になって置き換えられない場合、次に最適なコンテンツにリダイレクトします。このコンテンツは、範囲が少し変更されていたり、ランディング ページへのアクセスが変更されていたりする場合があります。
Q: ドキュメント、ビデオ、コード サンプルのカタログにアクセスする方法を教えてください。
現時点では、これらのカタログにプログラムでアクセスする方法はありません。 将来、これらのカタログにプログラムでアクセスできるようにする予定です。
ローカライズ
Q: Microsoft Learn で利用できる言語は何ですか?
Microsoft Learn では、65 を超えるロケールを利用できます。 完全な一覧をサイト フッターから確認できます (表示している言語を選択すると、完全な一覧が表示されます)。
Q: コンテンツは他の言語でも利用できますか?
一概には言えません。 Microsoft は、コンテンツに表示された製品が、利用可能なすべての言語でコンテンツ利用可能になることを目指しています。 学習者が特定のロケールで Microsoft Learn サイトにアクセスしたときにそのロケールでコンテンツが利用できない場合、ユーザーは希望するロケールでヘッダーとフッターを表示し、ローカライズされたバージョンが利用できるまで、コア コンテンツは既定で英語に戻ります。
Q: あるコンテンツ オブジェクトの内容が、どの言語で見るかによって異なることはありますか?
その可能性はあります。 英語のコンテンツの更新が公開されると、Microsoft のローカライズ パイプラインは、できるだけ早く、通常は元の変更から数日以内にローカライズ版を更新できるように作業します。
その他
Q: 閲覧数、クリック数、修了などのデータを取得するためのレポート用 API または機能はありますか?
現時点では、レポート用 API はありません。 組織用のレポート機能はあり、これを使用すると組織のユーザーの修了状況をレポートすることができます。
次のステップ
以下のリンクにアクセスして、Learn Catalog API についてさらに学ぶことができます。