Method: users.messages.batchModify

Modifica le etichette sui messaggi specificati.

Richiesta HTTP

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

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.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

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

string

Gli ID dei messaggi da modificare. Esiste un limite di 1000 ID per richiesta.
addLabelIds[]

string

Un elenco di ID etichette da aggiungere ai messaggi.
removeLabelIds[]

string

Un elenco di ID etichette da rimuovere dai messaggi.

Corpo della risposta

In caso di esito positivo, il corpo della risposta è vuoto.

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.