Google: Modifies the labels and the Classification Label values on the specified messages For administrators modifying messages for users in their organization, requests require authorization with a service account (https: developers google com identity protocols O Auth2 Service Account) that has domain-wide delegation authority (https: developers google com identity protocols O Auth2 Service Account#delegatingauthority) to impersonate users with the `https: www googleapis com auth gmail modify restricted` scope — request body — body
Modifies the labels and the Classification Label values on the specified messages. For administrators modifying messages for users in their organization, requests require authorization with a [service account](https://developers.google.com/identity/protocols/OAuth2ServiceAccount) that has [domain-wide delegation authority](https://developers.google.com/identity/protocols/OAuth2ServiceAccount#delegatingauthority) to impersonate users with the `https://www.googleapis.com/auth/gmail.modify.restricted` scope.: request body, field body. Complete fields and constraints for contract 2026-10-27.
API reference · Contract 2026-10-27
SDK schema: Modifies the labels and the Classification Label values on the specified messages For administrators modifying messages for users in their organization, requests require authorization with a service account (https: developers google com identity protocols O Auth2 Service Account) that has domain-wide delegation authority (https: developers google com identity protocols O Auth2 Service Account#delegatingauthority) to impersonate users with the `https: www googleapis com auth gmail modify restricted` scope — request body — body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
addClassificationLabels | array | Optional | A list of Classification Label values to add. If a Classification Label with the same label ID is already applied to the message, fields with existing field IDs will be updated and fields with new field IDs will be added. There’s a limit of 20 Classification Label values per request. If the message is already classified and the final total number of Classification Label values exceeds the maximum allowed number of Classification Label values per message, the modification fails. |
addClassificationLabels[] | Model | Each item | Expand Gets the specified message — response body — classification Label Values item |
addLabelIds | array | Optional | A list of label IDs to add to messages. |
addLabelIds[] | string | Each item | |
ids | array | Optional | The IDs of the messages to modify. There is a limit of 1000 ids per request. |
ids[] | string | Each item | |
removeClassificationLabelIds | array | Optional | A list of Classification Label values to remove from messages. |
removeClassificationLabelIds[] | string | Each item | |
removeLabelIds | array | Optional | A list of label IDs to remove from messages. |
removeLabelIds[] | string | Each item |
Referenced models: Gets the specified message — response body — classification Label Values item