Skip to content

Commit

Permalink
feat(authorizedbuyersmarketplace): update the api
Browse files Browse the repository at this point in the history
#### authorizedbuyersmarketplace:v1

The following keys were added:
- schemas.Deal.properties.eligibleSeatIds (Total Keys: 3)
- schemas.Deal.properties.mediaPlanner (Total Keys: 2)
- schemas.MediaPlanner (Total Keys: 4)
  • Loading branch information
yoshi-automation committed Mar 5, 2024
1 parent 42a9bf9 commit 4ba1346
Show file tree
Hide file tree
Showing 4 changed files with 136 additions and 33 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -95,7 +95,7 @@ <h3>Method Details</h3>

Args:
parent: string, Required. The buyer to list the finalized deals for, in the format: `buyers/{accountId}`. When used to list finalized deals for a bidder, its buyers and clients, in the format `bidders/{accountId}`. (required)
filter: string, Optional query string using the [Cloud API list filtering syntax](https://developers.google.com/authorized-buyers/apis/guides/list-filters) Supported columns for filtering are: * deal.displayName * deal.dealType * deal.createTime * deal.updateTime * deal.flightStartTime * deal.flightEndTime * dealServingStatus
filter: string, Optional query string using the [Cloud API list filtering syntax](https://developers.google.com/authorized-buyers/apis/guides/list-filters) Supported columns for filtering are: * deal.displayName * deal.dealType * deal.createTime * deal.updateTime * deal.flightStartTime * deal.flightEndTime * deal.eligibleSeatIds * dealServingStatus
orderBy: string, An optional query string to sort finalized deals using the [Cloud API sorting syntax](https://cloud.google.com/apis/design/design_patterns#sorting_order). If no sort order is specified, results will be returned in an arbitrary order. Supported columns for sorting are: * deal.displayName * deal.createTime * deal.updateTime * deal.flightStartTime * deal.flightEndTime * rtbMetrics.bidRequests7Days * rtbMetrics.bids7Days * rtbMetrics.adImpressions7Days * rtbMetrics.bidRate7Days * rtbMetrics.filteredBidRate7Days * rtbMetrics.mustBidRateCurrentMonth Example: &#x27;deal.displayName, deal.updateTime desc&#x27;
pageSize: integer, Requested page size. The server may return fewer results than requested. If requested more than 500, the server will return 500 results per page. If unspecified, the server will pick a default page size of 100.
pageToken: string, The page token as returned from ListFinalizedDealsResponse.
Expand All @@ -111,8 +111,8 @@ <h3>Method Details</h3>
&quot;finalizedDeals&quot;: [ # The list of finalized deals.
{ # A finalized deal is a snapshot of the deal when both buyer and seller accept the deal. The buyer or seller can update the deal after it&#x27;s been finalized and renegotiate on the deal targeting, terms and other fields, while at the same time the finalized snapshot of the deal can still be retrieved using this API. The finalized deal contains a copy of the deal as it existed when most recently finalized, as well as fields related to deal serving such as pause/resume status, RTB metrics, and more.
&quot;deal&quot;: { # A deal represents a segment of inventory for displaying ads that contains the terms and targeting information that is used for serving as well as the deal stats and status. Note: A proposal may contain multiple deals. # A copy of the Deal made upon finalization. During renegotiation, this will reflect the last finalized deal before renegotiation was initiated.
&quot;billedBuyer&quot;: &quot;A String&quot;, # Output only. When the client field is populated, this field refers to the buyer who creates and manages the client buyer and gets billed on behalf of the client buyer; when the buyer field is populated, this field is the same value as buyer. Format : `buyers/{buyerAccountId}`
&quot;buyer&quot;: &quot;A String&quot;, # Output only. Refers to a buyer in The Realtime-bidding API. Format: `buyers/{buyerAccountId}`
&quot;billedBuyer&quot;: &quot;A String&quot;, # Output only. When the client field is populated, this field refers to the buyer who creates and manages the client buyer and gets billed on behalf of the client buyer; when the buyer field is populated, this field is the same value as buyer; when the deal belongs to a media planner account, this field will be empty. Format : `buyers/{buyerAccountId}`
&quot;buyer&quot;: &quot;A String&quot;, # Output only. Refers to a buyer in Real-time Bidding API&#x27;s Buyer resource. Format: `buyers/{buyerAccountId}`
&quot;client&quot;: &quot;A String&quot;, # Output only. Refers to a Client. Format: `buyers/{buyerAccountId}/clients/{clientAccountid}`
&quot;createTime&quot;: &quot;A String&quot;, # Output only. The time of the deal creation.
&quot;creativeRequirements&quot;: { # Message captures data about the creatives in the deal. # Output only. Metadata about the creatives of this deal.
Expand All @@ -139,13 +139,19 @@ <h3>Method Details</h3>
},
&quot;description&quot;: &quot;A String&quot;, # Output only. Free text description for the deal terms.
&quot;displayName&quot;: &quot;A String&quot;, # Output only. The name of the deal. Maximum length of 255 unicode characters is allowed. Control characters are not allowed. Buyers cannot update this field. Note: Not to be confused with name, which is a unique identifier of the deal.
&quot;eligibleSeatIds&quot;: [ # Output only. If set, this field contains the list of DSP specific seat ids set by media planners that are eligible to transact on this deal. The seat ID is in the calling DSP&#x27;s namespace.
&quot;A String&quot;,
],
&quot;estimatedGrossSpend&quot;: { # Represents an amount of money with its currency type. # 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.
&quot;currencyCode&quot;: &quot;A String&quot;, # The three-letter currency code defined in ISO 4217.
&quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
&quot;units&quot;: &quot;A String&quot;, # The whole units of the amount. For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
},
&quot;flightEndTime&quot;: &quot;A String&quot;, # Proposed flight end time of the deal. This will generally be stored in a granularity of a second. A value is not necessary for Private Auction deals.
&quot;flightStartTime&quot;: &quot;A String&quot;, # Proposed flight start time of the deal. This will generally be stored in the granularity of one second since deal serving starts at seconds boundary. Any time specified with more granularity (for example, in milliseconds) will be truncated towards the start of time in seconds.
&quot;mediaPlanner&quot;: { # Describes a single Media Planner account. # Output only. Refers to a buyer in Real-time Bidding API&#x27;s Buyer resource. This field represents a media planner (For example, agency or big advertiser).
&quot;accountId&quot;: &quot;A String&quot;, # Output only. Account ID of the media planner.
},
&quot;name&quot;: &quot;A String&quot;, # Immutable. The unique identifier of the deal. Auto-generated by the server when a deal is created. Format: buyers/{accountId}/proposals/{proposalId}/deals/{dealId}
&quot;preferredDealTerms&quot;: { # Pricing terms for Preferred Deals. # The terms for preferred deals.
&quot;fixedPrice&quot;: { # Represents a price and a pricing type for a deal. # Fixed price for the deal.
Expand Down
Loading

0 comments on commit 4ba1346

Please sign in to comment.