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.

Suchparameter

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 berücksichtigt.

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

Format

Enums
full Gibt die vollständigen E‑Mail-Nachrichtendaten zurück, wobei der Inhalt des Nachrichtentexts im Feld payload analysiert wird. Das Feld raw wird nicht verwendet. Das Format kann nicht verwendet werden, wenn über den Bereich „gmail.metadata“ auf die API zugegriffen wird.
metadata Gibt nur E‑Mail-Nachrichten-IDs, Labels und E‑Mail-Header zurück.
minimal Gibt nur E‑Mail-Nachrichten-IDs und Labels zurück, nicht die E‑Mail-Header, den Text oder die Nutzlast.