プラットフォーム API 開発者向けリファレンスドキュメントについて学習する

この記事では、Microsoft Learn Platform API を実装する開発者とインテグレーター向けの情報を提供します。また、開発体験をサポートするために、Learn Platform API の概要、リリースノート、よく寄せられる質問に関する記事も確認することをお勧めします。

API エンドポイント

Microsoft Learn Platform API カタログエンドポイントは、JSON でエンコードされた応答を返す、認証された REST ベースの Web API のセットです。

エンドポイントには、次の場所からアクセスできます。

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

注

別の古いエンドポイントを使用している場合でも、2026 年 6 月まで想定どおりに動作します。その時点で、古い認証されていない Catalog API によって非推奨が開始されます。さらに質問がある場合は、 LearnPlatformAPIMigration@microsoft.comにお問い合わせください。

活用事例

Authentication

Learn Platform REST API は、認証に Microsoft Entra ID を使用します。 API 呼び出しを行う前に、アクセス方法を選択する必要があり、クライアントアプリケーションは有効な資格情報で認証する必要があります。

アプリ専用アクセス

アプリが Learn に直接アクセスする場合、そのアクセスは 1 人のユーザーに関連付けられません。アプリは、独自の ID を使用して API を直接呼び出します。このシナリオはアプリ専用アクセスです。 Microsoft ID プラットフォームの詳細を確認します。

開始するには、Microsoft ID プラットフォームで有効な ID が必要です。これは、アプリの登録またはマネージド ID です。クォータとパートナーの管理を簡素化するために、各パートナーが 1 つの ID を持っている必要があるのが理想的です。ユーザー割り当てマネージド ID を使用すると、異なるサービス間でマネージド ID を統合するのに役立ちます。

Entra ID ID が設定されたら、認証の証明としてスコープがに設定された Entra ID からhttps://learn.microsoft.com/.defaultを取得します。 Learn に対して REST API 要求を行うときに、HTTP Authorization ヘッダーにアクセストークンを含めます。

委任されたアクセス

ユーザーがアプリにサインインし、それを使用して Learn にアクセスする場合、アプリはまず、ユーザーの代わりにこのリソースにアクセスするためのアクセス許可を要求する必要があります。このシナリオは、委任されたアクセスと呼ばれます。 Microsoft ID プラットフォームの詳細を確認します。

開始するには、アプリの登録を登録する必要があります。アプリの登録が設定されたら、アプリはユーザーに特定のスコープを付与するか、ユーザーの代わりに Learn にアクセスするためのスコープのセットをユーザーに要求する必要があります。 Learn では、きめ細かなリソースアクセスのスコープの一覧を提供します。スコープの一覧は次のとおりです。

https://learn.microsoft.com/PublicContent.Read.All: このスコープを使用すると、ユーザーはサインインしているユーザーとして偽装された Learn のパブリックコンテンツにアクセスできます。

クエリパラメーター

要求に含めることができるクエリパラメーターを次に示します。 API バージョンのみが必要であり、現在のバージョンは 2023-11-01-preview です。クエリパラメーターの値を URL エンコードする必要があります。エンドポイントは、これらのパラメーターの 1 つ、一部、またはすべてを使用できます。

Important

複数のクエリを使用する場合は、AND 演算子を使用してクエリが評価されます。フィルター内のコンマ区切りの値は OR 結合されます。

