Hide

CampaignExtensionSettingService (v201506)

Service used to manage extensions at the campaign level. The extensions are managed by AdWords using existing feed services, including creating and modifying feeds, feed items, and campaign feeds for the user.


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

get

Returns a list of CampaignExtensionSettings that meet the selector criteria.

Parameters

Field Type Description
selector Selector Determines which CampaignExtensionSettings to return. If empty, all CampaignExtensionSettings are returned.

Response

Field Type Description
rval CampaignExtensionSettingPage The list of CampaignExtensionSettings specified by the selector.

mutate

Applies the list of mutate operations (add, remove, and set).

Parameters

Field Type Description
operations CampaignExtensionSettingOpe...[] The operations to apply. The same CampaignExtensionSetting cannot be specified in more than one operation.

Response

Field Type Description
rval CampaignExtensionSettingRet... The changed CampaignExtensionSettings.

query

Returns a list of CampaignExtensionSettings that match the query.

Parameters

Field Type Description
query xsd:string The SQL-like AWQL query string.

Response

Field Type Description
rval CampaignExtensionSettingPage The list of CampaignExtensionSettings specified by the query.

Errors

Error Reasons
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.
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
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.
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.
ExtensionSettingError Represents an error for various extension setting services.
Enumerations
EXTENSIONS_REQUIRED
A platform restriction was provided without input extensions or existing extensions.
FEED_TYPE_EXTENSION_TYPE_MISMATCH
The provided feed type does not correspond to the provided extensions.
INVALID_FEED_TYPE
The provided feed type cannot be used.
INVALID_FEED_TYPE_FOR_CUSTOMER_EXTENSION_SETTING
The provided feed type cannot be used at the customer level.
CANNOT_CHANGE_FEED_ITEM_ON_ADD
Can not change a feed item field on an ADD operation.
NO_EXISTING_AD_GROUP_EXTENSION_SETTING_FOR_TYPE
There is no existing AdGroupExtensionSetting for this type.
NO_EXISTING_CAMPAIGN_EXTENSION_SETTING_FOR_TYPE
There is no existing CampaignExtensionSetting for this type.
NO_EXISTING_CUSTOMER_EXTENSION_SETTING_FOR_TYPE
There is no existing CustomerExtensionSetting for this type.
AD_GROUP_EXTENSION_SETTING_ALREADY_EXISTS
The AdGroupExtensionSetting already exists. SET should be used to modify the existing AdGroupExtensionSetting.
CAMPAIGN_EXTENSION_SETTING_ALREADY_EXISTS
The CampaignExtensionSetting already exists. SET should be used to modify the existing CampaignExtensionSetting.
CUSTOMER_EXTENSION_SETTING_ALREADY_EXISTS
The CustomerExtensionSetting already exists. SET should be used to modify the existing CustomerExtensionSetting.
AD_GROUP_FEED_ALREADY_EXISTS_FOR_PLACEHOLDER_TYPE
An active ad group feed already exists for this place holder type.
CAMPAIGN_FEED_ALREADY_EXISTS_FOR_PLACEHOLDER_TYPE
An active campaign feed already exists for this place holder type.
CUSTOMER_FEED_ALREADY_EXISTS_FOR_PLACEHOLDER_TYPE
An active customer feed already exists for this place holder type.
VALUE_OUT_OF_RANGE
Value is not within the accepted range.
URL_LIST_TOO_LONG
Url list is too long.
CANNOT_SET_WITH_FINAL_URLS
Cannot simultaneously set sitelink field with final urls.
CANNOT_SET_WITHOUT_FINAL_URLS
Must set field with final urls.
CANNOT_SET_BOTH_DESTINATION_URL_AND_TRACKING_URL_TEMPLATE
Cannot simultaneously set sitelink url field with tracking url template.
INVALID_PHONE_NUMBER
Phone number for a call extension is invalid.
PHONE_NUMBER_NOT_SUPPORTED_FOR_COUNTRY
Phone number for a call extension is not supported for the given country code.
CARRIER_SPECIFIC_SHORT_NUMBER_NOT_ALLOWED
A carrier specific number in short format is not allowed for call extensions.
PREMIUM_RATE_NUMBER_NOT_ALLOWED
Premium rate numbers are not allowed for call extensions.
DISALLOWED_NUMBER_TYPE
Phone number type for a call extension is not allowed.
INVALID_DOMESTIC_PHONE_NUMBER_FORMAT
Phone number for a call extension does not meet domestic format requirements.
VANITY_PHONE_NUMBER_NOT_ALLOWED
Vanity phone numbers (i.e. those including letters) are not allowed for call extensions.
INVALID_COUNTRY_CODE
Country code provided for a call extension is invalid.
INVALID_CALL_CONVERSION_TYPE_ID
Call conversion type id provided for a call extension is invalid.
CUSTOMER_NOT_WHITELISTED_FOR_CALLTRACKING
For a call extension, the customer is not whitelisted for call tracking.
CALLTRACKING_NOT_SUPPORTED_FOR_COUNTRY
Call tracking is not supported for the given country for a call extension.
INVALID_APP_ID
App id provided for an app extension is invalid.
QUOTES_IN_REVIEW_EXTENSION_SNIPPET
Quotation marks present in the review text for a review extension.
HYPHENS_IN_REVIEW_EXTENSION_SNIPPET
Hyphen character present in the review text for a review extension.
REVIEW_EXTENSION_SOURCE_INELIGIBLE
A blacklisted review source name or url was provided for a review extension.
SOURCE_NAME_IN_REVIEW_EXTENSION_TEXT
Review source name should not be found in the review text.
MISSING_FIELD
Field must be set.
INVALID_DEVICE_PREFERENCE
Unknown or unsupported device preference.
INVALID_SCHEDULE_END
Invalid feed item schedule end time (i.e., endHour = 24 and endMinute != 0).
DATE_TIME_MUST_BE_IN_ACCOUNT_TIME_ZONE
Date time zone does not match the account's time zone.
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
IdError Errors associated with the ids.
Enumerations
NOT_FOUND
Id not found
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.
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).
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
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.
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.
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

Send feedback about...

AdWords API