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