Recurso: Espacio
Un espacio en Google Chat Los espacios son conversaciones entre dos o más usuarios, o mensajes 1:1 entre un usuario y una app de Chat.
Representación JSON |
---|
{ "name": string, "type": enum ( |
Campos | |
---|---|
name |
Es el nombre del recurso del espacio. Formato: |
type |
Solo salida. Obsoleto: usa |
spaceType |
El tipo de espacio. Es obligatorio cuando se crea un espacio o se actualiza su tipo. Salida solo para otros usos. |
singleUserBotDm |
Opcional. Si el espacio es un MD entre una app de Chat y una sola persona |
threaded |
Solo salida. Obsoleto: usa |
displayName |
El nombre visible del espacio. Es obligatorio cuando se crea un espacio. Si recibes el mensaje de error Para los mensajes directos, este campo puede estar vacío. Admite hasta 128 caracteres. |
externalUserAllowed |
Inmutable. Indica si este espacio permite que cualquier usuario de Google Chat sea miembro. Entrada cuando se crea un espacio en una organización de Google Workspace. Omite este campo cuando crees espacios en las siguientes condiciones:
Para los espacios existentes, este campo es de solo salida. |
spaceThreadingState |
Solo salida. El estado de las conversaciones en el espacio de Chat |
spaceDetails |
Detalles sobre el espacio, incluidas la descripción y las reglas |
spaceHistoryState |
El estado del historial de mensajes de los mensajes y las conversaciones de este espacio. |
importMode |
Opcional. Indica si este espacio se crea en |
createTime |
Opcional. En el caso de los espacios creados en Chat, indica la hora en que se creó. Este campo es de solo salida, excepto cuando se usa en espacios importados. En el caso de los espacios importados, configura este campo con la marca de tiempo histórica en la que se creó el espacio en la fuente para conservar la hora de creación original. Solo se propaga en el resultado cuando |
adminInstalled |
Solo salida. Indica si un administrador de Google Workspace instaló la app de Chat. Los administradores pueden instalar una app de Chat para su dominio, unidad organizativa o grupo de usuarios. Los administradores solo pueden instalar apps de Chat para la mensajería directa entre los usuarios y la app. Para admitir la instalación del administrador, tu app debe incluir mensajería directa. |
Tipo
Obsoleto: usa SpaceType
en su lugar.
Enumeradores | |
---|---|
TYPE_UNSPECIFIED |
|
ROOM |
Conversaciones entre dos o más personas |
DM |
Mensaje directo 1:1 entre una persona y una app de Chat en el que todos los mensajes son planos. Ten en cuenta que esto no incluye los mensajes directos entre dos personas. |
Tipo de espacio
El tipo de espacio. Es obligatorio cuando se crea o actualiza un espacio. Salida solo para otros usos.
Enumeradores | |
---|---|
SPACE_TYPE_UNSPECIFIED |
Reservado. |
SPACE |
Un lugar en el que las personas envían mensajes, comparten archivos y colaboran. Un SPACE puede incluir apps de Chat. |
GROUP_CHAT |
Conversaciones grupales entre 3 o más personas Un GROUP_CHAT puede incluir apps de Chat. |
DIRECT_MESSAGE |
Mensajes 1:1 entre dos personas o una persona y una app de Chat |
Estado de subprocesos de espacio
Especifica el tipo de estado de los subprocesos en el espacio de Chat.
Enumeradores | |
---|---|
SPACE_THREADING_STATE_UNSPECIFIED |
Reservado. |
THREADED_MESSAGES |
Espacios con nombre que admitan conversaciones de mensajes Cuando los usuarios responden un mensaje, pueden responder en la conversación, lo que mantiene su respuesta en el contexto del mensaje original. |
GROUPED_MESSAGES |
Espacios con nombre en los que la conversación se organiza por tema. Los temas y sus respuestas se agrupan. |
UNTHREADED_MESSAGES |
Mensajes directos (MD) entre dos personas y conversaciones grupales entre 3 o más personas |
Detalles del espacio
Detalles sobre el espacio, incluidas la descripción y las reglas
Representación JSON |
---|
{ "description": string, "guidelines": string } |
Campos | |
---|---|
description |
Opcional. Es una descripción del espacio. Por ejemplo, describe el tema de debate del espacio, el propósito funcional o los participantes. Admite hasta 150 caracteres. |
guidelines |
Opcional. Las reglas, las expectativas y la etiqueta del espacio. Admite hasta 5,000 caracteres. |
Estado del historial
El estado del historial de mensajes y espacios. Especifica por cuánto tiempo se conservarán los mensajes y las conversaciones después de su creación.
Enumeradores | |
---|---|
HISTORY_STATE_UNSPECIFIED |
Valor predeterminado No lo utilices. |
HISTORY_OFF |
Historial desactivado. Los mensajes y las conversaciones se guardan durante 24 horas. |
HISTORY_ON |
Historial activado. Las reglas de retención de Vault de la organización especifican por cuánto tiempo se conservan los mensajes y las conversaciones. |
Métodos |
|
---|---|
|
Completa el proceso de importación para el espacio especificado y lo hace visible para los usuarios. |
|
Crea un espacio con nombre. |
|
Borra un espacio con nombre. |
|
Muestra el mensaje directo existente con el usuario especificado. |
|
Muestra detalles sobre un espacio. |
|
Enumera los espacios de los que es miembro el emisor. |
|
Actualiza un espacio. |
|
Crea un espacio y le agrega usuarios específicos. |