En esta guía, se explica cómo usar el método delete
en el recurso membership
de la API de Google Chat para quitar miembros de un espacio, también conocido como
membresía. No se puede quitar a los administradores del espacio si son el único administrador del espacio
en un espacio. Asigna a otro usuario como administrador del espacio antes de quitar a estos usuarios
membresías.
El
Recurso Membership
representa si se invita a un usuario humano o a una app de Google Chat
es parte de un espacio o está ausente.
Requisitos previos
Python
- Python 3.6 o superior
- El valor pip herramienta de administración de paquetes
Las bibliotecas cliente de Google más recientes para Python. Para instalarlas o actualizarlas, Ejecuta el siguiente comando en tu interfaz de línea de comandos:
pip3 install --upgrade google-api-python-client google-auth-oauthlib
- Un proyecto de Google Cloud con la API de Google Chat habilitada y configurada. Para ver los pasos, consulta Compila una app de Google Chat.
Autorización configurada para la app de Chat. Borrando requiere una membresía Autenticación de usuarios con el Permiso de autorización
chat.memberships
ochat.memberships.app
de un usuario que tiene permiso para borrar la membresía especificada.
Quita a un miembro de un espacio
Para quitar a un usuario, un Grupo de Google o una app de Chat de una espacio:
- Para quitar un usuario o un Grupo de Google, especifica la autorización de
chat.memberships
del proyecto. Para quitar una app de Chat, especificachat.memberships.app
permiso de autorización (las apps solo pueden borrar su propio la membresía; no con la de otras apps). Como práctica recomendada, elige la más más restrictivo que permita que tu app funcione. - Realiza una llamada al método
delete
. en la Recursomembership
. - Pasa el
name
de la membresía que quieres borrar. Si la membresía pertenece al en un espacio, asigna a otro usuario como administrador eliminando esta membresía.
Para borrar una membresía, sigue estos pasos:
Python
- En el directorio de trabajo, crea un archivo llamado
chat_membership_delete.py
. Incluye el siguiente código en
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()
En el código, reemplaza lo siguiente:
SPACE
: Es un nombre de espacio, que puedes obtener desde Métodospaces.list
en la API de Chat o desde la URL de un espacio.MEMBER
: Es un nombre de membresía que puedes obtener. A partir del métodospaces.members.list
en la API de Chat. Para borrar la membresía de una app, reemplazaMEMBER
conapp
.
En tu directorio de trabajo, compila y ejecuta la muestra:
python3 chat_membership_delete.py
Si el proceso es satisfactorio, el cuerpo de la respuesta devuelve la membresía con
'state': 'NOT_A_MEMBER'
, lo que indica que el miembro ya no está en el espacio.
{ "name": "spaces/SPACE/members/MEMBER", "state": "NOT_A_MEMBER" }
Temas relacionados
- Obtén detalles sobre la membresía de un usuario o de la app de Chat.
- Enumera los miembros de un espacio.
- Actualiza la membresía de un usuario en un espacio de Google Chat.
- Invita o agrega a un usuario o una app de Chat a un espacio.