- Requête HTTP
- Paramètres de chemin d'accès
- Paramètres de requête
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- MessageReplyOption
- Essayer
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 |
Obligatoire. Nom de ressource de l'espace dans lequel créer un message. Format : |
Paramètres de requête
Paramètres | |
---|---|
threadKey |
Facultatif. Obsolète: utilisez plutôt |
requestId |
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 |
Facultatif. Indique si un message démarre un fil de discussion ou y répond. Uniquement disponible dans les espaces nommés. |
messageId |
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 La valeur de ce champ doit répondre aux exigences suivantes:
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 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 . 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 . Si un nouveau threadKey est utilisé, un thread est créé. Si la création du message échoue, une erreur NOT_FOUND est renvoyée. |