名前	価値	タイプ	必須	Example
api-version	API バージョンは api-version クエリパラメーターとして指定され、安定バージョンには yyyy-MM-dd、プレビューバージョンでは yyyy-MM-dd-preview を使用します。 API バージョンのクエリパラメーターは、すべての API 要求に必要です。	文字列	イエス	`?api-version=2023-11-01-preview`
ロケール	サポートされているロケールの一覧の 1 つの有効なロケールコード。メタデータは要求したロケールで返されます (利用可能な場合)。このパラメーターが指定されていない場合は、 `en-us` 応答が返されます。	文字列	いいえ	`?locale=en-us`
id	利用可能なコンテンツタイプから 1 つ以上の有効なコンテンツ一意 ID (uid) のカンマ区切りリスト。注: uid は大文字と小文字が区別されます。	文字列	いいえ	`?uid=learn.azure.intro-to-azure-fundamentals`
updatedAt.gt	オブジェクトの最終更新日時でフィルターするための演算子および日付時刻。演算子には、 `gt` (より大きい)、 `gte` (以上) が含まれます。このパラメーターを使用すると、指定されていない場合、演算子は既定で `gt` されます。	文字列	いいえ	`?updatedAt.gt=2022-01-01`
levels	現在使用できる 1 つ以上のレベルのコンマ区切りのリスト (完全な一覧は API 応答の levels オブジェクトにあります)。	文字列	いいえ	`?levels=beginner`
roles	現在使用できる 1 つ以上のロールのコンマ区切りの一覧 (完全な一覧は API 応答の roles オブジェクトにあります)。	文字列	いいえ	`?roles=developer`
products	現在使用できる 1 つ以上のロールのコンマ区切りのリスト (完全な一覧は API 応答の products オブジェクトにあります)。 API は製品階層をサポートしていないため、クエリに含めるすべての製品を一覧に追加します。	文字列	いいえ	`?products=azure`
情報カテゴリ	現在使用可能な 1 つ以上のロールのコンマ区切りのリスト (完全な一覧は API 応答の subjects オブジェクトにあります)。 API はサブジェクト階層をサポートしていないため、クエリに含める一覧にすべての件名を追加します。	文字列	いいえ	`?subjects=cloud-computing`
maxpagesize	1 つの応答に含めるリソースの最大数。既定値は 30 です。許容される最大値は 100 です。	文字列	いいえ	`?maxpagesize=50`

API 応答

サービスは、次の HTTP 状態コードを返す場合があります。

状態コード	Description
200	成功。応答の本文には、JSON でエンコードされたデータが含まれます。
400	クエリパラメーターの 1 つが欠落しているか無効です。
401	未承認のクエリ。
404	URL がサーバー上に見つかりませんでした。
429	要求はレート制限付きでした。
500	予期しないサーバーエラー。
503	サービスは一時的に利用できません。

成功した応答には、次に示すように、各エンドポイントの詳細が含まれます。

応答本文

モジュールの応答

モジュールレコード

各モジュールレコードの形式は次のとおりです。

{
  "type": "module",
  "id": "learn.wwl.fundamentals-generative-ai",
  "url": "https://learn.microsoft.com/training/modules/fundamentals-generative-ai/",
  "locale": "en-us",
  "title": "Introduction to generative AI and agents",
  "durationInMinutes": 37,
  "summary": "Ever wondered how AI can create content, answer questions, and assist with tasks? This module introduces you to the world of generative AI and agents.",
  "iconUrl": "https://learn.microsoft.com/training/achievements/fundamentals-generative-ai.svg",
  "levels": [
    {
      "id": "beginner",
      "name": ""
    }
  ],
  "roles": [
    {
      "id": "ai-engineer",
      "name": "AI Engineer"
    },
    {
      "id": "developer",
      "name": "Developer"
    },
    {
      "id": "solution-architect",
      "name": "Solution Architect"
    },
    {
      "id": "student",
      "name": "Student"
    }
  ],
  "products": [
    {
      "id": "azure-ai-foundry",
      "name": "Azure AI Foundry"
    }
  ],
  "subjects": [
    {
      "id": "artificial-intelligence",
      "name": "Artificial intelligence"
    }
  ],
  "units": [
    {
      "id": "learn.wwl.fundamentals-generative-ai.introduction"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.language-models"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.writing-prompts"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.agents"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.exercise-ai-agent"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.knowledge-check"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.summary"
    }
  ],
  "updatedAt": "2025-12-23T00:20:00.0000000Z"
}

物件の詳細

