REST Resource: spaces

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,
  "externalUserAllowed": boolean,
  "spaceThreadingState": enum (SpaceThreadingState),
  "spaceDetails": {
    object (SpaceDetails)
  },
  "spaceHistoryState": enum (HistoryState),
  "importMode": boolean,
  "createTime": string,
  "lastActiveTime": string,
  "adminInstalled": boolean,
  "membershipCount": {
    object (MembershipCount)
  },
  "accessSettings": {
    object (AccessSettings)
  },
  "spaceUri": string,

  // Union field space_permission_settings can be only one of the following:
  "predefinedPermissionSettings": enum (PredefinedPermissionSettings),
  "permissionSettings": {
    object (PermissionSettings)
  }
  // End of list of possible types for union field space_permission_settings.
}
Campos
name

string

Nombre de recurso del espacio.

Formato: spaces/{space}

type
(deprecated)

enum (Type)

Solo salida. Obsoleto: usa spaceType en su lugar. Indica el tipo de espacio.

spaceType

enum (SpaceType)

Indica el tipo de espacio. Es obligatorio cuando se crea un espacio o se actualiza su tipo. Salida solo para otros usos.

singleUserBotDm

boolean

Opcional. Si el espacio es un MD entre una app de Chat y una sola persona

threaded
(deprecated)

boolean

Solo salida. Obsoleto: usa spaceThreadingState en su lugar. Si los mensajes se agrupan en conversaciones en este espacio

displayName

string

El nombre visible del espacio. Es obligatorio cuando creas un espacio. Si recibes el mensaje de error ALREADY_EXISTS cuando creas un espacio o actualizas el displayName, prueba con otro displayName. Es posible que un espacio existente en la organización de Google Workspace ya use este nombre visible.

Para los mensajes directos, este campo puede estar vacío.

Admite hasta 128 caracteres.

externalUserAllowed

boolean

Inmutable. 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:

  • El usuario autenticado utiliza una cuenta personal (cuenta de usuario no administrada). De forma predeterminada, un espacio creado por una cuenta personal permite cualquier usuario de Google Chat.

  • El espacio se usa para importar datos a Google Chat porque en los espacios en modo de importación solo se deben permitir miembros de la misma organización de Google Workspace. Sin embargo, como parte del Programa de Versión preliminar para desarrolladores de Google Workspace, los espacios en modo de importación pueden permitir cualquier usuario de Google Chat, por lo que este campo se puede configurar para espacios en modo de importación.

Para los espacios existentes, este campo es de solo salida.

spaceThreadingState

enum (SpaceThreadingState)

Solo salida. El estado de la conversación en el espacio de Chat

spaceDetails

object (SpaceDetails)

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

spaceHistoryState

enum (HistoryState)

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

importMode

boolean

Opcional. Si este espacio se crea en Import Mode como parte de una migración de datos a Google Workspace. Mientras se importan los espacios, los usuarios no podrán verlos hasta que se complete la importación.

createTime

string (Timestamp format)

Opcional. Inmutable. En el caso de los espacios creados en Chat, la hora en que se creó el espacio. Este campo es solo de salida, excepto cuando se usa en espacios en modo de importación.

Para los espacios en modo de importación, establece este campo en 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 spaceType es GROUP_CHAT o SPACE.

lastActiveTime

string (Timestamp format)

Solo salida. Marca de tiempo del último mensaje en el espacio.

adminInstalled

boolean

Solo salida. En el caso de los espacios de mensajes directos (MD) con una app de Chat, indica si el espacio fue creado por un administrador de Google Workspace. Los administradores pueden instalar y configurar un mensaje directo con una app de Chat en nombre de los usuarios de su organización.

Para admitir la instalación por parte de administradores, tu app de Chat debe incluir mensajes directos.

membershipCount

object (MembershipCount)

Solo salida. La cantidad de membresías unidas agrupadas por tipo de miembro. Se propaga cuando spaceType es SPACE, DIRECT_MESSAGE o GROUP_CHAT.

accessSettings

object (AccessSettings)

Opcional. Especifica la configuración de acceso del espacio. Solo se completa cuando spaceType es SPACE.

spaceUri

string

Solo salida. El URI del espacio.

Campo de unión space_permission_settings. Representa la configuración de permisos de un espacio. Solo se completa cuando space_type es SPACE. space_permission_settings puede ser solo una de las siguientes opciones:
predefinedPermissionSettings

enum (PredefinedPermissionSettings)

Opcional. Solo entrada. Configuración de permisos de espacios. Entrada para crear un espacio. Si no estableces este campo, se creará un espacio de colaboración. Una vez que crees el espacio, la configuración se completará en el campo PermissionSettings.

permissionSettings

object (PermissionSettings)

Opcional. La configuración de permisos exacta, que se puede establecer para actualizar el espacio Entrada para actualizar un espacio. De lo contrario, solo muestra el resultado. Para crear espacios, usa predefinedPermissionSettings.

Tipo

Obsoleto: usa SpaceType en su lugar.

Enumeradores
TYPE_UNSPECIFIED Reservado.
ROOM Conversaciones entre dos o más personas.
DM Mensaje directo 1:1 entre una persona y una app de Chat, en la que todos los mensajes son planos. Ten en cuenta que esto no incluye los mensajes directos entre dos personas.

SpaceType

Indica 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 donde 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 entre una persona y una app de Chat.

