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.
HTTP request
POST https://authorizedbuyersmarketplace.googleapis.com/v1/{buyer=buyers/*}/proposals:sendRfp
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
buyer |
Required. The current buyer who is sending the RFP in the format: |
Request body
The request body contains data with the following structure:
JSON representation |
---|
{ "displayName": string, "client": string, "publisherProfile": string, "buyerContacts": [ { object ( |
Fields | |
---|---|
displayName |
Required. The display name of the proposal being created by this RFP. |
client |
If the current buyer is sending the RFP on behalf of its client, use this field to specify the name of the client in the format: |
publisherProfile |
Required. The profile of the publisher who will receive this RFP in the format: |
buyerContacts[] |
Contact information for the buyer. |
note |
A message that is sent to the publisher. Maximum length is 1024 characters. |
geoTargeting |
Geo criteria IDs to be targeted. Refer to [Geo tables][https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv]. |
inventorySizeTargeting |
Inventory sizes to be targeted. |
estimatedGrossSpend |
Specified by buyers in request for proposal (RFP) to notify publisher the total estimated spend for the proposal. Publishers will receive this information and send back proposed deals accordingly. |
flightStartTime |
Required. Proposed flight start time of the RFP. A timestamp in RFC3339 UTC "Zulu" format. Note that the specified value will be truncated to a granularity of one second. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
flightEndTime |
Required. Proposed flight end time of the RFP. A timestamp in RFC3339 UTC "Zulu" format. Note that the specified value will be truncated to a granularity of one second. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
Union field pricing_terms . The negotiable terms of the RFP. pricing_terms can be only one of the following: |
|
programmaticGuaranteedTerms |
The terms for programmatic guaranteed deals. |
preferredDealTerms |
The terms for preferred deals. |
Response body
If successful, the response body contains an instance of Proposal
.
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/authorized-buyers-marketplace