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

Si la valeur est "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 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
  • 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

Pour plus d'informations, consultez la OAuth 2.0 Overview.

Format

Enums
full Renvoie les données complètes du message électronique avec le contenu du corps analysé dans le champ payload. Le champ raw n'est pas utilisé. Ce format ne peut pas être utilisé pour accéder à l'API avec le champ d'application gmail.metadata.
metadata Renvoie uniquement les ID de messages, les libellés et les en-têtes d'e-mails.
minimal Renvoie uniquement les ID et les libellés des messages électroniques. Ne renvoie pas les en-têtes, le corps ni la charge utile des e-mails.