Method: users.messages.modify

Modifie les libellés du message spécifié.

Requête HTTP

POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/{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 message à 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 ID des libellés à ajouter à ce message. Vous pouvez ajouter jusqu'à 100 libellés à chaque mise à jour.
removeLabelIds[]

string

Liste des ID des libellés à supprimer de ce message. Vous pouvez supprimer jusqu'à 100 libellés à chaque mise à jour.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Message.

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 d'autorisation.