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 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 dieses Format angegeben ist und das Format METADATA 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 zurück, wobei der Text im Feld payload geparst wird. Das Feld raw wird nicht verwendet. Das Format kann beim Zugriff auf die API mit dem Bereich „gmail.metadata“ nicht verwendet werden.
metadata Gibt nur E-Mail-Nachrichten-IDs, -Labels und -E-Mail-Header zurück.
minimal Gibt nur die E-Mail-Nachrichten-IDs und -Labels zurück. Die Header, E-Mails oder Nutzlast werden nicht zurückgegeben.