AdWords API
Feedback on this document

AdExtensionOverrideService (v201209)

Use this service to override a campaign's existing location extension for specific ads within that campaign. The following conditions apply to ad extension overrides:

  • Only location extensions can be overridden.
  • Before adding an override, the location extension must already have been added to the ad's campaign using a campaign ad extension.
  • Once you set the location for an ad extension override, it cannot be updated. If you delete the ad's override, any new overrides will inherit the location information from the deleted one.

For general information about ad extensions, see the AdWords Help Center.

This is disabled for AdX.
Production WSDL
https://adwords.google.com/api/adwords/cm/v201209/AdExtensionOverrideService?wsdl
Sandbox WSDL
https://adwords-sandbox.google.com/api/adwords/cm/v201209/AdExtensionOverrideService?wsdl
Namespace
https://adwords.google.com/api/adwords/cm/v201209
Operations
Errors

get

Returns a list of AdExtensionOverrides based on an AdExtensionOverrideSelector.

Parameters

Field Type Description
selector AdExtensionOverrideSelector The selector specifying the query.

Response

Field Type Description
rval AdExtensionOverridePage The page containing the AdExtensionOverride which meet the criteria specified by the selector.

mutate

Applies the list of mutate operations.

Conditions for adding an ad-level AdExtension override using an AdExtension under the Ad's campaign:

  1. If the text ad has never been overridden, an AdExtension override may be set on the creative using an extension under the campaign, along with any override info.
  2. If the text ad has been overriden before, the latitude/longitude of the new extension override must be the same as the previous override and no override info can be specified (i.e. the override info will inherit from the previous override info).

Parameters

Field Type Description
operations AdExtensionOverrideOperation[] The operations to apply. The same ad extension override cannot be specified in more than one operation.

Response

Field Type Description
rval AdExtensionOverrideReturnValue The applied ad extension overrides.

Errors

Error Reasons
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
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.
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
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
DistinctError Errors related to distinct ids or content.
Enumerations
DUPLICATE_ELEMENT
DUPLICATE_TYPE
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.
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.
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
OperatorError Errors due to the use of unsupported operations.
Enumerations
OPERATOR_NOT_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.
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
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.
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.
StringLengthError A list of all errors associated with the @ContentsString constraint.
Enumerations
TOO_SHORT
TOO_LONG

Authentication required

You need to be signed in with Google+ to do that.

Signing you in...

Google Developers needs your permission to do that.