Method: spaces.members.delete

Borra una membresía. Para ver un ejemplo, consulta Cómo quitar un usuario o una app de Google Chat de un espacio.

Requiere la autenticación del usuario.

Solicitud HTTP

DELETE https://chat.googleapis.com/v1/{name=spaces/*/members/*}

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
name

string

Obligatorio. El nombre del recurso de la membresía que se borrará. Las apps de chat pueden borrar usuarios humanos o sus propias membresías. Las apps de Chat no pueden borrar las membresías de otras apps.

Cuando se borra una membresía humana, requiere el alcance chat.memberships y el formato spaces/{space}/members/{member}. Puedes usar el correo electrónico como alias para {member}. Por ejemplo, spaces/{space}/members/example@gmail.com, en el que example@gmail.com es el correo electrónico del usuario de Google Chat.

Cuando se borra una membresía de la app, requiere el alcance chat.memberships.app y el formato spaces/{space}/members/app.

Formato: spaces/{space}/members/{member} o spaces/{space}/members/app.

Parámetros de consulta

Parámetros
useAdminAccess

boolean

Cuando es true, el método se ejecuta con los privilegios de administrador de Google Workspace del usuario.

El usuario que llama debe ser un administrador de Google Workspace con el privilegio para administrar las conversaciones del chat y los espacios.

Requiere el permiso de OAuth 2.0 chat.admin.memberships.

No se admite la eliminación de membresías de apps en un espacio con el acceso de administrador.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Membership.

Alcances de autorización

Se necesita uno de los siguientes alcances de 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 obtener más información, consulta la guía de autorización.