Method: spaces.messages.create

Crée un message dans un espace Google Chat. La taille maximale des messages, textes et cartes compris, est de 32 000 octets. Pour obtenir un exemple, consultez Envoyer un message.

L'appel de cette méthode nécessite une authentification et est compatible avec les types d'authentification suivants:

  • Pour les SMS, l'authentification des utilisateurs ou l'authentification de l'application sont prises en charge.
  • Pour les messages de carte, seule l'authentification de l'application est prise en charge. (Seules les applications Chat peuvent créer des messages sous forme de fiches.)

Requête HTTP

POST https://chat.googleapis.com/v1/{parent=spaces/*}/messages

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Nom de ressource de l'espace dans lequel créer un message.

Format : spaces/{space}

Paramètres de requête

Paramètres
threadKey
(deprecated)

string

Facultatif. Obsolète: utilisez plutôt thread.thread_key. ID du fil de discussion. Jusqu'à 4 000 caractères. Pour démarrer un fil de discussion ou y ajouter des éléments, créez un message et spécifiez une threadKey ou une thread.name. Pour obtenir un exemple d'utilisation, consultez Démarrer un fil de discussion ou y répondre.
requestId

string

Facultatif. ID de requête unique pour ce message. Spécifier un ID de requête existant renvoie le message créé avec cet ID au lieu de créer un nouveau message.
messageReplyOption

enum (MessageReplyOption)

Facultatif. Indique si un message démarre un fil de discussion ou y répond. Uniquement disponible dans les espaces nommés.
messageId

string

Facultatif. ID personnalisé d'un message. Permet aux applications Chat de récupérer, de mettre à jour 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.
  • Il peut contenir jusqu'à 63 caractères. Il ne peut contenir que des lettres minuscules, des chiffres et des traits d'union.
  • est unique dans un espace ; Une application Chat ne peut pas utiliser le même ID personnalisé pour des messages différents.

Pour en savoir plus, consultez Attribuer un nom à un message.

Corps de la requête

Le corps de la requête contient une instance Message.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une nouvelle instance de Message.

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 relatif aux autorisations.

MessageReplyOption

Indique comment répondre à un message. D'autres états seront peut-être ajoutés à l'avenir.

Enums
MESSAGE_REPLY_OPTION_UNSPECIFIED Par défaut. Démarre un nouveau fil de discussion. Si vous utilisez cette option, toutes les thread ID ou threadKey incluses sont ignorées.
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD Crée le message en tant que réponse au fil de discussion spécifié par thread ID ou threadKey. En cas d'échec, le message lance un nouveau fil de discussion.
REPLY_MESSAGE_OR_FAIL Crée le message en tant que réponse au fil de discussion spécifié par thread ID ou threadKey. Si un nouveau threadKey est utilisé, un thread est créé. Si la création du message échoue, une erreur NOT_FOUND est renvoyée.