プロパティ	タイプ	必須	Description
`type`	`enum`	イエス	型識別子。許可: `module`。
`id`	`string`	イエス	グローバルに一意のモジュール識別子。
`url`	`uri`	イエス	要求されたロケールでのモジュールへの完全修飾 URL。
`locale`	`string`	イエス	モジュールコンテンツロケール。要求されたロケールが使用できない場合は、既定で `en-us` されます。
`title`	`string`	イエス	ローカライズされたモジュールのタイトル。
`durationInMinutes`	`integer`	イエス	モジュールの平均完了時間 (分)。
`summary`	`string`	イエス	モジュールの簡単な説明。
`iconUrl`	`uri`	イエス	100×100 SVG 透過性を持つモジュールアイコンへの URL。
`levels`	`Level[]`	イエス	このモジュールに関連付けられているエクスペリエンスレベル。
`roles`	`Role[]`	イエス	関連するジョブロール。
`products`	`Product[]`	イエス	関連する製品分類。
`subjects`	`Subject[]`	イエス	関連するサブジェクト分類。
`units`	`UnitReference[]`	イエス	関連する学習単位。
`updatedAt`	`date-time`	イエス	最終更新日時のタイムスタンプ (マイナー編集では変更されない可能性があります)。

単位レコード

各ユニットレコードの形式は次のとおりです。

{ 
"type": "unit",
  "id": "learn.wwl.fundamentals-generative-ai.agents",
  "url": "https://learn.microsoft.com/training/modules/fundamentals-generative-ai/7-agents/",
  "locale": "en-us",
  "title": "AI agents",
  "durationInMinutes": 5,
  "updatedAt": "2025-10-06T17:09:00.0000000Z"
},

物件の詳細

プロパティ	タイプ	必須	Description
`type`	`enum`	イエス	型識別子。許可: `unit`。
`id`	`string`	イエス	Microsoft Learn 全体におけるこのユニットのユニーク識別子。
`url`	`uri`	イエス	指定されたロケールの単位に対する完全修飾 URL。
`locale`	`string`	イエス	単位のロケール。要求されたロケールが使用できない場合は、 `en-us` にフォールバックします。
`title`	`string`	イエス	ローカライズされたユニットのタイトル（フォールバック: 米国英語）
`durationInMinutes`	`integer`	イエス	平均完了時間 (分)。
`updatedAt`	`date-time`	イエス	最終更新日時のタイムスタンプ。は、軽微な編集では変更されない場合があります。

学習経路記録

各ラーニングパスレコードの形式は次のとおりです。

{
  "type": "learningPath",
  "id": "learn.introduction-ai-azure",
  "url": "https://learn.microsoft.com/training/paths/introduction-to-ai-on-azure/",
  "locale": "en-us",
  "title": "Introduction to AI in Azure",
  "durationInMinutes": 669,
  "summary": "This course introduces core concepts related to artificial intelligence (AI), and the services in Microsoft Azure that can be used to create AI solutions, focusing on Microsoft Foundry.",
  "iconUrl": "https://learn.microsoft.com/training/achievements/document-intelligence-knowledge-mining.svg",
  "levels": [
    {
      "id": "beginner",
      "name": ""
    }
  ],
  "roles": [
    {
      "id": "ai-engineer",
      "name": "AI Engineer"
    },
    {
      "id": "developer",
      "name": "Developer"
    },
    {
      "id": "solution-architect",
      "name": "Solution Architect"
    },
    {
      "id": "student",
      "name": "Student"
    }
  ],
  "products": [
    {
      "id": "azure-ai-foundry",
      "name": "Azure AI Foundry"
    }
  ],
  "subjects": [
    {
      "id": "artificial-intelligence",
      "name": "Artificial intelligence"
    }
  ],
  "modules": [
    {
      "id": "learn.wwl.get-started-ai-fundamentals"
    },
    {
      "id": "learn.wwl.get-started-ai-in-foundry"
    },
    {
      "id": "learn.wwl.fundamentals-machine-learning"
    },
    {
      "id": "learn.wwl.design-machine-learning-model-training-solution"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai"
    },
    {
      "id": "learn.wwl.get-started-generative-ai-azure"
    },
    {
      "id": "learn.wwl.introduction-language"
    },
    {
      "id": "learn.wwl.get-started-language-azure"
    },
    {
      "id": "learn.wwl.introduction-ai-speech"
    },
    {
      "id": "learn.wwl.recognize-synthesize-speech"
    },
    {
      "id": "learn.wwl.introduction-computer-vision"
    },
    {
      "id": "learn.wwl.get-started-computer-vision"
    },
    {
      "id": "learn.wwl.introduction-information-extraction"
    },
    {
      "id": "learn.wwl.ai-information-extraction"
    }
  ],
  "updatedAt": "2025-12-12T00:08:00.0000000Z"
}

