Method: users.messages.modify

Ändert die Labels der angegebenen Nachricht.

HTTP-Anfrage

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

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.
id

string

Die ID der Nachricht, die geändert werden soll.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

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

string

Eine Liste der IDs der Labels, die dieser Nachricht hinzugefügt werden sollen. Bei jeder Aktualisierung können Sie bis zu 100 Labels hinzufügen.
removeLabelIds[]

string

Eine Liste mit IDs der Labels, die aus dieser Nachricht entfernt werden sollen. Bei jedem Update können Sie bis zu 100 Labels entfernen.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Message.

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.