Package google.chat.v1

Index

• ChatService (interface)
• AccessoryWidget (message)
• ActionResponse (message)
• ActionResponse.ResponseType (enum)
• ActionResponse.SelectionItems (message)
• ActionResponse.UpdatedWidget (message)
• ActionStatus (message)
• Annotation (message)
• AnnotationType (enum)
• AppCommandMetadata (message)
• AppCommandMetadata.AppCommandType (enum)
• AttachedGif (message)
• Attachment (message)
• Attachment.Source (enum)
• AttachmentDataRef (message)
• CalendarEventLinkData (message)
• CardWithId (message)
• ChatSpaceLinkData (message)
• CompleteImportSpaceRequest (message)
• CompleteImportSpaceResponse (message)
• ContextualAddOnMarkup (message)
• ContextualAddOnMarkup.Card (message)
• ContextualAddOnMarkup.Card.CardAction (message)
• ContextualAddOnMarkup.Card.CardHeader (message)
• ContextualAddOnMarkup.Card.CardHeader.ImageStyle (enum)
• ContextualAddOnMarkup.Card.Section (message)
• CreateCustomEmojiRequest (message)
• CreateMembershipRequest (message)
• CreateMessageRequest (message)
• CreateMessageRequest.MessageReplyOption (enum)
• CreateReactionRequest (message)
• CreateSpaceRequest (message)
• CustomEmoji (message)
• CustomEmoji.CustomEmojiPayload (message)
• CustomEmojiMetadata (message)
• DeleteCustomEmojiRequest (message)
• DeleteMembershipRequest (message)
• DeleteMessageRequest (message)
• DeleteReactionRequest (message)
• DeleteSpaceRequest (message)
• DeletionMetadata (message)
• DeletionMetadata.DeletionType (enum)
• Dialog (message)
• DialogAction (message)
• DriveDataRef (message)
• DriveLinkData (message)
• Emoji (message)
• EmojiReactionSummary (message)
• FindDirectMessageRequest (message)
• GetAttachmentRequest (message)
• GetCustomEmojiRequest (message)
• GetMembershipRequest (message)
• GetMessageRequest (message)
• GetSpaceEventRequest (message)
• GetSpaceNotificationSettingRequest (message)
• GetSpaceReadStateRequest (message)
• GetSpaceRequest (message)
• GetThreadReadStateRequest (message)
• Group (message)
• HistoryState (enum)
• ListCustomEmojisRequest (message)
• ListCustomEmojisResponse (message)
• ListMembershipsRequest (message)
• ListMembershipsResponse (message)
• ListMessagesRequest (message)
• ListMessagesResponse (message)
• ListReactionsRequest (message)
• ListReactionsResponse (message)
• ListSpaceEventsRequest (message)
• ListSpaceEventsResponse (message)
• ListSpacesRequest (message)
• ListSpacesResponse (message)
• MatchedUrl (message)
• MeetSpaceLinkData (message)
• MeetSpaceLinkData.HuddleStatus (enum)
• MeetSpaceLinkData.Type (enum)
• Membership (message)
• Membership.MembershipRole (enum)
• Membership.MembershipState (enum)
• MembershipBatchCreatedEventData (message)
• MembershipBatchDeletedEventData (message)
• MembershipBatchUpdatedEventData (message)
• MembershipCreatedEventData (message)
• MembershipDeletedEventData (message)
• MembershipUpdatedEventData (message)
• Message (message)
• MessageBatchCreatedEventData (message)
• MessageBatchDeletedEventData (message)
• MessageBatchUpdatedEventData (message)
• MessageCreatedEventData (message)
• MessageDeletedEventData (message)
• MessageUpdatedEventData (message)
• QuotedMessageMetadata (message)
• Reaction (message)
• ReactionBatchCreatedEventData (message)
• ReactionBatchDeletedEventData (message)
• ReactionCreatedEventData (message)
• ReactionDeletedEventData (message)
• RichLinkMetadata (message)
• RichLinkMetadata.RichLinkType (enum)
• SearchSpacesRequest (message)
• SearchSpacesResponse (message)
• SetUpSpaceRequest (message)
• SlashCommand (message)
• SlashCommandMetadata (message)
• SlashCommandMetadata.Type (enum)
• Space (message)
• Space.AccessSettings (message)
• Space.AccessSettings.AccessState (enum)
• Space.MembershipCount (message)
• Space.PermissionSetting (message)
• Space.PermissionSettings (message)
• Space.PredefinedPermissionSettings (enum)
• Space.SpaceDetails (message)
• Space.SpaceThreadingState (enum)
• Space.SpaceType (enum)
• Space.Type (enum)
• SpaceBatchUpdatedEventData (message)
• SpaceEvent (message)
• SpaceNotificationSetting (message)
• SpaceNotificationSetting.MuteSetting (enum)
• SpaceNotificationSetting.NotificationSetting (enum)
• SpaceReadState (message)
• SpaceUpdatedEventData (message)
• Thread (message)
• ThreadReadState (message)
• UpdateMembershipRequest (message)
• UpdateMessageRequest (message)
• UpdateSpaceNotificationSettingRequest (message)
• UpdateSpaceReadStateRequest (message)
• UpdateSpaceRequest (message)
• User (message)
• User.Type (enum)
• UserMentionMetadata (message)
• UserMentionMetadata.Type (enum)
• WidgetMarkup (message)
• WidgetMarkup.Button (message)
• WidgetMarkup.FormAction (message)
• WidgetMarkup.FormAction.ActionParameter (message)
• WidgetMarkup.Icon (enum)
• WidgetMarkup.Image (message)
• WidgetMarkup.ImageButton (message)
• WidgetMarkup.KeyValue (message)
• WidgetMarkup.OnClick (message)
• WidgetMarkup.OpenLink (message)
• WidgetMarkup.TextButton (message)
• WidgetMarkup.TextParagraph (message)

ChatService

Permet aux développeurs de créer des applications et des intégrations Chat sur la plate-forme Google Chat.

CompleteImportSpace

rpc CompleteImportSpace(CompleteImportSpaceRequest) returns (CompleteImportSpaceResponse) Finalise le processus d'importation pour l'espace spécifié et le rend visible pour les utilisateurs. Nécessite l'authentification de l'utilisateur et la délégation à l'échelle du domaine avec le champ d'application de l'autorisation : https://www.googleapis.com/auth/chat.import Pour en savoir plus, consultez Autoriser les applications Google Chat à importer des données. Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : https://www.googleapis.com/auth/chat.import Pour en savoir plus, consultez le guide d'autorisation.

CreateCustomEmoji

rpc CreateCustomEmoji(CreateCustomEmojiRequest) returns (CustomEmoji) Crée un emoji personnalisé. Les emoji personnalisés ne sont disponibles que pour les comptes Google Workspace. L'administrateur doit les activer pour l'organisation. Pour en savoir plus, consultez À propos des emoji personnalisés dans Google Chat et Gérer les autorisations pour les emoji personnalisés. Nécessite l'authentification de l'utilisateur avec le champ d'application de l'autorisation : https://www.googleapis.com/auth/chat.customemojis Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : https://www.googleapis.com/auth/chat.customemojis Pour en savoir plus, consultez le guide d'autorisation.

CreateMembership

