Method: spaces.messages.create

crée un message ; Pour obtenir un exemple, consultez Créer un message.

Nécessite une authentification.

La création d'un SMS prend en charge l'authentification des utilisateurs et l'authentification des applications. L'authentification de l'utilisateur nécessite le champ d'application de l'autorisation chat.messages ou chat.messages.create.

La création d'un message de carte nécessite l'authentification de l'application.

Étant donné que Chat fournit une authentification pour les webhooks dans l'URL générée lors de l'enregistrement d'un webhook, les webhooks peuvent créer des messages sans compte de service ni authentification des utilisateurs.

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. Identifiant de thread opaque. Pour démarrer ou ajouter un fil de discussion, créez un message et spécifiez un threadKey ou un thread.name. Pour en savoir plus sur l'utilisation, consultez Créer un fil de discussion ou y répondre.
requestId

string

Facultatif. ID de demande unique pour ce message. Si vous spécifiez un ID de requête existant, le message créé avec cet ID s'affiche au lieu d'en créer un autre.
messageReplyOption

enum (MessageReplyOption)

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

string

Facultatif. Nom personnalisé d'un message Chat attribué lors de la création. Le nom doit commencer par client- et ne peut contenir que des lettres minuscules, des chiffres et des traits d'union d'une longueur maximale de 63 caractères. Spécifiez ce champ pour obtenir, mettre à jour ou supprimer le message avec la valeur spécifiée. Attribuer un nom personnalisé permet à une application de chat de rappeler le message sans l'enregistrer name à partir du 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é, le nom de ressource du message. Au lieu de cela, il définit le nom personnalisé comme champ clientAssignedMessageId, auquel vous pouvez vous référer lors du traitement des opérations ultérieures, comme la mise à jour ou la suppression du message. Pour obtenir un exemple d'utilisation, consultez Donner un nom au message créé.

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 sur les autorisations.

Option MessageRépondre

Indique 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 fil de discussion ;
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD Crée le message en réponse au fil de discussion spécifié par thread ID ou threadKey. En cas d'échec, le message démarre 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 threadKey. En cas d'échec, une erreur NOT_FOUND est renvoyée à la place.