REST Resource: spaces.messages

Ressource : Message

Message dans un espace Google Chat.

Représentation JSON
{
  "name": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "lastUpdateTime": string,
  "deleteTime": string,
  "text": string,
  "formattedText": string,
  "cards": [
    {
      object (Card)
    }
  ],
  "cardsV2": [
    {
      object (CardWithId)
    }
  ],
  "annotations": [
    {
      object (Annotation)
    }
  ],
  "thread": {
    object (Thread)
  },
  "space": {
    object (Space)
  },
  "fallbackText": string,
  "actionResponse": {
    object (ActionResponse)
  },
  "argumentText": string,
  "slashCommand": {
    object (SlashCommand)
  },
  "attachment": [
    {
      object (Attachment)
    }
  ],
  "matchedUrl": {
    object (MatchedUrl)
  },
  "threadReply": boolean,
  "clientAssignedMessageId": string,
  "emojiReactionSummaries": [
    {
      object (EmojiReactionSummary)
    }
  ],
  "privateMessageViewer": {
    object (User)
  },
  "deletionMetadata": {
    object (DeletionMetadata)
  },
  "quotedMessageMetadata": {
    object (QuotedMessageMetadata)
  },
  "attachedGifs": [
    {
      object (AttachedGif)
    }
  ],
  "accessoryWidgets": [
    {
      object (AccessoryWidget)
    }
  ]
}
Champs
name

string

Identifiant. Nom de ressource du message.

Format : spaces/{space}/messages/{message}

{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

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

createTime

string (Timestamp format)

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.

lastUpdateTime

string (Timestamp format)

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.

deleteTime

string (Timestamp format)

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.

formattedText

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 :{emojiName}:, 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)

object (Card)

Obsolète : utilisez plutôt cardsV2.

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 cardsV2 est de 32 Ko.

cardsV2[]

object (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[]

object (Annotation)

Uniquement en sortie. Annotations associées au text dans ce message.

thread

object (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

object (Space)

Uniquement en sortie. Si votre application Chat s'authentifie en tant qu'utilisateur, le résultat ne renseigne que le space name.

fallbackText

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

actionResponse

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

argumentText

string

Uniquement en sortie. Corps du message en texte brut, sans aucune mention de l'application Chat.

slashCommand

object (SlashCommand)

Uniquement en sortie. Informations sur la commande à barre oblique, le cas échéant.

attachment[]

object (Attachment)

Facultatif. Pièce jointe importée par l'utilisateur.

matchedUrl

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

threadReply

boolean

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.

clientAssignedMessageId

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.

emojiReactionSummaries[]

object (EmojiReactionSummary)

Uniquement en sortie. Liste des résumés des réactions emoji sur le message.

privateMessageViewer

object (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 :

Pour en savoir plus, consultez Envoyer un message privé.

deletionMetadata

object (DeletionMetadata)

Uniquement en sortie. Informations sur un message supprimé. Un message est supprimé lorsque deleteTime est défini.

quotedMessageMetadata

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

attachedGifs[]

object (AttachedGif)

Uniquement en sortie. Images GIF jointes au message.

accessoryWidgets[]

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

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

Représentation JSON
{
  "cardId": string,
  "card": {
    object (Card)
  }
}
Champs
cardId

string

Obligatoire si le message contient plusieurs cartes. Identifiant unique d'une fiche dans un message.

card

object (Card)

Une fiche La taille maximale est de 32 Ko.

Annotation

Uniquement en sortie. Annotations associées au corps en texte brut du message. 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"
   }
}]
Représentation JSON
{
  "type": enum (AnnotationType),
  "length": integer,
  "startIndex": integer,

  // Union field metadata can be only one of the following:
  "userMention": {
    object (UserMentionMetadata)
  },
  "slashCommand": {
    object (SlashCommandMetadata)
  },
  "richLinkMetadata": {
    object (RichLinkMetadata)
  },
  "customEmojiMetadata": {
    object (CustomEmojiMetadata)
  }
  // End of list of possible types for union field metadata.
}
Champs
type

enum (AnnotationType)

Type de cette annotation.

length

integer

Longueur de la sous-chaîne dans le corps du message en texte brut à laquelle correspond cette annotation.

startIndex

integer

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 :
userMention

object (UserMentionMetadata)

Métadonnées de la mention de l'utilisateur.

slashCommand

object (SlashCommandMetadata)

