AdWords API
Hide

MutateJobService (v201506)

Use the MutateJobService to schedule large batches of updates to your AdWords campaigns as asynchronous mutate jobs, and to retrieve the status, results or statistics of your recent jobs.

Use this service when you wish to release your application from actively waiting on a synchronous response. Your application can do other things or even shutdown while we execute mutations asynchronously.

Requests to the service will fail if the request was invalid or if any of a job's structural constraints are violated, and depending on the operation, the job will not get created or updated.

Once a job has been submitted, you may check its status periodically, by calling get.

Caution: Do not poll the job status too frequently or you will risk getting your customer rate-limited.

Once a job's status changes to COMPLETED, you can retrieve the job's results.

A job can fail even after it has been accepted for processing. For example, a job may fail if the system experienced too many transient errors. In this scenario, the job will get a status of FAILED and will stop processing.

The submitted operations are processed in batches for efficiency. Each batch is processed atomically so that either all of them have successful results, or they all fail with a failure result for the entire batch.

Normally, jobs could be processed in parallel. This may cause concurrent mutations to the same entities to fail, though these would be retried later, see below. If you want to serialize the processing of jobs, you could specify prerequisites through the optional JobPolicy.

You may choose to avoid submitting a new job for mutating an entity while another job for the same entity has not completed yet.

The service will keep retrying operations when transient failures occur. However, if these failures persist for several hours or more serious ones occur, the service will abort a job leaving some or all of its operations unprocessed.

Production WSDL
https://adwords.google.com/api/adwords/cm/v201506/MutateJobService?wsdl
Namespace
https://adwords.google.com/api/adwords/cm/v201506
Operations
Errors

get

Query the status of existing jobs, both simple and bulk API.

Use a JobSelector to query and return a list which may contain both BulkMutateJob and/or SimpleMutateJob.

Parameters

Field Type Description
selector
  1. JobSelector
    1. BulkMutateJobSelector

Response

Field Type Description
rval
  1. Job[]
    1. SimpleMutateJob

getResult

Query mutation results, of a COMPLETED job.

Use a JobSelector to query and return either a BulkMutateResult or a SimpleMutateResult. Submit only one job ID at a time.

Parameters

Field Type Description
selector
  1. JobSelector
    1. BulkMutateJobSelector

Response

Field Type Description
rval JobResult

mutate

Simplified way of submitting a mutation job. The provided list of operations, if valid, will create a new job with a unique id, which will be returned. This id can later be used in invocations of get and getResult. Policy can optionally be specified.

When this method returns with success, the job will be in PROCESSING or PENDING state and no further action is needed for the job to get executed.

Parameters

Field Type Description
operations
  1. Operation[]
    1. AdGroupAdLabelOperation
    2. AdGroupAdOperation
    3. AdGroupBidModifierOperation
    4. AdGroupCriterionLabelOperation
    5. AdGroupCriterionOperation
    6. AdGroupLabelOperation
    7. AdGroupOperation
    8. BudgetOperation
    9. CampaignAdExtensionOperation
    10. CampaignCriterionOperation
    11. CampaignLabelOperation
    12. CampaignOperation
    13. FeedItemOperation
policy BulkMutateJobPolicy

Response

Field Type Description
rval SimpleMutateJob

Errors

