Method: spaces.members.delete

Exclui uma assinatura. Confira um exemplo em Remover um usuário ou um app do Google Chat de um espaço.

Oferece suporte aos seguintes tipos de autenticação:

  • Autenticação de app com aprovação do administrador na Prévia para desenvolvedores e o escopo de autorização:

    • https://www.googleapis.com/auth/chat.app.memberships

  • Autenticação do usuário com um dos seguintes escopos de autorização:

    • https://www.googleapis.com/auth/chat.memberships
    • https://www.googleapis.com/auth/chat.memberships.app (para remover o app de chamada do espaço)
    • https://www.googleapis.com/auth/chat.import (somente espaços do modo de importação)
    • A autenticação do usuário concede privilégios de administrador quando uma conta de administrador é autenticada, useAdminAccess é true e o seguinte escopo de autorização é usado:
      • https://www.googleapis.com/auth/chat.admin.memberships

Para excluir as inscrições de administradores do espaço, o solicitante precisa ser um administrador do espaço. Se você estiver usando a autenticação de app, o aplicativo precisa ser o criador do espaço.

Solicitação HTTP

DELETE https://chat.googleapis.com/v1/{name=spaces/*/members/*}

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
name

string

Obrigatório. Nome do recurso da assinatura a ser excluída. Os apps de chat podem excluir as assinaturas dos usuários humanos ou as próprias assinaturas. Os apps de chat não podem excluir as assinaturas de outros apps.

Ao excluir uma associação humana, é necessário o escopo chat.memberships com autenticação do usuário ou o escopo chat.memberships.app com autenticação do app e o formato spaces/{space}/members/{member}. Você pode usar o e-mail como um alias para {member}. Por exemplo, spaces/{space}/members/example@gmail.com, em que example@gmail.com é o e-mail do usuário do Google Chat.

Ao excluir uma associação a um app, é necessário o escopo chat.memberships.app e o formato spaces/{space}/members/app.

Formato: spaces/{space}/members/{member} ou spaces/{space}/members/app.

Parâmetros de consulta

Parâmetros
useAdminAccess

boolean

Opcional. Quando true, o método é executado usando os privilégios de administrador do Google Workspace do usuário.

O usuário que faz a chamada precisa ser um administrador do Google Workspace com o privilégio de gerenciar chats e conversas em espaços.

Requer o escopo do OAuth 2.0 chat.admin.memberships.

Não é possível excluir as adesões a apps em um espaço usando o acesso de administrador.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Membership.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://www.googleapis.com/auth/chat.app.memberships
  • https://www.googleapis.com/auth/chat.admin.memberships
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.app

Para mais informações, consulte o guia de autorização.