rocket
Meet
Merchant API
- the official successor to Content API for Shopping.
update
Get the latest
on new Merchant API features, bug fixes, and updates.
add_alert
Note: Content API for Shopping will be sunset on August 18, 2026.
REST Resource: accounts.labels
Stay organized with collections
Save and categorize content based on your preferences.
Resource: AccountLabel
Label assigned by CSS domain or CSS group to one of its sub-accounts.
| JSON representation |
{
"labelId": string,
"accountId": string,
"name": string,
"description": string,
"labelType": enum (LabelType)
} |
| Fields |
labelId |
string (int64 format)
Output only. The ID of the label.
|
accountId |
string (int64 format)
Immutable. The ID of account this label belongs to.
|
name |
string
The display name of this label.
|
description |
string
The description of this label.
|
labelType |
enum (LabelType)
Output only. The type of this label.
|
LabelType
| Enums |
LABEL_TYPE_UNSPECIFIED |
Unknown label type. |
MANUAL |
Indicates that the label was created manually. |
AUTOMATIC |
Indicates that the label was created automatically by CSS Center. |
Methods |
|
|
Creates a new label, not assigned to any account. |
|
|
Deletes a label and removes it from all accounts to which it was assigned. |
|
|
Lists the labels assigned to an account. |
|
|
Updates a label. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-02-25 UTC.
[null,null,["Last updated 2025-02-25 UTC."],[[["\u003cp\u003eAccountLabel is a label assigned by CSS domain or CSS group to its sub-accounts, represented in JSON format.\u003c/p\u003e\n"],["\u003cp\u003eLabels can be of type MANUAL or AUTOMATIC, indicating creation method.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage AccountLabels with methods to create, delete, list, and update them.\u003c/p\u003e\n"],["\u003cp\u003eKey AccountLabel fields include labelId, accountId, name, description, and labelType.\u003c/p\u003e\n"]]],["Account labels, assigned by a CSS domain or group to sub-accounts, are defined by `labelId`, `accountId`, `name`, `description`, and `labelType`. Labels can be `MANUAL` or `AUTOMATIC`. Key actions include: creating new labels, deleting labels and removing them from accounts, listing labels assigned to a specified account, and updating existing labels. The `labelType` is an output only field. Each label has an unique string identifier.\n"],null,["# REST Resource: accounts.labels\n\n- [Resource: AccountLabel](#AccountLabel)\n - [JSON representation](#AccountLabel.SCHEMA_REPRESENTATION)\n- [LabelType](#LabelType)\n- [Methods](#METHODS_SUMMARY)\n\nResource: AccountLabel\n----------------------\n\nLabel assigned by CSS domain or CSS group to one of its sub-accounts.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"labelId\": string, \"accountId\": string, \"name\": string, \"description\": string, \"labelType\": enum (/shopping-content/reference/rest/v2.1/accounts.labels#LabelType) } ``` |\n\n| Fields ||\n|---------------|-----------------------------------------------------------------------------------------------------------------------------------------|\n| `labelId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. The ID of the label. |\n| `accountId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Immutable. The ID of account this label belongs to. |\n| `name` | `string` The display name of this label. |\n| `description` | `string` The description of this label. |\n| `labelType` | `enum (`[LabelType](/shopping-content/reference/rest/v2.1/accounts.labels#LabelType)`)` Output only. The type of this label. |\n\nLabelType\n---------\n\nThe label type.\n\n| Enums ||\n|--------------------------|-------------------------------------------------------------------|\n| `LABEL_TYPE_UNSPECIFIED` | Unknown label type. |\n| `MANUAL` | Indicates that the label was created manually. |\n| `AUTOMATIC` | Indicates that the label was created automatically by CSS Center. |\n\n| Methods ------- ||\n|----------------------------------------------------------------------------|----------------------------------------------------------------------------|\n| ### [create](/shopping-content/reference/rest/v2.1/accounts.labels/create) | Creates a new label, not assigned to any account. |\n| ### [delete](/shopping-content/reference/rest/v2.1/accounts.labels/delete) | Deletes a label and removes it from all accounts to which it was assigned. |\n| ### [list](/shopping-content/reference/rest/v2.1/accounts.labels/list) | Lists the labels assigned to an account. |\n| ### [patch](/shopping-content/reference/rest/v2.1/accounts.labels/patch) | Updates a label. |"]]