teamsAppInstallation: Upgrade

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.

Aktualisieren einer App-Installation in einem Chat.

Hinweis:

  • Wenn der Chat einer onlineMeeting-instance zugeordnet ist, wird die in der Besprechung installierte teamsApp effektiv aktualisiert.

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

Weltweiter Service US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet
✅ ✅ ✅ ✅

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. 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.ReadWriteSelfForChat TeamsAppInstallation.ManageSelectedForChat, TeamsAppInstallation.ReadWriteAndConsentForChat, TeamsAppInstallation.ReadWriteAndConsentSelfForChat, TeamsAppInstallation.ReadWriteForChat
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Application TeamsAppInstallation.ReadWriteSelfForChat.All Chat. Verwalten. Chat, TeamsAppInstallation.ManageSelectedForChat.All, TeamsAppInstallation.ReadWriteAndConsentForChat.All, TeamsAppInstallation.ReadWriteAndConsentSelfForChat.All, TeamsAppInstallation.ReadWriteForChat.All

Hinweis

  • Die Berechtigungen TeamsAppInstallation.ReadWriteSelfForChat, TeamsAppInstallation.ReadWriteForChat, TeamsAppInstallation.ReadWriteSelfForChat.All und TeamsAppInstallation.ReadWriteForChat.All können nicht verwendet werden, um Apps zu installieren, die die Zustimmung zu ressourcenspezifischen Berechtigungen erfordern.
  • Der Chat. Verwalten. Die Berechtigung "Chat" verwendet die ressourcenspezifische Zustimmung.

HTTP-Anforderung

POST /chats/{chat-id}/installedApps/{app-installation-id}/upgrade

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung der Parameter an.

In der folgenden Tabelle sind weitere Parameter aufgeführt, die bei der Upgradeaktion verwendet werden können.

Parameter Typ Beschreibung
consentedPermissionSet teamsAppPermissionSet Der Satz ressourcenspezifischer Berechtigungen, denen zugestimmt wird.

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

Antwort

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No Content zurückgegeben.

Beispiele

Beispiel 1: Aktualisieren der im Chat installierten Teams-App

Anforderung

Im folgenden Beispiel wird eine in einem Chat installierte App aktualisiert.

POST https://graph.microsoft.com/beta/chats/19:ea28e88c00e94c7786b065394a61f296@thread.v2/installedApps/NjRiOWM3NDYtYjE1NS00MDQyLThkNDctOTQxYmQzODE2ODFiIyMwZDgyMGVjZC1kZWYyLTQyOTctYWRhZC03ODA1NmNkZTdjNzg=/upgrade

{

}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content

Die Liste der ressourcenspezifischen Berechtigungen, die von der App benötigt werden, finden Sie in AppCatalog, wie in Beispiel 7 gezeigt.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/beta/chats/19:ea28e88c00e94c7786b065394a61f296@thread.v2/installedApps/NjRiOWM3NDYtYjE1NS00MDQyLThkNDctOTQxYmQzODE2ODFiIyMwZDgyMGVjZC1kZWYyLTQyOTctYWRhZC03ODA1NmNkZTdjNzg=/upgrade
Content-Type: application/json

{
  "consentedPermissionSet": {
      "resourceSpecificPermissions": [
      {
        "permissionValue": "OnlineMeeting.ReadBasic.Chat",
        "permissionType": "Delegated"
      },
      {
        "permissionValue": "ChatMember.Read.Chat",
        "permissionType": "Application"
      }]
    }
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content