Métadonnées d'une commande à barre oblique.

customEmojiMetadata

object (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.
CUSTOM_EMOJI Annotation d'emoji personnalisé.

UserMentionMetadata

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

Représentation JSON
{
  "user": {
    object (User)
  },
  "type": enum (Type)
}
Champs
user

object (User)

L'utilisateur mentionné.

type

enum (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

SlashCommandMetadata

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

Représentation JSON
{
  "bot": {
    object (User)
  },
  "type": enum (Type),
  "commandName": string,
  "commandId": string,
  "triggersDialog": boolean
}
Champs
bot

object (User)

Application Chat dont la commande a été appelée.

type

enum (Type)

Type de commande à barre oblique.

commandName

string

Nom de la commande à barre oblique appelée.

commandId

string (int64 format)

ID de la commande à barre oblique appelée.

triggersDialog

boolean

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.

RichLinkMetadata

Lien enrichi vers une ressource.

Représentation JSON
{
  "uri": string,
  "richLinkType": enum (RichLinkType),

  // Union field data can be only one of the following:
  "driveLinkData": {
    object (DriveLinkData)
  },
  "chatSpaceLinkData": {
    object (ChatSpaceLinkData)
  }
  // End of list of possible types for union field data.
}
Champs
uri

string

URI de ce lien.

Champ d'union data. Données de la ressource associée. data ne peut être qu'un des éléments suivants :

RichLinkType

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

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

DriveLinkData

Données pour les liens Google Drive.

Représentation JSON
{
  "driveDataRef": {
    object (DriveDataRef)
  },
  "mimeType": string
}
Champs
driveDataRef

object (DriveDataRef)

Un DriveDataRef qui fait référence à un fichier Google Drive.

mimeType

string

Type MIME de la ressource Google Drive associée.

ChatSpaceLinkData

Données pour les liens vers les espaces Chat.

Représentation JSON
{
  "space": string,
  "thread": string,
  "message": string
}
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}

CustomEmojiMetadata

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

Représentation JSON
{
  "customEmoji": {
    object (CustomEmoji)
  }
}
Champs
customEmoji

object (CustomEmoji)

Emoji personnalisé.

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

Représentation JSON
{
  "name": string,
  "threadKey": string
}
Champs
name

string

Identifiant. Nom de ressource du fil de discussion.

Exemple : spaces/{space}/threads/{thread}

threadKey

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.

ActionResponse

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

Représentation JSON
{
  "type": enum (ResponseType),
  "url": string,
  "dialogAction": {
    object (DialogAction)
  },
  "updatedWidget": {
    object (UpdatedWidget)
  }
}
Champs
type

enum (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)

dialogAction

object (DialogAction)

Uniquement en entrée. Réponse à un événement d'interaction lié à une boîte de dialogue. Doit être accompagné de ResponseType.Dialog.

updatedWidget

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

DialogAction

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

Représentation JSON
{
  "actionStatus": {
    object (ActionStatus)
  },

  // Union field action can be only one of the following:
  "dialog": {
    object (Dialog)
  }
  // End of list of possible types for union field action.
}
Champs
actionStatus

object (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

object (Dialog)

Uniquement en entrée. Boîte de dialogue pour la requête.

Dialog

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

Représentation JSON
{
  "body": {
    object (Card)
  }
}
Champs
body

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

ActionStatus

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

Représentation JSON
{
  "statusCode": enum (Code),
  "userFacingMessage": string
}
Champs
statusCode

enum (Code)

Code d'état.

userFacingMessage

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 statusCode est envoyé.

Code

Les codes d'erreur canoniques pour les API de gRPC.

Parfois, plusieurs codes d'erreur peuvent s'appliquer. Les services doivent renvoyer le code d'erreur le plus spécifique qui s'applique. Par exemple, préférez OUT_OF_RANGE à FAILED_PRECONDITION si les deux codes s'appliquent. De même, préférez NOT_FOUND ou ALREADY_EXISTS à FAILED_PRECONDITION.

Enums
OK

Pas une erreur, affiché en cas de réussite.

Mise en correspondance HTTP : 200 OK

CANCELLED

L'opération a été annulée, généralement par l'appelant.

Mise en correspondance HTTP : 499 Le client a fermé la requête

UNKNOWN

Erreur inconnue. Par exemple, cette erreur peut s'afficher lorsqu'une valeur Status reçue d'un autre espace d'adressage appartient à un espace d'erreur inconnu dans cet espace d'adressage. De plus, les erreurs des API qui ne renvoient pas suffisamment d'informations relatives aux erreurs peuvent être converties dans cette erreur.

Mise en correspondance HTTP : 500 Erreur de serveur interne

INVALID_ARGUMENT

Le client a spécifié un argument non valide. Notez que cette erreur diffère de FAILED_PRECONDITION. INVALID_ARGUMENT indique les arguments problématiques quel que soit l'état du système (par exemple, un nom de fichier incorrect).

Mise en correspondance HTTP : 400 Requête incorrecte

DEADLINE_EXCEEDED

Le délai a expiré avant que l'opération puisse se terminer. Pour les opérations qui modifient l'état du système, cette erreur peut être affichée même si l'opération s'est terminée avec succès. Par exemple, une réponse réussie d'un serveur aurait pu être retardée suffisamment longtemps pour que le délai expire.

Mappage HTTP : 504 Passerelle hors délai

NOT_FOUND

Une entité demandée (fichier ou répertoire, par exemple) est introuvable.

Remarque pour les développeurs de serveurs : NOT_FOUND peut être utilisé si une requête est refusée pour toute une classe d'utilisateurs, telle que le déploiement progressif des fonctionnalités ou la liste d'autorisation non documentée. Si une requête est refusée pour certains utilisateurs appartenant à une classe d'utilisateurs, telle que le contrôle des accès basé sur l'utilisateur, PERMISSION_DENIED doit être utilisé.

Mise en correspondance HTTP : 404 Page introuvable

ALREADY_EXISTS

L'entité qu'un client a tenté de créer (par exemple, un fichier ou un répertoire) existe déjà.

Mise en correspondance HTTP : 409 Conflit

PERMISSION_DENIED

L'appelant n'a pas l'autorisation d'exécuter l'opération spécifiée. PERMISSION_DENIED ne doit pas être utilisé pour les rejets causés par l'épuisement d'une ressource (utilisez plutôt RESOURCE_EXHAUSTED pour ces erreurs). PERMISSION_DENIED ne doit pas être utilisé si l'appelant ne peut pas être identifié (utilisez plutôt UNAUTHENTICATED pour ces erreurs). Ce code d'erreur n'implique pas que la requête soit valide ni que l'entité demandée existe ou qu'elle répond à d'autres pré-requis.

Mise en correspondance HTTP : 403 Accès interdit

UNAUTHENTICATED

La requête ne dispose pas d'identifiants d'authentification valides pour l'opération.

Mise en correspondance HTTP : 401 Accès non autorisé

RESOURCE_EXHAUSTED

Certaines ressources ont été épuisées ; par exemple, un quota par utilisateur a été atteint ou le système de fichiers dans son intégralité manque d'espace.

Mise en correspondance HTTP : 429 Requêtes trop nombreuses

FAILED_PRECONDITION

L'opération a été rejetée car le système n'est pas dans un état requis pour exécuter l'opération. Par exemple, le répertoire à supprimer n'est pas vide, une opération rmdir est appliquée à un emplacement qui n'est pas un répertoire, etc.

Les développeurs de services peuvent suivre les instructions suivantes pour choisir entre FAILED_PRECONDITION, ABORTED et UNAVAILABLE : (a) Utilisez UNAVAILABLE si le client ne peut relancer que l'appel ayant échoué. (b) Utilisez ABORTED si le client doit effectuer une nouvelle tentative à un niveau supérieur (par exemple, lorsqu'un test-and-set spécifié par le client échoue, indiquant que le client doit redémarrer une séquence lecture-modification-écriture). (c) Utilisez FAILED_PRECONDITION si le client ne doit pas effectuer de nouvelle tentative tant que l'état du système n'a pas été explicitement corrigé. Par exemple, si un "rmdir" échoue parce que le répertoire n'est pas vide, FAILED_PRECONDITION doit être affiché car le client ne doit pas réessayer sauf si les fichiers sont supprimés du répertoire.

Mise en correspondance HTTP : 400 Requête incorrecte

ABORTED

L'opération a été abandonnée, généralement en raison d'un problème de simultanéité, tel qu'un échec de vérification du séquenceur ou un abandon de transaction.

Consultez les instructions ci-dessus pour choisir entre FAILED_PRECONDITION, ABORTED et UNAVAILABLE.

Mise en correspondance HTTP : 409 Conflit

OUT_OF_RANGE

L'opération a été tentée au-delà de la plage valide. Par exemple, rechercher ou lire après la fin du fichier.

Contrairement à INVALID_ARGUMENT, cette erreur indique un problème pouvant être résolu si l'état du système change. Par exemple, un système de fichiers 32 bits génère INVALID_ARGUMENT s'il est invité à lire avec un décalage qui n'est pas compris dans la plage [0,2^32-1], mais génère OUT_OF_RANGE s'il est invité à lire avec un décalage qui dépasse la taille du fichier actuel.

Il existe des cas où FAILED_PRECONDITION et OUT_OF_RANGE se chevauchent. Nous vous recommandons d'utiliser OUT_OF_RANGE (l'erreur la plus spécifique) lorsque celle-ci s'applique afin que les appelants qui itèrent dans un espace puissent facilement rechercher une erreur OUT_OF_RANGE pour détecter le moment où ils ont terminé.

