Method: spaces.members.delete

• Solicitud HTTP
• Parámetros de ruta de acceso
• Parámetros de consulta
• Cuerpo de la solicitud
• Cuerpo de la respuesta
• Alcances de autorización
• Pruébalo

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

Admite los siguientes tipos de autenticación:

• Autenticación de la app con aprobación del administrador y el alcance de autorización:

  • https://www.googleapis.com/auth/chat.app.memberships

• Autenticación de usuarios con uno de los siguientes permisos de autorización:

  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.app (para quitar la app de llamadas del espacio)
  • https://www.googleapis.com/auth/chat.import (solo espacios de modo de importación)
  • La autenticación de usuarios otorga privilegios de administrador cuando se autentica una cuenta de administrador, useAdminAccess es true y se usa el siguiente alcance de autorización:
    • https://www.googleapis.com/auth/chat.admin.memberships

La autenticación de la app no es compatible con los siguientes casos de uso:

• Se quita un grupo de Google de un espacio.
• Quitar una app de Chat de un espacio

Para borrar membresías de administradores del espacio, el solicitante debe ser administrador del espacio. Si usas la autenticación de la app, la app de Chat debe ser la creadora del espacio.

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 Es 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 suyas propias. Las apps de chat no pueden borrar las membresías de otras apps. Cuando se borra una membresía humana, se requiere el alcance chat.memberships con autenticación del usuario o el alcance chat.memberships.app con autenticación de la app y el formato spaces/{space}/members/{member}. Puedes usar el correo electrónico como alias para {member}. Por ejemplo, spaces/{space}/members/[e-mail], donde [e-mail] 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 llama debe ser administrador de Google Workspace y tener 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 el borrado 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.