REST Resource: spaces

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

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 (Type),
  "spaceType": enum (SpaceType),
  "singleUserBotDm": boolean,
  "threaded": boolean,
  "displayName": string,
  "spaceThreadingState": enum (SpaceThreadingState),
  "spaceDetails": {
    object (SpaceDetails)
  },
  "spaceHistoryState": enum (HistoryState)
}
Campos
name

string

Nombre del recurso del espacio.

Formato: Spaces/{space}

type
(deprecated)

enum (Type)

Solo salida. Obsoleto: En su lugar, usa singleUserBotDm o spaceType (vista previa para desarrolladores).

El tipo de un espacio.

spaceType

enum (SpaceType)

El tipo de espacio. Es obligatorio al crear o actualizar un espacio. Salida solo para otro uso.

singleUserBotDm

boolean

Opcional. Si el espacio es un MD entre una aplicación de chat y una persona.

threaded
(deprecated)

boolean

Solo salida. Obsoleto: Usa spaceThreadingState en su lugar. Si los mensajes están agrupados en conversaciones en este espacio.

displayName

string

El nombre visible del espacio. Para los mensajes directos entre personas, este campo puede estar vacío.

spaceThreadingState

enum (SpaceThreadingState)

Solo salida. El estado de los subprocesos en el espacio de Chat.

spaceDetails

object (SpaceDetails)

Detalles sobre el espacio, incluidas la descripción y las reglas.

spaceHistoryState

enum (HistoryState)

Es el estado del historial de mensajes y conversaciones de este espacio.

Tipo

Obsoleto: el tipo de un espacio. Usa singleUserBotDm o spaceType (vista previa para desarrolladores) 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 no se incluyen los mensajes directos entre dos personas.

Tipo de espacio

El tipo de espacio. Es obligatorio al crear un espacio. Salida solo para otro uso.

Enumeradores
SPACE_TYPE_UNSPECIFIED Reservado.
SPACE Un lugar donde las personas envían mensajes, comparten archivos y colaboran. Un SPACE puede incluir apps de Chat.
GROUP_CHAT Conversaciones en grupo entre 3 o más personas Un GROUP_CHAT puede incluir apps de Chat.
DIRECT_MESSAGE Mensajes 1:1 entre dos personas o una app de Chat

Estado del subproceso del 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 admiten conversaciones de mensajes. Cuando los usuarios responden un mensaje, pueden responder en cadena, 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

string

Opcional. Una descripción del espacio. Puede describir el tema del debate, el propósito funcional o los participantes del espacio.

guidelines

string

Opcional. Las reglas, las expectativas y la etiqueta del espacio.

Estado del historial

El estado del historial de los mensajes y espacios. Especifica por cuánto tiempo se conservan los mensajes y las conversaciones después de la creación.

Enumeradores
HISTORY_STATE_UNSPECIFIED Valor predeterminado No lo utilices.
HISTORY_OFF Historial desactivado. Los mensajes y las conversaciones se conservan 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 subprocesos y mensajes.

Métodos

create

Crea un espacio con nombre.

delete

Borra un espacio con nombre.

get

Muestra un espacio.

list

Enumera los espacios a los que pertenece el emisor.

patch

Actualiza un espacio.

setup

Crea un espacio y agrega usuarios a él.

webhooks

Ruta heredada para crear un mensaje.