Method: users.messages.batchModify

Ändert die Labels der angegebenen Nachrichten.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
userId

string

Die E-Mail-Adresse des Nutzers. Der spezielle Wert me kann verwendet werden, um den authentifizierten Nutzer anzugeben.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "ids": [
    string
  ],
  "addLabelIds": [
    string
  ],
  "removeLabelIds": [
    string
  ]
}
Felder
ids[]

string

Die IDs der Nachrichten, die geändert werden sollen. Pro Anfrage sind maximal 1.000 IDs zulässig.
addLabelIds[]

string

Eine Liste mit Label-IDs, die Nachrichten hinzugefügt werden sollen.
removeLabelIds[]

string

Eine Liste der Label-IDs, die aus Nachrichten entfernt werden sollen.

Antworttext

Wenn der Vorgang erfolgreich ist, ist der Antworttext leer.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.