type ProposalMarketplaceInfo (v202502)

  • Marketplace info for a proposal corresponds to an order in Marketplace and is identified by a shared marketplaceId between Ad Manager and the buy-side platform.

  • The hasLocalVersionEdits field indicates if a proposal's non-free-editable fields are open for editing, which prevents receiving buyer updates.

  • The negotiationStatus field reflects the current state of negotiation for the proposal, with various enumerated values representing different stages like SELLER_INITIATED, BUYER_INITIATED, FINALIZED, or CANCELLED.

  • isNewVersionFromBuyer signifies that the buyer has updated the proposal in Marketplace, only relevant when the proposal is open for editing.

  • The buyerAccountId and partnerClientId identify the buyer associated with the proposal, where partnerClientId is a read-only ID assigned by Google.
Service
ProposalService
Dependencies
Proposal
▼
ProposalMarketplaceInfo

Marketplace info for a proposal with a corresponding order in Marketplace.

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

Field

marketplaceId

xsd:string

The marketplace ID of this proposal. This is a shared ID between Ad Manager and the buy-side platform. This value is null if the proposal has not been sent to the buyer. This attribute is read-only.

hasLocalVersionEdits

xsd:boolean

Whether the non-free-editable fields of a Proposal are opened for edit. A proposal that is open for edit will not receive buyer updates from Marketplace. If the buyer updates the proposal while this is open for local editing, Google will set isNewVersionFromBuyer to true. You will then need to call DiscardProposalDrafts to revert your edits to get the buyer's latest changes. This attribute is read-only.

negotiationStatus

NegotiationStatus

The negotiation status of the Proposal. This attribute is read-only.

Enumerations
SELLER_INITIATED
Indicates that a new Proposal has been created by the seller and has not been sent to Marketplace yet.
BUYER_INITIATED
Indicates that a new Proposal has been created by the buyer and is awaiting seller action.
AWAITING_SELLER_REVIEW
Indicates that a Proposal has been updated by the buyer and is awaiting seller approval.
AWAITING_BUYER_REVIEW
Indicates that a Proposal has been updated by the seller and is awaiting buyer approval.
ONLY_SELLER_ACCEPTED
Indicates that the seller has accepted the Proposal and is awaiting the buyer's acceptance.
FINALIZED
Indicates that the Proposal has been accepted by both the buyer and the seller.
CANCELLED
Indicates that negotiations for the Proposal have been cancelled.
UNKNOWN
The value returned if the actual value is not exposed by the requested API version.

marketplaceComment

xsd:string

The comment on the Proposal to be sent to the buyer.

isNewVersionFromBuyer

xsd:boolean

Indicates that the buyer has made updates to the proposal on Marketplace. This attribute is only meaningful if the proposal is open for edit (i.e., hasLocalVersionEdits is true) This attribute is read-only.

buyerAccountId

xsd:long

The Authorized Buyers ID of the buyer that this Proposal is being negotiated with.

This attribute is required.

partnerClientId

xsd:string

The ID used to represent Display & Video 360 client buyer partner ID (if Display & Video 360) or Authorized Buyers client buyer account ID. This field is readonly and assigned by Google. This attribute is read-only.