AdGroupService (v201809)

Use this service to manage ad groups. An ad group organizes a set of ads and criteria together, and also provides the default bid for its criteria. One or more ad groups belong to a campaign.

---

Production WSDL

https://adwords.google.com/api/adwords/cm/v201809/AdGroupService?wsdl

Namespace

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

Operations

• get
• mutate
• mutateLabel
• query

Errors

• AdGroupServiceError
• AdxError
• AuthenticationError
• AuthorizationError
• BiddingErrors
• ClientTermsError
• DatabaseError
• DateError
• DistinctError
• EntityAccessDenied
• EntityCountLimitExceeded
• EntityNotFound
• ForwardCompatibilityError
• IdError
• InternalApiError
• MultiplierError
• NewEntityCreationError
• NotEmptyError
• NullError
• OperationAccessDenied
• OperatorError
• QueryError
• QuotaCheckError
• RangeError
• RateExceededError
• ReadOnlyError
• RejectedError
• RequestError
• RequiredError
• SelectorError
• SettingError
• SizeLimitError
• StatsQueryError
• StringFormatError
• StringLengthError
• UrlError

get

Returns a list of all the ad groups specified by the selector from the target customer's account.

Parameters

Field	Type	Description
serviceSelector	Selector	The selector specifying the AdGroups to return.

Response

Field	Type	Description
rval	AdGroupPage	List of adgroups identified by the selector.

mutate

Adds, updates, or removes ad groups.

Note: AdGroupOperation does not support the REMOVE operator. To remove an ad group, set its status to REMOVED.

Parameters

Field	Type	Description
operations	AdGroupOperation[]	List of unique operations. The same ad group cannot be specified in more than one operation.

Response

Field	Type	Description
rval	AdGroupReturnValue	The updated adgroups.

mutateLabel

Adds labels to the ad group or removes labels from the ad group.

ADD -- Apply an existing label to an existing ad group. The adGroupId must reference an existing ad group. The labelId must reference an existing label.

REMOVE -- Removes the link between the specified ad group and a label.

Parameters

Field	Type	Description
operations	AdGroupLabelOperation[]	the operations to apply.

Response

Field	Type	Description
rval	AdGroupLabelReturnValue	a list of AdGroupLabels where each entry in the list is the result of applying the operation in the input list with the same index. For an add operation, the returned AdGroupLabel contains the AdGroupId and the LabelId. In the case of a remove operation, the returned AdGroupLabel will only have AdGroupId.

query

Returns the list of ad groups that match the query.

Parameters

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

Response

Field	Type	Description
rval	AdGroupPage	A list of adgroups

Errors

