type ProposalMarketplaceInfo (v202411)

AI-generated Key Takeaways

• ProposalMarketplaceInfo stores marketplace data for proposals linked to Marketplace orders.

• It includes details like marketplace ID, negotiation status, buyer ID, and flags for local edits and buyer updates.

• The marketplaceId is shared between Ad Manager and the buy-side platform and is null if the proposal hasn't been sent.

• hasLocalVersionEdits indicates if a proposal is open for local editing, preventing buyer updates from being automatically applied.

• isNewVersionFromBuyer signals that the buyer has updated the proposal on Marketplace, requiring seller action if local edits are present.

Service

ProposalService

Dependencies

Proposal

▼

ProposalMarketplaceInfo

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

---

Namespace

https://www.google.com/apis/ads/publisher/v202411

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.