Method: spaces.messages.update

Met à jour un message. Il existe une différence entre les méthodes patch et update. La méthode patch utilise une requête patch, tandis que la méthode update utilise une requête put. Nous vous recommandons d'utiliser la méthode patch. Pour obtenir un exemple, consultez Mettre à jour un message.

Compatible avec les types d'authentification suivants :

  • Authentification par l'application avec le champ d'application de l'autorisation :

    • https://www.googleapis.com/auth/chat.bot

  • Authentification des utilisateurs avec l'un des champs d'application d'autorisation suivants :

    • https://www.googleapis.com/auth/chat.messages
    • https://www.googleapis.com/auth/chat.import (espaces en mode importation uniquement)

Lorsque vous utilisez l'authentification d'application, les requêtes ne peuvent mettre à jour que les messages créés par l'application Chat appelante.

Requête HTTP

PUT https://chat.googleapis.com/v1/{message.name=spaces/*/messages/*}

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
message.name

string

Identifiant. Nom de ressource du message.

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

Où {space} correspond à l'ID de l'espace dans lequel le message est publié et {message} à l'ID attribué par le système pour le message. Par exemple, spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB.

Si vous définissez un ID personnalisé lorsque vous créez un message, vous pouvez l'utiliser pour spécifier le message dans une requête en remplaçant {message} par la valeur du champ clientAssignedMessageId. Par exemple, spaces/AAAAAAAAAAA/messages/client-custom-name. Pour en savoir plus, consultez Nommer un message.

Paramètres de requête

Paramètres
updateMask

string (FieldMask format)

Obligatoire. Chemins des champs à mettre à jour. Séparez les valeurs multiples par des virgules ou utilisez * pour mettre à jour tous les chemins de champ.

Chemins de champ actuellement acceptés :
allowMissing

boolean

Facultatif. Si true et le message sont introuvables, un nouveau message est créé et updateMask est ignoré. L'ID de message spécifié doit être attribué par le client, sinon la requête échoue.

Corps de la requête

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

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une 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

Pour en savoir plus, consultez le guide d'autorisation.