REST Resource: spaces

Ressource: Espace

Espace dans Google Chat Les espaces sont des conversations entre deux utilisateurs ou plus, ou des messages privés entre un utilisateur et une application Chat.

Représentation 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,
  "importModeExpireTime": 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.
}
Champs
name

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.
type
(deprecated)

enum (Type)

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

enum (SpaceType)

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

boolean

Facultatif. Indique si l'espace est un MP entre une application Chat et une seule personne.
threaded
(deprecated)

boolean

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

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.
externalUserAllowed

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.
spaceThreadingState

enum (SpaceThreadingState)

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

object (SpaceDetails)

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

enum (HistoryState)

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

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.
createTime

string (Timestamp format)

Facultatif. Immuable. Pour les espaces créés dans Chat, l'heure à laquelle ils ont été créés. Ce champ est utilisé uniquement 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.
lastActiveTime

string (Timestamp format)

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

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.
membershipCount

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.
accessSettings

object (AccessSettings)

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

string

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

string (Timestamp format)

Uniquement en sortie. Date à laquelle l'espace sera automatiquement supprimé par le système s'il reste en mode importation.

Chaque espace créé en mode importation doit quitter ce mode avant l'expiration à l'aide de spaces.completeImport.

Ce champ n'est renseigné que pour les espaces créés en mode importation.
customer

string

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

Au format customers/{customer}, où customer est l'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é.

Champ d'union space_permission_settings. Représente les paramètres d'autorisation d'un espace. N'est renseigné que lorsque space_type est défini sur SPACE.

Authentification des utilisateurs requise. space_permission_settings ne peut être qu'un des éléments suivants :
predefinedPermissionSettings

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

Type

Obsolète: utilisez SpaceType à la place.

Enums
TYPE_UNSPECIFIED Réservé.
ROOM Conversations entre deux personnes ou plus
DM Message privé entre un humain et une application Chat, où tous les messages sont plats. Notez que cela n'inclut pas les messages privés entre deux personnes.

SpaceType

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

Enums
SPACE_TYPE_UNSPECIFIED Réservé.
SPACE Espace où les utilisateurs peuvent envoyer des messages, partager des fichiers et collaborer. Un SPACE peut inclure des applications Chat.
GROUP_CHAT Les conversations de groupe entre trois personnes ou plus Un GROUP_CHAT peut inclure des applications Chat.
DIRECT_MESSAGE Messages privés entre deux personnes ou entre une personne et une application Chat

SpaceThreadingState

Spécifie le type d'état de thread dans l'espace Chat.

Enums
SPACE_THREADING_STATE_UNSPECIFIED Réservé.
THREADED_MESSAGES Espaces nommés compatibles avec les fils de discussion Lorsque les utilisateurs répondent à un message, ils peuvent le faire dans le fil de discussion, ce qui permet de garder leur réponse dans le contexte du message d'origine.
GROUPED_MESSAGES Espaces nommés dans lesquels la conversation est organisée par sujet. Les sujets et leurs réponses sont regroupés.
UNTHREADED_MESSAGES Messages privés entre deux personnes et conversations de groupe entre trois personnes ou plus

SpaceDetails

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

Représentation JSON 
{
  "description": string,
  "guidelines": string
}
Champs
description

string

Facultatif. Description de l'espace. Par exemple, décrivez le sujet de discussion, l'objectif fonctionnel ou les participants de l'espace.

Peut contenir jusqu'à 150 caractères.
guidelines

string

Facultatif. Les règles, les attentes et l'étiquette de l'espace

Peut contenir jusqu'à 5 000 caractères.

HistoryState

État de l'historique des messages et des espaces. Spécifie la durée de conservation des messages et des fils de discussion après leur création.

Enums
HISTORY_STATE_UNSPECIFIED Valeur par défaut. Ne pas utiliser.
HISTORY_OFF L'historique est désactivé. Les messages et les fils de discussion sont conservés pendant 24 heures.
HISTORY_ON Historique activé. Les règles de conservation Vault de l'organisation spécifient la durée de conservation des messages et des discussions.

MembershipCount

Représente le nombre d'adhésions à un espace, regroupées par catégories.

Représentation JSON 
{
  "joinedDirectHumanUserCount": integer,
  "joinedGroupCount": integer
}
Champs
joinedDirectHumanUserCount

integer

Uniquement en sortie. Nombre d'utilisateurs humains ayant rejoint directement l'espace, sans compter les utilisateurs qui y ont accédé en tant que membres d'un groupe associé.
joinedGroupCount

integer

Uniquement en sortie. Nombre de groupes ayant rejoint directement l'espace.

AccessSettings

Représente le paramètre d'accès de l'espace.

Représentation JSON 
{
  "accessState": enum (AccessState),
  "audience": string
}
Champs
accessState

