type ProposalMarketplaceInfo (v202502)

AI-generated Key Takeaways

• 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.