Error	Reasons
AdGroupServiceError	Represents possible error codes in AdGroupService. Enumerations DUPLICATE_ADGROUP_NAME AdGroup with the same name already exists for the campaign. INVALID_ADGROUP_NAME AdGroup name is not valid. USE_SET_OPERATOR_AND_MARK_STATUS_TO_REMOVED Cannot remove an adgroup, adgroup status can be marked removed 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_TYPE_AND_BIDDING_STRATEGY_MISMATCH AdGroup bid does not match the campaign's bidding strategy. MISSING_ADGROUP_NAME AdGroup name is required for Add. ADGROUP_LABEL_DOES_NOT_EXIST No link found between the ad group and the label. ADGROUP_LABEL_ALREADY_EXISTS The label has already been attached to the ad group. INVALID_CONTENT_BID_CRITERION_TYPE_GROUP The CriterionTypeGroup is not supported for the content bid dimension. AD_GROUP_TYPE_NOT_VALID_FOR_ADVERTISING_CHANNEL_TYPE The ad group type is not compatible with the campaign channel type. ADGROUP_TYPE_NOT_SUPPORTED_FOR_CAMPAIGN_SALES_COUNTRY The ad group type is not supported in the country of sale of the campaign. CANNOT_ADD_ADGROUP_OF_TYPE_DSA_TO_CAMPAIGN_WITHOUT_DSA_SETTING Ad groups of AdGroupType.SEARCH_DYNAMIC_ADS can only be added to campaigns that have DynamicSearchAdsSetting attached.
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.
BiddingErrors	Represents error codes for bidding strategy entities. Enumerations BIDDING_STRATEGY_TRANSITION_NOT_ALLOWED Cannot transition to new bidding strategy. BIDDING_STRATEGY_NOT_COMPATIBLE_WITH_ADGROUP_OVERRIDES Bidding strategy cannot be overridden by current ad group bidding strategy. BIDDING_STRATEGY_NOT_COMPATIBLE_WITH_ADGROUP_CRITERIA_OVERRIDES Bidding strategy cannot be overridden by current criteria bidding strategy. CAMPAIGN_BIDDING_STRATEGY_CANNOT_BE_OVERRIDDEN Cannot override campaign bidding strategy. ADGROUP_BIDDING_STRATEGY_CANNOT_BE_OVERRIDDEN Cannot override ad group bidding strategy. CANNOT_ATTACH_BIDDING_STRATEGY_TO_CAMPAIGN Cannot attach bidding strategy to campaign. CANNOT_ATTACH_BIDDING_STRATEGY_TO_ADGROUP Cannot attach bidding strategy to ad group. CANNOT_ATTACH_BIDDING_STRATEGY_TO_ADGROUP_CRITERIA Cannot attach bidding strategy to criteria. INVALID_ANONYMOUS_BIDDING_STRATEGY_TYPE Bidding strategy is not supported or cannot be used as anonymous. 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. INVALID_BIDDING_STRATEGY_TYPE The type does not match the named strategy's type. MISSING_BIDDING_STRATEGY_TYPE The bidding strategy type is missing. 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. CANNOT_CREATE_CAMPAIGN_WITH_BIDDING_STRATEGY Campaign can not be created with given bidding strategy. It can be transitioned to the strategy, once eligible. CANNOT_TARGET_CONTENT_NETWORK_ONLY_WITH_AD_GROUP_LEVEL_POP_BIDDING_STRATEGY Cannot target content network only as ad group uses Page One Promoted bidding strategy. CANNOT_TARGET_CONTENT_NETWORK_ONLY_WITH_CAMPAIGN_LEVEL_POP_BIDDING_STRATEGY Cannot target content network only as campaign uses Page One Promoted bidding strategy. BIDDING_STRATEGY_NOT_SUPPORTED_WITH_AD_SCHEDULE Budget Optimizer and Target Spend bidding strategies are not supported for campaigns with AdSchedule targeting. 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. BIDDING_STRATEGY_NOT_SUPPORTED_IN_DRAFTS_OR_EXPERIMENTS The bidding strategy is not supported for use in drafts or experiments. BIDDING_STRATEGY_TYPE_DOES_NOT_SUPPORT_PRODUCT_TYPE_ADGROUP_CRITERION Bidding strategy type does not support product type ad group criterion. 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. ENHANCED_CPC_ENABLED_NOT_SUPPORTED_ON_PORTFOLIO_TARGET_SPEND_STRATEGY EnhancedCpcEnabled cannot be set on portfolio Target Spend strategies. BIDDING_STRATEGY_TYPE_NOT_ALLOWED_FOR_UNIVERSAL_APP_BIDDING_STRATEGY_GOAL_TYPE The bidding strategy is not allowed for the universal app bidding strategy goal type. UNKNOWN
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. 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.
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
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.
MultiplierError	Represents errors in bid multipliers. Enumerations MULTIPLIER_TOO_HIGH Multiplier value is too high MULTIPLIER_TOO_LOW Multiplier value is too low TOO_MANY_FRACTIONAL_DIGITS Too many fractional digits MULTIPLIER_NOT_ALLOWED_FOR_BIDDING_STRATEGY A multiplier cannot be set for this bidding strategy MULTIPLIER_NOT_ALLOWED_WHEN_BASE_BID_IS_MISSING A multiplier cannot be set when there is no base bid (e.g., content max cpc) NO_MULTIPLIER_SPECIFIED A bid multiplier must be specified MULTIPLIER_CAUSES_BID_TO_EXCEED_DAILY_BUDGET Multiplier causes bid to exceed daily budget MULTIPLIER_CAUSES_BID_TO_EXCEED_MONTHLY_BUDGET Multiplier causes bid to exceed monthly budget MULTIPLIER_CAUSES_BID_TO_EXCEED_CUSTOM_BUDGET Multiplier causes bid to exceed custom budget MULTIPLIER_CAUSES_BID_TO_EXCEED_MAX_ALLOWED_BID Multiplier causes bid to exceed maximum allowed bid BID_LESS_THAN_MIN_ALLOWED_BID_WITH_MULTIPLIER Multiplier causes bid to become less than the minimum bid allowed MULTIPLIER_AND_BIDDING_STRATEGY_TYPE_MISMATCH Multiplier type (cpc vs. cpm) needs to match campaign's bidding strategy MULTIPLIER_ERROR
NewEntityCreationError	Error associated with creation of new entities. Enumerations CANNOT_SET_ID_FOR_ADD Do not set the id field while creating new entities. DUPLICATE_TEMP_IDS Creating more than one entity with the same temp ID is not allowed. TEMP_ID_ENTITY_HAD_ERRORS Parent object with specified temp id failed validation, so no deep validation will be done for this child entity.
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
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
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_CONTAINS_INVALID_CRITERION_TYPE_GROUP The supplied TargetingSetting contains an invalid CriterionTypeGroup. See CriterionTypeGroup documentation for CriterionTypeGroups allowed in Campaign or AdGroup TargetingSettings. TARGETING_SETTING_DEMOGRAPHIC_CRITERION_TYPE_GROUPS_MUST_BE_SET_TO_TARGET_ALL Starting with AdWords API v201802, TargetingSetting must not explicitly set any of the Demographic CriterionTypeGroups (AGE_RANGE, GENDER, PARENT, INCOME_RANGE) to false (it's okay to not set them at all, in which case the system will set them to true automatically). TARGETING_SETTING_CANNOT_CHANGE_TARGET_ALL_TO_FALSE_FOR_DEMOGRAPHIC_CRITERION_TYPE_GROUP Starting with AdWords API v201802,TargetingSetting cannot change any of the Demographic CriterionTypeGroups (AGE_RANGE, GENDER, PARENT, INCOME_RANGE) from true to false. DYNAMIC_SEARCH_ADS_SETTING_AT_LEAST_ONE_FEED_ID_MUST_BE_PRESENT At least one feed id should be present. DYNAMIC_SEARCH_ADS_SETTING_CONTAINS_INVALID_DOMAIN_NAME The supplied DynamicSearchAdsSetting contains an invalid domain name. DYNAMIC_SEARCH_ADS_SETTING_CONTAINS_SUBDOMAIN_NAME The supplied DynamicSearchAdsSetting contains a subdomain name. DYNAMIC_SEARCH_ADS_SETTING_CONTAINS_INVALID_LANGUAGE_CODE The supplied DynamicSearchAdsSetting contains an invalid language code. TARGET_ALL_IS_NOT_ALLOWED_FOR_PLACEMENT_IN_SEARCH_CAMPAIGN TargetingSettings in search campaigns should not have CriterionTypeGroup.PLACEMENT set to targetAll. UNIVERSAL_APP_CAMPAIGN_SETTING_DUPLICATE_DESCRIPTION Duplicate description in universal app setting description field. UNIVERSAL_APP_CAMPAIGN_SETTING_DESCRIPTION_LINE_WIDTH_TOO_LONG Description line width is too long in universal app setting description field. UNIVERSAL_APP_CAMPAIGN_SETTING_APP_ID_CANNOT_BE_MODIFIED Universal app setting appId field cannot be modified for COMPLETE campaigns. TOO_MANY_YOUTUBE_MEDIA_IDS_IN_UNIVERSAL_APP_CAMPAIGN YoutubeVideoMediaIds in universal app setting cannot exceed size limit. TOO_MANY_IMAGE_MEDIA_IDS_IN_UNIVERSAL_APP_CAMPAIGN ImageMediaIds in universal app setting cannot exceed size limit. MEDIA_INCOMPATIBLE_FOR_UNIVERSAL_APP_CAMPAIGN Media is incompatible for universal app campaign. TOO_MANY_EXCLAMATION_MARKS Too many exclamation marks in universal app campaign ad text ideas. UNKNOWN Unspecified campaign setting error.
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
UrlError	Url Validation errors. Enumerations 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. MISSING_PROTOCOL_IN_TRACKING_URL_TEMPLATE The tracking url template must start with a valid protocol (or lpurl tag). INVALID_PROTOCOL_IN_TRACKING_URL_TEMPLATE The tracking url template starts with an invalid protocol. MALFORMED_TRACKING_URL_TEMPLATE The tracking url template contains illegal characters. MISSING_HOST_IN_TRACKING_URL_TEMPLATE The tracking url template must contain a host name (or lpurl tag). INVALID_TLD_IN_TRACKING_URL_TEMPLATE The tracking url template has an invalid or missing top level domain extension. 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}}). MISSING_PROTOCOL_IN_FINAL_URL The final url must start with a valid protocol. INVALID_PROTOCOL_IN_FINAL_URL The final url starts with an invalid protocol. MALFORMED_FINAL_URL The final url contains illegal characters. MISSING_HOST_IN_FINAL_URL The final url must contain a host name. INVALID_TLD_IN_FINAL_URL The tracking url template has an invalid or missing top level domain extension. INVALID_FINAL_MOBILE_URL The final mobile url is invalid. INVALID_TAG_IN_FINAL_MOBILE_URL The final mobile 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}}). MISSING_PROTOCOL_IN_FINAL_MOBILE_URL The final mobile url must start with a valid protocol. INVALID_PROTOCOL_IN_FINAL_MOBILE_URL The final mobile url starts with an invalid protocol. MALFORMED_FINAL_MOBILE_URL The final mobile url contains illegal characters. MISSING_HOST_IN_FINAL_MOBILE_URL The final mobile url must contain a host name. INVALID_TLD_IN_FINAL_MOBILE_URL The tracking url template has an invalid or missing top level domain extension. INVALID_FINAL_APP_URL The final app url is invalid. INVALID_TAG_IN_FINAL_APP_URL The final app url contains invalid tag. REDUNDANT_NESTED_FINAL_APP_URL_TAG The final app url contains nested occurrences of the same conditional tag (i.e. {ifmobile:{ifmobile:x}}). 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_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. FINAL_URL_SUFFIX_MALFORMED The final url suffix cannot begin with ? or & characters and must be a valid query string. INVALID_TAG_IN_FINAL_URL_SUFFIX The final url suffix cannot contain {lpurl} related or {ignore} tags. 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. 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. DUPLICATE_URL_ID INVALID_URL_ID URL_ERROR