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.

Note this service is similar to BulkMutateJobService and will eventually replace it. This new service supports a simplified API.

Keep in mind that using the simplified mutate will create a SimpleMutateJob, which should not be used with subsequent calls to BulkMutateJobService.

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/v201302/MutateJobService?wsdl

Namespace

https://adwords.google.com/api/adwords/cm/v201302

Operations

• get
• getResult
• mutate

Errors

• AdError
• AdExtensionError
• AdExtensionOverrideError
• AdGroupAdError
• AdGroupCriterionError
• AdGroupServiceError
• AdxError
• AuthenticationError
• AuthorizationError
• BetaError
• BiddingError
• BiddingErrors
• BiddingTransitionError
• BudgetError
• BulkMutateJobError
• CampaignAdExtensionError
• CampaignCriterionError
• CampaignError
• ClientTermsError
• CriterionError
• DatabaseError
• DateError
• DistinctError
• EntityAccessDenied
• EntityCountLimitExceeded
• EntityNotFound
• ForwardCompatibilityError
• IdError
• ImageError
• InternalApiError
• JobError
• MediaError
• NewEntityCreationError
• NotEmptyError
• NotWhitelistedError
• NullError
• OperationAccessDenied
• OperatorError
• PagingError
• PolicyViolationError
• QueryError
• QuotaCheckError
• QuotaError
• RangeError
• RateExceededError
• ReadOnlyError
• RegionCodeError
• RejectedError
• RequestError
• RequiredError
• SelectorError
• SettingError
• SizeLimitError
• StatsQueryError
• StringLengthError
• TargetError

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	JobSelector BulkMutateJobSelector

Response

Field	Type	Description
rval	Job[] BulkMutateJob 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	JobSelector 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.

You should not use the returned BulkMutateJobId with bulk API BulkMutateJobService.mutate method.

Parameters

Field	Type	Description
operations	Operation[] AdExtensionOverrideOperation AdGroupAdOperation AdGroupCriterionOperation AdGroupOperation BudgetOperation CampaignAdExtensionOperation CampaignCriterionOperation CampaignOperation CampaignTargetOperation
policy	BulkMutateJobPolicy

Response

Field	Type	Description
rval	SimpleMutateJob

Errors