rpc CreateMembership(CreateMembershipRequest) returns (Membership) Crée un abonnement pour l'application Chat pour les appels, un utilisateur ou un groupe Google. Il n'est pas possible de créer des abonnements pour d'autres applications Chat. Lorsque vous créez un abonnement, si le membre spécifié a désactivé sa règle d'acceptation automatique, il est invité et doit accepter l'invitation à rejoindre l'espace avant de pouvoir le faire. Sinon, la création d'un abonnement ajoute directement le membre à l'espace spécifié. Les types d'authentification suivants sont acceptés : Authentification de l'application avec approbation de l'administrateur et champ d'application de l'autorisation : https://www.googleapis.com/auth/chat.app.memberships Authentification des utilisateurs avec l'un des champs d'application d'autorisation suivants : https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.memberships.app (pour ajouter l'application d'appel à l'espace) https://www.googleapis.com/auth/chat.import (espaces en mode importation uniquement) L'authentification de l'utilisateur accorde des droits d'administrateur lorsqu'un compte administrateur s'authentifie, use_admin_access est true et que le champ d'application d'autorisation suivant est utilisé : https://www.googleapis.com/auth/chat.admin.memberships L'authentification des applications n'est pas compatible avec les cas d'utilisation suivants : Inviter des utilisateurs externes à l'organisation Workspace propriétaire de l'espace Ajouter un groupe Google à un espace Ajout d'une application Chat à un espace Pour obtenir un exemple d'utilisation, consultez : Invitez ou ajoutez un utilisateur à un espace. Invitez ou ajoutez un groupe Google à un espace. Ajoutez l'application Chat à un espace. Champs d'application des autorisations Nécessite l'un des champs d'application OAuth suivants : https://www.googleapis.com/auth/chat.app.memberships https://www.googleapis.com/auth/chat.admin.memberships https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.memberships.app Pour en savoir plus, consultez le guide d'autorisation.

CreateMessage

rpc CreateMessage(CreateMessageRequest) returns (Message) crée un message dans un espace Google Chat ; Pour obtenir un exemple, consultez Envoyer un message. Les types d'authentification suivants sont acceptés : Authentification de l'application avec le champ d'application de l'autorisation : https://www.googleapis.com/auth/chat.bot Authentification de l'utilisateur avec l'un des champs d'application d'autorisation suivants : https://www.googleapis.com/auth/chat.messages.create https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.import (espaces en mode importation uniquement) Chat attribue l'expéditeur du message différemment selon le type d'authentification que vous utilisez dans votre requête. L'image suivante montre comment Chat attribue un message lorsque vous utilisez l'authentification d'application. Chat affiche l'application Chat comme expéditeur du message. Le contenu du message peut contenir du texte (text), des cartes (cardsV2) et des widgets accessoires (accessoryWidgets). L'image suivante montre comment Chat attribue un message lorsque vous utilisez l'authentification des utilisateurs. Chat affiche l'utilisateur comme expéditeur du message et attribue l'application Chat au message en affichant son nom. Le contenu du message ne peut contenir que du texte (text). La taille maximale du message, y compris son contenu, est de 32 000 octets. Pour les requêtes webhook, la réponse ne contient pas le message complet. La réponse ne renseigne que les champs name et thread.name, en plus des informations contenues dans la requête. Champs d'application des autorisations Nécessite l'un des champs d'application OAuth suivants : https://www.googleapis.com/auth/chat.bot https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.messages.create Pour en savoir plus, consultez le guide d'autorisation.

CreateReaction

rpc CreateReaction(CreateReactionRequest) returns (Reaction) Crée une réaction et l'ajoute à un message. Pour obtenir un exemple, consultez Ajouter une réaction à un message. Nécessite une authentification de l'utilisateur avec l'un des champs d'application d'autorisation suivants : https://www.googleapis.com/auth/chat.messages.reactions.create https://www.googleapis.com/auth/chat.messages.reactions https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.import (espaces en mode importation uniquement) Champs d'application des autorisations Nécessite l'un des champs d'application OAuth suivants : https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.messages.reactions https://www.googleapis.com/auth/chat.messages.reactions.create Pour en savoir plus, consultez le guide d'autorisation.

CreateSpace

rpc CreateSpace(CreateSpaceRequest) returns (Space) Crée un espace. Permet de créer un espace nommé ou un chat de groupe dans Import mode. Pour obtenir un exemple, consultez Créer un espace. Les types d'authentification suivants sont acceptés : Authentification de l'application avec approbation de l'administrateur et l'un des champs d'application d'autorisation suivants : https://www.googleapis.com/auth/chat.app.spaces.create https://www.googleapis.com/auth/chat.app.spaces Authentification des utilisateurs avec l'un des champs d'application d'autorisation suivants : https://www.googleapis.com/auth/chat.spaces.create https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.import (espaces en mode importation uniquement) Lors de l'authentification en tant qu'application, le champ space.customer doit être défini dans la requête. Lorsque vous vous authentifiez en tant qu'application, l'application Chat est ajoutée en tant que membre de l'espace. Toutefois, contrairement à l'authentification humaine, l'application Chat n'est pas ajoutée en tant que gestionnaire de l'espace. Par défaut, tous les membres de l'espace peuvent supprimer l'application Chat de l'espace. Pour autoriser uniquement les gestionnaires d'espace à supprimer l'application d'un espace, définissez space.permission_settings.manage_apps sur managers_allowed. L'appartenance à un espace lors de sa création dépend de l'endroit où il est créé :Import mode Mode Importation : aucun membre n'est créé. Tous les autres modes : l'utilisateur qui appelle est ajouté en tant que membre. Il s'agit des actions de conversion suivantes : L'application elle-même lors de l'utilisation de l'authentification par application. Utilisateur humain lors de l'utilisation de l'authentification de l'utilisateur. Si le message d'erreur ALREADY_EXISTS s'affiche lorsque vous créez un espace, essayez un autre displayName. Il est possible qu'un espace existant dans l'organisation Google Workspace utilise déjà ce nom à afficher. Champs d'application des autorisations Nécessite l'un des champs d'application OAuth suivants : https://www.googleapis.com/auth/chat.app.spaces.create https://www.googleapis.com/auth/chat.app.spaces https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.spaces.create Pour en savoir plus, consultez le guide d'autorisation.

DeleteCustomEmoji

rpc DeleteCustomEmoji(DeleteCustomEmojiRequest) returns (Empty) Supprime un emoji personnalisé. Par défaut, les utilisateurs ne peuvent supprimer que les emoji personnalisés qu'ils ont créés. Les gestionnaires d'emoji désignés par l'administrateur peuvent supprimer n'importe quel emoji personnalisé de l'organisation. Consultez À propos des emoji personnalisés dans Google Chat. Les emoji personnalisés ne sont disponibles que pour les comptes Google Workspace. L'administrateur doit les activer pour l'organisation. Pour en savoir plus, consultez À propos des emoji personnalisés dans Google Chat et Gérer les autorisations pour les emoji personnalisés. Nécessite l'authentification de l'utilisateur avec le champ d'application de l'autorisation : https://www.googleapis.com/auth/chat.customemojis Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : https://www.googleapis.com/auth/chat.customemojis Pour en savoir plus, consultez le guide d'autorisation.

DeleteMembership

rpc DeleteMembership(DeleteMembershipRequest) returns (Membership) Supprime un abonnement. Pour obtenir un exemple, consultez Supprimer un utilisateur ou une application Google Chat d'un espace. Les types d'authentification suivants sont acceptés : Authentification de l'application avec approbation de l'administrateur et champ d'application de l'autorisation : https://www.googleapis.com/auth/chat.app.memberships Authentification des utilisateurs avec l'un des champs d'application d'autorisation suivants : https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.memberships.app (pour supprimer l'application d'appel de l'espace) https://www.googleapis.com/auth/chat.import (espaces en mode importation uniquement) L'authentification de l'utilisateur accorde des droits d'administrateur lorsqu'un compte administrateur s'authentifie, use_admin_access est true et que le champ d'application d'autorisation suivant est utilisé : https://www.googleapis.com/auth/chat.admin.memberships L'authentification des applications n'est pas compatible avec les cas d'utilisation suivants : Supprimer un groupe Google d'un espace Supprimer une application Chat d'un espace Pour supprimer des membres d'un espace, le demandeur doit être gestionnaire de l'espace. Si vous utilisez l'authentification par application, l'application Chat doit être le créateur de l'espace. Champs d'application des autorisations Nécessite l'un des champs d'application OAuth suivants : https://www.googleapis.com/auth/chat.app.memberships https://www.googleapis.com/auth/chat.admin.memberships https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.memberships.app Pour en savoir plus, consultez le guide d'autorisation.

DeleteMessage

rpc DeleteMessage(DeleteMessageRequest) returns (Empty) Supprime un message. Pour obtenir un exemple, consultez Supprimer un message. Les types d'authentification suivants sont acceptés : Authentification par l'application avec le champ d'application de l'autorisation : https://www.googleapis.com/auth/chat.bot Authentification des utilisateurs avec l'un des champs d'application d'autorisation suivants : https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.import (espaces en mode importation uniquement) Lorsque vous utilisez l'authentification d'application, les requêtes ne peuvent supprimer que les messages créés par l'application Chat appelante. Champs d'application des autorisations Nécessite l'un des champs d'application OAuth suivants : https://www.googleapis.com/auth/chat.bot https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.messages Pour en savoir plus, consultez le guide d'autorisation.

DeleteReaction

rpc DeleteReaction(DeleteReactionRequest) returns (Empty) Supprime une réaction à un message. Pour obtenir un exemple, consultez Supprimer une réaction. Nécessite une authentification de l'utilisateur avec l'un des champs d'application d'autorisation suivants : https://www.googleapis.com/auth/chat.messages.reactions https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.import (espaces en mode importation uniquement) Champs d'application des autorisations Nécessite l'un des champs d'application OAuth suivants : https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.messages.reactions Pour en savoir plus, consultez le guide d'autorisation.

DeleteSpace

rpc DeleteSpace(DeleteSpaceRequest) returns (Empty) Supprime un espace nommé. Effectue toujours une suppression en cascade, ce qui signifie que les ressources enfants de l'espace (comme les messages publiés dans l'espace et les membres de l'espace) sont également supprimées. Pour obtenir un exemple, consultez Supprimer un espace. Les types d'authentification suivants sont acceptés : Authentification de l'application avec approbation de l'administrateur et champ d'application de l'autorisation : https://www.googleapis.com/auth/chat.app.delete (uniquement dans les espaces créés par l'application) Authentification des utilisateurs avec l'un des champs d'application d'autorisation suivants : https://www.googleapis.com/auth/chat.delete https://www.googleapis.com/auth/chat.import (espaces en mode importation uniquement) L'authentification de l'utilisateur accorde des droits d'administrateur lorsqu'un compte administrateur s'authentifie, use_admin_access est true et que le champ d'application d'autorisation suivant est utilisé : https://www.googleapis.com/auth/chat.admin.delete Champs d'application des autorisations Nécessite l'un des champs d'application OAuth suivants : https://www.googleapis.com/auth/chat.app.delete https://www.googleapis.com/auth/chat.admin.delete https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.delete Pour en savoir plus, consultez le guide d'autorisation.

FindDirectMessage

rpc FindDirectMessage(FindDirectMessageRequest) returns (Space) Renvoie le message privé existant avec l'utilisateur spécifié. Si aucun espace de message privé n'est trouvé, une erreur 404 NOT_FOUND est renvoyée. Pour obtenir un exemple, consultez Rechercher un message privé. Avec l'authentification de l'application, renvoie l'espace de message privé entre l'utilisateur spécifié et l'application Chat appelante. Avec l'authentification de l'utilisateur, renvoie l'espace de messages privés entre l'utilisateur spécifié et l'utilisateur authentifié. Les types d'authentification suivants sont acceptés : Authentification par l'application avec le champ d'application de l'autorisation : https://www.googleapis.com/auth/chat.bot Authentification des utilisateurs avec l'un des champs d'application d'autorisation suivants : https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.spaces Champs d'application des autorisations Nécessite l'un des champs d'application OAuth suivants : https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.bot Pour en savoir plus, consultez le guide d'autorisation.

GetAttachment

rpc GetAttachment(GetAttachmentRequest) returns (Attachment) Obtient les métadonnées d'une pièce jointe d'un message. Les données des pièces jointes sont récupérées à l'aide de l'API Media. Pour obtenir un exemple, consultez Obtenir des métadonnées sur une pièce jointe d'un message. Nécessite une authentification de l'application avec le champ d'application de l'autorisation : https://www.googleapis.com/auth/chat.bot Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : https://www.googleapis.com/auth/chat.bot Pour en savoir plus, consultez le guide d'autorisation.

GetCustomEmoji

rpc GetCustomEmoji(GetCustomEmojiRequest) returns (CustomEmoji) Renvoie des informations sur un emoji personnalisé. Les emoji personnalisés ne sont disponibles que pour les comptes Google Workspace. L'administrateur doit les activer pour l'organisation. Pour en savoir plus, consultez À propos des emoji personnalisés dans Google Chat et Gérer les autorisations pour les emoji personnalisés. Nécessite une authentification de l'utilisateur avec l'un des champs d'application d'autorisation suivants : https://www.googleapis.com/auth/chat.customemojis.readonly https://www.googleapis.com/auth/chat.customemojis Champs d'application des autorisations Nécessite l'un des champs d'application OAuth suivants : https://www.googleapis.com/auth/chat.customemojis https://www.googleapis.com/auth/chat.customemojis.readonly Pour en savoir plus, consultez le guide d'autorisation.

GetMembership

rpc GetMembership(GetMembershipRequest) returns (Membership) Renvoie des informations sur une appartenance. Pour obtenir un exemple, consultez Obtenir des informations sur l'appartenance d'un utilisateur ou d'une application Google Chat. Les types d'authentification suivants sont acceptés : Authentification de l'application avec l'un des niveaux d'autorisation suivants : https://www.googleapis.com/auth/chat.bot https://www.googleapis.com/auth/chat.app.memberships (requiert l'approbation de l'administrateur) Authentification des utilisateurs avec l'un des champs d'application d'autorisation suivants : https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships L'authentification des utilisateurs accorde des droits d'administrateur lorsqu'un compte administrateur s'authentifie, use_admin_access est true et que l'un des niveaux d'autorisation suivants est utilisé : https://www.googleapis.com/auth/chat.admin.memberships.readonly https://www.googleapis.com/auth/chat.admin.memberships Champs d'application des autorisations Nécessite l'un des champs d'application OAuth suivants : https://www.googleapis.com/auth/chat.admin.memberships https://www.googleapis.com/auth/chat.admin.memberships.readonly https://www.googleapis.com/auth/chat.app.memberships https://www.googleapis.com/auth/chat.bot https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.memberships.readonly Pour en savoir plus, consultez le guide d'autorisation.

GetMessage

rpc GetMessage(GetMessageRequest) returns (Message) Renvoie des informations sur un message. Pour obtenir un exemple, consultez Obtenir des informations sur un message. Les types d'authentification suivants sont acceptés : Authentification par l'application avec le champ d'application de l'autorisation : https://www.googleapis.com/auth/chat.bot Authentification des utilisateurs avec l'un des champs d'application d'autorisation suivants : https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.messages Remarque : Il est possible qu'un message provenant d'un membre ou d'un espace bloqué soit renvoyé. Champs d'application des autorisations Nécessite l'un des champs d'application OAuth suivants : https://www.googleapis.com/auth/chat.bot https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.messages.readonly Pour en savoir plus, consultez le guide d'autorisation.

GetSpace

rpc GetSpace(GetSpaceRequest) returns (Space) Renvoie des informations sur un espace. Pour obtenir un exemple, consultez Obtenir des informations sur un espace. Les types d'authentification suivants sont acceptés : Authentification de l'application avec l'un des niveaux d'autorisation suivants : https://www.googleapis.com/auth/chat.bot https://www.googleapis.com/auth/chat.app.spaces avec l'approbation de l'administrateur Authentification des utilisateurs avec l'un des champs d'application d'autorisation suivants : https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.spaces L'authentification des utilisateurs accorde des droits d'administrateur lorsqu'un compte administrateur s'authentifie, use_admin_access est true et que l'un des niveaux d'autorisation suivants est utilisé : https://www.googleapis.com/auth/chat.admin.spaces.readonly https://www.googleapis.com/auth/chat.admin.spaces L'authentification des applications présente les limites suivantes : space.access_settings n'est renseigné que lorsque la portée chat.app.spaces est utilisée. space.predefind_permission_settings et space.permission_settings ne sont renseignés que lorsque vous utilisez le champ d'application chat.app.spaces, et uniquement pour les espaces créés par l'application. Champs d'application des autorisations Nécessite l'un des champs d'application OAuth suivants : https://www.googleapis.com/auth/chat.admin.spaces https://www.googleapis.com/auth/chat.admin.spaces.readonly https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.bot https://www.googleapis.com/auth/chat.app.spaces Pour en savoir plus, consultez le guide d'autorisation.

GetSpaceEvent

rpc GetSpaceEvent(GetSpaceEventRequest) returns (SpaceEvent) Renvoie un événement d'un espace Google Chat. La charge utile de l'événement contient la version la plus récente de la ressource qui a été modifiée. Par exemple, si vous demandez un événement concernant un nouveau message, mais que le message a été modifié par la suite, le serveur renvoie la ressource Message mise à jour dans la charge utile de l'événement. Remarque : Le champ permissionSettings n'est pas renvoyé dans l'objet Space des données d'événement Space pour cette requête. Nécessite une authentification de l'utilisateur avec un niveau d'accès approprié pour lire les données demandées : https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.messages.reactions.readonly https://www.googleapis.com/auth/chat.messages.reactions https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships Pour obtenir un événement, l'utilisateur authentifié doit être membre de l'espace. Pour obtenir un exemple, consultez Obtenir des informations sur un événement à partir d'un espace Google Chat. Champs d'application des autorisations Nécessite l'un des champs d'application OAuth suivants : https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.messages.reactions https://www.googleapis.com/auth/chat.messages.reactions.readonly Pour en savoir plus, consultez le guide d'autorisation.

GetSpaceNotificationSetting

rpc GetSpaceNotificationSetting(GetSpaceNotificationSettingRequest) returns (SpaceNotificationSetting) Récupère le paramètre de notification de l'espace. Pour obtenir un exemple, consultez Obtenir le paramètre de notification de l'espace de l'appelant. Nécessite l'authentification de l'utilisateur avec le champ d'application de l'autorisation : https://www.googleapis.com/auth/chat.users.spacesettings Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : https://www.googleapis.com/auth/chat.users.spacesettings Pour en savoir plus, consultez le guide d'autorisation.

GetSpaceReadState

rpc GetSpaceReadState(GetSpaceReadStateRequest) returns (SpaceReadState) Renvoie des informations sur l'état de lecture d'un utilisateur dans un espace, utilisé pour identifier les messages lus et non lus. Pour obtenir un exemple, consultez Obtenir des informations sur l'état de lecture d'un espace par un utilisateur. Nécessite une authentification de l'utilisateur avec l'un des champs d'application d'autorisation suivants : https://www.googleapis.com/auth/chat.users.readstate.readonly https://www.googleapis.com/auth/chat.users.readstate Champs d'application des autorisations Nécessite l'un des champs d'application OAuth suivants : https://www.googleapis.com/auth/chat.users.readstate https://www.googleapis.com/auth/chat.users.readstate.readonly Pour en savoir plus, consultez le guide d'autorisation.

GetThreadReadState

rpc GetThreadReadState(GetThreadReadStateRequest) returns (ThreadReadState) Renvoie des informations sur l'état de lecture d'un utilisateur dans un thread, utilisé pour identifier les messages lus et non lus. Pour obtenir un exemple, consultez Obtenir des informations sur l'état de lecture des fils de discussion d'un utilisateur. Nécessite une authentification de l'utilisateur avec l'un des champs d'application d'autorisation suivants : https://www.googleapis.com/auth/chat.users.readstate.readonly https://www.googleapis.com/auth/chat.users.readstate Champs d'application des autorisations Nécessite l'un des champs d'application OAuth suivants : https://www.googleapis.com/auth/chat.users.readstate https://www.googleapis.com/auth/chat.users.readstate.readonly Pour en savoir plus, consultez le guide d'autorisation.

ListCustomEmojis

rpc ListCustomEmojis(ListCustomEmojisRequest) returns (ListCustomEmojisResponse) Liste les emoji personnalisés visibles par l'utilisateur authentifié. Les emoji personnalisés ne sont disponibles que pour les comptes Google Workspace. L'administrateur doit les activer pour l'organisation. Pour en savoir plus, consultez À propos des emoji personnalisés dans Google Chat et Gérer les autorisations pour les emoji personnalisés. Nécessite une authentification de l'utilisateur avec l'un des champs d'application d'autorisation suivants : https://www.googleapis.com/auth/chat.customemojis.readonly https://www.googleapis.com/auth/chat.customemojis Champs d'application des autorisations Nécessite l'un des champs d'application OAuth suivants : https://www.googleapis.com/auth/chat.customemojis https://www.googleapis.com/auth/chat.customemojis.readonly Pour en savoir plus, consultez le guide d'autorisation.

ListMemberships

rpc ListMemberships(ListMembershipsRequest) returns (ListMembershipsResponse) Répertorie les membres d'un espace. Pour obtenir un exemple, consultez Lister les utilisateurs et les applications Google Chat dans un espace. La liste des membres avec authentification de l'application répertorie les membres des espaces auxquels l'application Chat a accès, mais exclut les membres de l'application Chat, y compris les siens. La liste des abonnements avec l'authentification des utilisateurs répertorie les abonnements aux espaces auxquels l'utilisateur authentifié a accès. Les types d'authentification suivants sont acceptés : Authentification de l'application avec l'un des niveaux d'autorisation suivants : https://www.googleapis.com/auth/chat.bot https://www.googleapis.com/auth/chat.app.memberships (requiert l'approbation de l'administrateur) Authentification des utilisateurs avec l'un des champs d'application d'autorisation suivants : https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.import (espaces en mode importation uniquement) L'authentification des utilisateurs accorde des droits d'administrateur lorsqu'un compte administrateur s'authentifie, use_admin_access est true et que l'un des niveaux d'autorisation suivants est utilisé : https://www.googleapis.com/auth/chat.admin.memberships.readonly https://www.googleapis.com/auth/chat.admin.memberships Champs d'application des autorisations Nécessite l'un des champs d'application OAuth suivants : https://www.googleapis.com/auth/chat.admin.memberships https://www.googleapis.com/auth/chat.admin.memberships.readonly https://www.googleapis.com/auth/chat.app.memberships https://www.googleapis.com/auth/chat.bot https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.memberships.readonly Pour en savoir plus, consultez le guide d'autorisation.

ListMessages

rpc ListMessages(ListMessagesRequest) returns (ListMessagesResponse) Liste les messages d'un espace dont l'appelant est membre, y compris les messages des membres et espaces bloqués. Si vous listez les messages d'un espace sans message, la réponse est un objet vide. Lorsque vous utilisez une interface REST/HTTP, la réponse contient un objet JSON vide, {}. Pour obtenir un exemple, consultez Lister les messages. Nécessite une authentification de l'utilisateur avec l'un des champs d'application d'autorisation suivants : https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.import (espaces en mode importation uniquement) Champs d'application des autorisations Nécessite l'un des champs d'application OAuth suivants : https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.messages.readonly Pour en savoir plus, consultez le guide d'autorisation.

ListReactions

rpc ListReactions(ListReactionsRequest) returns (ListReactionsResponse) Liste les réactions à un message. Pour obtenir un exemple, consultez Lister les réactions à un message. Nécessite une authentification de l'utilisateur avec l'un des champs d'application d'autorisation suivants : https://www.googleapis.com/auth/chat.messages.reactions.readonly https://www.googleapis.com/auth/chat.messages.reactions https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.messages Champs d'application des autorisations Nécessite l'un des champs d'application OAuth suivants : https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.messages.reactions https://www.googleapis.com/auth/chat.messages.reactions.readonly Pour en savoir plus, consultez le guide d'autorisation.

ListSpaceEvents

rpc ListSpaceEvents(ListSpaceEventsRequest) returns (ListSpaceEventsResponse) Liste les événements d'un espace Google Chat. Pour chaque événement, la charge utile contient la version la plus récente de la ressource Chat. Par exemple, si vous listez des événements concernant de nouveaux membres d'un espace, le serveur renvoie des ressources Membership contenant les dernières informations sur les membres. Si de nouveaux membres ont été supprimés au cours de la période demandée, la charge utile de l'événement contient une ressource Membership vide. Nécessite une authentification de l'utilisateur avec un niveau d'accès approprié pour lire les données demandées : https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.messages.reactions.readonly https://www.googleapis.com/auth/chat.messages.reactions https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships Pour lister les événements, l'utilisateur authentifié doit être membre de l'espace. Pour obtenir un exemple, consultez Lister les événements d'un espace Google Chat. Champs d'application des autorisations Nécessite l'un des champs d'application OAuth suivants : https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.messages.reactions https://www.googleapis.com/auth/chat.messages.reactions.readonly Pour en savoir plus, consultez le guide d'autorisation.

ListSpaces

rpc ListSpaces(ListSpacesRequest) returns (ListSpacesResponse) Liste les espaces dont l'appelant est membre. Les discussions de groupe et les messages privés ne sont listés qu'une fois le premier message envoyé. Pour obtenir un exemple, consultez Lister les espaces. Les types d'authentification suivants sont acceptés : Authentification par l'application avec le champ d'application de l'autorisation : https://www.googleapis.com/auth/chat.bot Authentification des utilisateurs avec l'un des champs d'application d'autorisation suivants : https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.spaces Pour lister tous les espaces nommés par organisation Google Workspace, utilisez plutôt la méthode spaces.search() avec les droits d'administrateur Workspace. Champs d'application des autorisations Nécessite l'un des champs d'application OAuth suivants : https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.bot Pour en savoir plus, consultez le guide d'autorisation.

SearchSpaces

rpc SearchSpaces(SearchSpacesRequest) returns (SearchSpacesResponse) Renvoie la liste des espaces d'une organisation Google Workspace en fonction de la recherche d'un administrateur. Nécessite une authentification utilisateur avec droits d'administrateur et l'un des champs d'application d'autorisation suivants : https://www.googleapis.com/auth/chat.admin.spaces.readonly https://www.googleapis.com/auth/chat.admin.spaces Dans la requête, définissez use_admin_access sur true. Champs d'application des autorisations Nécessite l'un des champs d'application OAuth suivants : https://www.googleapis.com/auth/chat.admin.spaces https://www.googleapis.com/auth/chat.admin.spaces.readonly Pour en savoir plus, consultez le guide d'autorisation.

SetUpSpace

rpc SetUpSpace(SetUpSpaceRequest) returns (Space) Crée un espace et y ajoute les utilisateurs spécifiés. L'utilisateur appelant est automatiquement ajouté à l'espace et ne doit pas être spécifié en tant que membre dans la requête. Pour obtenir un exemple, consultez Configurer un espace avec des membres initiaux. Pour spécifier les membres humains à ajouter, ajoutez des appartenances avec le membership.member.name approprié. Pour ajouter un utilisateur humain, utilisez users/{user}, où {user} peut être l'adresse e-mail de l'utilisateur. Pour les utilisateurs de la même organisation Workspace, {user} peut également être le id de la personne dans l'API People ou le id de l'utilisateur dans l'API Directory. Par exemple, si l'ID de profil de personne de l'API People pour [e-mail] est 123456789, vous pouvez ajouter l'utilisateur à l'espace en définissant membership.member.name sur users/[e-mail] ou users/123456789. Pour spécifier les groupes Google à ajouter, ajoutez des abonnements avec le membership.group_member.name approprié. Pour ajouter ou inviter un groupe Google, utilisez groups/{group}, où {group} correspond à l'id du groupe à partir de l'API Cloud Identity Groups. Par exemple, vous pouvez utiliser l'API Cloud Identity Groups Lookup pour récupérer l'ID 123456789 pour l'adresse e-mail du groupe [e-mail], puis ajouter le groupe à l'espace en définissant membership.group_member.name sur groups/123456789. Les adresses e-mail de groupe ne sont pas acceptées. Les groupes Google ne peuvent être ajoutés en tant que membres que dans les espaces nommés. Pour un espace nommé ou une discussion de groupe, si l'appelant bloque certains membres ou est bloqué par certains d'entre eux, ou s'il n'est pas autorisé à ajouter certains membres, ces membres ne sont pas ajoutés à l'espace créé. Pour créer un message privé (MP) entre l'utilisateur qui appelle et un autre utilisateur humain, spécifiez exactement une appartenance pour représenter l'utilisateur humain. Si un utilisateur bloque l'autre, la demande échoue et le message privé n'est pas créé. Pour créer un MP entre l'utilisateur appelant et l'application appelante, définissez Space.singleUserBotDm sur true et ne spécifiez aucune appartenance. Vous ne pouvez utiliser cette méthode que pour configurer un message privé avec l'application d'appel. Pour ajouter l'application d'appel en tant que membre d'un espace ou d'un message privé existant entre deux utilisateurs humains, consultez Inviter ou ajouter un utilisateur ou une application à un espace. Si un message privé existe déjà entre deux utilisateurs, même si l'un d'eux bloque l'autre au moment où la demande est effectuée, le message privé existant est renvoyé. Les espaces avec des réponses groupées ne sont pas acceptés. Si le message d'erreur ALREADY_EXISTS s'affiche lorsque vous configurez un espace, essayez un autre displayName. Il est possible qu'un espace existant dans l'organisation Google Workspace utilise déjà ce nom à afficher. Nécessite une authentification de l'utilisateur avec l'un des champs d'application d'autorisation suivants : https://www.googleapis.com/auth/chat.spaces.create https://www.googleapis.com/auth/chat.spaces Champs d'application des autorisations Nécessite l'un des champs d'application OAuth suivants : https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.spaces.create Pour en savoir plus, consultez le guide d'autorisation.

UpdateMembership

rpc UpdateMembership(UpdateMembershipRequest) returns (Membership) Met à jour une appartenance. Pour consulter un exemple, reportez-vous à la section Modifier l'appartenance d'un utilisateur à un espace. Les types d'authentification suivants sont acceptés : Authentification de l'application avec approbation de l'administrateur et champ d'application de l'autorisation : https://www.googleapis.com/auth/chat.app.memberships (uniquement dans les espaces créés par l'application) Authentification des utilisateurs avec l'un des champs d'application d'autorisation suivants : https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.import (espaces en mode importation uniquement) L'authentification de l'utilisateur accorde des droits d'administrateur lorsqu'un compte administrateur s'authentifie, use_admin_access est true et que le champ d'application d'autorisation suivant est utilisé : https://www.googleapis.com/auth/chat.admin.memberships Champs d'application des autorisations Nécessite l'un des champs d'application OAuth suivants : https://www.googleapis.com/auth/chat.app.memberships https://www.googleapis.com/auth/chat.admin.memberships https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.memberships Pour en savoir plus, consultez le guide d'autorisation.

