Graph エクスプローラーを使用して Microsoft Graph の教育 API を操作する
Microsoft Graph の Education API を使用して、EDU データにアクセスするアプリケーションを構築できます。 たとえば、学校データ同期 (SDS) とMicrosoft Teamsからの情報を表示したり、学生の追加や課題の作成などの一般的なタスクを自動化したりできます。
Graph エクスプローラーを使用して、アプリケーションに実装する前に Microsoft Graph クエリをテストできます。
Graph エクスプローラーで Education API 呼び出しを試すには、次の手順に従います。
プライベート Web ブラウザーを開き、[developer.microsoft.com/en-us/graph/graph-explorer] に移動し、[Graph エクスプローラー にサインイン] を選択して、Office 365管理者アカウントの資格情報を入力します。
名簿 API にアクセスするには、対応するアクセス許可を Graph エクスプローラーに付与します。 [ アクセス許可の変更] に移動し、 EduRoster.ReadBasic を検索し、[同意] を選択 します。
すべてのクエリを実行する前に、アクセス許可が更新されるのを待つ必要がある場合があります。
学校の一覧を取得するには、クエリ フィールドに「
https://graph.microsoft.com/v1.0/education/schools」と入力し、[クエリの 実行] を選択します。クラスの一覧を取得するには、 クエリ フィールドに「
https://graph.microsoft.com/v1.0/education/classes」と入力し、[ クエリの実行] を選択します。そのクラスの割り当てを取得するには、最初のクラス ID
740202c8-5db7-4496-a055-9f3c9fd98207を取得します。 クエリ フィールドに「https://graph.microsoft.com/v1.0/education/classes/740202c8-5db7-4496-a055-9f3c9fd98207/assignments」と入力し、[ クエリの実行] を選択します。割り当て API にアクセスするには、Graph エクスプローラーに対応するアクセス許可を付与します。 [アクセス許可の変更] に移動し、EduAssignments.Read、EduAssignments.ReadBasic、EduAssignments.ReadWrite、EduAssignments.ReadWriteBasic を検索し、[同意] を選択します。
クエリを実行して割り当てを取得します。
これで、新しい割り当てを作成できます。 クエリ フィールドに「
https://graph.microsoft.com/v1.0/education/classes/740202c8-5db7-4496-a055-9f3c9fd98207/assignments」と入力します。 要求の種類に対して [POST] が選択されていることを確認します。[ 要求本文 ] フィールドに、次の JSON を貼り付けます。
{ "dueDateTime": "2024-02-15T00:00:00Z", "displayName": "Reading and comprehension", "instructions": { "contentType": "text", "content": "Read the chapter and answer the questions" }, "grading": { "@odata.type": "#microsoft.graph.educationAssignmentPointsGradeType", "maxPoints": 50 }, "assignTo": { "@odata.type": "#microsoft.graph.educationAssignmentClassRecipient" }, "allowStudentsToAddResourcesToSubmission": true }[ クエリの実行] を選択します。 クエリが成功すると、
Created – 201応答と、新しい割り当てを表す JSON オブジェクトが取得されます。
その他のクエリを試す。 その他の例については、 Education API リファレンス コンテンツを参照してください。