Method: users.threads.get

Récupère le fil de discussion 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 les messages doivent être renvoyés.
metadataHeaders[]

string

Si ce paramètre est spécifié 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 d'autorisation.

Format

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