UpdateMessage

rpc UpdateMessage(UpdateMessageRequest) returns (Message) Met à jour un message. Il existe une différence entre les méthodes patch et update. La méthode patch utilise une requête patch, tandis que la méthode update utilise une requête put. Nous vous recommandons d'utiliser la méthode patch. Pour obtenir un exemple, consultez Mettre à jour un message. Les types d'authentification suivants sont acceptés : Authentification par l'application avec le champ d'application de l'autorisation : https://www.googleapis.com/auth/chat.bot Authentification des utilisateurs avec l'un des champs d'application d'autorisation suivants : https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.import (espaces en mode importation uniquement) Lorsque vous utilisez l'authentification d'application, les requêtes ne peuvent mettre à jour que les messages créés par l'application Chat appelante. Champs d'application des autorisations Nécessite l'un des champs d'application OAuth suivants : https://www.googleapis.com/auth/chat.bot https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.messages Pour en savoir plus, consultez le guide d'autorisation.

UpdateSpace

rpc UpdateSpace(UpdateSpaceRequest) returns (Space) Met à jour un espace. Pour obtenir un exemple, consultez Mettre à jour un espace. Si vous mettez à jour le champ displayName et que le message d'erreur ALREADY_EXISTS s'affiche, essayez un autre nom à afficher. Il est possible qu'un espace existant dans l'organisation Google Workspace utilise déjà ce nom à afficher. Les types d'authentification suivants sont acceptés : Authentification de l'application avec approbation de l'administrateur et l'un des champs d'application d'autorisation suivants : https://www.googleapis.com/auth/chat.app.spaces Authentification des utilisateurs avec l'un des champs d'application d'autorisation suivants : https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.import (espaces en mode importation uniquement) L'authentification des utilisateurs accorde des droits d'administrateur lorsqu'un compte administrateur s'authentifie, use_admin_access est défini sur true et les niveaux d'accès suivants sont utilisés : https://www.googleapis.com/auth/chat.admin.spaces L'authentification des applications présente les limites suivantes : Pour mettre à jour space.predefined_permission_settings ou space.permission_settings, l'application doit être celle qui a créé l'espace. La mise à jour de space.access_settings.audience n'est pas acceptée pour l'authentification des applications. Champs d'application des autorisations Nécessite l'un des champs d'application OAuth suivants : https://www.googleapis.com/auth/chat.app.spaces https://www.googleapis.com/auth/chat.admin.spaces https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.spaces Pour en savoir plus, consultez le guide d'autorisation.

UpdateSpaceNotificationSetting

rpc UpdateSpaceNotificationSetting(UpdateSpaceNotificationSettingRequest) returns (SpaceNotificationSetting) Met à jour le paramètre de notification de l'espace. Pour obtenir un exemple, consultez Mettre à jour le paramètre de notification de l'espace de l'appelant. Nécessite l'authentification de l'utilisateur avec le champ d'application de l'autorisation : https://www.googleapis.com/auth/chat.users.spacesettings Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : https://www.googleapis.com/auth/chat.users.spacesettings Pour en savoir plus, consultez le guide d'autorisation.

UpdateSpaceReadState

rpc UpdateSpaceReadState(UpdateSpaceReadStateRequest) returns (SpaceReadState) Met à jour l'état de lecture d'un utilisateur dans un espace. Permet d'identifier les messages lus et non lus. Pour consulter un exemple, reportez-vous à la section Mettre à jour l'état de lecture d'un espace pour un utilisateur. Nécessite l'authentification de l'utilisateur avec le champ d'application de l'autorisation : https://www.googleapis.com/auth/chat.users.readstate Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : https://www.googleapis.com/auth/chat.users.readstate Pour en savoir plus, consultez le guide d'autorisation.

AccessoryWidget

Un ou plusieurs widgets interactifs qui s'affichent en bas d'un message. Pour en savoir plus, consultez Ajouter des widgets interactifs au bas d'un message.

Champs
Champ d'union action. Type d'action. action ne peut être qu'un des éléments suivants :
button_list	ButtonList Liste de boutons.

ActionResponse

Paramètres qu'une application Chat peut utiliser pour configurer la façon dont sa réponse est publiée.

Champs
type	ResponseType Uniquement en entrée. Type de réponse de l'application Chat.
url	string Uniquement en entrée. URL permettant aux utilisateurs de s'authentifier ou de configurer le service. (Uniquement pour les types de réponse REQUEST_CONFIG.)
dialog_action	DialogAction Uniquement en entrée. Réponse à un événement d'interaction lié à une boîte de dialogue. Doit être accompagné de ResponseType.Dialog.
updated_widget	UpdatedWidget Uniquement en entrée. Réponse du widget mis à jour.

ResponseType

Type de réponse de l'application Chat.

Enums
TYPE_UNSPECIFIED	Type par défaut géré en tant que NEW_MESSAGE.
NEW_MESSAGE	Publier un nouveau message dans le sujet
UPDATE_MESSAGE	Modifiez le message de l'application Chat. Cela n'est autorisé que pour un événement CARD_CLICKED dont le type d'expéditeur du message est BOT.
UPDATE_USER_MESSAGE_CARDS	Mettez à jour les fiches du message d'un utilisateur. Cela n'est autorisé qu'en réponse à un événement MESSAGE avec une URL correspondante ou à un événement CARD_CLICKED dont le type d'expéditeur du message est HUMAN. Le texte est ignoré.
REQUEST_CONFIG	Demandez à l'utilisateur de manière privée de fournir une authentification ou une configuration supplémentaire.
DIALOG	Présente une boîte de dialogue.
UPDATE_WIDGET	Requête d'options de saisie semi-automatique du texte du widget.

SelectionItems

Liste des résultats de saisie semi-automatique du widget.

Champs
items[]	SelectionItem Tableau des objets SelectionItem.

UpdatedWidget

Pour les widgets selectionInput, renvoie des suggestions de saisie semi-automatique pour un menu à sélection multiple.

Champs
widget	string ID du widget mis à jour. L'ID doit correspondre à celui du widget qui a déclenché la demande de mise à jour.
Champ d'union updated_widget. Le widget a été mis à jour en réponse à une action de l'utilisateur. updated_widget ne peut être qu'un des éléments suivants :
suggestions	SelectionItems Liste des résultats de saisie semi-automatique du widget

ActionStatus

Représente l'état d'une requête visant à appeler ou à envoyer un dialogue.

Champs
status_code	Code Code d'état.
user_facing_message	string Message à envoyer aux utilisateurs concernant l'état de leur demande. Si cette valeur n'est pas définie, un message générique basé sur status_code est envoyé.

Annotation

Les annotations peuvent être associées au corps en texte brut du message ou à des chips qui renvoient vers des ressources Google Workspace telles que Google Docs ou Sheets avec start_index et length définis sur 0. Pour ajouter une mise en forme de base à un message, consultez Mettre en forme les messages.

Exemple de corps de message en texte brut :

Hello @FooBot how are you!"

Métadonnées des annotations correspondantes :

"annotations":[{
  "type":"USER_MENTION",
  "startIndex":6,
  "length":7,
  "userMention": {
    "user": {
      "name":"users/{user}",
      "displayName":"FooBot",
      "avatarUrl":"https://goo.gl/aeDtrS",
      "type":"BOT"
    },
    "type":"MENTION"
   }
}]

Champs
type	AnnotationType Type de cette annotation.
length	int32 Longueur de la sous-chaîne dans le corps du message en texte brut à laquelle correspond cette annotation. Si elle n'est pas présente, cela indique une longueur de 0.
start_index	int32 Index de début (inclus, basé sur 0) dans le corps du message en texte brut auquel correspond cette annotation.
Champ d'union metadata. Métadonnées supplémentaires sur l'annotation. metadata ne peut être qu'un des éléments suivants :
user_mention	UserMentionMetadata Métadonnées de la mention de l'utilisateur.
slash_command	SlashCommandMetadata Métadonnées d'une commande à barre oblique.
rich_link_metadata	RichLinkMetadata Métadonnées d'un lien enrichi.
custom_emoji_metadata	CustomEmojiMetadata Métadonnées d'un emoji personnalisé.

AnnotationType

Type de l'annotation.

Enums
ANNOTATION_TYPE_UNSPECIFIED	Valeur par défaut de l'énumération. Ne pas utiliser.
USER_MENTION	Un utilisateur est mentionné.
SLASH_COMMAND	Une commande à barre oblique est appelée.
RICH_LINK	Annotation de lien enrichi.
CUSTOM_EMOJI	Annotation d'emoji personnalisé.

AppCommandMetadata

Métadonnées concernant une commande d'application Chat.

Champs
app_command_id	int32 ID de la commande spécifiée dans la configuration de l'API Chat.
app_command_type	AppCommandType Type de commande d'application Chat.

AppCommandType

Type de commande d'application Chat. Pour en savoir plus, consultez Types de commandes d'applications Chat.

Enums
APP_COMMAND_TYPE_UNSPECIFIED	Valeur par défaut. Non spécifié.
SLASH_COMMAND	Une commande à barre oblique. L'utilisateur envoie la commande dans un message Chat.
QUICK_COMMAND	Une commande rapide. L'utilisateur sélectionne la commande dans le menu Chat de la zone de réponse au message.

AttachedGif

Image GIF spécifiée par une URL.

Champs
uri	string Uniquement en sortie. URL qui héberge l'image GIF.

Pièce jointe

Pièce jointe dans Google Chat.

Champs
name	string Facultatif. Nom de ressource de la pièce jointe, au format spaces/{space}/messages/{message}/attachments/{attachment}.
content_name	string Uniquement en sortie. Nom de fichier d'origine du contenu, et non le chemin d'accès complet.
content_type	string Uniquement en sortie. Type de contenu (type MIME) du fichier.
thumbnail_uri	string Uniquement en sortie. URL de la miniature à utiliser pour prévisualiser la pièce jointe pour un utilisateur humain. Les applications de chat ne doivent pas utiliser cette URL pour télécharger le contenu des pièces jointes.
download_uri	string Uniquement en sortie. URL de téléchargement à utiliser pour permettre à un utilisateur humain de télécharger la pièce jointe. Les applications de chat ne doivent pas utiliser cette URL pour télécharger le contenu des pièces jointes.
source	Source Uniquement en sortie. Source de la pièce jointe.
Champ d'union data_ref. Référence aux données de la pièce jointe. data_ref ne peut être qu'un des éléments suivants :
attachment_data_ref	AttachmentDataRef Facultatif. Référence aux données de la pièce jointe. Ce champ permet de créer ou de modifier des messages avec des pièces jointes, ou avec l'API Media pour télécharger les données des pièces jointes.
drive_data_ref	DriveDataRef Uniquement en sortie. Référence à la pièce jointe Google Drive. Ce champ est utilisé avec l'API Google Drive.

Source

Source de la pièce jointe.

Enums
SOURCE_UNSPECIFIED	Réservé.
DRIVE_FILE	Le fichier est un fichier Google Drive.
UPLOADED_CONTENT	Le fichier est importé dans Chat.

AttachmentDataRef

Référence aux données de la pièce jointe.

Champs
resource_name	string Facultatif. Nom de ressource des données de la pièce jointe. Ce champ est utilisé avec l'API Media pour télécharger les données des pièces jointes.
attachment_upload_token	string Facultatif. Jeton opaque contenant une référence à une pièce jointe importée. Traitée par les clients comme une chaîne opaque et utilisée pour créer ou modifier des messages Chat avec des pièces jointes.

CalendarEventLinkData

Données pour les liens vers des événements Agenda.

Champs
calendar_id	string Identifiant de l'agenda associé.
event_id	string L'identifiant de l'événement de l'événement Agenda associé.

CardWithId

Une fiche dans un message Google Chat.

Seules les applications Chat peuvent créer des fiches. Si votre application Chat s'authentifie en tant qu'utilisateur, le message ne peut pas contenir de cartes.

Concevez et prévisualisez des cartes avec le générateur de cartes.

Ouvrir le générateur de cartes

Champs
card_id	string Obligatoire si le message contient plusieurs cartes. Identifiant unique d'une fiche dans un message.
card	Card Une fiche La taille maximale est de 32 Ko.

ChatSpaceLinkData

Données pour les liens vers les espaces Chat.

Champs
space	string Espace de la ressource d'espace Chat associée. Format : spaces/{space}
thread	string Fil de discussion de la ressource d'espace Chat associée. Format : spaces/{space}/threads/{thread}
message	string Message de la ressource d'espace Chat associée. Format : spaces/{space}/messages/{message}

CompleteImportSpaceRequest

Message de requête pour terminer le processus d'importation d'un espace.

Champs
name	string Obligatoire. Nom de ressource de l'espace en mode importation. Format : spaces/{space}

CompleteImportSpaceResponse

Message de réponse pour la finalisation du processus d'importation d'un espace.

Champs
space	Space Espace en mode importation.

ContextualAddOnMarkup

Ce type ne comporte aucun champ.

Balisage permettant aux développeurs de spécifier le contenu d'un module complémentaire contextuel.

Fiche

Une fiche est un élément d'interface utilisateur qui peut contenir des widgets d'UI tels que du texte et des images.

Champs
header	CardHeader En-tête de la carte. Un en-tête contient généralement un titre et une image.
sections[]	Section Les sections sont séparées par une ligne.
card_actions[]	CardAction Actions de cette carte.
name	string Nom de la carte.

CardAction

Une action de fiche est l'action associée à la fiche. Pour une fiche de facture, une action typique consiste à supprimer la facture, à l'envoyer par e-mail ou à l'ouvrir dans un navigateur.

Non disponible pour les applications Google Chat.

Champs
action_label	string Le libellé était affiché dans l'élément de menu d'action.
on_click	OnClick Action onclick pour cet élément d'action.

CardHeader

Champs
title	string Vous devez indiquer le titre. L'en-tête a une hauteur fixe : si un titre et un sous-titre sont spécifiés, chacun occupe une ligne. Si seul le titre est spécifié, il occupe les deux lignes.
subtitle	string Sous-titre de l'en-tête de la fiche.
image_style	ImageStyle Type de l'image (par exemple, bordure carrée ou circulaire).
image_url	string URL de l'image dans l'en-tête de la carte.

ImageStyle

Enums
IMAGE_STYLE_UNSPECIFIED
IMAGE	Bordure carrée.
AVATAR	Bordure circulaire.

Section

Une section contient un ensemble de widgets qui sont affichés (verticalement) dans l'ordre dans lequel ils sont spécifiés. Sur toutes les plates-formes, les cartes ont une largeur fixe étroite. Il n'est donc pas nécessaire d'utiliser des propriétés de mise en page (par exemple, float).

Champs
header	string En-tête de la section. Le texte mis en forme est accepté. Pour en savoir plus sur la mise en forme du texte, consultez Mettre en forme du texte dans les applications Google Chat et Mettre en forme du texte dans les modules complémentaires Google Workspace.
widgets[]	WidgetMarkup Une section doit contenir au moins un widget.

CreateCustomEmojiRequest

Requête permettant de créer un emoji personnalisé.

Champs
custom_emoji	CustomEmoji Obligatoire. Emoji personnalisé à créer.

CreateMembershipRequest

Message de requête pour créer un abonnement.

Champs
parent	string Obligatoire. Nom de ressource de l'espace pour lequel créer l'abonnement. Format : spaces/{space}
membership	Membership Obligatoire. Relation d'appartenance à créer. Le champ memberType doit contenir un utilisateur dont les champs user.name et user.type sont renseignés. Le serveur attribuera un nom de ressource et écrasera tout ce qui a été spécifié. Lorsqu'une application Chat crée une relation de membre pour un utilisateur humain, elle doit utiliser certains niveaux d'autorisation et définir des valeurs spécifiques pour certains champs : Lors de l'l'authentification en tant qu'utilisateur, le champ d'application de l'autorisation chat.memberships est requis. Lorsque vous vous authentifiez en tant qu'application, le champ d'application de l'autorisation chat.app.memberships est requis. Définissez user.type sur HUMAN et user.name au format users/{user}, où {user} peut être l'adresse e-mail de l'utilisateur. Pour les utilisateurs de la même organisation Workspace, {user} peut également être le id de la personne de l'API People ou le id de l'utilisateur dans l'API Directory. Par exemple, si l'ID de profil de personne de l'API People pour [e-mail] est 123456789, vous pouvez ajouter l'utilisateur à l'espace en définissant membership.member.name sur users/[e-mail] ou users/123456789. Pour inviter des utilisateurs externes à l'organisation Workspace propriétaire de l'espace, vous devez authentifier les utilisateurs. Lorsqu'une application Chat crée une relation d'appartenance pour elle-même, elle doit s'authentifier en tant qu'utilisateur et utiliser le champ d'application chat.memberships.app, définir user.type sur BOT et définir user.name sur users/app.
use_admin_access	bool Facultatif. Lorsque la valeur est true, la méthode s'exécute avec les droits d'administrateur Google Workspace de l'utilisateur. L'utilisateur qui appelle doit être un administrateur Google Workspace disposant du droit "Gérer les conversations Chat et Espaces". Nécessite le champ d'application OAuth 2.0 chat.admin.memberships. La création d'abonnements à des applications ou pour des utilisateurs en dehors de l'organisation Google Workspace de l'administrateur n'est pas possible avec l'accès administrateur.

CreateMessageRequest

Crée un message.

