Method: spaces.delete

Borra un espacio con nombre. Siempre realiza un borrado en cascada, lo que significa que también se borran los recursos secundarios del espacio, como los mensajes publicados en él y las membresías. Para ver un ejemplo, consulta Cómo borrar 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.delete (solo en los espacios que creó la app)
  • Autenticación de usuarios con uno de los siguientes permisos de autorización:

    • https://www.googleapis.com/auth/chat.delete
    • 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.delete

Solicitud HTTP

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

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 del espacio que se borrará.

Formato: spaces/{space}

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.delete.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Si se ejecuta correctamente, el cuerpo de la respuesta es un objeto JSON vacío.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/chat.app.delete
  • https://www.googleapis.com/auth/chat.admin.delete
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.delete

Para obtener más información, consulta la Guía de autorización.