TrialService (v201806)

TrialService manages the life cycle of campaign trials. It is used to create new trials from drafts, modify trial properties, promote changes in a trial back to its base campaign, and to archive a trial.

A trial is an experiment, running two variants (trial arms) - the base campaign and the trial - at the same time, directing a fixed share of traffic to each trial arm. A trial is created from a draft of the base campaign and will be a snapshot of changes in the draft at the time of creation.

Constraints

  • A campaign cannot have running/scheduled "AdWords Campaign Experiments" (ACE) and running/scheduled trials at the same time. Trial creation will fail, if the base campaign has a running/scheduled ACE experiment.
  • Trial names must be unique across all of the customer's non-deleted trial and campaign names.
  • When creating a trial, [startDate, endDate] cannot be in the past or overlap with any other running/scheduled trial, must be within the base campaign's [startDate, endDate] and endDate must be later than startDate.
  • A future startDate/endDate can be updated to a different future startDate/endDate as long as the constraints on [startDate, endDate] are not violated.
  • There is at most one trial running and at most one trial scheduled for the future at a time, per base campaign.
  • The base campaign's budget cannot be shared with any other campaign. Trial creation will fail if the base campaign's budget is shared with another campaign.

Life cycle

A trial's status reflects the state of the trial within its life cycle. Some status transitions are performed explicitly by sending a SET operation, while other status transitions occur asynchronously without a client operation.

When a trial is first ADDed, its status is CREATING. The trial will be created asynchronously, and once it is fully created, its status will change to ACTIVE.

If the asynchronous creation of the trial fails, its status will change to CREATION_FAILED.

To promote changes in an ACTIVE trial back to the base campaign, set the trial status to PROMOTING. The promotion itself will occur asynchronously. If the promotion operation fails after some of the base campaign has already been updated, the status will change to PROMOTE_FAILED.

