Method: spaces.members.create

Cria uma associação para o app de chat que está fazendo a chamada, um usuário ou um grupo do Google. Não é possível criar assinaturas para outros apps de chat. Ao criar uma assinatura, se o membro especificado tiver a política de aceitação automática desativada, ele vai receber um convite e precisará aceitá-lo antes de entrar no espaço. Caso contrário, a criação de uma assinatura vai adicionar o participante diretamente ao espaço especificado.

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 adicionar o app de chamada ao 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

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

  • Convide usuários externos à organização do Workspace que é proprietária do espaço.
  • Adicionar um grupo do Google a um espaço.
  • Adicionar um app do Chat a um espaço.

Para conferir exemplos de uso, consulte:

Solicitação HTTP

POST https://chat.googleapis.com/v1/{parent=spaces/*}/members

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

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O nome do recurso do espaço em que a associação será criada.

Formato: spaces/{space}

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 usar o acesso de administrador para criar assinaturas de apps ou assinaturas para usuários fora da organização do Google Workspace do administrador.

Corpo da solicitação

O corpo da solicitação contém uma instância de Membership.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta incluirá 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.