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

Nombre de 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)

Es el tipo de espacio. Obligatorio cuando se crea un espacio o se actualiza el tipo de espacio. Salida solo 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

El nombre visible del espacio. Es obligatorio cuando creas un espacio con una 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 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.

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.

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

enum (SpaceThreadingState)

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

object (SpaceDetails)

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

enum (HistoryState)

Es 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 podrán verlos hasta que se complete 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 la 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 para 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.

Para los MD, este campo no se propaga.

enum (PredefinedPermissionSettings)

Opcional. Solo entrada. Configuración predefinida de permisos de espacios, entrada 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 espacios existentes. Entrada para actualizar la configuración de permisos de espacio exacta, donde se reemplaza la configuración de permisos existente. El resultado muestra la configuración de permisos actual.