- Solicitação HTTP
- Parâmetros de caminho
- Parâmetros de consulta
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- Faça um teste
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 oid
da pessoa na API People ou oid
do usuário na API Directory. Por exemplo, se o ID do perfil de pessoa da API People parauser@example.com
for123456789
, definamembership.member.name
comousers/user@example.com
ouusers/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}
é oid
do grupo na API Cloud Identity Groups. Por exemplo, você pode usar a API Cloud Identity Groups lookup para recuperar o ID123456789
do e-mail do grupogroup@example.com
e, em seguida, adicionar ou convidar o grupo para um espaço nomeado definindomembership.group_member.name
comogroups/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 |
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 |
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 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.