Este guia explica como usar o método delete
no recurso membership
da API Google Chat para remover participantes de um espaço, o que também é conhecido como excluir
assinatura. Não é possível remover os administradores do espaço se eles forem os únicos administradores do espaço
em um espaço. Atribua a função de administrador do espaço a outro usuário antes de remover estes itens
assinaturas.
O
Recurso Membership
representa se um usuário humano ou um app do Google Chat foi convidado;
ausente ou faz parte de um espaço.
Pré-requisitos
Python
- Uma empresa Conta do Google Workspace com acesso a Google Chat.
- Configure o ambiente:
- Crie um projeto do Google Cloud.
- Configure a tela de permissão OAuth.
- Ative e configure a API Google Chat com um nome. o ícone e a descrição do app do Chat.
- Instale o Python biblioteca de cliente das APIs do Google.
-
Criar credenciais de ID do cliente OAuth para um aplicativo para computador. Para executar o exemplo
salve as credenciais como um arquivo JSON chamado
client_secrets.json
em seu no diretório local.
- Escolha um escopo de autorização que ofereça suporte à autenticação de usuários.
Remover um participante de um espaço
Para remover um usuário, Grupo do Google ou app do Chat de uma espaço:
- Para remover um usuário ou Grupo do Google, especifique a autorização
chat.memberships
do projeto. Para remover um app do Chat, especifique ochat.memberships.app
escopo de autorização (os apps só podem excluir os próprios membership; e não de outros apps). Como prática recomendada, escolha as um escopo restritivo que ainda permite o funcionamento do app. - Chame o método
delete
. no(a) Recursomembership
. - Transmita o
name
da assinatura a ser excluída. Se a assinatura pertencer ao só admin do espaço. Antes, atribua outro usuário como administrador. está excluindo essa assinatura.
Veja como excluir uma assinatura:
Python
- No diretório de trabalho, crie um arquivo chamado
chat_membership_delete.py
. Inclua o seguinte código em
chat_membership_delete.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 deletes the specified 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().delete( # The membership to delete. # # Replace SPACE with a space name. # Obtain the space name from the spaces resource of Chat API, # or from a space's URL. # # Replace MEMBER with a membership name. # Obtain the membership name from the memberships resource of # Chat API. To delete a Chat app's membership, replace MEMBER # with app; an alias for the app calling the API. name='spaces/SPACE/members/MEMBER' ).execute() # Print Chat API's response in your command line interface. # When deleting a membership, the response body is empty. print(result) if __name__ == '__main__': main()
No código, substitua o seguinte:
SPACE
: um nome de espaço, que você pode conferir em O métodospaces.list
na API Chat ou pelo URL de um espaço.MEMBER
: um nome de assinatura, que você pode usar do métodospaces.members.list
na API Chat. Para excluir a assinatura de um app, substituaMEMBER
comapp
.
No diretório de trabalho, crie e execute o exemplo:
python3 chat_membership_delete.py
Se bem-sucedido, o corpo da resposta retornará a associação com
'state': 'NOT_A_MEMBER'
, indicando que o participante não está mais no espaço.
{ "name": "spaces/SPACE/members/MEMBER", "state": "NOT_A_MEMBER" }
Temas relacionados
- Veja detalhes sobre a assinatura de um usuário ou de um app do Chat.
- Listar os participantes de um espaço
- Atualizar a associação de um usuário em um espaço do Google Chat
- Convidar ou adicionar um usuário ou um app do Chat a um espaço