Method: spaces.messages.patch

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.

Une authentification est requise. Il prend en charge l'authentification des applications et l'authentification des utilisateurs. 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

PATCH 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

Nom de ressource du message.

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

{space} est l'ID de l'espace dans lequel le message est publié et {message} est un ID attribué au message par le système. 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. Exemple :spaces/AAAAAAAAAAA/messages/client-custom-name Pour en savoir plus, consultez Attribuer un nom à un message.

Paramètres de requête

Paramètres
updateMask

string (FieldMask format)

Obligatoire. Chemins d'accès des champs à mettre à jour. Séparez les différentes valeurs par des virgules ou utilisez * pour mettre à jour tous les chemins d'accès aux champs.

Chemins d'accès des champs actuellement acceptés:

allowMissing

boolean

Facultatif. Si true et le message est introuvable, 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 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 relatif aux autorisations.