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 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.

Suchparameter

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

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
  • 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.