blob: b83e69ace499422b2e4a043f4c635685400166e9 [file] [log] [blame]
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001<html><body>
2<style>
3
4body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13}
14
15body {
16 font-size: 13px;
17 padding: 1em;
18}
19
20h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23}
24
25h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28}
29
30h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34}
35
36pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42 margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46 font-family: Arial, sans serif;
47}
48
49h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51}
52
53.toc_element {
54 margin-top: 0.5em;
55}
56
57.firstline {
58 margin-left: 2 em;
59}
60
61.method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66}
67
68.details {
69 font-weight: bold;
70 font-size: 14px;
71}
72
73</style>
74
75<h1><a href="adexchangebuyer2_v2beta1.html">Ad Exchange Buyer API II</a> . <a href="adexchangebuyer2_v2beta1.accounts.html">accounts</a> . <a href="adexchangebuyer2_v2beta1.accounts.finalizedProposals.html">finalizedProposals</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
Bu Sun Kim65020912020-05-20 12:08:20 -070078 <code><a href="#list">list(accountId, filterSyntax=None, filter=None, pageToken=None, pageSize=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070079<p class="firstline">List finalized proposals, regardless if a proposal is being renegotiated.</p>
80<p class="toc_element">
81 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
82<p class="firstline">Retrieves the next page of results.</p>
83<h3>Method Details</h3>
84<div class="method">
Bu Sun Kim65020912020-05-20 12:08:20 -070085 <code class="details" id="list">list(accountId, filterSyntax=None, filter=None, pageToken=None, pageSize=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070086 <pre>List finalized proposals, regardless if a proposal is being renegotiated.
87A filter expression (PQL query) may be specified to filter the results.
88The notes will not be returned.
89
90Args:
91 accountId: string, Account ID of the buyer. (required)
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070092 filterSyntax: string, Syntax the filter is written in. Current implementation defaults to PQL
93but in the future it will be LIST_FILTER.
94 filter: string, An optional PQL filter query used to query for proposals.
95
96Nested repeated fields, such as proposal.deals.targetingCriterion,
97cannot be filtered.
Bu Sun Kim65020912020-05-20 12:08:20 -070098 pageToken: string, The page token as returned from ListProposalsResponse.
99 pageSize: integer, Requested page size. The server may return fewer results than requested.
100If unspecified, the server will pick an appropriate default.
101 x__xgafv: string, V1 error format.
102 Allowed values
103 1 - v1 error format
104 2 - v2 error format
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700105
106Returns:
107 An object of the form:
108
109 { # Response message for listing proposals.
Bu Sun Kim65020912020-05-20 12:08:20 -0700110 &quot;nextPageToken&quot;: &quot;A String&quot;, # Continuation token for fetching the next page of results.
111 &quot;proposals&quot;: [ # The list of proposals.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700112 { # Note: this resource requires whitelisting for access. Please contact your
113 # account manager for access to Marketplace resources.
114 #
115 # Represents a proposal in the Marketplace. A proposal is the unit of
116 # negotiation between a seller and a buyer and contains deals which
117 # are served.
118 #
119 # Note: you can not update, create, or otherwise modify Private
120 # Auction or Preferred Deals deals through the API.
121 #
122 # Fields are updatable unless noted otherwise.
Bu Sun Kim65020912020-05-20 12:08:20 -0700123 &quot;buyer&quot;: { # Represents a buyer of inventory. Each buyer is identified by a unique # Reference to the buyer on the proposal.
124 #
125 # Note: This field may be set only when creating the resource. Modifying
126 # this field while updating the resource will result in an error.
127 # Authorized Buyers account ID.
128 &quot;accountId&quot;: &quot;A String&quot;, # Authorized Buyers account ID of the buyer.
129 },
130 &quot;isRenegotiating&quot;: True or False, # Output only. True if the proposal is being renegotiated.
131 &quot;notes&quot;: [ # Output only. The notes associated with this proposal.
132 { # A proposal may be associated to several notes.
133 &quot;note&quot;: &quot;A String&quot;, # The actual note to attach.
134 # (max-length: 1024 unicode code units)
135 #
136 # Note: This field may be set only when creating the resource. Modifying
137 # this field while updating the resource will result in an error.
138 &quot;proposalRevision&quot;: &quot;A String&quot;, # Output only. The revision number of the proposal when the note is created.
139 &quot;noteId&quot;: &quot;A String&quot;, # Output only. The unique ID for the note.
140 &quot;createTime&quot;: &quot;A String&quot;, # Output only. The timestamp for when this note was created.
141 &quot;creatorRole&quot;: &quot;A String&quot;, # Output only. The role of the person (buyer/seller) creating the note.
142 },
143 ],
144 &quot;isSetupComplete&quot;: True or False, # Output only. True, if the buyside inventory setup is complete for this
145 # proposal.
146 &quot;proposalState&quot;: &quot;A String&quot;, # Output only. The current state of the proposal.
147 &quot;sellerContacts&quot;: [ # Output only. Contact information for the seller.
148 { # Contains information on how a buyer or seller can be reached.
149 &quot;email&quot;: &quot;A String&quot;, # Email address for the contact.
150 &quot;name&quot;: &quot;A String&quot;, # The name of the contact.
151 },
152 ],
153 &quot;privateAuctionId&quot;: &quot;A String&quot;, # Output only. Private auction ID if this proposal is a private auction
154 # proposal.
155 &quot;originatorRole&quot;: &quot;A String&quot;, # Output only. Indicates whether the buyer/seller created the proposal.
156 &quot;lastUpdaterOrCommentorRole&quot;: &quot;A String&quot;, # Output only. The role of the last user that either updated the proposal or
157 # left a comment.
158 &quot;buyerPrivateData&quot;: { # Buyers are allowed to store certain types of private data in a proposal/deal. # Private data for buyer. (hidden from seller).
159 &quot;referenceId&quot;: &quot;A String&quot;, # A buyer or seller specified reference ID. This can be queried in the list
160 # operations (max-length: 1024 unicode code units).
161 },
162 &quot;displayName&quot;: &quot;A String&quot;, # The name for the proposal.
163 &quot;buyerContacts&quot;: [ # Contact information for the buyer.
164 { # Contains information on how a buyer or seller can be reached.
165 &quot;email&quot;: &quot;A String&quot;, # Email address for the contact.
166 &quot;name&quot;: &quot;A String&quot;, # The name of the contact.
167 },
168 ],
169 &quot;billedBuyer&quot;: { # Represents a buyer of inventory. Each buyer is identified by a unique # Output only. Reference to the buyer that will get billed for this proposal.
170 # Authorized Buyers account ID.
171 &quot;accountId&quot;: &quot;A String&quot;, # Authorized Buyers account ID of the buyer.
172 },
173 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The time when the proposal was last revised.
174 &quot;proposalId&quot;: &quot;A String&quot;, # Output only. The unique ID of the proposal.
175 &quot;deals&quot;: [ # The deals associated with this proposal. For Private Auction proposals
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700176 # (whose deals have NonGuaranteedAuctionTerms), there will only be one deal.
177 { # A deal represents a segment of inventory for displaying ads on.
178 # A proposal can contain multiple deals. A deal contains the terms and
179 # targeting information that is used for serving.
Bu Sun Kim65020912020-05-20 12:08:20 -0700180 &quot;programmaticCreativeSource&quot;: &quot;A String&quot;, # Output only. Specifies the creative source for programmatic deals.
181 # PUBLISHER means creative is provided by seller and ADVERTISER means
182 # creative is provided by buyer.
183 &quot;buyerPrivateData&quot;: { # Buyers are allowed to store certain types of private data in a proposal/deal. # Buyer private data (hidden from seller).
184 &quot;referenceId&quot;: &quot;A String&quot;, # A buyer or seller specified reference ID. This can be queried in the list
185 # operations (max-length: 1024 unicode code units).
186 },
187 &quot;displayName&quot;: &quot;A String&quot;, # The name of the deal.
188 &quot;webPropertyCode&quot;: &quot;A String&quot;, # The web property code for the seller copied over from the product.
189 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The time when the deal was last updated.
190 &quot;targetingCriterion&quot;: [ # The shared targeting visible to buyers and sellers. Each shared
191 # targeting entity is AND&#x27;d together.
192 { # Advertisers can target different attributes of an ad slot. For example,
193 # they can choose to show ads only if the user is in the U.S. Such
194 # targeting criteria can be specified as part of Shared Targeting.
195 &quot;exclusions&quot;: [ # The list of values to exclude from targeting. Each value is AND&#x27;d
196 # together.
197 { # A polymorphic targeting value used as part of Shared Targeting.
198 &quot;creativeSizeValue&quot;: { # Specifies the size of the creative. # The creative size value to include/exclude.
199 # Filled in when key = GOOG_CREATIVE_SIZE
200 &quot;size&quot;: { # Message depicting the size of the creative. The units of width and # For regular or video creative size type, specifies the size
201 # of the creative
202 # height depend on the type of the targeting.
203 &quot;height&quot;: 42, # The height of the creative.
204 &quot;width&quot;: 42, # The width of the creative
205 },
206 &quot;allowedFormats&quot;: [ # What formats are allowed by the publisher.
207 # If this repeated field is empty then all formats are allowed.
208 # For example, if this field contains AllowedFormatType.AUDIO then the
209 # publisher only allows an audio ad (without any video).
210 &quot;A String&quot;,
211 ],
212 &quot;companionSizes&quot;: [ # For video creatives specifies the sizes of companion ads (if present).
213 # Companion sizes may be filled in only when creative_size_type = VIDEO
214 { # Message depicting the size of the creative. The units of width and
215 # height depend on the type of the targeting.
216 &quot;height&quot;: 42, # The height of the creative.
217 &quot;width&quot;: 42, # The width of the creative
218 },
219 ],
220 &quot;skippableAdType&quot;: &quot;A String&quot;, # The type of skippable ad for this creative. It will have a value only if
221 # creative_size_type = CreativeSizeType.VIDEO.
222 &quot;creativeSizeType&quot;: &quot;A String&quot;, # The creative size type.
223 &quot;nativeTemplate&quot;: &quot;A String&quot;, # Output only. The native template for this creative. It will have a value
224 # only if creative_size_type = CreativeSizeType.NATIVE.
225 },
226 &quot;stringValue&quot;: &quot;A String&quot;, # The string value to include/exclude.
227 &quot;longValue&quot;: &quot;A String&quot;, # The long value to include/exclude.
228 &quot;dayPartTargetingValue&quot;: { # Specifies the day part targeting criteria. # The daypart targeting to include / exclude.
229 # Filled in when the key is GOOG_DAYPART_TARGETING.
230 # The definition of this targeting is derived from the structure
231 # used by Ad Manager.
232 &quot;timeZoneType&quot;: &quot;A String&quot;, # The timezone to use for interpreting the day part targeting.
233 &quot;dayParts&quot;: [ # A list of day part targeting criterion.
234 { # Daypart targeting message that specifies if the ad can be shown
235 # only during certain parts of a day/week.
236 &quot;startTime&quot;: { # Represents a time of day. The date and time zone are either not significant # The starting time of day for the ad to show (minute level granularity).
237 # The start time is inclusive.
238 # This field is not available for filtering in PQL queries.
239 # or are specified elsewhere. An API may choose to allow leap seconds. Related
240 # types are google.type.Date and `google.protobuf.Timestamp`.
241 &quot;minutes&quot;: 42, # Minutes of hour of day. Must be from 0 to 59.
242 &quot;hours&quot;: 42, # Hours of day in 24 hour format. Should be from 0 to 23. An API may choose
243 # to allow the value &quot;24:00:00&quot; for scenarios like business closing time.
244 &quot;nanos&quot;: 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
245 &quot;seconds&quot;: 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may
246 # allow the value 60 if it allows leap-seconds.
247 },
248 &quot;dayOfWeek&quot;: &quot;A String&quot;, # The day of the week to target. If unspecified, applicable to all days.
249 &quot;endTime&quot;: { # Represents a time of day. The date and time zone are either not significant # The ending time of the day for the ad to show (minute level
250 # granularity). The end time is exclusive. This field is not available
251 # for filtering in PQL queries.
252 # or are specified elsewhere. An API may choose to allow leap seconds. Related
253 # types are google.type.Date and `google.protobuf.Timestamp`.
254 &quot;minutes&quot;: 42, # Minutes of hour of day. Must be from 0 to 59.
255 &quot;hours&quot;: 42, # Hours of day in 24 hour format. Should be from 0 to 23. An API may choose
256 # to allow the value &quot;24:00:00&quot; for scenarios like business closing time.
257 &quot;nanos&quot;: 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
258 &quot;seconds&quot;: 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may
259 # allow the value 60 if it allows leap-seconds.
260 },
261 },
262 ],
263 },
264 },
265 ],
266 &quot;key&quot;: &quot;A String&quot;, # The key representing the shared targeting criterion.
267 # Targeting criteria defined by Google ad servers will begin with GOOG_.
268 # Third parties may define their own keys.
269 # A list of permissible keys along with the acceptable values will be
270 # provided as part of the external documentation.
271 &quot;inclusions&quot;: [ # The list of value to include as part of the targeting. Each value is OR&#x27;d
272 # together.
273 { # A polymorphic targeting value used as part of Shared Targeting.
274 &quot;creativeSizeValue&quot;: { # Specifies the size of the creative. # The creative size value to include/exclude.
275 # Filled in when key = GOOG_CREATIVE_SIZE
276 &quot;size&quot;: { # Message depicting the size of the creative. The units of width and # For regular or video creative size type, specifies the size
277 # of the creative
278 # height depend on the type of the targeting.
279 &quot;height&quot;: 42, # The height of the creative.
280 &quot;width&quot;: 42, # The width of the creative
281 },
282 &quot;allowedFormats&quot;: [ # What formats are allowed by the publisher.
283 # If this repeated field is empty then all formats are allowed.
284 # For example, if this field contains AllowedFormatType.AUDIO then the
285 # publisher only allows an audio ad (without any video).
286 &quot;A String&quot;,
287 ],
288 &quot;companionSizes&quot;: [ # For video creatives specifies the sizes of companion ads (if present).
289 # Companion sizes may be filled in only when creative_size_type = VIDEO
290 { # Message depicting the size of the creative. The units of width and
291 # height depend on the type of the targeting.
292 &quot;height&quot;: 42, # The height of the creative.
293 &quot;width&quot;: 42, # The width of the creative
294 },
295 ],
296 &quot;skippableAdType&quot;: &quot;A String&quot;, # The type of skippable ad for this creative. It will have a value only if
297 # creative_size_type = CreativeSizeType.VIDEO.
298 &quot;creativeSizeType&quot;: &quot;A String&quot;, # The creative size type.
299 &quot;nativeTemplate&quot;: &quot;A String&quot;, # Output only. The native template for this creative. It will have a value
300 # only if creative_size_type = CreativeSizeType.NATIVE.
301 },
302 &quot;stringValue&quot;: &quot;A String&quot;, # The string value to include/exclude.
303 &quot;longValue&quot;: &quot;A String&quot;, # The long value to include/exclude.
304 &quot;dayPartTargetingValue&quot;: { # Specifies the day part targeting criteria. # The daypart targeting to include / exclude.
305 # Filled in when the key is GOOG_DAYPART_TARGETING.
306 # The definition of this targeting is derived from the structure
307 # used by Ad Manager.
308 &quot;timeZoneType&quot;: &quot;A String&quot;, # The timezone to use for interpreting the day part targeting.
309 &quot;dayParts&quot;: [ # A list of day part targeting criterion.
310 { # Daypart targeting message that specifies if the ad can be shown
311 # only during certain parts of a day/week.
312 &quot;startTime&quot;: { # Represents a time of day. The date and time zone are either not significant # The starting time of day for the ad to show (minute level granularity).
313 # The start time is inclusive.
314 # This field is not available for filtering in PQL queries.
315 # or are specified elsewhere. An API may choose to allow leap seconds. Related
316 # types are google.type.Date and `google.protobuf.Timestamp`.
317 &quot;minutes&quot;: 42, # Minutes of hour of day. Must be from 0 to 59.
318 &quot;hours&quot;: 42, # Hours of day in 24 hour format. Should be from 0 to 23. An API may choose
319 # to allow the value &quot;24:00:00&quot; for scenarios like business closing time.
320 &quot;nanos&quot;: 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
321 &quot;seconds&quot;: 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may
322 # allow the value 60 if it allows leap-seconds.
323 },
324 &quot;dayOfWeek&quot;: &quot;A String&quot;, # The day of the week to target. If unspecified, applicable to all days.
325 &quot;endTime&quot;: { # Represents a time of day. The date and time zone are either not significant # The ending time of the day for the ad to show (minute level
326 # granularity). The end time is exclusive. This field is not available
327 # for filtering in PQL queries.
328 # or are specified elsewhere. An API may choose to allow leap seconds. Related
329 # types are google.type.Date and `google.protobuf.Timestamp`.
330 &quot;minutes&quot;: 42, # Minutes of hour of day. Must be from 0 to 59.
331 &quot;hours&quot;: 42, # Hours of day in 24 hour format. Should be from 0 to 23. An API may choose
332 # to allow the value &quot;24:00:00&quot; for scenarios like business closing time.
333 &quot;nanos&quot;: 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
334 &quot;seconds&quot;: 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may
335 # allow the value 60 if it allows leap-seconds.
336 },
337 },
338 ],
339 },
340 },
341 ],
342 },
343 ],
344 &quot;dealId&quot;: &quot;A String&quot;, # Output only. A unique deal ID for the deal (server-assigned).
345 &quot;proposalId&quot;: &quot;A String&quot;, # Output only. ID of the proposal that this deal is part of.
346 &quot;availableEndTime&quot;: &quot;A String&quot;, # Proposed flight end time of the deal.
347 # This will generally be stored in a granularity of a second.
348 # A value is not required for Private Auction deals or Preferred Deals.
349 &quot;syndicationProduct&quot;: &quot;A String&quot;, # The syndication product associated with the deal.
350 #
351 # Note: This field may be set only when creating the resource. Modifying
352 # this field while updating the resource will result in an error.
353 &quot;createProductId&quot;: &quot;A String&quot;, # The product ID from which this deal was created.
354 #
355 # Note: This field may be set only when creating the resource. Modifying
356 # this field while updating the resource will result in an error.
357 &quot;creativeSafeFrameCompatibility&quot;: &quot;A String&quot;, # Output only. Specifies whether the creative is safeFrame compatible.
358 &quot;isSetupComplete&quot;: True or False, # Output only. True, if the buyside inventory setup is complete for this
359 # deal.
360 &quot;createProductRevision&quot;: &quot;A String&quot;, # Optional revision number of the product that the deal was created from.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700361 # If present on create, and the server `product_revision` has advanced sinced
362 # the passed-in `create_product_revision`, an `ABORTED` error will be
363 # returned.
364 #
365 # Note: This field may be set only when creating the resource. Modifying
366 # this field while updating the resource will result in an error.
Bu Sun Kim65020912020-05-20 12:08:20 -0700367 &quot;sellerContacts&quot;: [ # Output only. Seller contact information for the deal.
368 { # Contains information on how a buyer or seller can be reached.
369 &quot;email&quot;: &quot;A String&quot;, # Email address for the contact.
370 &quot;name&quot;: &quot;A String&quot;, # The name of the contact.
371 },
372 ],
373 &quot;availableStartTime&quot;: &quot;A String&quot;, # Optional proposed flight start time of the deal.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700374 # This will generally be stored in the granularity of one second since deal
375 # serving starts at seconds boundary. Any time specified with more
376 # granularity (e.g., in milliseconds) will be truncated towards the start of
377 # time in seconds.
Bu Sun Kim65020912020-05-20 12:08:20 -0700378 &quot;createTime&quot;: &quot;A String&quot;, # Output only. The time of the deal creation.
379 &quot;dealTerms&quot;: { # The deal terms specify the details of a Product/deal. They specify things # The negotiable terms of the deal.
380 # like price per buyer, the type of pricing model (e.g., fixed price, auction)
381 # and expected impressions from the publisher.
382 &quot;description&quot;: &quot;A String&quot;, # Publisher provided description for the terms.
383 &quot;nonGuaranteedFixedPriceTerms&quot;: { # Terms for Preferred Deals. Note that Preferred Deals cannot be created via # The terms for non-guaranteed fixed price deals.
384 # the API at this time, but can be returned in a get or list request.
385 &quot;fixedPrices&quot;: [ # Fixed price for the specified buyer.
386 { # Used to specify pricing rules for buyers/advertisers. Each PricePerBuyer in
387 # a product can become 0 or 1 deals. To check if there is a PricePerBuyer for
388 # a particular buyer or buyer/advertiser pair, we look for the most specific
389 # matching rule - we first look for a rule matching the buyer and advertiser,
390 # next a rule with the buyer but an empty advertiser list, and otherwise look
391 # for a matching rule where no buyer is set.
392 &quot;price&quot;: { # Represents a price and a pricing type for a product / deal. # The specified price.
393 &quot;amount&quot;: { # Represents an amount of money with its currency type. # The actual price with currency specified.
394 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
395 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
396 # The value must be between -999,999,999 and +999,999,999 inclusive.
397 # If `units` is positive, `nanos` must be positive or zero.
398 # If `units` is zero, `nanos` can be positive, zero, or negative.
399 # If `units` is negative, `nanos` must be negative or zero.
400 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
401 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
402 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
403 },
404 &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product. (default: CPM)
405 },
406 &quot;advertiserIds&quot;: [ # The list of advertisers for this price when associated with this buyer.
407 # If empty, all advertisers with this buyer pay this price.
408 &quot;A String&quot;,
409 ],
410 &quot;buyer&quot;: { # Represents a buyer of inventory. Each buyer is identified by a unique # The buyer who will pay this price. If unset, all buyers can pay this price
411 # (if the
412 # advertisers match, and there&#x27;s no more specific rule matching the buyer).
413 # Authorized Buyers account ID.
414 &quot;accountId&quot;: &quot;A String&quot;, # Authorized Buyers account ID of the buyer.
415 },
416 },
417 ],
418 },
419 &quot;estimatedImpressionsPerDay&quot;: &quot;A String&quot;, # Non-binding estimate of the impressions served per day.
420 # Can be set by buyer or seller.
421 &quot;nonGuaranteedAuctionTerms&quot;: { # Terms for Private Auctions. Note that Private Auctions can be created only # The terms for non-guaranteed auction deals.
422 # by the seller, but they can be returned in a get or list request.
423 &quot;autoOptimizePrivateAuction&quot;: True or False, # True if open auction buyers are allowed to compete with invited buyers
424 # in this private auction.
425 &quot;reservePricesPerBuyer&quot;: [ # Reserve price for the specified buyer.
426 { # Used to specify pricing rules for buyers/advertisers. Each PricePerBuyer in
427 # a product can become 0 or 1 deals. To check if there is a PricePerBuyer for
428 # a particular buyer or buyer/advertiser pair, we look for the most specific
429 # matching rule - we first look for a rule matching the buyer and advertiser,
430 # next a rule with the buyer but an empty advertiser list, and otherwise look
431 # for a matching rule where no buyer is set.
432 &quot;price&quot;: { # Represents a price and a pricing type for a product / deal. # The specified price.
433 &quot;amount&quot;: { # Represents an amount of money with its currency type. # The actual price with currency specified.
434 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
435 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
436 # The value must be between -999,999,999 and +999,999,999 inclusive.
437 # If `units` is positive, `nanos` must be positive or zero.
438 # If `units` is zero, `nanos` can be positive, zero, or negative.
439 # If `units` is negative, `nanos` must be negative or zero.
440 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
441 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
442 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
443 },
444 &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product. (default: CPM)
445 },
446 &quot;advertiserIds&quot;: [ # The list of advertisers for this price when associated with this buyer.
447 # If empty, all advertisers with this buyer pay this price.
448 &quot;A String&quot;,
449 ],
450 &quot;buyer&quot;: { # Represents a buyer of inventory. Each buyer is identified by a unique # The buyer who will pay this price. If unset, all buyers can pay this price
451 # (if the
452 # advertisers match, and there&#x27;s no more specific rule matching the buyer).
453 # Authorized Buyers account ID.
454 &quot;accountId&quot;: &quot;A String&quot;, # Authorized Buyers account ID of the buyer.
455 },
456 },
457 ],
458 },
459 &quot;estimatedGrossSpend&quot;: { # Represents a price and a pricing type for a product / deal. # Non-binding estimate of the estimated gross spend for this deal.
460 # Can be set by buyer or seller.
461 &quot;amount&quot;: { # Represents an amount of money with its currency type. # The actual price with currency specified.
462 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
463 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
464 # The value must be between -999,999,999 and +999,999,999 inclusive.
465 # If `units` is positive, `nanos` must be positive or zero.
466 # If `units` is zero, `nanos` can be positive, zero, or negative.
467 # If `units` is negative, `nanos` must be negative or zero.
468 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
469 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
470 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
471 },
472 &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product. (default: CPM)
473 },
474 &quot;brandingType&quot;: &quot;A String&quot;, # Visibility of the URL in bid requests. (default: BRANDED)
475 &quot;sellerTimeZone&quot;: &quot;A String&quot;, # The time zone name. For deals with Cost Per Day billing, defines the
476 # time zone used to mark the boundaries of a day. It should be an
477 # IANA TZ name, such as &quot;America/Los_Angeles&quot;. For more information,
478 # see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones.
479 &quot;guaranteedFixedPriceTerms&quot;: { # Terms for Programmatic Guaranteed Deals. # The terms for guaranteed fixed price deals.
480 &quot;guaranteedImpressions&quot;: &quot;A String&quot;, # Guaranteed impressions as a percentage. This is the percentage
481 # of guaranteed looks that the buyer is guaranteeing to buy.
482 &quot;minimumDailyLooks&quot;: &quot;A String&quot;, # Daily minimum looks for CPD deal types.
483 &quot;guaranteedLooks&quot;: &quot;A String&quot;, # Count of guaranteed looks. Required for deal, optional for product.
484 &quot;fixedPrices&quot;: [ # Fixed price for the specified buyer.
485 { # Used to specify pricing rules for buyers/advertisers. Each PricePerBuyer in
486 # a product can become 0 or 1 deals. To check if there is a PricePerBuyer for
487 # a particular buyer or buyer/advertiser pair, we look for the most specific
488 # matching rule - we first look for a rule matching the buyer and advertiser,
489 # next a rule with the buyer but an empty advertiser list, and otherwise look
490 # for a matching rule where no buyer is set.
491 &quot;price&quot;: { # Represents a price and a pricing type for a product / deal. # The specified price.
492 &quot;amount&quot;: { # Represents an amount of money with its currency type. # The actual price with currency specified.
493 &quot;currencyCode&quot;: &quot;A String&quot;, # The 3-letter currency code defined in ISO 4217.
494 &quot;nanos&quot;: 42, # Number of nano (10^-9) units of the amount.
495 # The value must be between -999,999,999 and +999,999,999 inclusive.
496 # If `units` is positive, `nanos` must be positive or zero.
497 # If `units` is zero, `nanos` can be positive, zero, or negative.
498 # If `units` is negative, `nanos` must be negative or zero.
499 # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
500 &quot;units&quot;: &quot;A String&quot;, # The whole units of the amount.
501 # For example if `currencyCode` is `&quot;USD&quot;`, then 1 unit is one US dollar.
502 },
503 &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product. (default: CPM)
504 },
505 &quot;advertiserIds&quot;: [ # The list of advertisers for this price when associated with this buyer.
506 # If empty, all advertisers with this buyer pay this price.
507 &quot;A String&quot;,
508 ],
509 &quot;buyer&quot;: { # Represents a buyer of inventory. Each buyer is identified by a unique # The buyer who will pay this price. If unset, all buyers can pay this price
510 # (if the
511 # advertisers match, and there&#x27;s no more specific rule matching the buyer).
512 # Authorized Buyers account ID.
513 &quot;accountId&quot;: &quot;A String&quot;, # Authorized Buyers account ID of the buyer.
514 },
515 },
516 ],
517 },
518 },
519 &quot;targeting&quot;: { # Targeting represents different criteria that can be used by advertisers to # Output only. Specifies the subset of inventory targeted by the deal.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700520 # target ad inventory. For example, they can choose to target ad requests only
521 # if the user is in the US.
522 # Multiple types of targeting are always applied as a logical AND, unless noted
523 # otherwise.
Bu Sun Kim65020912020-05-20 12:08:20 -0700524 &quot;geoTargeting&quot;: { # Generic targeting used for targeting dimensions that contains a list of # Geo criteria IDs to be included/excluded.
525 # included and excluded numeric IDs.
526 &quot;targetedCriteriaIds&quot;: [ # A list of numeric IDs to be included.
527 &quot;A String&quot;,
528 ],
529 &quot;excludedCriteriaIds&quot;: [ # A list of numeric IDs to be excluded.
530 &quot;A String&quot;,
531 ],
532 },
533 &quot;inventorySizeTargeting&quot;: { # Represents the size of an ad unit that can be targeted on an ad # Inventory sizes to be included/excluded.
534 # request. It only applies to Private Auction, AdX Preferred Deals and
535 # Auction Packages. This targeting does not apply to Programmatic Guaranteed
536 # and Preferred Deals in Ad Manager.
537 &quot;targetedInventorySizes&quot;: [ # A list of inventory sizes to be included.
538 { # Represents size of a single ad slot, or a creative.
539 &quot;width&quot;: &quot;A String&quot;, # The width of the ad slot in pixels.
540 # This field will be present only when size type is `PIXEL`.
541 &quot;sizeType&quot;: &quot;A String&quot;, # The size type of the ad slot.
542 &quot;height&quot;: &quot;A String&quot;, # The height of the ad slot in pixels.
543 # This field will be present only when size type is `PIXEL`.
544 },
545 ],
546 &quot;excludedInventorySizes&quot;: [ # A list of inventory sizes to be excluded.
547 { # Represents size of a single ad slot, or a creative.
548 &quot;width&quot;: &quot;A String&quot;, # The width of the ad slot in pixels.
549 # This field will be present only when size type is `PIXEL`.
550 &quot;sizeType&quot;: &quot;A String&quot;, # The size type of the ad slot.
551 &quot;height&quot;: &quot;A String&quot;, # The height of the ad slot in pixels.
552 # This field will be present only when size type is `PIXEL`.
553 },
554 ],
555 },
556 &quot;videoTargeting&quot;: { # Represents targeting information about video. # Video targeting information.
557 &quot;targetedPositionTypes&quot;: [ # A list of video positions to be included.
558 # When the included list is present, the excluded list must be empty.
559 # When the excluded list is present, the included list must be empty.
560 &quot;A String&quot;,
561 ],
562 &quot;excludedPositionTypes&quot;: [ # A list of video positions to be excluded.
563 # Position types can either be included or excluded (XOR).
564 &quot;A String&quot;,
565 ],
566 },
567 &quot;technologyTargeting&quot;: { # Represents targeting about various types of technology. # Technology targeting information, e.g., operating system, device category.
568 &quot;deviceCapabilityTargeting&quot;: { # Generic targeting used for targeting dimensions that contains a list of # IDs of device capabilities to be included/excluded.
569 # included and excluded numeric IDs.
570 &quot;targetedCriteriaIds&quot;: [ # A list of numeric IDs to be included.
571 &quot;A String&quot;,
Dan O'Mearadd494642020-05-01 07:42:23 -0700572 ],
Bu Sun Kim65020912020-05-20 12:08:20 -0700573 &quot;excludedCriteriaIds&quot;: [ # A list of numeric IDs to be excluded.
574 &quot;A String&quot;,
Dan O'Mearadd494642020-05-01 07:42:23 -0700575 ],
576 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700577 &quot;operatingSystemTargeting&quot;: { # Represents targeting information for operating systems. # Operating system related targeting information.
578 &quot;operatingSystemCriteria&quot;: { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating systems to be included/excluded.
579 # included and excluded numeric IDs.
580 &quot;targetedCriteriaIds&quot;: [ # A list of numeric IDs to be included.
581 &quot;A String&quot;,
582 ],
583 &quot;excludedCriteriaIds&quot;: [ # A list of numeric IDs to be excluded.
584 &quot;A String&quot;,
585 ],
586 },
587 &quot;operatingSystemVersionCriteria&quot;: { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating system versions to be included/excluded.
588 # included and excluded numeric IDs.
589 &quot;targetedCriteriaIds&quot;: [ # A list of numeric IDs to be included.
590 &quot;A String&quot;,
591 ],
592 &quot;excludedCriteriaIds&quot;: [ # A list of numeric IDs to be excluded.
593 &quot;A String&quot;,
594 ],
595 },
596 },
597 &quot;deviceCategoryTargeting&quot;: { # Generic targeting used for targeting dimensions that contains a list of # IDs of device categories to be included/excluded.
598 # included and excluded numeric IDs.
599 &quot;targetedCriteriaIds&quot;: [ # A list of numeric IDs to be included.
600 &quot;A String&quot;,
601 ],
602 &quot;excludedCriteriaIds&quot;: [ # A list of numeric IDs to be excluded.
603 &quot;A String&quot;,
604 ],
605 },
606 },
607 &quot;placementTargeting&quot;: { # Represents targeting about where the ads can appear, e.g., certain sites or # Placement targeting information, e.g., URL, mobile applications.
608 # mobile applications.
609 # Different placement targeting types will be logically OR&#x27;ed.
610 &quot;urlTargeting&quot;: { # Represents a list of targeted and excluded URLs (e.g., google.com). # URLs to be included/excluded.
611 # For Private Auction and AdX Preferred Deals, URLs are either included or
612 # excluded.
613 # For Programmatic Guaranteed and Preferred Deals, this doesn&#x27;t
614 # apply.
615 &quot;targetedUrls&quot;: [ # A list of URLs to be included.
616 &quot;A String&quot;,
617 ],
618 &quot;excludedUrls&quot;: [ # A list of URLs to be excluded.
619 &quot;A String&quot;,
620 ],
621 },
622 &quot;mobileApplicationTargeting&quot;: { # Mobile application targeting settings. # Mobile application targeting information in a deal.
623 # This doesn&#x27;t apply to Auction Packages.
624 &quot;firstPartyTargeting&quot;: { # Represents a list of targeted and excluded mobile application IDs that # Publisher owned apps to be targeted or excluded by the publisher to
Dan O'Mearadd494642020-05-01 07:42:23 -0700625 # display the ads in.
626 # publishers own.
627 # Mobile application IDs are from App Store and Google Play Store.
628 # Android App ID, for example, com.google.android.apps.maps, can be found in
629 # Google Play Store URL.
630 # iOS App ID (which is a number) can be found at the end of iTunes store URL.
631 # First party mobile applications is either included or excluded.
Bu Sun Kim65020912020-05-20 12:08:20 -0700632 &quot;targetedAppIds&quot;: [ # A list of application IDs to be included.
633 &quot;A String&quot;,
Dan O'Mearadd494642020-05-01 07:42:23 -0700634 ],
Bu Sun Kim65020912020-05-20 12:08:20 -0700635 &quot;excludedAppIds&quot;: [ # A list of application IDs to be excluded.
636 &quot;A String&quot;,
Dan O'Mearadd494642020-05-01 07:42:23 -0700637 ],
638 },
639 },
640 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700641 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700642 &quot;creativePreApprovalPolicy&quot;: &quot;A String&quot;, # Output only. Specifies the creative pre-approval policy.
643 &quot;deliveryControl&quot;: { # Message contains details about how the deals will be paced. # The set of fields around delivery control that are interesting for a buyer
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700644 # to see but are non-negotiable. These are set by the publisher.
Bu Sun Kim65020912020-05-20 12:08:20 -0700645 &quot;deliveryRateType&quot;: &quot;A String&quot;, # Output only. Specifies how the impression delivery will be paced.
646 &quot;frequencyCaps&quot;: [ # Output only. Specifies any frequency caps.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700647 { # Frequency cap.
Bu Sun Kim65020912020-05-20 12:08:20 -0700648 &quot;numTimeUnits&quot;: 42, # The amount of time, in the units specified by time_unit_type. Defines the
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700649 # amount of time over which impressions per user are counted and capped.
Bu Sun Kim65020912020-05-20 12:08:20 -0700650 &quot;maxImpressions&quot;: 42, # The maximum number of impressions that can be served to a user within the
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700651 # specified time period.
Bu Sun Kim65020912020-05-20 12:08:20 -0700652 &quot;timeUnitType&quot;: &quot;A String&quot;, # The time unit. Along with num_time_units defines the amount of time over
653 # which impressions per user are counted and capped.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700654 },
655 ],
Bu Sun Kim65020912020-05-20 12:08:20 -0700656 &quot;creativeBlockingLevel&quot;: &quot;A String&quot;, # Output only. Specified the creative blocking levels to be applied.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700657 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700658 &quot;externalDealId&quot;: &quot;A String&quot;, # Output only. The external deal ID assigned to this deal once the deal is
659 # finalized. This is the deal ID that shows up in serving/reporting etc.
660 &quot;creativeRestrictions&quot;: { # Represents creative restrictions associated to Programmatic Guaranteed/ # Output only. Restricitions about the creatives associated with the deal
Dan O'Mearadd494642020-05-01 07:42:23 -0700661 # (i.e., size) This is available for Programmatic Guaranteed/Preferred Deals
662 # in Ad Manager.
663 # Preferred Deal in Ad Manager.
Bu Sun Kim65020912020-05-20 12:08:20 -0700664 # This doesn&#x27;t apply to Private Auction and AdX Preferred Deals.
665 &quot;creativeFormat&quot;: &quot;A String&quot;, # The format of the environment that the creatives will be displayed in.
666 &quot;creativeSpecifications&quot;: [
Dan O'Mearadd494642020-05-01 07:42:23 -0700667 { # Represents information for a creative that is associated with a Programmatic
668 # Guaranteed/Preferred Deal in Ad Manager.
Bu Sun Kim65020912020-05-20 12:08:20 -0700669 &quot;creativeSize&quot;: { # Represents size of a single ad slot, or a creative. # The size of the creative.
670 &quot;width&quot;: &quot;A String&quot;, # The width of the ad slot in pixels.
Dan O'Mearadd494642020-05-01 07:42:23 -0700671 # This field will be present only when size type is `PIXEL`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700672 &quot;sizeType&quot;: &quot;A String&quot;, # The size type of the ad slot.
673 &quot;height&quot;: &quot;A String&quot;, # The height of the ad slot in pixels.
Dan O'Mearadd494642020-05-01 07:42:23 -0700674 # This field will be present only when size type is `PIXEL`.
675 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700676 &quot;creativeCompanionSizes&quot;: [ # Companion sizes may be filled in only when this is a video creative.
Dan O'Mearadd494642020-05-01 07:42:23 -0700677 { # Represents size of a single ad slot, or a creative.
Bu Sun Kim65020912020-05-20 12:08:20 -0700678 &quot;width&quot;: &quot;A String&quot;, # The width of the ad slot in pixels.
Dan O'Mearadd494642020-05-01 07:42:23 -0700679 # This field will be present only when size type is `PIXEL`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700680 &quot;sizeType&quot;: &quot;A String&quot;, # The size type of the ad slot.
681 &quot;height&quot;: &quot;A String&quot;, # The height of the ad slot in pixels.
Dan O'Mearadd494642020-05-01 07:42:23 -0700682 # This field will be present only when size type is `PIXEL`.
683 },
684 ],
685 },
686 ],
Bu Sun Kim65020912020-05-20 12:08:20 -0700687 &quot;skippableAdType&quot;: &quot;A String&quot;, # Skippable video ads allow viewers to skip ads after 5 seconds.
Dan O'Mearadd494642020-05-01 07:42:23 -0700688 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700689 &quot;dealServingMetadata&quot;: { # Message captures metadata about the serving status of a deal. # Output only. Metadata about the serving status of this deal.
690 &quot;dealPauseStatus&quot;: { # Tracks which parties (if any) have paused a deal. # Output only. Tracks which parties (if any) have paused a deal.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700691 # The deal is considered paused if either hasBuyerPaused or
692 # hasSellPaused is true.
Bu Sun Kim65020912020-05-20 12:08:20 -0700693 &quot;firstPausedBy&quot;: &quot;A String&quot;, # The role of the person who first paused this deal.
694 &quot;sellerPauseReason&quot;: &quot;A String&quot;, # The seller&#x27;s reason for pausing, if the seller paused the deal.
695 &quot;hasSellerPaused&quot;: True or False, # True, if the seller has paused the deal unilaterally.
696 &quot;buyerPauseReason&quot;: &quot;A String&quot;, # The buyer&#x27;s reason for pausing, if the buyer paused the deal.
697 &quot;hasBuyerPaused&quot;: True or False, # True, if the buyer has paused the deal unilaterally.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700698 },
699 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700700 &quot;description&quot;: &quot;A String&quot;, # Description for the deal terms.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700701 },
702 ],
Bu Sun Kim65020912020-05-20 12:08:20 -0700703 &quot;proposalRevision&quot;: &quot;A String&quot;, # Output only. The revision number for the proposal.
Dan O'Mearadd494642020-05-01 07:42:23 -0700704 # Each update to the proposal or the deal causes the proposal revision number
705 # to auto-increment. The buyer keeps track of the last revision number they
706 # know of and pass it in when making an update. If the head revision number
707 # on the server has since incremented, then an ABORTED error is returned
708 # during the update operation to let the buyer know that a subsequent update
709 # was made.
Bu Sun Kim65020912020-05-20 12:08:20 -0700710 &quot;seller&quot;: { # Represents a seller of inventory. Each seller is identified by a unique # Reference to the seller on the proposal.
Dan O'Mearadd494642020-05-01 07:42:23 -0700711 #
712 # Note: This field may be set only when creating the resource. Modifying
713 # this field while updating the resource will result in an error.
714 # Ad Manager account ID.
Bu Sun Kim65020912020-05-20 12:08:20 -0700715 &quot;subAccountId&quot;: &quot;A String&quot;, # Optional sub-account ID for the seller.
716 &quot;accountId&quot;: &quot;A String&quot;, # The unique ID for the seller. The seller fills in this field.
Dan O'Mearadd494642020-05-01 07:42:23 -0700717 # The seller account ID is then available to buyer in the product.
718 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700719 },
720 ],
721 }</pre>
722</div>
723
724<div class="method">
725 <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
726 <pre>Retrieves the next page of results.
727
728Args:
729 previous_request: The request for the previous page. (required)
730 previous_response: The response from the request for the previous page. (required)
731
732Returns:
Bu Sun Kim65020912020-05-20 12:08:20 -0700733 A request object that you can call &#x27;execute()&#x27; on to request the next
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700734 page. Returns None if there are no more items in the collection.
735 </pre>
736</div>
737
738</body></html>