Sign in

v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-1350108168.1 KB
accounts

Create the given proposal. Each created proposal and any deals it contains are assigned a unique ID by the server.

post/v2beta1/accounts/{accountId}/proposals

Path parameters

accountIdstring required

Account ID of the buyer.

Request body

proposalIdstring

Output only. The unique ID of the proposal.

proposalState'PROPOSAL_STATE_UNSPECIFIED' | 'PROPOSED' | 'BUYER_ACCEPTED' | 'SELLER_ACCEPTED' | 'CANCELED' | 'FINALIZED'

Output only. The current state of the proposal.

termsAndConditionsstring

Output only. The terms and conditions set by the publisher for this proposal.

updateTimestring google-datetime

Output only. The time when the proposal was last revised.

originatorRole'BUYER_SELLER_ROLE_UNSPECIFIED' | 'BUYER' | 'SELLER'

Output only. Indicates whether the buyer/seller created the proposal.

lastUpdaterOrCommentorRole'BUYER_SELLER_ROLE_UNSPECIFIED' | 'BUYER' | 'SELLER'

Output only. The role of the last user that either updated the proposal or left a comment.

proposalRevisionstring int64

Output only. The revision number for the proposal. Each update to the proposal or the deal causes the proposal revision number to auto-increment. The buyer keeps track of the last revision number they know of and pass it in when making an update. If the head revision number on the server has since incremented, then an ABORTED error is returned during the update operation to let the buyer know that a subsequent update was made.

privateAuctionIdstring

Output only. Private auction ID if this proposal is a private auction proposal.

displayNamestring

The name for the proposal.

isRenegotiatingboolean

Output only. True if the proposal is being renegotiated.

isSetupCompleteboolean

Output only. True, if the buyside inventory setup is complete for this proposal.

Response

Successful response