物件の詳細

プロパティ	タイプ	必須	Description
`type`	`enum`	イエス	型識別子。許可: `learningPath`。
`id`	`string`	イエス	Microsoft Learn でこのラーニングパスを示す一意の識別子。
`url`	`uri`	イエス	要求されたロケールのラーニングパスへの完全修飾 URL。
`locale`	`string`	イエス	ラーニングパスが書き込まれるロケール。要求されたロケールが使用できない場合は、 `en-us` にフォールバックします。
`title`	`string`	イエス	ローカライズされたラーニングパスのタイトル。
`durationInMinutes`	`integer`	イエス	ラーニングパスの平均完了時間 (分)。
`summary`	`string`	イエス	ラーニングパスの簡単な説明。
`iconUrl`	`uri`	イエス	ラーニングパスを表す 100 ×100 SVG アイコンへの URL。
`levels`	`Level[]`	イエス	ラーニングパスに関連付けられているエクスペリエンスレベル。
`roles`	`Role[]`	イエス	関連するジョブロール。
`products`	`Product[]`	イエス	関連する製品分類。
`subjects`	`Subject[]`	イエス	関連するサブジェクト分類。
`modules`	`ModuleReference[]`	イエス	関連付けられているモジュール参照。
`updatedAt`	`date-time`	イエス	最終更新日時のタイムスタンプ。は、軽微な編集では変更されない場合があります。

応用スキル記録

適用された各スキルレコードの形式は次のとおりです。

{
  "type": "appliedSkills",
  "id": "applied-skill.deploy-and-configure-azure-monitor",
  "locale": "en-us",
  "title": "Microsoft Applied Skills: Deploy and configure Azure Monitor",
  "summary": "<p>To earn this Microsoft Applied Skills credential, learners demonstrate the ability to deploy and configure monitoring for Azure infrastructure.</p>\n<p>Candidates for this assessment lab should be familiar with operating systems, networking, servers, and virtualization.</p>\n",
  "iconUrl": "https://learn.microsoft.com/",
  "url": "https://learn.microsoft.com/credentials/applied-skills/deploy-and-configure-azure-monitor/",
  "levels": [
    {
      "id": "intermediate",
      "name": ""
    }
  ],
  "roles": [
    {
      "id": "administrator",
      "name": "Administrator"
    }
  ],
  "products": [
    {
      "id": "azure-monitor",
      "name": "Azure Monitor"
    },
    {
      "id": "azure-virtual-machines",
      "name": "Azure Virtual Machines"
    },
    {
      "id": "azure-virtual-network",
      "name": "Azure Virtual Network"
    },
    {
      "id": "windows-server",
      "name": "Windows Server"
    }
  ],
  "subjects": [
    {
      "id": "it-management-monitoring",
      "name": "IT management and monitoring"
    }
  ],
  "updatedAt": "2026-02-06T00:10:57.0000000Z"
}

物件の詳細

プロパティ	タイプ	必須	Description
`type`	`enum`	イエス	型識別子。許可: `appliedSkills`。
`id`	`string`	イエス	Microsoft Learn 全体でのこの適用されたスキルの一意の識別子。
`locale`	`string`	イエス	適用されたスキルが書き込まれるロケール。要求されたロケールが使用できない場合は、 `en-us` にフォールバックします。
`title`	`string`	イエス	ローカライズされた適用されたスキルのタイトル。
`summary`	`string`	イエス	適用されたスキルの簡単な説明。
`iconUrl`	`uri`	イエス	適用されたスキルを表す 100×100 SVG アイコンへの URL。
`url`	`uri`	イエス	要求されたロケールにおける適用されたスキルへの完全修飾 URL。
`levels`	`Level[]`	イエス	この適用されたスキルに関連付けられているエクスペリエンスレベル。
`roles`	`Role[]`	イエス	関連するジョブロール。
`products`	`Product[]`	イエス	関連する製品分類。
`subjects`	`Subject[]`	イエス	関連するサブジェクト分類。
`updatedAt`	`date-time`	イエス	最終更新日時のタイムスタンプ。は、マイナー更新の場合も変更されない可能性があります。

