Package google.ads.googleads.v0.errors

Index

AccountBudgetProposalErrorEnum

Container for enum describing possible account budget proposal errors.

AccountBudgetProposalError

Enum describing possible account budget proposal errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
FIELD_MASK_NOT_ALLOWED The field mask must be empty for create/end/remove proposals.
IMMUTABLE_FIELD The field cannot be set because of the proposal type.
REQUIRED_FIELD_MISSING The field is required because of the proposal type.
CANNOT_CANCEL_APPROVED_PROPOSAL Proposals that have been approved cannot be cancelled.
CANNOT_REMOVE_UNAPPROVED_BUDGET Budgets that haven't been approved cannot be removed.
CANNOT_REMOVE_RUNNING_BUDGET Budgets that are currently running cannot be removed.
CANNOT_END_UNAPPROVED_BUDGET Budgets that haven't been approved cannot be truncated.
CANNOT_END_INACTIVE_BUDGET Only budgets that are currently running can be truncated.
BUDGET_NAME_REQUIRED All budgets must have names.
CANNOT_UPDATE_OLD_BUDGET Expired budgets cannot be edited after a sufficient amount of time has passed.
CANNOT_END_IN_PAST It is not permissible a propose a new budget that ends in the past.
CANNOT_EXTEND_END_TIME An expired budget cannot be extended to overlap with the running budget.
PURCHASE_ORDER_NUMBER_REQUIRED A purchase order number is required.
PENDING_UPDATE_PROPOSAL_EXISTS Budgets that have a pending update cannot be updated.
MULTIPLE_BUDGETS_NOT_ALLOWED_FOR_UNAPPROVED_BILLING_SETUP Cannot propose more than one budget when the corresponding billing setup hasn't been approved.
CANNOT_UPDATE_START_TIME_FOR_STARTED_BUDGET Cannot update the start time of a budget that has already started.
SPENDING_LIMIT_LOWER_THAN_ACCRUED_COST_NOT_ALLOWED Cannot update the spending limit of a budget with an amount lower than what has already been spent.
UPDATE_IS_NO_OP Cannot propose a budget update without actually changing any fields.
END_TIME_MUST_FOLLOW_START_TIME The end time must come after the start time.
BUDGET_DATE_RANGE_INCOMPATIBLE_WITH_BILLING_SETUP The budget's date range must fall within the date range of its billing setup.
NOT_AUTHORIZED The user is not authorized to mutate budgets for the given billing setup.
INVALID_BILLING_SETUP Mutates are not allowed for the given billing setup.

AdCustomizerErrorEnum

Container for enum describing possible ad customizer errors.

AdCustomizerError

Enum describing possible ad customizer errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
COUNTDOWN_INVALID_DATE_FORMAT Invalid date argument in countdown function.
COUNTDOWN_DATE_IN_PAST Countdown end date is in the past.
COUNTDOWN_INVALID_LOCALE Invalid locale string in countdown function.
COUNTDOWN_INVALID_START_DAYS_BEFORE Days-before argument to countdown function is not positive.
UNKNOWN_USER_LIST A user list referenced in an IF function does not exist.

AdErrorEnum

Container for enum describing possible ad errors.

AdError

