Ressource: Espace
Un 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 ( |
Champs | |
---|---|
name |
Nom de ressource de l'espace. Format : |
type |
Uniquement en sortie. Obsolète: utilisez plutôt |
spaceType |
Type d'espace. Obligatoire pour créer ou modifier le type d'un espace. Sortie uniquement pour une autre utilisation. |
singleUserBotDm |
Facultatif. Indique si l'espace est un MP entre une application Chat et une seule personne. |
threaded |
Uniquement en sortie. Obsolète: utilisez plutôt |
displayName |
Nom à afficher de l'espace. Obligatoire lors de la création d'un espace. Si le message d'erreur Pour les messages privés, ce champ peut être vide. Jusqu'à 128 caractères. |
externalUserAllowed |
Immuable. Indique si l'espace autorise les utilisateurs de Google Chat à devenir membre. À saisir lors de la création d'un espace dans une organisation Google Workspace. Omettez ce champ lorsque vous créez des espaces dans les conditions suivantes:
Pour les espaces existants, ce champ n'est généré qu'en sortie. |
spaceThreadingState |
Uniquement en sortie. État des threads dans l'espace Chat. |
spaceDetails |
Détails concernant l'espace, y compris la description et les règles. |
spaceHistoryState |
État de l'historique des messages et des fils de discussion de cet espace. |
importMode |
Facultatif. Indique si cet espace est créé dans |
createTime |
Facultatif. Heure de création des espaces créés dans Chat. Ce champ est uniquement en sortie, sauf lorsqu'il est utilisé dans des espaces importés. Pour les espaces importés, définissez ce champ sur l'horodatage historique correspondant à la date de 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 |
adminInstalled |
Uniquement en sortie. Indique si l'application Chat a été installée par un administrateur Google Workspace. Les administrateurs peuvent installer une application Chat pour leur domaine, leur unité organisationnelle ou un groupe d'utilisateurs. Les administrateurs ne peuvent installer que des applications Chat pour envoyer des messages privés entre les utilisateurs et l'application. Pour permettre l'installation administrateur, votre application doit inclure la messagerie directe. |
Type
Obsolète: utilisez plutôt SpaceType
.
Enums | |
---|---|
TYPE_UNSPECIFIED |
|
ROOM |
Conversations entre deux personnes ou plus |
DM |
Messages privés entre un humain et une application de chat, où tous les messages sont statiques Notez que cela n'inclut pas les messages privés entre deux personnes. |
Type d'espace
Type d'espace. Obligatoire pour la création ou la mise à jour d'un espace. Sortie uniquement pour une autre utilisation.
Enums | |
---|---|
SPACE_TYPE_UNSPECIFIED |
Réservée. |
SPACE |
Un espace où les utilisateurs peuvent envoyer des messages, partager des fichiers et collaborer Un SPACE peut inclure des applications Chat. |
GROUP_CHAT |
Conversations de groupe entre trois personnes ou plus Un GROUP_CHAT peut inclure des applications Chat. |
DIRECT_MESSAGE |
Messages privés entre deux humains ou entre deux personnes et une application Chat |
EspaceThreadingState
Spécifie le type d'état des threads dans l'espace Chat.
Enums | |
---|---|
SPACE_THREADING_STATE_UNSPECIFIED |
Réservée. |
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 conserver leur réponse dans le contexte du message d'origine. |
GROUPED_MESSAGES |
Espaces nommés où la conversation est organisée par sujet. Les sujets et leurs réponses sont regroupés. |
UNTHREADED_MESSAGES |
Messages privés (MP) entre deux personnes et conversations de groupe entre trois personnes ou plus |
Détails de l'espace
Détails concernant l'espace, y compris la description et les règles.
Représentation JSON |
---|
{ "description": string, "guidelines": string } |
Champs | |
---|---|
description |
Facultatif. Description de l'espace. Par exemple, décrivez le sujet de discussion, l'objectif fonctionnel ou les participants de l'espace. Jusqu'à 150 caractères. |
guidelines |
Facultatif. Les règles, les attentes et l'étiquette de l'espace. Jusqu'à 5 000 caractères. |
État de l'historique
État de l'historique des messages et des espaces. Indique 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 l'utilisez pas. |
HISTORY_OFF |
Historique 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 indiquent la durée de conservation des messages et des fils de discussion. |
Méthodes |
|
---|---|
|
Achète le processus d'importation de l'espace spécifié et le rend visible pour les utilisateurs. |
|
Crée un espace nommé. |
|
Supprime un espace nommé. |
|
Renvoie le message privé existant avec l'utilisateur spécifié. |
|
Affiche les détails d'un espace. |
|
Répertorie les espaces dont l'appelant est membre. |
|
Met à jour un espace. |
|
Crée un espace et y ajoute les utilisateurs spécifiés. |