- Solicitud HTTP
- Parámetros de búsqueda
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Alcances de autorización
- Pruébalo
Crea un espacio. Se puede usar para crear un espacio con nombre o un chat en grupo en Import mode. Para ver 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.createhttps://www.googleapis.com/auth/chat.app.spaces
Autenticación de usuarios con uno de los siguientes permisos de autorización:
https://www.googleapis.com/auth/chat.spaces.createhttps://www.googleapis.com/auth/chat.spaceshttps://www.googleapis.com/auth/chat.import(solo espacios de modo de importación)
Cuando se autentica 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 de Chat del espacio. Para permitir que solo los administradores del espacio quiten la app de un espacio, establece space.permission_settings.manage_apps en managersAllowed.
La membresía del espacio en el momento de la creación depende de si el espacio se creó 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
- Es el usuario humano cuando se usa la autenticación de usuarios.
Si recibes el mensaje de error ALREADY_EXISTS cuando creas un espacio, prueba con otro displayName. 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 |
Opcional. Es un identificador único para esta solicitud. Se recomienda usar un UUID aleatorio. Si se especifica un ID de solicitud existente, se devuelve el espacio creado con ese ID en lugar de crear uno nuevo. Si se especifica un ID de solicitud existente de la misma app de Chat con un usuario autenticado diferente, se devuelve 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.createhttps://www.googleapis.com/auth/chat.app.spaceshttps://www.googleapis.com/auth/chat.importhttps://www.googleapis.com/auth/chat.spaceshttps://www.googleapis.com/auth/chat.spaces.create
Para obtener más información, consulta la Guía de autorización.