Method: users.messages.batchModify

Modifie les libellés des messages spécifiés.

Requête HTTP

POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/batchModify

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é.

Corps de la requête

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

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

string

Identifiants des messages à modifier. Le nombre d'ID est limité à 1 000 par requête.

addLabelIds[]

string

Liste des ID de libellés à ajouter aux messages.

removeLabelIds[]

string

Liste des ID de libellés à supprimer des messages.

Corps de la réponse

Si la requête aboutit, le corps de la réponse est vide.

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.