Neste guia, explicamos como usar o método create
no recurso membership
da API Google Chat para convidar ou adicionar um usuário ou um app do Chat a um espaço, também conhecido como criação de assinatura. Ao criar uma assinatura, se o participante especificado estiver com a política de aceitação automática desativada, ele será convidado e precisará aceitar o convite do espaço antes de entrar. Caso contrário, a criação de uma associação vai adicionar o participante
diretamente ao espaço especificado.
O
recurso Membership
representa se um usuário humano ou app do Google Chat foi convidado,
parte de ou ausente de um espaço.
Pré-requisitos
Python
- Python 3.6 ou superior
- A ferramenta de gerenciamento de pacotes pip
As bibliotecas de cliente mais recentes do Google para Python. Para instalar ou atualizar, execute o seguinte na interface de linha de comando:
pip3 install --upgrade google-api-python-client google-auth-oauthlib
- Um projeto do Google Cloud com a API Google Chat ativada e configurada. Veja as etapas em Criar um app do Google Chat.
Autorização configurada para o app do Chat. Para criar uma assinatura, é necessário ter a autenticação do usuário com o escopo de autorização
chat.memberships
ouchat.memberships.app
.
Node.js
- Node.js e npm
As bibliotecas de cliente mais recentes do Google para Node.js. Para instalá-los, execute o seguinte comando na interface de linha de comando:
npm install @google-cloud/local-auth @googleapis/chat
- Um projeto do Google Cloud com a API Google Chat ativada e configurada. Veja as etapas em Criar um app do Google Chat.
Autorização configurada para o app do Chat. Para criar uma assinatura, é necessário ter a autenticação do usuário com o escopo de autorização
chat.memberships
ouchat.memberships.app
.
Convidar ou adicionar um usuário a um espaço
Para convidar ou adicionar um usuário a um espaço, envie o seguinte comando na sua solicitação:
- Especifique o escopo de autorização
chat.memberships
. - Chame o
método
create
no recursomembership
. - Defina
parent
como o nome do recurso do espaço em que a associação será criada. - Defina
member
comousers/{user}
, em que{user}
é a pessoa para quem você quer criar a assinatura e é:- O ID da
pessoa
na API People. Por exemplo, se a pessoa
resourceName
da API People forpeople/123456789
, definamembership.member.name
comousers/123456789
. - O ID do usuário na API Directory.
- O endereço de e-mail do usuário. Por exemplo,
users/222larabrown@gmail.com
ouusers/larabrown@cymbalgroup.com
. Se o usuário usa uma Conta do Google ou pertence a outra organização do Google Workspace, use o endereço de e-mail dele.
- O ID da
pessoa
na API People. Por exemplo, se a pessoa
O exemplo a seguir adiciona um usuário a um espaço:
Python
- No diretório de trabalho, crie um arquivo chamado
chat_membership_user_create.py
. Inclua o seguinte código em
chat_membership_user_create.py
:from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient.discovery import build # Define your app's authorization scopes. # When modifying these scopes, delete the file token.json, if it exists. SCOPES = ["https://www.googleapis.com/auth/chat.memberships"] def main(): ''' Authenticates with Chat API via user credentials, then adds a user to a Chat space by creating a membership. ''' # Authenticate with Google Workspace # and get user authorization. flow = InstalledAppFlow.from_client_secrets_file( 'client_secrets.json', SCOPES) creds = flow.run_local_server() # Build a service endpoint for Chat API. chat = build('chat', 'v1', credentials=creds) # Use the service endpoint to call Chat API. result = chat.spaces().members().create( # The space in which to create a membership. parent = 'spaces/SPACE', # Specify which user the membership is for. body = { 'member': { 'name':'users/USER', 'type': 'HUMAN' } } ).execute() # Prints details about the created membership. print(result) if __name__ == '__main__': main()
No código, substitua o seguinte:
SPACE
: um nome de espaço, que pode ser obtido no métodospaces.list
na API Chat ou no URL de um espaço.USER
: um ID do usuário.
No diretório de trabalho, crie e execute a amostra:
python3 chat_membership_user_create.py
Node.js
- No diretório de trabalho, crie um arquivo chamado
add-user-to-space.js
. Inclua o seguinte código em
add-user-to-space.js
:const chat = require('@googleapis/chat'); const {authenticate} = require('@google-cloud/local-auth'); /** * Adds the user to the Chat space. * @return {!Promise<!Object>} */ async function addUserToSpace() { const scopes = [ 'https://www.googleapis.com/auth/chat.memberships', ]; const authClient = await authenticate({scopes, keyfilePath: 'client_secrets.json'}); const chatClient = await chat.chat({version: 'v1', auth: authClient}); return await chatClient.spaces.members.create({ parent: 'spaces/SPACE', requestBody: {member: {name: 'users/USER', type: 'HUMAN'}} }); } addUserToSpace().then(console.log);
No código, substitua o seguinte:
SPACE
: um nome de espaço, que pode ser encontrado no métodospaces.list
na API Chat ou no URL de um espaço.USER
: um ID do usuário.
No diretório de trabalho, execute o exemplo:
node add-user-to-space.js
A API Chat retorna uma instância de
membership
que detalha a assinatura que foi criada.
Adicionar um app do Chat a um espaço
Um app do Chat não pode adicionar outro app como participante de um espaço. Para adicionar um app do Chat a um espaço ou uma mensagem direta entre dois usuários humanos, transmita o seguinte na sua solicitação:
- Especifique o escopo de autorização
chat.memberships.app
. - Chame o
método
create
no recursomembership
. - Defina
parent
como o nome do recurso do espaço em que a associação será criada. - Defina
member
comousers/app
, um alias que representa o app que chama a API Chat.
O exemplo a seguir adiciona um app do Chat a um espaço:
Python
- No diretório de trabalho, crie um arquivo chamado
chat_membership_app_create.py
. Inclua o seguinte código em
chat_membership_app_create.py
:from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient.discovery import build # Define your app's authorization scopes. # When modifying these scopes, delete the file token.json, if it exists. SCOPES = ["https://www.googleapis.com/auth/chat.memberships.app"] def main(): ''' Authenticates with Chat API via user credentials, then adds the Chat app to a Chat space. ''' # Authenticate with Google Workspace # and get user authorization. flow = InstalledAppFlow.from_client_secrets_file( 'client_secrets.json', SCOPES) creds = flow.run_local_server() # Build a service endpoint for Chat API. chat = build('chat', 'v1', credentials=creds) # Use the service endpoint to call Chat API. result = chat.spaces().members().create( # The space in which to create a membership. parent = 'spaces/SPACE', # Set the Chat app as the entity that gets added to the space. # 'app' is an alias for the Chat app calling the API. body = { 'member': { 'name':'users/app', 'type': 'BOT' } } ).execute() # Prints details about the created membership. print(result) if __name__ == '__main__': main()
No código, substitua
SPACE
por um nome de espaço, que pode ser obtido no métodospaces.list
na API Chat ou no URL de um espaço.No diretório de trabalho, crie e execute a amostra:
python3 chat_membership_app_create.py
Node.js
- No diretório de trabalho, crie um arquivo chamado
add-app-to-space.js
. Inclua o seguinte código em
add-app-to-space.js
:const chat = require('@googleapis/chat'); const {authenticate} = require('@google-cloud/local-auth'); /** * Adds the app to the Chat space. * @return {!Promise<!Object>} */ async function addAppToSpace() { const scopes = [ 'https://www.googleapis.com/auth/chat.memberships.app', ]; const authClient = await authenticate({scopes, keyfilePath: 'client_secrets.json'}); const chatClient = await chat.chat({version: 'v1', auth: authClient}); return await chatClient.spaces.members.create({ parent: 'spaces/SPACE', requestBody: {member: {name: 'users/app', type: 'BOT'}} }); } addAppToSpace().then(console.log);
No código, substitua
SPACE
por um nome de espaço, que pode ser obtido no métodospaces.list
na API Chat ou no URL de um espaço.No diretório de trabalho, execute o exemplo:
node add-app-to-space.js
A API Chat retorna uma instância de
membership
que detalha a assinatura que foi criada.
Temas relacionados
- Ver detalhes sobre a assinatura de um usuário ou um app do Chat.
- Listar os participantes em um espaço
- Atualizar a associação de um usuário em um espaço do Google Chat.
- Remover um usuário ou app do Chat de um espaço