class BuyersProposals extends Resource (View source)

The "proposals" collection of methods.

Typical usage is:

 $authorizedbuyersmarketplaceService = new Google\Service\AuthorizedBuyersMarketplace(...);
 $proposals = $authorizedbuyersmarketplaceService->buyers_proposals;

Methods

accept(string $name, AcceptProposalRequest $postBody, array $optParams = [])

Accepts the proposal at the given revision number. If the revision number in the request is behind the latest from the server, an error message will be returned. This call updates the Proposal.state from BUYER_ACCEPTANCE_REQUESTED to FINALIZED; it has no side effect if the Proposal.state is already FINALIZED and throws exception if the Proposal.state is not either BUYER_ACCEPTANCE_REQUESTED or FINALIZED.

addNote(string $proposal, AddNoteRequest $postBody, array $optParams = [])

Creates a note for this proposal and sends to the seller. This method is not supported for proposals with DealType set to 'PRIVATE_AUCTION'.

cancelNegotiation(string $proposal, CancelNegotiationRequest $postBody, array $optParams = [])

Cancels an ongoing negotiation on a proposal. This does not cancel or end serving for the deals if the proposal has been finalized. If the proposal has not been finalized before, calling this method will set the Proposal.state to TERMINATED and increment the Proposal.proposal_revision. If the proposal has been finalized before and is under renegotiation now, calling this method will reset the Proposal.state to FINALIZED and increment the Proposal.proposal_revision. This method does not support private auction proposals whose Proposal.deal_type is 'PRIVATE_AUCTION'.

get(string $name, array $optParams = [])

Gets a proposal using its resource name. The proposal is returned at the latest revision. (proposals.get)

listBuyersProposals(string $parent, array $optParams = [])

Lists proposals. A filter expression using Cloud API list filtering syntax may be specified to filter the results.

patch(string $name, Proposal $postBody, array $optParams = [])

Updates the proposal at the given revision number. If the revision number in the request is behind the latest one kept in the server, an error message will be returned. See FieldMask for how to use FieldMask. Only fields specified in the UpdateProposalRequest.update_mask will be updated; Fields noted as 'Immutable' or 'Output only' yet specified in the UpdateProposalRequest.update_mask will be ignored and left unchanged.

sendRfp(string $buyer, SendRfpRequest $postBody, array $optParams = [])

Sends a request for proposal (RFP) to a publisher to initiate the negotiation regarding certain inventory. In the RFP, buyers can specify the deal type, deal terms, start and end dates, targeting, and a message to the publisher.

Details

Proposal accept(string $name, AcceptProposalRequest $postBody, array $optParams = [])

Accepts the proposal at the given revision number. If the revision number in the request is behind the latest from the server, an error message will be returned. This call updates the Proposal.state from BUYER_ACCEPTANCE_REQUESTED to FINALIZED; it has no side effect if the Proposal.state is already FINALIZED and throws exception if the Proposal.state is not either BUYER_ACCEPTANCE_REQUESTED or FINALIZED.

Accepting a proposal means the buyer understands and accepts the Proposal.terms_and_conditions proposed by the seller. (proposals.accept)

Parameters

string $name

Name of the proposal. Format: buyers/{accountId}/proposals/{proposalId}

AcceptProposalRequest $postBody
array $optParams

Optional parameters.

Return Value

Proposal

Exceptions

Exception

Proposal addNote(string $proposal, AddNoteRequest $postBody, array $optParams = [])

Creates a note for this proposal and sends to the seller. This method is not supported for proposals with DealType set to 'PRIVATE_AUCTION'.

(proposals.addNote)

Parameters

string $proposal

Name of the proposal. Format: buyers/{accountId}/proposals/{proposalId}

AddNoteRequest $postBody
array $optParams

Optional parameters.

Return Value

Proposal

Exceptions

Exception

Proposal cancelNegotiation(string $proposal, CancelNegotiationRequest $postBody, array $optParams = [])

Cancels an ongoing negotiation on a proposal. This does not cancel or end serving for the deals if the proposal has been finalized. If the proposal has not been finalized before, calling this method will set the Proposal.state to TERMINATED and increment the Proposal.proposal_revision. If the proposal has been finalized before and is under renegotiation now, calling this method will reset the Proposal.state to FINALIZED and increment the Proposal.proposal_revision. This method does not support private auction proposals whose Proposal.deal_type is 'PRIVATE_AUCTION'.

(proposals.cancelNegotiation)

Parameters

string $proposal

Name of the proposal. Format: buyers/{accountId}/proposals/{proposalId}

CancelNegotiationRequest $postBody
array $optParams

Optional parameters.

Return Value

Proposal

Exceptions

Exception

Proposal get(string $name, array $optParams = [])

Gets a proposal using its resource name. The proposal is returned at the latest revision. (proposals.get)

Parameters

string $name

Required. Name of the proposal. Format: buyers/{accountId}/proposals/{proposalId}

array $optParams

Optional parameters.

Return Value

Proposal

Exceptions

Exception

ListProposalsResponse listBuyersProposals(string $parent, array $optParams = [])

Lists proposals. A filter expression using Cloud API list filtering syntax may be specified to filter the results.

(proposals.listBuyersProposals)

Parameters

string $parent

Required. Parent that owns the collection of proposals Format: buyers/{accountId}

array $optParams

Optional parameters.

Return Value

ListProposalsResponse

Exceptions

Exception

Proposal patch(string $name, Proposal $postBody, array $optParams = [])

Updates the proposal at the given revision number. If the revision number in the request is behind the latest one kept in the server, an error message will be returned. See FieldMask for how to use FieldMask. Only fields specified in the UpdateProposalRequest.update_mask will be updated; Fields noted as 'Immutable' or 'Output only' yet specified in the UpdateProposalRequest.update_mask will be ignored and left unchanged.

Updating a private auction proposal is not allowed and will result in an error. (proposals.patch)

Parameters

string $name

Immutable. The name of the proposal serving as a unique identifier. Format: buyers/{accountId}/proposals/{proposalId}

Proposal $postBody
array $optParams

Optional parameters.

Return Value

Proposal

Exceptions

Exception

Proposal sendRfp(string $buyer, SendRfpRequest $postBody, array $optParams = [])

Sends a request for proposal (RFP) to a publisher to initiate the negotiation regarding certain inventory. In the RFP, buyers can specify the deal type, deal terms, start and end dates, targeting, and a message to the publisher.

Once the RFP is sent, a proposal in SELLER_REVIEW_REQUESTED state will be created and returned in the response. The publisher may review your request and respond with detailed deals in the proposal. (proposals.sendRfp)

Parameters

string $buyer

Required. The current buyer who is sending the RFP in the format: buyers/{accountId}.

SendRfpRequest $postBody
array $optParams

Optional parameters.

Return Value

Proposal

Exceptions

Exception