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, l'heure à laquelle le message a été créé. Ce champ est uniquement 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. L'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 d'aperçu. Vous pouvez également @mentionner un utilisateur de Google Chat ou tous les membres de l'espace.

Pour savoir comment créer des SMS, consultez Envoyer un SMS.

string

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

• Syntaxe de balisage pour les blocs en gras, en italique, barré, à chasse fixe et à chasse fixe.
• Mentions des utilisateurs au format <users/{user}>.
• 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, tels que U+1F600 pour les emojis 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 du texte formaté, 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)

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 cartes et comment les créer, consultez Concevoir des interfaces utilisateur dynamiques, interactives et cohérentes à l'aide de cartes.

object (Annotation)

Uniquement en sortie. Annotations associées à 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 renseigne l'espace name.

string

Description en texte brut des cartes associées au 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 de 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 sans aucune mention de l'application Chat.

object (SlashCommand)

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

object (Attachment)

Pièce jointe importée par l'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 sous forme de fils de discussion.

Si l'espace ne permet pas de répondre dans un fil de discussion, la valeur de ce champ est toujours false.

string

Nom personnalisé attribué à un message Chat lors de sa création Le nom doit commencer par client- et ne contenir que des lettres minuscules, des chiffres et des traits d'union. Il ne doit pas dépasser 63 caractères. 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 l'enregistrer name dans le corps de la réponse renvoyé lors de sa création. L'attribution d'un nom personnalisé ne remplace pas le champ name généré, qui correspond au nom de ressource du message. Au lieu de cela, il définit le nom personnalisé 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 sous forme d'emoji sur le message.

object (DeletionMetadata)

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

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 (de base 0, inclusif) 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)

Les 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 la commande à barre oblique appelée.

boolean

Indique si la commande à barre oblique est pour 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 permettant de créer ou de 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 d'appel ou d'envoi d'une boîte de dialogue. Affiche un état et un message pour les utilisateurs, si nécessaire. (par exemple, en cas d'erreur ou de réussite).

object (Dialog)

Uniquement en entrée. Dialog (Boîte de dialogue) pour 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 cartes 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 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 du widget

{
  "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 entre guillemets.

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.