App zum Chatten 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.

Eine teamsApp für den angegebenen Chat installieren.

Anmerkungen:

  • Wenn der Chat einem onlineMeeting -Fall zugeordnet ist, wird die teamsApp in der Besprechung installiert.

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

Anforderungsheader

Kopfzeile Wert
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Der Anforderungstext sollte die vom Katalog generierte App-ID für den App-Katalog enthalten. Mehr dazu finden Sie unter teamsApp-Eigenschaften. In der folgenden Tabelle sind weitere Parameter aufgeführt, die mit dem Anforderungstext verwendet werden können.

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

Hinweis: Die Berechtigungen, denen während der Installation 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 201 Created zurückgegeben.

Beispiele

Beispiel 1: App in einem Chat installieren

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/beta/chats/19:ea28e88c00e94c7786b065394a61f296@thread.v2/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 201 Created

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
Content-Type: application/json

{
	"teamsApp@odata.bind" : "https://graph.microsoft.com/beta/appCatalogs/teamsApps/2b524e28-95ce-4c9b-9773-4a5bd6ec1770",
    "consentedPermissionSet": {
        "resourceSpecificPermissions": [
        {
          "permissionValue": "OnlineMeeting.ReadBasic.Chat",
          "permissionType": "Delegated"
        },
        {
          "permissionValue": "OnlineMeetingIncomingAudio.Detect.Chat",
          "permissionType": "Delegated"
        },
        {
          "permissionValue": "ChatMember.Read.Chat",
          "permissionType": "Application"
        },
        {
          "permissionValue": "ChatMessage.Read.Chat",
          "permissionType": "Application"
        }]
      }
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 201 Created