Method: spaces.members.delete

Exclui uma assinatura. Por exemplo, consulte Remover um usuário ou um app do Google Chat de um espaço.

Aceita os seguintes tipos de autenticação:

  • Autenticação de app com aprovação do administrador e o escopo de autorização:

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

  • Autenticação de 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 chamadas do espaço)
    • https://www.googleapis.com/auth/chat.import (somente espaços do modo de importação)
    • A autenticação de 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

A autenticação de app não é compatível com os seguintes casos de uso:

  • Remover um grupo do Google de um espaço.
  • Remover um app do Chat de um espaço.

Para excluir assinaturas de administradores do espaço, o solicitante precisa ser um administrador do espaço. Se você estiver usando a autenticação de app, o app Chat 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. Os apps de chat não podem excluir assinaturas de outros apps.

Ao excluir uma assinatura 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 assinatura de app, exige 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 conversas no Chat e nos espaços.

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

Não é possível excluir as associações de 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.