Champs
parent	string Obligatoire. Nom de ressource de l'espace dans lequel créer un message. Format : spaces/{space}
message	Message Obligatoire. Corps du message.
thread_key (deprecated)	string Cet élément est obsolète. Facultatif. Obsolète : utilisez plutôt thread.thread_key. ID du thread. Elle peut contenir jusqu'à 4 000 caractères. Pour démarrer ou ajouter un message à un fil de discussion, créez un message et spécifiez un threadKey ou le thread.name. Pour obtenir des exemples d'utilisation, consultez Démarrer un fil de discussion ou y répondre.
request_id	string Facultatif. ID de requête unique pour ce message. Si vous spécifiez un ID de demande existant, le message créé avec cet ID est renvoyé au lieu d'en créer un.
message_reply_option	MessageReplyOption Facultatif. Indique si un message démarre un fil de discussion ou y répond. Compatible uniquement avec les espaces nommés. Ce champ est ignoré lorsque vous répondez aux interactions utilisateur. Pour les interactions dans un fil de discussion, la réponse est créée dans le même fil. Sinon, la réponse est créée sous forme de nouveau fil de discussion.
message_id	string Facultatif. ID personnalisé d'un message. Permet aux applications Chat d'obtenir, de modifier ou de supprimer un message sans avoir à stocker l'ID attribué par le système dans le nom de ressource du message (représenté dans le champ name du message). La valeur de ce champ doit répondre aux exigences suivantes : Commence par client-. Par exemple, client-custom-name est un ID personnalisé valide, mais custom-name ne l'est pas. Contenir jusqu'à 63 caractères, et uniquement des lettres minuscules, des chiffres et des traits d'union. Il est unique dans un espace. Une application Chat ne peut pas utiliser le même ID personnalisé pour différents messages. Pour en savoir plus, consultez Nommer un message.

MessageReplyOption

Spécifie comment répondre à un message. D'autres États pourront être ajoutés à l'avenir.

Enums
MESSAGE_REPLY_OPTION_UNSPECIFIED	Par défaut. Démarre un nouveau thread. Si vous choisissez cette option, les thread ID ou thread_key inclus seront ignorés.
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD	Crée le message en réponse au fil de discussion spécifié par thread ID ou thread_key. Si l'opération échoue, le message lance un nouveau fil de discussion.
REPLY_MESSAGE_OR_FAIL	Crée le message en réponse au fil de discussion spécifié par thread ID ou thread_key. Si un nouveau thread_key est utilisé, un fil de discussion est créé. Si la création du message échoue, une erreur NOT_FOUND est renvoyée.

CreateReactionRequest

Crée une réaction à un message.

Champs
parent	string Obligatoire. Message dans lequel la réaction est créée. Format : spaces/{space}/messages/{message}
reaction	Reaction Obligatoire. Réaction à créer.

CreateSpaceRequest

Demande de création d'un espace nommé sans membres.

Champs
space	Space Obligatoire. Les champs displayName et spaceType doivent être renseignés. Seuls SpaceType.SPACE et SpaceType.GROUP_CHAT sont acceptés. SpaceType.GROUP_CHAT ne peut être utilisé que si importMode est défini sur "true". Si le message d'erreur ALREADY_EXISTS s'affiche, essayez un autre displayName. Il est possible qu'un espace existant dans l'organisation Google Workspace utilise déjà ce nom à afficher. L'espace name est attribué sur le serveur. Par conséquent, tout ce qui est spécifié dans ce champ sera ignoré.
request_id	string Facultatif. Identifiant unique de cette demande. Nous vous recommandons d'utiliser un UUID aléatoire. Si vous spécifiez un ID de requête existant, l'espace créé avec cet ID est renvoyé au lieu d'un nouvel espace. Si vous spécifiez un ID de demande existant provenant de la même application Chat avec un utilisateur authentifié différent, une erreur est renvoyée.

CustomEmoji

Représente un emoji personnalisé.

Champs
name	string Identifiant. Nom de ressource de l'emoji personnalisé, attribué par le serveur. Format : customEmojis/{customEmoji}
uid	string Uniquement en sortie. Clé unique de la ressource d'emoji personnalisé.
emoji_name	string Facultatif. Immuable. Nom fourni par l'utilisateur pour l'emoji personnalisé, qui est unique au sein de l'organisation. Obligatoire lors de la création de l'emoji personnalisé, en sortie uniquement dans le cas contraire. Les noms d'emoji doivent commencer et se terminer par un deux-points, être en minuscules et ne contenir que des caractères alphanumériques, des traits d'union et des traits de soulignement. Les traits d'union et les traits de soulignement servent à séparer les mots et ne peuvent pas être utilisés de manière consécutive. Exemple : :valid-emoji-name:
temporary_image_uri	string Uniquement en sortie. URL temporaire de l'image de l'emoji personnalisé, valide pendant au moins 10 minutes. Notez que cette valeur n'est pas renseignée dans la réponse lorsque l'emoji personnalisé est créé.
payload	CustomEmojiPayload Facultatif. Uniquement en entrée. Données de charge utile. Obligatoire lors de la création de l'emoji personnalisé.

CustomEmojiPayload

Données de charge utile pour l'emoji personnalisé.

Champs
file_content	bytes Obligatoire. Uniquement en entrée. Image utilisée pour l'emoji personnalisé. La charge utile doit être inférieure à 256 ko, et la dimension de l'image doit être carrée et comprise entre 64 et 500 pixels. Ces restrictions sont susceptibles d'être modifiées.
filename	string Obligatoire. Uniquement en entrée. Nom du fichier image. Extensions de fichier acceptées : .png, .jpg, .gif.

CustomEmojiMetadata

Métadonnées d'annotation pour les emoji personnalisés.

Champs
custom_emoji	CustomEmoji Emoji personnalisé.

DeleteCustomEmojiRequest

Demande de suppression d'un emoji personnalisé.

Champs
name	string Obligatoire. Nom de ressource de l'emoji personnalisé à supprimer. Format : customEmojis/{customEmoji} Vous pouvez utiliser le nom de l'emoji comme alias pour {customEmoji}. Par exemple, customEmojis/:example-emoji: où :example-emoji: est le nom d'un emoji personnalisé.

DeleteMembershipRequest

Demande de suppression d'un membre dans un espace.

Champs
name	string Obligatoire. Nom de ressource de l'abonnement à supprimer. Les applications de chat peuvent supprimer les abonnements des utilisateurs humains ou les leurs. Les applications de chat ne peuvent pas supprimer les abonnements d'autres applications. Lorsque vous supprimez un membre humain, vous devez utiliser le champ d'application chat.memberships avec l'authentification de l'utilisateur ou le champ d'application chat.memberships.app avec l'authentification de l'application et le format spaces/{space}/members/{member}. Vous pouvez utiliser l'adresse e-mail comme alias pour {member}. Par exemple, spaces/{space}/members/[e-mail] où [e-mail] est l'adresse e-mail de l'utilisateur Google Chat. Lors de la suppression d'une appartenance à une application, les formats chat.memberships.app et spaces/{space}/members/app sont requis. Format : spaces/{space}/members/{member} ou spaces/{space}/members/app.
use_admin_access	bool Facultatif. Lorsque la valeur est true, la méthode s'exécute avec les droits d'administrateur Google Workspace de l'utilisateur. L'utilisateur qui appelle doit être un administrateur Google Workspace disposant du droit "Gérer les conversations Chat et Espaces". Nécessite le champ d'application OAuth 2.0 chat.admin.memberships. Il n'est pas possible de supprimer les abonnements aux applications dans un espace avec un accès administrateur.

DeleteMessageRequest

Demande de suppression d'un message.

Champs
name	string Obligatoire. Nom de ressource du message. Format : spaces/{space}/messages/{message} Si vous avez défini un ID personnalisé pour votre message, vous pouvez utiliser la valeur du champ clientAssignedMessageId pour {message}. Pour en savoir plus, consultez Nommer un message.
force	bool Facultatif. Lorsque true, la suppression d'un message entraîne également la suppression des réponses associées. Lorsque false, si un message comporte des réponses groupées, la suppression échoue. Ne s'applique que lorsque vous vous authentifiez en tant qu'utilisateur. N'a aucun effet lors de l'authentification en tant qu'application Chat.

DeleteReactionRequest

Supprime une réaction à un message.

Champs
name	string Obligatoire. Nom de la réaction à supprimer. Format : spaces/{space}/messages/{message}/reactions/{reaction}

DeleteSpaceRequest

Demande de suppression d'un espace.

Champs
name	string Obligatoire. Nom de ressource de l'espace à supprimer. Format : spaces/{space}
use_admin_access	bool Facultatif. Lorsque la valeur est true, la méthode s'exécute avec les droits d'administrateur Google Workspace de l'utilisateur. L'utilisateur qui appelle doit être un administrateur Google Workspace disposant du droit "Gérer les conversations Chat et Espaces". Nécessite le champ d'application OAuth 2.0 chat.admin.delete.

DeletionMetadata

Informations sur un message supprimé. Un message est supprimé lorsque delete_time est défini.

Champs
deletion_type	DeletionType Indique qui a supprimé le message.

DeletionType

Qui a supprimé le message et comment il a été supprimé D'autres valeurs pourront être ajoutées à l'avenir. Pour savoir quand les messages peuvent être supprimés, consultez Modifier ou supprimer un message dans Google Chat.

