enum AdUnitCodeError.Reason (v202508)

  • The AdUnitCodeError.Reason enumeration details various reasons why an ad unit code might be invalid.

  • Invalid characters in AdUnit.adUnitCode include restrictions based on whether UTF characters are allowed or if it's for a legacy Ad Exchange tag.

  • Leading forward slashes are not permitted in AdUnit.adUnitCode.

  • Certain codes matching the pattern ca-*pub-*-tag are reserved.

  • The UNKNOWN reason is used when the actual value is not available in the requested API version.
Service
ForecastService InventoryService PublisherQueryLanguageService
Dependencies
AdUnitCodeError
▼
AdUnitCodeError.Reason
Namespace
https://www.google.com/apis/ads/publisher/v202508
Enumeration Description
INVALID_CHARACTERS For AdUnit.adUnitCode, only alpha-numeric characters, underscores, hyphens, periods, asterisks, double quotes, back slashes, forward slashes, exclamations, left angle brackets, colons and parentheses are allowed.
INVALID_CHARACTERS_WHEN_UTF_CHARACTERS_ARE_ALLOWED For AdUnit.adUnitCode, only letters, numbers, underscores, hyphens, periods, asterisks, double quotes, back slashes, forward slashes, exclamations, left angle brackets, colons and parentheses are allowed.
INVALID_CHARACTERS_FOR_LEGACY_AD_EXCHANGE_TAG For AdUnit.adUnitCode representing slot codes, only alphanumeric characters, underscores, hyphens, periods and colons are allowed.
LEADING_FORWARD_SLASH For AdUnit.adUnitCode, forward slashes are not allowed as the first character.
RESERVED_CODE Specific codes matching ca-*pub-*-tag are reserved for "Web Property IUs" generated as part of the SlotCode migration.
UNKNOWN The value returned if the actual value is not exposed by the requested API version.