type ProposalMarketplaceInfo (v202411)

  • ProposalMarketplaceInfo contains marketplace information for a proposal with a corresponding order in Marketplace.

  • It includes the marketplaceId, which is a shared ID between Ad Manager and the buy-side platform, and is read-only.

  • The hasLocalVersionEdits field indicates if the non-free-editable fields are open for edit, affecting whether buyer updates are received.

  • The negotiationStatus field shows the current negotiation stage of the proposal with various possible values.

  • The isNewVersionFromBuyer field indicates if the buyer has made updates while the proposal is open for local editing.
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.