Ressource: Espace
Un espace dans Google Chat. Les espaces sont des conversations entre deux utilisateurs ou plus, ou des messages 1:1 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 lors de la création d'un espace ou de la mise à jour du type d'espace. Sortie uniquement pour une autre utilisation. |
singleUserBotDm |
Facultatif. Indique si l'espace est un MP entre une application Chat et un seul humain. |
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 vous recevez le message d'erreur Pour les messages privés, ce champ peut être vide. Jusqu'à 128 caractères. |
externalUserAllowed |
Immuable. Indique si cet espace autorise tous les utilisateurs de Google Chat à devenir membres. Saisies 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 fils de discussion dans l'espace Chat. |
spaceDetails |
Informations sur l'espace, y compris sa description et ses 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. Immuable. Pour les espaces créés dans Chat, il s'agit de l'heure à laquelle ils ont été créés. Ce champ n'est généré qu'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 de la création de l'espace dans la source afin de conserver l'heure de création d'origine. Renseigné dans la sortie uniquement lorsque |
adminInstalled |
Uniquement en sortie. Pour les espaces de messagerie privée (MP) avec une application Chat, si l'espace a été créé par un administrateur Google Workspace Les administrateurs peuvent installer et configurer un message privé avec une application Chat pour le compte des utilisateurs de leur organisation. Pour permettre l'installation administrateur, votre application Chat doit être compatible avec la messagerie directe. |
accessSettings |
Facultatif. Spécifie le paramètre d'accès de l'espace. Renseigné uniquement lorsque |
spaceUri |
Uniquement en sortie. URI de l'espace. |
Type
Obsolète: utilisez plutôt SpaceType
.
Enums | |
---|---|
TYPE_UNSPECIFIED |
Réservé. |
ROOM |
Les conversations entre deux personnes ou plus |
DM |
Messages privés 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 pour la création ou la mise à jour d'un espace. Sortie uniquement pour une autre utilisation.
Enums | |
---|---|
SPACE_TYPE_UNSPECIFIED |
Réservé. |
SPACE |
Un endroit où les gens envoient des messages, partagent des fichiers et collaborent. Un élément SPACE peut inclure des applications Chat. |
GROUP_CHAT |
Des conversations de groupe entre trois personnes ou plus Un élément GROUP_CHAT peut inclure des applications Chat. |
DIRECT_MESSAGE |
Messages 1:1 entre deux humains ou entre un humain et une application Chat |
SpaceThreadingState
Spécifie le type d'état des fils de discussion 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 y répondre 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 |
SpaceDetails
Informations sur l'espace, y compris sa description et ses 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 les usages de l’espace. 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 conversation après leur création.
Enums | |
---|---|
HISTORY_STATE_UNSPECIFIED |
Valeur par défaut. Ne pas utiliser. |
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. |
AccessSettings
Représente le paramètre d'accès de l'espace.
Représentation JSON |
---|
{
"accessState": enum ( |
Champs | |
---|---|
accessState |
Uniquement en sortie. Indique l'état d'accès à l'espace. |
audience |
Facultatif. Nom de ressource de l'audience cible qui peut accéder à l'espace. Définissez ce champ sur un ID d'audience cible valide pour rendre l'espace visible ou utilisez l'alias |
AccessState
Représente l'état d'accès à l'espace.
Enums | |
---|---|
ACCESS_STATE_UNSPECIFIED |
L'état de l'accès est inconnu ou non compatible avec cette API. |
PRIVATE |
Les membres ou les groupes ajoutés ou invités peuvent voir l'espace. |
DISCOVERABLE |
L'espace est visible par l'audience cible sélectionnée, ainsi que par les membres ou les groupes ajoutés ou invités. |
Méthodes |
|
---|---|
|
Finalise 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. |