Method: users.messages.modify

Modifica le etichette del messaggio specificato.

Richiesta HTTP

POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/{id}/modify

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
userId

string

L'indirizzo email dell'utente. È possibile utilizzare il valore speciale me per indicare l'utente autenticato.

id

string

L'ID del messaggio da modificare.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "addLabelIds": [
    string
  ],
  "removeLabelIds": [
    string
  ]
}
Campi
addLabelIds[]

string

Un elenco di ID di etichette da aggiungere a questo messaggio. Puoi aggiungere fino a 100 etichette a ogni aggiornamento.

removeLabelIds[]

string

Un elenco di ID di etichette da rimuovere da questo messaggio. Puoi rimuovere fino a 100 etichette a ogni aggiornamento.

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://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify

Per ulteriori informazioni, consulta la Guida alle autorizzazioni.