Graph エクスプローラーを使用して Microsoft Graph の教育 API を操作する

[アーティクル]
03/26/2023

Microsoft Graph の Education API を使用して、EDU データにアクセスするアプリケーションを構築できます。たとえば、School Data Sync (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 を貼り付けます。

```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
    }
```

[ クエリの実行] を選択します。クエリが成功すると、新しい割り当てを表す応答と JSON オブジェクトが取得 Created – 201 されます。
その他のクエリを試す。その他の例については、 Education API リファレンスコンテンツを参照してください。

次の手順

Microsoft Graph での教育機関 API の操作

次の方法で共有

Graph エクスプローラーを使用して Microsoft Graph の教育 API を操作する

次の手順

フィードバック

フィードバック

その他のリソース