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. Der spezielle Wert me kann verwendet werden, um den authentifizierten Nutzer anzugeben.
id

string

Die ID des Threads, der abgerufen werden soll.

Abfrageparameter

Parameter
format

enum (Format)

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

string

Wenn angegeben und das Format METADATA ist, werden nur die angegebenen Header eingeschlossen.

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 E-Mail-Nachrichtendaten mit dem im Feld payload geparsten Textkörper zurück. Das Feld raw wird nicht verwendet. Das Format kann nicht verwendet werden, wenn auf die API mit dem Gültigkeitsbereich „gmail.metadata“ zugegriffen wird.
metadata Es werden nur E-Mail-Nachrichten-IDs, Labels und E-Mail-Header zurückgegeben.
minimal Es werden nur E-Mail-Nachrichten-IDs und Labels zurückgegeben, nicht die E-Mail-Header, der E-Mail-Text oder die Nutzlast.