type ListStringCreativeTemplateVariable (v202408)
Stay organized with collections
Save and categorize content based on your preferences.
Service
CreativeTemplateService
Represents a list variable defined in a creative template. This is
similar to StringCreativeTemplateVariable, except
that there are possible choices to choose from.
Use StringCreativeTemplateVariableValue to
specify the value for this variable when creating a
TemplateCreative from a CreativeTemplate.
- Namespace
-
https://www.google.com/apis/ads/publisher/v202408
Field
|
CreativeTemplateVariable (inherited)
|
label
|
xsd:string
Label that is displayed to users when creating TemplateCreative from the
CreativeTemplate. This attribute is required and has a maximum
length of 127 characters.
|
uniqueName
|
xsd:string
Unique name used to identify the variable. This attribute is read-only and
is assigned by Google, by deriving from label, when a creative template
variable is created.
|
description
|
xsd:string
A descriptive help text that is displayed to users along with the
label. This attribute is required and has a maximum length of 255 characters.
|
isRequired
|
xsd:boolean
true if this variable is required to be filled in by users when
creating TemplateCreative from the CreativeTemplate.
|
StringCreativeTemplateVariable (inherited)
|
defaultValue
|
xsd:string
Default value to be filled in when creating creatives from the creative
template.
|
ListStringCreativeTemplateVariable
|
choices
|
ListStringCreativeTemplateV...[]
The values within the list users need to select from.
|
allowOtherChoice
|
xsd:boolean
true if a user can specifiy an 'other' value.
For example, if a variable called backgroundColor is defined as a list
with values: red, green, blue, this boolean can be set to allow a user
to enter a value not on the list such as purple.
|
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."],[[["\u003cp\u003eListStringCreativeTemplateVariable represents a list variable within a creative template, offering predefined choices for users to select when creating TemplateCreatives.\u003c/p\u003e\n"],["\u003cp\u003eIt inherits properties from StringCreativeTemplateVariable and CreativeTemplateVariable, such as label, uniqueName, description, isRequired, and defaultValue.\u003c/p\u003e\n"],["\u003cp\u003eUsers can select from predefined choices specified in the \u003ccode\u003echoices\u003c/code\u003e field or input an 'other' value if \u003ccode\u003eallowOtherChoice\u003c/code\u003e is enabled.\u003c/p\u003e\n"],["\u003cp\u003eThis variable type aids in streamlining the creative creation process by providing standardized options for specific template elements.\u003c/p\u003e\n"],["\u003cp\u003eThe namespace for this object is \u003ccode\u003ehttps://www.google.com/apis/ads/publisher/v202408\u003c/code\u003e.\u003c/p\u003e\n"]]],["The content details `ListStringCreativeTemplateVariable`, a component within `CreativeTemplateService`. This variable type offers a predefined list of `choices` for users to select when creating a `TemplateCreative`. It inherits properties like `label`, `uniqueName`, `description`, `isRequired` from `CreativeTemplateVariable`, and `defaultValue` from `StringCreativeTemplateVariable`. Users can also input their own choice, if `allowOtherChoice` is set to `true`. When a user is creating a `TemplateCreative`, the `StringCreativeTemplateVariableValue` is used to define this variable.\n"],null,["# type ListStringCreativeTemplateVariable (v202408)\n\n**Service** \n**CreativeTemplateService** **Inheritance** \n[CreativeTemplateVariable](/ad-manager/api/reference/v202408/CreativeTemplateService.CreativeTemplateVariable) \n▼\n[StringCreativeTemplateVariable](/ad-manager/api/reference/v202408/CreativeTemplateService.StringCreativeTemplateVariable) \n▼\n**ListStringCreativeTemplateV...**\n\n\nRepresents a list variable defined in a creative template. This is\nsimilar to [StringCreativeTemplateVariable](/ad-manager/api/reference/v202408/CreativeTemplateService.StringCreativeTemplateVariable), except\nthat there are possible choices to choose from.\n\nUse [StringCreativeTemplateVariableValue](/ad-manager/api/reference/v202408/CreativeService.StringCreativeTemplateVariableValue) to\nspecify the value for this variable when creating a\n[TemplateCreative](/ad-manager/api/reference/v202408/CreativeService.TemplateCreative) from a [CreativeTemplate](/ad-manager/api/reference/v202408/CreativeTemplateService.CreativeTemplate).\n\n*** ** * ** ***\n\nNamespace\n:\n `https://www.google.com/apis/ads/publisher/v202408`\n\n| Field ----- ||\n|------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **`CreativeTemplateVariable` (inherited)** ||\n| ### `label` | ` `xsd:`string` Label that is displayed to users when creating [TemplateCreative](/ad-manager/api/reference/v202408/CreativeService.TemplateCreative) from the [CreativeTemplate](/ad-manager/api/reference/v202408/CreativeTemplateService.CreativeTemplate). This attribute is required and has a maximum length of 127 characters. |\n| ### `uniqueName` | ` `xsd:`string` Unique name used to identify the variable. This attribute is read-only and is assigned by Google, by deriving from label, when a creative template variable is created. |\n| ### `description` | ` `xsd:`string` A descriptive help text that is displayed to users along with the label. This attribute is required and has a maximum length of 255 characters. |\n| ### `isRequired` | ` `xsd:`boolean` `true` if this variable is required to be filled in by users when creating [TemplateCreative](/ad-manager/api/reference/v202408/CreativeService.TemplateCreative) from the [CreativeTemplate](/ad-manager/api/reference/v202408/CreativeTemplateService.CreativeTemplate). |\n| **`StringCreativeTemplateVariable` (inherited)** ||\n| ### `defaultValue` | ` `xsd:`string` Default value to be filled in when creating creatives from the creative template. |\n| **`ListStringCreativeTemplateVariable`** ||\n| ### `choices` | ` `[ListStringCreativeTemplateV...](/ad-manager/api/reference/v202408/CreativeTemplateService.ListStringCreativeTemplateVariable.VariableChoice \"ListStringCreativeTemplateVariable.VariableChoice\")`[]` The values within the list users need to select from. |\n| ### `allowOtherChoice` | ` `xsd:`boolean` `true` if a user can specifiy an 'other' value. For example, if a variable called backgroundColor is defined as a list with values: red, green, blue, this boolean can be set to allow a user to enter a value not on the list such as purple. |"]]