Enums
DELETION_TYPE_UNSPECIFIED	Cette valeur n'est pas utilisée.
CREATOR	L'utilisateur a supprimé son propre message.
SPACE_OWNER	Un gestionnaire de l'espace a supprimé le message.
ADMIN	Un administrateur Google Workspace a supprimé le message. Les administrateurs peuvent supprimer n'importe quel message de l'espace, y compris ceux envoyés par un membre de l'espace ou par l'application Chat.
APP_MESSAGE_EXPIRY	Une application Chat a supprimé son propre message à son expiration.
CREATOR_VIA_APP	Une application Chat a supprimé le message au nom de son créateur (à l'aide de l'authentification de l'utilisateur).
SPACE_OWNER_VIA_APP	Une application Chat a supprimé le message au nom d'un gestionnaire de l'espace (à l'aide de l'authentification de l'utilisateur).
SPACE_MEMBER	Un membre de l'espace a supprimé le message. Les utilisateurs peuvent supprimer les messages envoyés par les applications.

Dialog

Wrapper autour du corps de la fiche de la boîte de dialogue.

Champs
body	Card Uniquement en entrée. Corps de la boîte de dialogue, affiché dans un modal. Les applications Google Chat ne sont pas compatibles avec les entités de carte suivantes : DateTimePicker, OnChangeAction.

DialogAction

Contient un dialogue et un code d'état de la requête.

Champs
action_status	ActionStatus Uniquement en entrée. État d'une requête permettant d'appeler ou d'envoyer un dialogue. Affiche un état et un message aux utilisateurs, si nécessaire. Par exemple, en cas d'erreur ou de réussite.
Champ d'union action. Action à effectuer. action ne peut être qu'un des éléments suivants :
dialog	Dialog Uniquement en entrée. Boîte de dialogue pour la requête.

DriveDataRef

Référence aux données d'une pièce jointe Drive.

Champs
drive_file_id	string ID du fichier Drive. Utilisez-le avec l'API Drive.

DriveLinkData

Données pour les liens Google Drive.

Champs
drive_data_ref	DriveDataRef Un DriveDataRef qui fait référence à un fichier Google Drive.
mime_type	string Type MIME de la ressource Google Drive associée.

Emoji

Emoji utilisé comme réaction à un message.

Champs
Champ d'union content. Obligatoire. Contenu de l'emoji. content ne peut être qu'un des éléments suivants :
unicode	string Facultatif. Emoji de base représenté par une chaîne Unicode.
custom_emoji	CustomEmoji Un emoji personnalisé.

EmojiReactionSummary

Nombre de personnes ayant réagi à un message avec un emoji spécifique.

Champs
emoji	Emoji Uniquement en sortie. Emoji associé aux réactions.
reaction_count	int32 Uniquement en sortie. Nombre total de réactions utilisant l'emoji associé.

FindDirectMessageRequest

Requête permettant d'obtenir un espace de messages privés en fonction de la ressource utilisateur.

Champs

name

string Obligatoire. Nom de ressource de l'utilisateur avec lequel rechercher un message privé. Format : users/{user}, où {user} correspond au id de la personne dans l'API People ou au id de l'utilisateur dans l'API Directory. Par exemple, si l'ID de profil de l'API People est 123456789, vous pouvez trouver un message privé avec cette personne en utilisant users/123456789 comme name. Lorsque vous êtes authentifié en tant qu'utilisateur, vous pouvez utiliser l'adresse e-mail comme alias pour {user}. Par exemple, users/[e-mail] où [e-mail] est l'adresse e-mail de l'utilisateur Google Chat.

GetAttachmentRequest

Requête d'obtention d'une pièce jointe.

Champs
name	string Obligatoire. Nom de ressource de la pièce jointe, au format spaces/{space}/messages/{message}/attachments/{attachment}.

GetCustomEmojiRequest

Requête permettant de renvoyer un seul emoji personnalisé.

Champs
name	string Obligatoire. Nom de ressource de l'emoji personnalisé. Format : customEmojis/{customEmoji} Vous pouvez utiliser le nom de l'emoji comme alias pour {customEmoji}. Par exemple, customEmojis/:example-emoji: où :example-emoji: est le nom d'un emoji personnalisé.

GetMembershipRequest

Requête permettant d'obtenir l'adhésion à un espace.

Champs
name	string Obligatoire. Nom de ressource de l'abonnement à récupérer. Pour obtenir l'abonnement de l'application à l'aide de l'authentification de l'utilisateur, vous pouvez éventuellement utiliser spaces/{space}/members/app. Format : spaces/{space}/members/{member} ou spaces/{space}/members/app Vous pouvez utiliser l'adresse e-mail de l'utilisateur comme alias pour {member}. Par exemple, spaces/{space}/members/[e-mail] où [e-mail] est l'adresse e-mail de l'utilisateur Google Chat.
use_admin_access	bool Facultatif. Lorsque la valeur est true, la méthode s'exécute avec les droits d'administrateur Google Workspace de l'utilisateur. L'utilisateur qui appelle doit être un administrateur Google Workspace disposant du droit "Gérer les conversations Chat et Espaces". Nécessite les champs d'application OAuth 2.0 chat.admin.memberships ou chat.admin.memberships.readonly. Il n'est pas possible de souscrire des abonnements à des applications dans un espace lorsque vous utilisez un accès administrateur.

GetMessageRequest

Requête permettant d'obtenir un message.

Champs
name	string Obligatoire. Nom de ressource du message. Format : spaces/{space}/messages/{message} Si vous avez défini un ID personnalisé pour votre message, vous pouvez utiliser la valeur du champ clientAssignedMessageId pour {message}. Pour en savoir plus, consultez Nommer un message.

GetSpaceEventRequest

Message de requête pour obtenir un événement d'espace.

Champs
name	string Obligatoire. Nom de ressource de l'événement d'espace. Format : spaces/{space}/spaceEvents/{spaceEvent}

GetSpaceNotificationSettingRequest

Message de requête pour obtenir le paramètre de notification d'un espace. Ne permet d'obtenir les paramètres de notification que pour l'utilisateur appelant.

Champs
name	string Obligatoire. Format : users/{user}/spaces/{space}/spaceNotificationSetting users/me/spaces/{space}/spaceNotificationSetting, OU users/[e-mail]/spaces/{space}/spaceNotificationSetting, OU users/123456789/spaces/{space}/spaceNotificationSetting. Remarque : Seuls l'ID utilisateur ou l'adresse e-mail de l'appelant sont autorisés dans le chemin d'accès.

GetSpaceReadStateRequest

Message de requête pour l'API GetSpaceReadState.

Champs

name

string Obligatoire. Nom de ressource de l'état de lecture de l'espace à récupérer. Ne permet d'obtenir l'état de lecture que pour l'utilisateur appelant. Pour faire référence à l'utilisateur appelant, définissez l'une des valeurs suivantes : Alias me. Exemple :users/me/spaces/{space}/spaceReadState Son adresse e-mail Workspace Par exemple, users/[e-mail]/spaces/{space}/spaceReadState. Son ID utilisateur. Par exemple, users/123456789/spaces/{space}/spaceReadState. Format : users/{user}/spaces/{space}/spaceReadState

GetSpaceRequest

Requête permettant de renvoyer un seul espace.

Champs
name	string Obligatoire. Nom de ressource de l'espace, au format spaces/{space}. Format : spaces/{space}
use_admin_access	bool Facultatif. Lorsque la valeur est true, la méthode s'exécute avec les droits d'administrateur Google Workspace de l'utilisateur. L'utilisateur qui appelle doit être un administrateur Google Workspace disposant du droit "Gérer les conversations Chat et Espaces". Nécessite les champs d'application OAuth 2.0 chat.admin.spaces ou chat.admin.spaces.readonly.

GetThreadReadStateRequest

Message de requête pour l'API GetThreadReadStateRequest.

Champs

name

string Obligatoire. Nom de ressource de l'état de lecture du thread à récupérer. Ne permet d'obtenir l'état de lecture que pour l'utilisateur appelant. Pour faire référence à l'utilisateur appelant, définissez l'une des valeurs suivantes : Alias me. Exemple :users/me/spaces/{space}/threads/{thread}/threadReadState Son adresse e-mail Workspace Par exemple, users/[e-mail]/spaces/{space}/threads/{thread}/threadReadState. Son ID utilisateur. Par exemple, users/123456789/spaces/{space}/threads/{thread}/threadReadState. Format : users/{user}/spaces/{space}/threads/{thread}/threadReadState

Groupe

Un groupe Google dans Google Chat.

Champs
name	string Nom de ressource d'un groupe Google. Représente un groupe dans l'API Cloud Identity Groups. Format : groups/{group}

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	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 spécifient la durée de conservation des messages et des fils de discussion.

ListCustomEmojisRequest

Requête permettant de renvoyer une liste d'emojis personnalisés.

Champs
page_size	int32 Facultatif. Nombre maximal d'emojis personnalisés renvoyés. Le service peut renvoyer un nombre d'emojis personnalisés inférieur à cette valeur. Si aucune valeur n'est spécifiée, la valeur par défaut est 25. La valeur maximale est 200. Les valeurs supérieures sont remplacées par 200.
page_token	string Facultatif. (Si vous reprenez une requête précédente.) Jeton de page reçu d'un appel de liste d'emojis personnalisés précédent. Fournissez-le pour récupérer la page suivante. Lors de la pagination, la valeur du filtre doit correspondre à l'appel ayant fourni le jeton de page. Si vous transmettez une autre valeur, vous risquez d'obtenir des résultats inattendus.
filter	string Facultatif. Filtre de requête. Permet de filtrer les résultats par créateur. Pour filtrer par créateur, vous devez spécifier une valeur valide. Actuellement, seuls creator("users/me") et NOT creator("users/me") sont acceptés pour filtrer les emoji personnalisés selon qu'ils ont été créés ou non par l'utilisateur qui appelle. Par exemple, la requête suivante renvoie les emoji personnalisés créés par l'appelant : creator("users/me") Les requêtes non valides sont rejetées avec une erreur INVALID_ARGUMENT.

ListCustomEmojisResponse

Réponse permettant de lister les emoji personnalisés.

Champs
custom_emojis[]	CustomEmoji Liste à puces. Liste des emoji personnalisés.
next_page_token	string Jeton pouvant être envoyé en tant que pageToken pour récupérer la page de résultats suivante. Si ce champ est vide, il n'y a pas d'autres pages.

ListMembershipsRequest

Message de requête pour lister les souscriptions.

Champs
parent	string Obligatoire. Nom de ressource de l'espace pour lequel extraire une liste de membres. Format : spaces/{space}
page_size	int32 Facultatif. Nombre maximal de membres à afficher. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 100 souscriptions au maximum sont renvoyées. La valeur maximale est de 1 000. Si vous utilisez une valeur supérieure à 1 000, elle est automatiquement remplacée par 1 000. Les valeurs négatives renvoient une erreur INVALID_ARGUMENT.
page_token	string Facultatif. Jeton de page reçu d'un appel précédent pour lister les abonnements. Fournissez ce paramètre pour récupérer la page suivante. Lors de la pagination, tous les autres paramètres fournis doivent correspondre à l'appel ayant fourni le jeton de page. Si vous transmettez des valeurs différentes aux autres paramètres, vous risquez d'obtenir des résultats inattendus.
filter	string Facultatif. Filtre de requête. Vous pouvez filtrer les membres par rôle (role) et par type (member.type). Pour filtrer par rôle, définissez role sur ROLE_MEMBER ou ROLE_MANAGER. Pour filtrer par type, définissez member.type sur HUMAN ou BOT. Vous pouvez également filtrer member.type à l'aide de l'opérateur !=. Pour filtrer à la fois par rôle et par type, utilisez l'opérateur AND. Pour filtrer par rôle ou par type, utilisez l'opérateur OR. member.type = "HUMAN" ou member.type != "BOT" est obligatoire lorsque use_admin_access est défini sur "true". Les autres filtres de type de membre seront refusés. Par exemple, les requêtes suivantes sont valides : role = "ROLE_MANAGER" OR role = "ROLE_MEMBER" member.type = "HUMAN" AND role = "ROLE_MANAGER" member.type != "BOT" Les requêtes suivantes ne sont pas valides : member.type = "HUMAN" AND member.type = "BOT" role = "ROLE_MANAGER" AND role = "ROLE_MEMBER" Les requêtes non valides sont rejetées par le serveur avec une erreur INVALID_ARGUMENT.
show_groups	bool Facultatif. Lorsque true, renvoie également les souscriptions associées à un Google Group, en plus des autres types de souscriptions. Si une filter est définie, les abonnements Google Group qui ne correspondent pas aux critères de filtre ne sont pas renvoyés.
show_invited	bool Facultatif. Lorsque la valeur est true, renvoie également les souscriptions associées aux membres invited, en plus des autres types de souscriptions. Si un filtre est défini, les abonnements invited qui ne correspondent pas aux critères du filtre ne sont pas renvoyés. Nécessite actuellement une authentification de l'utilisateur.
use_admin_access	bool Facultatif. Lorsque la valeur est true, la méthode s'exécute avec les droits d'administrateur Google Workspace de l'utilisateur. L'utilisateur qui appelle doit être un administrateur Google Workspace disposant du droit "Gérer les conversations Chat et Espaces". Nécessite le champ d'application OAuth 2.0 chat.admin.memberships.readonly ou chat.admin.memberships. Il n'est pas possible de lister les abonnements aux applications dans un espace lorsque vous utilisez l'accès administrateur.

ListMembershipsResponse

Réponse à la liste des membres de l'espace.

Champs
memberships[]	Membership Liste à puces. Liste des abonnements sur la page demandée (ou la première page).
next_page_token	string Jeton pouvant être envoyé en tant que pageToken pour récupérer la page de résultats suivante. Si ce champ est vide, il n'y a pas d'autres pages.

ListMessagesRequest

Liste les messages de l'espace spécifié dont l'utilisateur est membre.

Champs
parent	string Obligatoire. Nom de ressource de l'espace à partir duquel lister les messages. Format : spaces/{space}
page_size	int32 Facultatif. Nombre maximal de messages renvoyés. Le service peut renvoyer un nombre de messages inférieur à cette valeur. Si aucune valeur n'est spécifiée, 25 résultats au maximum sont renvoyés. La valeur maximale est de 1 000. Si vous utilisez une valeur supérieure à 1 000, elle est automatiquement remplacée par 1 000. Les valeurs négatives renvoient une erreur INVALID_ARGUMENT.
page_token	string Facultatif. Jeton de page reçu lors d'un appel de liste des messages précédent. Fournissez ce paramètre pour récupérer la page suivante. Lors de la pagination, tous les autres paramètres fournis doivent correspondre à l'appel ayant fourni le jeton de page. Si vous transmettez des valeurs différentes aux autres paramètres, vous risquez d'obtenir des résultats inattendus.
filter	string Facultatif. Filtre de requête. Vous pouvez filtrer les messages par date (create_time) et par fil de discussion (thread.name). Pour filtrer les messages par date de création, spécifiez create_time avec un code temporel au format RFC-3339 et des guillemets doubles. Par exemple, "2023-04-21T11:30:00-04:00". Vous pouvez utiliser l'opérateur supérieur à > pour lister les messages créés après un code temporel, ou l'opérateur inférieur à < pour lister les messages créés avant un code temporel. Pour filtrer les messages dans un intervalle de temps, utilisez l'opérateur AND entre deux codes temporels. Pour filtrer par thread, spécifiez le thread.name au format spaces/{space}/threads/{thread}. Vous ne pouvez spécifier qu'un seul thread.name par requête. Pour filtrer à la fois par fil de discussion et par date, utilisez l'opérateur AND dans votre requête. Par exemple, les requêtes suivantes sont valides : create_time > "2012-04-21T11:30:00-04:00" create_time > "2012-04-21T11:30:00-04:00" AND thread.name = spaces/AAAAAAAAAAA/threads/123 create_time > "2012-04-21T11:30:00+00:00" AND create_time < "2013-01-01T00:00:00+00:00" AND thread.name = spaces/AAAAAAAAAAA/threads/123 thread.name = spaces/AAAAAAAAAAA/threads/123 Les requêtes non valides sont rejetées par le serveur avec une erreur INVALID_ARGUMENT.
order_by	string Facultatif. Ordre de la liste des messages. Spécifiez une valeur pour trier selon une opération de tri. Les valeurs d'opération de tri valides sont les suivantes : ASC pour l'ordre croissant. DESC pour l'ordre décroissant. L'ordre par défaut est create_time ASC.
show_deleted	bool Facultatif. Indique si les messages supprimés doivent être inclus. Les messages supprimés incluent l'heure de suppression et les métadonnées associées, mais le contenu des messages n'est pas disponible.

ListMessagesResponse

Message de réponse pour la liste des messages.

Champs
messages[]	Message Liste des messages.
next_page_token	string Vous pouvez envoyer un jeton en tant que pageToken pour récupérer la page de résultats suivante. Si ce champ est vide, il n'y a pas d'autres pages.

ListReactionsRequest

Liste les réactions à un message.

Champs
parent	string Obligatoire. Message auquel les utilisateurs ont réagi. Format : spaces/{space}/messages/{message}
page_size	int32 Facultatif. Nombre maximal de réactions renvoyées. Le service peut renvoyer un nombre de réactions inférieur à cette valeur. Si aucune valeur n'est spécifiée, la valeur par défaut est 25. La valeur maximale est 200. Les valeurs supérieures sont remplacées par 200.
page_token	string Facultatif. (Si vous reprenez une requête précédente.) Jeton de page reçu lors d'un appel de liste des réactions précédent. Fournissez-le pour récupérer la page suivante. Lors de la pagination, la valeur du filtre doit correspondre à l'appel ayant fourni le jeton de page. Si vous transmettez une autre valeur, vous risquez d'obtenir des résultats inattendus.
filter	string Facultatif. Filtre de requête. Vous pouvez filtrer les réactions par emoji (emoji.unicode ou emoji.custom_emoji.uid) et par utilisateur (user.name). Pour filtrer les réactions pour plusieurs emoji ou utilisateurs, joignez des champs similaires avec l'opérateur OR, comme emoji.unicode = "🙂" OR emoji.unicode = "👍" et user.name = "users/AAAAAA" OR user.name = "users/BBBBBB". Pour filtrer les réactions par emoji et par utilisateur, utilisez l'opérateur AND, par exemple emoji.unicode = "🙂" AND user.name = "users/AAAAAA". Si votre requête utilise à la fois AND et OR, regroupez-les avec des parenthèses. Par exemple, les requêtes suivantes sont valides : user.name = "users/{user}" emoji.unicode = "🙂" emoji.custom_emoji.uid = "{uid}" emoji.unicode = "🙂" OR emoji.unicode = "👍" emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}" emoji.unicode = "🙂" AND user.name = "users/{user}" (emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}") AND user.name = "users/{user}" Les requêtes suivantes ne sont pas valides : emoji.unicode = "🙂" AND emoji.unicode = "👍" emoji.unicode = "🙂" AND emoji.custom_emoji.uid = "{uid}" emoji.unicode = "🙂" OR user.name = "users/{user}" emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}" OR user.name = "users/{user}" emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}" AND user.name = "users/{user}" Les requêtes non valides sont rejetées avec une erreur INVALID_ARGUMENT.

ListReactionsResponse

Réponse à une requête de liste des réactions.

Champs
reactions[]	Reaction Liste des réactions sur la page demandée (ou la première page).
next_page_token	string Jeton de continuation permettant de récupérer la page de résultats suivante. Il est vide pour la dernière page de résultats.

ListSpaceEventsRequest

Message de requête pour lister les événements spatiaux.

Champs
parent	string Obligatoire. Nom de ressource de l'espace Google Chat où les événements se sont produits. Format : spaces/{space}.
page_size	int32 Facultatif. Nombre maximal d'événements d'espace renvoyés. Le service peut renvoyer un nombre inférieur à cette valeur. Les valeurs négatives renvoient une erreur INVALID_ARGUMENT.
page_token	string Facultatif. Jeton de page reçu d'un appel de liste des événements d'espace précédent. Fournissez-le pour récupérer la page suivante. Lors de la pagination, tous les autres paramètres fournis à la liste des événements d'espace doivent correspondre à l'appel ayant fourni le jeton de page. Si vous transmettez des valeurs différentes aux autres paramètres, vous risquez d'obtenir des résultats inattendus.
filter	string Obligatoire. Filtre de requête. Vous devez spécifier au moins un type d'événement (event_type) à l'aide de l'opérateur :. Pour filtrer les données par plusieurs types d'événements, utilisez l'opérateur OR. Omettez les types d'événements par lot dans votre filtre. La requête renvoie automatiquement tous les événements de lot associés. Par exemple, si vous filtrez par nouvelles réactions (google.workspace.chat.reaction.v1.created), le serveur renvoie également des événements de nouvelles réactions par lot (google.workspace.chat.reaction.v1.batchCreated). Pour obtenir la liste des types d'événements acceptés, consultez la documentation de référence SpaceEvents. Vous pouvez également filtrer par heure de début (start_time) et heure de fin (end_time) : start_time : horodatage exclusif à partir duquel commencer à lister les événements de l'espace. Vous pouvez lister les événements survenus jusqu'à 28 jours auparavant. Si aucune date n'est spécifiée, la commande liste les événements liés à l'espace au cours des 28 derniers jours. end_time : horodatage inclusif jusqu'auquel les événements de l'espace sont listés. Si aucune valeur n'est spécifiée, la liste des événements s'arrête à l'heure de la requête. Pour spécifier une heure de début ou de fin, utilisez l'opérateur égal à = et le format RFC-3339. Pour filtrer par start_time et end_time, utilisez l'opérateur AND. Par exemple, les requêtes suivantes sont valides : start_time="2023-08-23T19:20:33+00:00" AND end_time="2023-08-23T19:21:54+00:00" start_time="2023-08-23T19:20:33+00:00" AND (event_types:"google.workspace.chat.space.v1.updated" OR event_types:"google.workspace.chat.message.v1.created") Les requêtes suivantes ne sont pas valides : start_time="2023-08-23T19:20:33+00:00" OR end_time="2023-08-23T19:21:54+00:00" event_types:"google.workspace.chat.space.v1.updated" AND event_types:"google.workspace.chat.message.v1.created" Les requêtes non valides sont rejetées par le serveur avec une erreur INVALID_ARGUMENT.

ListSpaceEventsResponse

Message de réponse pour la liste des événements d'un espace.

