Method: users.threads.modify

Modifie les libellés appliqués au thread. Cette sélection s'applique à tous les messages du fil de discussion.

Requête HTTP

POST https://gmail.googleapis.com/gmail/v1/users/{userId}/threads/{id}/modify

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 à modifier.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON
{
  "addLabelIds": [
    string
  ],
  "removeLabelIds": [
    string
  ]
}
Champs
addLabelIds[]

string

Liste des identifiants des libellés à ajouter à ce fil de discussion. Vous pouvez ajouter jusqu'à 100 étiquettes à chaque mise à jour.

removeLabelIds[]

string

Liste des identifiants des libellés à supprimer de ce fil de discussion. Vous pouvez supprimer jusqu'à 100 étiquettes à chaque mise à jour.

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

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