Google: Modifies the labels and the Classification Label values on the specified message For administrators modifying message 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 message. For administrators modifying message 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 message For administrators modifying message 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 IDs of labels to add to this message. You can add up to 100 labels with each update. |
addLabelIds[] | string | Each item | |
removeClassificationLabelIds | array | Optional | A list of Classification Label values to remove from this message. |
removeClassificationLabelIds[] | string | Each item | |
removeLabelIds | array | Optional | A list IDs of labels to remove from this message. You can remove up to 100 labels with each update. |
removeLabelIds[] | string | Each item |
Referenced models: Gets the specified message — response body — classification Label Values item