Method: users.threads.get

Ruft den angegebenen Thread ab.

HTTP-Anfrage

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

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.

id

string

Die ID des abzurufenden Threads.

Abfrageparameter

Parameter
format

enum (Format)

Das Format, in dem die Nachrichten zurückgegeben werden sollen.

metadataHeaders[]

string

Wenn METADATEN angegeben und das Format METADATEN ist, dürfen nur Header angegeben werden.

Anfragetext

Der Anfragetext muss leer sein.

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
  • https://www.googleapis.com/auth/gmail.readonly
  • https://www.googleapis.com/auth/gmail.metadata

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.

Format

Enums
full Gibt die vollständigen Daten der E-Mail-Nachricht mit dem Textinhalt zurück, der im Feld payload geparst wurde. Das Feld raw wird nicht verwendet. Das Format kann beim Zugriff auf die API über den Bereich „gmail.metadata“ nicht verwendet werden.
metadata Gibt nur IDs, Labels und E-Mail-Header von E-Mail-Nachrichten zurück.
minimal Gibt nur E-Mail-Nachrichten-IDs und -Labels zurück; gibt nicht die E-Mail-Header, den Text oder die Nutzlast zurück