Integrieren Ihrer Teams-App in Bildungsaufgaben

  • Artikel

Die Bildungscommunity verfügt über eine Vielzahl von Tools und Anwendungen, die die Erfahrung für Lehrkräfte und Benutzer verbessern. Sie können Microsoft Graph-APIs verwenden, um Ihre Lösung für Lehrkräfte und Schüler verfügbar zu machen, indem Sie Ihre App in Aufgaben in Teams integrieren.

Hinweis: Sie können Graph Explorer verwenden, um die in diesem Artikel erwähnten APIs zu testen.

Erstellen einer Microsoft Teams-App

Microsoft Teams bietet eine Sammlung von Apps, die von Microsoft oder externen Diensten bereitgestellt werden. Die Apps können Registerkarten, Bots, Nachrichtenerweiterungen oder Ressourcen sein.

Informationen zu den ersten Schritten beim Erstellen Einer eigenen Teams-App finden Sie unter Erstellen einer neuen Teams-App.

Bewährte Methoden für die Integration Ihrer Teams-App in Zuweisungen finden Sie im Beispiel für Zuweisungs-Apps.

Ausführliche Informationen zu den Anforderungen für die Integration in den Aufgabenflow in Teams finden Sie unter Integrationsanforderungen für Zuweisungs-Apps.

Anfordern der Aktivierung Ihrer Teams-App für Zuweisungsflows

Nachdem Sie Ihre Teams-App erstellt und veröffentlicht haben, muss Ihre App aktiviert sein, bevor Sie in Aufgaben integrieren können. Füllen Sie dieses Formular aus, um die Aktivierung Ihrer App anzufordern.

Hinzufügen Ihrer Teams-App zu einer Aufgabe

Ihre Teams-App kann als Zuweisungsressource hinzugefügt werden.

  1. Rufen Sie die Anwendungs-ID mithilfe dieses Endpunkts ab. Geben Sie keinen Anforderungstext an.
GET /appCatalogs/teamsApps?$filter=displayName eq 'APPLICATION NAME'
  1. Fügen Sie die Teams-App an eine Aufgabe an.

Anforderung

Das folgende Beispiel zeigt eine Anfrage. Verwenden Sie die ID aus der vorherigen Anforderung für den AppId-Eigenschaftswert .

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

Antwort

Das folgende Beispiel zeigt die Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

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. Die Teams-App wird jetzt der Aufgabe hinzugefügt und steht den Kursteilnehmern zum Starten zur Verfügung.

Ein Beispiel zum Integrieren einer Teams-App in eine Aufgabe finden Sie unter Beispiel 7: Erstellen einer educationTeamsAppResource.

Berechtigungen

Die Zuweisungs-API unterstützt sowohl delegierte (pro Benutzer) als auch nur App-Berechtigungen (pro App). Aus Gründen der Benutzerfreundlichkeit für Kursteilnehmer und Lehrer werden Nur-App-Berechtigungen bevorzugt. Dies ermöglicht die Genehmigung Ihrer App nur zum Abrufen von Daten.