Method: users.threads.modify

Ändert die auf den Thread angewendeten Labels. Dies gilt für alle Nachrichten im Thread. Weitere Informationen finden Sie unter Threads verwalten.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
userId

string

Die E-Mail-Adresse des Nutzers. Mit dem Sonderwert me kann der authentifizierte Nutzer angegeben werden.
id

string

Die ID des zu ändernden Threads.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

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

string

Eine Liste der IDs von Labels, die diesem Thread hinzugefügt werden sollen. Mit jeder Aktualisierung können bis zu 100 Labels hinzugefügt werden.
removeLabelIds[]

string

Eine Liste der IDs von Labels, die aus diesem Thread entfernt werden sollen. Mit jeder Aktualisierung können bis zu 100 Labels entfernt werden.

Antworttext

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

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie im Autorisierungsleitfaden.