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.

Compatible avec les types d'authentification suivants :

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

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

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} à un ID attribué par le système au 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 d'accès des champs à mettre à jour. Séparez plusieurs valeurs par une virgule ou utilisez * pour mettre à jour tous les chemins d'accès des champs.

Chemins d'accès de champs actuellement acceptés:
allowMissing

boolean

Facultatif. Si true et le message ne sont pas trouvés, un nouveau message est créé et updateMask est ignoré. L'ID de message spécifié doit être client-assigned, 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.