To graduate an ACTIVE trial, which will allow its associated campaign to act independently of the trial and free it of restrictions from the trial, set the status to GRADUATED and provide a new budgetId for the campaign to use (since it can no longer share the base campaign's budget).

Any trial that is not CREATING or PROMOTING can be archived by setting the status to the value of the same name.


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

get

Loads a TrialPage containing a list of Trial objects matching the selector.

Parameters

Field Type Description
selector Selector defines which subset of all available trials to return, the sort order, and which fields to include

Response

Field Type Description
rval TrialPage Returns a page of matching trial objects.

mutate

Creates new trials, updates properties and controls the life cycle of existing trials. See TrialService for details on the trial life cycle.

Parameters

Field Type Description
operations TrialOperation[]

Response

Field Type Description
rval TrialReturnValue Returns the list of updated Trials, in the same order as the operations list.

query

Loads a TrialPage containing a list of Trial objects matching the query.

Parameters

Field Type Description
query xsd:string defines which subset of all available trials to return, the sort order, and which fields to include

Response

Field Type Description
rval TrialPage Returns a page of matching trial objects.

Errors

Error Reasons
AuthenticationError Errors returned when Authentication failed.
Enumerations
AUTHENTICATION_FAILED
Authentication of the request failed.
CLIENT_CUSTOMER_ID_IS_REQUIRED
Client Customer Id is required if CustomerIdMode is set to CLIENT_EXTERNAL_CUSTOMER_ID. Starting version V201409 ClientCustomerId will be required for all requests except for CustomerService.get
CLIENT_EMAIL_REQUIRED
Client Email is required if CustomerIdMode is set to CLIENT_EXTERNAL_EMAIL_FIELD.
CLIENT_CUSTOMER_ID_INVALID
Client customer Id is not a number.
CLIENT_EMAIL_INVALID
Client customer Id is not a number.
CLIENT_EMAIL_FAILED_TO_AUTHENTICATE
Client email is not a valid customer email.
CUSTOMER_NOT_FOUND
No customer found for the customer id provided in the header.
GOOGLE_ACCOUNT_DELETED
Client's Google Account is deleted.
GOOGLE_ACCOUNT_COOKIE_INVALID
Google account login token in the cookie is invalid.
FAILED_TO_AUTHENTICATE_GOOGLE_ACCOUNT
problem occurred during Google account authentication.
GOOGLE_ACCOUNT_USER_AND_ADS_USER_MISMATCH
The user in the google account login token does not match the UserId in the cookie.
LOGIN_COOKIE_REQUIRED
Login cookie is required for authentication.
NOT_ADS_USER
User in the cookie is not a valid Ads user.
OAUTH_TOKEN_INVALID
Oauth token in the header is not valid.
OAUTH_TOKEN_EXPIRED
Oauth token in the header has expired.
OAUTH_TOKEN_DISABLED
Oauth token in the header has been disabled.
OAUTH_TOKEN_REVOKED
Oauth token in the header has been revoked.
OAUTH_TOKEN_HEADER_INVALID
Oauth token HTTP header is malformed.
LOGIN_COOKIE_INVALID
Login cookie is not valid.
FAILED_TO_RETRIEVE_LOGIN_COOKIE
Failed to decrypt the login cookie.
USER_ID_INVALID
User Id in the header is not a valid id.
AuthorizationError Errors encountered when trying to authorize a user.
Enumerations
UNABLE_TO_AUTHORIZE
Could not complete authorization due to an internal problem.
NO_ADWORDS_ACCOUNT_FOR_CUSTOMER
Customer has no AdWords account.
USER_PERMISSION_DENIED
User doesn't have permission to access customer.
EFFECTIVE_USER_PERMISSION_DENIED
Effective user doesn't have permission to access this customer.
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.
UNKNOWN
BudgetError A list of all the error codes being used by the common budget domain package.
Enumerations
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.
CampaignError Base error class for Campaign Service.
Enumerations
CANNOT_GO_BACK_TO_INCOMPLETE
A complete campaign cannot go back to being incomplete
CANNOT_TARGET_CONTENT_NETWORK
Cannot target content network.
CANNOT_TARGET_SEARCH_NETWORK
Cannot target search network.
CANNOT_TARGET_SEARCH_NETWORK_WITHOUT_GOOGLE_SEARCH
Cannot cover search network without google search network.
CANNOT_TARGET_GOOGLE_SEARCH_FOR_CPM_CAMPAIGN
Cannot target Google Search network for a CPM campaign.
CAMPAIGN_MUST_TARGET_AT_LEAST_ONE_NETWORK
Must target at least one network.
CANNOT_TARGET_PARTNER_SEARCH_NETWORK
Only some Google partners are allowed to target partner search network.
CANNOT_TARGET_CONTENT_NETWORK_ONLY_WITH_CRITERIA_LEVEL_BIDDING_STRATEGY
Cannot target content network only as campaign has criteria-level bidding strategy.
CAMPAIGN_DURATION_MUST_CONTAIN_ALL_RUNNABLE_TRIALS
Cannot modify the start or end date such that the campaign duration would not contain the durations of all runnable trials.
CANNOT_MODIFY_FOR_TRIAL_CAMPAIGN
Cannot modify dates, budget or campaign name of a trial campaign.
DUPLICATE_CAMPAIGN_NAME
Trying to modify the name of an active or paused campaign, where the name is already assigned to another active or paused campaign.
INCOMPATIBLE_CAMPAIGN_FIELD
Two fields are in conflicting modes.
INVALID_CAMPAIGN_NAME
Campaign name cannot be used.
INVALID_AD_SERVING_OPTIMIZATION_STATUS
Given status is invalid.
INVALID_TRACKING_URL
Error in the campaign level tracking url.
CANNOT_SET_BOTH_TRACKING_URL_TEMPLATE_AND_TRACKING_SETTING
Cannot set both tracking url template and tracking setting. An user has to clear legacy tracking setting in order to add tracking url template.
MAX_IMPRESSIONS_NOT_IN_RANGE
The maximum number of impressions for Frequency Cap should be an integer greater than 0.
TIME_UNIT_NOT_SUPPORTED
Only the Day, Week and Month time units are supported.
INVALID_OPERATION_IF_SERVING_STATUS_HAS_ENDED
Operation not allowed on a campaign whose serving status has ended
BUDGET_CANNOT_BE_SHARED
This budget is exclusively linked to a Campaign that is using @link{Experiment}s so it cannot be shared.
CAMPAIGN_CANNOT_USE_SHARED_BUDGET
Campaigns using @link{Experiment}s cannot use a shared budget.
CANNOT_CHANGE_BUDGET_ON_CAMPAIGN_WITH_TRIALS
A different budget cannot be assigned to a campaign when there are running or scheduled trials.
CAMPAIGN_LABEL_DOES_NOT_EXIST
No link found between the campaign and the label.
CAMPAIGN_LABEL_ALREADY_EXISTS
The label has already been attached to the campaign.
MISSING_SHOPPING_SETTING
A ShoppingSetting was not found when creating a shopping campaign.
INVALID_SHOPPING_SALES_COUNTRY
The country in shopping setting is not an allowed country.
SHOPPING_MERCHANT_NOT_ALLOWED_FOR_PURCHASES_ON_GOOGLE
Shopping merchant is not enabled for Purchases on Google.
PURCHASES_ON_GOOGLE_NOT_SUPPORTED_FOR_SHOPPING_SALES_COUNTRY
Purchases on Google not enabled for the shopping campaign's sales country.
MISSING_UNIVERSAL_APP_CAMPAIGN_SETTING
A Campaign with channel sub type UNIVERSAL_APP_CAMPAIGN must have a UniversalAppCampaignSetting specified.
ADVERTISING_CHANNEL_TYPE_NOT_AVAILABLE_FOR_ACCOUNT_TYPE
The requested channel type is not available according to the customer's account setting.
INVALID_ADVERTISING_CHANNEL_SUB_TYPE
The AdvertisingChannelSubType is not a valid subtype of the primary channel type.
AT_LEAST_ONE_CONVERSION_MUST_BE_SELECTED
At least one conversion must be selected.
CANNOT_SET_AD_ROTATION_MODE
Setting ad rotation mode for a campaign is not allowed. Ad rotation mode at campaign is deprecated.
UNKNOWN
Default error
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.
DateRangeError A list of all the error codes being used for date range error.
Enumerations
DATE_RANGE_ERROR
INVALID_DATE
Invalid date.
START_DATE_AFTER_END_DATE
The start date was after the end date.
CANNOT_SET_DATE_TO_PAST
Cannot set date to past time
AFTER_MAXIMUM_ALLOWABLE_DATE
A date was used that is past the system "last" date.
CANNOT_MODIFY_START_DATE_IF_ALREADY_STARTED
Trying to change start date on a campaign that has started.
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
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
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
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
TrialError Error class for TrialService.
Enumerations
UNKNOWN
INVALID_STATUS_TRANSITION
Trial status cannot be updated from the current status to the requested target status.
CANNOT_USE_TRIAL_WITH_SHARED_BUDGET
Cannot create a trial from a campaign using an explicitly shared budget.
CANNOT_CREATE_TRIAL_WHEN_CAMPAIGN_HAS_ACTIVE_EXPERIMENTS
Cannot create a trial as long as the campaign has a running or scheduled Advertiser Campaign Experiment.
CANNOT_CREATE_TRIAL_FOR_DELETED_BASE_CAMPAIGN
Cannot create a trial for a base campaign, which is deleted.
CANNOT_CREATE_TRIAL_FOR_NON_PROPOSED_DRAFT
Cannot create a trial from a draft, which has a status other than proposed.
CUSTOMER_CANNOT_CREATE_TRIAL
This customer is not allowed to create a trial.
CAMPAIGN_CANNOT_CREATE_TRIAL
This campaign is not allowed to create a trial.
NAME_ALREADY_IN_USE
Trying to use a trial name which is already assigned to another campaign or trial.
TRIAL_DURATIONS_MUST_NOT_OVERLAP
Trying to set a trial duration which overlaps with another trial.
TRIAL_DURATION_MUST_BE_WITHIN_CAMPAIGN_DURATION
All non-archived trials must start and end within their campaign's duration.

Send feedback about...

AdWords API
AdWords API
Need help? Visit our support page.