Method: users.threads.get

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

Requête HTTP

GET https://gmail.googleapis.com/gmail/v1/users/{userId}/threads/{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

ID du thread à récupérer.

Paramètres de requête

Paramètres
format

enum (Format)

Format dans lequel renvoyer les messages.
metadataHeaders[]

string

Lorsqu'il est indiqué et au format MÉTADONNÉES, 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 Thread.

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.

Format

Enums
full Renvoie les données complètes des e-mails avec le contenu du corps analysé dans le champ payload. Le champ raw n'est pas utilisé. Le format ne peut pas être utilisé lors de l'accès à l'API avec le champ d'application "gmail.metadata".
metadata Renvoie uniquement les ID, les libellés et les en-têtes des e-mails.
minimal Renvoie uniquement les ID et les libellés des e-mails (ne renvoie pas les en-têtes, le corps ou la charge utile de l'e-mail).