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

Identifiant. Nom de la ressource de l'espace.

Format : spaces/{space}

Où {space} représente l'ID attribué par le système à l'espace. Vous pouvez obtenir l'ID de l'espace en appelant la méthode spaces.list() ou à partir de l'URL de l'espace. Par exemple, si l'URL de l'espace est https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA, l'ID de l'espace est AAAAAAAAA.

enum (Type)

Uniquement en sortie. Obsolète: utilisez spaceType à la place. Type d'espace.

enum (SpaceType)

Facultatif. Type d'espace. Obligatoire lors de la création d'un espace ou de la mise à jour de son type. Sortie uniquement pour une autre utilisation.

boolean

Facultatif. Indique si l'espace est un message privé entre une application Chat et une personne.

boolean

Uniquement en sortie. Obsolète: utilisez spaceThreadingState à la place. Indique si les messages sont organisés en fils de discussion dans cet espace.

string

Facultatif. Nom à afficher de l'espace. Obligatoire lors de la création d'un espace avec un spaceType de SPACE. Si le message d'erreur ALREADY_EXISTS s'affiche lorsque vous créez un espace ou mettez à jour le displayName, essayez un autre displayName. Il est possible qu'un espace existant de l'organisation Google Workspace utilise déjà ce nom à afficher.

Pour les messages privés, ce champ peut être vide.

Peut contenir jusqu'à 128 caractères.

boolean

Facultatif. Immuable. Indique si cet espace autorise tout utilisateur Google Chat à en être membre. Valeur à saisir lorsque vous créez un espace dans une organisation Google Workspace. Omettre ce champ lorsque vous créez des espaces dans les conditions suivantes:

• L'utilisateur authentifié utilise un compte personnel (compte utilisateur non géré). Par défaut, un espace créé avec un compte personnel autorise tous les utilisateurs de Google Chat.

Pour les espaces existants, ce champ est de sortie uniquement.

enum (SpaceThreadingState)

Uniquement en sortie. État des fils de discussion dans l'espace Chat.

object (SpaceDetails)

Facultatif. Informations sur l'espace, y compris sa description et ses règles

enum (HistoryState)

Facultatif. État de l'historique des messages pour les messages et les fils de discussion de cet espace.

boolean

Facultatif. Indique si cet espace est créé dans Import Mode lors d'une migration de données vers Google Workspace. Pendant l'importation des espaces, ils ne sont pas visibles par les utilisateurs tant que l'importation n'est pas terminée.

La création d'un espace dans Import Mode nécessite l'authentification des utilisateurs.

string (Timestamp format)

Facultatif. Immuable. Pour les espaces créés dans Chat, l'heure à laquelle ils ont été créés. Ce champ est à usage exclusif en sortie, sauf lorsqu'il est utilisé dans des espaces en mode importation.

Pour les espaces en mode importation, définissez ce champ sur l'horodatage historique au moment de la création de l'espace dans la source afin de conserver l'heure de création d'origine.

N'est renseigné dans la sortie que lorsque spaceType est GROUP_CHAT ou SPACE.

string (Timestamp format)

Uniquement en sortie. Code temporel du dernier message dans l'espace.

boolean

Uniquement en sortie. Pour les espaces de messages privés (MP) avec une application Chat, indique si l'espace a été créé par un administrateur Google Workspace. Les administrateurs peuvent installer et configurer un message privé avec une application Chat au nom des utilisateurs de leur organisation.

Pour être compatible avec l'installation par administrateur, votre application Chat doit proposer les messages privés.

object (MembershipCount)

Uniquement en sortie. Nombre d'adhésions regroupées par type de membre. Renseigné lorsque spaceType est SPACE, DIRECT_MESSAGE ou GROUP_CHAT.

object (AccessSettings)

Facultatif. Indique le paramètre d'accès de l'espace. N'est renseigné que lorsque spaceType est défini sur SPACE.

string

Uniquement en sortie. URI permettant à un utilisateur d'accéder à l'espace.

string

Facultatif. Immuable. ID client du domaine de l'espace. Obligatoire uniquement lors de la création d'un espace avec authentification de l'application et lorsque SpaceType est SPACE. Sinon, ne doit pas être défini.

Au format customers/{customer}, où customer correspond à id de la [ressource client du SDK Admin]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Les applications privées peuvent également utiliser l'alias customers/my_customer pour créer l'espace dans la même organisation Google Workspace que l'application.

Pour les MP, ce champ n'est pas renseigné.

enum (PredefinedPermissionSettings)

Facultatif. Uniquement en entrée. Paramètres d'autorisation prédéfinis pour l'espace, saisis uniquement lors de la création de l'espace. Si le champ n'est pas défini, un espace de collaboration est créé. Une fois l'espace créé, les paramètres sont renseignés dans le champ PermissionSettings.

object (PermissionSettings)

Facultatif. Paramètres d'autorisation des espaces pour les espaces existants. Saisie permettant de modifier les paramètres d'autorisation exacts de l'espace, où les paramètres d'autorisation existants sont remplacés. La sortie liste les paramètres d'autorisation actuels.