認定記録

各認定レコードの形式は次のとおりです。

{
  "type": "certification",
  "id": "certification.d365-functional-consultant-customer-service",
  "locale": "en-us",
  "title": "Microsoft Certified: Dynamics 365 Customer Service Functional Consultant Associate (Legacy with Power Platform)",
  "subtitle": "<p>If you’re a functional consultant responsible for configuring and implementing Dynamics 365 solutions for customers, you can use this certification to shine a light on your skills and to help advance your career. A Dynamics 365 Customer Service functional consultant implements omnichannel solutions that focus on service, quality, reliability, efficiency, and customer satisfaction. As a functional consultant, you know how to work with project managers, developers, and solution architects. You need a minimum of one to three years of experience as a functional consultant implementing Dynamics 365.</p>\n<p>If you need more experience before you try to earn this certification, here are some suggestions:</p>\n<ul>\n<li>Work as a Dynamics 365 functional consultant on one or more projects.</li>\n<li>Work on a Dynamics 365 Customer Service implementation.</li>\n<li>Join the community at <a href=\"https://community.dynamics.com/\">community.dynamics.com</a>.</li>\n<li>Take available learning paths on <a href=\"/training/browse/?expanded=dynamics-365&amp;products=dynamics-customer-service&amp;roles=functional-consultant&amp;resource_type=learning%20path\">Microsoft Learn</a>.</li>\n<li>Complete more hands-on practice.</li>\n<li>Sign up for an instructor-led training course.</li>\n</ul>\n<div class=\"WARNING\">\n<p>Warning</p>\n<p>This version of the certification is no longer available. <a href=\"https://techcommunity.microsoft.com/t5/microsoft-learn-blog/new-exam-structure-for-dynamics-365-certifications-for-customer/ba-p/3500861\">Read this blog post for more information about this change</a>.</p>\n</div>\n",
  "iconUrl": "https://learn.microsoft.com/media/learn/certification/badges/microsoft-certified-associate-badge.svg",
  "url": "https://learn.microsoft.com/credentials/certifications/d365-functional-consultant-customer-service-legacy-with-power-platform/",
  "levels": [
    {
      "id": "intermediate",
      "name": ""
    }
  ],
  "roles": [
    {
      "id": "business-analyst",
      "name": "Business Analyst"
    },
    {
      "id": "developer",
      "name": "Developer"
    },
    {
      "id": "functional-consultant",
      "name": "Functional Consultant"
    }
  ],
  "products": [
    {
      "id": "power-apps",
      "name": "Power Apps"
    },
    {
      "id": "power-bi",
      "name": "Power BI"
    },
    {
      "id": "power-automate",
      "name": "Power Automate"
    },
    {
      "id": "dataverse",
      "name": "Microsoft Dataverse"
    },
    {
      "id": "ai-builder",
      "name": "AI Builder"
    },
    {
      "id": "power-platform",
      "name": "Microsoft Power Platform"
    },
    {
      "id": "office-teams",
      "name": "Microsoft Teams"
    },
    {
      "id": "microsoft-copilot-studio",
      "name": "Microsoft Copilot Studio"
    },
    {
      "id": "dynamics-365",
      "name": "Dynamics 365"
    },
    {
      "id": "dynamics-customer-service",
      "name": "Customer Service"
    }
  ],
  "subjects": [],
  "certificationType": {
    "id": "role-based",
    "name": "role-based"
  },
  "renewalFrequencyInDays": 0,
  "prerequisites": [],
  "exams": [
    {
      "id": "exam.mb-230"
    }
  ],
  "updatedAt": "2024-10-08T15:40:00.0000000Z"
}

