REST Resource: spaces.messages

{
  "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)
    }
  ],
  "deletionMetadata": {
    object (DeletionMetadata)
  },
  "quotedMessageMetadata": {
    object (QuotedMessageMetadata)
  },
  "attachedGifs": [
    {
      object (AttachedGif)
    }
  ]
}

string

Nom de la ressource au format spaces/*/messages/*.

Exemple : spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB

object (User)

Uniquement en sortie. Utilisateur ayant créé le message. Si votre application Chat s'authentifie en tant qu'utilisateur, la sortie renseigne les champs utilisateur name et type.

string (Timestamp format)

Pour les espaces créés dans Chat, il s'agit de la date et de l'heure de création du message. Ce champ n'est affiché qu'en sortie, sauf lorsqu'il est utilisé dans des espaces importés.

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.

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.

string

Corps en texte brut du message. Le premier lien vers une image, une vidéo ou une page Web génère un chip de prévisualisation. Vous pouvez également @mentionner un utilisateur de Google Chat ou tous les membres de l'espace.

Pour en savoir plus sur la création de messages, consultez Envoyer un SMS.

string

Uniquement en sortie. Contient le message text avec des balisages ajoutés pour communiquer la mise en forme. Il se peut que ce champ ne capture pas toute la mise en forme visible dans l'interface utilisateur, mais il inclut les éléments suivants:

• Syntaxe de balisage pour les formats gras, italique, barré, à chasse fixe et à chasse fixe.

• Mentions des utilisateurs au format <users/{user}>.

• Liens hypertextes 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 les emoji souriants.

Pour en savoir plus, consultez Afficher la mise en forme du texte envoyé dans un message.

object (Card)

Obsolète: utilisez plutôt cardsV2.

Des fiches 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 sont généralement affichées sous le corps en texte brut du message. La taille maximale de cards et cardsV2 est de 32 Ko.

object (CardWithId)

Un tableau de fiches

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 en savoir plus sur les fiches et apprendre à en créer, consultez Concevoir des interfaces utilisateur dynamiques, interactives et cohérentes avec des fiches.

object (Annotation)

Uniquement en sortie. Annotations associées à l'élément text dans ce message.

object (Thread)

Fil de discussion auquel le message appartient. Pour obtenir des exemples d'utilisation, consultez Démarrer un fil de discussion ou y répondre.

object (Space)

Si votre application Chat s'authentifie en tant qu'utilisateur, la sortie est insérée dans l'espace name.

string

Description en texte brut des cartes du message, utilisée lorsque les cartes ne peuvent pas être affichées (par exemple, les notifications mobiles).

object (ActionResponse)

Uniquement en entrée. Paramètres qu'une application Chat peut utiliser pour configurer la manière dont sa réponse est publiée

string

Uniquement en sortie. Corps du message en texte brut où toutes les mentions de l'application Chat ont été supprimées.

object (SlashCommand)

Uniquement en sortie. Informations sur la commande Slash, le cas échéant.

object (Attachment)

Pièce jointe importée par un utilisateur.

object (MatchedUrl)

Uniquement en sortie. URL dans spaces.messages.text qui correspond à un format d'aperçu de lien. Pour en savoir plus, consultez Prévisualiser les liens.

boolean

Uniquement en sortie. Lorsque la valeur est true, le message est une réponse dans un fil de discussion de réponse. Lorsque la valeur est false, le message est visible dans la conversation racine de l'espace en tant que premier message d'un fil de discussion ou en tant que message sans réponses organisées en fils de discussion.

Si l'espace n'accepte pas les réponses dans les fils de discussion, la valeur de ce champ est toujours false.

string

Nom personnalisé attribué lors de la création d'un message Chat. Le nom doit commencer par client-. Il ne doit pas contenir plus de 63 caractères. Il ne peut contenir que des lettres minuscules, des chiffres et des traits d'union. Spécifiez ce champ pour obtenir, mettre à jour ou supprimer le message avec la valeur spécifiée. L'attribution d'un nom personnalisé permet à une application Chat de rappeler le message sans enregistrer le message name dans le corps de la réponse renvoyé lors de sa création. Attribuer un nom personnalisé ne remplace pas le champ name généré, qui est le nom de ressource du message. Au lieu de cela, le nom personnalisé est défini comme le champ clientAssignedMessageId, auquel vous pouvez faire référence lors d'opérations ultérieures, telles que la mise à jour ou la suppression du message. Pour obtenir des exemples d'utilisation, consultez Nommer un message créé.

object (EmojiReactionSummary)

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

object (DeletionMetadata)

Uniquement en sortie. Informations sur un message supprimé. Un message est supprimé lorsque la règle deleteTime est définie.

object (QuotedMessageMetadata)

Uniquement en sortie. Informations sur un message cité par un utilisateur de Google Chat dans un espace. Les utilisateurs de Google Chat peuvent citer un message pour y répondre.

object (AttachedGif)

Uniquement en sortie. Images GIF jointes au message

{
  "cardId": string,
  "card": {
    object (Card)
  }
}

string

Obligatoire si le message contient plusieurs fiches. Identifiant unique d'une carte dans un message.

object (Card)

Une fiche La taille maximale est de 32 Ko.

{
  "type": enum (AnnotationType),
  "length": integer,
  "startIndex": integer,

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

enum (AnnotationType)

Type de cette annotation.

integer

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

integer

Index de début (compris en base 0) dans le corps du message en texte brut auquel cette annotation correspond.

object (UserMentionMetadata)

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

object (SlashCommandMetadata)

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

{
  "user": {
    object (User)
  },
  "type": enum (Type)
}

object (User)

L'utilisateur mentionné.

enum (Type)

Type de mention de l'utilisateur.

{
  "bot": {
    object (User)
  },
  "type": enum (Type),
  "commandName": string,
  "commandId": string,
  "triggersDialog": boolean
}

object (User)

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

enum (Type)

Type de commande à barre oblique.

string

Nom de la commande à barre oblique appelée.

string (int64 format)

ID de commande de la commande à barre oblique appelée.

boolean

Indique si la commande à barre oblique est destinée à une boîte de dialogue.

{
  "name": string,
  "threadKey": string
}

string

Uniquement en sortie. Nom de ressource du thread.

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

string

Facultatif. Entrée pour créer ou mettre à jour un thread. Sinon, sortie uniquement. ID du fil de discussion. 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 avec la même clé de fil de discussion, les messages sont publiés dans des fils de discussion différents. Pour répondre dans un fil de discussion créé par une personne ou une autre application Chat, spécifiez plutôt le champ name du fil de discussion.

{
  "type": enum (ResponseType),
  "url": string,
  "dialogAction": {
    object (DialogAction)
  },
  "updatedWidget": {
    object (UpdatedWidget)
  }
}

enum (ResponseType)

Uniquement en entrée. Type de réponse de l'application Chat.

string

Uniquement en entrée. URL permettant aux utilisateurs de s'authentifier ou de configurer. (uniquement pour les types de réponse REQUEST_CONFIG).

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.

object (UpdatedWidget)

Uniquement en entrée. Réponse du widget mis à jour.

{
  "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.
}

object (ActionStatus)

Uniquement en entrée. État d'une requête permettant d'appeler ou d'envoyer une boîte de dialogue. Affiche un état et un message aux utilisateurs, si nécessaire. (par exemple, en cas d'erreur ou de réussite).

object (Dialog)

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

{
  "body": {
    object (Card)
  }
}

object (Card)

Uniquement en entrée. Corps de la boîte de dialogue, affiché dans une fenêtre modale. Les applications Google Chat ne sont pas compatibles avec les entités de carte suivantes: DateTimePicker et OnChangeAction.

{
  "statusCode": enum (Code),
  "userFacingMessage": string
}

enum (Code)

Code d'état.

string

Message à envoyer aux utilisateurs sur l'état de leur demande. Si cette règle n'est pas configurée, un message générique basé sur la valeur statusCode est envoyé.

{
  "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.
}

string

ID du widget mis à jour. L'ID doit correspondre à celui du widget qui a déclenché la requête de mise à jour.

object (SelectionItems)

Liste des résultats de la saisie semi-automatique des widgets

{
  "items": [
    {
      object (SelectionItem)
    }
  ]
}

object (SelectionItem)

Tableau des objets SelectionItem.

{
  "commandId": string
}

string (int64 format)

ID de la commande à barre oblique appelée.

{
  "url": string
}

string

Uniquement en sortie. URL qui a été mise en correspondance.

{
  "emoji": {
    object (Emoji)
  },
  "reactionCount": integer
}

object (Emoji)

Emoji associé aux réactions.

integer

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

{
  "deletionType": enum (DeletionType)
}

enum (DeletionType)

Indique qui a supprimé le message.

{
  "name": string,
  "lastUpdateTime": string
}

string

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

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

string (Timestamp format)

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

{
  "uri": string
}

string

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