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

string

Die ID der Nachricht, die abgerufen werden soll. Diese ID wird in der Regel 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, 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 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.