物件の詳細

プロパティ	タイプ	必須	Description
`type`	`enum`	イエス	型識別子。許可: `certification`。
`id`	`string`	イエス	Microsoft Learn 全体で使用されるこの認定のユニークな識別子。
`locale`	`string`	イエス	認定が書き込まれるロケール。要求されたロケールが使用できない場合は、 `en-us` にフォールバックします。
`title`	`string`	イエス	ローカライズされた認定タイトル。
`subtitle`	`string`	イエス	ローカライズされた認定サブタイトル。
`iconUrl`	`uri`	イエス	認定を表す 100 ×100 SVG アイコンへの URL。
`url`	`uri`	イエス	要求されたロケールでの認定に対応する完全な形式の URL。
`levels`	`Level[]`	イエス	この認定に関連付けられているエクスペリエンスレベル。
`roles`	`Role[]`	イエス	関連するジョブロール。
`products`	`Product[]`	イエス	関連する製品分類。
`subjects`	`Subject[]`	イエス	関連するサブジェクト分類。
`certificationType`	`Taxonomy`	イエス	認定の種類を表す分類。
`renewalFrequencyInDays`	`integer`	イエス	この認定が期限切れになるまでの日数。 `0` は期限切れではないことを意味します。
`prerequisites`	`string[]`	イエス	この認定を取得するための推奨される前提条件の一覧。
`exams`	`ExamReference[]`	イエス	この認定に必要な関連試験。
`updatedAt`	`date-time`	イエス	前回の更新のタイムスタンプ。は、軽微な編集では変更されない場合があります。

試験の記録

各試験レコードの形式は次のとおりです。

{
  "type": "exam",
  "id": "exam.77-881",
  "locale": "en-us",
  "title": "Word 2010",
  "subtitle": "The core-level Microsoft Office Word 2010 user should be able to navigate Microsoft Office Word 2010 software at the feature and functional level. They should be familiar with and know how to use at least 80 percent of the features and capabilities of Microsoft Office Word 2010. The core-level user should be able to use Microsoft Office Word 2010 to create and edit professional-looking documents for a variety of purposes and situations. Users would include people from a wide variety of job roles from almost all areas of professional, student, and personal life.",
  "iconUrl": "https://learn.microsoft.com/media/learn/certification/badges/certification-exam.svg",
  "url": "https://learn.microsoft.com/credentials/certifications/exams/77-881/",
  "levels": [
    {
      "id": "beginner",
      "name": ""
    }
  ],
  "roles": [
    {
      "id": "business-user",
      "name": "Business User"
    }
  ],
  "products": [
    {
      "id": "office-word",
      "name": "Word"
    }
  ],
  "locales": [],
  "examNumber": "77-881",
  "pdfUrl": "https://learn.microsoft.comhttps//query.prod.cms.rt.microsoft.com/cms/api/am/binary/RE4trjX",
  "practiceAssessmentUrl": "https://learn.microsoft.com/",
  "providers": [],
  "courses": [],
  "studyGuide": [],
  "updatedAt": "2026-02-06T00:10:57.0000000Z"
}

物件の詳細

プロパティ	タイプ	必須	Description
`type`	`enum`	イエス	型識別子。許可: `exam`。
`id`	`string`	イエス	Microsoft Learn 内でこの試験を一意に識別するための識別子。
`locale`	`string`	イエス	試験が記述されているロケール。要求されたロケールが使用できない場合は、 `en-us` にフォールバックします。
`title`	`string`	イエス	ローカライズされた試験のタイトル。
`subtitle`	`string`	イエス	ローカライズされた試験のサブタイトル。
`iconUrl`	`uri`	イエス	試験を表す 100 ×100 SVG アイコンへの URL。
`url`	`uri`	イエス	要求されたロケールでの試験の完全修飾 URL。
`levels`	`Level[]`	イエス	この試験に関連する経験レベル。
`roles`	`Role[]`	イエス	関連するジョブロール。
`products`	`Product[]`	イエス	関連する製品分類。
`locales`	`Locale[]`	イエス	試験が正式に提供されている言語。
`examNumber`	`string`	イエス	試験番号識別子。
`pdfUrl`	`uri`	いいえ	この試験の "スキル測定済み" PDF への URL。
`practiceAssessmentUrl`	`uri`	いいえ	この試験の無料実習評価用URL。
`providers`	`Provider[]`	いいえ	この試験を提供するプロバイダー。
`courses`	`Course[]`	いいえ	この試験に関連付けられているインストラクター主導のコース。
`studyGuide`	`StudyGuideRef[]`	いいえ	関連する学習ガイドの内容（ポリモーフィック参照）。
`updatedAt`	`date-time`	イエス	最終更新日時のタイムスタンプ。は、軽微な編集では変更されない場合があります。

