Method: users.messages.get

Ruft die angegebene Nachricht ab.

HTTP-Anfrage

GET https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/{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 der abzurufenden Nachricht. Diese ID wird normalerweise mit messages.list abgerufen. Die ID ist auch im Ergebnis enthalten, wenn eine Nachricht eingefügt (messages.insert) oder importiert (messages.import) wird.

Abfrageparameter

Parameter
format

enum (Format)

Das Format, in dem die Nachricht zurückgegeben werden soll.

metadataHeaders[]

string

Wenn angegeben 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 Message.

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.