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 afficher les messages.
metadataHeaders[]

string

Si cette option est fournie et que le format 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

Pour en savoir plus, consultez le guide sur les autorisations.

Format

Enums
full Renvoie l'intégralité des données d'e-mail dont le contenu du corps a été analysé dans le champ payload. Le champ raw n'est pas utilisé. Impossible d'utiliser le format lorsque vous accédez à l'API avec le champ d'application gmail.metadata.
metadata Affiche uniquement les ID, les libellés et les en-têtes d'e-mails.
minimal Affiche uniquement les ID et les libellés d'e-mails, ni les en-têtes, le corps ou la charge utile de l'e-mail.