Method: spaces.create

Crea un espacio. Se puede usar para crear un espacio con nombre o un chat en grupo en Import mode. Para obtener un ejemplo, consulta Crea un espacio.

Admite los siguientes tipos de autenticación:

  • Autenticación de la app con aprobación del administrador y uno de los siguientes permisos de autorización:

    • https://www.googleapis.com/auth/chat.app.spaces.create
    • https://www.googleapis.com/auth/chat.app.spaces

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

    • https://www.googleapis.com/auth/chat.spaces.create
    • https://www.googleapis.com/auth/chat.spaces
    • https://www.googleapis.com/auth/chat.import (solo espacios en modo de importación)

Cuando se realiza la autenticación como una app, se debe configurar el campo space.customer en la solicitud.

Cuando se realiza la autenticación como una app, la app de Chat se agrega como miembro del espacio. Sin embargo, a diferencia de la autenticación humana, la app de Chat no se agrega como administrador del espacio. De forma predeterminada, todos los miembros del espacio pueden quitar la app del espacio. Para permitir que solo los administradores del espacio quiten la app de un espacio, configura space.permission_settings.manage_apps como managersAllowed.

La membresía del espacio al momento de la creación depende de si el espacio se crea en Import mode:

  • Modo de importación: No se crean miembros.
  • Todos los demás modos: El usuario que llama se agrega como miembro. Esto es:
    • La app en sí cuando se usa la autenticación de la app
    • El usuario humano cuando se usa la autenticación del usuario

Si recibes el mensaje de error ALREADY_EXISTS cuando creas un espacio, prueba con un displayName diferente. Es posible que un espacio existente dentro de la organización de Google Workspace ya use este nombre visible.

Solicitud HTTP

POST https://chat.googleapis.com/v1/spaces

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

Parámetros de consulta

Parámetros
requestId

string

Es opcional. Es un ID único para esta solicitud. Se recomienda usar un UUID aleatorio. Si especificas un ID de solicitud, la solicitud se vuelve idempotente, lo que garantiza que varias solicitudes idénticas con el mismo ID de solicitud generen la creación de un solo espacio. Las solicitudes posteriores con el mismo ID de solicitud muestran el espacio existente y no lo actualizan, incluso si los detalles solicitados difieren del estado actual.

Para usar este campo de manera eficaz, haz lo siguiente:

  • Asegúrate de que las solicitudes posteriores sean idénticas y usen las mismas credenciales de autenticación que la solicitud original.
  • Si ya se creó un espacio con el ID de solicitud proporcionado, la solicitud muestra ese espacio. Ten en cuenta que es posible que el espacio que se muestra no esté completamente propagado. La API repite el espacio en tu solicitud con el nombre de recurso asignado por el sistema propagado. Para recuperar los metadatos más recientes del espacio, llama a spaces.get.
  • Si se reutiliza un ID de solicitud existente con un usuario autenticado diferente, se produce un error.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de Space.

Cuerpo de la respuesta

Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de Space.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/chat.app.spaces.create
  • https://www.googleapis.com/auth/chat.app.spaces
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.create

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