インストラクター主導のコース記録

各コースレコードの形式は次のとおりです。

{
  "type": "course",
  "id": "course.ai-900t00",
  "url": "https://learn.microsoft.com/training/courses/ai-900t00/",
  "locale": "en-us",
  "title": "Introduction to AI in Azure",
  "summary": "<p>This course introduces fundamentals concepts related to artificial intelligence (AI), and the services in Microsoft Azure that can be used to create AI solutions. The course is not designed to teach students to become professional data scientists or software developers, but rather to build awareness of common AI workloads and the ability to identify Azure services to support them. The course is designed as a blended learning experience that combines instructor-led training with online materials on the Microsoft Learn platform (<a href=\"https://azure.com/learn\">https://azure.com/learn</a>). The hands-on exercises in the course are based on Learn modules, and students are encouraged to use the content on Learn as reference materials to reinforce what they learn in the class and to explore topics in more depth.</p>\n<h4 id=\"audience-profile\">Audience Profile</h4>\n<p>The Introduction to AI in Azure course is designed for anyone interested in learning about the types of solution artificial intelligence (AI) makes possible, and the services on Microsoft Azure that you can use to create them. You don’t need to have any experience of using Microsoft Azure before taking this course, but a basic level of familiarity with computer technology and the Internet is assumed. Some of the concepts covered in the course require a basic understanding of mathematics, such as the ability to interpret charts. The course includes hands-on activities that involve working with data and running code, so a knowledge of fundamental programming principles will be helpful.</p>\n",
  "iconUrl": "https://learn.microsoft.com/media/learn/certification/course.svg",
  "courseNumber": "AI-900T00",
  "durationInHours": 24,
  "locales": [
    {
      "id": "en",
      "name": "en"
    },
    {
      "id": "ar",
      "name": "ar"
    },
    {
      "id": "zh-cn",
      "name": "zh-cn"
    },
    {
      "id": "zh-tw",
      "name": "zh-tw"
    },
    {
      "id": "fr",
      "name": "fr"
    },
    {
      "id": "de",
      "name": "de"
    },
    {
      "id": "id",
      "name": "id"
    },
    {
      "id": "it",
      "name": "it"
    },
    {
      "id": "ja",
      "name": "ja"
    },
    {
      "id": "ko",
      "name": "ko"
    },
    {
      "id": "pt-br",
      "name": "pt-br"
    },
    {
      "id": "ru",
      "name": "ru"
    },
    {
      "id": "es",
      "name": "es"
    }
  ],
  "levels": [],
  "roles": [
    {
      "id": "ai-engineer",
      "name": "AI Engineer"
    }
  ],
  "products": [
    {
      "id": "azure",
      "name": "Azure"
    }
  ],
  "certification": {
    "id": "certification.azure-ai-fundamentals"
  },
  "studyGuide": [],
  "updatedAt": "2026-02-06T00:10:57.0000000Z"
},

物件の詳細