Error	Reasons
AdError	Base error class for Ad Service. Enumerations 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_URL Cannot specify a url for the ad type 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_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. 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. 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_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. 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_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 UNSUPPORTED_PARENT_CAMPAIGN_FOR_DEVICE_PREFERENCE The associated campaign is not enhanced. INCOMPATIBLE_AD_TYPE_AND_DEVICE_PREFERENCE The device preference is not compatible with the ad type
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_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
AdExtensionOverrideError	AdExtensionOverride errors. Enumerations AD_ALREADY_HAS_ADEXTENSION_OVERRIDE Cannot override an ad that is already overriden with an adextension ADEXTENSION_ID_MUST_BE_SPECIFIED AdExtension id must be specified ADEXTENSION_LATITUTE_CANNOT_CHANGE_AFTER_BEING_SET_ONCE Latitutde of the new override must be the same as the first override set on the ad ADEXTENSION_LONGITUDE_CANNOT_CHANGE_AFTER_BEING_SET_ONCE Longitude of the new override must be the same as the first override set on the ad ADEXTENSION_NOT_UNDER_CAMPAIGN The adextension to use in overriding does not belong to the campaign CANNOT_OPERATE_ON_DELETED_OVERRIDE Cannot operate on a deleted adextension override CANNOT_OVERRIDE_EXTENSIONS_ON_NON_TEXT_AD Cannot override any other ad type besides a text ad CANNOT_OVERRIDE_USING_NON_LOCATION_EXTENSION Cannot override an ad using a non-location extension override INVALID_ADEXTENSION_ID Invalid adextension id LOCATION_OVERRIDE_INFO_REQUIRED_FOR_NEW_LOCATION_EXTENSION_OVERRIDE Location override info must be specified when overriding an ad for the first time OVERRIDE_INFO_MUST_BE_NULL_AFTER_BEING_SET_ONCE Location override info must not be specified once an ad has already been overrided once RADIUS_TOO_LARGE Radius is too large RADIUS_TOO_SMALL Radius is too small UNKNOWN_ADEXTENSION_OVERRIDE Unknown adextension override specified
AdGroupAdError	Error information for AdGroupAdService. Enumerations AD_NOT_UNDER_ADGROUP The specified ad was not found in the adgroup CANNOT_OPERATE_ON_DELETED_ADGROUPAD Deleted 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 INVALID_ID_FILTER_TYPE The valid field combinations to set in AdGroupCriterionIdFilter are: campaignId only, adGroupId only, criterionId only, and combination of (adGroupId, criterionId). ID_FILTERS_HAVE_DIFF_FIELDS_SET We require the list of AdGroupCriterionIdFilters all have the same set of the fields set. E.g, if one filter has only campaignId set, but another has only adGroupId set, then this error gets triggered. ID_FILTERS_HAVE_DIFF_FIELDS_SET, INAPPLICABLE_FOR_NEGATIVE When selecting negative criteria, filters may not be applied to biddable criteria. INAPPLICABLE_FILTER_SPECIFIED One or more filters specified are not applicable. TOO_MANY_OPERTAIONS Too many operations for a single call. CANT_UPDATE_NEGATIVE Negative ad group criteria are not updateable. TYPE_MISMATCH The wrong type (for the operation) was used. For example, if attempting to update an AdGroupCriterion of an existing adgroup but with a different biddability. 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. NETWORK_NOT_OVERRIDABLE CURRENCY_MISMATCH There is a mismatch between the given bid's currency and the account's currency. CRITERION_NOT_TARGETED Tried to do an operation for a targeted criterion. CANNOT_TARGET_AND_EXCLUDE Cannot target and exclude the same criterion at once. ILLEGAL_URL The URL of a placement is invalid. INVALID_VERTICAL_PATH The path specified for the vertical is invalid. NO_EFFECTIVE_BID_FOR_THIS_CRITERION Adding a criterion to an ad group would result in that criterion not having an effective bid under that ad group. 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 deleted biddable ad group criterion. 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. 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. INVALID_PRODUCT_FILTER Product filter in the product criteria is has invalid characters, Operand and the argument in the filter cannot have "==" or "&+". UNKNOWN
AdGroupServiceError	Represents possible error codes in AdGroupService. Enumerations DUPLICATE_ADGROUP_NAME AdGroup with the same name already exists for the campaign. INVALID_ADGROUP_ID AdGroup Id is not valid. INVALID_ADGROUP_NAME AdGroup name is not valid. USE_SET_OPERATOR_AND_MARK_STATUS_TO_DELETED Cannot delete an adgroup, adgroup status can be marked deleted 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_TOO_SMALL Bid amount is too small. BID_TYPE_AND_BIDDING_STRATEGY_MISMATCH AdGroup bid does not match the campaign's bidding strategy. INVALID_BID Invalid bid amoumt. MISSING_ADGROUP_NAME AdGroup name is required for Add. 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. 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.
BetaError	Errors that are thrown when a Beta feature is accessed incorrectly. Enumerations BETA_FEATURE Attempt to use beta feature by non-beta account.
BiddingError	Represents bidding errors. Enumerations BID_AMOUNT_REQUIRED Bid amount can not be null. 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. NON_POSITIVE_BID Bids must have a positive amount. BID_TOO_HIGH_FOR_DAILY_BUDGET Bid is too high for the daily budget. BID_TOO_HIGH_FOR_MONTHLY_BUDGET Bid is too high for the monthly budget. MUST_EXCLUDE_0_TO_17_WITH_OTHER_AGE_EXCLUSIONS Demographic targeting: Age 0-17 needs to be excluded for any other age to get excluded CAMPAIGN_MUST_HAVE_A_BUDGET_TO_ENABLE_BUDGET_OPTIMIZER Not allowed to enable budget optimizer, for a campaign with no budget. CANNOT_SET_CONTENT_BID_WITHOUT_SETTING_KEYWORD_MAX_CPC_AS_WELL Not allowed to set content bid without setting the keyword bid. 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. 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 PAY_PER_CONVERSION_NOT_ALLOWED_WITH_MANY_PER_CLICK Pay per conversion is not allowed with many per click TARGET_CPA_NOT_AVAILABLE_FOR_CUSTOMER Customer is not whitelisted to use target cpa MANY_PER_CLICK_NOT_AVAILABLE_FOR_CUSTOMER Customer is not whitelisted to use many per click CANNOT_SET_SITE_MAX_CPC Site cpc bid can not be set BID_ERROR Default bidding related error
BiddingErrors	Represents error codes for bidding strategy entities. Enumerations BIDDING_STRATEGY_OVERRIDE_NOT_ALLOWED Bidding strategy cannot override ad group or campaign bidding strategy. BIDDING_STRATEGY_TRANSITION_NOT_ALLOWED Cannot transition to new bidding strategy. PERCENT_CPA_NOT_AVAILABLE_FOR_CUSTOMER Percent Cpa not available for customer. Only whitelisted customers can use it. 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. 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. NOT_ENOUGH_CONVERSION_DATA Not enough right kind of data required for conversion or not enough data in last 3 days suggesting the campaign is not stable enough to enter into conversion optimizer. 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. 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. UNKNOWN
BiddingTransitionError	Bidding transition errors. Enumerations BID_TO_POSITION_ENABLED Transition is not allowed since Bid to position is enabled. BIDDING_STRATEGY_NOT_AVAILABLE_FOR_ACCOUNT_TYPE Bidding strategy is not available for the account type. BUDGET_OPTIMIZER_IS_ENABLED Transition is not allowed for budget optimizer campaign. CONVERSION_OPTIMIZER_IS_ENABLED Transition is not allowed for conversion optimizer campaign. CONVERSION_TRACKING_NOT_ENABLED Conversion tracking is not enabled for the campaign for VBB transition. CONVERSION_TRACKING_NOT_AVAILABLE_FOR_ACCOUNT_TYPE Conversion tracking is not available for the account type. USE_POSITION_PREFERENCE_IN_MANUALCPC_INSTEAD_TO_DISABLE_POSITION_PREFERENCE Disable position preference by setting the position preference off on Campaign. INVALID_BID Explicit bid is invalid for the transition CANNOT_SET_EXPLICIT_BID Cannot set explicit bid for adgroups for transition e.g. ManualCPC from BudgetOptimizer, it takes the proxy bids. EXPLICIT_BID_REQUIRED_FOR_TRANSITION Explicit bid is required for bidding transition e.g. ManualCPC <-> ManualCPM EXPLICIT_BID_TYPE_DOES_NOT_MATCH_CAMPAIGN_BIDDING_STRATEGY Explicit bid specified for the bidding transition should match the bidding strategy, the campaign is transitioning to. MISSING_REQUIRED_BID The required bid for transition is missing INVALID_STATUS Campaign has invalid status, it is deleted or suggested IS_CPM_CAMPAIGN Transition is not allowed since campaign is a CPM campaign. IS_PERCENT_CPA_CAMPAIGN Transition is not allowed since campaign is a percent CPA campaign. NOT_THE_PREVIOUS_BIDDING_STRATEGY In case of budget optimizer, the only transition allowed is a switch to the previous strategy. NOT_ENOUGH_CONVERSION_DATA Not enough right kind of data required for conversion or not enough data in last 3 days suggesting the campaign is not stable enough to enter into conversion optimizer. NOT_ENOUGH_CONVERSIONS Not enough conversions tracked for VBB transitions. OPTED_IN_SEARCH Campaign is on search network - so can not switch to CPM. PROXY_BIDDING_ON Proxy bidding is on. SITE_REMNANT_RESERVATION_ALLOWED Can not switch to manual CPC if campaign allows site remnant reservation bid type. TRANSITION_TO_ITSELF Transition to itself is not allowed. UNKNOWN_BIDDING_STRATEGY Unknown Bidding strategy UNSUPPORTED_TRANSITION Transition is not supported. VCG_ENABLED Transition not allowed since VCG is enabled. BIDDING_TRANSITION_FAILED Bidding transition failed. This is a default bidding transition error in case no other error matches. Please use a specific error. ACCELERATED_DELIVERY_NOT_SUPPORTED_FOR_BUDGET_OPTIMIZER Accelerated delivery method is not supported for budget optimizer. HAS_ACTIVE_EXPERIMENT Bidding transition is prohibited for campaigns having an active experiment INCOMPATIBLE_WITH_CAMPAIGN_SETTING Target bidding strategy is incompatible with a campaign setting.
BudgetError	A list of all the error codes being used by the common budget domain package. Enumerations BUDGET_DELETED 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_SET_ACCELERATED_DELIVERY_FOR_BUDGET_SHARED_BY_BUDGET_OPTIMIZER_CAMPAIGN This budget is currently associated with a @link{BudgetOptimizer} campaign, so it must use the STANDARD delivery method. 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_DELETED_CAMPAIGN_ADEXTENSION Cannot add a CampaignAdExtension with status DELETED CANNOT_OPERATE_ON_DELETED_CAMPAIGN_ADEXTENSION Cannot operate on a CampaignAdExtension with status DELETED INVALID_ADEXTENSION_ID Invalid adextension id MISSING_ADEXTENSION_ID Missing adextension id MUST_USE_CONCRETE_ADEXTENSION_DURING_ADD Must use a concrete subtype of AdExtension (eg. LocationExtension) MUST_USE_CONCRETE_ADEXTENSION Must use a concrete subtype of AdExtension (eg. LocationExtension) UNKNOWN_ERROR
CampaignCriterionError	Base error class for Campaign Criterion Service. Enumerations CRITERIA_QUOTA_EXCEEDED The operation would result in more campaign criteria than allowed. CONCRETE_TYPE_REQUIRED Concrete type of criterion (keyword v.s. placement) is required for ADD and SET operations. ID_FILTERS_HAVE_DIFF_FIELDS_SET Id filters have different combinations of field settings (they should all be the same). INVALID_EXCLUDED_CATEGORY The category requested for exclusion is invalid. INVALID_KEYWORD_TEXT Invalid keyword criteria text. INVALID_PLACEMENT_URL Invalid placement URL. INVALID_VERTICAL_PATH Invalid vertical path LICENSED_USERLISTS_NOT_ALLOWED Not allowed to exclude licensed user list. CANNOT_EXCLUDE_ALL_PLATFORMS Cannot exclude all platforms. 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_EXCLUDE_PLATFORM_CRITERION Cannot exclude platform criterion, i.e. this platform criterion has been already excluded. 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. UNKNOWN
CampaignError	Base error class for Campaign Service. Enumerations AFTER_MAXIMUM_ALLOWABLE_DATE A date was used that is past the system "last" date. CANNOT_GO_BACK_TO_INCOMPLETE A complete campaign cannot go back to being incomplete CANNOT_MODIFY_START_DATE_IF_ALREADY_STARTED Trying to change start date on a campaign that has started. CANNOT_SET_ACCELERATED_DELIVERY_FOR_BUDGET_OPTIMIZER_CAMPAIGN An accelerated delivery method was specified for a budget optimizer campaign. CANNOT_SET_END_DATE_BEFORE_EXPERIMENT_END_DATE Trying to modify an end date before an active experiment end date. CANNOT_SET_DATE_TO_PAST Trying to modify a date into the past. CANNOT_SET_POSITION_PREFERENCE_IF_NOT_SEARCH_TARGETED The campaign is not search targeted to enable position preference CURRENCY_NOT_VALID_FOR_ACCOUNT A currency was specified other than the account currency. DUPLICATE_CAMPAIGN_NAME Trying to modify name of campaign to one already assigned to another 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. KEYWORD_QUOTA_EXCEEDED Customer keyword quota has been exceeded. MAX_IMPRESSIONS_NOT_IN_RANGE The maximum number of impressions for Frequency Cap should be an integer greater than 0. START_DATE_AFTER_END_DATE The campaign start date was after the campaign end date. TIME_UNIT_NOT_SUPPORTED Only the Day, Week and Month time units are supported. USE_BIDDING_TRANSITION_FIELD_INSTEAD_TO_SWITCH_BIDDING_STRATEGY Bidding strategy field was set to a value other than the current bidding strategy of the campaign CANNOT_CHANGE_CAMPAIGN_TYPE Changing campaignType is not allowed INVALID_OPERATION_IF_SERVING_STATUS_HAS_ENDED Operation not allowed on a campaign whose serving status has ended CANNOT_CHANGE_TV_CAMPAIGN Modifying TV Campaigns is not allowed CANNOT_ADD_CAMPAIGN_WITH_CONVERSION_OPTIMIZER_BIDDING_STRATEGY Cannot add a campaign with conversion optimizer turned on CANNOT_SET_BUDGET Campaigns with percent cpa bidding strategy do not have budgets MUST_SPECIFY_KEYWORD_MATCH_SETTINGS All new campaigns must specify KeywordMatchSetting BIDDING_STRATEGY_NOT_SUPPORTED_WITH_BID_MODIFIER The strategy is not supported when there are campaign criteria with bid modifiers. BIDDING_STRATEGY_NOT_SUPPORTED_WITH_AD_SCHEDULE Budget Optimizer bidding strategy is not supported for AdSchedule targets. 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
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. 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. 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. 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. 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_NEGATIVE_CRITERION Cannot set bid modifier for a negative criterion. CANNOT_ADD_BID_MODIFIER_FOR_BIDDING_STRATEGY Campaign's bidding strategy does not support bid modifiers. 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 the campaign's bidding strategy. 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. 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.
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 CAMPAIGN_LIMIT ADGROUP_LIMIT ADGROUP_TEXT_AD_LIMIT Specifies max number of ads not intended for Display Network; applies to MobileAd, TextAd, TemplateAd (text templates only). ADGROUP_DISPLAY_AD_LIMIT Specifies max number of Display Network ads; applies to ImageAd, MobileImageAd, TemplateAd (except text templates). 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.
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
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. 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. 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
NewEntityCreationError	Error associated with creation of new entities using TempIds. 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
NotWhitelistedError	Indicates that the customer is not whitelisted for accessing the API. Enumerations CUSTOMER_NOT_WHITELISTED_FOR_API Customer is not whitelisted for accessing the API.
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. 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 INCOMPLETE_SIGNUP_LATEST_ADWORDS_API_TNC_NOT_AGREED Latest AdWords API T&C not agreed. INCOMPLETE_SIGNUP_NO_BILLING_INFO No Billing Info. INCOMPLETE_SIGNUP_USER_INFO_MISSING User Info missing. INCOMPLETE_SIGNUP_USER_INFO_PENDING User Info pending. INCOMPLETE_SIGNUP_USER_INFO_REJECTED User Info rejected. MONTHLY_BUDGET_REACHED Monthly budget quota reached. QUOTA_EXCEEDED Monthly budget quota exceeded.
QuotaError	Errors that are thrown if a quota limit is exceeded. Enumerations TOO_MANY_ADGROUPS_PER_CAMPAIGN Too many ad groups per campaign. TOO_MANY_CAMPAIGNS_PER_ACCOUNT Too many campaigns per account. TOO_MANY_CONVERSION_TYPES_PER_ACCOUNT Too many conversion types per account. TOO_MANY_KEYWORDS_PER_ADGROUP Too many keywords per ad group. TOO_MANY_KEYWORDS_PER_CAMPAIGN Too many keywords per campaign. TOO_MANY_KEYWORDS_PER_CUSTOMER Too many keywords per customer. TOO_MANY_SITES_PER_ADGROUP Too many sites per ad group. TOO_MANY_SITES_PER_CAMPAIGN Too many sites per campaign. TOO_MANY_CRITERIA_PER_ACCOUNT Too many campaign level negative keywords + negative sites + geo targets for the account. UNKNOWN
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.
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. 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_REQUIRES_CAMPAIGN_TARGET_RESTRICT_SETTING TargetingSetting for AdGroups requires a TargetRestrictSetting be added to the campaign with useAdGroup set to true. TARGET_RESTRICT_SETTING_CANNOT_BE_REVERSED TargetRestrictSetting useAdGroup cannot be reversed from true back to false. 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. 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. 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.
StringLengthError	Errors associated with the length of the given string being out of bounds. Enumerations TOO_SHORT TOO_LONG
TargetError	A list of all the error codes being used by the common targeting package. Enumerations AD_SCHEDULE_ADVANCED_INCOMPATIBLE_WITH_CONVERSION_OPTIMIZER Cannot enable advanced ad scheduling for a conversion optimizer campaign. AD_SCHEDULE_BID_MULTIPLIER_MALFORMED Bid multiplier could not be parsed as a number; it was malformed. AD_SCHEDULE_BID_MULTIPLIER_TOO_BIG Bid multiplier was too big. AD_SCHEDULE_BID_MULTIPLIER_TOO_SMALL Bid multiplier was too small. AD_SCHEDULE_BID_MULTIPLIER_TOO_MANY_FRACTION_DIGITS Bid multiplier has too many decimal digits. AD_SCHEDULE_EXCEEDED_INTERVALS_PER_DAY_LIMIT The number of intervals per day limit was exceeded. AD_SCHEDULE_EXCEEDS_PAST_END_OF_WEEK The required times must be on or before the end of the week (Sunday at 11:45pm). AD_SCHEDULE_INCOMPATIBILITY Cannot enable ad scheduling for the campaign. AD_SCHEDULE_INCOMPATIBLE_WITH_BUDGET_OPTIMIZER Cannot enable ad scheduling for a budget optimizer campaign. AD_SCHEDULE_INTERVAL_CANNOT_SPAN_MULTIPLE_DAYS The start and end times are not on the same day. AD_SCHEDULE_INVALID_DAY_OF_THE_WEEK Integer representation day of the week is not within proper range AD_SCHEDULE_INVALID_TIME_INTERVAL The start time is not less than the end time. AD_SCHEDULE_NO_INTERVALS_WHILE_ENABLED Enabled ad schedule does not have at least one interval. AD_SCHEDULE_NOT_MULTIPLE_OF_15_MINUTES The required times must be a multiple of 15 minutes. AD_SCHEDULE_TIME_INTERVALS_OVERLAP Two time intervals overlap each other. CANNOT_EXCLUDE_CITY Cannot exclude city. CANNOT_EXCLUDE_IF_NOT_TARGETED Cannot exclude a location that is not being targeted by an enclosing location. CANNOT_EXCLUDE_METRO Cannot exclude metro. CANNOT_EXCLUDE_PROVINCE Cannot exclude province. CANNOT_OPT_OUT_GOOGLE_SEARCH_WHILE_BID_TO_POSITION_ENABLE Cannot opt out from Google Search while position preference enabled. CANNOT_TARGET_AGE_WITHOUT_GENDER Cannot target an age segment without targeting at least one gender segment. CANNOT_TARGET_CITY Cannot target city. CANNOT_TARGET_CONTENT_CONTEXTUAL_WITHOUT_CONTENT_NETWORK Cannot cover content contextual without content network. CANNOT_MODIFY_CONTENT_CONTEXTUAL Cannot modify content contextual on campaigns setup to use AdGroup level targeting settings. This is specified using TargetRestrictSetting. Note that TargetRestrictSetting is set automatically for all campaigns created after version v201206. CANNOT_TARGET_COUNTRY Cannot target country. CANNOT_TARGET_COVERAGE The requested network coverage modification is prohibited. CANNOT_TARGET_GENDER_WITHOUT_AGE Cannot target a gender segment without targeting at least one age segment. CANNOT_TARGET_GOOGLE_SEARCH_FOR_CPM_CAMPAIGN Cannot target Google Search network for a CPM campaign. CANNOT_TARGET_LANGUAGE Specified language cannot be targeted. CANNOT_TARGET_METRO Cannot target metro. CANNOT_TARGET_MOBILE_CARRIER Specified Mobile carrier cannot be targeted CANNOT_TARGET_PROVINCE Cannot target province. CANNOT_TARGET_SEARCH_SYNDICATION_WITHOUT_GOOGLE_SEARCH Cannot cover search syndication network without google search network. CANNOT_TARGET_SYNDICATABLE_TYPES Cannot target any syndicatable types. CANNOT_TARGET_THE_SAME_TARGET_LIST_TYPE_MULTIPLE_TIMES Cannot target the same target list type twice. DEMOGRAPHIC_BID_MODIFIER_SHOULD_BE_IN_BETWEEN_0_AND_500 The bid modifier of a demographic target should be in the [0, 500] range. INVALID_CITY_CODE A city could not be matched with the provided input. INVALID_CITYNAME_LENGTH CityName is too long. INVALID_EXCLUDED_POLYGON_TARGET Polygon targets cannot be excluded. INVALID_EXCLUDED_PROXIMITY_TARGET Proximity targets cannot be excluded INVALID_LANGUAGE_CODE Language code specified is invalid. INVALID_LATITUDE Latitude supplied with the target is invalid. INVALID_LONGITUDE Longitude supplied with the target is invalid. INVALID_METRO_CODE Metro code specified is invalid. INVALID_MOBILE_CARRIER Mobile Carrier specified is invalid. INVALID_MOBILE_PLATFORM Mobile Platform is invalid. INVALID_POSTALCODE_LENGTH PostalCode is too long. INVALID_PROVINCE_CODE Province code specified is invalid. INVALID_PROXIMITY_RADIUS Radius supplied with the proximity target is invalid. INVALID_REGIONCODE_LENGTH RegionCode is too long. INVALID_REGIONNAME_LENGTH RegionName is too long. INVALID_STREETADDRESS_LENGTH StreetAddress is too long. MULTIPLE_OCCURRENCES_OF_SAME_TARGET Multiple occurrences of the same target were encountered. POLYGON_DUPLICATE_VERTICES A PolygonTarget point is duplicated. POLYGON_EDGES_INTERSECT A PolygonTarget has edges that intersect. POLYGON_TOO_FEW_VERTICES A PolygonTarget has too few vertices. POLYGON_TOO_MANY_VERTICES A polygonTarget has too many vertices. (more than 100) POLYGON_TOO_LARGE A PolygonTarget is too large. TARGETING_VALIDATION_FAILED A validation error was encountered; however, a more detailed TargetingValidationError usually has already been provided. TARGETING_CROSS_COUNTRY_REGIONAL Region spanning multiple countries. TARGETING_EXCLUSION_NOT_SUPPORTED The given exclusion is not supported. TARGETING_INCOMPATIBLE_LOCATION_TYPES The location types are incompatible for targeting. TARGETING_NOT_SUPPORTED The targeting is not supported. TARGETING_TOO_MANY_REGIONS There are too many regions. TOO_MANY_EXCLUDED_LOCATIONS There are too many excluded locations. TOO_MANY_TARGETED_LOCATIONS There are too many targeted locations. WARNING_MAY_NOW_REQUIRE_CHINESE_APPROVAL This is for warnings which is currently not being passed back to the client. WARNING_NOW_REQUIRES_CHINESE_APPROVAL This is for warnings which is currently not being passed back to the client. WARNING_NOW_TARGETS_CHINA This is for warnings which is currently not being passed back to the client. WARNING_NOW_TARGETS_CHINESE This is for warnings which is currently not being passed back to the client. TARGET_ERROR The target error is unknown.

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.

Last updated June 12, 2013.