SpaceThreadingState

Especifica el tipo de estado de conversación 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 hacerlo dentro de 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.

SpaceDetails

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

Representación JSON
{
  "description": string,
  "guidelines": string
}
Campos
description

string

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

string

Opcional. Las reglas, las expectativas y el protocolo del espacio.

Admite hasta 5,000 caracteres.

HistoryState

El estado del historial de los mensajes y espacios. Especifica cuánto tiempo se conservan 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 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 mensajes y las conversaciones.

MembershipCount

Representa el recuento de membresías de un espacio, agrupadas en categorías.

Representación JSON
{
  "joinedDirectHumanUserCount": integer,
  "joinedGroupCount": integer
}
Campos
joinedDirectHumanUserCount

integer

Recuento de usuarios humanos que se unieron directamente al espacio, sin contar los usuarios que se unieron a un grupo.

joinedGroupCount

integer

Recuento de todos los grupos que se unieron directamente al espacio.

AccessSettings

Representa la configuración de acceso del espacio.

Representación JSON
{
  "accessState": enum (AccessState),
  "audience": string
}
Campos
accessState

enum (AccessState)

Solo salida. Indica el estado de acceso al espacio.

audience

string

Opcional. Es el nombre del recurso del público objetivo que puede acceder al espacio. Configura este campo con un ID de público objetivo válido para que el espacio sea detectable o usa el alias audiences/default para establecerlo con el parámetro de configuración de acceso predeterminado en la Consola del administrador. Para obtener más información, consulta Haz que un espacio sea detectable para el público objetivo. Anula la configuración de este campo para restringir el espacio. Solo se completa cuando el espacio es detectable. Formato: audiences/{audience}. Se puede usar audiences/default como alias del parámetro de configuración de uso compartido predeterminado de Chat.

AccessState

Representa el estado de acceso del espacio.

Enumeradores
ACCESS_STATE_UNSPECIFIED Se desconoce el estado del acceso o no se admite en esta API.
PRIVATE Los miembros o grupos agregados o invitados pueden descubrir el espacio.
DISCOVERABLE El espacio será visible para el público objetivo seleccionado, así como para los miembros o grupos agregados o invitados.

PredefinedPermissionSettings

La configuración de permisos de espacio que puedes especificar cuando creas un espacio con nombre. Es posible que se agreguen más parámetros de configuración en el futuro. Para obtener detalles sobre la configuración de permisos para espacios con nombre, consulta Información sobre los espacios.

Enumeradores
PREDEFINED_PERMISSION_SETTINGS_UNSPECIFIED Sin especificar. No usar.
COLLABORATION_SPACE Parámetro de configuración para que el espacio sea de colaboración en el que todos los miembros puedan publicar mensajes.
ANNOUNCEMENT_SPACE Parámetro de configuración para convertir este espacio en un espacio de anuncios en el que solo los administradores del espacio puedan publicar mensajes.

PermissionSettings

Configuración de permisos para un espacio con nombre Para establecer la configuración de permisos cuando creas un espacio, especifica el campo PredefinedPermissionSettings en la solicitud.

Representación JSON
{
  "manageMembersAndGroups": {
    object (PermissionSetting)
  },
  "modifySpaceDetails": {
    object (PermissionSetting)
  },
  "toggleHistory": {
    object (PermissionSetting)
  },
  "useAtMentionAll": {
    object (PermissionSetting)
  },
  "manageApps": {
    object (PermissionSetting)
  },
  "manageWebhooks": {
    object (PermissionSetting)
  },
  "postMessages": {
    object (PermissionSetting)
  },
  "replyMessages": {
    object (PermissionSetting)
  }
}
Campos
manageMembersAndGroups

object (PermissionSetting)

Parámetro de configuración para administrar los miembros y grupos de un espacio.

modifySpaceDetails

object (PermissionSetting)

Parámetro de configuración para actualizar el nombre, el avatar, la descripción y los lineamientos del espacio.

toggleHistory

object (PermissionSetting)

Parámetro de configuración para activar y desactivar el historial de espacio.

useAtMentionAll

object (PermissionSetting)

Parámetro de configuración para usar @todos en un espacio.

manageApps

object (PermissionSetting)

Parámetro de configuración para administrar apps en un espacio.

manageWebhooks

object (PermissionSetting)

Parámetro de configuración para administrar webhooks en un espacio.

postMessages

object (PermissionSetting)

Solo salida. Parámetro de configuración para publicar mensajes en un espacio.

replyMessages

object (PermissionSetting)

Parámetro de configuración para responder mensajes en un espacio.

PermissionSetting

Representa un parámetro de configuración de permiso de espacio.

Representación JSON
{
  "managersAllowed": boolean,
  "membersAllowed": boolean
}
Campos
managersAllowed

boolean

Si los administradores de espacios tienen este permiso

membersAllowed

boolean

Indica si las personas que no son administradores tienen este permiso.

Métodos

completeImport

Completa el proceso de importación para el espacio especificado y lo hace visible para los usuarios.

create

Crea un espacio con nombre.

delete

Borra un espacio con nombre.

findDirectMessage

Muestra el mensaje directo existente con el usuario especificado.

get

Muestra detalles sobre un espacio.

list

Enumera los espacios a los que pertenece el emisor.

patch

Actualiza un espacio.

setup

Crea un espacio y le agrega los usuarios especificados.