enum DealError.Reason (v202508)

  • DealError.Reason provides specific reasons for errors related to deals within the Ad Manager API.

  • Many errors prevent actions on a Proposal when it is already sold (isSold is true), including adding or archiving line items and archiving the proposal itself.

  • Actions on Proposals may be restricted if they require buyer approval or if local edits are not enabled.

  • Errors can occur if essential components like proposal line items, environment, seller ID, or associated Ad Exchange properties are missing.

  • Issues related to syncing with the Marketplace or finding the proposal or related products can also lead to DealError instances.
Service
ProposalLineItemService ProposalService PublisherQueryLanguageService
Dependencies
DealError
▼
DealError.Reason

The reasons for the target error.

Namespace
https://www.google.com/apis/ads/publisher/v202508
Enumeration Description
CANNOT_ADD_LINE_ITEM_WHEN_SOLD Cannot add new proposal line items to a Proposal when Proposal.isSold is true.
CANNOT_ARCHIVE_LINE_ITEM_WHEN_SOLD Cannot archive proposal line items from a Proposal when Proposal.isSold is true.
CANNOT_ARCHIVE_PROPOSAL_WHEN_SOLD Cannot archive a Proposal when Proposal.isSold is true.
CANNOT_CHANGE_FIELD_REQUIRING_BUYER_APPROVAL Cannot change a field that requires buyer approval during the current operation.
CANNOT_GET_SELLER_ID Cannot find seller ID for the Proposal.
CAN_ONLY_EXECUTE_IF_LOCAL_EDITS Proposal must be marked as editable by EditProposalsForNegotiation before performing requested action.
MISSING_PROPOSAL_LINE_ITEMS Proposal contains no proposal line items.
MISSING_ENVIRONMENT No environment set for Proposal.
MISSING_AD_EXCHANGE_PROPERTY The Ad Exchange property is not associated with the current network.
CANNOT_FIND_PROPOSAL_IN_MARKETPLACE Cannot find Proposal in Marketplace.
CANNOT_GET_PRODUCT No Product exists for buyer-initiated programmatic proposals.
NEW_VERSION_FROM_BUYER A new version of the Proposal was sent from buyer, cannot execute the requested action before performing DiscardLocalVersionEdits.
PROPOSAL_OUT_OF_SYNC_WITH_MARKETPLACE A new version of the Proposal exists in Marketplace, cannot execute the requested action before the proposal is synced to newest revision.
NO_PROPOSAL_CHANGES_FOUND No Proposal changes were found.
UNKNOWN The value returned if the actual value is not exposed by the requested API version.