Freigeben über


App zu Team hinzufügen

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Installieren Sie eine App für das angegebene Team.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

Berechtigungen

Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) TeamsAppInstallation.ReadWriteSelfForTeam Directory.ReadWrite.All, Group.ReadWrite.All, TeamsAppInstallation.ManageSelectedForTeam, TeamsAppInstallation.ReadWriteAndConsentSelfForTeam, TeamsAppInstallation.ReadWriteForTeam
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Anwendung TeamsAppInstallation.ReadWriteSelfForTeam.All Directory.ReadWrite.All, Group.ReadWrite.All, TeamsAppInstallation.ManageSelectedForTeam.All, TeamsAppInstallation.ReadWriteAndConsentForTeam.All, TeamsAppInstallation.ReadWriteAndConsentSelfForTeam.All, TeamsAppInstallation.ReadWriteForTeam.All

Hinweis

  • Die Berechtigungen TeamsAppInstallation.ReadWriteSelfForTeam, TeamsAppInstallation.ReadWriteForTeam, TeamsAppInstallation.ReadWriteSelfForTeam.All und TeamsAppInstallation.ReadWriteForTeam.All können nicht zum Installieren von Apps verwendet werden, die eine Zustimmung zu ressourcenspezifischen Zustimmungsberechtigungen erfordern.
  • Die Berechtigungen Group.ReadWrite.All und Directory.ReadWrite.All werden nur aus Gründen der Abwärtskompatibilität unterstützt. Es wird empfohlen, dass Sie Ihre Lösungen so aktualisieren, dass sie eine alternative Berechtigung verwenden und diese Berechtigungen in Zukunft nicht mehr verwenden.

HTTP-Anforderung

POST /teams/{team-id}/installedApps

Anforderungsheader

Kopfzeile Wert
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.

Anforderungstext

Der Anforderungstext sollte die generierte App-ID der Katalog-App enthalten. Mehr dazu finden Sie unter teamsApp-Eigenschaften.

In der folgenden Tabelle sind weitere Eigenschaften aufgeführt, die in den Anforderungstext aufgenommen werden können.

Eigenschaft Typ Beschreibung
teamsApp Zeichenfolge Die ID der hinzuzufügenden App.
consentedPermissionSet teamsAppPermissionSet Der Satz von ressourcenspezifischen Berechtigungen, denen zugestimmt wird.

Hinweis: Die während der Installation genehmigten Berechtigungen müssen mit den ressourcenspezifischen Berechtigungen übereinstimmen, die in teamsAppDefinition der App vorhanden sind. Informationen zum Abrufen der Anwendung und delegierter ressourcenspezifischer Berechtigungen finden Sie unter Beispiel 7. Wenn in teamsAppDefinition nur delegierte ressourcenspezifische Berechtigungen vorhanden sind, können Berechtigungen im Text dieser Anforderung weggelassen werden.

Antwort

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 200 OK zurückgegeben. Es gibt nichts im Antworttext zurück.

Beispiele

Beispiel 1: Installieren einer App in einem Chat

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/beta/teams/87654321-0abc-zqf0-321456789q/installedApps
Content-type: application/json

{
   "teamsApp@odata.bind":"https://graph.microsoft.com/beta/appCatalogs/teamsApps/12345678-9abc-def0-123456789a"
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 200 OK

Um die Liste der ressourcenspezifischen Berechtigungen abzurufen, die für die App erforderlich sind, rufen Sie die App aus appCatalog ab, wie in Beispiel 7 gezeigt.

Anforderung

POST https://graph.microsoft.com/beta/teams/7023576d-9e40-47ca-9cf2-daae6838e785/installedApps
Content-Type: application/json

{
	"teamsApp@odata.bind" : "https://graph.microsoft.com/beta/appCatalogs/teamsApps/7023576d-9e40-47ca-9cf2-daae6838e785",
    "consentedPermissionSet": {
        "resourceSpecificPermissions": [
        {
          "permissionValue": "OnlineMeeting.ReadBasic.Chat",
          "permissionType": "delegated"
        },
        {
          "permissionValue": "ChatMessage.Read.Chat",
          "permissionType": "application"
        }]
      }
}

Antwort

HTTP/1.1 201 Created

Wenn Ihr Aufruf zu einer Fehlermeldung führt, die besagt The required permissions have not been consented to by the caller, dass der Anforderungstext nicht alle RSC-Berechtigungen angibt, die für die App erforderlich sind, für die der Benutzer seine Zustimmung erteilen muss. Stellen Sie sicher, dass Sie Ihre Anforderung wie im Beispiel gezeigt erstellen.