- 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 apps con aprobación del administrador en la Versión preliminar para desarrolladores
Cuando te autenticas como una app, se debe configurar el campo space.customer en la solicitud.
La membresía del espacio en el momento de su creación depende de si se crea en Import mode:
- Modo de importación: No se crean miembros.
- Todos los demás modos: El usuario que realiza la llamada se agrega como miembro. Esto es lo que sucede:
- La app en sí cuando se usa la autenticación de apps
- 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 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 | |
|---|---|
request |
Opcional. Es un identificador único para esta solicitud. Se recomienda usar un UUID aleatorio. Si especificas un ID de solicitud existente, se muestra el espacio creado con ese ID en lugar de crear uno nuevo. Si especificas un ID de solicitud existente de la misma app de Chat con un usuario autenticado diferente, se muestra 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.