Error Reasons
AdCustomizerError An error indicating a problem with an ad customizer tag.
Enumerations
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.
AdError Base error class for Ad Service.
Enumerations
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_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_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.
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.
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_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_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.
MARKUP_LANGUAGES_PRESENT
When entering a markup language the Destination URL must be entered.
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
A destination URL must be entered.
MISSING_DESTINATION_URL_TAG
The destination url 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_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_URL_AND_PHONE
Ad must link to a mobile web page or connect users to your business telephone, or both. Please enter a mobile Destination URL and/or a business telephone number.
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})
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
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.
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
AdExtensionError AdExtension errors.
Enumerations
ACCOUNT_DELETED
Account has been deleted
AD_EXTENSION_NO_LONGER_ACTIVE
Cannot reuse an ad extension that is no longer active
CANNOT_HAVE_MULTIPLE_LOCATION_SYNC_EXTENSIONS_PER_CAMPAIGN
Cannot have multiple location sync extensions per campaign
CANNOT_HAVE_MULTIPLE_MOBILE_EXTENSIONS_PER_CAMPAIGN
Cannot have multiple mobile extensions per campaign
CANNOT_HAVE_MULTIPLE_PRODUCT_EXTENSIONS_PER_CAMPAIGN
Cannot have multiple product extensions per campaign
CANNOT_HAVE_MULTIPLE_SITELINKS_EXTENSIONS_PER_CAMPAIGN
Cannot have multiple sitelinks extensions per campaign
CANNOT_HAVE_MULTIPLE_IN_APP_LINK_EXTENSIONS_PER_CAMPAIGN_PER_APPSTORE
Cannot have multiple in-app link extensions with same app store in a campaign.
INVALID_ADEXTENSION_TYPE
Invalid adextension type for an input adextension
INVALID_AUTH_TOKEN_FOR_EMAIL
Invalid auth token for the given email
INVALID_COUNTRY_CODE
Invalid country code specified
INVALID_DOMESTIC_PHONE_NUMBER_FORMAT
Invalid phone number format specified
INVALID_DESTINATION_URL
Invalid destination url specified
INVALID_EMAIL
Invalid email specified
INVALID_ENCODED_LOCATION
The encoded location does not match what should have been returned in GeoLocation.
INVALID_ENUM_CONDITION_OPERATOR
The enum operator in condition is not valid.
INVALID_ICON_DIMENSIONS
The icon has dimensions other than 16x16
INVALID_ID
Invalid id specified
INVALID_IMAGE_DIMENSIONS
The image has width or height exceeding 125
INVALID_INPUT
The input field is invalid
INVALID_LATITUDE
Invalid latitude specified
INVALID_LONGITUDE
Invalid longitude specified
INVALID_PHONE_NUMBER
Invalid phone number specified
INVALID_STRING_CONDITION_OPERATOR
The string operator in condition is not valid.
INVALID_TOLL_PHONE_NUMBER_FORMAT
Invalid toll phone number format specified
MEDIA_DOES_NOT_BELONG_TO_ACCOUNT
Media referenced does not belong to the customer's account
MEDIA_NOT_ICON_TYPE
Media referenced is not an icon
MEDIA_NOT_IMAGE_TYPE
Media referenced is not an image
MISSING_ADVERTISER_NAME
Missing advertiser name
MISSING_AUTH_TOKEN
Missing auth token
MISSING_COUNTRY_CODE
Missing country code
MISSING_CITY_NAME
Missing city name
MISSING_EMAIL
Missing email
MISSING_ENCODED_LOCATION
Missing encoded location
MISSING_CONDITION_OPERAND
Missing operand for condition
MISSING_CONDITION_STRING_VALUE
Missing comparison string value for condition
MISSING_POSTAL_CODE
Missing postal code
MISSING_STREET_ADDRESS
Missing street address
NUM_AND_GROUPS_OVER_LIMIT
Extension or OR clause contains more than 10 AND clauses
NUM_CONDITIONS_OVER_LIMIT
The number of conditions in an extension or AND group (5 max in AND) exceeds limit
NUM_LOCATION_EXTENSIONS_OVER_LIMIT
The number of location extensions exceeds campaign limits
NOT_AUTHORIZED_TO_CREATE_EXTENSION
The client is not authorized to make the specified extension
PHONE_NUMBER_NOT_SUPPORTED_FOR_COUNTRY
Setting phone number is not supported for the specified country currently
DISALLOWED_NUMBER_TYPE
Phone number type is not allowed
PREMIUM_RATE_NUMBER_NOT_ALLOWED
Premium rate numbers e.g. 1-900 numbers not allowed
TOO_LONG
Text is too long
USER_NOT_PERMITTED_TO_CREATE_LBC_SYNC_LOCATION_EXTENSION
The user is not permitted to create location sync extensions
AdGroupAdError Error information for AdGroupAdService.
Enumerations
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.
EMPTY_FIELD
A required field was not specified or is an empty string.
ENTITY_REFERENCED_IN_MULTIPLE_OPS
An ad may only be modified once per call
UNSUPPORTED_OPERATION
The specified operation is not supported. Only ADD, SET, and REMOVE are supported
AdGroupCriterionError Base error class for Ad Group Criterion Service.
Enumerations
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_OPERTAIONS
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.
INVALID_PRODUCT_PARTITION_HIERARCHY
Ad group is invalid due to the product partitions it contains.
PRODUCT_PARTITION_UNIT_CANNOT_HAVE_CHILDREN
Product partition unit cannot have children.
PRODUCT_PARTITION_SUBDIVISION_REQUIRES_OTHERS_CASE
Subdivided product partitions must have an "others" case.
PRODUCT_PARTITION_REQUIRES_SAME_DIMENSION_TYPE_AS_SIBLINGS
Dimension type of product partition must be the same as that of its siblings.
PRODUCT_PARTITION_ALREADY_EXISTS
Product partition cannot be added to the ad group because it already exists.
PRODUCT_PARTITION_DOES_NOT_EXIST
Product partition referenced in the operation was not found in the ad group.
PRODUCT_PARTITION_CANNOT_BE_REMOVED
Recursive removal failed because product partition subdivision is being created or modified in this request.
INVALID_PRODUCT_PARTITION_TYPE
Product partition type is not allowed for specified AdGroupCriterion type.
PRODUCT_PARTITION_ADD_MAY_ONLY_USE_TEMP_ID
Product partition in an ADD operation specifies a non temporary CriterionId.
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.
UNKNOWN
AdGroupServiceError Represents possible error codes in AdGroupService.
Enumerations
DUPLICATE_ADGROUP_NAME
AdGroup with the same name already exists for the campaign.
INVALID_ADGROUP_NAME
AdGroup name is not valid.
USE_SET_OPERATOR_AND_MARK_STATUS_TO_REMOVED
Cannot remove an adgroup, adgroup status can be marked removed using set operator.
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.
AdxError Errors that are thrown when a non-AdX feature is accessed by an AdX customer.
Enumerations
UNSUPPORTED_FEATURE
Attempt to use non-AdX feature by AdX customer.
AuthenticationError Errors returned when Authentication failed.
Enumerations
AUTHENTICATION_FAILED
Authentication of the request failed.
CLIENT_CUSTOMER_ID_IS_REQUIRED
Client Customer Id is required if CustomerIdMode is set to CLIENT_EXTERNAL_CUSTOMER_ID. Starting version V201409 ClientCustomerId will be required for all requests except for CustomerService.get
CLIENT_EMAIL_REQUIRED
Client Email is required if CustomerIdMode is set to CLIENT_EXTERNAL_EMAIL_FIELD.
CLIENT_CUSTOMER_ID_INVALID
Client customer Id is not a number.
CLIENT_EMAIL_INVALID
Client customer Id is not a number.
CLIENT_EMAIL_FAILED_TO_AUTHENTICATE
Client email is not a valid customer email.
CUSTOMER_NOT_FOUND
No customer found for the customer id provided in the header.
GOOGLE_ACCOUNT_DELETED
Client's Google Account is deleted.
GOOGLE_ACCOUNT_COOKIE_INVALID
Google account login token in the cookie is invalid.
FAILED_TO_AUTHENTICATE_GOOGLE_ACCOUNT
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.
LOGIN_COOKIE_REQUIRED
Login cookie is required for authentication.
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.
LOGIN_COOKIE_INVALID
Login cookie is not valid.
FAILED_TO_RETRIEVE_LOGIN_COOKIE
Failed to decrypt the login cookie.
USER_ID_INVALID
User Id in the header is not a valid id.
AuthorizationError Errors encountered when trying to authorize a user.
Enumerations
UNABLE_TO_AUTHORIZE
Could not complete authorization due to an internal problem.
NO_ADWORDS_ACCOUNT_FOR_CUSTOMER
Customer has no AdWords account.
USER_PERMISSION_DENIED
User doesn't have permission to access customer.
EFFECTIVE_USER_PERMISSION_DENIED
Effective user doesn't have permission to access this customer.
USER_HAS_READONLY_PERMISSION
User has read-only permission cannot mutate.
NO_CUSTOMER_FOUND
No customer found.
SERVICE_ACCESS_DENIED
Developer doesn't have permission to access service.
BiddingErrors Represents error codes for bidding strategy entities.
Enumerations
BIDDING_STRATEGY_TRANSITION_NOT_ALLOWED
Cannot transition to new bidding strategy.
BIDDING_STRATEGY_NOT_COMPATIBLE_WITH_ADGROUP_OVERRIDES
Bidding strategy cannot be overridden by current ad group bidding strategy.
BIDDING_STRATEGY_NOT_COMPATIBLE_WITH_ADGROUP_CRITERIA_OVERRIDES
Bidding strategy cannot be overridden by current criteria bidding strategy.
CAMPAIGN_BIDDING_STRATEGY_CANNOT_BE_OVERRIDDEN
Cannot override campaign bidding strategy.
ADGROUP_BIDDING_STRATEGY_CANNOT_BE_OVERRIDDEN
Cannot override ad group bidding strategy.
CANNOT_ATTACH_BIDDING_STRATEGY_TO_CAMPAIGN
Cannot attach bidding strategy to campaign.
CANNOT_ATTACH_BIDDING_STRATEGY_TO_ADGROUP
Cannot attach bidding strategy to ad group.
CANNOT_ATTACH_BIDDING_STRATEGY_TO_ADGROUP_CRITERIA
Cannot attach bidding strategy to criteria.
INVALID_ANONYMOUS_BIDDING_STRATEGY_TYPE
Bidding strategy is not supported or cannot be used as anonymous.
BIDS_NOT_ALLLOWED
No bids may be set. The bid list must be null or empty.
DUPLICATE_BIDS
The bid list contains two or more bids of the same type.
INVALID_BIDDING_SCHEME
The bidding scheme does not match the bidding strategy type.
INVALID_BIDDING_STRATEGY_TYPE
The type does not match the named strategy's type.
MISSING_BIDDING_STRATEGY_TYPE
The bidding strategy type is missing.
NULL_BID
The bid list contains a null entry.
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_CONVERSION_OPTIMIZER
Campaign can not be created with Conversion Optimizer bidding strategy. It can be transitioned to conversion optimizer, once eligible.
CANNOT_TARGET_CONTENT_NETWORK_ONLY_WITH_AD_GROUP_LEVEL_POP_BIDDING_STRATEGY
Cannot target content network only as ad group uses Page One Promoted bidding strategy.
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_FOR_CAMPAIGNS_WITH_EXPERIMENTS
The campaign has active experiments so bidding transition is prohibited.
CANNOT_CHANGE_BIDDING_STRATEGY_IN_CAMPAIGN_WITH_EXPERIMENT
The campaign has active experiment so bid strategy change is prohibited.
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.
UNKNOWN
BudgetError A list of all the error codes being used by the common budget domain package.
Enumerations
BUDGET_REMOVED
The requested budget no longer exists.
BUDGET_ERROR
Default budget error.
BUDGET_IN_USE
The budget is associated with at least one campaign, and so the budget cannot be removed.
BUDGET_PERIOD_NOT_AVAILABLE
Customer is not whitelisted for this budget period.
CANNOT_EDIT_SHARED_BUDGET
Customer cannot use CampaignService to edit a shared budget.
CANNOT_MODIFY_FIELD_OF_IMPLICITLY_SHARED_BUDGET
This field is not mutable on implicitly shared budgets
CANNOT_UPDATE_BUDGET_TO_IMPLICITLY_SHARED
Cannot change explicitly shared budgets back to implicitly shared ones.
CANNOT_UPDATE_BUDGET_TO_EXPLICITLY_SHARED_WITHOUT_NAME
An implicit budget without a name cannot be changed to explicitly shared budget.
CANNOT_USE_IMPLICITLY_SHARED_BUDGET_WITH_MULTIPLE_CAMPAIGNS
Only explicitly shared budgets can be used with multiple campaigns.
DUPLICATE_NAME
A 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.
BulkMutateJobError Bulk mutate job handling errors.
Enumerations
CAN_RETURN_RESULT_FOR_ONLY_COMPLETED_JOBS
The job selector must specify a job that has completed when a result part is also requested to be returned.
CAN_RETURN_RESULT_FOR_ONLY_ONE_JOB
The job selector must specify a single job when a result part is also requested to be returned.
CANNOT_UPDATE_JOB_ONCE_ALL_REQUEST_PARTS_ARE_RECEIVED
A bulk mutate job can be updated to add new request parts or to set the number of request parts only until all request parts are determined to have been received.
INVALID_SCOPING_ENTITY_TYPE
An operation stream in the bulk mutate request refers to an unknown or unsupported type of scoping entity.
MISSING_SCOPING_ENTITY_FOR_OPERATION_STREAM
An operation stream in the bulk mutate request does not specify a scoping entity id.
MORE_THAN_ONE_SCOPING_ENTITY_TYPE
The operation streams in the bulk mutate request refer to more than one type of scoping entity.
PAYLOAD_STORE_UNAVAILABLE
The request cannot be processed because the payload store (where the request and response parts are saved) is temporarily unavailable.
REQUEST_PART_IS_OUT_OF_ORDER
The request part is not the next one expected to be received.
TOO_MANY_OPERATION_STREAMS_IN_REQUEST_PART
The number of operation streams in this request part exceeds the maximum limit.
TOO_MANY_OPERATIONS_IN_JOB
The number of operations in this job exceeds the maximum limit.
TOO_MANY_OPERATIONS_IN_REQUEST_PART
The number of operations in this request part exceeds the maximum limit.
TOO_MANY_RESULTS_TO_STORE
The limit for the number of operation results to store in the bulk mutate workflow system has been exceeded for this customer.
TOO_MANY_SCOPING_ENTITIES
The operation streams in the bulk mutate request refer to more than the allowed number of scoping entities.
UNKNOWN
Used for return value only. An enumeration could not be processed, typically due to incompatibility with your WSDL version.
LOST_RESULT
A specific operation has been applied but the result was lost. This can be returned when getting the result of a completed job.
UNPROCESSED_RESULT
A specific operation was not applied because of job failure(s). This can be returned when getting the result of a completed job.
BATCH_FAILURE
A specific operation was not applied because another operation in the same batch failed. This can be returned when getting the result of a completed job with other failed operations.
SERVICE_PROVIDED_NO_RESULT
The operation was applied, but we got fewer results than we expected. This can be returned when getting the result of a completed job.
CampaignAdExtensionError CampaignAdExtension errors.
Enumerations
ADEXTENSION_NOT_UNDER_CAMPAIGN
Cannot operate on an adextensions under the wrong campaign
CANNOT_ADD_REMOVED_CAMPAIGN_ADEXTENSION
Cannot add a CampaignAdExtension with status REMOVED.
CANNOT_OPERATE_ON_REMOVED_CAMPAIGN_ADEXTENSION
Cannot operate on a CampaignAdExtension with status REMOVED.
INVALID_ADEXTENSION_ID
Invalid adextension id
MISSING_ADEXTENSION_ID
Missing adextension id
MUST_USE_CONCRETE_ADEXTENSION
Must use a concrete subtype of AdExtension (eg. LocationExtension)
UNKNOWN_ERROR
CampaignCriterionError Base error class for Campaign Criterion Service.
Enumerations
CONCRETE_TYPE_REQUIRED
Concrete type of criterion (keyword v.s. placement) is required for ADD and SET 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_TARGET_AND_EXCLUDE
Cannot target and exclude the same criterion.
TOO_MANY_OPERTAIONS
The #mutate operation 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.
UNKNOWN
CANNOT_ADD_EXISTING_FIELD
The existing field can't be updated with ADD operation. It can be updated with SET operation only.
CampaignError Base error class for Campaign Service.
Enumerations
CANNOT_GO_BACK_TO_INCOMPLETE
A complete campaign cannot go back to being incomplete
CANNOT_SET_END_DATE_BEFORE_EXPERIMENT_END_DATE
Trying to modify an end date before an active experiment end date.
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.
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 @link{Experiment}s so it cannot be shared.
CAMPAIGN_CANNOT_USE_SHARED_BUDGET
Campaigns using @link{Experiment}s cannot use a shared budget.
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.
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.
UNKNOWN
Default error Used for return value only. An enumeration could not be processed, typically due to incompatibility with your WSDL version.
ClientTermsError Error due to user not accepting the AdWords terms of service.
Enumerations
INCOMPLETE_SIGNUP_CURRENT_ADWORDS_TNC_NOT_AGREED
Customer has not agreed to the latest AdWords Terms & Conditions
CollectionSizeError Errors associated with the size of the given collection being out of bounds.
Enumerations
TOO_FEW
TOO_MANY
CriterionError Error class used for reporting criteria related errors.
Enumerations
CONCRETE_TYPE_REQUIRED
Concrete type of criterion is required for ADD and SET 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.
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_ADD_DISPLAY_ONLY_LISTS_TO_SEARCH_ONLY_CAMPAIGNS
Not allowed to add display only UserLists 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_DESTINATION_URL_TO_CRITERION_TYPE_IN_SEARCH_CAMPAIGNS
Destination URL cannot be set for the criterion types of Gender, AgeRange, UserList, Placement, MobileApp, and MobileAppCategory in search 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 platform 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.
UNKNOWN
DatabaseError Errors that are thrown due to a database access problem.
Enumerations
CONCURRENT_MODIFICATION
A concurrency problem occurred as two threads were attempting to modify same object.
PERMISSION_DENIED
The permission was denied to access an object.
ACCESS_PROHIBITED
The user's access to an object has been prohibited.
CAMPAIGN_PRODUCT_NOT_SUPPORTED
Requested campaign belongs to a product that is not supported by the api.
DUPLICATE_KEY
a duplicate key was detected upon insertion
DATABASE_ERROR
a database error has occurred
UNKNOWN
an unknown error has occurred
DateError Errors associated with invalid dates and date ranges.
Enumerations
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_RANGE
The string date range's format should be yyyymmdd 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.
DateRangeError A list of all the error codes being used for date range error.
Enumerations
DATE_RANGE_ERROR
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.
DistinctError Errors related to distinct ids or content.
Enumerations
DUPLICATE_ELEMENT
DUPLICATE_TYPE
EntityAccessDenied Reports permission problems trying to access an entity.
Enumerations
READ_ACCESS_DENIED
User did not have read access.
WRITE_ACCESS_DENIED
User did not have write access.
EntityCountLimitExceeded Signals that an entity count limit was exceeded for some level. For example, too many criteria for a campaign.
Enumerations
ACCOUNT_LIMIT
Indicates that this request would exceed the number of allowed entities for the AdWords account. The exact entity type and limit being checked can be inferred from accountLimitType.
CAMPAIGN_LIMIT
Indicates that this request would exceed the number of allowed entities in a Campaign. The exact entity 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 entities in an ad group. The exact entity 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 entities in an ad group ad. The exact entity 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 entities in an ad group criterion. The exact entity 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 entities in this shared set. The exact entity 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.
UNKNOWN
Specific limit that has been exceeded is unknown (the client may be of an older version than the server).
EntityNotFound An id did not correspond to an entity, or it referred to an entity which does not belong to the customer.
Enumerations
INVALID_ID
The specified id refered to an entity which either doesn't exist or is not accessible to the customer. e.g. campaign belongs to another customer.
ExperimentError
Enumerations
EXPERIMENT_DELTA_STATUS_NOT_SPECIFIED
Experiment delta status not specified.
EXPERIMENT_DELTA_STATUS_NOT_ALLOWED
Experiment delta status not allowed.
EXPERIMENT_STATUS_NOT_ALLOWED
Cannot create experiment data in REMOVED status
EXPERIMENT_NOT_ALLOWED_FOR_BIDDING_STRATEGY
Experiments are not allowed for this bidding strategy
EXPERIMENT_NOT_ALLOWED_FOR_CRITERION_TYPE
Experiments are not allowed for this criterion type
EXPERIMENT_NOT_ACTIVE
Cannot make changes for inactive experiments
INVALID_EXPERIMENT_ID
Invalid experiment id
EXPERIMENT_ID_NOT_SPECIFIED_WITH_SEGMENTATION_CRITERIA
Experiment id must be specified for this criterion
TOO_MANY_CHANGES_TO_EXPERIMENT
This experiment has too many changes
EXPERIMENT_ERROR
FeedAttributeReferenceError An error indicating a problem with a reference to a feed attribute in an ad.
Enumerations
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.
FeedItemError FeedItemService related errors.
Enumerations
CAMPAIGN_TARGETING_MISMATCH
Targeted adgroup's campaign does not match the targeted campaign.
CANNOT_CONVERT_ATTRIBUTE_VALUE_FROM_STRING
Cannot convert the feed attribute value from string to its real type.
CANNOT_OPERATE_ON_REMOVED_FEED_ITEM
Cannot operate on removed feed item.
DATE_TIME_MUST_BE_IN_ACCOUNT_TIME_ZONE
Date time zone does not match the account's time zone.
KEY_ATTRIBUTES_NOT_FOUND
Feed item with the key attributes could not be found.
INVALID_DEVICE_PREFERENCE
Unknown or unsupported device preference.
INVALID_SCHEDULE_END
Invalid feed item schedule end time (i.e., endHour = 24 and endMinute != 0).
INVALID_URL
Url feed attribute value is not valid.
MISSING_KEY_ATTRIBUTES
Some key attributes are missing.
KEY_ATTRIBUTES_NOT_UNIQUE
Feed item has same key attributes as another feed item.
CANNOT_MODIFY_KEY_ATTRIBUTE_VALUE
Cannot modify key attributes on an existing feed item.
OVERLAPPING_SCHEDULES
Overlapping feed item schedule times (e.g., 7-10AM and 8-11AM) are not allowed.
SCHEDULE_END_NOT_AFTER_START
Feed item schedule end time must be after start time.
TOO_MANY_SCHEDULES_PER_DAY
There are too many feed item schedules per day.
UNKNOWN
Unknown error.
ForwardCompatibilityError A ForwardComptibilityError represents possible errors when using the forwardCompatibilityMap in some of the common services.
Enumerations
INVALID_FORWARD_COMPATIBILITY_MAP_VALUE
Invalid value specified for a key in the forward compatibility map.
UNKNOWN
FunctionError Errors that indicate issues with the function.
Enumerations
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_ATTRIBUTE_NAME
Invalid attribute name.
UNKNOWN
FunctionParsingError An error resulting from a failure to parse the textual representation of a function.
Enumerations
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.
UNKNOWN
IdError Errors associated with the ids.
Enumerations
NOT_FOUND
Id not found
ImageError Error class for errors associated with parsing image data.
Enumerations
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.
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.
InternalApiError Indicates that a server-side error has occured. InternalApiErrors are generally not the result of an invalid request or message sent by the client.
Enumerations
UNEXPECTED_INTERNAL_API_ERROR
API encountered an unexpected internal error.
TRANSIENT_ERROR
A temporary error occurred during the request. Please retry.
UNKNOWN
The cause of the error is not known or only defined in newer versions.
DOWNTIME
The API is currently unavailable for a planned downtime.
JobError Job handling errors.
Enumerations
DUPLICATE_JOB_KEY_FOR_CUSTOMER
The supplied customer job key has already been used for an earlier job.
JOB_TYPE_NOT_SUPPORTED
The server does not support the given type of job.
PREREQUISITE_JOB_FAILED
A job specified as a prerequisite to this job has failed.
SELECTOR_CANNOT_USE_BOTH_JOB_IDS_AND_JOB_KEYS
Cannot select using both job ids and customer job keys.
TOO_LATE_TO_CANCEL_JOB
Cannot cancel this job as it is an advanced stage of processing; See the specific job type to understand when a job may be canceled.
TOO_MANY_PREREQUISITE_JOBS
The limit for the number of prerequisite jobs has been exceeded for this job request.
TOO_MANY_JOBS_IN_QUEUE
The limit for the number of pending jobs has been exceeded for this customer.
USER_CANCELED_JOB
The job was canceled at the request of the user.
WORKFLOW_FAILURE
Encountered a workflow system failure.
UNKNOWN
Used for return value only. An enumeration could not be processed, typically due to incompatibility with your WSDL version.
MediaError Error class for media related errors.
Enumerations
CANNOT_ADD_STANDARD_ICON
Cannot add a standard icon type
CANNOT_SELECT_STANDARD_ICON_WITH_OTHER_TYPES
May only select Standard Icons alone
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.
ENTITY_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_TYPE
The media type is invalid
INVALID_MEDIA_SUB_TYPE
The media subtype is invalid
INVALID_REFERENCE_ID
The media reference id is invalid
INVALID_YOU_TUBE_ID
The YouTube video id is invalid
YOU_TUBE_VIDEO_NOT_FOUND
The YouTube video id is syntactically valid but the video was not found.
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.
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
MultiplierError Represents errors in bid multipliers.
Enumerations
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)
MULTIPLIER_NOT_ALLOWED_FOR_EXPERIMENT_DELTA_STATUS
A multiplier cannot be set for this criterion type
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
MULTIPLIER_ERROR
NewEntityCreationError Error associated with creation of new entities.
Enumerations
CANNOT_SET_ID_FOR_ADD
Do not set the id field while creating new entities.
NotEmptyError Errors corresponding with violation of a NOT EMPTY check.
Enumerations
EMPTY_LIST
NullError Errors associated with violation of a NOT NULL check.
Enumerations
NULL_CONTENT
Specified list/container must not contain any null elements
OperationAccessDenied Operation not permitted due to the invoked service's access policy.
Enumerations
ACTION_NOT_PERMITTED
Unauthorized invocation of a service's method (get, mutate, etc.)
ADD_OPERATION_NOT_PERMITTED
Unauthorized ADD operation in invoking a service's mutate method.
REMOVE_OPERATION_NOT_PERMITTED
Unauthorized REMOVE operation in invoking a service's mutate method.
SET_OPERATION_NOT_PERMITTED
Unauthorized SET 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
ADD_AS_REMOVED_NOT_PERMITTED
An ADD operation may not set status to REMOVED.
OPERATION_NOT_PERMITTED_FOR_REMOVED_ENTITY
This operation is not allowed because the campaign or adgroup is removed.
UNKNOWN
The reason the invoked method or operation is prohibited is not known (the client may be of an older version than the server).
OperatorError Errors due to the use of unsupported operations.
Enumerations
OPERATOR_NOT_SUPPORTED
PagingError Error codes for pagination. See Paging.
Enumerations
START_INDEX_CANNOT_BE_NEGATIVE
NUMBER_OF_RESULTS_CANNOT_BE_NEGATIVE
UNKNOWN
Used for return value only. An enumeration could not be processed, typically due to incompatibility with your WSDL version.
PolicyViolationError Represents violations of a single policy by some text in a field. Violations of a single policy by the same string in multiple places within a field is reported in one instance of this class and only one exemption needs to be filed. Violations of a single policy by two different strings is reported as two separate instances of this class. e.g. If 'ACME' violates 'capitalization' and occurs twice in a text ad it would be represented by one instance. If the ad also contains 'INC' which also violates 'capitalization' it would be represented in a separate instance.
QueryError A QueryError represents possible errors for query parsing and execution.
Enumerations
PARSING_FAILED
Exception that happens when trying to parse a query that doesn't match the AWQL grammar.
MISSING_QUERY
The provided query is an empty string.
MISSING_SELECT_CLAUSE
The query does not contain the required SELECT clause or it is not in the correct location.
MISSING_FROM_CLAUSE
The query does not contain the required FROM clause or it is not in the correct location.
INVALID_SELECT_CLAUSE
The SELECT clause could not be parsed.
INVALID_FROM_CLAUSE
The FROM clause could not be parsed.
INVALID_WHERE_CLAUSE
The WHERE clause could not be parsed.
INVALID_ORDER_BY_CLAUSE
The ORDER BY clause could not be parsed.
INVALID_LIMIT_CLAUSE
The LIMIT clause could not be parsed.
INVALID_START_INDEX_IN_LIMIT_CLAUSE
The startIndex in the LIMIT clause does not contain a valid integer.
INVALID_PAGE_SIZE_IN_LIMIT_CLAUSE
The pageSize in the LIMIT clause does not contain a valid integer.
INVALID_DURING_CLAUSE
The DURING clause could not be parsed.
INVALID_MIN_DATE_IN_DURING_CLAUSE
The minimum date in the DURING clause is not a valid date in YYYYMMDD format.
INVALID_MAX_DATE_IN_DURING_CLAUSE
The maximum date in the DURING clause is not a valid date in YYYYMMDD format.
MAX_LESS_THAN_MIN_IN_DURING_CLAUSE
The minimum date in the DURING is after the maximum date.
VALIDATION_FAILED
The query matched the grammar, but is invalid in some way such as using a service that isn't supported.
QuotaCheckError Encapsulates the errors thrown during developer quota checks.
Enumerations
INVALID_TOKEN_HEADER
Customer passed in an invalid token in the header.
ACCOUNT_DELINQUENT
Customer is marked delinquent.
ACCOUNT_INACCESSIBLE
Customer is a fraudulent.
ACCOUNT_INACTIVE
Inactive Account.
INCOMPLETE_SIGNUP
Signup not complete
DEVELOPER_TOKEN_NOT_APPROVED
Developer token is not approved for production access, and the customer is attempting to access a production account.
TERMS_AND_CONDITIONS_NOT_SIGNED
Terms and conditions are not signed.
MONTHLY_BUDGET_REACHED
Monthly budget quota reached.
QUOTA_EXCEEDED
Monthly budget quota exceeded.
RangeError A list of all errors associated with the Range constraint.
Enumerations
TOO_LOW
TOO_HIGH
RateExceededError Signals that a call failed because a measured rate exceeded.
Enumerations
RATE_EXCEEDED
Rate exceeded.
ReadOnlyError Errors from attempting to write to read-only fields.
Enumerations
READ_ONLY
RegionCodeError A list of all errors associated with the @RegionCode constraints.
Enumerations
INVALID_REGION_CODE
RejectedError Indicates that a field was rejected due to compatibility issues.
Enumerations
UNKNOWN_VALUE
Unknown value encountered
RequestError Encapsulates the generic errors thrown when there's an error with user request.
Enumerations
UNKNOWN
Error reason is unknown.
INVALID_INPUT
Invalid input.
UNSUPPORTED_VERSION
The api version in the request has been discontinued. Please update to the new AdWords API version.
RequiredError Errors due to missing required field.
Enumerations
REQUIRED
Missing required field.
SelectorError Represents possible error codes for Selector.
Enumerations
INVALID_FIELD_NAME
The field name is not valid.
MISSING_FIELDS
The list of fields is null or empty.
MISSING_PREDICATES
The list of predicates is null or empty.
OPERATOR_DOES_NOT_SUPPORT_MULTIPLE_VALUES
Predicate operator does not support multiple values. Multiple values are supported only for Predicate.Operator.IN and Predicate.Operator.NOT_IN.
INVALID_PREDICATE_ENUM_VALUE
The predicate enum value is not valid.
MISSING_PREDICATE_OPERATOR
The predicate operator is empty.
MISSING_PREDICATE_VALUES
The predicate values are empty.
INVALID_PREDICATE_FIELD_NAME
The predicate field name is not valid.
INVALID_PREDICATE_OPERATOR
The predicate operator is not valid.
INVALID_FIELD_SELECTION
Invalid selection of fields.
INVALID_PREDICATE_VALUE
The predicate value is not valid.
INVALID_SORT_FIELD_NAME
The sort field name is not valid or the field is not sortable.
SELECTOR_ERROR
Standard error.
FILTER_BY_DATE_RANGE_NOT_SUPPORTED
Filtering by date range is not supported.
START_INDEX_IS_TOO_HIGH
Selector paging start index is too high.
TOO_MANY_PREDICATE_VALUES
The values list in a predicate was too long.
UNKNOWN_ERROR
Used for return value only. An enumeration could not be processed, typically due to incompatibility with your WSDL version.
SettingError Indicates a problem with campaign settings.
Enumerations
DUPLICATE_SETTING_TYPE
The campaign already has a setting of the type that is being added.
SETTING_TYPE_IS_NOT_AVAILABLE
The campaign setting is not available for this AdWords 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.
DYNAMIC_SEARCH_ADS_SETTING_CONTAINS_INVALID_DOMAIN_NAME
The supplied DynamicSearchAdsSetting contains an invalid domain 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.
UNKNOWN
Unspecified campaign setting error. Used for return value only. An enumeration could not be processed, typically due to incompatibility with your WSDL version.
SizeLimitError Indicates that the number of entries in the request or response exceeds the system limit.
Enumerations
REQUEST_SIZE_LIMIT_EXCEEDED
The number of entries in the request exceeds the system limit.
RESPONSE_SIZE_LIMIT_EXCEEDED
The number of entries in the response exceeds the system limit.
INTERNAL_STORAGE_ERROR
The account is too large to load.
UNKNOWN
Used for return value only. An enumeration could not be processed, typically due to incompatibility with your WSDL version.
StatsQueryError Represents possible error codes when querying for stats.
Enumerations
DATE_NOT_IN_VALID_RANGE
Date is outside of allowed range.
StringFormatError A list of error code for reporting invalid content of input strings.
Enumerations
UNKNOWN
ILLEGAL_CHARS
The input string value contains disallowed characters.
INVALID_FORMAT
The input string value is invalid for the associated field.
StringLengthError Errors associated with the length of the given string being out of bounds.
Enumerations
TOO_SHORT
TOO_LONG
UrlError Url Validation errors.
Enumerations
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.
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.
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}}).
INVALID_FINAL_MOBILE_URL
The final mobile url is invalid.
INVALID_FINAL_APP_URL
The final app url is invalid.
INVALID_TAG_IN_FINAL_MOBILE_URL
The final mobile url contains invalid tag.
INVALID_TAG_IN_FINAL_APP_URL
The final app 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}}).
REDUNDANT_NESTED_FINAL_APP_URL_TAG
The final app url contains nested occurrences of the same conditional tag (i.e. {ifmobile:{ifmobile:x}}).
URL_CUSTOM_PARAMETERS_COUNT_EXCEEDS_LIMIT
The number of url custom parameters for an entity exceeds the maximum limit allowed.
URL_CUSTOM_PARAMETER_REMOVAL_WITH_NON_NULL_VALUE
The parameter has isRemove set to true but a value that is non-null.
CANNOT_REMOVE_URL_CUSTOM_PARAMETER_IN_ADD_OPERATION
For add operations, there will not be any existing parameters to delete.
CANNOT_REMOVE_URL_CUSTOM_PARAMETER_DURING_FULL_REPLACEMENT
When the doReplace flag is set to true, individual parameters cannot be deleted.
NULL_CUSTOM_PARAMETER_VALUE_DURING_ADD_OR_FULL_REPLACEMENT
For ADD operations and when the doReplace flag is set to true, custom parameter values cannot be null.
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.
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_ERROR

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 3.0 License, and code samples are licensed under the Apache 2.0 License. For details, see our Site Policies.

Send feedback about...

This page
Documentation feedback
AdWords API
Product feedback