Adicionar o aplicativo ao chat

Namespace: microsoft.graph

Instale um teamsApp para o chatespecificado.

Observações:

  • Se o chat estiver associado a uma instância do onlineMeeting, então, efetivamente, o teamsApp será instalado na reunião.

Essa API está disponível nas seguintes implantações de nuvem nacional.

Serviço global Governo dos EUA L4 US Government L5 (DOD) China operada pela 21Vianet

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão Permissões menos privilegiadas Permissões com privilégios mais elevados
Delegado (conta corporativa ou de estudante) TeamsAppInstallation.ReadWriteSelfForChat TeamsAppInstallation.ManageSelectedForChat, TeamsAppInstallation.ReadWriteAndConsentForChat, TeamsAppInstallation.ReadWriteAndConsentSelfForChat, TeamsAppInstallation.ReadWriteForChat
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application TeamsAppInstallation.ReadWriteSelfForChat.All Chat. Gerar. Chat, TeamsAppInstallation.ManageSelectedForChat.All, TeamsAppInstallation.ReadWriteAndConsentForChat.All, TeamsAppInstallation.ReadWriteAndConsentSelfForChat.All, TeamsAppInstallation.ReadWriteForChat.All

Observação

Essas permissões TeamsAppInstallation.ReadWriteSelfForChat, TeamsAppInstallation.ReadWriteForChat, TeamsAppInstallation.ReadWriteSelfForChat.All e TeamsAppInstallation.ReadWriteForChat.All não podem ser usadas para instalar aplicativos que exigem consentimento para permissões específicas do recurso.

Solicitação HTTP

POST /chats/{chat-id}/installedApps

Cabeçalhos de solicitação

Cabeçalho Valor
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type application/json. Obrigatório.

Corpo da solicitação

O corpo da solicitação deve incluir a ID do aplicativo de catálogo gerada. Para obter mais informações, consulte Propriedades do teamsApp. A tabela a seguir lista outros parâmetros que podem ser usados com o corpo da solicitação.

Parâmetro Tipo Descrição
consentedPermissionSet teamsAppPermissionSet Conjunto de permissões específicas do recurso que estão sendo consentidas.

Observação: As permissões consentidas durante a instalação devem corresponder às permissões específicas do recurso definidas no teamsAppDefinition do aplicativo. Para obter o aplicativo e as permissões específicas do recurso delegadas, consulte o Exemplo 6. Se apenas permissões específicas do recurso delegadas forem especificadas no teamsAppDefinition, as permissões poderão ser omitidas no corpo da solicitação.

Resposta

Se tiver êxito, este método retornará um código de resposta 201 Created.

Exemplos

Exemplo 1: Instalar o aplicativo em um chat

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/v1.0/chats/19:ea28e88c00e94c7786b065394a61f296@thread.v2/installedApps
Content-Type: application/json

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

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 201 Created

Para obter a lista de permissões específicas do recurso exigidas pelo aplicativo, obtenha o aplicativo do appCatalog, conforme mostrado no Exemplo 6.

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/v1.0/chats/19:ea28e88c00e94c7786b065394a61f296@thread.v2/installedApps
Content-Type: application/json

{
  "teamsApp@odata.bind" : "https://graph.microsoft.com/v1.0/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"
        }]
      }
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 201 Created