Allows for the creation of labels to exclude competing ads from showing on
the same page.
AD_UNIT_FREQUENCY_CAP
Allows for the creation of limits on the frequency that a user sees a
particular type of creative over a portion of the inventory.
AD_EXCLUSION
Allows for the creation of labels to exclude ads from showing against a tag
that specifies the label as an exclusion.
CREATIVE_WRAPPER
Allows for the creation of labels that can be used to force the wrapping of
a delivering creative with header/footer creatives. These labels are
paired with a CreativeWrapper.
CANONICAL_CATEGORY
Allows for the creation of labels mapped to a Google canonical ad category, which can be used
for competitive exclusions and blocking across Google systems.
UNKNOWN
The value returned if the actual value is not exposed by the requested API
version.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-06 UTC."],[[["\u003cp\u003eLabels provide additional information that can be associated with entities in Google Ad Manager.\u003c/p\u003e\n"],["\u003cp\u003eA label has a unique ID, name, optional description, and status (active or inactive).\u003c/p\u003e\n"],["\u003cp\u003eLabels can be used for competitive exclusions, frequency capping, ad exclusions, creative wrapping, and canonical categorization.\u003c/p\u003e\n"],["\u003cp\u003eEach label can have one or more predefined types that determine its functionality.\u003c/p\u003e\n"],["\u003cp\u003eAd Manager assigns a read-only unique ID to each label upon creation.\u003c/p\u003e\n"]]],["The `LabelService` allows the creation and updating of `Label` entities. A `Label` contains data, such as a unique `id`, a required `name` (max 127 characters), an optional `description` (max 255 characters), and `isActive` status. Labels can be associated with an `AdCategory` and have defined `types`. Enumerated types include `COMPETITIVE_EXCLUSION`, `AD_UNIT_FREQUENCY_CAP`, `AD_EXCLUSION`, `CREATIVE_WRAPPER`, and `CANONICAL_CATEGORY`, each serving a different purpose in ad management.\n"],null,["# type Label (v202408)\n\n**Service** \n**LabelService** **Dependencies** \n[LabelPage](/ad-manager/api/reference/v202408/LabelService.LabelPage) [createLabels()](/ad-manager/api/reference/v202408/LabelService#createLabels) [updateLabels()](/ad-manager/api/reference/v202408/LabelService#updateLabels) \n▼\n**Label**\n\nA `Label` is additional information that can be added to an entity.\n\n*** ** * ** ***\n\nNamespace\n:\n `https://www.google.com/apis/ads/publisher/v202408`\n\n| Field ----- ||\n|-------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ### `id` | ` `xsd:`long` Unique ID of the `Label`. This value is readonly and is assigned by Google. |\n| ### `name` | ` `xsd:`string` Name of the `Label`. This is value is required to create a label and has a maximum length of 127 characters. |\n| ### `description` | ` `xsd:`string` A description of the label. This value is optional and its maximum length is 255 characters. |\n| ### `isActive` | ` `xsd:`boolean` Specifies whether or not the label is active. This attribute is read-only. |\n| ### `adCategory` | ` `[AdCategoryDto](/ad-manager/api/reference/v202408/LabelService.AdCategoryDto)` ` Indicates the Ad Category associated with the label. |\n| ### `types` | ` `[LabelType](/ad-manager/api/reference/v202408/LabelService.LabelType)`[]` The types of the `Label`. *** ** * ** *** **Enumerations** `COMPETITIVE_EXCLUSION` : Allows for the creation of labels to exclude competing ads from showing on the same page. `AD_UNIT_FREQUENCY_CAP` : Allows for the creation of limits on the frequency that a user sees a particular type of creative over a portion of the inventory. `AD_EXCLUSION` : Allows for the creation of labels to exclude ads from showing against a tag that specifies the label as an exclusion. `CREATIVE_WRAPPER` : Allows for the creation of labels that can be used to force the wrapping of a delivering creative with header/footer creatives. These labels are paired with a [CreativeWrapper](/ad-manager/api/reference/v202408/CreativeWrapperService.CreativeWrapper). `CANONICAL_CATEGORY` : Allows for the creation of labels mapped to a Google canonical ad category, which can be used for competitive exclusions and blocking across Google systems. `UNKNOWN` : The value returned if the actual value is not exposed by the requested API version. \u003cbr /\u003e |"]]
