次の方法で共有

Teams アプリを教育課題と統合する

教育コミュニティには、教師とユーザーのエクスペリエンスを強化する豊富なツールとアプリケーションのセットがあります。 Microsoft Graph API を使用すると、アプリを Teams の課題と統合することで、教師や学生がソリューションを利用できるようにします。

メモ：Graph エクスプローラーを使用して、この記事で説明されている API をテストできます。

Microsoft Teams アプリを作成する

Microsoft Teams では、Microsoft または外部のサービスによって提供されるアプリのコレクションが用意されています。 アプリには、タブ、ボット、メッセージ拡張機能、またはリソースを指定できます。

独自の Teams アプリの構築を開始するには、「 新しい Teams アプリを作成する」を参照してください。

Teams アプリと割り当てを統合するためのベスト プラクティスについては、 割り当てアプリのサンプルを参照してください。

Teams の割り当てフローと統合するための要件の詳細については、「 割り当てアプリの統合要件」を参照してください。

割り当てフローに対して Teams アプリを有効にする要求

Teams アプリを作成して発行した後、割り当てと統合する前に、アプリを有効にする必要があります。 アプリを有効にするよう要求するには、このフォームに入力 します。

Teams アプリを割り当てに追加する

Teams アプリは 、割り当て リソースとして追加できます。

  1. このエンドポイントを使用してアプリケーション ID を 取得します。 要求本文を指定しないでください。
GET /appCatalogs/teamsApps?$filter=displayName eq 'APPLICATION NAME'
  1. Teams アプリを割り当てにアタッチします。

要求

次の例は要求を示しています。 appId プロパティ値には、前の要求の ID を使用します。

POST https://graph.microsoft.com/beta/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/1618dfb0-3ff2-4edf-8d5c-b8f81df00e80/resources
Content-type: application/json

{
    "distributeForStudentWork": false,
    "resource": {
        "contentUrl": "https://sd-prod-us-web-galileo.azurewebsites.net/assets/content.html",
        "appId": "7caaa66b-34b0-4c15-a65d-dba6edf0c8fd",
        "appIconUrl": "https://statics.teams.cdn.office.net/evergreen-assets/ThirdPartyApps/7caaa66b-34b0-4c15-a65d-dba6edf0c8fd_largeImage.png?v=1.3.0",
        "displayName": "School Day",
        "websiteUrl": "https://sd-prod-us-web-galileo.azurewebsites.net/",
        "@odata.type": "#microsoft.graph.educationTeamsAppResource"
    }
}

Response

次の例は応答を示しています。

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

HTTP/1.1 201 Created
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('72a7baec-c3e9-4213-a850-f62de0adad5f')/assignments('1618dfb0-3ff2-4edf-8d5c-b8f81df00e80')/resources/$entity",
    "distributeForStudentWork": false,
    "status": "published",
    "id": "de220fbc-865a-4c8e-a013-fc5dabe0f817",
    "resource": {
        "@odata.type": "#microsoft.graph.educationTeamsAppResource",
        "displayName": "School Day",
        "createdDateTime": "2022-12-21T02:17:01.9365101Z",
        "lastModifiedDateTime": "2022-12-21T02:17:01.9365342Z",
        "appId": "7caaa66b-34b0-4c15-a65d-dba6edf0c8fd",
        "appIconUrl": "https://statics.teams.cdn.office.net/evergreen-assets/ThirdPartyApps/7caaa66b-34b0-4c15-a65d-dba6edf0c8fd_largeImage.png?v=1.3.0",
        "contentUrl": "https://sd-prod-us-web-galileo.azurewebsites.net/assets/content.html",
        "websiteUrl": "https://sd-prod-us-web-galileo.azurewebsites.net/",
        "createdBy": {
            "application": null,
            "device": null,
            "user": {
                "id": "cb1a4af3-0aba-4679-aa12-9f99bab0b61a",
                "displayName": null
            }
        },
        "lastModifiedBy": {
            "application": null,
            "device": null,
            "user": {
                "id": "cb1a4af3-0aba-4679-aa12-9f99bab0b61a",
                "displayName": null
            }
        }
    }
}
  1. Teams アプリが課題に追加され、学生が起動できるようになりました。

Teams アプリと割り当てを統合する方法を示す例については、「 例 7: educationTeamsAppResource を作成する」を参照してください。

アクセス許可

割り当て API では、委任された (ユーザーごと) アクセス許可とアプリ専用 (アプリごとの) アクセス許可の両方がサポートされています。 学生と教師の使いやすさを考慮して、アプリ専用のアクセス許可を使用することをお勧めします。 これにより、アプリがデータを取得するだけの承認が可能になります。