Method: spaces.members.delete

Borra una membresía. Para ver un ejemplo, consulta Quita a un usuario o una app de Google Chat de un espacio.

Admite los siguientes tipos de autenticación:

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. Es el nombre del recurso de la membresía que se borrará. Las apps de chat pueden borrar las membresías de los usuarios humanos o las propias. Las apps de chat no pueden borrar las membresías de otras apps.

Cuando se borra una membresía humana, se requiere el permiso 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, donde example@gmail.com es el correo electrónico del usuario de Google Chat.

Cuando se borra una membresía de la app, se 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

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

El usuario que realiza la llamada debe ser un administrador de Google Workspace con el privilegio para administrar el chat y las conversaciones de 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 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 permisos de 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 obtener más información, consulta la Guía de autorización.