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. Mit dem speziellen Wert me kann der authentifizierte Nutzer angegeben werden.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

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

string

Die IDs der zu ändernden Nachrichten. Pro Anfrage sind maximal 1.000 IDs zulässig.

addLabelIds[]

string

Eine Liste der IDs von Labels, 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.