Mise en correspondance HTTP : 400 Requête incorrecte

UNIMPLEMENTED

L'opération n'est pas implémentée ou n'est pas prise en charge/activée dans ce service.

Mise en correspondance HTTP : 501 Non implémenté

INTERNAL

Erreurs internes. Cela signifie que certains invariants attendus par le système sous-jacent n'ont pas été respectés. Ce code d'erreur est réservé aux erreurs graves.

Mise en correspondance HTTP : 500 Erreur de serveur interne

UNAVAILABLE

Le service est actuellement indisponible. Il s'agit probablement d'une condition temporaire qui peut être corrigée en réessayant après avoir laissé passer un intervalle entre les tentatives. Notez qu'il n'est pas toujours sûr de relancer des opérations non idempotentes.

Consultez les instructions ci-dessus pour choisir entre FAILED_PRECONDITION, ABORTED et UNAVAILABLE.

Mise en correspondance HTTP : 503 Service non disponible

DATA_LOSS

Perte ou corruption de données irrécupérable.

Mise en correspondance HTTP : 500 Erreur de serveur interne

UpdatedWidget

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

Représentation JSON
{
  "widget": string,

  // Union field updated_widget can be only one of the following:
  "suggestions": {
    object (SelectionItems)
  }
  // End of list of possible types for union field updated_widget.
}
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

