Method: spaces.messages.patch
Aggiorna un messaggio. Esiste una differenza tra i metodi patch
e update
. Il metodo patch
utilizza una richiesta patch
, mentre il metodo update
utilizza una richiesta put
. Ti consigliamo di utilizzare il metodo patch
. Per un esempio, vedi Aggiornare un messaggio.
Supporta i seguenti tipi di autenticazione:
Quando utilizzi l'autenticazione dell'app, le richieste possono aggiornare solo i messaggi creati dall'app Chat chiamante.
Richiesta HTTP
PATCH https://chat.googleapis.com/v1/{message.name=spaces/*/messages/*}
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri |
message.name |
string
Identificatore. Nome della risorsa del messaggio. Formato: spaces/{space}/messages/{message} dove {space} è l'ID dello spazio in cui viene pubblicato il messaggio e {message} è un ID assegnato dal sistema al messaggio. Ad esempio: spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB . Se imposti un ID personalizzato quando crei un messaggio, puoi utilizzarlo per specificare il messaggio in una richiesta sostituendo {message} con il valore del campo clientAssignedMessageId . Ad esempio: spaces/AAAAAAAAAAA/messages/client-custom-name . Per maggiori dettagli, vedi Assegnare un nome a un messaggio.
|
Parametri di query
Parametri |
updateMask |
string (FieldMask format)
Obbligatorio. I percorsi dei campi da aggiornare. Separa più valori con virgole o utilizza * per aggiornare tutti i percorsi dei campi. Percorsi dei campi attualmente supportati:
|
allowMissing |
boolean
(Facoltativo) Se true e il messaggio non vengono trovati, viene creato un nuovo messaggio e updateMask viene ignorato. L'ID messaggio specificato deve essere client-assigned, altrimenti la richiesta non va a buon fine.
|
Corpo della richiesta
Il corpo della richiesta contiene un'istanza di Message
.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di Message
.
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/chat.bot
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.messages
Per ulteriori informazioni, consulta la Guida all'autorizzazione.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2024-11-04 UTC.
[null,null,["Ultimo aggiornamento 2024-11-04 UTC."],[[["Updates a Google Chat message using the `PATCH` method, preferably over the `update` method which uses `PUT`."],["Supports both app and user authentication, with app authentication limited to updating messages created by the calling Chat app."],["Requires specifying the message to update using its resource name in the URL path and the fields to update using the `updateMask` query parameter."],["Allows creation of a new message if the original is not found when `allowMissing` query parameter is set to `true` and a client-assigned message ID is provided."],["Requires authorization with one of the specified OAuth scopes (`chat.bot`, `chat.import`, or `chat.messages`)."]]],["This documentation outlines how to update a message using the `PATCH` method via an HTTP request to `https://chat.googleapis.com/v1/{message.name=spaces/*/messages/*}`. The `message.name` path parameter is required, specifying the message's resource name. The `updateMask` query parameter is mandatory, indicating which fields to update (e.g., text, attachments). Optionally, `allowMissing` creates a new message if one isn't found. The request and response bodies utilize the `Message` resource, and app or user authentication are supported, with specific authentication impacting permissions.\n"]]