type Label (v202505)
Stay organized with collections
Save and categorize content based on your preferences.
A Label is additional information that can be added to an entity.
- Namespace
-
https://www.google.com/apis/ads/publisher/v202505
Field
|
id
|
xsd:long
Unique ID of the Label. This value is readonly and is assigned by Google.
|
name
|
xsd:string
Name of the Label. This is value is required to create a label and has a maximum length
of 127 characters.
|
description
|
xsd:string
A description of the label. This value is optional and its maximum length is 255 characters.
|
isActive
|
xsd:boolean
Specifies whether or not the label is active. This attribute is read-only.
|
adCategory
|
AdCategoryDto
Indicates the Ad Category associated with the label.
|
types
|
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.
-
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.
|
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-08-06 UTC.
[null,null,["Last updated 2025-08-06 UTC."],[],[],null,["# type Label (v202505)\n\n**Service** \n**LabelService** **Dependencies** \n[LabelPage](/ad-manager/api/reference/v202505/LabelService.LabelPage) [createLabels()](/ad-manager/api/reference/v202505/LabelService#createLabels) [updateLabels()](/ad-manager/api/reference/v202505/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/v202505`\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/v202505/LabelService.AdCategoryDto)` ` Indicates the Ad Category associated with the label. |\n| ### `types` | ` `[LabelType](/ad-manager/api/reference/v202505/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/v202505/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 |"]]