enum (AccessState)

Uniquement en sortie. Indique l'état d'accès de l'espace.
audience

string

Facultatif. Nom de la ressource de l'audience cible pouvant découvrir l'espace, le rejoindre et prévisualiser les messages qu'il contient. Si cette option n'est pas définie, seuls les utilisateurs ou les groupes Google qui ont été invités ou ajoutés individuellement à l'espace peuvent y accéder. Pour en savoir plus, consultez Rendre un espace visible par une audience cible.

Format : audiences/{audience}

Pour utiliser l'audience cible par défaut de l'organisation Google Workspace, définissez la valeur sur audiences/default.

La lecture de l'audience cible permet de:

Ce champ n'est pas renseigné lorsque vous utilisez le champ d'application chat.bot avec l'authentification de l'application.

La définition de l'audience cible nécessite une authentification de l'utilisateur.

AccessState

Représente l'état d'accès de l'espace.

Enums
ACCESS_STATE_UNSPECIFIED L'état d'accès est inconnu ou non compatible avec cette API.
PRIVATE Seuls les utilisateurs ou les groupes Google qui ont été ajoutés ou invités individuellement par d'autres utilisateurs ou administrateurs Google Workspace peuvent découvrir et accéder à l'espace.
DISCOVERABLE

Un gestionnaire d'espace a accordé l'accès à une audience cible. Les utilisateurs ou groupes Google qui ont été ajoutés ou invités individuellement à l'espace peuvent également le découvrir et y accéder. Pour en savoir plus, consultez Rendre un espace visible pour des utilisateurs spécifiques.

La création d'espaces visibles nécessite une authentification de l'utilisateur.

PredefinedPermissionSettings

Paramètres d'autorisation prédéfinis que vous ne pouvez spécifier que lorsque vous créez un espace nommé. D'autres paramètres pourraient être ajoutés à l'avenir. Pour en savoir plus sur les paramètres d'autorisation des espaces nommés, consultez En savoir plus sur les espaces.

Enums
PREDEFINED_PERMISSION_SETTINGS_UNSPECIFIED Non spécifié. Ne pas utiliser.
COLLABORATION_SPACE Paramètre permettant de faire de l'espace un espace de collaboration où tous les membres peuvent publier des messages.
ANNOUNCEMENT_SPACE Paramètre permettant de transformer l'espace en espace d'annonces où seuls les gestionnaires de l'espace peuvent publier des messages.

PermissionSettings

Paramètres d'autorisation que vous pouvez spécifier lorsque vous modifiez un espace nommé existant.

Pour définir les paramètres d'autorisation lors de la création d'un espace, spécifiez le champ PredefinedPermissionSettings dans votre requête.

Représentation 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)
  }
}
Champs
manageMembersAndGroups

object (PermissionSetting)

Facultatif. Paramètre permettant de gérer les membres et les groupes dans un espace.
modifySpaceDetails

object (PermissionSetting)

Facultatif. Paramètre permettant de modifier le nom, l'avatar, la description et les consignes de l'espace.
toggleHistory

object (PermissionSetting)

Facultatif. Paramètre permettant d'activer ou de désactiver l'historique des espaces.
useAtMentionAll

object (PermissionSetting)

Facultatif. Paramètre permettant d'utiliser @tous dans un espace.
manageApps

object (PermissionSetting)

Facultatif. Paramètre permettant de gérer les applications dans un espace.
manageWebhooks

object (PermissionSetting)

Facultatif. Paramètre permettant de gérer les webhooks dans un espace.
postMessages

object (PermissionSetting)

Uniquement en sortie. Paramètre permettant de publier des messages dans un espace.
replyMessages

object (PermissionSetting)

Facultatif. Paramètre pour répondre aux messages dans un espace.

PermissionSetting

Représente un paramètre d'autorisation d'espace.

Représentation JSON 
{
  "managersAllowed": boolean,
  "membersAllowed": boolean
}
Champs
managersAllowed

boolean

Facultatif. Indique si les gestionnaires d'espaces disposent de cette autorisation.
membersAllowed

boolean

Facultatif. Indique si les membres non administrateurs disposent de cette autorisation.

Méthodes

completeImport

 Termine le processus d'importation pour l'espace spécifié et le rend visible pour les utilisateurs.

create

 Crée un espace.

delete

 Supprime un espace nommé.

findDirectMessage

 Renvoie le message privé existant avec l'utilisateur spécifié.

get

 Renvoie des informations sur un espace.

list

 Liste les espaces dont l'appelant est membre.

patch

 Met à jour un espace.
Renvoie la liste des espaces d'une organisation Google Workspace en fonction de la recherche d'un administrateur.

setup

 Crée un espace et y ajoute les utilisateurs spécifiés.