Method: spaces.messages.update

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:

  • Autenticazione dell'app con l'ambito di autorizzazione:

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

  • Autenticazione utente con uno dei seguenti ambiti di autorizzazione:

    • https://www.googleapis.com/auth/chat.messages
    • https://www.googleapis.com/auth/chat.import (solo spazi in modalità di importazione)

Quando utilizzi l'autenticazione dell'app, le richieste possono aggiornare solo i messaggi creati dall'app di chat chiamante.

Richiesta HTTP

PUT 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 per il 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 le 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 assegnato dal client, altrimenti la richiesta non andrà 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.