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 aCreativeWrapper.
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\u003eA \u003ccode\u003eLabel\u003c/code\u003e provides additional information that can be assigned to an entity in Google Ad Manager.\u003c/p\u003e\n"],["\u003cp\u003eLabels have properties like \u003ccode\u003ename\u003c/code\u003e, \u003ccode\u003edescription\u003c/code\u003e, and \u003ccode\u003etypes\u003c/code\u003e to categorize and manage them.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eLabel\u003c/code\u003e types include competitive exclusion, frequency capping, ad exclusion, creative wrappers, and canonical categories.\u003c/p\u003e\n"],["\u003cp\u003eLabels are uniquely identified by an \u003ccode\u003eid\u003c/code\u003e assigned by Google and can be activated or deactivated using the \u003ccode\u003eisActive\u003c/code\u003e field.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eLabelService\u003c/code\u003e enables the management of labels, including creation and updates.\u003c/p\u003e\n"]]],["The `LabelService` allows the creation and updating of `Label` entities, which are additional information added to entities. A `Label` has a unique `id`, a required `name` (max 127 chars), an optional `description` (max 255 chars), and an `isActive` status. It may be linked to an `AdCategory` and has multiple `types`. The supported types are `COMPETITIVE_EXCLUSION`, `AD_UNIT_FREQUENCY_CAP`, `AD_EXCLUSION`, `CREATIVE_WRAPPER`, and `CANONICAL_CATEGORY`, each serving a distinct purpose.\n"],null,["# type Label (v202411)\n\n**Service** \n**LabelService** **Dependencies** \n[LabelPage](/ad-manager/api/reference/v202411/LabelService.LabelPage) [createLabels()](/ad-manager/api/reference/v202411/LabelService#createLabels) [updateLabels()](/ad-manager/api/reference/v202411/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/v202411`\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/v202411/LabelService.AdCategoryDto)` ` Indicates the Ad Category associated with the label. |\n| ### `types` | ` `[LabelType](/ad-manager/api/reference/v202411/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/v202411/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 |"]]
