Method: spaces.members.create

Cria uma assinatura humana ou uma assinatura no app para o app de chamada. Não é possível criar associações para outros apps. Confira um exemplo em Convidar ou adicionar um usuário ou um app do Google Chat a um espaço. Ao criar uma participação, se a política de aceitação automática do participante especificado estiver desativada, ele vai receber um convite e precisará aceitar o convite do espaço antes de entrar. Caso contrário, a criação da assinatura adiciona o participante diretamente ao espaço especificado. Exige a autenticação do usuário.

Para especificar o participante a ser adicionado, defina membership.member.name para o membro humano ou do app ou defina membership.group_member.name para o participante do grupo.

  • Para adicionar o app de chamada a um espaço ou uma mensagem direta entre dois usuários humanos, use users/app. Não foi possível adicionar outros apps ao espaço.

  • Para adicionar um usuário humano, use users/{user}, em que {user} pode ser o endereço de e-mail do usuário. Para usuários na mesma organização do Workspace, {user} também pode ser o id da pessoa na API People ou o id do usuário na API Directory. Por exemplo, se o ID do perfil de pessoa da API People para user@example.com for 123456789, defina membership.member.name como users/user@example.com ou users/123456789 para adicionar o usuário ao espaço.

  • Para adicionar ou convidar um grupo do Google em um espaço nomeado, use groups/{group}, em que {group} é o id do grupo na API Cloud Identity Groups. Por exemplo, você pode usar a API Cloud Identity Groups lookup para recuperar o ID 123456789 do e-mail do grupo group@example.com e, em seguida, adicionar ou convidar o grupo para um espaço nomeado definindo membership.group_member.name como groups/123456789. Não é possível usar o e-mail do grupo, e os grupos do Google só podem ser adicionados como participantes em espaços nomeados.

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: espaços/{space}

Parâmetros de consulta

Parâmetros
useAdminAccess

boolean

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 "Gerenciar conversas de chats e espaços".

Exige o escopo OAuth 2.0 chat.admin.memberships.

Não é possível criar assinaturas do app ou criar assinaturas para usuários fora da organização do Google Workspace do administrador usando o acesso de 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.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.