Microsoft Learn Catalog API に関してよく寄せられる質問
この記事では、Microsoft Learn Catalog API に関してよく寄せられる質問とその回答と、必要に応じて詳細情報へのリンクを示します。
全般
Q: Learn Catalog API の使用コストはどのくらいですか?
Learn Catalog API を使用するコストは発生しません。 詳細については、Learn Catalog API 機能の概要に関する記事の「可用性と価格」セクションを参照してください。
Q: Learn Catalog API を使用するための規則は何ですか?
Microsoft API 使用条件 Microsoft Learn とを参照してください。
Q: Learn Catalog API を使用するには、キーをオンボードまたは取得する必要がありますか?
いいえ。 API は一般公開されています。 cURL と Visual Studio Code を使用した Learn Catalog API の概要に関する記事、および/または Learn Catalog API 開発者向けリファレンスの記事を参照してください。
Q: この API を使用すると、ユーザーはプラットフォーム内で Learn コンテンツを使用できますか?
いいえ。 Learn Catalog API は、コンテンツに関するメタデータと、コンテンツへの直接リンクを提供します。 ユーザーは、Microsoft API 使用条件に従って、これらのリンクを任意の Learning Management System (LMS) または Web エクスペリエンスに統合できます。
Q: Learn Catalog API から返されるデータは静的なままですか、それとも変更されますか?
データは、新しいコンテンツが追加、変更、または削除されるたびに変更されます。通常は毎日行われます。
API 応答
Q: すべてのデータを一度に取得できますか。
はい。 ベース エンドポイント「learn.microsoft.com/api/catalog」を使用して、完全な応答を取得します。 API 要求の詳細については、カタログ API 開発者向けリファレンスの記事 を参照してください。
Q: 応答を事前にフィルター処理できますか。
はい。 Learn Catalog API 開発者向けリファレンスの記事で使用できるクエリ フィルターを参照してください。
Q: UID はコンテンツ オブジェクトごとに一意ですか?
はい。 UID は "一意の ID" を表し、コンテンツ オブジェクトごとに一意です。 UID が変更された場合、タイトルまたはその他のメタデータが変わらない場合でも、コンテンツは新しいオブジェクトと見なされます。
Q: モジュールの概要に HTML タグが含まれているのはなぜですか?
通常、サマリーの書式設定は可能な限り生のままにしますが、特定のテキストを強調したりリンクしたりする必要がある場合があります。
Q: 個々のユニットのリンクがないのはなぜですか?
ユニットはスタンドアロン コンテンツとして書き込まれません。 これらは、モジュールの特定の順序で取得することを目的としています。 このため、モジュールの詳細ページと最初のユニットへのリンクを含めて、ユーザーがそこから開始してコンテンツを続行できるようにします。
Q: 新しいコンテンツを伝える方法
last_modified値は、レコードが最後に変更された日時を通知します。
Q: コンテンツ リンクに対してシングル Sign-On (SSO) は有効になっていますか?
現時点ではできません。 今後、SSO を有効にすることを目指しています。
コンテンツ
Q: UID はコンテンツに対して一意ですか?
はい。 UID は "一意の 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 Learn サイトにアクセスすると、コンテンツがそのロケールで使用できない場合、ユーザーは目的のロケールのヘッダーとフッターを表示し、コア コンテンツはローカライズされたバージョンが使用可能になるまで既定で英語に戻ります。
Q: 表示する言語に応じて、特定のコンテンツ オブジェクトのコンテンツは異なりますか?
多分。 更新プログラムが英語コンテンツに公開されると、ローカライズ パイプラインは、ローカライズされたバージョンをできるだけ早く (通常は元の変更から数日以内に) 更新するように機能します。
その他
Q: ビュー、クリック、完了などのデータを取得するためのレポート API または機能はありますか。
現時点では、レポート API はありません。 組織のレポート機能 があり、組織はユーザーの完了を報告できます。
次の手順
Learn Catalog API の詳細については、次のリンクを参照してください。