TargetingIdeaService (v201809)

Use this service to generate new keyword ideas based on the parameters specified in the selector. See the TargetingIdeaSelector documentation for more details.

You can also use this service to retrieve statistics for existing keyword ideas by setting the selector's requestType to RequestType.STATS and passing in the appropriate search parameters.

Production WSDL
https://adwords.google.com/api/adwords/o/v201809/TargetingIdeaService?wsdl
Namespace
https://adwords.google.com/api/adwords/o/v201809
Operations
Errors

get

Returns a page of ideas that match the query described by the specified TargetingIdeaSelector.

The selector must specify a paging value, with numberResults set to 700 or less. Large result sets must be composed through multiple calls to this method, advancing the paging startIndex value by numberResults with each call.

Parameters

Field Type Description
selector TargetingIdeaSelector Query describing the types of results to return when finding matches (similar keyword ideas).

Response

Field Type Description
rval TargetingIdeaPage A TargetingIdeaPage of results, that is a subset of the list of possible ideas meeting the criteria of the TargetingIdeaSelector.

Errors

Error Reasons
AdGroupCriterionError Base error class for Ad Group Criterion Service.
Enumerations
AD_GROUP_CRITERION_LABEL_DOES_NOT_EXIST
No link found between the AdGroupCriterion and the label.
AD_GROUP_CRITERION_LABEL_ALREADY_EXISTS
The label has already been attached to the AdGroupCriterion.
CANNOT_ADD_LABEL_TO_NEGATIVE_CRITERION
Negative AdGroupCriterion cannot have labels.
TOO_MANY_OPERATIONS
Too many operations for a single call.
CANT_UPDATE_NEGATIVE
Negative ad group criteria are not updateable.
CONCRETE_TYPE_REQUIRED
Concrete type of criterion (keyword v.s. placement) is required for ADD and SET operations.
BID_INCOMPATIBLE_WITH_ADGROUP
Bid is incompatible with ad group's bidding settings.
CANNOT_TARGET_AND_EXCLUDE
Cannot target and exclude the same criterion at once.
ILLEGAL_URL
The URL of a placement is invalid.
INVALID_KEYWORD_TEXT
Keyword text was invalid.
INVALID_DESTINATION_URL
Destination URL was invalid.
MISSING_DESTINATION_URL_TAG
The destination url must contain at least one tag (e.g. {lpurl})
KEYWORD_LEVEL_BID_NOT_SUPPORTED_FOR_MANUALCPM
Keyword-level cpm bid is not supported
INVALID_USER_STATUS
For example, cannot add a biddable ad group criterion that had been removed.
CANNOT_ADD_CRITERIA_TYPE
Criteria type cannot be targeted for the ad group. Either the account is restricted to keywords only, the criteria type is incompatible with the campaign's bidding strategy, or the criteria type can only be applied to campaigns.
CANNOT_EXCLUDE_CRITERIA_TYPE
Criteria type cannot be excluded for the ad group. Refer to the documentation for a specific criterion to check if it is excludable.
INVALID_PRODUCT_PARTITION_HIERARCHY
Ad group is invalid due to the product partitions it contains.
PRODUCT_PARTITION_UNIT_CANNOT_HAVE_CHILDREN
Product partition unit cannot have children.
PRODUCT_PARTITION_SUBDIVISION_REQUIRES_OTHERS_CASE
Subdivided product partitions must have an "others" case.
PRODUCT_PARTITION_REQUIRES_SAME_DIMENSION_TYPE_AS_SIBLINGS
Dimension type of product partition must be the same as that of its siblings.
PRODUCT_PARTITION_ALREADY_EXISTS
Product partition cannot be added to the ad group because it already exists.
PRODUCT_PARTITION_DOES_NOT_EXIST
Product partition referenced in the operation was not found in the ad group.
PRODUCT_PARTITION_CANNOT_BE_REMOVED
Recursive removal failed because product partition subdivision is being created or modified in this request.
INVALID_PRODUCT_PARTITION_TYPE
Product partition type is not allowed for specified AdGroupCriterion type.
PRODUCT_PARTITION_ADD_MAY_ONLY_USE_TEMP_ID
Product partition in an ADD operation specifies a non temporary CriterionId.
CAMPAIGN_TYPE_NOT_COMPATIBLE_WITH_PARTIAL_FAILURE
Partial failure is not supported for shopping campaign mutate operations.
OPERATIONS_FOR_TOO_MANY_SHOPPING_ADGROUPS
Operations in the mutate request changes too many shopping ad groups. Please split requests for multiple shopping ad groups across multiple requests.
CANNOT_MODIFY_URL_FIELDS_WITH_DUPLICATE_ELEMENTS
Not allowed to modify url fields of an ad group criterion if there are duplicate elements for that ad group criterion in the request.
CANNOT_SET_WITHOUT_FINAL_URLS
Cannot set url fields without also setting final urls.
CANNOT_CLEAR_FINAL_URLS_IF_FINAL_MOBILE_URLS_EXIST
Cannot clear final urls if final mobile urls exist.
CANNOT_CLEAR_FINAL_URLS_IF_FINAL_APP_URLS_EXIST
Cannot clear final urls if final app urls exist.
CANNOT_CLEAR_FINAL_URLS_IF_TRACKING_URL_TEMPLATE_EXISTS
Cannot clear final urls if tracking url template exists.
CANNOT_CLEAR_FINAL_URLS_IF_URL_CUSTOM_PARAMETERS_EXIST
Cannot clear final urls if url custom parameters exist.
CANNOT_SET_BOTH_DESTINATION_URL_AND_FINAL_URLS
Cannot set both destination url and final urls.
CANNOT_SET_BOTH_DESTINATION_URL_AND_TRACKING_URL_TEMPLATE
Cannot set both destination url and tracking url template.
FINAL_URLS_NOT_SUPPORTED_FOR_CRITERION_TYPE
Final urls are not supported for this criterion type.
FINAL_MOBILE_URLS_NOT_SUPPORTED_FOR_CRITERION_TYPE
Final mobile urls are not supported for this criterion type.
UNKNOWN
AdxError Errors that are thrown when a non-AdX feature is accessed by an AdX customer.
Enumerations
UNSUPPORTED_FEATURE
Attempt to use non-AdX feature by AdX customer.
AuthenticationError Errors returned when Authentication failed.
Enumerations
AUTHENTICATION_FAILED
Authentication of the request failed.
CLIENT_CUSTOMER_ID_IS_REQUIRED
Client Customer Id is required if CustomerIdMode is set to CLIENT_EXTERNAL_CUSTOMER_ID. Starting version V201409 ClientCustomerId will be required for all requests except for CustomerService.get
CLIENT_EMAIL_REQUIRED
Client Email is required if CustomerIdMode is set to CLIENT_EXTERNAL_EMAIL_FIELD.
CLIENT_CUSTOMER_ID_INVALID
Client customer Id is not a number.
CLIENT_EMAIL_INVALID
Client customer Id is not a number.
CLIENT_EMAIL_FAILED_TO_AUTHENTICATE
Client email is not a valid customer email.
CUSTOMER_NOT_FOUND
No customer found for the customer id provided in the header.
GOOGLE_ACCOUNT_DELETED
Client's Google Account is deleted.
GOOGLE_ACCOUNT_COOKIE_INVALID
Google account login token in the cookie is invalid.
FAILED_TO_AUTHENTICATE_GOOGLE_ACCOUNT
problem occurred during Google account authentication.
GOOGLE_ACCOUNT_USER_AND_ADS_USER_MISMATCH
The user in the google account login token does not match the UserId in the cookie.
LOGIN_COOKIE_REQUIRED
Login cookie is required for authentication.
NOT_ADS_USER
User in the cookie is not a valid Ads user.
OAUTH_TOKEN_INVALID
Oauth token in the header is not valid.
OAUTH_TOKEN_EXPIRED
Oauth token in the header has expired.
OAUTH_TOKEN_DISABLED
Oauth token in the header has been disabled.
OAUTH_TOKEN_REVOKED
Oauth token in the header has been revoked.
OAUTH_TOKEN_HEADER_INVALID
Oauth token HTTP header is malformed.
LOGIN_COOKIE_INVALID
Login cookie is not valid.
FAILED_TO_RETRIEVE_LOGIN_COOKIE
Failed to decrypt the login cookie.
USER_ID_INVALID
User Id in the header is not a valid id.
AuthorizationError Errors encountered when trying to authorize a user.
Enumerations
UNABLE_TO_AUTHORIZE
Could not complete authorization due to an internal problem.
NO_ADWORDS_ACCOUNT_FOR_CUSTOMER
Customer has no AdWords account.
USER_PERMISSION_DENIED
User doesn't have permission to access customer.
EFFECTIVE_USER_PERMISSION_DENIED
Effective user doesn't have permission to access this customer.
CUSTOMER_NOT_ACTIVE
Access denied since the customer is not active.
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.
TWO_STEP_VERIFICATION_NOT_ENROLLED
The customer has a policy to enforce 2-Step Verification, but the user is not enrolled.
ADVANCED_PROTECTION_NOT_ENROLLED
The customer has a policy to enforce enrollment in the Advanced Protection Program, but the user is not enrolled.
BudgetError A list of all the error codes being used by the common budget domain package.
Enumerations
BUDGET_CANNOT_BE_EXPLICITLY_SHARED
Budgets cannot be shared.
BUDGET_REMOVED
The requested budget no longer exists.
BUDGET_ERROR
Default budget error.
BUDGET_IN_USE
The budget is associated with at least one campaign, and so the budget cannot be removed.
BUDGET_PERIOD_NOT_AVAILABLE
Customer is not whitelisted for this budget period.
CANNOT_EDIT_SHARED_BUDGET
Customer cannot use CampaignService to edit a shared budget.
CANNOT_MODIFY_FIELD_OF_IMPLICITLY_SHARED_BUDGET
This field is not mutable on implicitly shared budgets
CANNOT_UPDATE_BUDGET_TO_IMPLICITLY_SHARED
Cannot change explicitly shared budgets back to implicitly shared ones.
CANNOT_UPDATE_BUDGET_TO_EXPLICITLY_SHARED_WITHOUT_NAME
An implicit budget without a name cannot be changed to explicitly shared budget.
CANNOT_UPDATE_BUDGET_TO_EXPLICITLY_SHARED
Cannot change an implicitly shared budget to an explicitly shared one.
CANNOT_USE_IMPLICITLY_SHARED_BUDGET_WITH_MULTIPLE_CAMPAIGNS
Only explicitly shared budgets can be used with multiple campaigns.
DUPLICATE_NAME
A budget with this name already exists.
MONEY_AMOUNT_IN_WRONG_CURRENCY
A money amount was not in the expected currency.
MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC
A money amount was less than the minimum CPC for currency.
MONEY_AMOUNT_TOO_LARGE
A money amount was greater than the maximum allowed.
NEGATIVE_MONEY_AMOUNT
A money amount was negative.
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT
A money amount was not a multiple of a minimum unit.
ClientTermsError Error due to user not accepting the AdWords terms of service.
Enumerations
INCOMPLETE_SIGNUP_CURRENT_ADWORDS_TNC_NOT_AGREED
Customer has not agreed to the latest AdWords Terms & Conditions
CollectionSizeError Errors associated with the size of the given collection being out of bounds.
Enumerations
TOO_FEW
TOO_MANY
CriterionError Error class used for reporting criteria related errors.
Enumerations
CONCRETE_TYPE_REQUIRED
Concrete type of criterion is required for ADD and SET operations.
INVALID_EXCLUDED_CATEGORY
The category requested for exclusion is invalid.
INVALID_KEYWORD_TEXT
Invalid keyword criteria text.
KEYWORD_TEXT_TOO_LONG
Keyword text should be less than 80 chars.
KEYWORD_HAS_TOO_MANY_WORDS
Keyword text has too many words.
KEYWORD_HAS_INVALID_CHARS
Keyword text has invalid characters or symbols.
INVALID_PLACEMENT_URL
Invalid placement URL.
INVALID_USER_LIST
Invalid user list criterion.
INVALID_USER_INTEREST
Invalid user interest criterion.
INVALID_FORMAT_FOR_PLACEMENT_URL
Placement URL has wrong format.
PLACEMENT_URL_IS_TOO_LONG
Placement URL is too long.
PLACEMENT_URL_HAS_ILLEGAL_CHAR
Indicates the URL contains an illegal character.
PLACEMENT_URL_HAS_MULTIPLE_SITES_IN_LINE
Indicates the URL contains multiple comma separated URLs.
PLACEMENT_IS_NOT_AVAILABLE_FOR_TARGETING_OR_EXCLUSION
Indicates the domain is blacklisted.
INVALID_VERTICAL_PATH
Invalid vertical path.
INVALID_YOUTUBE_CHANNEL_ID
The YouTube Channel Id is invalid.
INVALID_YOUTUBE_VIDEO_ID
The YouTube Video Id is invalid.
YOUTUBE_VERTICAL_CHANNEL_DEPRECATED
Indicates the placement is a YouTube vertical channel, which is no longer supported.
YOUTUBE_DEMOGRAPHIC_CHANNEL_DEPRECATED
Indicates the placement is a YouTube demographic channel, which is no longer supported.
YOUTUBE_URL_UNSUPPORTED
YouTube urls are not supported in Placement criterion. Use YouTubeChannel and YouTubeVideo criterion instead.
CANNOT_EXCLUDE_CRITERIA_TYPE
Criteria type can not be excluded by the customer, like AOL account type cannot target site type criteria.
CANNOT_ADD_CRITERIA_TYPE
Criteria type can not be targeted.
INVALID_PRODUCT_FILTER
Product filter in the product criteria has invalid characters. Operand and the argument in the filter can not have "==" or "&+".
PRODUCT_FILTER_TOO_LONG
Product filter in the product criteria is translated to a string as operand1==argument1&+operand2==argument2, maximum allowed length for the string is 255 chars.
CANNOT_EXCLUDE_SIMILAR_USER_LIST
Not allowed to exclude similar user list.
CANNOT_ADD_CLOSED_USER_LIST
Not allowed to target a closed user list.
CANNOT_ADD_DISPLAY_ONLY_LISTS_TO_SEARCH_ONLY_CAMPAIGNS
Not allowed to add display only UserLists to search only campaigns.
CANNOT_ADD_DISPLAY_ONLY_LISTS_TO_SEARCH_CAMPAIGNS
Not allowed to add display only UserLists to search plus campaigns.
CANNOT_ADD_DISPLAY_ONLY_LISTS_TO_SHOPPING_CAMPAIGNS
Not allowed to add display only UserLists to shopping campaigns.
CANNOT_ADD_USER_INTERESTS_TO_SEARCH_CAMPAIGNS
Not allowed to add User interests to search only campaigns.
CANNOT_SET_BIDS_ON_CRITERION_TYPE_IN_SEARCH_CAMPAIGNS
Not allowed to set bids for this criterion type in search campaigns
CANNOT_ADD_URLS_TO_CRITERION_TYPE_FOR_CAMPAIGN_TYPE
Final URLs, URL Templates and CustomParameters cannot be set for the criterion types of Gender, AgeRange, UserList, Placement, MobileApp, and MobileAppCategory in search campaigns and shopping campaigns.
CANNOT_ADD_POSITIVE_PLACEMENTS_TO_SEARCH_CAMPAIGNS
Positive (targeted) criteria in the Placement targeting dimension (aka CriterionTypeGroup) are not allowed in Search campaigns. They can only be excluded. The Placement targeting dimension includes Placements, MobileApps, MobileAppCategories, YouTubeChannels, YouTubeVideos, etc.
INVALID_IP_ADDRESS
IP address is not valid.
INVALID_IP_FORMAT
IP format is not valid.
INVALID_MOBILE_APP
Mobile application is not valid.
INVALID_MOBILE_APP_CATEGORY
Mobile application category is not valid.
INVALID_CRITERION_ID
The CriterionId does not exist or is of the incorrect type.
CANNOT_TARGET_CRITERION
The Criterion is not allowed to be targeted.
CANNOT_TARGET_OBSOLETE_CRITERION
The criterion is not allowed to be targeted as it is deprecated.
CRITERION_ID_AND_TYPE_MISMATCH
The CriterionId is not valid for the type.
INVALID_PROXIMITY_RADIUS
Distance for the radius for the proximity criterion is invalid.
INVALID_PROXIMITY_RADIUS_UNITS
Units for the distance for the radius for the proximity criterion is invalid.
INVALID_STREETADDRESS_LENGTH
Street address is too short.
INVALID_CITYNAME_LENGTH
City name in the address is too short.
INVALID_REGIONCODE_LENGTH
Region code in the address is too short.
INVALID_REGIONNAME_LENGTH
Region name in the address is not valid.
INVALID_POSTALCODE_LENGTH
Postal code in the address is not valid.
INVALID_COUNTRY_CODE
Country code in the address is not valid.
INVALID_LATITUDE
Latitude for the GeoPoint is not valid.
INVALID_LONGITUDE
Longitude for the GeoPoint is not valid.
PROXIMITY_GEOPOINT_AND_ADDRESS_BOTH_CANNOT_BE_NULL
The Proximity input is not valid. Both address and geoPoint cannot be null.
INVALID_PROXIMITY_ADDRESS
The Proximity address cannot be geocoded to a valid lat/long.
INVALID_USER_DOMAIN_NAME
User domain name is not valid.
INVALID_WEBPAGE_CONDITION
The combination of operand and operator in webpage condition is invalid.
INVALID_WEBPAGE_CONDITION_URL
The URL of webpage condition is invalid.
WEBPAGE_CONDITION_URL_CANNOT_BE_EMPTY
The URL of webpage condition cannot be empty or contain white space.
WEBPAGE_CONDITION_URL_UNSUPPORTED_PROTOCOL
The URL of webpage condition contains unsupported protocol.
WEBPAGE_CONDITION_URL_CANNOT_BE_IP_ADDRESS
The URL of webpage condition cannot be an IP address.
WEBPAGE_CONDITION_URL_DOMAIN_NOT_CONSISTENT_WITH_CAMPAIGN_SETTING
The domain of the URL is not consistent with the domain in campaign setting.
WEBPAGE_CONDITION_URL_CANNOT_BE_PUBLIC_SUFFIX
The URL of webpage condition cannot be a public suffix itself.
WEBPAGE_CONDITION_URL_INVALID_PUBLIC_SUFFIX
The URL of webpage condition has an invalid public suffix.
WEBPAGE_CONDITION_URL_VALUE_TRACK_VALUE_NOT_SUPPORTED
Value track parameter is not supported in webpage condition URL.
WEBPAGE_CRITERION_URL_EQUALS_CAN_HAVE_ONLY_ONE_CONDITION
Only one URL-EQUALS webpage condition is allowed in a webpage criterion and it cannot be combined with other conditions.
WEBPAGE_CRITERION_CANNOT_ADD_NON_SMART_TARGETING_TO_NON_DSA_AD_GROUP
Only allow smart targeting on non-DSA ad groups.
CRITERION_PARAMETER_TOO_LONG
Length of serialized criterion parameter exceeded size limit.
AD_SCHEDULE_TIME_INTERVALS_OVERLAP
Time interval in the AdSchedule overlaps with another AdSchedule.
AD_SCHEDULE_INTERVAL_CANNOT_SPAN_MULTIPLE_DAYS
AdSchedule time interval cannot span multiple days.
AD_SCHEDULE_INVALID_TIME_INTERVAL
AdSchedule time interval specified is invalid, endTime cannot be earlier than startTime.
AD_SCHEDULE_EXCEEDED_INTERVALS_PER_DAY_LIMIT
The number of AdSchedule entries in a day exceeds the limit.
AD_SCHEDULE_CRITERION_ID_MISMATCHING_FIELDS
CriteriaId does not match the interval of the AdSchedule specified.
CANNOT_BID_MODIFY_CRITERION_TYPE
Cannot set bid modifier for this criterion type.
CANNOT_BID_MODIFY_CRITERION_CAMPAIGN_OPTED_OUT
Cannot bid modify criterion, since it is opted out of the campaign.
CANNOT_BID_MODIFY_NEGATIVE_CRITERION
Cannot set bid modifier for a negative criterion.
BID_MODIFIER_ALREADY_EXISTS
Bid Modifier already exists. Use SET operation to update.
FEED_ID_NOT_ALLOWED
Feed Id is not allowed in these Location Groups.
ACCOUNT_INELIGIBLE_FOR_CRITERIA_TYPE
The account may not use the requested criteria type. For example, some accounts are restricted to keywords only.
CRITERIA_TYPE_INVALID_FOR_BIDDING_STRATEGY
The requested criteria type cannot be used with campaign or ad group bidding strategy.
CANNOT_EXCLUDE_CRITERION
The Criterion is not allowed to be excluded.
CANNOT_REMOVE_CRITERION
The criterion is not allowed to be removed. For example, we cannot remove any of the platform criterion.
PRODUCT_SCOPE_TOO_LONG
The combined length of product dimension values of the product scope criterion is too long.
PRODUCT_SCOPE_TOO_MANY_DIMENSIONS
Product scope contains too many dimensions.
PRODUCT_PARTITION_TOO_LONG
The combined length of product dimension values of the product partition criterion is too long.
PRODUCT_PARTITION_TOO_MANY_DIMENSIONS
Product partition contains too many dimensions.
INVALID_PRODUCT_DIMENSION
The product dimension is invalid (e.g. dimension contains illegal value, dimension type is represented with wrong class, etc). Product dimension value can not contain "==" or "&+".
INVALID_PRODUCT_DIMENSION_TYPE
Product dimension type is either invalid for campaigns of this type or cannot be used in the current context. BIDDING_CATEGORY_Lx and PRODUCT_TYPE_Lx product dimensions must be used in ascending order of their levels: L1, L2, L3, L4, L5... The levels must be specified sequentially and start from L1. Furthermore, an "others" product partition cannot be subdivided with a dimension of the same type but of a higher level ("others" BIDDING_CATEGORY_L3 can be subdivided with BRAND but not with BIDDING_CATEGORY_L4).
INVALID_PRODUCT_BIDDING_CATEGORY
Bidding categories do not form a valid path in the Shopping bidding category taxonomy.
MISSING_SHOPPING_SETTING
ShoppingSetting must be added to the campaign before ProductScope criteria can be added.
INVALID_MATCHING_FUNCTION
Matching function is invalid.
LOCATION_FILTER_NOT_ALLOWED
Filter parameters not allowed for location groups targeting.
LOCATION_FILTER_INVALID
Given location filter parameter is invalid for location groups targeting.
CANNOT_ATTACH_CRITERIA_AT_CAMPAIGN_AND_ADGROUP
Criteria type cannot be associated with a campaign and its ad group(s) simultaneously.
ADSENSE_FOR_MOBILE_APPS_PLACEMENT_DEPRECATED
adsenseformobileapps.com placement is no longer supported.
UNKNOWN
CurrencyCodeError Errors for currency codes.
Enumerations
UNSUPPORTED_CURRENCY_CODE
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
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.
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.
ERROR_GENERATING_RESPONSE
Mutate succeeded but server was unable to build response. Client should not retry mutate.
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.
OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
This operation is not permitted on this ad group type.
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
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.
QuotaCheckError Encapsulates the errors thrown during developer quota checks.
Enumerations
INVALID_TOKEN_HEADER
Customer passed in an invalid token in the header.
ACCOUNT_DELINQUENT
Customer is marked delinquent.
ACCOUNT_INACCESSIBLE
Customer is a fraudulent.
ACCOUNT_INACTIVE
Inactive Account.
INCOMPLETE_SIGNUP
Signup not complete
DEVELOPER_TOKEN_NOT_APPROVED
Developer token is not approved for production access, and the customer is attempting to access a production account.
TERMS_AND_CONDITIONS_NOT_SIGNED
Terms and conditions are not signed.
MONTHLY_BUDGET_REACHED
Monthly budget quota reached.
QUOTA_EXCEEDED
Monthly budget quota exceeded.
RangeError A list of all errors associated with the Range constraint.
Enumerations
TOO_LOW
TOO_HIGH
RateExceededError Signals that a call failed because a measured rate exceeded.
Enumerations
RATE_EXCEEDED
Rate exceeded.
ReadOnlyError Errors from attempting to write to read-only fields.
Enumerations
READ_ONLY
RegionCodeError A list of all errors associated with the @RegionCode constraints.
Enumerations
INVALID_REGION_CODE
RejectedError Indicates that a field was rejected due to compatibility issues.
Enumerations
UNKNOWN_VALUE
Unknown value encountered
RequestError Encapsulates the generic errors thrown when there's an error with user request.
Enumerations
UNKNOWN
Error reason is unknown.
INVALID_INPUT
Invalid input.
UNSUPPORTED_VERSION
The api version in the request has been discontinued. Please update to the new AdWords API version.
RequiredError Errors due to missing required field.
Enumerations
REQUIRED
Missing required field.
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
StatsQueryError Represents possible error codes when querying for stats.
Enumerations
DATE_NOT_IN_VALID_RANGE
Date is outside of allowed range.
StringFormatError A list of error code for reporting invalid content of input strings.
Enumerations
UNKNOWN
ILLEGAL_CHARS
The input string value contains disallowed characters.
INVALID_FORMAT
The input string value is invalid for the associated field.
StringLengthError Errors associated with the length of the given string being out of bounds.
Enumerations
TOO_SHORT
TOO_LONG
TargetingIdeaError Base error class for the TargetingIdeaService.
Enumerations
DUPLICATE_SEARCH_FILTER_TYPES_PRESENT
Error returned when there are multiple instance of same type of SearchParameters.
INSUFFICIENT_SEARCH_PARAMETERS
Error returned when the TargetingIdeaSelector doesn't have enough SearchParameters to execute request.
INVALID_ATTRIBUTE_TYPE
Error returned when an AttributeType doesn't match the IdeaType specified in the TargetingIdeaSelector. For example, if the KEYWORD IDEAS selector contains an STATS only AttributeType, this error will be returned.
INVALID_SEARCH_PARAMETERS
Error returned when a SearchParameter doesn't match the IdeaType specified in the TargetingIdeaSelector or is otherwise invalid. Error trigger usually contains the parameter name, and error details contain a more detailed explanation.
INVALID_DOMAIN_SUFFIX
Error returned when the TargetingIdeaSelector contains a DomainSuffixSearchParameters that contains an invalid domain suffix.
MUTUALLY_EXCLUSIVE_SEARCH_PARAMETERS_IN_QUERY
Error returned when a selector contains mutually exclusive parameters.
SERVICE_UNAVAILABLE
Error returned when the TargetingIdeaService is not available.
INVALID_URL_IN_SEARCH_PARAMETER
Error returned when the URL value specified in the TargetingIdeaSelector, such as RelatedToUrlSearchParameter, is not a valid URL.
TOO_MANY_RESULTS_REQUESTED
Error returned when the requested number of entries in TargetingIdeaSelector's Paging is greater than the maximum allowed.
NO_PAGING_IN_SELECTOR
Error returned when the requested Paging is missing from the TargetingIdeaSelector when required.
INVALID_INCLUDED_EXCLUDED_KEYWORDS
Error returned when included keywords and excluded keywords in IdeaTextFilterSearchParameter, IdeaTextMatchesSearchParameter or ExcludedKeywordSearchParameter are overlapped.
TrafficEstimatorError Base error class for TrafficEstimatorService.
Enumerations
NO_CAMPAIGN_FOR_AD_GROUP_ESTIMATE_REQUEST
When the request with null campaign ID in CampaignEstimateRequest contains an AdGroupEstimateRequest with an ID.
NO_AD_GROUP_FOR_KEYWORD_ESTIMATE_REQUEST
When the request with null adgroup ID in AdGroupEstimateRequest contains a KeywordEstimateRequest with an ID.
NO_MAX_CPC_FOR_KEYWORD_ESTIMATE_REQUEST
All KeywordEstimateRequest items should have maxCpc associated with them.
TOO_MANY_KEYWORD_ESTIMATE_REQUESTS
When there are more KeywordEstimateRequests in the request than TrafficEstimatorService allows.
TOO_MANY_CAMPAIGN_ESTIMATE_REQUESTS
When there are more CampaignEstimateRequests in the request than TrafficEstimatorService allows.
TOO_MANY_ADGROUP_ESTIMATE_REQUESTS
When there are more AdGroupEstimateRequests in the request than TrafficEstimatorService allows.
TOO_MANY_TARGETS
When there are more targets in the request than TrafficEstimatorService allows. See documentation on CampaignEstimateRequest for more information about this error.
KEYWORD_TOO_LONG
Request contains a keyword that is too long for backends to handle.
KEYWORD_CONTAINS_BROAD_MATCH_MODIFIERS
Request contains a keyword that contains broad match modifiers.
INVALID_INPUT
When an unexpected error occurs.
SERVICE_UNAVAILABLE
When backend service calls fail.