Enum describing possible ad errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
AD_CUSTOMIZERS_NOT_SUPPORTED_FOR_AD_TYPE Ad customizers are not supported for ad type.
APPROXIMATELY_TOO_LONG Estimating character sizes the string is too long.
APPROXIMATELY_TOO_SHORT Estimating character sizes the string is too short.
BAD_SNIPPET There is a problem with the snippet.
CANNOT_MODIFY_AD Cannot modify an ad.
CANNOT_SET_BUSINESS_NAME_IF_URL_SET business name and url cannot be set at the same time
CANNOT_SET_FIELD The specified field is incompatible with this ad's type or settings.
CANNOT_SET_FIELD_WITH_ORIGIN_AD_ID_SET Cannot set field when originAdId is set.
CANNOT_SET_FIELD_WITH_AD_ID_SET_FOR_SHARING Cannot set field when an existing ad id is set for sharing.
CANNOT_SET_ALLOW_FLEXIBLE_COLOR_FALSE Cannot set allowFlexibleColor false if no color is provided by user.
CANNOT_SET_COLOR_CONTROL_WHEN_NATIVE_FORMAT_SETTING When user select native, no color control is allowed because we will always respect publisher color for native format serving.
CANNOT_SET_URL Cannot specify a url for the ad type
CANNOT_SET_WITHOUT_FINAL_URLS Cannot specify a tracking or mobile url without also setting final urls
CANNOT_SET_WITH_FINAL_URLS Cannot specify a legacy url and a final url simultaneously
CANNOT_SET_WITH_TRACKING_URL_TEMPLATE Cannot specify a legacy url and a tracking url template simultaneously in a DSA.
CANNOT_SET_WITH_URL_DATA Cannot specify a urls in UrlData and in template fields simultaneously.
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR This operator cannot be used with a subclass of Ad.
CUSTOMER_NOT_APPROVED_MOBILEADS Customer is not approved for mobile ads.
CUSTOMER_NOT_APPROVED_THIRDPARTY_ADS Customer is not approved for 3PAS richmedia ads.
CUSTOMER_NOT_APPROVED_THIRDPARTY_REDIRECT_ADS Customer is not approved for 3PAS redirect richmedia (Ad Exchange) ads.
CUSTOMER_NOT_ELIGIBLE Not an eligible customer
CUSTOMER_NOT_ELIGIBLE_FOR_UPDATING_BEACON_URL Customer is not eligible for updating beacon url
DIMENSION_ALREADY_IN_UNION There already exists an ad with the same dimensions in the union.
DIMENSION_MUST_BE_SET Ad's dimension must be set before setting union dimension.
DIMENSION_NOT_IN_UNION Ad's dimension must be included in the union dimensions.
DISPLAY_URL_CANNOT_BE_SPECIFIED Display Url cannot be specified (applies to Ad Exchange Ads)
DOMESTIC_PHONE_NUMBER_FORMAT Telephone number contains invalid characters or invalid format. Please re-enter your number using digits (0-9), dashes (-), and parentheses only.
EMERGENCY_PHONE_NUMBER Emergency telephone numbers are not allowed. Please enter a valid domestic phone number to connect customers to your business.
EMPTY_FIELD A required field was not specified or is an empty string.
FEED_ATTRIBUTE_MUST_HAVE_MAPPING_FOR_TYPE_ID A feed attribute referenced in an ad customizer tag is not in the ad customizer mapping for the feed.
FEED_ATTRIBUTE_MAPPING_TYPE_MISMATCH The ad customizer field mapping for the feed attribute does not match the expected field type.
ILLEGAL_AD_CUSTOMIZER_TAG_USE The use of ad customizer tags in the ad text is disallowed. Details in trigger.
ILLEGAL_TAG_USE Tags of the form {PH_x}, where x is a number, are disallowed in ad text.
INCONSISTENT_DIMENSIONS The dimensions of the ad are specified or derived in multiple ways and are not consistent.
INCONSISTENT_STATUS_IN_TEMPLATE_UNION The status cannot differ among template ads of the same union.
INCORRECT_LENGTH The length of the string is not valid.
INELIGIBLE_FOR_UPGRADE The ad is ineligible for upgrade.
INVALID_AD_ADDRESS_CAMPAIGN_TARGET User cannot create mobile ad for countries targeted in specified campaign.
INVALID_AD_TYPE Invalid Ad type. A specific type of Ad is required.
INVALID_ATTRIBUTES_FOR_MOBILE_IMAGE Headline, description or phone cannot be present when creating mobile image ad.
INVALID_ATTRIBUTES_FOR_MOBILE_TEXT Image cannot be present when creating mobile text ad.
INVALID_CALL_TO_ACTION_TEXT Invalid call to action text.
INVALID_CHARACTER_FOR_URL Invalid character in URL.
INVALID_COUNTRY_CODE Creative's country code is not valid.
INVALID_DSA_URL_TAG Invalid use of Dynamic Search Ads tags ({lpurl} etc.)
INVALID_EXPANDED_DYNAMIC_SEARCH_AD_TAG Invalid use of Expanded Dynamic Search Ads tags ({lpurl} etc.)
INVALID_INPUT An input error whose real reason was not properly mapped (should not happen).
INVALID_MARKUP_LANGUAGE An invalid markup language was entered.
INVALID_MOBILE_CARRIER An invalid mobile carrier was entered.
INVALID_MOBILE_CARRIER_TARGET Specified mobile carriers target a country not targeted by the campaign.
INVALID_NUMBER_OF_ELEMENTS Wrong number of elements for given element type
INVALID_PHONE_NUMBER_FORMAT The format of the telephone number is incorrect. Please re-enter the number using the correct format.
INVALID_RICH_MEDIA_CERTIFIED_VENDOR_FORMAT_ID The certified vendor format id is incorrect.
INVALID_TEMPLATE_DATA The template ad data contains validation errors.
INVALID_TEMPLATE_ELEMENT_FIELD_TYPE The template field doesn't have have the correct type.
INVALID_TEMPLATE_ID Invalid template id.
LINE_TOO_WIDE After substituting replacement strings, the line is too wide.
MISSING_AD_CUSTOMIZER_MAPPING The feed referenced must have ad customizer mapping to be used in a customizer tag.
MISSING_ADDRESS_COMPONENT Missing address component in template element address field.
MISSING_ADVERTISEMENT_NAME An ad name must be entered.
MISSING_BUSINESS_NAME Business name must be entered.
MISSING_DESCRIPTION1 Description (line 2) must be entered.
MISSING_DESCRIPTION2 Description (line 3) must be entered.
MISSING_DESTINATION_URL_TAG The destination url must contain at least one tag (e.g. {lpurl})
MISSING_LANDING_PAGE_URL_TAG The tracking url template of ExpandedDynamicSearchAd must contain at least one tag. (e.g. {lpurl})
MISSING_DIMENSION A valid dimension must be specified for this ad.
MISSING_DISPLAY_URL A display URL must be entered.
MISSING_HEADLINE Headline must be entered.
MISSING_HEIGHT A height must be entered.
MISSING_IMAGE An image must be entered.
MISSING_MARKETING_IMAGE_OR_PRODUCT_VIDEOS Marketing image or product videos are required.
MISSING_MARKUP_LANGUAGES The markup language in which your site is written must be entered.
MISSING_MOBILE_CARRIER A mobile carrier must be entered.
MISSING_PHONE Phone number must be entered.
MISSING_REQUIRED_TEMPLATE_FIELDS Missing required template fields
MISSING_TEMPLATE_FIELD_VALUE Missing a required field value
MISSING_TEXT The ad must have text.
MISSING_VISIBLE_URL A visible URL must be entered.
MISSING_WIDTH A width must be entered.
MULTIPLE_DISTINCT_FEEDS_UNSUPPORTED Only 1 feed can be used as the source of ad customizer substitutions in a single ad.
MUST_USE_TEMP_AD_UNION_ID_ON_ADD TempAdUnionId must be use when adding template ads.
TOO_LONG The string has too many characters.
TOO_SHORT The string has too few characters.
UNION_DIMENSIONS_CANNOT_CHANGE Ad union dimensions cannot change for saved ads.
UNKNOWN_ADDRESS_COMPONENT Address component is not {country, lat, lng}.
UNKNOWN_FIELD_NAME Unknown unique field name
UNKNOWN_UNIQUE_NAME Unknown unique name (template element type specifier)
UNSUPPORTED_DIMENSIONS Unsupported ad dimension
URL_INVALID_SCHEME URL starts with an invalid scheme.
URL_INVALID_TOP_LEVEL_DOMAIN URL ends with an invalid top-level domain name.
URL_MALFORMED URL contains illegal characters.
URL_NO_HOST URL must contain a host name.
URL_NOT_EQUIVALENT URL not equivalent during upgrade.
URL_HOST_NAME_TOO_LONG URL host name too long to be stored as visible URL (applies to Ad Exchange ads)
URL_NO_SCHEME URL must start with a scheme.
URL_NO_TOP_LEVEL_DOMAIN URL should end in a valid domain extension, such as .com or .net.
URL_PATH_NOT_ALLOWED URL must not end with a path.
URL_PORT_NOT_ALLOWED URL must not specify a port.
URL_QUERY_NOT_ALLOWED URL must not contain a query.
URL_SCHEME_BEFORE_DSA_TAG A url scheme is not allowed in front of tag in dest url (e.g. http://{lpurl})
URL_SCHEME_BEFORE_EXPANDED_DYNAMIC_SEARCH_AD_TAG A url scheme is not allowed in front of tag in tracking url template (e.g. http://{lpurl})
USER_DOES_NOT_HAVE_ACCESS_TO_TEMPLATE The user does not have permissions to create a template ad for the given template.
INCONSISTENT_EXPANDABLE_SETTINGS Expandable setting is inconsistent/wrong. For example, an AdX ad is invalid if it has a expandable vendor format but no expanding directions specified, or expanding directions is specified, but the vendor format is not expandable.
INVALID_FORMAT Format is invalid
INVALID_FIELD_TEXT The text of this field did not match a pattern of allowed values.
ELEMENT_NOT_PRESENT Template element is mising
IMAGE_ERROR Error occurred during image processing
VALUE_NOT_IN_RANGE The value is not within the valid range
FIELD_NOT_PRESENT Template element field is not present
ADDRESS_NOT_COMPLETE Address is incomplete
ADDRESS_INVALID Invalid address
VIDEO_RETRIEVAL_ERROR Error retrieving specified video
AUDIO_ERROR Error processing audio
INVALID_YOUTUBE_DISPLAY_URL Display URL is incorrect for YouTube PYV ads
TOO_MANY_PRODUCT_IMAGES Too many product Images in GmailAd
TOO_MANY_PRODUCT_VIDEOS Too many product Videos in GmailAd
INCOMPATIBLE_AD_TYPE_AND_DEVICE_PREFERENCE The device preference is not compatible with the ad type
CALLTRACKING_NOT_SUPPORTED_FOR_COUNTRY Call tracking is not supported for specified country.
CARRIER_SPECIFIC_SHORT_NUMBER_NOT_ALLOWED Carrier specific short number is not allowed.
DISALLOWED_NUMBER_TYPE Specified phone number type is disallowed.
PHONE_NUMBER_NOT_SUPPORTED_FOR_COUNTRY Phone number not supported for country.
PHONE_NUMBER_NOT_SUPPORTED_WITH_CALLTRACKING_FOR_COUNTRY Phone number not supported with call tracking enabled for country.
PREMIUM_RATE_NUMBER_NOT_ALLOWED Premium rate phone number is not allowed.
VANITY_PHONE_NUMBER_NOT_ALLOWED Vanity phone number is not allowed.
INVALID_CALL_CONVERSION_TYPE_ID Invalid call conversion type id.
CANNOT_DISABLE_CALL_CONVERSION_AND_SET_CONVERSION_TYPE_ID Cannot disable call conversion and set conversion type id.
CANNOT_SET_PATH2_WITHOUT_PATH1 Cannot set path2 without path1.
MISSING_DYNAMIC_SEARCH_ADS_SETTING_DOMAIN_NAME Missing domain name in campaign setting when adding expanded dynamic search ad.
INCOMPATIBLE_WITH_RESTRICTION_TYPE The associated ad is not compatible with restriction type.

AdGroupAdErrorEnum

Container for enum describing possible ad group ad errors.

AdGroupAdError

Enum describing possible ad group ad errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
AD_GROUP_AD_LABEL_DOES_NOT_EXIST No link found between the adgroup ad and the label.
AD_GROUP_AD_LABEL_ALREADY_EXISTS The label has already been attached to the adgroup ad.
AD_NOT_UNDER_ADGROUP The specified ad was not found in the adgroup
CANNOT_OPERATE_ON_REMOVED_ADGROUPAD Removed ads may not be modified
CANNOT_CREATE_DEPRECATED_ADS An ad of this type is deprecated and cannot be created. Only deletions are permitted.
CANNOT_CREATE_TEXT_ADS Text ads are deprecated and cannot be created. Use expanded text ads instead.
EMPTY_FIELD A required field was not specified or is an empty string.
RESOURCE_REFERENCED_IN_MULTIPLE_OPS An ad may only be modified once per call

AdGroupBidModifierErrorEnum

Container for enum describing possible ad group bid modifier errors.

AdGroupBidModifierError

Enum describing possible ad group bid modifier errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
CRITERION_ID_NOT_SUPPORTED The criterion ID does not support bid modification.
CANNOT_OVERRIDE_OPTED_OUT_CAMPAIGN_CRITERION_BID_MODIFIER Cannot override the bid modifier for the given criterion ID if the parent campaign is opted out of the same criterion.

AdGroupCriterionErrorEnum

Container for enum describing possible ad group criterion errors.

AdGroupCriterionError

Enum describing possible ad group criterion errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
AD_GROUP_CRITERION_LABEL_DOES_NOT_EXIST No link found between the AdGroupCriterion and the label.
AD_GROUP_CRITERION_LABEL_ALREADY_EXISTS The label has already been attached to the AdGroupCriterion.
CANNOT_ADD_LABEL_TO_NEGATIVE_CRITERION Negative AdGroupCriterion cannot have labels.
TOO_MANY_OPERATIONS Too many operations for a single call.
CANT_UPDATE_NEGATIVE Negative ad group criteria are not updateable.
CONCRETE_TYPE_REQUIRED Concrete type of criterion (keyword v.s. placement) is required for ADD and SET operations.
BID_INCOMPATIBLE_WITH_ADGROUP Bid is incompatible with ad group's bidding settings.
CANNOT_TARGET_AND_EXCLUDE Cannot target and exclude the same criterion at once.
ILLEGAL_URL The URL of a placement is invalid.
INVALID_KEYWORD_TEXT Keyword text was invalid.
INVALID_DESTINATION_URL Destination URL was invalid.
MISSING_DESTINATION_URL_TAG The destination url must contain at least one tag (e.g. {lpurl})
KEYWORD_LEVEL_BID_NOT_SUPPORTED_FOR_MANUALCPM Keyword-level cpm bid is not supported
INVALID_USER_STATUS For example, cannot add a biddable ad group criterion that had been removed.
CANNOT_ADD_CRITERIA_TYPE Criteria type cannot be targeted for the ad group. Either the account is restricted to keywords only, the criteria type is incompatible with the campaign's bidding strategy, or the criteria type can only be applied to campaigns.
CANNOT_EXCLUDE_CRITERIA_TYPE Criteria type cannot be excluded for the ad group. Refer to the documentation for a specific criterion to check if it is excludable.
CAMPAIGN_TYPE_NOT_COMPATIBLE_WITH_PARTIAL_FAILURE Partial failure is not supported for shopping campaign mutate operations.
OPERATIONS_FOR_TOO_MANY_SHOPPING_ADGROUPS Operations in the mutate request changes too many shopping ad groups. Please split requests for multiple shopping ad groups across multiple requests.
CANNOT_MODIFY_URL_FIELDS_WITH_DUPLICATE_ELEMENTS Not allowed to modify url fields of an ad group criterion if there are duplicate elements for that ad group criterion in the request.
CANNOT_SET_WITHOUT_FINAL_URLS Cannot set url fields without also setting final urls.
CANNOT_CLEAR_FINAL_URLS_IF_FINAL_MOBILE_URLS_EXIST Cannot clear final urls if final mobile urls exist.
CANNOT_CLEAR_FINAL_URLS_IF_FINAL_APP_URLS_EXIST Cannot clear final urls if final app urls exist.
CANNOT_CLEAR_FINAL_URLS_IF_TRACKING_URL_TEMPLATE_EXISTS Cannot clear final urls if tracking url template exists.
CANNOT_CLEAR_FINAL_URLS_IF_URL_CUSTOM_PARAMETERS_EXIST Cannot clear final urls if url custom parameters exist.
CANNOT_SET_BOTH_DESTINATION_URL_AND_FINAL_URLS Cannot set both destination url and final urls.
CANNOT_SET_BOTH_DESTINATION_URL_AND_TRACKING_URL_TEMPLATE Cannot set both destination url and tracking url template.
FINAL_URLS_NOT_SUPPORTED_FOR_CRITERION_TYPE Final urls are not supported for this criterion type.
FINAL_MOBILE_URLS_NOT_SUPPORTED_FOR_CRITERION_TYPE Final mobile urls are not supported for this criterion type.
INVALID_LISTING_GROUP_HIERARCHY Ad group is invalid due to the listing groups it contains.
LISTING_GROUP_UNIT_CANNOT_HAVE_CHILDREN Listing group unit cannot have children.
LISTING_GROUP_SUBDIVISION_REQUIRES_OTHERS_CASE Subdivided listing groups must have an "others" case.
LISTING_GROUP_REQUIRES_SAME_DIMENSION_TYPE_AS_SIBLINGS Dimension type of listing group must be the same as that of its siblings.
LISTING_GROUP_ALREADY_EXISTS Listing group cannot be added to the ad group because it already exists.
LISTING_GROUP_DOES_NOT_EXIST Listing group referenced in the operation was not found in the ad group.
LISTING_GROUP_CANNOT_BE_REMOVED Recursive removal failed because listing group subdivision is being created or modified in this request.
INVALID_LISTING_GROUP_TYPE Listing group type is not allowed for specified ad group criterion type.
LISTING_GROUP_ADD_MAY_ONLY_USE_TEMP_ID Listing group in an ADD operation specifies a non temporary criterion id.

AdGroupErrorEnum

Container for enum describing possible ad group errors.

AdGroupError

Enum describing possible ad group errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
DUPLICATE_ADGROUP_NAME AdGroup with the same name already exists for the campaign.
INVALID_ADGROUP_NAME AdGroup name is not valid.
ADVERTISER_NOT_ON_CONTENT_NETWORK Advertiser is not allowed to target sites or set site bids that are not on the Google Search Network.
BID_TOO_BIG Bid amount is too big.
BID_TYPE_AND_BIDDING_STRATEGY_MISMATCH AdGroup bid does not match the campaign's bidding strategy.
MISSING_ADGROUP_NAME AdGroup name is required for Add.
ADGROUP_LABEL_DOES_NOT_EXIST No link found between the ad group and the label.
ADGROUP_LABEL_ALREADY_EXISTS The label has already been attached to the ad group.
INVALID_CONTENT_BID_CRITERION_TYPE_GROUP The CriterionTypeGroup is not supported for the content bid dimension.
AD_GROUP_TYPE_NOT_VALID_FOR_ADVERTISING_CHANNEL_TYPE The ad group type is not compatible with the campaign channel type.
ADGROUP_TYPE_NOT_SUPPORTED_FOR_CAMPAIGN_SALES_COUNTRY The ad group type is not supported in the country of sale of the campaign.
CANNOT_ADD_ADGROUP_OF_TYPE_DSA_TO_CAMPAIGN_WITHOUT_DSA_SETTING Ad groups of AdGroupType.SEARCH_DYNAMIC_ADS can only be added to campaigns that have DynamicSearchAdsSetting attached.

AdSharingErrorEnum

Container for enum describing possible ad sharing errors.

AdSharingError

Enum describing possible ad sharing errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
AD_GROUP_ALREADY_CONTAINS_AD Error resulting in attempting to add an Ad to an AdGroup that already contains the Ad.
INCOMPATIBLE_AD_UNDER_AD_GROUP Ad is not compatible with the AdGroup it is being shared with.
CANNOT_SHARE_INACTIVE_AD Cannot add AdGroupAd on inactive Ad.

AdxErrorEnum

Container for enum describing possible adx errors.

AdxError

Enum describing possible adx errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
UNSUPPORTED_FEATURE Attempt to use non-AdX feature by AdX customer.

AuthenticationErrorEnum

Container for enum describing possible authentication errors.

AuthenticationError

Enum describing possible authentication errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
AUTHENTICATION_ERROR Authentication of the request failed.
CLIENT_CUSTOMER_ID_INVALID Client customer Id is not a number.
CUSTOMER_NOT_FOUND No customer found for the provided customer id.
GOOGLE_ACCOUNT_DELETED Client's Google Account is deleted.
FAILED_TO_AUTHENTICATE_GOOGLE_ACCOUNT A problem occurred during Google account authentication.
GOOGLE_ACCOUNT_USER_AND_ADS_USER_MISMATCH The user in the google account login token does not match the UserId in the cookie.
NOT_ADS_USER User in the cookie is not a valid Ads user.
OAUTH_TOKEN_INVALID Oauth token in the header is not valid.
OAUTH_TOKEN_EXPIRED Oauth token in the header has expired.
OAUTH_TOKEN_DISABLED Oauth token in the header has been disabled.
OAUTH_TOKEN_REVOKED Oauth token in the header has been revoked.
OAUTH_TOKEN_HEADER_INVALID Oauth token HTTP header is malformed.
USER_ID_INVALID User Id in the header is not a valid id.
TWO_STEP_VERIFICATION_NOT_ENROLLED An account administrator changed this account's authentication settings. To access this Google Ads account, enable 2-Step Verification in your Google account at https://www.google.com/landing/2step.
ADVANCED_PROTECTION_NOT_ENROLLED An account administrator changed this account's authentication settings. To access this Google Ads account, enable Advanced Protection in your Google account at https://landing.google.com/advancedprotection.

AuthorizationErrorEnum

Container for enum describing possible authorization errors.

AuthorizationError

Enum describing possible authorization errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
USER_PERMISSION_DENIED User doesn't have permission to access customer.
DEVELOPER_TOKEN_NOT_WHITELISTED The developer token is not whitelisted.
DEVELOPER_TOKEN_PROHIBITED The developer token is not allowed with the project sent in the request.
PROJECT_DISABLED The Google Cloud project sent in the request does not have permission to access the api.
AUTHORIZATION_ERROR Authorization of the client failed.
ACTION_NOT_PERMITTED The user does not have permission to perform this action (e.g., ADD, UPDATE, REMOVE) on the resource or call a method.
INCOMPLETE_SIGNUP Signup not complete.

BiddingErrorEnum

Container for enum describing possible bidding errors.

BiddingError

Enum describing possible bidding errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
BIDDING_STRATEGY_TRANSITION_NOT_ALLOWED Cannot transition to new bidding strategy.
CANNOT_ATTACH_BIDDING_STRATEGY_TO_CAMPAIGN Cannot attach bidding strategy to campaign.
INVALID_ANONYMOUS_BIDDING_STRATEGY_TYPE Bidding strategy is not supported or cannot be used as anonymous.
INVALID_BIDDING_STRATEGY_TYPE The type does not match the named strategy's type.
INVALID_BID The bid is invalid.
BIDDING_STRATEGY_NOT_AVAILABLE_FOR_ACCOUNT_TYPE Bidding strategy is not available for the account type.
CONVERSION_TRACKING_NOT_ENABLED Conversion tracking is not enabled for the campaign for VBB transition.
NOT_ENOUGH_CONVERSIONS Not enough conversions tracked for VBB transitions.
CANNOT_CREATE_CAMPAIGN_WITH_BIDDING_STRATEGY Campaign can not be created with given bidding strategy. It can be transitioned to the strategy, once eligible.
CANNOT_TARGET_CONTENT_NETWORK_ONLY_WITH_CAMPAIGN_LEVEL_POP_BIDDING_STRATEGY Cannot target content network only as campaign uses Page One Promoted bidding strategy.
BIDDING_STRATEGY_NOT_SUPPORTED_WITH_AD_SCHEDULE Budget Optimizer and Target Spend bidding strategies are not supported for campaigns with AdSchedule targeting.
PAY_PER_CONVERSION_NOT_AVAILABLE_FOR_CUSTOMER Pay per conversion is not available to all the customer, only few whitelisted customers can use this.
PAY_PER_CONVERSION_NOT_ALLOWED_WITH_TARGET_CPA Pay per conversion is not allowed with Target CPA.
BIDDING_STRATEGY_NOT_ALLOWED_FOR_SEARCH_ONLY_CAMPAIGNS Cannot set bidding strategy to Manual CPM for search network only campaigns.
BIDDING_STRATEGY_NOT_SUPPORTED_IN_DRAFTS_OR_EXPERIMENTS The bidding strategy is not supported for use in drafts or experiments.
BIDDING_STRATEGY_TYPE_DOES_NOT_SUPPORT_PRODUCT_TYPE_ADGROUP_CRITERION Bidding strategy type does not support product type ad group criterion.
BID_TOO_SMALL Bid amount is too small.
BID_TOO_BIG Bid amount is too big.
BID_TOO_MANY_FRACTIONAL_DIGITS Bid has too many fractional digit precision.
INVALID_DOMAIN_NAME Invalid domain name specified.

BiddingStrategyErrorEnum

Container for enum describing possible bidding strategy errors.

BiddingStrategyError

Enum describing possible bidding strategy errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
DUPLICATE_NAME Each bidding strategy must have a unique name.
CANNOT_CHANGE_BIDDING_STRATEGY_TYPE Bidding strategy type is immutable.
CANNOT_REMOVE_ASSOCIATED_STRATEGY Only bidding strategies not linked to campaigns, adgroups or adgroup criteria can be removed.
BIDDING_STRATEGY_NOT_SUPPORTED The specified bidding strategy is not supported.

CampaignBudgetErrorEnum

Container for enum describing possible campaign budget errors.

CampaignBudgetError

Enum describing possible campaign budget errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
CAMPAIGN_BUDGET_CANNOT_BE_SHARED The campaign budget cannot be shared.
CAMPAIGN_BUDGET_REMOVED The requested campaign budget no longer exists.
CAMPAIGN_BUDGET_IN_USE The campaign budget is associated with at least one campaign, and so the campaign budget cannot be removed.
CAMPAIGN_BUDGET_PERIOD_NOT_AVAILABLE Customer is not whitelisted for this campaign budget period.
CANNOT_MODIFY_FIELD_OF_IMPLICITLY_SHARED_CAMPAIGN_BUDGET This field is not mutable on implicitly shared campaign budgets
CANNOT_UPDATE_CAMPAIGN_BUDGET_TO_IMPLICITLY_SHARED Cannot change explicitly shared campaign budgets back to implicitly shared ones.
CANNOT_UPDATE_CAMPAIGN_BUDGET_TO_EXPLICITLY_SHARED_WITHOUT_NAME An implicit campaign budget without a name cannot be changed to explicitly shared campaign budget.
CANNOT_UPDATE_CAMPAIGN_BUDGET_TO_EXPLICITLY_SHARED Cannot change an implicitly shared campaign budget to an explicitly shared one.
CANNOT_USE_IMPLICITLY_SHARED_CAMPAIGN_BUDGET_WITH_MULTIPLE_CAMPAIGNS Only explicitly shared campaign budgets can be used with multiple campaigns.
DUPLICATE_NAME A campaign budget with this name already exists.
MONEY_AMOUNT_IN_WRONG_CURRENCY A money amount was not in the expected currency.
MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC A money amount was less than the minimum CPC for currency.
MONEY_AMOUNT_TOO_LARGE A money amount was greater than the maximum allowed.
NEGATIVE_MONEY_AMOUNT A money amount was negative.
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT A money amount was not a multiple of a minimum unit.

CampaignCriterionErrorEnum

Container for enum describing possible campaign criterion errors.

CampaignCriterionError

Enum describing possible campaign criterion errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
CONCRETE_TYPE_REQUIRED Concrete type of criterion (keyword v.s. placement) is required for CREATE and UPDATE operations.
INVALID_PLACEMENT_URL Invalid placement URL.
CANNOT_EXCLUDE_CRITERIA_TYPE Criteria type can not be excluded for the campaign by the customer. like AOL account type cannot target site type criteria
CANNOT_SET_STATUS_FOR_CRITERIA_TYPE Cannot set the campaign criterion status for this criteria type.
CANNOT_SET_STATUS_FOR_EXCLUDED_CRITERIA Cannot set the campaign criterion status for an excluded criteria.
CANNOT_TARGET_AND_EXCLUDE Cannot target and exclude the same criterion.
TOO_MANY_OPERATIONS The mutate contained too many operations.
OPERATOR_NOT_SUPPORTED_FOR_CRITERION_TYPE This operator cannot be applied to a criterion of this type.
SHOPPING_CAMPAIGN_SALES_COUNTRY_NOT_SUPPORTED_FOR_SALES_CHANNEL The Shopping campaign sales country is not supported for ProductSalesChannel targeting.
CANNOT_ADD_EXISTING_FIELD The existing field can't be updated with CREATE operation. It can be updated with UPDATE operation only.
CANNOT_UPDATE_NEGATIVE_CRITERION Negative criteria are immutable, so updates are not allowed.

CampaignErrorEnum

Container for enum describing possible campaign errors.

CampaignError

Enum describing possible campaign errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
CANNOT_TARGET_CONTENT_NETWORK Cannot target content network.
CANNOT_TARGET_SEARCH_NETWORK Cannot target search network.
CANNOT_TARGET_GOOGLE_SEARCH_FOR_CPM_CAMPAIGN Cannot target Google Search network for a CPM campaign.
CAMPAIGN_MUST_TARGET_AT_LEAST_ONE_NETWORK Must target at least one network.
CANNOT_TARGET_PARTNER_SEARCH_NETWORK Only some Google partners are allowed to target partner search network.
CANNOT_TARGET_CONTENT_NETWORK_ONLY_WITH_CRITERIA_LEVEL_BIDDING_STRATEGY Cannot target content network only as campaign has criteria-level bidding strategy.
CAMPAIGN_DURATION_MUST_CONTAIN_ALL_RUNNABLE_TRIALS Cannot modify the start or end date such that the campaign duration would not contain the durations of all runnable trials.
CANNOT_MODIFY_FOR_TRIAL_CAMPAIGN Cannot modify dates, budget or campaign name of a trial campaign.
DUPLICATE_CAMPAIGN_NAME Trying to modify the name of an active or paused campaign, where the name is already assigned to another active or paused campaign.
INCOMPATIBLE_CAMPAIGN_FIELD Two fields are in conflicting modes.
INVALID_CAMPAIGN_NAME Campaign name cannot be used.
INVALID_AD_SERVING_OPTIMIZATION_STATUS Given status is invalid.
INVALID_TRACKING_URL Error in the campaign level tracking url.
CANNOT_SET_BOTH_TRACKING_URL_TEMPLATE_AND_TRACKING_SETTING Cannot set both tracking url template and tracking setting. An user has to clear legacy tracking setting in order to add tracking url template.
MAX_IMPRESSIONS_NOT_IN_RANGE The maximum number of impressions for Frequency Cap should be an integer greater than 0.
TIME_UNIT_NOT_SUPPORTED Only the Day, Week and Month time units are supported.
INVALID_OPERATION_IF_SERVING_STATUS_HAS_ENDED Operation not allowed on a campaign whose serving status has ended
BUDGET_CANNOT_BE_SHARED This budget is exclusively linked to a Campaign that is using experiments so it cannot be shared.
CAMPAIGN_CANNOT_USE_SHARED_BUDGET Campaigns using experiments cannot use a shared budget.
CANNOT_CHANGE_BUDGET_ON_CAMPAIGN_WITH_TRIALS A different budget cannot be assigned to a campaign when there are running or scheduled trials.
CAMPAIGN_LABEL_DOES_NOT_EXIST No link found between the campaign and the label.
CAMPAIGN_LABEL_ALREADY_EXISTS The label has already been attached to the campaign.
MISSING_SHOPPING_SETTING A ShoppingSetting was not found when creating a shopping campaign.
INVALID_SHOPPING_SALES_COUNTRY The country in shopping setting is not an allowed country.
MISSING_UNIVERSAL_APP_CAMPAIGN_SETTING A Campaign with channel sub type UNIVERSAL_APP_CAMPAIGN must have a UniversalAppCampaignSetting specified.
ADVERTISING_CHANNEL_TYPE_NOT_AVAILABLE_FOR_ACCOUNT_TYPE The requested channel type is not available according to the customer's account setting.
INVALID_ADVERTISING_CHANNEL_SUB_TYPE The AdvertisingChannelSubType is not a valid subtype of the primary channel type.
AT_LEAST_ONE_CONVERSION_MUST_BE_SELECTED At least one conversion must be selected.
CANNOT_SET_AD_ROTATION_MODE Setting ad rotation mode for a campaign is not allowed. Ad rotation mode at campaign is deprecated.
CANNOT_MODIFY_START_DATE_IF_ALREADY_STARTED Trying to change start date on a campaign that has started.
CANNOT_SET_DATE_TO_PAST Trying to modify a date into the past.
MISSING_HOTEL_SETTING Hotel setting was not found when creating a hotel ads campaign.
CANNOT_USE_SHARED_CAMPAIGN_BUDGET_WHILE_PART_OF_CAMPAIGN_GROUP A Campaign cannot use shared campaign budgets and be part of a campaign group.

CampaignGroupErrorEnum

Container for enum describing possible campaign group errors.

CampaignGroupError

Enum describing possible campaign group errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
CANNOT_REMOVE_CAMPAIGN_GROUP_WITH_ENABLED_OR_PAUSED_CAMPAIGNS CampaignGroup was removed with ENABLED or PAUSED Campaigns associated with it.
DUPLICATE_NAME CampaignGroup with the given name already exists.
CANNOT_MODIFY_REMOVED_CAMPAIGN_GROUP Cannot modify a removed campaign group.

CampaignSharedSetErrorEnum

Container for enum describing possible campaign shared set errors.

CampaignSharedSetError

Enum describing possible campaign shared set errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
SHARED_SET_ACCESS_DENIED The shared set belongs to another customer and permission isn't granted.

ChangeStatusErrorEnum

Container for enum describing possible change status errors.

ChangeStatusError

Enum describing possible change status errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
INVALID_START_DATE The requested start date is invalid.
START_DATE_TOO_OLD The requested start date is too old.

CollectionSizeErrorEnum

Container for enum describing possible collection size errors.

CollectionSizeError

Enum describing possible collection size errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
TOO_FEW Too few.
TOO_MANY Too many.

ContextErrorEnum

Container for enum describing possible context errors.

ContextError

Enum describing possible context errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
OPERATION_NOT_PERMITTED_FOR_CONTEXT The operation is not allowed for the given context.
OPERATION_NOT_PERMITTED_FOR_REMOVED_RESOURCE The operation is not allowed for removed resources.

ConversionActionErrorEnum

Container for enum describing possible conversion action errors.

ConversionActionError

Enum describing possible conversion action errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
DUPLICATE_NAME The specified conversion action name already exists.
DUPLICATE_APP_ID Another conversion action with the specified app id already exists.
TWO_CONVERSION_ACTIONS_BIDDING_ON_SAME_APP_DOWNLOAD Android first open action conflicts with Google play codeless download action tracking the same app.
BIDDING_ON_SAME_APP_DOWNLOAD_AS_GLOBAL_ACTION Android first open action conflicts with Google play codeless download action tracking the same app.
DATA_DRIVEN_MODEL_WAS_NEVER_GENERATED The attribution model cannot be set to DATA_DRIVEN because a data-driven model has never been generated.
DATA_DRIVEN_MODEL_EXPIRED The attribution model cannot be set to DATA_DRIVEN because the data-driven model is expired.
DATA_DRIVEN_MODEL_STALE The attribution model cannot be set to DATA_DRIVEN because the data-driven model is stale.
DATA_DRIVEN_MODEL_UNKNOWN The attribution model cannot be set to DATA_DRIVEN because the data-driven model is unavailable or the conversion action was newly added.

CriterionErrorEnum

Container for enum describing possible criterion errors.

CriterionError

Enum describing possible criterion errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
CONCRETE_TYPE_REQUIRED Concrete type of criterion is required for CREATE and UPDATE operations.
INVALID_EXCLUDED_CATEGORY The category requested for exclusion is invalid.
INVALID_KEYWORD_TEXT Invalid keyword criteria text.
KEYWORD_TEXT_TOO_LONG Keyword text should be less than 80 chars.
KEYWORD_HAS_TOO_MANY_WORDS Keyword text has too many words.
KEYWORD_HAS_INVALID_CHARS Keyword text has invalid characters or symbols.
INVALID_PLACEMENT_URL Invalid placement URL.
INVALID_USER_LIST Invalid user list criterion.
INVALID_USER_INTEREST Invalid user interest criterion.
INVALID_FORMAT_FOR_PLACEMENT_URL Placement URL has wrong format.
PLACEMENT_URL_IS_TOO_LONG Placement URL is too long.
PLACEMENT_URL_HAS_ILLEGAL_CHAR Indicates the URL contains an illegal character.
PLACEMENT_URL_HAS_MULTIPLE_SITES_IN_LINE Indicates the URL contains multiple comma separated URLs.
PLACEMENT_IS_NOT_AVAILABLE_FOR_TARGETING_OR_EXCLUSION Indicates the domain is blacklisted.
INVALID_VERTICAL_PATH Invalid vertical path.
INVALID_YOUTUBE_CHANNEL_ID The YouTube Channel Id is invalid.
INVALID_YOUTUBE_VIDEO_ID The YouTube Video Id is invalid.
YOUTUBE_VERTICAL_CHANNEL_DEPRECATED Indicates the placement is a YouTube vertical channel, which is no longer supported.
YOUTUBE_DEMOGRAPHIC_CHANNEL_DEPRECATED Indicates the placement is a YouTube demographic channel, which is no longer supported.
YOUTUBE_URL_UNSUPPORTED YouTube urls are not supported in Placement criterion. Use YouTubeChannel and YouTubeVideo criterion instead.
CANNOT_EXCLUDE_CRITERIA_TYPE Criteria type can not be excluded by the customer, like AOL account type cannot target site type criteria.
CANNOT_ADD_CRITERIA_TYPE Criteria type can not be targeted.
INVALID_PRODUCT_FILTER Product filter in the product criteria has invalid characters. Operand and the argument in the filter can not have "==" or "&+".
PRODUCT_FILTER_TOO_LONG Product filter in the product criteria is translated to a string as operand1==argument1&+operand2==argument2, maximum allowed length for the string is 255 chars.
CANNOT_EXCLUDE_SIMILAR_USER_LIST Not allowed to exclude similar user list.
CANNOT_ADD_CLOSED_USER_LIST Not allowed to target a closed user list.
CANNOT_ADD_DISPLAY_ONLY_LISTS_TO_SEARCH_ONLY_CAMPAIGNS Not allowed to add display only UserLists to search only campaigns.
CANNOT_ADD_DISPLAY_ONLY_LISTS_TO_SEARCH_CAMPAIGNS Not allowed to add display only UserLists to search plus campaigns.
CANNOT_ADD_DISPLAY_ONLY_LISTS_TO_SHOPPING_CAMPAIGNS Not allowed to add display only UserLists to shopping campaigns.
CANNOT_ADD_USER_INTERESTS_TO_SEARCH_CAMPAIGNS Not allowed to add User interests to search only campaigns.
CANNOT_SET_BIDS_ON_CRITERION_TYPE_IN_SEARCH_CAMPAIGNS Not allowed to set bids for this criterion type in search campaigns
CANNOT_ADD_URLS_TO_CRITERION_TYPE_FOR_CAMPAIGN_TYPE Final URLs, URL Templates and CustomParameters cannot be set for the criterion types of Gender, AgeRange, UserList, Placement, MobileApp, and MobileAppCategory in search campaigns and shopping campaigns.
INVALID_IP_ADDRESS IP address is not valid.
INVALID_IP_FORMAT IP format is not valid.
INVALID_MOBILE_APP Mobile application is not valid.
INVALID_MOBILE_APP_CATEGORY Mobile application category is not valid.
INVALID_CRITERION_ID The CriterionId does not exist or is of the incorrect type.
CANNOT_TARGET_CRITERION The Criterion is not allowed to be targeted.
CANNOT_TARGET_OBSOLETE_CRITERION The criterion is not allowed to be targeted as it is deprecated.
CRITERION_ID_AND_TYPE_MISMATCH The CriterionId is not valid for the type.
INVALID_PROXIMITY_RADIUS Distance for the radius for the proximity criterion is invalid.
INVALID_PROXIMITY_RADIUS_UNITS Units for the distance for the radius for the proximity criterion is invalid.
INVALID_STREETADDRESS_LENGTH Street address is too short.
INVALID_CITYNAME_LENGTH City name in the address is too short.
INVALID_REGIONCODE_LENGTH Region code in the address is too short.
INVALID_REGIONNAME_LENGTH Region name in the address is not valid.
INVALID_POSTALCODE_LENGTH Postal code in the address is not valid.
INVALID_COUNTRY_CODE Country code in the address is not valid.
INVALID_LATITUDE Latitude for the GeoPoint is not valid.
INVALID_LONGITUDE Longitude for the GeoPoint is not valid.
PROXIMITY_GEOPOINT_AND_ADDRESS_BOTH_CANNOT_BE_NULL The Proximity input is not valid. Both address and geoPoint cannot be null.
INVALID_PROXIMITY_ADDRESS The Proximity address cannot be geocoded to a valid lat/long.
INVALID_USER_DOMAIN_NAME User domain name is not valid.
CRITERION_PARAMETER_TOO_LONG Length of serialized criterion parameter exceeded size limit.
AD_SCHEDULE_TIME_INTERVALS_OVERLAP Time interval in the AdSchedule overlaps with another AdSchedule.
AD_SCHEDULE_INTERVAL_CANNOT_SPAN_MULTIPLE_DAYS AdSchedule time interval cannot span multiple days.
AD_SCHEDULE_INVALID_TIME_INTERVAL AdSchedule time interval specified is invalid, endTime cannot be earlier than startTime.
AD_SCHEDULE_EXCEEDED_INTERVALS_PER_DAY_LIMIT The number of AdSchedule entries in a day exceeds the limit.
AD_SCHEDULE_CRITERION_ID_MISMATCHING_FIELDS CriteriaId does not match the interval of the AdSchedule specified.
CANNOT_BID_MODIFY_CRITERION_TYPE Cannot set bid modifier for this criterion type.
CANNOT_BID_MODIFY_CRITERION_CAMPAIGN_OPTED_OUT Cannot bid modify criterion, since it is opted out of the campaign.
CANNOT_BID_MODIFY_NEGATIVE_CRITERION Cannot set bid modifier for a negative criterion.
BID_MODIFIER_ALREADY_EXISTS Bid Modifier already exists. Use SET operation to update.
FEED_ID_NOT_ALLOWED Feed Id is not allowed in these Location Groups.
ACCOUNT_INELIGIBLE_FOR_CRITERIA_TYPE The account may not use the requested criteria type. For example, some accounts are restricted to keywords only.
CRITERIA_TYPE_INVALID_FOR_BIDDING_STRATEGY The requested criteria type cannot be used with campaign or ad group bidding strategy.
CANNOT_EXCLUDE_CRITERION The Criterion is not allowed to be excluded.
CANNOT_REMOVE_CRITERION The criterion is not allowed to be removed. For example, we cannot remove any of the device criterion.
PRODUCT_SCOPE_TOO_LONG The combined length of product dimension values of the product scope criterion is too long.
PRODUCT_SCOPE_TOO_MANY_DIMENSIONS Product scope contains too many dimensions.
PRODUCT_PARTITION_TOO_LONG The combined length of product dimension values of the product partition criterion is too long.
PRODUCT_PARTITION_TOO_MANY_DIMENSIONS Product partition contains too many dimensions.
INVALID_PRODUCT_DIMENSION The product dimension is invalid (e.g. dimension contains illegal value, dimension type is represented with wrong class, etc). Product dimension value can not contain "==" or "&+".
INVALID_PRODUCT_DIMENSION_TYPE Product dimension type is either invalid for campaigns of this type or cannot be used in the current context. BIDDING_CATEGORY_Lx and PRODUCT_TYPE_Lx product dimensions must be used in ascending order of their levels: L1, L2, L3, L4, L5... The levels must be specified sequentially and start from L1. Furthermore, an "others" product partition cannot be subdivided with a dimension of the same type but of a higher level ("others" BIDDING_CATEGORY_L3 can be subdivided with BRAND but not with BIDDING_CATEGORY_L4).
INVALID_PRODUCT_BIDDING_CATEGORY Bidding categories do not form a valid path in the Shopping bidding category taxonomy.
MISSING_SHOPPING_SETTING ShoppingSetting must be added to the campaign before ProductScope criteria can be added.
INVALID_MATCHING_FUNCTION Matching function is invalid.
LOCATION_FILTER_NOT_ALLOWED Filter parameters not allowed for location groups targeting.
LOCATION_FILTER_INVALID Given location filter parameter is invalid for location groups targeting.
CANNOT_ATTACH_CRITERIA_AT_CAMPAIGN_AND_ADGROUP Criteria type cannot be associated with a campaign and its ad group(s) simultaneously.
HOTEL_LENGTH_OF_STAY_OVERLAPS_WITH_EXISTING_CRITERION Range represented by hotel length of stay's min nights and max nights overlaps with an existing criterion.
HOTEL_ADVANCE_BOOKING_WINDOW_OVERLAPS_WITH_EXISTING_CRITERION Range represented by hotel advance booking window's min days and max days overlaps with an existing criterion.
FIELD_INCOMPATIBLE_WITH_NEGATIVE_TARGETING The field is not allowed to be set when the negative field is set to true, e.g. we don't allow bids in negative ad group or campaign criteria.

DatabaseErrorEnum

Container for enum describing possible database errors.

DatabaseError

Enum describing possible database errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
CONCURRENT_MODIFICATION Multiple requests were attempting to modify the same resource at once. Please retry the request.

DateErrorEnum

Container for enum describing possible date errors.

DateError

Enum describing possible date errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
INVALID_FIELD_VALUES_IN_DATE Given field values do not correspond to a valid date.
INVALID_FIELD_VALUES_IN_DATE_TIME Given field values do not correspond to a valid date time.
INVALID_STRING_DATE The string date's format should be yyyymmdd.
INVALID_STRING_DATE_TIME The string date time's format should be yyyymmdd hhmmss [tz].
EARLIER_THAN_MINIMUM_DATE Date is before allowed minimum.
LATER_THAN_MAXIMUM_DATE Date is after allowed maximum.
DATE_RANGE_MINIMUM_DATE_LATER_THAN_MAXIMUM_DATE Date range bounds are not in order.
DATE_RANGE_MINIMUM_AND_MAXIMUM_DATES_BOTH_NULL Both dates in range are null.

DateRangeErrorEnum

Container for enum describing possible date range errors.

DateRangeError

Enum describing possible date range errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
INVALID_DATE Invalid date.
START_DATE_AFTER_END_DATE The start date was after the end date.
CANNOT_SET_DATE_TO_PAST Cannot set date to past time
AFTER_MAXIMUM_ALLOWABLE_DATE A date was used that is past the system "last" date.
CANNOT_MODIFY_START_DATE_IF_ALREADY_STARTED Trying to change start date on a campaign that has started.

DistinctErrorEnum

Container for enum describing possible distinct errors.

DistinctError

Enum describing possible distinct errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
DUPLICATE_ELEMENT Duplicate element.
DUPLICATE_TYPE Duplicate type.

EnumErrorEnum

Container for enum describing possible enum errors.

EnumError

Enum describing possible enum errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
ENUM_VALUE_NOT_PERMITTED The enum value is not permitted.

ErrorCode

The error reason represented by type and enum.

Fields
Union field error_code. The list of error enums error_code can be only one of the following:
request_error

RequestError

An error caused by the request

bidding_strategy_error

BiddingStrategyError

An error with a Bidding Strategy mutate.

url_field_error

UrlFieldError

An error with a URL field mutate.

list_operation_error

ListOperationError

An error with a list operation.

query_error

QueryError

An error with an AWQL query

mutate_error

MutateError

An error with a mutate

field_mask_error

FieldMaskError

An error with a field mask

authorization_error

AuthorizationError

An error encountered when trying to authorize a user.

internal_error

InternalError

An unexpected server-side error.

quota_error

QuotaError

An error with the amonut of quota remaining.

ad_error

AdError

An error with an Ad Group Ad mutate.

ad_group_error

AdGroupError

An error with an Ad Group mutate.

campaign_budget_error

CampaignBudgetError

An error with a Campaign Budget mutate.

campaign_error

CampaignError

An error with a Campaign mutate.

authentication_error

AuthenticationError

Indicates failure to properly authenticate user.

ad_group_criterion_error

AdGroupCriterionError

Indicates failure to properly authenticate user.

ad_customizer_error

AdCustomizerError

The reasons for the ad customizer error

ad_group_ad_error

AdGroupAdError

The reasons for the ad group ad error

ad_sharing_error

AdSharingError

The reasons for the ad sharing error

adx_error

AdxError

The reasons for the adx error

bidding_error

BiddingError

The reasons for the bidding errors

campaign_criterion_error

CampaignCriterionError

The reasons for the campaign criterion error

collection_size_error

CollectionSizeError

The reasons for the collection size error

criterion_error

CriterionError

The reasons for the criterion error

date_error

DateError

The reasons for the date error

date_range_error

DateRangeError

The reasons for the date range error

distinct_error

DistinctError

The reasons for the distinct error

feed_attribute_reference_error

FeedAttributeReferenceError

The reasons for the feed attribute reference error

function_error

FunctionError

The reasons for the function error

function_parsing_error

FunctionParsingError

The reasons for the function parsing error

id_error

IdError

The reasons for the id error

image_error

ImageError

The reasons for the image error

media_bundle_error

MediaBundleError

The reasons for the media bundle error

media_error

MediaError

The reasons for the media error

multiplier_error

MultiplierError

The reasons for the multiplier error

new_resource_creation_error

NewResourceCreationError

The reasons for the new resource creation error

not_empty_error

NotEmptyError

The reasons for the not empty error

null_error

NullError

The reasons for the null error

operator_error

OperatorError

The reasons for the operator error

range_error

RangeError

The reasons for the range error

recommendation_error

RecommendationError

The reasons for error in applying a recommendation

region_code_error

RegionCodeError

The reasons for the region code error

setting_error

SettingError

The reasons for the setting error

string_format_error

StringFormatError

The reasons for the string format error

string_length_error

StringLengthError

The reasons for the string length error

operation_access_denied_error

OperationAccessDeniedError

The reasons for the operation access denied error

resource_access_denied_error

ResourceAccessDeniedError

The reasons for the resource access denied error

resource_count_limit_exceeded_error

ResourceCountLimitExceededError

The reasons for the resource count limit exceeded error

ad_group_bid_modifier_error

AdGroupBidModifierError

The reasons for the ad group bid modifier error

context_error

ContextError

The reasons for the context error

field_error

FieldError

The reasons for the field error

shared_set_error

SharedSetError

The reasons for the shared set error

shared_criterion_error

SharedCriterionError

The reasons for the shared criterion error

campaign_shared_set_error

CampaignSharedSetError

The reasons for the campaign shared set error

conversion_action_error

ConversionActionError

The reasons for the conversion action error

header_error

HeaderError

The reasons for the header error.

database_error

DatabaseError

The reasons for the database error.

policy_finding_error

PolicyFindingError

The reasons for the policy finding error.

campaign_group_error

CampaignGroupError

The reasons for campaign group error.

enum_error

EnumError

The reason for enum error.

account_budget_proposal_error

AccountBudgetProposalError

The reasons for account budget proposal errors.

change_status_error

ChangeStatusError

The reasons for the change status error

ErrorDetails

Additional error details.

Fields
unpublished_error_code

string

The error code that should have been returned, but wasn't. This is used when the error code is InternalError.ERROR_CODE_NOT_PUBLISHED.

policy_violation_details

PolicyViolationDetails

Describes an ad policy violation.

policy_finding_details

PolicyFindingDetails

Describes policy violation findings.

ErrorLocation

Describes the part of the request proto that caused the error.

Fields
operation_index

Int64Value

The mutate operation that failed

field_path_elements[]

FieldPathElement

A field path that indicates which field was invalid in the resource being mutated.

FieldPathElement

A part of a field path.

Fields
field_name

string

The name of a field

index

Int64Value

If field_name is a list, this is the element that failed

FeedAttributeReferenceErrorEnum

Container for enum describing possible feed attribute reference errors.

FeedAttributeReferenceError

Enum describing possible feed attribute reference errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
CANNOT_REFERENCE_DELETED_FEED A feed referenced by ID has been deleted.
INVALID_FEED_NAME There is no active feed with the given name.
INVALID_FEED_ATTRIBUTE_NAME There is no feed attribute in an active feed with the given name.

FieldErrorEnum

Container for enum describing possible field errors.

FieldError

Enum describing possible field errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
REQUIRED The required field was not present in the resource.
IMMUTABLE_FIELD The field attempted to be mutated is immutable.
INVALID_VALUE The field's value is invalid.
VALUE_MUST_BE_UNSET The field cannot be set.
REQUIRED_NONEMPTY_LIST The required repeated field was empty.

FieldMaskErrorEnum

Container for enum describing possible field mask errors.

FieldMaskError

Enum describing possible field mask errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
FIELD_MASK_MISSING The field mask must be provided for update operations.
FIELD_MASK_NOT_ALLOWED The field mask must be empty for create and remove operations.
FIELD_NOT_FOUND The field mask contained an invalid field.
FIELD_HAS_SUBFIELDS The field mask updated a field with subfields. Fields with subfields may be cleared, but not updated. To fix this, the field mask should select all the subfields of the invalid field.

FunctionErrorEnum

Container for enum describing possible function errors.

FunctionError

Enum describing possible function errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
INVALID_FUNCTION_FORMAT The format of the function is not recognized as a supported function format.
DATA_TYPE_MISMATCH Operand data types do not match.
INVALID_CONJUNCTION_OPERANDS The operands cannot be used together in a conjunction.
INVALID_NUMBER_OF_OPERANDS Invalid numer of Operands.
INVALID_OPERAND_TYPE Operand Type not supported.
INVALID_OPERATOR Operator not supported.
INVALID_REQUEST_CONTEXT_TYPE Request context type not supported.
INVALID_FUNCTION_FOR_CALL_PLACEHOLDER The matching function is not allowed for call placeholders
INVALID_FUNCTION_FOR_PLACEHOLDER The matching function is not allowed for the specified placeholder
INVALID_OPERAND Invalid operand.
MISSING_CONSTANT_OPERAND_VALUE Missing value for the constant operand.
INVALID_CONSTANT_OPERAND_VALUE The value of the constant operand is invalid.
INVALID_NESTING Invalid function nesting.
MULTIPLE_FEED_IDS_NOT_SUPPORTED The Feed ID was different from another Feed ID in the same function.
INVALID_FUNCTION_FOR_FEED_WITH_FIXED_SCHEMA The matching function is invalid for use with a feed with a fixed schema.
INVALID_ATTRIBUTE_NAME Invalid attribute name.

FunctionParsingErrorEnum

Container for enum describing possible function parsing errors.

FunctionParsingError

Enum describing possible function parsing errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
NO_MORE_INPUT Unexpected end of function string.
EXPECTED_CHARACTER Could not find an expected character.
UNEXPECTED_SEPARATOR Unexpected separator character.
UNMATCHED_LEFT_BRACKET Unmatched left bracket or parenthesis.
UNMATCHED_RIGHT_BRACKET Unmatched right bracket or parenthesis.
TOO_MANY_NESTED_FUNCTIONS Functions are nested too deeply.
MISSING_RIGHT_HAND_OPERAND Missing right-hand-side operand.
INVALID_OPERATOR_NAME Invalid operator/function name.
FEED_ATTRIBUTE_OPERAND_ARGUMENT_NOT_INTEGER Feed attribute operand's argument is not an integer.
NO_OPERANDS Missing function operands.
TOO_MANY_OPERANDS Function had too many operands.

GoogleAdsError

GoogleAds-specific error.

Fields
error_code

ErrorCode

An enum value that indicates which error occurred.

message

string

A human-readable description of the error.

trigger

Value

The value that triggered the error.

location

ErrorLocation

Describes the part of the request proto that caused the error.

details

ErrorDetails

Additional error details, which are returned by certain error codes. Most error codes do not include details.

GoogleAdsFailure

Describes how a GoogleAds API call failed. It's returned inside google.rpc.Status.details when a call fails.

Fields
errors[]

GoogleAdsError

The list of errors that occurred.

HeaderErrorEnum

Container for enum describing possible header errors.

HeaderError

Enum describing possible header errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
INVALID_USER_SELECTED_CUSTOMER_ID The user selected customer id could not be validated.

IdErrorEnum

Container for enum describing possible id errors.

IdError

Enum describing possible id errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
NOT_FOUND Id not found

ImageErrorEnum

Container for enum describing possible image errors.

ImageError

Enum describing possible image errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
INVALID_IMAGE The image is not valid.
STORAGE_ERROR The image could not be stored.
BAD_REQUEST There was a problem with the request.
UNEXPECTED_SIZE The image is not of legal dimensions.
ANIMATED_NOT_ALLOWED Animated image are not permitted.
ANIMATION_TOO_LONG Animation is too long.
SERVER_ERROR There was an error on the server.
CMYK_JPEG_NOT_ALLOWED Image cannot be in CMYK color format.
FLASH_NOT_ALLOWED Flash images are not permitted.
FLASH_WITHOUT_CLICKTAG Flash images must support clickTag.
FLASH_ERROR_AFTER_FIXING_CLICK_TAG A flash error has occurred after fixing the click tag.
ANIMATED_VISUAL_EFFECT Unacceptable visual effects.
FLASH_ERROR There was a problem with the flash image.
LAYOUT_PROBLEM Incorrect image layout.
PROBLEM_READING_IMAGE_FILE There was a problem reading the image file.
ERROR_STORING_IMAGE There was an error storing the image.
ASPECT_RATIO_NOT_ALLOWED The aspect ratio of the image is not allowed.
FLASH_HAS_NETWORK_OBJECTS Flash cannot have network objects.
FLASH_HAS_NETWORK_METHODS Flash cannot have network methods.
FLASH_HAS_URL Flash cannot have a Url.
FLASH_HAS_MOUSE_TRACKING Flash cannot use mouse tracking.
FLASH_HAS_RANDOM_NUM Flash cannot have a random number.
FLASH_SELF_TARGETS Ad click target cannot be '_self'.
FLASH_BAD_GETURL_TARGET GetUrl method should only use '_blank'.
FLASH_VERSION_NOT_SUPPORTED Flash version is not supported.
FLASH_WITHOUT_HARD_CODED_CLICK_URL Flash movies need to have hard coded click URL or clickTAG
INVALID_FLASH_FILE Uploaded flash file is corrupted.
FAILED_TO_FIX_CLICK_TAG_IN_FLASH Uploaded flash file can be parsed, but the click tag can not be fixed properly.
FLASH_ACCESSES_NETWORK_RESOURCES Flash movie accesses network resources
FLASH_EXTERNAL_JS_CALL Flash movie attempts to call external javascript code
FLASH_EXTERNAL_FS_CALL Flash movie attempts to call flash system commands
FILE_TOO_LARGE Image file is too large.
IMAGE_DATA_TOO_LARGE Image data is too large.
IMAGE_PROCESSING_ERROR Error while processing the image.
IMAGE_TOO_SMALL Image is too small.
INVALID_INPUT Input was invalid.
PROBLEM_READING_FILE There was a problem reading the image file.

InternalErrorEnum

Container for enum describing possible internal errors.

InternalError

Enum describing possible internal errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
INTERNAL_ERROR Google Ads API encountered unexpected internal error.
ERROR_CODE_NOT_PUBLISHED The intended error code doesn't exist in any API version. This will be fixed by adding a new error code as soon as possible.
TRANSIENT_ERROR Google Ads API encountered an unexpected transient error. The user should retry their request in these cases.

ListOperationErrorEnum

Container for enum describing possible list operation errors.

ListOperationError

Enum describing possible list operation errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
REQUIRED_FIELD_MISSING Field required in value is missing.
DUPLICATE_VALUES Duplicate or identical value is sent in multiple list operations.

MediaBundleErrorEnum

Container for enum describing possible media bundle errors.

MediaBundleError

Enum describing possible media bundle errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
BAD_REQUEST There was a problem with the request.
DOUBLECLICK_BUNDLE_NOT_ALLOWED HTML5 ads using DoubleClick Studio created ZIP files are not supported.
EXTERNAL_URL_NOT_ALLOWED Cannot reference URL external to the media bundle.
FILE_TOO_LARGE Media bundle file is too large.
GOOGLE_WEB_DESIGNER_ZIP_FILE_NOT_PUBLISHED ZIP file from Google Web Designer is not published.
INVALID_INPUT Input was invalid.
INVALID_MEDIA_BUNDLE There was a problem with the media bundle.
INVALID_MEDIA_BUNDLE_ENTRY There was a problem with one or more of the media bundle entries.
INVALID_MIME_TYPE The media bundle contains a file with an unknown mime type
INVALID_PATH The media bundle contain an invalid asset path.
INVALID_URL_REFERENCE HTML5 ad is trying to reference an asset not in .ZIP file
MEDIA_DATA_TOO_LARGE Media data is too large.
MISSING_PRIMARY_MEDIA_BUNDLE_ENTRY The media bundle contains no primary entry.
SERVER_ERROR There was an error on the server.
STORAGE_ERROR The image could not be stored.
SWIFFY_BUNDLE_NOT_ALLOWED Media bundle created with the Swiffy tool is not allowed.
TOO_MANY_FILES The media bundle contains too many files.
UNEXPECTED_SIZE The media bundle is not of legal dimensions.
UNSUPPORTED_GOOGLE_WEB_DESIGNER_ENVIRONMENT Google Web Designer not created for "Google Ads" environment.
UNSUPPORTED_HTML5_FEATURE Unsupported HTML5 feature in HTML5 asset.
URL_IN_MEDIA_BUNDLE_NOT_SSL_COMPLIANT URL in HTML5 entry is not ssl compliant.
CUSTOM_EXIT_NOT_ALLOWED Custom exits not allowed in HTML5 entry.

MediaErrorEnum

Container for enum describing possible media errors.

MediaError

Enum describing possible media errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
CANNOT_ADD_STANDARD_ICON Cannot add a standard icon type
CANNOT_SELECT_STANDARD_ICON_WITH_OTHER_TYPES May only select Standard Icons alone
CANNOT_SPECIFY_MEDIA_ID_AND_DATA Image contains both a media ID and media data.
DUPLICATE_MEDIA A media with given type and reference id already exists
EMPTY_FIELD A required field was not specified or is an empty string.
RESOURCE_REFERENCED_IN_MULTIPLE_OPS A media may only be modified once per call
FIELD_NOT_SUPPORTED_FOR_MEDIA_SUB_TYPE Field is not supported for the media sub type.
INVALID_MEDIA_ID The media id is invalid
INVALID_MEDIA_SUB_TYPE The media subtype is invalid
INVALID_MEDIA_TYPE The media type is invalid
INVALID_MIME_TYPE The mimetype is invalid
INVALID_REFERENCE_ID The media reference id is invalid
INVALID_YOU_TUBE_ID The YouTube video id is invalid
MEDIA_FAILED_TRANSCODING Media has failed transcoding
MEDIA_NOT_TRANSCODED Media has not been transcoded
MEDIA_TYPE_DOES_NOT_MATCH_OBJECT_TYPE The MediaType does not match the actual media object's type
NO_FIELDS_SPECIFIED None of the fields have been specified.
NULL_REFERENCE_ID_AND_MEDIA_ID One of reference Id or media Id must be specified
TOO_LONG The string has too many characters.
UNSUPPORTED_OPERATION The specified operation is not supported. Only ADD, SET, and REMOVE are supported
UNSUPPORTED_TYPE The specified type is not supported.
YOU_TUBE_SERVICE_UNAVAILABLE YouTube is unavailable for requesting video data.
YOU_TUBE_VIDEO_HAS_NON_POSITIVE_DURATION The YouTube video has a non positive duration.
YOU_TUBE_VIDEO_NOT_FOUND The YouTube video id is syntactically valid but the video was not found.

MultiplierErrorEnum

Container for enum describing possible multiplier errors.

MultiplierError

Enum describing possible multiplier errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
MULTIPLIER_TOO_HIGH Multiplier value is too high
MULTIPLIER_TOO_LOW Multiplier value is too low
TOO_MANY_FRACTIONAL_DIGITS Too many fractional digits
MULTIPLIER_NOT_ALLOWED_FOR_BIDDING_STRATEGY A multiplier cannot be set for this bidding strategy
MULTIPLIER_NOT_ALLOWED_WHEN_BASE_BID_IS_MISSING A multiplier cannot be set when there is no base bid (e.g., content max cpc)
NO_MULTIPLIER_SPECIFIED A bid multiplier must be specified
MULTIPLIER_CAUSES_BID_TO_EXCEED_DAILY_BUDGET Multiplier causes bid to exceed daily budget
MULTIPLIER_CAUSES_BID_TO_EXCEED_MONTHLY_BUDGET Multiplier causes bid to exceed monthly budget
MULTIPLIER_CAUSES_BID_TO_EXCEED_CUSTOM_BUDGET Multiplier causes bid to exceed custom budget
MULTIPLIER_CAUSES_BID_TO_EXCEED_MAX_ALLOWED_BID Multiplier causes bid to exceed maximum allowed bid
BID_LESS_THAN_MIN_ALLOWED_BID_WITH_MULTIPLIER Multiplier causes bid to become less than the minimum bid allowed
MULTIPLIER_AND_BIDDING_STRATEGY_TYPE_MISMATCH Multiplier type (cpc vs. cpm) needs to match campaign's bidding strategy

MutateErrorEnum

Container for enum describing possible mutate errors.

MutateError

Enum describing possible mutate errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
RESOURCE_NOT_FOUND Requested resource was not found.
ID_EXISTS_IN_MULTIPLE_MUTATES Cannot mutate the same resource twice in one request.
INCONSISTENT_FIELD_VALUES The field's contents don't match another field that represents the same data.
MUTATE_NOT_ALLOWED Mutates are not allowed for the requested resource.

NewResourceCreationErrorEnum

Container for enum describing possible new resource creation errors.

NewResourceCreationError

Enum describing possible new resource creation errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
CANNOT_SET_ID_FOR_ADD Do not set the id field while creating new entities.
DUPLICATE_TEMP_IDS Creating more than one resource with the same temp ID is not allowed.
TEMP_ID_RESOURCE_HAD_ERRORS Parent object with specified temp id failed validation, so no deep validation will be done for this child resource.

NotEmptyErrorEnum

Container for enum describing possible not empty errors.

NotEmptyError

Enum describing possible not empty errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
EMPTY_LIST Empty list.

NullErrorEnum

Container for enum describing possible null errors.

NullError

Enum describing possible null errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
NULL_CONTENT Specified list/container must not contain any null elements

OperationAccessDeniedErrorEnum

Container for enum describing possible operation access denied errors.

OperationAccessDeniedError

Enum describing possible operation access denied errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
ACTION_NOT_PERMITTED Unauthorized invocation of a service's method (get, mutate, etc.)
CREATE_OPERATION_NOT_PERMITTED Unauthorized CREATE operation in invoking a service's mutate method.
REMOVE_OPERATION_NOT_PERMITTED Unauthorized REMOVE operation in invoking a service's mutate method.
UPDATE_OPERATION_NOT_PERMITTED Unauthorized UPDATE operation in invoking a service's mutate method.
MUTATE_ACTION_NOT_PERMITTED_FOR_CLIENT A mutate action is not allowed on this campaign, from this client.
OPERATION_NOT_PERMITTED_FOR_CAMPAIGN_TYPE This operation is not permitted on this campaign type
CREATE_AS_REMOVED_NOT_PERMITTED A CREATE operation may not set status to REMOVED.
OPERATION_NOT_PERMITTED_FOR_REMOVED_RESOURCE This operation is not allowed because the campaign or adgroup is removed.
OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE This operation is not permitted on this ad group type.

OperatorErrorEnum

Container for enum describing possible operator errors.

OperatorError

Enum describing possible operator errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
OPERATOR_NOT_SUPPORTED Operator not supported.

PolicyFindingDetails

Error returned as part of a mutate response. This error indicates one or more policy findings in the fields of a resource.

Fields
policy_topic_entries[]

PolicyTopicEntry

The list of policy topics for the resource. Contains the PROHIBITED or FULLY_LIMITED policy topic entries that prevented the resource from being saved (among any other entries the resource may also have).

PolicyFindingErrorEnum

Container for enum describing possible policy finding errors.

PolicyFindingError

Enum describing possible policy finding errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
POLICY_FINDING The resource has been disapproved since the policy summary includes policy topics of type PROHIBITED.
POLICY_TOPIC_NOT_FOUND The given policy topic does not exist.

PolicyViolationDetails

Error returned as part of a mutate response. This error indicates single policy violation by some text in one of the fields.

Fields
external_policy_description

string

Human readable description of policy violation.

key

PolicyViolationKey

Unique identifier for this violation. If policy is exemptible, this key may be used to request exemption.

external_policy_name

string

Human readable name of the policy.

is_exemptible

bool

Whether user can file an exemption request for this violation.

QueryErrorEnum

Container for enum describing possible query errors.

QueryError

Enum describing possible query errors.

Enums
UNSPECIFIED Name unspecified.
UNKNOWN The received error code is not known in this version.
QUERY_ERROR Returned if all other query error reasons are not applicable.
BAD_ENUM_CONSTANT A condition used in the query references an invalid enum constant.
BAD_ESCAPE_SEQUENCE Query contains an invalid escape sequence.
BAD_FIELD_NAME Field name is invalid.
BAD_LIMIT_VALUE Limit value is invalid (i.e. not a number)
BAD_NUMBER Encountered number can not be parsed.
BAD_OPERATOR Invalid operator encountered.
BAD_RESOURCE_TYPE_IN_FROM_CLAUSE Invalid resource type was specified in the FROM clause.
BAD_SYMBOL Non-ASCII symbol encountered outside of strings.
BAD_VALUE Value is invalid.
DATE_RANGE_TOO_WIDE Date filters fail to restrict date to a range smaller than 31 days. Applicable if the query is segmented by date.
EXPECTED_AND Expected AND between values with BETWEEN operator.
EXPECTED_BY Expecting ORDER BY to have BY.
EXPECTED_DIMENSION_FIELD_IN_SELECT_CLAUSE There was no dimension field selected.
EXPECTED_FILTERS_ON_DATE_RANGE Missing filters on date related fields.
EXPECTED_FROM Missing FROM clause.
EXPECTED_LIST The operator used in the conditions requires the value to be a list.
EXPECTED_REFERENCED_FIELD_IN_SELECT_CLAUSE Fields used in WHERE or ORDER BY clauses are missing from the SELECT clause.
EXPECTED_SELECT SELECT is missing at the beginning of query.
EXPECTED_SINGLE_VALUE A list was passed as a value to a condition whose operator expects a single value.
EXPECTED_VALUE_WITH_BETWEEN_OPERATOR Missing one or both values with BETWEEN operator.
INVALID_DATE_FORMAT Invalid date format. Expected 'YYYY-MM-DD'.
INVALID_STRING_VALUE Value passed was not a string when it should have been. I.e., it was a number or unquoted literal.
INVALID_VALUE_WITH_BETWEEN_OPERATOR A String value passed to the BETWEEN operator does not parse as a date.
INVALID_VALUE_WITH_DURING_OPERATOR The value passed to the DURING operator is not a Date range literal
INVALID_VALUE_WITH_LIKE_OPERATOR A non-string value was passed to the LIKE operator.
OPERATOR_FIELD_MISMATCH An operator was provided that is inapplicable to the field being filtered.
PROHIBITED_EMPTY_LIST_IN_CONDITION A Condition was found with an empty list.
PROHIBITED_ENUM_CONSTANT A condition used in the query references an unsupported enum constant.
PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE Fields that are not allowed to be selected together were included in the SELECT clause.
PROHIBITED_FIELD_IN_ORDER_BY_CLAUSE A field that is not orderable was included in the ORDER BY clause.
PROHIBITED_FIELD_IN_SELECT_CLAUSE A field that is not selectable was included in the SELECT clause.
PROHIBITED_FIELD_IN_WHERE_CLAUSE A field that is not filterable was included in the WHERE clause.
PROHIBITED_RESOURCE_TYPE_IN_FROM_CLAUSE Resource type specified in the FROM clause is not supported by this service.
PROHIBITED_RESOURCE_TYPE_IN_SELECT_CLAUSE A field that comes from an incompatible resource was included in the SELECT clause.
PROHIBITED_RESOURCE_TYPE_IN_WHERE_CLAUSE A field that comes from an incompatible resource was included in the WHERE clause.
PROHIBITED_METRIC_IN_SELECT_OR_WHERE_CLAUSE A metric incompatible with the main resource or other selected segmenting resources was included in the SELECT or WHERE clause.
PROHIBITED_SEGMENT_IN_SELECT_OR_WHERE_CLAUSE A segment incompatible with the main resource or other selected segmenting resources was included in the SELECT or WHERE clause.
PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE A segment in the SELECT clause is incompatible with a metric in the SELECT or WHERE clause.
LIMIT_VALUE_TOO_LOW The value passed to the limit clause is too low.
PROHIBITED_NEWLINE_IN_STRING Query has a string containing a newline character.
PROHIBITED_VALUE_COMBINATION_IN_LIST List contains values of different types.
PROHIBITED_VALUE_COMBINATION_WITH_BETWEEN_OPERATOR The values passed to the BETWEEN operator are not of the same type.
STRING_NOT_TERMINATED Query contains unterminated string.
TOO_MANY_SEGMENTS Too many segments are specified in SELECT clause.
UNEXPECTED_END_OF_QUERY Query is incomplete and cannot be parsed.
UNEXPECTED_FROM_CLAUSE FROM clause cannot be specified in this query.
UNRECOGNIZED_FIELD Query contains one or more unrecognized fields.
UNEXPECTED_INPUT Query has an unexpected extra part.

QuotaErrorEnum

Container for enum describing possible quota errors.

QuotaError

Enum describing possible quota errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
RESOURCE_EXHAUSTED Too many requests.
ACCESS_PROHIBITED Access is prohibited.
RESOURCE_TEMPORARILY_EXHAUSTED Too many requests in a short amount of time.

RangeErrorEnum

Container for enum describing possible range errors.

RangeError

Enum describing possible range errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
TOO_LOW Too low.
TOO_HIGH Too high.

RecommendationErrorEnum

Container for enum describing possible errors from applying a recommendation.

RecommendationError

Enum describing possible errors from applying a recommendation.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
BUDGET_AMOUNT_TOO_SMALL The specified budget amount is too low e.g. lower than minimum currency unit or lower than ad group minimum cost-per-click.
BUDGET_AMOUNT_TOO_LARGE The specified budget amount is too large.
INVALID_BUDGET_AMOUNT The specified budget amount is not a valid amount. e.g. not a multiple of minimum currency unit.
POLICY_ERROR The specified keyword or ad violates ad policy.
INVALID_BID_AMOUNT The specified bid amount is not valid. e.g. too many fractional digits, or negative amount.
ADGROUP_KEYWORD_LIMIT The number of keywords in ad group have reached the maximum allowed.
RECOMMENDATION_ALREADY_APPLIED The recommendation requested to apply has already been applied.
RECOMMENDATION_INVALIDATED The recommendation requested to apply has been invalidated.

RegionCodeErrorEnum

Container for enum describing possible region code errors.

RegionCodeError

Enum describing possible region code errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
INVALID_REGION_CODE Invalid region code.

RequestErrorEnum

Container for enum describing possible request errors.

RequestError

Enum describing possible request errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
RESOURCE_NAME_MISSING Resource name is required for this request.
RESOURCE_NAME_MALFORMED Resource name provided is malformed.
BAD_RESOURCE_ID Resource name provided is malformed.
INVALID_CUSTOMER_ID Customer ID is invalid.
OPERATION_REQUIRED Mutate operation should have either create, update, or remove specified.
RESOURCE_NOT_FOUND Requested resource not found.
INVALID_PAGE_TOKEN Next page token specified in user request is invalid.
EXPIRED_PAGE_TOKEN Next page token specified in user request has expired.
REQUIRED_FIELD_MISSING Required field is missing.
IMMUTABLE_FIELD The field cannot be modified because it's immutable. It's also possible that the field can be modified using 'create' operation but not 'update'.
TOO_MANY_MUTATE_OPERATIONS Received too many entries in request.
CANNOT_BE_EXECUTED_BY_MANAGER_ACCOUNT Request cannot be executed by a manager account.
CANNOT_MODIFY_FOREIGN_FIELD Mutate request was attempting to modify a readonly field. For instance, Budget fields can be requested for Ad Group, but are read-only for adGroups:mutate.
INVALID_ENUM_VALUE Enum value is not permitted.
DEVELOPER_TOKEN_PARAMETER_MISSING The developer-token parameter is required for all requests.

ResourceAccessDeniedErrorEnum

Container for enum describing possible resource access denied errors.

ResourceAccessDeniedError

Enum describing possible resource access denied errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
WRITE_ACCESS_DENIED User did not have write access.

ResourceCountLimitExceededErrorEnum

Container for enum describing possible resource count limit exceeded errors.

ResourceCountLimitExceededError

Enum describing possible resource count limit exceeded errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
ACCOUNT_LIMIT Indicates that this request would exceed the number of allowed resources for the Google Ads account. The exact resource type and limit being checked can be inferred from accountLimitType.
CAMPAIGN_LIMIT Indicates that this request would exceed the number of allowed resources in a Campaign. The exact resource type and limit being checked can be inferred from accountLimitType, and the numeric id of the Campaign involved is given by enclosingId.
ADGROUP_LIMIT Indicates that this request would exceed the number of allowed resources in an ad group. The exact resource type and limit being checked can be inferred from accountLimitType, and the numeric id of the ad group involved is given by enclosingId.
AD_GROUP_AD_LIMIT Indicates that this request would exceed the number of allowed resources in an ad group ad. The exact resource type and limit being checked can be inferred from accountLimitType, and the enclosingId contains the ad group id followed by the ad id, separated by a single comma (,).
AD_GROUP_CRITERION_LIMIT Indicates that this request would exceed the number of allowed resources in an ad group criterion. The exact resource type and limit being checked can be inferred from accountLimitType, and the enclosingId contains the ad group id followed by the criterion id, separated by a single comma (,).
SHARED_SET_LIMIT Indicates that this request would exceed the number of allowed resources in this shared set. The exact resource type and limit being checked can be inferred from accountLimitType, and the numeric id of the shared set involved is given by enclosingId.
MATCHING_FUNCTION_LIMIT Exceeds a limit related to a matching function.
RESPONSE_ROW_LIMIT_EXCEEDED The response for this request would exceed the maximum number of rows that can be returned.

SettingErrorEnum

Container for enum describing possible setting errors.

SettingError

Enum describing possible setting errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
SETTING_TYPE_IS_NOT_AVAILABLE The campaign setting is not available for this Google Ads account.
SETTING_TYPE_IS_NOT_COMPATIBLE_WITH_CAMPAIGN The setting is not compatible with the campaign.
TARGETING_SETTING_CONTAINS_INVALID_CRITERION_TYPE_GROUP The supplied TargetingSetting contains an invalid CriterionTypeGroup. See CriterionTypeGroup documentation for CriterionTypeGroups allowed in Campaign or AdGroup TargetingSettings.
TARGETING_SETTING_DEMOGRAPHIC_CRITERION_TYPE_GROUPS_MUST_BE_SET_TO_TARGET_ALL TargetingSetting must not explicitly set any of the Demographic CriterionTypeGroups (AGE_RANGE, GENDER, PARENT, INCOME_RANGE) to false (it's okay to not set them at all, in which case the system will set them to true automatically).
TARGETING_SETTING_CANNOT_CHANGE_TARGET_ALL_TO_FALSE_FOR_DEMOGRAPHIC_CRITERION_TYPE_GROUP TargetingSetting cannot change any of the Demographic CriterionTypeGroups (AGE_RANGE, GENDER, PARENT, INCOME_RANGE) from true to false.
DYNAMIC_SEARCH_ADS_SETTING_AT_LEAST_ONE_FEED_ID_MUST_BE_PRESENT At least one feed id should be present.
DYNAMIC_SEARCH_ADS_SETTING_CONTAINS_INVALID_DOMAIN_NAME The supplied DynamicSearchAdsSetting contains an invalid domain name.
DYNAMIC_SEARCH_ADS_SETTING_CONTAINS_SUBDOMAIN_NAME The supplied DynamicSearchAdsSetting contains a subdomain name.
DYNAMIC_SEARCH_ADS_SETTING_CONTAINS_INVALID_LANGUAGE_CODE The supplied DynamicSearchAdsSetting contains an invalid language code.
TARGET_ALL_IS_NOT_ALLOWED_FOR_PLACEMENT_IN_SEARCH_CAMPAIGN TargetingSettings in search campaigns should not have CriterionTypeGroup.PLACEMENT set to targetAll.
UNIVERSAL_APP_CAMPAIGN_SETTING_DUPLICATE_DESCRIPTION Duplicate description in universal app setting description field.
UNIVERSAL_APP_CAMPAIGN_SETTING_DESCRIPTION_LINE_WIDTH_TOO_LONG Description line width is too long in universal app setting description field.
UNIVERSAL_APP_CAMPAIGN_SETTING_APP_ID_CANNOT_BE_MODIFIED Universal app setting appId field cannot be modified for COMPLETE campaigns.
TOO_MANY_YOUTUBE_MEDIA_IDS_IN_UNIVERSAL_APP_CAMPAIGN YoutubeVideoMediaIds in universal app setting cannot exceed size limit.
TOO_MANY_IMAGE_MEDIA_IDS_IN_UNIVERSAL_APP_CAMPAIGN ImageMediaIds in universal app setting cannot exceed size limit.
MEDIA_INCOMPATIBLE_FOR_UNIVERSAL_APP_CAMPAIGN Media is incompatible for universal app campaign.
TOO_MANY_EXCLAMATION_MARKS Too many exclamation marks in universal app campaign ad text ideas.

SharedCriterionErrorEnum

Container for enum describing possible shared criterion errors.

SharedCriterionError

Enum describing possible shared criterion errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
CRITERION_TYPE_NOT_ALLOWED_FOR_SHARED_SET_TYPE The criterion is not appropriate for the shared set type.

SharedSetErrorEnum

Container for enum describing possible shared set errors.

SharedSetError

Enum describing possible shared set errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
CUSTOMER_CANNOT_CREATE_SHARED_SET_OF_THIS_TYPE The customer cannot create this type of shared set.
DUPLICATE_NAME A shared set with this name already exists.
SHARED_SET_REMOVED Removed shared sets cannot be mutated.
SHARED_SET_IN_USE The shared set cannot be removed because it is in use.

StringFormatErrorEnum

Container for enum describing possible string format errors.

StringFormatError

Enum describing possible string format errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
ILLEGAL_CHARS The input string value contains disallowed characters.
INVALID_FORMAT The input string value is invalid for the associated field.

StringLengthErrorEnum

Container for enum describing possible string length errors.

StringLengthError

Enum describing possible string length errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
TOO_SHORT Too short.
TOO_LONG Too long.

UrlFieldErrorEnum

Container for enum describing possible url field errors.

UrlFieldError

Enum describing possible url field errors.

Enums
UNSPECIFIED Enum unspecified.
UNKNOWN The received error code is not known in this version.
INVALID_TRACKING_URL_TEMPLATE The tracking url template is invalid.
INVALID_TAG_IN_TRACKING_URL_TEMPLATE The tracking url template contains invalid tag.
MISSING_TRACKING_URL_TEMPLATE_TAG The tracking url template must contain at least one tag (e.g. {lpurl}), This applies only to tracking url template associated with website ads or product ads.
MISSING_PROTOCOL_IN_TRACKING_URL_TEMPLATE The tracking url template must start with a valid protocol (or lpurl tag).
INVALID_PROTOCOL_IN_TRACKING_URL_TEMPLATE The tracking url template starts with an invalid protocol.
MALFORMED_TRACKING_URL_TEMPLATE The tracking url template contains illegal characters.
MISSING_HOST_IN_TRACKING_URL_TEMPLATE The tracking url template must contain a host name (or lpurl tag).
INVALID_TLD_IN_TRACKING_URL_TEMPLATE The tracking url template has an invalid or missing top level domain extension.
REDUNDANT_NESTED_TRACKING_URL_TEMPLATE_TAG The tracking url template contains nested occurrences of the same conditional tag (i.e. {ifmobile:{ifmobile:x}}).
INVALID_FINAL_URL The final url is invalid.
INVALID_TAG_IN_FINAL_URL The final url contains invalid tag.
REDUNDANT_NESTED_FINAL_URL_TAG The final url contains nested occurrences of the same conditional tag (i.e. {ifmobile:{ifmobile:x}}).
MISSING_PROTOCOL_IN_FINAL_URL The final url must start with a valid protocol.
INVALID_PROTOCOL_IN_FINAL_URL The final url starts with an invalid protocol.
MALFORMED_FINAL_URL The final url contains illegal characters.
MISSING_HOST_IN_FINAL_URL The final url must contain a host name.
INVALID_TLD_IN_FINAL_URL The tracking url template has an invalid or missing top level domain extension.
INVALID_FINAL_MOBILE_URL The final mobile url is invalid.
INVALID_TAG_IN_FINAL_MOBILE_URL The final mobile url contains invalid tag.
REDUNDANT_NESTED_FINAL_MOBILE_URL_TAG The final mobile url contains nested occurrences of the same conditional tag (i.e. {ifmobile:{ifmobile:x}}).
MISSING_PROTOCOL_IN_FINAL_MOBILE_URL The final mobile url must start with a valid protocol.
INVALID_PROTOCOL_IN_FINAL_MOBILE_URL The final mobile url starts with an invalid protocol.
MALFORMED_FINAL_MOBILE_URL The final mobile url contains illegal characters.
MISSING_HOST_IN_FINAL_MOBILE_URL The final mobile url must contain a host name.
INVALID_TLD_IN_FINAL_MOBILE_URL The tracking url template has an invalid or missing top level domain extension.
INVALID_FINAL_APP_URL The final app url is invalid.
INVALID_TAG_IN_FINAL_APP_URL The final app url contains invalid tag.
REDUNDANT_NESTED_FINAL_APP_URL_TAG The final app url contains nested occurrences of the same conditional tag (i.e. {ifmobile:{ifmobile:x}}).
MULTIPLE_APP_URLS_FOR_OSTYPE More than one app url found for the same OS type.
INVALID_OSTYPE The OS type given for an app url is not valid.
INVALID_PROTOCOL_FOR_APP_URL The protocol given for an app url is not valid. (E.g. "android-app://")
INVALID_PACKAGE_ID_FOR_APP_URL The package id (app id) given for an app url is not valid.
URL_CUSTOM_PARAMETERS_COUNT_EXCEEDS_LIMIT The number of url custom parameters for an resource exceeds the maximum limit allowed.
INVALID_CHARACTERS_IN_URL_CUSTOM_PARAMETER_KEY An invalid character appears in the parameter key.
INVALID_CHARACTERS_IN_URL_CUSTOM_PARAMETER_VALUE An invalid character appears in the parameter value.
INVALID_TAG_IN_URL_CUSTOM_PARAMETER_VALUE The url custom parameter value fails url tag validation.
REDUNDANT_NESTED_URL_CUSTOM_PARAMETER_TAG The custom parameter contains nested occurrences of the same conditional tag (i.e. {ifmobile:{ifmobile:x}}).
MISSING_PROTOCOL The protocol (http:// or https://) is missing.
INVALID_URL The url is invalid.
DESTINATION_URL_DEPRECATED Destination Url is deprecated.
INVALID_TAG_IN_URL The url contains invalid tag.
MISSING_URL_TAG The url must contain at least one tag (e.g. {lpurl}), This applies only to urls associated with website ads or product ads.
DUPLICATE_URL_ID Duplicate url id.
INVALID_URL_ID Invalid url id.

Send feedback about...

Google Ads API Beta
Google Ads API Beta
Need help? Visit our support page.