AdWords API

AdWords API
Feedback on this document

AdGroupBidModifierService (v201306)

Service used to manage campaign criterion bid overrides at the ad group level. Currently supports platform (mobile) bid multiplier overrides only.

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

get

Gets ad group level criterion bid modifiers.

Parameters

Field Type Description
selector Selector The selector specifying the AdGroupBidModifiers to return.

Response

Field Type Description
rval AdGroupBidModifierPage A list of ad group bid modifiers.

mutate

Adds, removes or updates ad group bid modifier overrides.

Parameters

Field Type Description
operations AdGroupBidModifierOperation[] The operations to apply.

Response

Field Type Description
rval AdGroupBidModifierReturnValue The added ad group bid modifier overrides.

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.
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
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.
CANNOT_ADD_DISPLAY_ONLY_LISTS_TO_SEARCH_ONLY_CAMPAIGNS
Not allowed to add display only UserLists to search only campaigns.
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.
CANNOT_BID_MODIFY_NON_ENHANCED_CAMPAIGN
Only enhanced campaigns support bid modifier.
CANNOT_BID_MODIFY_DESKTOP
Cannot set bid modifier for Desktop criterion.
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.
CANNOT_ATTACH_CRITERIA_BIDDING_STRATEGY_ON_CONTENT_NETWORK_ONLY_CAMPAIGN
Cannot attach bidding strategy for campaigns opted in to content network only.
CANNOT_EXCLUDE_CRITERION
The Criterion is not allowed to be excluded.
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
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.
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.
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.
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.
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.
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.
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 Errors associated with the length of the given string being out of bounds.
Enumerations
TOO_SHORT
TOO_LONG

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.

Authentication required

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

Signing you in...

Google Developers needs your permission to do that.