AdWords API

AdWords API
Feedback on this document

AdGroupAdService (v201306)

Use this service to manage ads. Available ad types are subclasses of the base Ad type and are shown in the AdGroupAd.ad documentation. Here are some of the commonly used ad types:

Text Ad
The primary ad type used on both the search and display networks. A text ad contains a headline, two lines of text, and a destination URL.
Image Ad
A standard image ad.
Mobile Ad
A text ad specific to mobile devices. In addition, a mobile ad can contain a click-to-call phone number.
Template Ad (AdWords Display Ad Builder)
A flexible ad type that supports video ads, image search ads, and more. For a list of available templates, see the Template Ad Formats appendix.

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

get

Returns a list of AdGroupAds. Deleted AdGroupAds are not returned by default.

Parameters

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

Response

Field Type Description
rval AdGroupAdPage The page containing the AdGroupAds that meet the criteria specified by the selector.

mutate

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

Add - Creates a new ad group ad. The adGroupId must reference an existing ad group. The child Ad must be sufficiently specified by constructing a concrete ad type (such as TextAd) and setting its fields accordingly.

Set - Updates an ad group ad. Except for status, ad group ad fields are not mutable. Status updates are straightforward - the status of the ad group ad is updated as specified. If any other field has changed, it will be ignored. If you want to change any of the fields other than status, you must make a new ad and then delete the old one.

Remove - Removes the link between the specified AdGroup and Ad.

Parameters

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

Response

Field Type Description
rval AdGroupAdReturnValue A list of AdGroupAds where each entry in the list is the result of applying the operation in the input list with the same index. For an add/set operation, the return AdGroupAd will be what is saved to the db. In the case of the remove operation, the return AdGroupAd will simply be an AdGroupAd containing an Ad with the id set to the Ad being deleted from the AdGroup.

query

Returns a list of AdGroupAds based on the query.

Parameters

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

Response

Field Type Description
rval AdGroupAdPage A list of AdGroupAds.

Errors

