Method: users.messages.get

Récupère le message spécifié.

Requête HTTP

GET https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/{id}

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
userId

string

Adresse e-mail de l'utilisateur. La valeur spéciale me peut être utilisée pour indiquer l'utilisateur authentifié.
id

string

Identifiant du message à récupérer. Cet ID est généralement récupéré à l'aide de messages.list. L'ID est également inclus dans le résultat lorsqu'un message est inséré (messages.insert) ou importé (messages.import).

Paramètres de requête

Paramètres
format

enum (Format)

Format dans lequel renvoyer le message.
metadataHeaders[]

string

Lorsque la valeur et le format sont METADATA, n'incluez que les en-têtes spécifiés.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Message.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • 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

Pour en savoir plus, consultez le guide relatif aux autorisations.