Champs
space_events[]	SpaceEvent Les résultats sont renvoyés par ordre chronologique (l'événement le plus ancien en premier). Remarque : Le champ permissionSettings n'est pas renvoyé dans l'objet Space pour les requêtes de liste.
next_page_token	string Jeton de continuation utilisé pour récupérer d'autres événements. Si ce champ est omis, il n'y a pas d'autres pages.

ListSpacesRequest

Requête permettant de lister les espaces dont l'appelant est membre.

Champs
page_size	int32 Facultatif. Nombre maximal d'espaces à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 100 espaces au maximum sont renvoyés. La valeur maximale est de 1 000. Si vous utilisez une valeur supérieure à 1 000, elle est automatiquement remplacée par 1 000. Les valeurs négatives renvoient une erreur INVALID_ARGUMENT.
page_token	string Facultatif. Jeton de page reçu d'un appel list spaces précédent. Fournissez ce paramètre pour récupérer la page suivante. Lors de la pagination, la valeur du filtre doit correspondre à l'appel ayant fourni le jeton de page. Si vous transmettez une autre valeur, vous risquez d'obtenir des résultats inattendus.
filter	string Facultatif. Filtre de requête. Vous pouvez filtrer les espaces par type (space_type). Pour filtrer par type d'espace, vous devez spécifier une valeur enum valide, telle que SPACE ou GROUP_CHAT (space_type ne peut pas être SPACE_TYPE_UNSPECIFIED). Pour interroger plusieurs types d'espaces, utilisez l'opérateur OR. Par exemple, les requêtes suivantes sont valides : space_type = "SPACE" spaceType = "GROUP_CHAT" OR spaceType = "DIRECT_MESSAGE" Les requêtes non valides sont rejetées par le serveur avec une erreur INVALID_ARGUMENT.

ListSpacesResponse

Réponse à une requête de liste des espaces.

Champs
spaces[]	Space Liste des espaces sur la page demandée (ou la première page). Remarque : Le champ permissionSettings n'est pas renvoyé dans l'objet Space pour les requêtes de liste.
next_page_token	string Vous pouvez envoyer un jeton en tant que pageToken pour récupérer la page de résultats suivante. Si ce champ est vide, il n'y a pas d'autres pages.

MatchedUrl

URL correspondante dans un message Chat. Les applications Chat peuvent prévisualiser les URL correspondantes. Pour en savoir plus, consultez Prévisualiser les liens.

Champs
url	string Uniquement en sortie. URL correspondante.

MeetSpaceLinkData

Données pour les liens vers les espaces Meet.

Champs
meeting_code	string Code de réunion de l'espace Meet associé.
type	Type Indique le type d'espace Meet.
huddle_status	HuddleStatus Facultatif. Uniquement en sortie. Si la réunion Meet est un espace de discussion, indique l'état de l'espace. Sinon, cette valeur n'est pas définie.

HuddleStatus

État du groupe

Enums
HUDDLE_STATUS_UNSPECIFIED	Valeur par défaut de l'énumération. Ne pas utiliser.
STARTED	L'appel d'équipe a commencé.
ENDED	L'appel d'équipe est terminé. Dans ce cas, l'URI et les identifiants de l'espace Meet ne seront plus valides.
MISSED	Vous avez manqué l'appel d'équipe. Dans ce cas, l'URI et les identifiants de l'espace Meet ne seront plus valides.

Type

Type d'espace Meet.

Enums
TYPE_UNSPECIFIED	Valeur par défaut de l'énumération. Ne pas utiliser.
MEETING	L'espace Meet est une réunion.
HUDDLE	L'espace Meet est un espace de discussion.

Abonnement

Représente une relation d'appartenance dans Google Chat, par exemple si un utilisateur ou une application Chat est invité à un espace, en fait partie ou en est absent.

Champs
name	string Identifiant. Nom de ressource de l'abonnement, attribué par le serveur. Format : spaces/{space}/members/{member}
state	MembershipState Uniquement en sortie. État de l'abonnement.
role	MembershipRole Facultatif. Rôle de l'utilisateur dans un espace Chat, qui détermine les actions qu'il est autorisé à effectuer dans l'espace. Ce champ ne peut être utilisé comme entrée que dans UpdateMembership.
create_time	Timestamp Facultatif. Immuable. Date de création de l'abonnement, par exemple la date à laquelle un membre a rejoint un espace ou y a été invité. Ce champ est en sortie seule, sauf lorsqu'il est utilisé pour importer des adhésions historiques dans des espaces en mode importation.
delete_time	Timestamp Facultatif. Immuable. Heure de suppression de l'appartenance, par exemple lorsqu'un membre a quitté ou a été exclu d'un espace. Ce champ est en sortie seule, sauf lorsqu'il est utilisé pour importer des adhésions historiques dans des espaces en mode importation.
Champ d'union memberType. Membre associé à cet abonnement. D'autres types de membres pourront être acceptés à l'avenir. memberType ne peut être qu'un des éléments suivants :
member	User Facultatif. Utilisateur ou application Google Chat auxquels correspond l'abonnement. Si votre application Chat s'authentifie en tant qu'utilisateur, la sortie renseigne les champs user name et type.
group_member	Group Facultatif. Le groupe Google auquel l'adhésion correspond. La lecture ou la modification des appartenances à des groupes Google Groupes nécessitent l'authentification de l'utilisateur.

MembershipRole

Représente les actions autorisées d'un utilisateur dans un espace Chat. D'autres valeurs d'énumération pourront être ajoutées à l'avenir.

Enums
MEMBERSHIP_ROLE_UNSPECIFIED	Valeur par défaut. Pour users : il n'est pas membre de l'espace, mais peut être invité. Pour Google Groups : ce rôle leur est toujours attribué (d'autres valeurs d'énumération pourront être utilisées à l'avenir).
ROLE_MEMBER	Membre de l'espace. L'utilisateur dispose d'autorisations de base, comme l'envoi de messages dans l'espace. Dans les conversations privées et de groupe sans nom, tous les participants ont ce rôle.
ROLE_MANAGER	un gestionnaire de l'espace ; L'utilisateur dispose de toutes les autorisations de base, ainsi que d'autorisations administratives lui permettant de gérer l'espace, par exemple en ajoutant ou en supprimant des membres. Compatible uniquement avec SpaceType.SPACE.

MembershipState

Spécifie la relation du membre avec un espace. D'autres états de membre pourront être pris en charge à l'avenir.

Enums
MEMBERSHIP_STATE_UNSPECIFIED	Valeur par défaut. Ne pas utiliser.
JOINED	L'utilisateur est ajouté à l'espace et peut y participer.
INVITED	L'utilisateur a été invité à rejoindre l'espace, mais ne l'a pas encore fait.
NOT_A_MEMBER	L'utilisateur n'appartient pas à l'espace et n'a pas d'invitation en attente pour le rejoindre.

MembershipBatchCreatedEventData

Charge utile d'événement pour plusieurs nouvelles souscriptions.

Type d'événement : google.workspace.chat.membership.v1.batchCreated

Champs
memberships[]	MembershipCreatedEventData Liste des nouvelles souscriptions.

MembershipBatchDeletedEventData

Charge utile de l'événement pour plusieurs abonnements supprimés.

Type d'événement : google.workspace.chat.membership.v1.batchDeleted

Champs
memberships[]	MembershipDeletedEventData Liste des souscriptions supprimées.

MembershipBatchUpdatedEventData

Charge utile d'événement pour plusieurs abonnements modifiés.

Type d'événement : google.workspace.chat.membership.v1.batchUpdated

Champs
memberships[]	MembershipUpdatedEventData Liste des abonnements modifiés.

MembershipCreatedEventData

Charge utile de l'événement pour un nouvel abonnement.

Type d'événement : google.workspace.chat.membership.v1.created.

Champs
membership	Membership Le nouvel abonnement.

MembershipDeletedEventData

Charge utile d'événement pour une adhésion supprimée.

Type d'événement : google.workspace.chat.membership.v1.deleted

Champs
membership	Membership Abonnement supprimé. Seuls les champs name et state sont renseignés.

MembershipUpdatedEventData

Charge utile d'événement pour un abonnement modifié.

Type d'événement : google.workspace.chat.membership.v1.updated

Champs
membership	Membership L'appartenance mise à jour.

Message

Message dans un espace Google Chat.

Champs
name	string Identifiant. Nom de ressource du message. Format : spaces/{space}/messages/{message} Où {space} correspond à l'ID de l'espace dans lequel le message est publié et {message} à l'ID attribué par le système pour le message. Par exemple, spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB. Si vous définissez un ID personnalisé lorsque vous créez un message, vous pouvez l'utiliser pour spécifier le message dans une requête en remplaçant {message} par la valeur du champ clientAssignedMessageId. Par exemple, spaces/AAAAAAAAAAA/messages/client-custom-name. Pour en savoir plus, consultez Nommer un message.
sender	User Uniquement en sortie. Utilisateur qui a créé le message. Si votre application Chat s'authentifie en tant qu'utilisateur, la sortie renseigne les champs user name et type.
create_time	Timestamp Facultatif. Immuable. Pour les espaces créés dans Chat, il s'agit de l'heure à laquelle le message a été créé. Ce champ est en sortie seule, sauf lorsqu'il est utilisé dans des espaces en mode importation. Pour les espaces en mode importation, définissez ce champ sur le code temporel historique auquel le message a été créé dans la source afin de conserver l'heure de création d'origine.
last_update_time	Timestamp Uniquement en sortie. Heure à laquelle le message a été modifié pour la dernière fois par un utilisateur. Si le message n'a jamais été modifié, ce champ est vide.
delete_time	Timestamp Uniquement en sortie. Heure à laquelle le message a été supprimé dans Google Chat. Si le message n'est jamais supprimé, ce champ est vide.
text	string Facultatif. Corps du message en texte brut. Le premier lien vers une image, une vidéo ou une page Web génère un chip d'aperçu. Vous pouvez également @mentionner un utilisateur Google Chat ou tous les membres de l'espace. Pour savoir comment créer des messages, consultez Envoyer un message.
formatted_text	string Uniquement en sortie. Contient le message text avec des balises ajoutées pour communiquer la mise en forme. Il est possible que ce champ ne capture pas toute la mise en forme visible dans l'UI, mais il inclut les éléments suivants : Syntaxe de balisage pour le gras, l'italique, le barré, la police à chasse fixe, le bloc à chasse fixe et la liste à puces. Mentions d'utilisateurs au format <users/{user}>. Des liens hypertexte personnalisés au format <{url}|{rendered_text}>, où la première chaîne correspond à l'URL et la seconde au texte affiché (par exemple, <http://example.com|custom text>). Emoji personnalisés au format :{emoji_name}:, par exemple :smile:. Cela ne s'applique pas aux emoji Unicode, comme U+1F600 pour un emoji visage souriant. Pour en savoir plus, consultez Afficher la mise en forme du texte envoyé dans un message.
cards[] (deprecated)	Card Cet élément est obsolète. Obsolète : utilisez plutôt cards_v2. Cartes riches, mises en forme et interactives que vous pouvez utiliser pour afficher des éléments d'interface utilisateur tels que des textes mis en forme, des boutons et des images cliquables. Les cartes s'affichent normalement sous le corps en texte brut du message. La taille maximale de cards et cards_v2 est de 32 Ko.
cards_v2[]	CardWithId Facultatif. Tableau de cartes. Seules les applications Chat peuvent créer des fiches. Si votre application Chat s'authentifie en tant qu'utilisateur, les messages ne peuvent pas contenir de cartes. Pour savoir comment créer un message contenant des cartes, consultez Envoyer un message. Concevez et prévisualisez des cartes avec le générateur de cartes. Ouvrir le générateur de cartes
annotations[]	Annotation Uniquement en sortie. Les annotations peuvent être associées au corps en texte brut du message ou à des chips qui renvoient vers des ressources Google Workspace telles que Google Docs ou Sheets avec start_index et length définis sur 0.
thread	Thread Fil de discussion auquel appartient le message. Pour obtenir des exemples d'utilisation, consultez Démarrer un fil de discussion ou y répondre.
space	Space Uniquement en sortie. Si votre application Chat s'authentifie en tant qu'utilisateur, le résultat ne renseigne que le space name.
fallback_text	string Facultatif. Description en texte brut des cartes du message, utilisée lorsque les cartes réelles ne peuvent pas être affichées (par exemple, dans les notifications mobiles).
action_response	ActionResponse Uniquement en entrée. Paramètres qu'une application Chat peut utiliser pour configurer la façon dont sa réponse est publiée.
argument_text	string Uniquement en sortie. Corps du message en texte brut, sans aucune mention de l'application Chat.
slash_command	SlashCommand Uniquement en sortie. Informations sur la commande à barre oblique, le cas échéant.
attachment[]	Attachment Facultatif. Pièce jointe importée par l'utilisateur.
matched_url	MatchedUrl Uniquement en sortie. URL dans spaces.messages.text qui correspond à un format d'aperçu de lien. Pour en savoir plus, consultez Liens d'aperçu.
thread_reply	bool Uniquement en sortie. Lorsque la valeur est true, le message est une réponse dans un fil de discussion. Lorsque false, le message est visible dans la conversation de premier niveau de l'espace, soit en tant que premier message d'un fil de discussion, soit en tant que message sans réponse dans un fil de discussion. Si l'espace n'accepte pas les réponses dans les fils de discussion, ce champ est toujours défini sur false.
client_assigned_message_id	string Facultatif. ID personnalisé du message. Vous pouvez utiliser le champ pour identifier un message, ou pour obtenir, supprimer ou modifier un message. Pour définir un ID personnalisé, spécifiez le champ messageId lorsque vous créez le message. Pour en savoir plus, consultez Nommer un message.
emoji_reaction_summaries[]	EmojiReactionSummary Uniquement en sortie. Liste des résumés des réactions emoji sur le message.
private_message_viewer	User Facultatif. Immuable. Entrée pour créer un message, sinon sortie uniquement. L'utilisateur qui peut voir le message. Lorsqu'il est défini, le message est privé et n'est visible que par l'utilisateur spécifié et l'application Chat. Pour inclure ce champ dans votre requête, vous devez appeler l'API Chat à l'aide de l'authentification de l'application et omettre les éléments suivants : Pièces jointes Widgets d'accessoires Pour en savoir plus, consultez Envoyer un message privé.
deletion_metadata	DeletionMetadata Uniquement en sortie. Informations sur un message supprimé. Un message est supprimé lorsque delete_time est défini.
quoted_message_metadata	QuotedMessageMetadata Uniquement en sortie. Informations sur un message cité par un utilisateur Google Chat dans un espace. Les utilisateurs de Google Chat peuvent citer un message pour y répondre.
attached_gifs[]	AttachedGif Uniquement en sortie. Images GIF jointes au message.
accessory_widgets[]	AccessoryWidget Facultatif. Un ou plusieurs widgets interactifs qui s'affichent en bas d'un message. Vous pouvez ajouter des widgets accessoires aux messages contenant du texte, des fiches, ou à la fois du texte et des fiches. Non compatible avec les messages contenant des boîtes de dialogue. Pour en savoir plus, consultez Ajouter des widgets interactifs au bas d'un message. La création d'un message avec des widgets accessoires nécessite une authentification de l'application.

MessageBatchCreatedEventData

Charge utile d'événement pour plusieurs nouveaux messages.

Type d'événement : google.workspace.chat.message.v1.batchCreated

Champs
messages[]	MessageCreatedEventData Une liste de nouveaux messages.

MessageBatchDeletedEventData

Charge utile d'événement pour plusieurs messages supprimés.

Type d'événement : google.workspace.chat.message.v1.batchDeleted

Champs
messages[]	MessageDeletedEventData Liste des messages supprimés.

MessageBatchUpdatedEventData

Charge utile d'événement pour plusieurs messages modifiés.

Type d'événement : google.workspace.chat.message.v1.batchUpdated

Champs
messages[]	MessageUpdatedEventData Liste des messages mis à jour.

MessageCreatedEventData

Charge utile d'événement pour un nouveau message.

Type d'événement : google.workspace.chat.message.v1.created

Champs
message	Message Nouveau message.

MessageDeletedEventData

Charge utile d'événement pour un message supprimé.

Type d'événement : google.workspace.chat.message.v1.deleted

Champs
message	Message Le message supprimé. Seuls les champs name, createTime, deleteTime et deletionMetadata sont renseignés.

MessageUpdatedEventData

Charge utile de l'événement pour un message modifié.

Type d'événement : google.workspace.chat.message.v1.updated

Champs
message	Message Message modifié.

QuotedMessageMetadata

Informations sur un message cité.

Champs
name	string Uniquement en sortie. Nom de ressource du message cité. Format : spaces/{space}/messages/{message}
last_update_time	Timestamp Uniquement en sortie. Code temporel de la création ou de la dernière mise à jour du message cité.

Réaction

Réaction à un message.

Champs
name	string Identifiant. Nom de ressource de la réaction. Format : spaces/{space}/messages/{message}/reactions/{reaction}
user	User Uniquement en sortie. Utilisateur qui a créé la réaction.
emoji	Emoji Obligatoire. Emoji utilisé dans la réaction.

ReactionBatchCreatedEventData

Charge utile d'événement pour plusieurs nouvelles réactions.

Type d'événement : google.workspace.chat.reaction.v1.batchCreated

Champs
reactions[]	ReactionCreatedEventData Liste des nouvelles réactions.

ReactionBatchDeletedEventData

Charge utile d'événement pour plusieurs réactions supprimées.

Type d'événement : google.workspace.chat.reaction.v1.batchDeleted

Champs
reactions[]	ReactionDeletedEventData Liste des réactions supprimées.

ReactionCreatedEventData

Charge utile de l'événement pour une nouvelle réaction.

Type d'événement : google.workspace.chat.reaction.v1.created

Champs
reaction	Reaction La nouvelle réaction.

ReactionDeletedEventData

Charge utile d'un événement pour une réaction supprimée.

Type : google.workspace.chat.reaction.v1.deleted

Champs
reaction	Reaction Réaction supprimée.

RichLinkMetadata

Lien enrichi vers une ressource. Les liens enrichis peuvent être associés au corps en texte brut du message ou représenter des chips qui renvoient vers des ressources Google Workspace telles que Google Docs ou Sheets avec start_index et length définis sur 0.

Champs
uri	string URI de ce lien.
rich_link_type	RichLinkType Type de lien enrichi.
Champ d'union data. Données de la ressource associée. data ne peut être qu'un des éléments suivants :
drive_link_data	DriveLinkData Données pour un lien Drive.
chat_space_link_data	ChatSpaceLinkData Données pour un lien vers un espace de discussion.
meet_space_link_data	MeetSpaceLinkData Données pour un lien vers un espace Meet.
calendar_event_link_data	CalendarEventLinkData Données pour un lien vers un événement Agenda.

RichLinkType

Type de lien enrichi. D'autres types pourront être ajoutés à l'avenir.

Enums
RICH_LINK_TYPE_UNSPECIFIED	Valeur par défaut de l'énumération. Ne pas utiliser.
DRIVE_FILE	Type de lien enrichi Google Drive.
CHAT_SPACE	Type de lien enrichi d'un espace Chat. Par exemple, un chip intelligent d'espace.
MEET_SPACE	Type de lien enrichi pour un message Meet. Par exemple, un chip Meet.
CALENDAR_EVENT	Type de lien enrichi pour un message Agenda. Par exemple, un chip Agenda.

SearchSpacesRequest

Demande de recherche d'une liste d'espaces en fonction d'une requête.

Champs
use_admin_access	bool Lorsque la valeur est true, la méthode s'exécute avec les droits d'administrateur Google Workspace de l'utilisateur. L'utilisateur qui appelle doit être un administrateur Google Workspace disposant du droit "Gérer les conversations Chat et Espaces". Nécessite le champ d'application OAuth 2.0 chat.admin.spaces.readonly ou chat.admin.spaces. Cette méthode n'accepte actuellement que l'accès administrateur. Par conséquent, seule la valeur true est acceptée pour ce champ.
page_size	int32 Nombre maximal d'espaces à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 100 espaces au maximum sont renvoyés. La valeur maximale est de 1 000. Si vous utilisez une valeur supérieure à 1 000, elle est automatiquement remplacée par 1 000.
page_token	string Jeton reçu de l'appel précédent des espaces de recherche. Fournissez ce paramètre pour récupérer la page suivante. Lors de la pagination, tous les autres paramètres fournis doivent correspondre à l'appel ayant fourni le jeton de page. Si vous transmettez des valeurs différentes aux autres paramètres, vous risquez d'obtenir des résultats inattendus.
query	string Obligatoire. Une requête de recherche. Vous pouvez effectuer une recherche à l'aide des paramètres suivants : create_time customer display_name external_user_allowed last_active_time space_history_state space_type create_time et last_active_time acceptent un code temporel au format RFC-3339. Les opérateurs de comparaison acceptés sont les suivants : =, <, >, <= et >=. customer est obligatoire et permet d'indiquer le client à partir duquel récupérer les espaces. customers/my_customer est la seule valeur acceptée. display_name n'accepte que l'opérateur HAS (:). Le texte à faire correspondre est d'abord tokenisé en jetons. Chaque jeton est ensuite mis en correspondance de préfixe de manière indépendante et sans tenir compte de la casse, en tant que sous-chaîne n'importe où dans le display_name de l'espace. Par exemple, Fun Eve correspond à Fun event ou The evening was fun, mais pas à notFun event ni à even. external_user_allowed accepte true ou false. space_history_state n'accepte que les valeurs du champ historyState d'une ressource space. space_type est obligatoire et la seule valeur valide est SPACE. Seuls les opérateurs AND sont acceptés dans les différents champs. space_type = "SPACE" AND display_name:"Hello" est un exemple valide, tandis que space_type = "SPACE" OR display_name:"Hello" ne l'est pas. Dans un même champ, space_type n'est pas compatible avec les opérateurs AND ni OR. display_name, "space_history_state" et "external_user_allowed" n'acceptent que les opérateurs OR. last_active_time et create_time acceptent les opérateurs AND et OR. AND ne peut être utilisé que pour représenter un intervalle, tel que last_active_time < "2022-01-01T00:00:00+00:00" AND last_active_time > "2023-01-01T00:00:00+00:00". Les exemples de requêtes suivants sont valides : customer = "customers/my_customer" AND space_type = "SPACE" customer = "customers/my_customer" AND space_type = "SPACE" AND display_name:"Hello World" customer = "customers/my_customer" AND space_type = "SPACE" AND (last_active_time < "2020-01-01T00:00:00+00:00" OR last_active_time > "2022-01-01T00:00:00+00:00") customer = "customers/my_customer" AND space_type = "SPACE" AND (display_name:"Hello World" OR display_name:"Fun event") AND (last_active_time > "2020-01-01T00:00:00+00:00" AND last_active_time < "2022-01-01T00:00:00+00:00") customer = "customers/my_customer" AND space_type = "SPACE" AND (create_time > "2019-01-01T00:00:00+00:00" AND create_time < "2020-01-01T00:00:00+00:00") AND (external_user_allowed = "true") AND (space_history_state = "HISTORY_ON" OR space_history_state = "HISTORY_OFF")
order_by	string Facultatif. Ordre de la liste des espaces. Les attributs suivants peuvent être utilisés pour trier les résultats : membership_count.joined_direct_human_user_count : indique le nombre d'utilisateurs humains qui ont rejoint directement un espace. last_active_time : indique l'heure à laquelle le dernier élément éligible a été ajouté à un sujet de cet espace. create_time : indique l'heure de création de l'espace. Les valeurs d'opération de tri valides sont les suivantes : ASC pour l'ordre croissant. Valeur par défaut. DESC pour l'ordre décroissant. Voici les syntaxes acceptées : membership_count.joined_direct_human_user_count DESC membership_count.joined_direct_human_user_count ASC last_active_time DESC last_active_time ASC create_time DESC create_time ASC

SearchSpacesResponse

Réponse avec une liste d'espaces correspondant à la demande d'espaces de recherche.

Champs
spaces[]	Space Page des espaces demandés.
next_page_token	string Jeton pouvant être utilisé pour récupérer la page suivante. Si ce champ est vide, il n'y a pas d'autres pages.
total_size	int32 Nombre total d'espaces correspondant à la requête, sur toutes les pages. Si le résultat est supérieur à 10 000 espaces, cette valeur est une estimation.

SetUpSpaceRequest

Demander la création d'un espace et l'ajout d'utilisateurs spécifiques à cet espace.

Champs
space	Space Obligatoire. Le champ Space.spaceType est obligatoire. Pour créer un espace, définissez Space.spaceType sur SPACE et définissez Space.displayName. Si le message d'erreur ALREADY_EXISTS s'affiche lorsque vous configurez un espace, essayez un autre displayName. Il est possible qu'un espace existant dans l'organisation Google Workspace utilise déjà ce nom à afficher. Pour créer un chat de groupe, définissez Space.spaceType sur GROUP_CHAT. Ne définissez pas Space.displayName. Pour créer une conversation privée entre deux personnes, définissez Space.spaceType sur DIRECT_MESSAGE et Space.singleUserBotDm sur false. Ne définissez pas Space.displayName ni Space.spaceDetails. Pour créer une conversation privée entre un utilisateur et l'application Chat pour les appels, définissez Space.spaceType sur DIRECT_MESSAGE et Space.singleUserBotDm sur true. Ne définissez pas Space.displayName ni Space.spaceDetails. Si un espace DIRECT_MESSAGE existe déjà, il est renvoyé au lieu d'en créer un.
request_id	string Facultatif. Identifiant unique de cette demande. Nous vous recommandons d'utiliser un UUID aléatoire. Si vous spécifiez un ID de requête existant, l'espace créé avec cet ID est renvoyé au lieu d'un nouvel espace. Si vous spécifiez un ID de demande existant provenant de la même application Chat avec un utilisateur authentifié différent, une erreur est renvoyée.
memberships[]	Membership Facultatif. Utilisateurs ou groupes Google Chat à inviter à rejoindre l'espace. Omettez l'utilisateur appelant, car il est ajouté automatiquement. L'ensemble autorise actuellement jusqu'à 49 membres (en plus de l'appelant). Pour les membres humains, le champ Membership.member doit contenir un user avec name renseigné (format : users/{user}) et type défini sur User.Type.HUMAN. Vous ne pouvez ajouter que des utilisateurs humains lorsque vous configurez un espace (l'ajout d'applications Chat n'est possible que pour la configuration des messages privés avec l'application d'appel). Vous pouvez également ajouter des membres en utilisant leur adresse e-mail comme alias pour {user}. Par exemple, user.name peut être users/[e-mail]. Pour inviter des utilisateurs Gmail ou des utilisateurs de domaines Google Workspace externes, vous devez utiliser leur adresse e-mail pour {user}. Pour l'appartenance à un groupe Google, le champ Membership.group_member doit contenir un group avec name renseigné (format groups/{group}). Vous ne pouvez ajouter des groupes Google que lorsque vous définissez Space.spaceType sur SPACE. Facultatif lorsque Space.spaceType est défini sur SPACE. Obligatoire lorsque Space.spaceType est défini sur GROUP_CHAT, avec au moins deux abonnements. Obligatoire lorsque Space.spaceType est défini sur DIRECT_MESSAGE avec un utilisateur humain, ainsi qu'un seul abonnement. Doit être vide lors de la création d'une conversation privée entre un humain et l'application Chat appelante (lorsque Space.spaceType est défini sur DIRECT_MESSAGE et Space.singleUserBotDm sur true).

SlashCommand

Métadonnées concernant une commande à barre oblique dans Google Chat.

Champs
command_id	int64 ID de la commande à barre oblique.

SlashCommandMetadata

Métadonnées d'annotation pour les commandes à barre oblique (/).

Champs
bot	User Application Chat dont la commande a été appelée.
type	Type Type de commande à barre oblique.
command_name	string Nom de la commande à barre oblique appelée.
command_id	int64 ID de la commande à barre oblique appelée.
triggers_dialog	bool Indique si la commande à barre oblique est destinée à une boîte de dialogue.

Type

Enums
TYPE_UNSPECIFIED	Valeur par défaut de l'énumération. Ne pas utiliser.
ADD	Ajoutez l'application Chat à l'espace.
INVOKE	Appelez une commande à barre oblique dans un espace.

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.

Champs
name	string Identifiant. Nom de ressource de l'espace. Format : spaces/{space} Où {space} représente l'ID attribué par le système pour 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)	Type Cet élément est obsolète. Uniquement en sortie. Obsolète : utilisez plutôt space_type. Type d'espace.
space_type	SpaceType Facultatif. Type d'espace. Obligatoire lors de la création d'un espace ou de la modification de son type. Sortie uniquement pour les autres utilisations.
single_user_bot_dm	bool Facultatif. Indique si l'espace est un message privé entre une application Chat et un seul utilisateur.
threaded (deprecated)	bool Cet élément est obsolète. Uniquement en sortie. Obsolète : utilisez plutôt spaceThreadingState. Si les messages sont organisés en fils de discussion dans cet espace.
display_name	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 que vous mettez à jour le displayName, essayez un autre displayName. Il est possible qu'un espace existant dans l'organisation Google Workspace utilise déjà ce nom à afficher. Pour les messages privés, ce champ peut être vide. Jusqu'à 128 caractères.
external_user_allowed	bool Facultatif. Immuable. Indique si cet espace autorise tout utilisateur Google Chat à en devenir membre. Saisie 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 : L'utilisateur authentifié utilise un compte personnel (compte utilisateur non géré). Par défaut, un espace créé avec un compte personnel est accessible à tous les utilisateurs Google Chat. Pour les espaces existants, ce champ est en sortie uniquement.
space_threading_state	SpaceThreadingState Uniquement en sortie. État des fils de discussion dans l'espace Chat.
space_details	SpaceDetails Facultatif. Informations sur l'espace, y compris sa description et ses règles.
space_history_state	HistoryState Facultatif. État de l'historique des messages et des fils de discussion dans cet espace.
import_mode	bool Facultatif. Cet espace a été créé dans Import Mode lors d'une migration de données vers Google Workspace. Pendant l'importation des espaces, les utilisateurs ne peuvent pas les voir tant qu'elle n'est pas terminée. Pour créer un espace dans Import Mode, vous devez authentifier l'utilisateur.
create_time	Timestamp Facultatif. Immuable. Pour les espaces créés dans Chat, il s'agit de la date et de l'heure de création de l'espace. Ce champ est en sortie seule, sauf lorsqu'il est utilisé dans des espaces en mode importation. Pour les espaces en mode importation, définissez ce champ sur le code temporel historique auquel l'espace a été créé 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.
last_active_time	Timestamp Uniquement en sortie. Code temporel du dernier message dans l'espace.
admin_installed	bool Uniquement en sortie. Pour les espaces de messages privés 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 que l'installation par l'administrateur soit possible, votre application Chat doit proposer la messagerie privée.
membership_count	MembershipCount Uniquement en sortie. Nombre d'abonnements souscrits, regroupés par type de membre. Renseigné lorsque space_type est SPACE, DIRECT_MESSAGE ou GROUP_CHAT.
access_settings	AccessSettings Facultatif. Spécifie le paramètre d'accès de l'espace. Renseigné uniquement lorsque space_type est SPACE.
space_uri	string Uniquement en sortie. URI permettant à un utilisateur d'accéder à l'espace.
import_mode_expire_time	Timestamp Uniquement en sortie. Heure à 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 du délai à 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 lors de la création d'un espace avec authentification de l'application et 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 messages privés, ce champ n'est pas renseigné. Version Preview pour les développeurs : disponible dans le cadre du programme Preview développeur Google Workspace, qui permet d'accéder de manière anticipée à certaines fonctionnalités.
Champ d'union space_permission_settings. Représente les paramètres d'autorisation d'un espace. Renseigné uniquement lorsque space_type est SPACE. space_permission_settings ne peut être qu'un des éléments suivants :
predefined_permission_settings	PredefinedPermissionSettings Facultatif. Uniquement en entrée. Paramètres d'autorisation prédéfinis pour un espace, à saisir uniquement lors de la création d'un 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. La définition de paramètres d'autorisation prédéfinis permet : Authentification de l'application avec approbation de l'administrateur avec les champs d'application chat.app.spaces ou chat.app.spaces.create. Authentification des utilisateurs
permission_settings	PermissionSettings Facultatif. Paramètres d'autorisation des espaces existants. Entrée permettant de mettre à jour les paramètres d'autorisation exacts d'un espace, en remplaçant les paramètres d'autorisation existants. Le résultat liste les paramètres d'autorisation actuels. La lecture et la mise à jour des paramètres d'autorisation sont compatibles avec : Authentification de l'application avec approbation de l'administrateur avec le champ d'application chat.app.spaces. N'est renseigné et définissable que lorsque l'application Chat a créé l'espace. Authentification des utilisateurs

AccessSettings

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

Champs
access_state	AccessState Uniquement en sortie. Indique l'état d'accès à l'espace.
audience	string Facultatif. Nom de ressource de l'audience cible qui peut 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é ajoutés ou invités individuellement à l'espace peuvent y accéder. Pour en savoir plus, consultez Rendre un espace détectable 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 : Authentification des utilisateurs Authentification de l'application avec approbation de l'administrateur avec le champ d'application chat.app.spaces. 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 à l'espace.

Enums
ACCESS_STATE_UNSPECIFIED	L'état d'accès est inconnu ou non pris en charge dans 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 l'espace et y accéder.
DISCOVERABLE	Un gestionnaire d'espace a accordé l'accès à l'espace à une audience cible. Les utilisateurs ou les 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. Pour créer des espaces visibles, vous devez authentifier les utilisateurs.

MembershipCount

Représente le nombre d'abonnements à un espace, regroupés par catégories.

Champs
joined_direct_human_user_count	int32 Uniquement en sortie. Nombre d'utilisateurs humains qui ont rejoint directement l'espace, sans compter les utilisateurs qui l'ont rejoint en étant membres d'un groupe.
joined_group_count	int32 Uniquement en sortie. Nombre de tous les groupes ayant rejoint directement l'espace.

PermissionSetting

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

Champs
managers_allowed	bool Facultatif. Indique si les gestionnaires d'espaces disposent de cette autorisation.
members_allowed	bool Facultatif. Indique si les membres non administrateurs disposent de cette autorisation.

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.

Champs
manage_members_and_groups	PermissionSetting Facultatif. Paramètre permettant de gérer les membres et les groupes dans un espace.
modify_space_details	PermissionSetting Facultatif. Paramètre permettant de modifier le nom, l'avatar, la description et les consignes de l'espace.
toggle_history	PermissionSetting Facultatif. Paramètre permettant d'activer ou de désactiver l'historique des espaces.
use_at_mention_all	PermissionSetting Facultatif. Paramètre permettant d'utiliser @tous dans un espace.
manage_apps	PermissionSetting Facultatif. Paramètre permettant de gérer les applications dans un espace.
manage_webhooks	PermissionSetting Facultatif. Paramètre permettant de gérer les webhooks dans un espace.
post_messages	PermissionSetting Uniquement en sortie. Paramètre permettant de publier des messages dans un espace.
reply_messages	PermissionSetting Facultatif. Paramètre permettant de répondre aux messages dans un espace.

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 pourront être ajoutés à l'avenir. Pour en savoir plus sur les paramètres d'autorisation pour les espaces nommés, consultez À propos des 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 faire de l'espace un espace d'annonces où seuls les gestionnaires peuvent publier des messages.

SpaceDetails

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

Champs
description	string Facultatif. Description de l'espace. Par exemple, décrivez le thème de discussion de l'espace, son objectif fonctionnel ou ses participants. Jusqu'à 150 caractères.
guidelines	string Facultatif. les règles, les attentes et l'étiquette de l'espace. Jusqu'à 5 000 caractères sont acceptés.

SpaceThreadingState

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

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 même fil de discussion, ce qui permet de conserver 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 entre deux personnes et conversations de groupe entre trois personnes ou plus

SpaceType

Type d'espace. Obligatoire lors de la création ou de la modification d'un espace. Sortie uniquement pour les autres utilisations.

Enums
SPACE_TYPE_UNSPECIFIED	Réservé.
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 personnes ou entre une personne et une application Chat

Type

Obsolète : utilisez plutôt SpaceType.

Enums
TYPE_UNSPECIFIED	Réservé.
ROOM	Conversations entre deux personnes ou plus
DM	Message privé entre un utilisateur et une application de chat, où tous les messages sont au même niveau. Notez que cela n'inclut pas les messages privés entre deux personnes.

SpaceBatchUpdatedEventData

Charge utile d'événement pour plusieurs mises à jour d'un espace.

Type d'événement : google.workspace.chat.space.v1.batchUpdated

Champs
spaces[]	SpaceUpdatedEventData Liste des espaces mis à jour.

SpaceEvent

Événement représentant une modification ou une activité dans un espace Google Chat. Pour en savoir plus, consultez Utiliser des événements Google Chat.

Champs
name	string Nom de ressource de l'événement d'espace. Format : spaces/{space}/spaceEvents/{spaceEvent}
event_time	Timestamp Heure à laquelle l'événement s'est produit.
event_type	string Type d'événement d'espace. Chaque type d'événement possède une version par lot, qui représente plusieurs instances du type d'événement se produisant sur une courte période. Pour les requêtes spaceEvents.list(), omettez les types d'événements par lot dans votre filtre de requête. Par défaut, le serveur renvoie le type d'événement et sa version par lot. Types d'événements acceptés pour les messages : Nouveau message : google.workspace.chat.message.v1.created Message mis à jour : google.workspace.chat.message.v1.updated Message supprimé : google.workspace.chat.message.v1.deleted Plusieurs nouveaux messages : google.workspace.chat.message.v1.batchCreated Plusieurs messages modifiés : google.workspace.chat.message.v1.batchUpdated Plusieurs messages supprimés : google.workspace.chat.message.v1.batchDeleted Types d'événements acceptés pour les souscriptions : Nouvel abonnement : google.workspace.chat.membership.v1.created Abonnement modifié : google.workspace.chat.membership.v1.updated Abonnement supprimé : google.workspace.chat.membership.v1.deleted Plusieurs nouveaux abonnements : google.workspace.chat.membership.v1.batchCreated Plusieurs abonnements modifiés : google.workspace.chat.membership.v1.batchUpdated Plusieurs abonnements supprimés : google.workspace.chat.membership.v1.batchDeleted Types d'événements acceptés pour les réactions : Nouvelle réaction : google.workspace.chat.reaction.v1.created Réaction supprimée : google.workspace.chat.reaction.v1.deleted Plusieurs nouvelles réactions : google.workspace.chat.reaction.v1.batchCreated Plusieurs réactions supprimées : google.workspace.chat.reaction.v1.batchDeleted Types d'événements acceptés concernant l'espace : Espace modifié : google.workspace.chat.space.v1.updated Plusieurs mises à jour de l'espace : google.workspace.chat.space.v1.batchUpdated
Champ d'union payload. payload ne peut être qu'un des éléments suivants :
message_created_event_data	MessageCreatedEventData Charge utile d'événement pour un nouveau message. Type d'événement : google.workspace.chat.message.v1.created
message_updated_event_data	MessageUpdatedEventData Charge utile de l'événement pour un message modifié. Type d'événement : google.workspace.chat.message.v1.updated
message_deleted_event_data	MessageDeletedEventData Charge utile d'événement pour un message supprimé. Type d'événement : google.workspace.chat.message.v1.deleted
message_batch_created_event_data	MessageBatchCreatedEventData Charge utile d'événement pour plusieurs nouveaux messages. Type d'événement : google.workspace.chat.message.v1.batchCreated
message_batch_updated_event_data	MessageBatchUpdatedEventData Charge utile d'événement pour plusieurs messages modifiés. Type d'événement : google.workspace.chat.message.v1.batchUpdated
message_batch_deleted_event_data	MessageBatchDeletedEventData Charge utile d'événement pour plusieurs messages supprimés. Type d'événement : google.workspace.chat.message.v1.batchDeleted
space_updated_event_data	SpaceUpdatedEventData Charge utile d'événement pour la mise à jour d'un espace. Type d'événement : google.workspace.chat.space.v1.updated
space_batch_updated_event_data	SpaceBatchUpdatedEventData Charge utile d'événement pour plusieurs mises à jour d'un espace. Type d'événement : google.workspace.chat.space.v1.batchUpdated
membership_created_event_data	MembershipCreatedEventData Charge utile de l'événement pour un nouvel abonnement. Type d'événement : google.workspace.chat.membership.v1.created
membership_updated_event_data	MembershipUpdatedEventData Charge utile d'événement pour un abonnement modifié. Type d'événement : google.workspace.chat.membership.v1.updated
membership_deleted_event_data	MembershipDeletedEventData Charge utile d'événement pour une adhésion supprimée. Type d'événement : google.workspace.chat.membership.v1.deleted
membership_batch_created_event_data	MembershipBatchCreatedEventData Charge utile d'événement pour plusieurs nouvelles souscriptions. Type d'événement : google.workspace.chat.membership.v1.batchCreated
membership_batch_updated_event_data	MembershipBatchUpdatedEventData Charge utile d'événement pour plusieurs abonnements modifiés. Type d'événement : google.workspace.chat.membership.v1.batchUpdated
membership_batch_deleted_event_data	MembershipBatchDeletedEventData Charge utile de l'événement pour plusieurs abonnements supprimés. Type d'événement : google.workspace.chat.membership.v1.batchDeleted
reaction_created_event_data	ReactionCreatedEventData Charge utile de l'événement pour une nouvelle réaction. Type d'événement : google.workspace.chat.reaction.v1.created
reaction_deleted_event_data	ReactionDeletedEventData Charge utile d'un événement pour une réaction supprimée. Type d'événement : google.workspace.chat.reaction.v1.deleted
reaction_batch_created_event_data	ReactionBatchCreatedEventData Charge utile d'événement pour plusieurs nouvelles réactions. Type d'événement : google.workspace.chat.reaction.v1.batchCreated
reaction_batch_deleted_event_data	ReactionBatchDeletedEventData Charge utile d'événement pour plusieurs réactions supprimées. Type d'événement : google.workspace.chat.reaction.v1.batchDeleted

SpaceNotificationSetting

Paramètre de notification d'un utilisateur dans un espace.

Champs
name	string Identifiant. Nom de ressource du paramètre de notification de l'espace. Format : users/{user}/spaces/{space}/spaceNotificationSetting.
notification_setting	NotificationSetting Paramètre de notification.
mute_setting	MuteSetting Paramètre de désactivation des notifications de l'espace.

MuteSetting

Types de paramètres de désactivation des notifications d'espace.

Enums
MUTE_SETTING_UNSPECIFIED	Réservé.
UNMUTED	L'utilisateur recevra des notifications pour l'espace en fonction du paramètre de notification.
MUTED	L'utilisateur ne recevra aucune notification pour l'espace, quel que soit le paramètre de notification.

NotificationSetting

Types de paramètres de notification. D'autres types pourront être acceptés à l'avenir.

Enums
NOTIFICATION_SETTING_UNSPECIFIED	Réservé.
ALL	Les notifications sont déclenchées par les @mentions, les fils de discussion suivis et le premier message d'un nouveau fil. Tous les nouveaux fils de discussion sont automatiquement suivis, sauf si l'utilisateur arrête manuellement de les suivre.
MAIN_CONVERSATIONS	La notification est déclenchée par les @mentions, les fils de discussion suivis et le premier message d'un nouveau fil. Non disponible pour les messages privés.
FOR_YOU	La notification est déclenchée par les @mentions et les fils de discussion suivis. Non disponible pour les messages privés.
OFF	Les notifications sont désactivées.

SpaceReadState

État de lecture d'un utilisateur dans un espace, utilisé pour identifier les messages lus et non lus.

Champs
name	string Nom de ressource de l'état de lecture de l'espace. Format : users/{user}/spaces/{space}/spaceReadState
last_read_time	Timestamp Facultatif. Heure à laquelle l'état de lecture de l'espace de l'utilisateur a été mis à jour. Il s'agit généralement de l'horodatage du dernier message lu ou d'un horodatage spécifié par l'utilisateur pour marquer la dernière position de lecture dans un espace.

SpaceUpdatedEventData

Charge utile d'événement pour un espace mis à jour.

Type d'événement : google.workspace.chat.space.v1.updated

Champs
space	Space L'espace modifié.

Thread

Fil de discussion dans un espace Google Chat. Pour obtenir des exemples d'utilisation, consultez Démarrer un fil de discussion ou y répondre.

Si vous spécifiez un fil de discussion lorsque vous créez un message, vous pouvez définir le champ messageReplyOption pour déterminer ce qui se passe si aucun fil de discussion correspondant n'est trouvé.

Champs
name	string Identifiant. Nom de ressource du fil de discussion. Exemple : spaces/{space}/threads/{thread}
thread_key	string Facultatif. Entrée pour créer ou mettre à jour un thread. Sinon, sortie uniquement. ID du thread. Elle peut contenir jusqu'à 4 000 caractères. Cet ID est propre à l'application Chat qui le définit. Par exemple, si plusieurs applications Chat créent un message à l'aide de la même clé de fil de discussion, les messages sont publiés dans des fils de discussion différents. Pour répondre à un fil de discussion créé par une personne ou une autre application Chat, spécifiez plutôt le champ name du fil de discussion.

ThreadReadState

État de lecture d'un utilisateur dans un fil de discussion, utilisé pour identifier les messages lus et non lus.

Champs
name	string Nom de ressource de l'état de lecture du thread. Format : users/{user}/spaces/{space}/threads/{thread}/threadReadState
last_read_time	Timestamp Heure à laquelle l'état de lecture du fil de discussion de l'utilisateur a été mis à jour. Cela correspond généralement au code temporel du dernier message lu dans un fil de discussion.

UpdateMembershipRequest

Message de requête pour mettre à jour une adhésion.

Champs
membership	Membership Obligatoire. Abonnement à mettre à jour. Seuls les champs spécifiés par update_mask sont mis à jour.
update_mask	FieldMask Obligatoire. Chemins des champs à mettre à jour. Séparez les valeurs multiples par des virgules ou utilisez * pour mettre à jour tous les chemins de champ. Chemins de champ actuellement acceptés : role
use_admin_access	bool Facultatif. Lorsque la valeur est true, la méthode s'exécute avec les droits d'administrateur Google Workspace de l'utilisateur. L'utilisateur qui appelle doit être un administrateur Google Workspace disposant du droit "Gérer les conversations Chat et Espaces". Nécessite le champ d'application OAuth 2.0 chat.admin.memberships.

UpdateMessageRequest

Requête de mise à jour d'un message.

Champs
message	Message Obligatoire. Message avec des champs mis à jour.
update_mask	FieldMask Obligatoire. Chemins des champs à mettre à jour. Séparez les valeurs multiples par des virgules ou utilisez * pour mettre à jour tous les chemins de champ. Chemins de champ actuellement acceptés : text attachment cards (Authentification de l'application requise) cards_v2 (Authentification de l'application requise) accessory_widgets (Authentification de l'application requise)
allow_missing	bool Facultatif. Si true et le message sont introuvables, un nouveau message est créé et updateMask est ignoré. L'ID de message spécifié doit être attribué par le client, sinon la requête échoue.

UpdateSpaceNotificationSettingRequest

Requête de mise à jour des paramètres de notification de l'espace. Ne permet de mettre à jour les paramètres de notification que pour l'utilisateur appelant.

Champs
space_notification_setting	SpaceNotificationSetting Obligatoire. Le nom de ressource des paramètres de notification de l'espace doit être renseigné au format users/{user}/spaces/{space}/spaceNotificationSetting. Seuls les champs spécifiés par update_mask sont mis à jour.
update_mask	FieldMask Obligatoire. Chemins de champ acceptés : notification_setting mute_setting

UpdateSpaceReadStateRequest

Message de requête pour l'API UpdateSpaceReadState.

Champs
space_read_state	SpaceReadState Obligatoire. État de lecture de l'espace et champs à mettre à jour. Ne permet de mettre à jour l'état de lecture que pour l'utilisateur appelant. Pour faire référence à l'utilisateur appelant, définissez l'une des valeurs suivantes : Alias me. Exemple :users/me/spaces/{space}/spaceReadState Son adresse e-mail Workspace Par exemple, users/[e-mail]/spaces/{space}/spaceReadState. Son ID utilisateur. Par exemple, users/123456789/spaces/{space}/spaceReadState. Format : users/{user}/spaces/{space}/spaceReadState
update_mask	FieldMask Obligatoire. Chemins des champs à mettre à jour. Chemins de champ actuellement acceptés : last_read_time Lorsque last_read_time est antérieur à l'heure de création du dernier message, l'espace apparaît comme non lu dans l'UI. Pour marquer l'espace comme lu, définissez last_read_time sur une valeur ultérieure (supérieure) à l'heure de création du dernier message. La valeur last_read_time est forcée pour correspondre à l'heure de création du dernier message. Notez que l'état de lecture de l'espace n'affecte que l'état de lecture des messages visibles dans la conversation de premier niveau de l'espace. Les réponses dans les fils de discussion ne sont pas concernées par cet horodatage. Elles dépendent plutôt de l'état de lecture du fil de discussion.

UpdateSpaceRequest

Requête permettant de mettre à jour un seul espace.

Champs
space	Space Obligatoire. Espace avec les champs à mettre à jour. Space.name doit être renseigné au format spaces/{space}. Seuls les champs spécifiés par update_mask sont mis à jour.
update_mask	FieldMask Obligatoire. Chemins d'accès aux champs mis à jour, séparés par une virgule s'il y en a plusieurs. Vous pouvez modifier les champs suivants d'un espace : space_details : met à jour la description de l'espace. Jusqu'à 150 caractères. display_name : ne permet de modifier le nom à afficher que pour les espaces où le champ spaceType est défini sur SPACE. Si le message d'erreur ALREADY_EXISTS s'affiche, essayez une autre valeur. Il est possible qu'un espace existant dans l'organisation Google Workspace utilise déjà ce nom à afficher. space_type : ne permet de modifier un type d'espace GROUP_CHAT que pour le remplacer par SPACE. Incluez display_name avec space_type dans le masque de mise à jour et assurez-vous que l'espace spécifié a un nom à afficher non vide et le type d'espace SPACE. L'inclusion du masque space_type et du type SPACE dans l'espace spécifié lors de la modification du nom à afficher est facultative si l'espace existant possède déjà le type SPACE. Si vous essayez de modifier le type d'espace d'une autre manière, une erreur d'argument non valide s'affiche. space_type n'est pas compatible avec useAdminAccess. space_history_state : met à jour les paramètres de l'historique de l'espace en activant ou en désactivant l'historique de l'espace. N'est disponible que si les paramètres d'historique sont activés pour l'organisation Google Workspace. Pour mettre à jour l'état de l'historique de l'espace, vous devez omettre tous les autres masques de champ dans votre requête. space_history_state n'est pas compatible avec useAdminAccess. access_settings.audience : met à jour le paramètre d'accès pour déterminer qui peut découvrir l'espace, le rejoindre et prévisualiser les messages dans l'espace nommé où le champ spaceType est défini sur SPACE. Si l'espace existant a une audience cible, vous pouvez la supprimer et limiter l'accès à l'espace en omettant une valeur pour ce masque de champ. Pour modifier les paramètres d'accès d'un espace, l'utilisateur qui s'authentifie doit être un administrateur de l'espace et omettre tous les autres masques de champ dans sa demande. Vous ne pouvez pas modifier ce champ si l'espace est en mode importation. Pour en savoir plus, consultez Rendre un espace visible pour des utilisateurs spécifiques. access_settings.audience n'est pas compatible avec useAdminAccess. permission_settings : permet de modifier les paramètres d'autorisation d'un espace. Lorsque vous mettez à jour les paramètres d'autorisation, vous ne pouvez spécifier que des masques de champ permissionSettings. Vous ne pouvez pas mettre à jour d'autres masques de champ en même temps. permissionSettings n'est pas compatible avec useAdminAccess. Voici les masques de champ acceptés : permission_settings.manageMembersAndGroups permission_settings.modifySpaceDetails permission_settings.toggleHistory permission_settings.useAtMentionAll permission_settings.manageApps permission_settings.manageWebhooks permission_settings.replyMessages
use_admin_access	bool Facultatif. Lorsque la valeur est true, la méthode s'exécute avec les droits d'administrateur Google Workspace de l'utilisateur. L'utilisateur qui appelle doit être un administrateur Google Workspace disposant du droit "Gérer les conversations Chat et Espaces". Nécessite le champ d'application OAuth 2.0 chat.admin.spaces. Certaines valeurs FieldMask ne sont pas compatibles avec l'accès administrateur. Pour en savoir plus, consultez la description de update_mask.

Utilisateur

Un utilisateur dans Google Chat. Lorsqu'elle est renvoyée en tant que résultat d'une requête, si votre application Chat s'authentifie en tant qu'utilisateur, le résultat d'une ressource User ne renseigne que les name et type de l'utilisateur.

Champs
name	string Nom de ressource pour un user Google Chat. Format : users/{user}. users/app peut être utilisé comme alias pour l'utilisateur de l'application d'appel bot. Pour human users, {user} est le même identifiant utilisateur que : id pour la Personne dans l'API People. Par exemple, users/123456789 dans l'API Chat représente la même personne que l'ID de profil de personne 123456789 dans l'API People. le id d'un utilisateur dans l'API Directory du SDK Admin. L'adresse e-mail de l'utilisateur peut être utilisée comme alias pour {user} dans les requêtes API. Par exemple, si l'ID de profil de personne de l'API People pour [e-mail] est 123456789, vous pouvez utiliser users/[e-mail] comme alias pour faire référence à users/123456789. Seul le nom canonique de la ressource (par exemple, users/123456789) sera renvoyé par l'API.
display_name	string Uniquement en sortie. Nom à afficher de l'utilisateur.
domain_id	string Identifiant unique du domaine Google Workspace de l'utilisateur.
type	Type Type d'utilisateur.
is_anonymous	bool Uniquement en sortie. Lorsque true, l'utilisateur est supprimé ou son profil n'est pas visible.

Type

Enums
TYPE_UNSPECIFIED	Valeur par défaut de l'énumération. NE PAS UTILISER.
HUMAN	Utilisateur humain.
BOT	Utilisateur de l'application Chat.

UserMentionMetadata

Métadonnées d'annotation pour les mentions utilisateur (@).

Champs
user	User L'utilisateur mentionné.
type	Type Type de mention utilisateur.

Type

Enums
TYPE_UNSPECIFIED	Valeur par défaut de l'énumération. Ne pas utiliser.
ADD	Ajoutez un utilisateur à l'espace.
MENTION	Mentionner un utilisateur dans un espace

WidgetMarkup

Un widget est un élément d'interface utilisateur qui présente du texte et des images.

Champs
buttons[]	Button Liste de boutons. "Buttons" est également oneof data. Vous ne devez définir qu'un seul de ces champs.
Champ d'union data. Un WidgetMarkup ne peut contenir qu'un seul des éléments suivants. Vous pouvez utiliser plusieurs champs WidgetMarkup pour afficher plus d'éléments. data ne peut être qu'un des éléments suivants :
text_paragraph	TextParagraph Affichez un paragraphe de texte dans ce widget.
image	Image Affichez une image dans ce widget.
key_value	KeyValue Affichez un élément clé-valeur dans ce widget.

Bouton

Un bouton. Il peut s'agir d'un bouton textuel ou d'un bouton image.

Champs
Champ d'union type. type ne peut être qu'un des éléments suivants :
text_button	TextButton Bouton avec texte et action onclick.
image_button	ImageButton Bouton avec image et action onclick.

FormAction

Une action de formulaire décrit le comportement lorsque le formulaire est envoyé. Par exemple, vous pouvez appeler Apps Script pour gérer le formulaire.

Champs
action_method_name	string Le nom de la méthode permet d'identifier la partie du formulaire qui a déclenché l'envoi du formulaire. Ces informations sont renvoyées à l'application Chat dans le cadre de l'événement de clic sur la fiche. Vous pouvez utiliser le même nom de méthode pour plusieurs éléments qui déclenchent un comportement commun.
parameters[]	ActionParameter Liste des paramètres d'action.

ActionParameter

Liste des paramètres de chaîne à fournir lorsque la méthode d'action est appelée. Par exemple, considérons trois boutons de report : "Reporter maintenant", "Reporter d'un jour" et "Reporter d'une semaine". Vous pouvez utiliser action method = snooze() en transmettant le type et la durée de la mise en veille dans la liste des paramètres de chaîne.

Champs
key	string Nom du paramètre du script d'action.
value	string Valeur du paramètre.

Icône

Ensemble d'icônes compatibles.

Enums
ICON_UNSPECIFIED
AIRPLANE
BOOKMARK
BUS
CAR
CLOCK
CONFIRMATION_NUMBER_ICON
DOLLAR
DESCRIPTION
EMAIL
EVENT_PERFORMER
EVENT_SEAT
FLIGHT_ARRIVAL
FLIGHT_DEPARTURE
HOTEL
HOTEL_ROOM_TYPE
INVITE
MAP_PIN
MEMBERSHIP
MULTIPLE_PEOPLE
OFFER
PERSON
PHONE
RESTAURANT_ICON
SHOPPING_CART
STAR
STORE
TICKET
TRAIN
VIDEO_CAMERA
VIDEO_PLAY

Image

Image spécifiée par une URL et pouvant être associée à une action onclick.

Champs
image_url	string URL de l'image
on_click	OnClick Action onclick.
aspect_ratio	double Rapport d'aspect de cette image (largeur et hauteur). Ce champ vous permet de réserver la hauteur appropriée pour l'image en attendant qu'elle se charge. Il n'est pas destiné à remplacer le format intégré de l'image. Si elle n'est pas définie, le serveur la remplit en préchargeant l'image.

ImageButton

Bouton d'image avec une action onclick.

Champs
on_click	OnClick Action onclick.
name	string Nom de ce image_button utilisé pour l'accessibilité. Une valeur par défaut est fournie si ce nom n'est pas spécifié.
Champ d'union icons. L'icône peut être spécifiée par un Icon enum ou une URL. icons ne peut être qu'un des éléments suivants :
icon	Icon Icône spécifiée par un enum qui indexe une icône fournie par l'API Chat.
icon_url	string Icône spécifiée par une URL.

KeyValue

Un élément d'interface utilisateur contient une clé (libellé) et une valeur (contenu). Cet élément peut également contenir certaines actions, comme le bouton onclick.

Champs
top_label	string Texte du libellé supérieur. Le texte mis en forme est accepté. Pour en savoir plus sur la mise en forme du texte, consultez Mettre en forme du texte dans les applications Google Chat et Mettre en forme du texte dans les modules complémentaires Google Workspace.
content	string Texte du contenu. Le texte mis en forme est accepté et toujours obligatoire. Pour en savoir plus sur la mise en forme du texte, consultez Mettre en forme du texte dans les applications Google Chat et Mettre en forme du texte dans les modules complémentaires Google Workspace.
content_multiline	bool Indique si le contenu doit être multiligne.
bottom_label	string Texte du libellé inférieur. Le texte mis en forme est accepté. Pour en savoir plus sur la mise en forme du texte, consultez Mettre en forme du texte dans les applications Google Chat et Mettre en forme du texte dans les modules complémentaires Google Workspace.
on_click	OnClick Action onclick. Seuls le libellé supérieur, le libellé inférieur et la région de contenu sont cliquables.
Champ d'union icons. Vous devez définir au moins une icône, top_label ou bottom_label. icons ne peut être qu'un des éléments suivants :
icon	Icon Valeur enum remplacée par l'API Chat par l'image d'icône correspondante.
icon_url	string Icône spécifiée par une URL.
Champ d'union control. Un widget de contrôle. Vous pouvez définir button ou switch_widget, mais pas les deux. control ne peut être qu'un des éléments suivants :
button	Button Bouton sur lequel l'utilisateur peut cliquer pour déclencher une action.

OnClick

Une action onclick (par exemple, ouvrir un lien).

Champs
Champ d'union data. data ne peut être qu'un des éléments suivants :
action	FormAction Une action de formulaire est déclenchée par cette action onclick si elle est spécifiée.
open_link	OpenLink Cette action onclick déclenche une action d'ouverture de lien, si elle est spécifiée.

OpenLink

Un lien qui ouvre une nouvelle fenêtre.

Champs
url	string URL à ouvrir.

TextButton

Bouton avec texte et action onclick.

Champs
text	string Texte du bouton
on_click	OnClick Action onclick du bouton.

TextParagraph

Un paragraphe de texte. Le texte mis en forme est accepté. Pour en savoir plus sur la mise en forme du texte, consultez Mettre en forme du texte dans les applications Google Chat et Mettre en forme du texte dans les modules complémentaires Google Workspace.

Champs
text	string