REST Resource: spaces

{
  "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,
  "customer": 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.
}

string

Identificador. Es el nombre del recurso del espacio.

Formato: spaces/{space}

En el que {space} representa el ID asignado por el sistema para el espacio. Para obtener el ID del espacio, llama al método spaces.list() o desde la URL del espacio. Por ejemplo, si la URL del espacio es https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA, el ID del espacio es AAAAAAAAA.

enum (Type)

Solo salida. Obsoleto: Usa spaceType en su lugar. Es el tipo de un espacio.

enum (SpaceType)

Opcional. Es el tipo de espacio. Obligatorio cuando se crea un espacio o se actualiza el tipo de espacio. Solo salida para otro uso.

boolean

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

boolean

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

string

Opcional. Es el nombre visible del espacio. Obligatorio cuando se crea un espacio con un spaceType de SPACE. 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 dentro de la organización de Google Workspace ya use este nombre visible.

En el caso de los mensajes directos, este campo puede estar vacío.

Admite hasta 128 caracteres.

boolean

Opcional. Inmutable. Si este espacio permite que cualquier usuario de Google Chat sea miembro. Se ingresa 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 usa una cuenta de consumidor (cuenta de usuario no administrada). De forma predeterminada, un espacio creado por una cuenta de consumidor permite a cualquier usuario de Google Chat.

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

enum (SpaceThreadingState)

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

object (SpaceDetails)

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

enum (HistoryState)

Opcional. El estado del historial de mensajes de los mensajes y las conversaciones de este espacio.

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 pueden verlos hasta que se completa la importación.

Para crear un espacio en Import Mode, se requiere la autenticación del usuario.

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 de modo de importación.

En el caso de los espacios del 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.

string (Timestamp format)

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

boolean

Solo salida. En el caso de los espacios de mensajes directos (MD) con una app de Chat, si un administrador de Google Workspace creó el espacio. 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 de administrador, tu app de Chat debe incluir mensajes directos.

object (MembershipCount)

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

object (AccessSettings)

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

string

Solo salida. Es el URI que permite que un usuario acceda al espacio.

string

Opcional. Inmutable. El ID de cliente del dominio del espacio. Solo es obligatorio cuando se crea un espacio con autenticación de apps y SpaceType es SPACE. De lo contrario, no se debe establecer.

En el formato customers/{customer}, donde customer es el id del [recurso de cliente del SDK de Admin]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Las apps privadas también pueden usar el alias customers/my_customer para crear el espacio en la misma organización de Google Workspace que la app.

En el caso de los mensajes directos, este campo no se completa.

enum (PredefinedPermissionSettings)

Opcional. Solo entrada. Configuración predefinida de permisos del espacio, que se ingresa solo cuando se crea un espacio. Si no se establece el campo, se crea un espacio de colaboración. Después de crear el espacio, la configuración se propaga en el campo PermissionSettings.

object (PermissionSettings)

Opcional. Configuración de permisos de los espacios existentes Entrada para actualizar la configuración exacta de permisos de espacio, en la que se reemplaza la configuración de permisos existente. El resultado muestra la configuración de permisos actual.