type ProposalError (v202505)

  • ProposalError lists errors related to proposals and inherits from ApiError.

  • Common errors include invalid contacts, unsupported companies, and duplicated roles like salespeople or traffickers.

  • Currency code errors can occur if the proposal currency is not supported by the network or the selected buyer.

  • Several errors prevent updates or changes once a proposal reaches a certain status, such as updating the advertiser or currency after reservation.

  • The reason field provides an enum detailing specific causes for ProposalError.
Service
ProposalLineItemService ProposalService
Inheritance
ApiError
▼
ApiVersionError AudienceSegmentError AuthenticationError BillingError CollectionSizeError CommonError CurrencyCodeError CustomFieldValueError DealError EntityChildrenLimitReachedE... EntityLimitReachedError ExchangeRateError FeatureError ForecastError InternalApiError InvalidUrlError LabelEntityAssociationError LineItemOperationError NotNullError NullError ParseError PermissionError PrecisionError ProgrammaticError ProposalActionError ProposalError ProposalLineItemError ProposalLineItemMakegoodError ProposalLineItemProgrammati... PublisherQueryLanguageConte... PublisherQueryLanguageSynta... QuotaError RangeError RequiredCollectionError RequiredError RequiredNumberError ServerError StatementError StringFormatError StringLengthError TeamError TimeZoneError TypeError UniqueError

Lists all errors associated with proposals.

Namespace
https://www.google.com/apis/ads/publisher/v202505

Field
ApiError (inherited)

fieldPath

xsd:string

The OGNL field path to identify cause of error.

fieldPathElements

FieldPathElement[]

A parsed copy of the field path. For example, the field path "operations[1].operand" corresponds to this list: {FieldPathElement(field = "operations", index = 1), FieldPathElement(field = "operand", index = null)}.

trigger

xsd:string

The data that caused the error.

errorString

xsd:string

A simple string representation of the error and reason.

ProposalError

reason

ProposalError.Reason

The error reason represented by an enum.

Enumerations
AD_SERVER_UNKNOWN_ERROR
Unknown error from ad-server
AD_SERVER_API_ERROR
Ad-server reports an api error for the operation.
UPDATE_ADVERTISER_NOT_ALLOWED
Advertiser cannot be updated once the proposal has been reserved.
UPDATE_PROPOSAL_NOT_ALLOWED
Proposal cannot be updated when its status is not DRAFT or it is archived.
CONTACT_UNSUPPORTED_FOR_ADVERTISER
Contacts are not supported for advertisers in a programmatic Proposal.
INVALID_CONTACT
Contact associated with a proposal does not belong to the specific company.
DUPLICATED_CONTACT
Contact associated with a proposal's advertiser or agency is duplicated.
UNACCEPTABLE_COMPANY_CREDIT_STATUS
A proposal cannot be created or updated because the company it is associated with has Company.creditStatus that is not ACTIVE or ON_HOLD.
COMPANY_CREDIT_STATUS_NOT_ACTIVE
Advertiser or agency associated with the proposal has Company.creditStatus that is not ACTIVE.
PRIMARY_AGENCY_REQUIRED
Cannot have other agencies without a primary agency.
PRIMARY_AGENCY_NOT_UNIQUE
Cannot have more than one primary agency.
UNSUPPORTED_COMPANY_ASSOCIATION_TYPE_FOR_PROGRAMMATIC_PROPOSAL
The Company association type is not supported for programmatic proposals.
DUPLICATED_COMPANY_ASSOCIATION
Advertiser or agency associated with a proposal is duplicated.
DUPLICATED_SALESPERSON
Found duplicated primary or secondary sales person.
DUPLICATED_SALES_PLANNER
Found duplicated sales planner.
DUPLICATED_TRAFFICKER
Found duplicated primary or secondary trafficker.
HAS_NO_UNARCHIVED_PROPOSAL_LINEITEMS
The proposal has no unarchived proposal line items.
DUPLICATE_TERMS_AND_CONDITIONS
One or more of the terms and conditions being added already exists on the proposal.
UNSUPPORTED_PROPOSAL_CURRENCY_CODE
The currency code of the proposal is not supported by the current network. All supported currencies can be found in the union of Network.currencyCode and Network.secondaryCurrencyCodes.
UNSUPPORTED_BUYER_CURRENCY_CODE
The currency code of the proposal is not supported by the selected buyer.
INVALID_POC
The POC value of the proposal is invalid.
UPDATE_CURRENCY_NOT_ALLOWED
Currency cannot be updated once the proposal has been reserved.
UPDATE_TIME_ZONE_NOT_ALLOWED
Time zone cannot be updated once the proposal has been sold.
UNKNOWN
The value returned if the actual value is not exposed by the requested API version.