object (SelectionItems)

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

SelectionItems

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

Représentation JSON
{
  "items": [
    {
      object (SelectionItem)
    }
  ]
}
Champs
items[]

object (SelectionItem)

Tableau des objets SelectionItem.

SlashCommand

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

Représentation JSON
{
  "commandId": string
}
Champs
commandId

string (int64 format)

ID de la commande à barre oblique.

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.

Représentation JSON
{
  "url": string
}
Champs
url

string

Uniquement en sortie. URL correspondante.

EmojiReactionSummary

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

Représentation JSON
{
  "emoji": {
    object (Emoji)
  },
  "reactionCount": integer
}
Champs
emoji

object (Emoji)

Uniquement en sortie. Emoji associé aux réactions.

reactionCount

integer

Uniquement en sortie. Nombre total de réactions utilisant l'emoji associé.

DeletionMetadata

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

Représentation JSON
{
  "deletionType": enum (DeletionType)
}
Champs
deletionType

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

QuotedMessageMetadata

Informations sur un message cité.

Représentation JSON
{
  "name": string,
  "lastUpdateTime": string
}
Champs
name

string

Uniquement en sortie. Nom de ressource du message cité.

Format : spaces/{space}/messages/{message}

lastUpdateTime

string (Timestamp format)

Uniquement en sortie. Code temporel de la création ou de la dernière mise à jour du message cité.

AttachedGif

Image GIF spécifiée par une URL.

Représentation JSON
{
  "uri": string
}
Champs
uri

string

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

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.

Représentation JSON
{

  // Union field action can be only one of the following:
  "buttonList": {
    object (ButtonList)
  }
  // End of list of possible types for union field action.
}
Champs
Champ d'union action. Type d'action. action ne peut être qu'un des éléments suivants :
buttonList

object (ButtonList)

Liste de boutons.

Méthodes

create

crée un message dans un espace Google Chat ;

delete

Supprime un message.

get

Renvoie des informations sur un message.

list

Liste les messages d'un espace dont l'appelant est membre, y compris les messages des membres et espaces bloqués.

patch

Met à jour un message.

update

Met à jour un message.