Error Reasons
AdError Base error class for Ad Service.
Enumerations
APPROXIMATELY_TOO_LONG
Estimating character sizes the string is too long.
APPROXIMATELY_TOO_SHORT
Estimating character sizes the string is too short.
BAD_SNIPPET
There is a problem with the snippet.
CANNOT_SET_BUSINESS_NAME_IF_URL_SET
business name and url cannot be set at the same time
CANNOT_SET_URL
Cannot specify a url for the ad type
CUSTOMER_NOT_APPROVED_MOBILEADS
Customer is not approved for mobile ads.
CUSTOMER_NOT_APPROVED_THIRDPARTY_ADS
Customer is not approved for 3PAS richmedia ads.
CUSTOMER_NOT_APPROVED_THIRDPARTY_REDIRECT_ADS
Customer is not approved for 3PAS redirect richmedia (Ad Exchange) ads.
CUSTOMER_NOT_ELIGIBLE
Not an eligible customer
CUSTOMER_NOT_ELIGIBLE_FOR_UPDATING_BEACON_URL
Customer is not eligible for updating beacon url
DIMENSION_ALREADY_IN_UNION
There already exists an ad with the same dimensions in the union.
DIMENSION_MUST_BE_SET
Ad's dimension must be set before setting union dimension.
DIMENSION_NOT_IN_UNION
Ad's dimension must be included in the union dimensions.
DISPLAY_URL_CANNOT_BE_SPECIFIED
Display Url cannot be specified (applies to Ad Exchange Ads)
DOMESTIC_PHONE_NUMBER_FORMAT
Telephone number contains invalid characters or invalid format. Please re-enter your number using digits (0-9), dashes (-), and parentheses only.
EMERGENCY_PHONE_NUMBER
Emergency telephone numbers are not allowed. Please enter a valid domestic phone number to connect customers to your business.
EMPTY_FIELD
A required field was not specified or is an empty string.
INCONSISTENT_STATUS_IN_TEMPLATE_UNION
The status cannot differ among template ads of the same union.
INCORRECT_LENGTH
The length of the string is not valid.
INVALID_AD_ADDRESS_CAMPAIGN_TARGET
User cannot create mobile ad for countries targeted in specified campaign.
INVALID_AD_TYPE
Invalid Ad type. A specific type of Ad is required.
INVALID_ATTRIBUTES_FOR_MOBILE_IMAGE
Headline, description or phone cannot be present when creating mobile image ad.
INVALID_ATTRIBUTES_FOR_MOBILE_TEXT
Image cannot be present when creating mobile text ad.
INVALID_CHARACTER_FOR_URL
Invalid character in URL.
INVALID_COUNTRY_CODE
Creative's country code is not valid.
INVALID_DSA_URL_TAG
Invalid use of Dynamic Search Ads tags ({lpurl} etc.)
INVALID_INPUT
An input error whose real reason was not properly mapped (should not happen).
INVALID_MARKUP_LANGUAGE
An invalid markup language was entered.
INVALID_MOBILE_CARRIER
An invalid mobile carrier was entered.
INVALID_MOBILE_CARRIER_TARGET
Specified mobile carriers target a country not targeted by the campaign.
INVALID_NUMBER_OF_ELEMENTS
Wrong number of elements for given element type
INVALID_PHONE_NUMBER_FORMAT
The format of the telephone number is incorrect. Please re-enter the number using the correct format.
INVALID_RICH_MEDIA_CERTIFIED_VENDOR_FORMAT_ID
The certified vendor format id is incorrect.
INVALID_TEMPLATE_DATA
The template ad data contains validation errors.
INVALID_TEMPLATE_ELEMENT_FIELD_TYPE
The template field doesn't have have the correct type.
INVALID_TEMPLATE_ID
Invalid template id.
LINE_TOO_WIDE
After substituting replacement strings, the line is too wide.
MARKUP_LANGUAGES_PRESENT
When entering a markup language the Destination URL must be entered.
MISSING_ADDRESS_COMPONENT
Missing address component in template element address field.
MISSING_ADVERTISEMENT_NAME
An ad name must be entered.
MISSING_BUSINESS_NAME
Business name must be entered.
MISSING_DESCRIPTION1
Description (line 2) must be entered.
MISSING_DESCRIPTION2
Description (line 3) must be entered.
MISSING_DESTINATION_URL
A destination URL must be entered.
MISSING_DESTINATION_URL_TAG
The destination url must contain at least one tag (e.g. {lpurl})
MISSING_DIMENSION
A valid dimension must be specified for this ad.
MISSING_DISPLAY_URL
A display URL must be entered.
MISSING_HEADLINE
Headline must be entered.
MISSING_HEIGHT
A height must be entered.
MISSING_IMAGE
An image must be entered.
MISSING_MARKUP_LANGUAGES
The markup language in which your site is written must be entered.
MISSING_MOBILE_CARRIER
A mobile carrier must be entered.
MISSING_PHONE
Phone number must be entered.
MISSING_REQUIRED_TEMPLATE_FIELDS
Missing required template fields
MISSING_TEMPLATE_FIELD_VALUE
Missing a required field value
MISSING_TEXT
The ad must have text.
MISSING_URL_AND_PHONE
Ad must link to a mobile web page or connect users to your business telephone, or both. Please enter a mobile Destination URL and/or a business telephone number.
MISSING_VISIBLE_URL
A visible URL must be entered.
MISSING_WIDTH
A width must be entered.
MUST_USE_TEMP_AD_UNION_ID_ON_ADD
TempAdUnionId must be use when adding template ads.
TOO_LONG
The string has too many characters.
TOO_SHORT
The string has too few characters.
UNION_DIMENSIONS_CANNOT_CHANGE
Ad union dimensions cannot change for saved ads.
UNKNOWN_ADDRESS_COMPONENT
Address component is not {country, lat, lng}.
UNKNOWN_FIELD_NAME
Unknown unique field name
UNKNOWN_UNIQUE_NAME
Unknown unique name (template element type specifier)
UNSUPPORTED_DIMENSIONS
Unsupported ad dimension
URL_INVALID_SCHEME
URL starts with an invalid scheme.
URL_INVALID_TOP_LEVEL_DOMAIN
URL ends with an invalid top-level domain name.
URL_MALFORMED
URL contains illegal characters.
URL_NO_HOST
URL must contain a host name.
URL_HOST_NAME_TOO_LONG
URL host name too long to be stored as visible URL (applies to Ad Exchange ads)
URL_NO_SCHEME
URL must start with a scheme.
URL_NO_TOP_LEVEL_DOMAIN
URL should end in a valid domain extension, such as .com or .net.
URL_PATH_NOT_ALLOWED
URL must not end with a path.
URL_PORT_NOT_ALLOWED
URL must not specify a port.
URL_QUERY_NOT_ALLOWED
URL must not contain a query.
URL_SCHEME_BEFORE_DSA_TAG
A url scheme is not allowed in front of tag in dest url (e.g. http://{lpurl})
USER_DOES_NOT_HAVE_ACCESS_TO_TEMPLATE
The user does not have permissions to create a template ad for the given template.
INCONSISTENT_EXPANDABLE_SETTINGS
Expandable setting is inconsistent/wrong. For example, an AdX ad is invalid if it has a expandable vendor format but no expanding directions specified, or expanding directions is specified, but the vendor format is not expandable.
INVALID_FORMAT
Format is invalid
INVALID_FIELD_TEXT
The text of this field did not match a pattern of allowed values.
ELEMENT_NOT_PRESENT
Template element is mising
IMAGE_ERROR
Error occurred during image processing
VALUE_NOT_IN_RANGE
The value is not within the valid range
FIELD_NOT_PRESENT
Template element field is not present
ADDRESS_NOT_COMPLETE
Address is incomplete
ADDRESS_INVALID
Invalid address
VIDEO_RETRIEVAL_ERROR
Error retrieving specified video
AUDIO_ERROR
Error processing audio
INVALID_YOUTUBE_DISPLAY_URL
Display URL is incorrect for YouTube PYV ads
UNSUPPORTED_PARENT_CAMPAIGN_FOR_DEVICE_PREFERENCE
The associated campaign is not enhanced.
INCOMPATIBLE_AD_TYPE_AND_DEVICE_PREFERENCE
The device preference is not compatible with the ad type
AdGroupAdError Error information for AdGroupAdService.
Enumerations
AD_NOT_UNDER_ADGROUP
The specified ad was not found in the adgroup
CANNOT_OPERATE_ON_DELETED_ADGROUPAD
Deleted ads may not be modified
CANNOT_CREATE_DEPRECATED_ADS
An ad of this type is deprecated and cannot be created. Only deletions are permitted.
EMPTY_FIELD
A required field was not specified or is an empty string.
ENTITY_REFERENCED_IN_MULTIPLE_OPS
An ad may only be modified once per call
UNSUPPORTED_OPERATION
The specified operation is not supported. Only ADD, SET, and REMOVE are supported
AdxError Errors that are thrown when a non-AdX feature is accessed by an AdX customer.
Enumerations
UNSUPPORTED_FEATURE
Attempt to use non-AdX feature by AdX customer.
AuthenticationError Errors returned when Authentication failed.
Enumerations
AUTHENTICATION_FAILED
Authentication of the request failed.
CLIENT_CUSTOMER_ID_IS_REQUIRED
Client Customer Id is required if CustomerIdMode is set to CLIENT_EXTERNAL_CUSTOMER_ID.
CLIENT_EMAIL_REQUIRED
Client Email is required if CustomerIdMode is set to CLIENT_EXTERNAL_EMAIL_FIELD.
CLIENT_CUSTOMER_ID_INVALID
Client customer Id is not a number.
CLIENT_EMAIL_INVALID
Client customer Id is not a number.
CLIENT_EMAIL_FAILED_TO_AUTHENTICATE
Client email is not a valid customer email.
CUSTOMER_NOT_FOUND
No customer found for the customer id provided in the header.
GOOGLE_ACCOUNT_DELETED
Client's Google Account is deleted.
GOOGLE_ACCOUNT_COOKIE_INVALID
Google account login token in the cookie is invalid.
FAILED_TO_AUTHENTICATE_GOOGLE_ACCOUNT
problem occurred during Google account authentication.
GOOGLE_ACCOUNT_USER_AND_ADS_USER_MISMATCH
The user in the google account login token does not match the UserId in the cookie.
LOGIN_COOKIE_REQUIRED
Login cookie is required for authentication.
NOT_ADS_USER
User in the cookie is not a valid Ads user.
OAUTH_TOKEN_INVALID
Oauth token in the header is not valid.
OAUTH_TOKEN_EXPIRED
Oauth token in the header has expired.
OAUTH_TOKEN_DISABLED
Oauth token in the header has been disabled.
OAUTH_TOKEN_REVOKED
Oauth token in the header has been revoked.
OAUTH_TOKEN_HEADER_INVALID
Oauth token HTTP header is malformed.
LOGIN_COOKIE_INVALID
Login cookie is not valid.
FAILED_TO_RETRIEVE_LOGIN_COOKIE
Failed to decrypt the login cookie.
USER_ID_INVALID
User Id in the header is not a valid id.
AuthorizationError Errors encountered when trying to authorize a user.
Enumerations
UNABLE_TO_AUTHORIZE
Could not complete authorization due to an internal problem.
NO_ADWORDS_ACCOUNT_FOR_CUSTOMER
Customer has no AdWords account.
USER_PERMISSION_DENIED
User doesn't have permission to access customer.
EFFECTIVE_USER_PERMISSION_DENIED
Effective user doesn't have permission to access this customer.
USER_HAS_READONLY_PERMISSION
User has read-only permission cannot mutate.
NO_CUSTOMER_FOUND
No customer found.
SERVICE_ACCESS_DENIED
Developer doesn't have permission to access service.
BetaError Errors that are thrown when a Beta feature is accessed incorrectly.
Enumerations
BETA_FEATURE
Attempt to use beta feature by non-beta account.
ClientTermsError Error due to user not accepting the AdWords terms of service.
Enumerations
INCOMPLETE_SIGNUP_CURRENT_ADWORDS_TNC_NOT_AGREED
Customer has not agreed to the latest AdWords Terms & Conditions
DatabaseError Errors that are thrown due to a database access problem.
Enumerations
CONCURRENT_MODIFICATION
A concurrency problem occurred as two threads were attempting to modify same object.
PERMISSION_DENIED
The permission was denied to access an object.
CAMPAIGN_PRODUCT_NOT_SUPPORTED
Requested campaign belongs to a product that is not supported by the api.
DUPLICATE_KEY
a duplicate key was detected upon insertion
DATABASE_ERROR
a database error has occurred
UNKNOWN
an unknown error has occurred
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
CAMPAIGN_LIMIT
ADGROUP_LIMIT
ADGROUP_TEXT_AD_LIMIT
Specifies max number of ads not intended for Display Network; applies to MobileAd, TextAd, TemplateAd (text templates only).
ADGROUP_DISPLAY_AD_LIMIT
Specifies max number of Display Network ads; applies to ImageAd, MobileImageAd, TemplateAd (except text templates).
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
ImageError Error class for errors associated with parsing image data.
Enumerations
INVALID_IMAGE
The image is not valid.
STORAGE_ERROR
The image could not be stored.
BAD_REQUEST
There was a problem with the request.
UNEXPECTED_SIZE
The image is not of legal dimensions.
ANIMATED_NOT_ALLOWED
Animated image are not permitted.
ANIMATION_TOO_LONG
Animation is too long.
SERVER_ERROR
There was an error on the server.
CMYK_JPEG_NOT_ALLOWED
Image cannot be in CMYK color format.
FLASH_NOT_ALLOWED
Flash images are not permitted.
FLASH_WITHOUT_CLICKTAG
Flash images must support clickTag.
ANIMATED_VISUAL_EFFECT
Unacceptable visual effects.
FLASH_ERROR
There was a problem with the flash image.
LAYOUT_PROBLEM
Incorrect image layout.
PROBLEM_READING_IMAGE_FILE
There was a problem reading the image file.
ERROR_STORING_IMAGE
There was an error storing the image.
FLASH_HAS_NETWORK_OBJECTS
Flash cannot have network objects.
FLASH_HAS_NETWORK_METHODS
Flash cannot have network methods.
FLASH_HAS_URL
Flash cannot have a Url.
FLASH_HAS_MOUSE_TRACKING
Flash cannot use mouse tracking.
FLASH_HAS_RANDOM_NUM
Flash cannot have a random number.
FLASH_SELF_TARGETS
Ad click target cannot be '_self'.
FLASH_BAD_GETURL_TARGET
GetUrl method should only use '_blank'.
FLASH_VERSION_NOT_SUPPORTED
Flash version is not supported.
FLASH_WITHOUT_HARD_CODED_CLICK_URL
Flash movies need to have hard coded click URL or clickTAG
INVALID_FLASH_FILE
Uploaded flash file is corrupted.
FAILED_TO_FIX_CLICK_TAG_IN_FLASH
Uploaded flash file can be parsed, but the click tag can not be fixed properly.
FLASH_ACCESSES_NETWORK_RESOURCES
Flash movie accesses network resources
FLASH_EXTERNAL_JS_CALL
Flash movie attempts to call external javascript code
FLASH_EXTERNAL_FS_CALL
Flash movie attempts to call flash system commands
FILE_TOO_LARGE
Image file is too large.
IMAGE_DATA_TOO_LARGE
Image data is too large.
IMAGE_PROCESSING_ERROR
Error while processing the image.
IMAGE_TOO_SMALL
Image is too small.
INVALID_INPUT
Input was invalid.
PROBLEM_READING_FILE
There was a problem reading the image file.
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.
MediaError Error class for media related errors.
Enumerations
CANNOT_ADD_STANDARD_ICON
Cannot add a standard icon type
CANNOT_SELECT_STANDARD_ICON_WITH_OTHER_TYPES
May only select Standard Icons alone
DUPLICATE_MEDIA
A media with given type and reference id already exists
EMPTY_FIELD
A required field was not specified or is an empty string.
ENTITY_REFERENCED_IN_MULTIPLE_OPS
A media may only be modified once per call
FIELD_NOT_SUPPORTED_FOR_MEDIA_SUB_TYPE
Field is not supported for the media sub type.
INVALID_MEDIA_ID
The media id is invalid
INVALID_MEDIA_TYPE
The media type is invalid
INVALID_MEDIA_SUB_TYPE
The media subtype is invalid
INVALID_REFERENCE_ID
The media reference id is invalid
INVALID_YOU_TUBE_ID
The YouTube video id is invalid
YOU_TUBE_VIDEO_NOT_FOUND
The YouTube video id is syntactically valid but the video was not found.
YOU_TUBE_SERVICE_UNAVAILABLE
YouTube is unavailable for requesting video data.
YOU_TUBE_VIDEO_HAS_NON_POSITIVE_DURATION
The YouTube video has a non positive duration.
MEDIA_FAILED_TRANSCODING
Media has failed transcoding
MEDIA_NOT_TRANSCODED
Media has not been transcoded
MEDIA_TYPE_DOES_NOT_MATCH_OBJECT_TYPE
The MediaType does not match the actual media object's type
NO_FIELDS_SPECIFIED
None of the fields have been specified.
NULL_REFERENCE_ID_AND_MEDIA_ID
One of reference Id or media Id must be specified
TOO_LONG
The string has too many characters.
UNSUPPORTED_OPERATION
The specified operation is not supported. Only ADD, SET, and REMOVE are supported
UNSUPPORTED_TYPE
NewEntityCreationError Error associated with creation of new entities using TempIds.
Enumerations
CANNOT_SET_ID_FOR_ADD
Do not set the id field while creating new entities.
NotEmptyError Errors corresponding with violation of a NOT EMPTY check.
Enumerations
EMPTY_LIST
NotWhitelistedError Indicates that the customer is not whitelisted for accessing the API.
Enumerations
CUSTOMER_NOT_WHITELISTED_FOR_API
Customer is not whitelisted for accessing the API.
NullError Errors associated with violation of a NOT NULL check.
Enumerations
NULL_CONTENT
Specified list/container must not contain any null elements
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
UNKNOWN
The reason the invoked method or operation is prohibited is not known (the client may be of an older version than the server).
PagingError Error codes for pagination. See Paging.
Enumerations
START_INDEX_CANNOT_BE_NEGATIVE
NUMBER_OF_RESULTS_CANNOT_BE_NEGATIVE
UNKNOWN
Used for return value only. An enumeration could not be processed, typically due to incompatibility with your WSDL version.
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.
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
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.
StatsQueryError Represents possible error codes when querying for stats.
Enumerations
DATE_NOT_IN_VALID_RANGE
Date is outside of allowed range.
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.