- 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 associação para o app de chat chamador, 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 adiciona o membro diretamente ao espaço especificado.
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 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 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:
- Convidar usuários externos à organização do Workspace proprietária do espaço.
- Adicionar um grupo do Google a um espaço.
- Adicionar um app do Chat a um espaço.
Para 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 |
Obrigatório. O nome do recurso do espaço para o qual a associação será criada. Formato: spaces/{space} |
Parâmetros de consulta
Parâmetros | |
---|---|
useAdminAccess |
Opcional. Quando 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 Não é possível criar assinaturas de apps ou 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.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.