プロパティ	タイプ	必須	Description
`type`	`enum`	イエス	型識別子。許可: `course`。
`id`	`string`	イエス	Microsoft Learn 全体でこのコースを識別する一意の識別子。
`url`	`uri`	イエス	要求されたロケールでのコースの完全修飾 URL。
`locale`	`string`	イエス	コースが記述されているロケール。要求されたロケールが使用できない場合は、 `en-us` にフォールバックします。
`title`	`string`	イエス	ローカライズされたコースタイトル。
`summary`	`string`	イエス	コースの簡単な説明。
`iconUrl`	`uri`	イエス	コースを表す 100 ×100 SVG アイコンへの URL。
`courseNumber`	`string`	イエス	インストラクター主導のコース番号。
`durationInHours`	`integer`	イエス	コースの平均所要時間 (時間単位)。
`locales`	`Locale[]`	イエス	コースが正式に提供されている言語。その他の言語は、パートナーによってサポートされる場合があります。
`levels`	`Level[]`	イエス	このコースに関連する経験レベル。
`roles`	`Role[]`	イエス	関連するジョブロール。
`products`	`Product[]`	イエス	関連する製品分類。
`exam`	`ExamRef`	いいえ	このコースに関連する試験。
`certification`	`CertRef`	いいえ	このコースの関連する認定。
`studyGuide`	`StudyGuideRef[]`	いいえ	関連する教材（多相参照）。
`updatedAt`	`date-time`	イエス	最終更新日時のタイムスタンプ。は、マイナー更新の場合も変更されない可能性があります。

レベル、製品、役割、テーマのレコード

levels、products、roles、およびsubjectsコレクションは、モジュールで使用される値とラーニングパスデータのフレンドリ名を提供します。 4 つのコレクションはすべて同じ図形を持っています。

{ 
    "id": "unique-id",
    "name": "name-of-item",
    "children": [
        { "id": "unique-id", "name": "name-of-item" },
        { "id": "unique-id", "name": "name-of-item" },
           ...
    ]
}

idは、他のカタログエントリに含まれるレベル、製品、ロール、およびサブジェクトの値と一致します。関連付けられている name は、エントリの英語で適切な名前を提供します。 children配列は省略可能であり、製品などの子リレーションシップを持つ値に対して階層型を有効にします。

たとえば、考えられるロールのセットを次に示します。

{
    ...
    "roles": [ 
        {
            "id": "administrator",
            "name": "Administrator"
        },
        {
            "id": "ai-engineer",
            "name": "AI Engineer"
        },
        {
            "id": "business-analyst",
            "name": "Business Analyst"
        },
        {
            "id": "developer",
            "name": "Developer"
        },
        ...
    ]
}

より具体的な製品カテゴリを提供するために子を含む製品のセットの例を次に示します。

{ 
    ...
    "products": [
        {
            "id": "dotnet",
            "name": ".NET",
            "children": [
                { "id": "dotnet-core", "name": ".NET Core" },
                { "id": "dotnet-standard", "name": ".NET Standard" },
                { "id": "aspnet-core", "name": "ASP.NET Core" },
                { "id": "ef-core", "name": "Entity Framework Core" }
            ]
        },
        {
            "id": "ms-graph",
            "name": "Microsoft Graph"
        },
        {
            "id": "office",
            "name": "Office",
            "children": [
                { "id": "office-365", "name": "Office 365" },
                { "id": "office-add-ins", "name": "Office Add-ins" },
                { "id": "office-teams", "name": "Teams" }
            ]
        },
        {
            "id": "sql-server",
            "name": "SQL Server"
        },
        ...
    ]
}

次のステップ

以下のリソースを確認して、開発の旅をサポートしましょう。

Last updated on 2026-02-11

次の方法で共有

プラットフォーム API 開発者向けリファレンス ドキュメントについて学習する

API エンドポイント

活用事例

Authentication

アプリ専用アクセス

委任されたアクセス

クエリ パラメーター

API 応答

応答本文

モジュールの応答

物件の詳細

単位レコード

物件の詳細

学習経路記録

物件の詳細

応用スキル記録

物件の詳細

認定記録

物件の詳細

試験の記録

物件の詳細

インストラクター主導のコース記録

物件の詳細

レベル、製品、役割、テーマのレコード

次のステップ

その他のリソース

プラットフォーム API 開発者向けリファレンスドキュメントについて学習する

クエリパラメーター