1<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="authorizedbuyersmarketplace_v1.html">Authorized Buyers Marketplace API</a> . <a href="authorizedbuyersmarketplace_v1.buyers.html">buyers</a> . <a href="authorizedbuyersmarketplace_v1.buyers.proposals.html">proposals</a> . <a href="authorizedbuyersmarketplace_v1.buyers.proposals.deals.html">deals</a></h1> 76<h2>Instance Methods</h2> 77<p class="toc_element"> 78 <code><a href="#batchUpdate">batchUpdate(parent, body=None, x__xgafv=None)</a></code></p> 79<p class="firstline">Batch updates multiple deals in the same proposal.</p> 80<p class="toc_element"> 81 <code><a href="#close">close()</a></code></p> 82<p class="firstline">Close httplib2 connections.</p> 83<p class="toc_element"> 84 <code><a href="#get">get(name, x__xgafv=None)</a></code></p> 85<p class="firstline">Gets a deal given its name. The deal is returned at its head revision.</p> 86<p class="toc_element"> 87 <code><a href="#list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p> 88<p class="firstline">Lists all deals in a proposal. To retrieve only the finalized revision deals regardless if a deal is being renegotiated, see the FinalizedDeals resource.</p> 89<p class="toc_element"> 90 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p> 91<p class="firstline">Retrieves the next page of results.</p> 92<p class="toc_element"> 93 <code><a href="#patch">patch(name, body=None, updateMask=None, x__xgafv=None)</a></code></p> 94<p class="firstline">Updates the given deal at the buyer known revision number. If the server revision has advanced since the passed-in proposal.proposal_revision an ABORTED error message will be returned. The revision number is incremented by the server whenever the proposal or its constituent deals are updated. Note: The revision number is kept at a proposal level. The buyer of the API is expected to keep track of the revision number after the last update operation and send it in as part of the next update request. This way, if there are further changes on the server (e.g., seller making new updates), then the server can detect conflicts and reject the proposed changes.</p> 95<h3>Method Details</h3> 96<div class="method"> 97 <code class="details" id="batchUpdate">batchUpdate(parent, body=None, x__xgafv=None)</code> 98 <pre>Batch updates multiple deals in the same proposal. 99 100Args: 101 parent: string, Required. The name of the proposal containing the deals to batch update. Format: buyers/{accountId}/proposals/{proposalId} (required) 102 body: object, The request body. 103 The object takes the form of: 104 105{ # Request message for batch updating deals. 106 "requests": [ # Required. List of request messages to update deals. 107 { # Request message for updating the deal at the given revision number. 108 "deal": { # A deal represents a segment of inventory for displaying ads that contains the terms and targeting information that is used for serving as well as the deal stats and status. Note: A proposal may contain multiple deals. # Required. The deal to update. The deal's `name` field is used to identify the deal to be updated. Note: proposal_revision will have to be provided within the resource or else an error will be thrown. Format: buyers/{accountId}/proposals/{proposalId}/deals/{dealId} 109 "billedBuyer": "A String", # Output only. When the client field is populated, this field refers to the buyer who creates and manages the client buyer and gets billed on behalf of the client buyer; when the buyer field is populated, this field is the same value as buyer. Format : `buyers/{buyerAccountId}` 110 "buyer": "A String", # Output only. Refers to a buyer in The Realtime-bidding API. Format: `buyers/{buyerAccountId}` 111 "client": "A String", # Output only. Refers to a Client. Format: `buyers/{buyerAccountId}/clients/{clientAccountid}` 112 "createTime": "A String", # Output only. The time of the deal creation. 113 "creativeRequirements": { # Message captures data about the creatives in the deal. # Output only. Metadata about the creatives of this deal. 114 "creativePreApprovalPolicy": "A String", # Output only. Specifies the creative pre-approval policy. 115 "creativeSafeFrameCompatibility": "A String", # Output only. Specifies whether the creative is safeFrame compatible. 116 "programmaticCreativeSource": "A String", # Output only. Specifies the creative source for programmatic deals. PUBLISHER means creative is provided by seller and ADVERTISER means creative is provided by the buyer. 117 }, 118 "dealType": "A String", # Output only. Type of deal. 119 "deliveryControl": { # Message contains details about how the deal will be paced. # Output only. Specifies the pacing set by the publisher. 120 "companionDeliveryType": "A String", # Output only. Specifies roadblocking in a master companion lineitem. 121 "creativeRotationType": "A String", # Output only. Specifies strategy to use for selecting a creative when multiple creatives of the same size are available. 122 "deliveryRateType": "A String", # Output only. Specifies how the impression delivery will be paced. 123 "frequencyCap": [ # Output only. Specifies any frequency caps. Cannot be filtered within ListDealsRequest. 124 { # Message contains details about publisher-set frequency caps of the delivery. 125 "maxImpressions": 42, # The maximum number of impressions that can be served to a user within the specified time period. 126 "timeUnitType": "A String", # The time unit. Along with num_time_units defines the amount of time over which impressions per user are counted and capped. 127 "timeUnitsCount": 42, # The amount of time, in the units specified by time_unit_type. Defines the amount of time over which impressions per user are counted and capped. 128 }, 129 ], 130 "roadblockingType": "A String", # Output only. Specifies the roadblocking type in display creatives. 131 }, 132 "description": "A String", # Output only. Free text description for the deal terms. 133 "displayName": "A String", # Output only. The name of the deal. Maximum length of 255 unicode characters is allowed. Control characters are not allowed. Buyers cannot update this field. Note: Not to be confused with name, which is a unique identifier of the deal. 134 "estimatedGrossSpend": { # Represents an amount of money with its currency type. # Specified by buyers in request for proposal (RFP) to notify publisher the total estimated spend for the proposal. Publishers will receive this information and send back proposed deals accordingly. 135 "currencyCode": "A String", # The three-letter currency code defined in ISO 4217. 136 "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000. 137 "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar. 138 }, 139 "flightEndTime": "A String", # Proposed flight end time of the deal. This will generally be stored in a granularity of a second. A value is not necessary for Private Auction deals. 140 "flightStartTime": "A String", # Proposed flight start time of the deal. This will generally be stored in the granularity of one second since deal serving starts at seconds boundary. Any time specified with more granularity (e.g., in milliseconds) will be truncated towards the start of time in seconds. 141 "name": "A String", # Immutable. The unique identifier of the deal. Auto-generated by the server when a deal is created. Format: buyers/{accountId}/proposals/{proposalId}/deals/{dealId} 142 "preferredDealTerms": { # Pricing terms for Preferred Deals. # The terms for preferred deals. 143 "fixedPrice": { # Represents a price and a pricing type for a deal. # Fixed price for the deal. 144 "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified. 145 "currencyCode": "A String", # The three-letter currency code defined in ISO 4217. 146 "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000. 147 "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar. 148 }, 149 "type": "A String", # The pricing type for the deal. 150 }, 151 }, 152 "privateAuctionTerms": { # Pricing terms for Private Auctions. # The terms for private auction deals. 153 "floorPrice": { # Represents a price and a pricing type for a deal. # The minimum price buyer has to bid to compete in the private auction. 154 "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified. 155 "currencyCode": "A String", # The three-letter currency code defined in ISO 4217. 156 "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000. 157 "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar. 158 }, 159 "type": "A String", # The pricing type for the deal. 160 }, 161 "openAuctionAllowed": True or False, # Output only. True if open auction buyers are allowed to compete with invited buyers in this private auction. 162 }, 163 "programmaticGuaranteedTerms": { # Pricing terms for Programmatic Guaranteed Deals. # The terms for programmatic guaranteed deals. 164 "fixedPrice": { # Represents a price and a pricing type for a deal. # Fixed price for the deal. 165 "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified. 166 "currencyCode": "A String", # The three-letter currency code defined in ISO 4217. 167 "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000. 168 "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar. 169 }, 170 "type": "A String", # The pricing type for the deal. 171 }, 172 "guaranteedLooks": "A String", # Count of guaranteed looks. 173 "impressionCap": "A String", # The lifetime impression cap for CPM Sponsorship deals. Deal will stop serving when cap is reached. 174 "minimumDailyLooks": "A String", # Daily minimum looks for CPD deal types. 175 "percentShareOfVoice": "A String", # For sponsorship deals, this is the percentage of the seller's eligible impressions that the deal will serve until the cap is reached. Valid value is within range 0~100. 176 "reservationType": "A String", # The reservation type for a Programmatic Guaranteed deal. This indicates whether the number of impressions is fixed, or a percent of available impressions. If not specified, the default reservation type is STANDARD. 177 }, 178 "proposalRevision": "A String", # Output only. The revision number for the proposal and is the same value as proposal.proposal_revision. Each update to deal causes the proposal revision number to auto-increment. The buyer keeps track of the last revision number they know of and pass it in when making an update. If the head revision number on the server has since incremented, then an ABORTED error is returned during the update operation to let the buyer know that a subsequent update was made. 179 "publisherProfile": "A String", # Immutable. Reference to the seller on the deal. Format: `buyers/{buyerAccountId}/publisherProfiles/{publisherProfileId}` 180 "sellerTimeZone": { # Represents a time zone from the [IANA Time Zone Database](https://www.iana.org/time-zones). # Output only. Time zone of the seller used to mark the boundaries of a day for daypart targeting and CPD billing. 181 "id": "A String", # IANA Time Zone Database time zone, e.g. "America/New_York". 182 "version": "A String", # Optional. IANA Time Zone Database version number, e.g. "2019a". 183 }, 184 "targeting": { # Targeting represents different criteria that can be used to target inventory. For example, they can choose to target inventory only if the user is in the US. Multiple types of targeting are always applied as a logical AND, unless noted otherwise. # Specifies the subset of inventory targeted by the deal. Can be updated by the buyer before the deal is finalized. 185 "daypartTargeting": { # Represents Daypart targeting. # Daypart targeting information. 186 "dayParts": [ # The targeted weekdays and times 187 { # Defines targeting for a period of time on a specific week day. 188 "dayOfWeek": "A String", # Day of week for the period. 189 "endTime": { # Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. # Hours in 24 hour time between 0 and 24, inclusive. Note: 24 is logically equivalent to 0, but is supported since in some cases there may need to be differentiation made between midnight on one day and midnight on the next day. Accepted values for minutes are [0, 15, 30, 45]. 0 is the only acceptable minute value for hour 24. Seconds and nanos are ignored. 190 "hours": 42, # Hours of day in 24 hour format. Should be from 0 to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time. 191 "minutes": 42, # Minutes of hour of day. Must be from 0 to 59. 192 "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999. 193 "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds. 194 }, 195 "startTime": { # Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. # Hours in 24 hour time between 0 and 24, inclusive. Note: 24 is logically equivalent to 0, but is supported since in some cases there may need to be differentiation made between midnight on one day and midnight on the next day. Accepted values for minutes are [0, 15, 30, 45]. 0 is the only acceptable minute value for hour 24. Seconds and nanos are ignored. 196 "hours": 42, # Hours of day in 24 hour format. Should be from 0 to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time. 197 "minutes": 42, # Minutes of hour of day. Must be from 0 to 59. 198 "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999. 199 "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds. 200 }, 201 }, 202 ], 203 "timeZoneType": "A String", # The time zone type of the day parts 204 }, 205 "geoTargeting": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # Output only. Geo criteria IDs to be included/excluded. 206 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 207 "A String", 208 ], 209 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 210 "A String", 211 ], 212 }, 213 "inventorySizeTargeting": { # Represents the size of an ad unit that can be targeted on a bid request. # Output only. Inventory sizes to be included/excluded. 214 "excludedInventorySizes": [ # A list of inventory sizes to be excluded. 215 { # Represents size of a single ad slot, or a creative. 216 "height": "A String", # The height of the ad slot in pixels. This field will be present only when size type is `PIXEL`. 217 "type": "A String", # The type of the ad slot size. 218 "width": "A String", # The width of the ad slot in pixels. This field will be present only when size type is `PIXEL`. 219 }, 220 ], 221 "targetedInventorySizes": [ # A list of inventory sizes to be included. 222 { # Represents size of a single ad slot, or a creative. 223 "height": "A String", # The height of the ad slot in pixels. This field will be present only when size type is `PIXEL`. 224 "type": "A String", # The type of the ad slot size. 225 "width": "A String", # The width of the ad slot in pixels. This field will be present only when size type is `PIXEL`. 226 }, 227 ], 228 }, 229 "placementTargeting": { # Represents targeting about where the ads can appear, e.g., certain sites or mobile applications. Different placement targeting types will be logically OR'ed. # Output only. Placement targeting information, e.g., URL, mobile applications. 230 "mobileApplicationTargeting": { # Mobile application targeting settings. # Mobile application targeting information in a deal. This doesn't apply to Auction Packages. 231 "firstPartyTargeting": { # Represents a list of targeted and excluded mobile application IDs that publishers own. Android App ID, for example, com.google.android.apps.maps, can be found in Google Play Store URL. iOS App ID (which is a number) can be found at the end of iTunes store URL. First party mobile applications is either included or excluded. # Publisher owned apps to be targeted or excluded by the publisher to display the ads in. 232 "excludedAppIds": [ # A list of application IDs to be excluded. 233 "A String", 234 ], 235 "targetedAppIds": [ # A list of application IDs to be included. 236 "A String", 237 ], 238 }, 239 }, 240 "uriTargeting": { # Represents a list of targeted and excluded URLs (e.g., google.com). For Private Auction Deals, URLs are either included or excluded. For Programmatic Guaranteed and Preferred Deals, this doesn't apply. # URLs to be included/excluded. 241 "excludedUris": [ # A list of URLs to be excluded. 242 "A String", 243 ], 244 "targetedUris": [ # A list of URLs to be included. 245 "A String", 246 ], 247 }, 248 }, 249 "technologyTargeting": { # Represents targeting about various types of technology. # Output only. Technology targeting information, e.g., operating system, device category. 250 "deviceCapabilityTargeting": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # IDs of device capabilities to be included/excluded. 251 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 252 "A String", 253 ], 254 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 255 "A String", 256 ], 257 }, 258 "deviceCategoryTargeting": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # IDs of device categories to be included/excluded. 259 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 260 "A String", 261 ], 262 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 263 "A String", 264 ], 265 }, 266 "operatingSystemTargeting": { # Represents targeting information for operating systems. # Operating system related targeting information. 267 "operatingSystemCriteria": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # IDs of operating systems to be included/excluded. 268 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 269 "A String", 270 ], 271 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 272 "A String", 273 ], 274 }, 275 "operatingSystemVersionCriteria": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # IDs of operating system versions to be included/excluded. 276 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 277 "A String", 278 ], 279 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 280 "A String", 281 ], 282 }, 283 }, 284 }, 285 "userListTargeting": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # Buyer user list targeting information. User lists can be uploaded via https://developers.google.com/authorized-buyers/rtb/bulk-uploader. 286 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 287 "A String", 288 ], 289 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 290 "A String", 291 ], 292 }, 293 "videoTargeting": { # Represents targeting information about video. # Output only. Video targeting information. 294 "excludedPositionTypes": [ # A list of video positions to be excluded. When this field is populated, the targeted_position_types field must be empty. 295 "A String", 296 ], 297 "targetedPositionTypes": [ # A list of video positions to be included. When this field is populated, the excluded_position_types field must be empty. 298 "A String", 299 ], 300 }, 301 }, 302 "updateTime": "A String", # Output only. The time when the deal was last updated. 303 }, 304 "updateMask": "A String", # List of fields to be updated. If empty or unspecified, the service will update all fields populated in the update request excluding the output only fields and primitive fields with default value. Note that explicit field mask is required in order to reset a primitive field back to its default value, e.g. false for boolean fields, 0 for integer fields. A special field mask consisting of a single path "*" can be used to indicate full replacement(the equivalent of PUT method), updatable fields unset or unspecified in the input will be cleared or set to default value. Output only fields will be ignored regardless of the value of updateMask. 305 }, 306 ], 307} 308 309 x__xgafv: string, V1 error format. 310 Allowed values 311 1 - v1 error format 312 2 - v2 error format 313 314Returns: 315 An object of the form: 316 317 { # Response message for batch updating deals. 318 "deals": [ # Deals updated. 319 { # A deal represents a segment of inventory for displaying ads that contains the terms and targeting information that is used for serving as well as the deal stats and status. Note: A proposal may contain multiple deals. 320 "billedBuyer": "A String", # Output only. When the client field is populated, this field refers to the buyer who creates and manages the client buyer and gets billed on behalf of the client buyer; when the buyer field is populated, this field is the same value as buyer. Format : `buyers/{buyerAccountId}` 321 "buyer": "A String", # Output only. Refers to a buyer in The Realtime-bidding API. Format: `buyers/{buyerAccountId}` 322 "client": "A String", # Output only. Refers to a Client. Format: `buyers/{buyerAccountId}/clients/{clientAccountid}` 323 "createTime": "A String", # Output only. The time of the deal creation. 324 "creativeRequirements": { # Message captures data about the creatives in the deal. # Output only. Metadata about the creatives of this deal. 325 "creativePreApprovalPolicy": "A String", # Output only. Specifies the creative pre-approval policy. 326 "creativeSafeFrameCompatibility": "A String", # Output only. Specifies whether the creative is safeFrame compatible. 327 "programmaticCreativeSource": "A String", # Output only. Specifies the creative source for programmatic deals. PUBLISHER means creative is provided by seller and ADVERTISER means creative is provided by the buyer. 328 }, 329 "dealType": "A String", # Output only. Type of deal. 330 "deliveryControl": { # Message contains details about how the deal will be paced. # Output only. Specifies the pacing set by the publisher. 331 "companionDeliveryType": "A String", # Output only. Specifies roadblocking in a master companion lineitem. 332 "creativeRotationType": "A String", # Output only. Specifies strategy to use for selecting a creative when multiple creatives of the same size are available. 333 "deliveryRateType": "A String", # Output only. Specifies how the impression delivery will be paced. 334 "frequencyCap": [ # Output only. Specifies any frequency caps. Cannot be filtered within ListDealsRequest. 335 { # Message contains details about publisher-set frequency caps of the delivery. 336 "maxImpressions": 42, # The maximum number of impressions that can be served to a user within the specified time period. 337 "timeUnitType": "A String", # The time unit. Along with num_time_units defines the amount of time over which impressions per user are counted and capped. 338 "timeUnitsCount": 42, # The amount of time, in the units specified by time_unit_type. Defines the amount of time over which impressions per user are counted and capped. 339 }, 340 ], 341 "roadblockingType": "A String", # Output only. Specifies the roadblocking type in display creatives. 342 }, 343 "description": "A String", # Output only. Free text description for the deal terms. 344 "displayName": "A String", # Output only. The name of the deal. Maximum length of 255 unicode characters is allowed. Control characters are not allowed. Buyers cannot update this field. Note: Not to be confused with name, which is a unique identifier of the deal. 345 "estimatedGrossSpend": { # Represents an amount of money with its currency type. # Specified by buyers in request for proposal (RFP) to notify publisher the total estimated spend for the proposal. Publishers will receive this information and send back proposed deals accordingly. 346 "currencyCode": "A String", # The three-letter currency code defined in ISO 4217. 347 "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000. 348 "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar. 349 }, 350 "flightEndTime": "A String", # Proposed flight end time of the deal. This will generally be stored in a granularity of a second. A value is not necessary for Private Auction deals. 351 "flightStartTime": "A String", # Proposed flight start time of the deal. This will generally be stored in the granularity of one second since deal serving starts at seconds boundary. Any time specified with more granularity (e.g., in milliseconds) will be truncated towards the start of time in seconds. 352 "name": "A String", # Immutable. The unique identifier of the deal. Auto-generated by the server when a deal is created. Format: buyers/{accountId}/proposals/{proposalId}/deals/{dealId} 353 "preferredDealTerms": { # Pricing terms for Preferred Deals. # The terms for preferred deals. 354 "fixedPrice": { # Represents a price and a pricing type for a deal. # Fixed price for the deal. 355 "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified. 356 "currencyCode": "A String", # The three-letter currency code defined in ISO 4217. 357 "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000. 358 "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar. 359 }, 360 "type": "A String", # The pricing type for the deal. 361 }, 362 }, 363 "privateAuctionTerms": { # Pricing terms for Private Auctions. # The terms for private auction deals. 364 "floorPrice": { # Represents a price and a pricing type for a deal. # The minimum price buyer has to bid to compete in the private auction. 365 "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified. 366 "currencyCode": "A String", # The three-letter currency code defined in ISO 4217. 367 "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000. 368 "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar. 369 }, 370 "type": "A String", # The pricing type for the deal. 371 }, 372 "openAuctionAllowed": True or False, # Output only. True if open auction buyers are allowed to compete with invited buyers in this private auction. 373 }, 374 "programmaticGuaranteedTerms": { # Pricing terms for Programmatic Guaranteed Deals. # The terms for programmatic guaranteed deals. 375 "fixedPrice": { # Represents a price and a pricing type for a deal. # Fixed price for the deal. 376 "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified. 377 "currencyCode": "A String", # The three-letter currency code defined in ISO 4217. 378 "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000. 379 "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar. 380 }, 381 "type": "A String", # The pricing type for the deal. 382 }, 383 "guaranteedLooks": "A String", # Count of guaranteed looks. 384 "impressionCap": "A String", # The lifetime impression cap for CPM Sponsorship deals. Deal will stop serving when cap is reached. 385 "minimumDailyLooks": "A String", # Daily minimum looks for CPD deal types. 386 "percentShareOfVoice": "A String", # For sponsorship deals, this is the percentage of the seller's eligible impressions that the deal will serve until the cap is reached. Valid value is within range 0~100. 387 "reservationType": "A String", # The reservation type for a Programmatic Guaranteed deal. This indicates whether the number of impressions is fixed, or a percent of available impressions. If not specified, the default reservation type is STANDARD. 388 }, 389 "proposalRevision": "A String", # Output only. The revision number for the proposal and is the same value as proposal.proposal_revision. Each update to deal causes the proposal revision number to auto-increment. The buyer keeps track of the last revision number they know of and pass it in when making an update. If the head revision number on the server has since incremented, then an ABORTED error is returned during the update operation to let the buyer know that a subsequent update was made. 390 "publisherProfile": "A String", # Immutable. Reference to the seller on the deal. Format: `buyers/{buyerAccountId}/publisherProfiles/{publisherProfileId}` 391 "sellerTimeZone": { # Represents a time zone from the [IANA Time Zone Database](https://www.iana.org/time-zones). # Output only. Time zone of the seller used to mark the boundaries of a day for daypart targeting and CPD billing. 392 "id": "A String", # IANA Time Zone Database time zone, e.g. "America/New_York". 393 "version": "A String", # Optional. IANA Time Zone Database version number, e.g. "2019a". 394 }, 395 "targeting": { # Targeting represents different criteria that can be used to target inventory. For example, they can choose to target inventory only if the user is in the US. Multiple types of targeting are always applied as a logical AND, unless noted otherwise. # Specifies the subset of inventory targeted by the deal. Can be updated by the buyer before the deal is finalized. 396 "daypartTargeting": { # Represents Daypart targeting. # Daypart targeting information. 397 "dayParts": [ # The targeted weekdays and times 398 { # Defines targeting for a period of time on a specific week day. 399 "dayOfWeek": "A String", # Day of week for the period. 400 "endTime": { # Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. # Hours in 24 hour time between 0 and 24, inclusive. Note: 24 is logically equivalent to 0, but is supported since in some cases there may need to be differentiation made between midnight on one day and midnight on the next day. Accepted values for minutes are [0, 15, 30, 45]. 0 is the only acceptable minute value for hour 24. Seconds and nanos are ignored. 401 "hours": 42, # Hours of day in 24 hour format. Should be from 0 to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time. 402 "minutes": 42, # Minutes of hour of day. Must be from 0 to 59. 403 "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999. 404 "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds. 405 }, 406 "startTime": { # Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. # Hours in 24 hour time between 0 and 24, inclusive. Note: 24 is logically equivalent to 0, but is supported since in some cases there may need to be differentiation made between midnight on one day and midnight on the next day. Accepted values for minutes are [0, 15, 30, 45]. 0 is the only acceptable minute value for hour 24. Seconds and nanos are ignored. 407 "hours": 42, # Hours of day in 24 hour format. Should be from 0 to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time. 408 "minutes": 42, # Minutes of hour of day. Must be from 0 to 59. 409 "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999. 410 "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds. 411 }, 412 }, 413 ], 414 "timeZoneType": "A String", # The time zone type of the day parts 415 }, 416 "geoTargeting": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # Output only. Geo criteria IDs to be included/excluded. 417 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 418 "A String", 419 ], 420 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 421 "A String", 422 ], 423 }, 424 "inventorySizeTargeting": { # Represents the size of an ad unit that can be targeted on a bid request. # Output only. Inventory sizes to be included/excluded. 425 "excludedInventorySizes": [ # A list of inventory sizes to be excluded. 426 { # Represents size of a single ad slot, or a creative. 427 "height": "A String", # The height of the ad slot in pixels. This field will be present only when size type is `PIXEL`. 428 "type": "A String", # The type of the ad slot size. 429 "width": "A String", # The width of the ad slot in pixels. This field will be present only when size type is `PIXEL`. 430 }, 431 ], 432 "targetedInventorySizes": [ # A list of inventory sizes to be included. 433 { # Represents size of a single ad slot, or a creative. 434 "height": "A String", # The height of the ad slot in pixels. This field will be present only when size type is `PIXEL`. 435 "type": "A String", # The type of the ad slot size. 436 "width": "A String", # The width of the ad slot in pixels. This field will be present only when size type is `PIXEL`. 437 }, 438 ], 439 }, 440 "placementTargeting": { # Represents targeting about where the ads can appear, e.g., certain sites or mobile applications. Different placement targeting types will be logically OR'ed. # Output only. Placement targeting information, e.g., URL, mobile applications. 441 "mobileApplicationTargeting": { # Mobile application targeting settings. # Mobile application targeting information in a deal. This doesn't apply to Auction Packages. 442 "firstPartyTargeting": { # Represents a list of targeted and excluded mobile application IDs that publishers own. Android App ID, for example, com.google.android.apps.maps, can be found in Google Play Store URL. iOS App ID (which is a number) can be found at the end of iTunes store URL. First party mobile applications is either included or excluded. # Publisher owned apps to be targeted or excluded by the publisher to display the ads in. 443 "excludedAppIds": [ # A list of application IDs to be excluded. 444 "A String", 445 ], 446 "targetedAppIds": [ # A list of application IDs to be included. 447 "A String", 448 ], 449 }, 450 }, 451 "uriTargeting": { # Represents a list of targeted and excluded URLs (e.g., google.com). For Private Auction Deals, URLs are either included or excluded. For Programmatic Guaranteed and Preferred Deals, this doesn't apply. # URLs to be included/excluded. 452 "excludedUris": [ # A list of URLs to be excluded. 453 "A String", 454 ], 455 "targetedUris": [ # A list of URLs to be included. 456 "A String", 457 ], 458 }, 459 }, 460 "technologyTargeting": { # Represents targeting about various types of technology. # Output only. Technology targeting information, e.g., operating system, device category. 461 "deviceCapabilityTargeting": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # IDs of device capabilities to be included/excluded. 462 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 463 "A String", 464 ], 465 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 466 "A String", 467 ], 468 }, 469 "deviceCategoryTargeting": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # IDs of device categories to be included/excluded. 470 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 471 "A String", 472 ], 473 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 474 "A String", 475 ], 476 }, 477 "operatingSystemTargeting": { # Represents targeting information for operating systems. # Operating system related targeting information. 478 "operatingSystemCriteria": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # IDs of operating systems to be included/excluded. 479 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 480 "A String", 481 ], 482 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 483 "A String", 484 ], 485 }, 486 "operatingSystemVersionCriteria": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # IDs of operating system versions to be included/excluded. 487 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 488 "A String", 489 ], 490 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 491 "A String", 492 ], 493 }, 494 }, 495 }, 496 "userListTargeting": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # Buyer user list targeting information. User lists can be uploaded via https://developers.google.com/authorized-buyers/rtb/bulk-uploader. 497 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 498 "A String", 499 ], 500 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 501 "A String", 502 ], 503 }, 504 "videoTargeting": { # Represents targeting information about video. # Output only. Video targeting information. 505 "excludedPositionTypes": [ # A list of video positions to be excluded. When this field is populated, the targeted_position_types field must be empty. 506 "A String", 507 ], 508 "targetedPositionTypes": [ # A list of video positions to be included. When this field is populated, the excluded_position_types field must be empty. 509 "A String", 510 ], 511 }, 512 }, 513 "updateTime": "A String", # Output only. The time when the deal was last updated. 514 }, 515 ], 516}</pre> 517</div> 518 519<div class="method"> 520 <code class="details" id="close">close()</code> 521 <pre>Close httplib2 connections.</pre> 522</div> 523 524<div class="method"> 525 <code class="details" id="get">get(name, x__xgafv=None)</code> 526 <pre>Gets a deal given its name. The deal is returned at its head revision. 527 528Args: 529 name: string, Required. Format: buyers/{accountId}/proposals/{proposalId}/deals/{dealId} (required) 530 x__xgafv: string, V1 error format. 531 Allowed values 532 1 - v1 error format 533 2 - v2 error format 534 535Returns: 536 An object of the form: 537 538 { # A deal represents a segment of inventory for displaying ads that contains the terms and targeting information that is used for serving as well as the deal stats and status. Note: A proposal may contain multiple deals. 539 "billedBuyer": "A String", # Output only. When the client field is populated, this field refers to the buyer who creates and manages the client buyer and gets billed on behalf of the client buyer; when the buyer field is populated, this field is the same value as buyer. Format : `buyers/{buyerAccountId}` 540 "buyer": "A String", # Output only. Refers to a buyer in The Realtime-bidding API. Format: `buyers/{buyerAccountId}` 541 "client": "A String", # Output only. Refers to a Client. Format: `buyers/{buyerAccountId}/clients/{clientAccountid}` 542 "createTime": "A String", # Output only. The time of the deal creation. 543 "creativeRequirements": { # Message captures data about the creatives in the deal. # Output only. Metadata about the creatives of this deal. 544 "creativePreApprovalPolicy": "A String", # Output only. Specifies the creative pre-approval policy. 545 "creativeSafeFrameCompatibility": "A String", # Output only. Specifies whether the creative is safeFrame compatible. 546 "programmaticCreativeSource": "A String", # Output only. Specifies the creative source for programmatic deals. PUBLISHER means creative is provided by seller and ADVERTISER means creative is provided by the buyer. 547 }, 548 "dealType": "A String", # Output only. Type of deal. 549 "deliveryControl": { # Message contains details about how the deal will be paced. # Output only. Specifies the pacing set by the publisher. 550 "companionDeliveryType": "A String", # Output only. Specifies roadblocking in a master companion lineitem. 551 "creativeRotationType": "A String", # Output only. Specifies strategy to use for selecting a creative when multiple creatives of the same size are available. 552 "deliveryRateType": "A String", # Output only. Specifies how the impression delivery will be paced. 553 "frequencyCap": [ # Output only. Specifies any frequency caps. Cannot be filtered within ListDealsRequest. 554 { # Message contains details about publisher-set frequency caps of the delivery. 555 "maxImpressions": 42, # The maximum number of impressions that can be served to a user within the specified time period. 556 "timeUnitType": "A String", # The time unit. Along with num_time_units defines the amount of time over which impressions per user are counted and capped. 557 "timeUnitsCount": 42, # The amount of time, in the units specified by time_unit_type. Defines the amount of time over which impressions per user are counted and capped. 558 }, 559 ], 560 "roadblockingType": "A String", # Output only. Specifies the roadblocking type in display creatives. 561 }, 562 "description": "A String", # Output only. Free text description for the deal terms. 563 "displayName": "A String", # Output only. The name of the deal. Maximum length of 255 unicode characters is allowed. Control characters are not allowed. Buyers cannot update this field. Note: Not to be confused with name, which is a unique identifier of the deal. 564 "estimatedGrossSpend": { # Represents an amount of money with its currency type. # Specified by buyers in request for proposal (RFP) to notify publisher the total estimated spend for the proposal. Publishers will receive this information and send back proposed deals accordingly. 565 "currencyCode": "A String", # The three-letter currency code defined in ISO 4217. 566 "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000. 567 "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar. 568 }, 569 "flightEndTime": "A String", # Proposed flight end time of the deal. This will generally be stored in a granularity of a second. A value is not necessary for Private Auction deals. 570 "flightStartTime": "A String", # Proposed flight start time of the deal. This will generally be stored in the granularity of one second since deal serving starts at seconds boundary. Any time specified with more granularity (e.g., in milliseconds) will be truncated towards the start of time in seconds. 571 "name": "A String", # Immutable. The unique identifier of the deal. Auto-generated by the server when a deal is created. Format: buyers/{accountId}/proposals/{proposalId}/deals/{dealId} 572 "preferredDealTerms": { # Pricing terms for Preferred Deals. # The terms for preferred deals. 573 "fixedPrice": { # Represents a price and a pricing type for a deal. # Fixed price for the deal. 574 "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified. 575 "currencyCode": "A String", # The three-letter currency code defined in ISO 4217. 576 "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000. 577 "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar. 578 }, 579 "type": "A String", # The pricing type for the deal. 580 }, 581 }, 582 "privateAuctionTerms": { # Pricing terms for Private Auctions. # The terms for private auction deals. 583 "floorPrice": { # Represents a price and a pricing type for a deal. # The minimum price buyer has to bid to compete in the private auction. 584 "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified. 585 "currencyCode": "A String", # The three-letter currency code defined in ISO 4217. 586 "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000. 587 "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar. 588 }, 589 "type": "A String", # The pricing type for the deal. 590 }, 591 "openAuctionAllowed": True or False, # Output only. True if open auction buyers are allowed to compete with invited buyers in this private auction. 592 }, 593 "programmaticGuaranteedTerms": { # Pricing terms for Programmatic Guaranteed Deals. # The terms for programmatic guaranteed deals. 594 "fixedPrice": { # Represents a price and a pricing type for a deal. # Fixed price for the deal. 595 "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified. 596 "currencyCode": "A String", # The three-letter currency code defined in ISO 4217. 597 "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000. 598 "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar. 599 }, 600 "type": "A String", # The pricing type for the deal. 601 }, 602 "guaranteedLooks": "A String", # Count of guaranteed looks. 603 "impressionCap": "A String", # The lifetime impression cap for CPM Sponsorship deals. Deal will stop serving when cap is reached. 604 "minimumDailyLooks": "A String", # Daily minimum looks for CPD deal types. 605 "percentShareOfVoice": "A String", # For sponsorship deals, this is the percentage of the seller's eligible impressions that the deal will serve until the cap is reached. Valid value is within range 0~100. 606 "reservationType": "A String", # The reservation type for a Programmatic Guaranteed deal. This indicates whether the number of impressions is fixed, or a percent of available impressions. If not specified, the default reservation type is STANDARD. 607 }, 608 "proposalRevision": "A String", # Output only. The revision number for the proposal and is the same value as proposal.proposal_revision. Each update to deal causes the proposal revision number to auto-increment. The buyer keeps track of the last revision number they know of and pass it in when making an update. If the head revision number on the server has since incremented, then an ABORTED error is returned during the update operation to let the buyer know that a subsequent update was made. 609 "publisherProfile": "A String", # Immutable. Reference to the seller on the deal. Format: `buyers/{buyerAccountId}/publisherProfiles/{publisherProfileId}` 610 "sellerTimeZone": { # Represents a time zone from the [IANA Time Zone Database](https://www.iana.org/time-zones). # Output only. Time zone of the seller used to mark the boundaries of a day for daypart targeting and CPD billing. 611 "id": "A String", # IANA Time Zone Database time zone, e.g. "America/New_York". 612 "version": "A String", # Optional. IANA Time Zone Database version number, e.g. "2019a". 613 }, 614 "targeting": { # Targeting represents different criteria that can be used to target inventory. For example, they can choose to target inventory only if the user is in the US. Multiple types of targeting are always applied as a logical AND, unless noted otherwise. # Specifies the subset of inventory targeted by the deal. Can be updated by the buyer before the deal is finalized. 615 "daypartTargeting": { # Represents Daypart targeting. # Daypart targeting information. 616 "dayParts": [ # The targeted weekdays and times 617 { # Defines targeting for a period of time on a specific week day. 618 "dayOfWeek": "A String", # Day of week for the period. 619 "endTime": { # Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. # Hours in 24 hour time between 0 and 24, inclusive. Note: 24 is logically equivalent to 0, but is supported since in some cases there may need to be differentiation made between midnight on one day and midnight on the next day. Accepted values for minutes are [0, 15, 30, 45]. 0 is the only acceptable minute value for hour 24. Seconds and nanos are ignored. 620 "hours": 42, # Hours of day in 24 hour format. Should be from 0 to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time. 621 "minutes": 42, # Minutes of hour of day. Must be from 0 to 59. 622 "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999. 623 "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds. 624 }, 625 "startTime": { # Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. # Hours in 24 hour time between 0 and 24, inclusive. Note: 24 is logically equivalent to 0, but is supported since in some cases there may need to be differentiation made between midnight on one day and midnight on the next day. Accepted values for minutes are [0, 15, 30, 45]. 0 is the only acceptable minute value for hour 24. Seconds and nanos are ignored. 626 "hours": 42, # Hours of day in 24 hour format. Should be from 0 to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time. 627 "minutes": 42, # Minutes of hour of day. Must be from 0 to 59. 628 "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999. 629 "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds. 630 }, 631 }, 632 ], 633 "timeZoneType": "A String", # The time zone type of the day parts 634 }, 635 "geoTargeting": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # Output only. Geo criteria IDs to be included/excluded. 636 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 637 "A String", 638 ], 639 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 640 "A String", 641 ], 642 }, 643 "inventorySizeTargeting": { # Represents the size of an ad unit that can be targeted on a bid request. # Output only. Inventory sizes to be included/excluded. 644 "excludedInventorySizes": [ # A list of inventory sizes to be excluded. 645 { # Represents size of a single ad slot, or a creative. 646 "height": "A String", # The height of the ad slot in pixels. This field will be present only when size type is `PIXEL`. 647 "type": "A String", # The type of the ad slot size. 648 "width": "A String", # The width of the ad slot in pixels. This field will be present only when size type is `PIXEL`. 649 }, 650 ], 651 "targetedInventorySizes": [ # A list of inventory sizes to be included. 652 { # Represents size of a single ad slot, or a creative. 653 "height": "A String", # The height of the ad slot in pixels. This field will be present only when size type is `PIXEL`. 654 "type": "A String", # The type of the ad slot size. 655 "width": "A String", # The width of the ad slot in pixels. This field will be present only when size type is `PIXEL`. 656 }, 657 ], 658 }, 659 "placementTargeting": { # Represents targeting about where the ads can appear, e.g., certain sites or mobile applications. Different placement targeting types will be logically OR'ed. # Output only. Placement targeting information, e.g., URL, mobile applications. 660 "mobileApplicationTargeting": { # Mobile application targeting settings. # Mobile application targeting information in a deal. This doesn't apply to Auction Packages. 661 "firstPartyTargeting": { # Represents a list of targeted and excluded mobile application IDs that publishers own. Android App ID, for example, com.google.android.apps.maps, can be found in Google Play Store URL. iOS App ID (which is a number) can be found at the end of iTunes store URL. First party mobile applications is either included or excluded. # Publisher owned apps to be targeted or excluded by the publisher to display the ads in. 662 "excludedAppIds": [ # A list of application IDs to be excluded. 663 "A String", 664 ], 665 "targetedAppIds": [ # A list of application IDs to be included. 666 "A String", 667 ], 668 }, 669 }, 670 "uriTargeting": { # Represents a list of targeted and excluded URLs (e.g., google.com). For Private Auction Deals, URLs are either included or excluded. For Programmatic Guaranteed and Preferred Deals, this doesn't apply. # URLs to be included/excluded. 671 "excludedUris": [ # A list of URLs to be excluded. 672 "A String", 673 ], 674 "targetedUris": [ # A list of URLs to be included. 675 "A String", 676 ], 677 }, 678 }, 679 "technologyTargeting": { # Represents targeting about various types of technology. # Output only. Technology targeting information, e.g., operating system, device category. 680 "deviceCapabilityTargeting": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # IDs of device capabilities to be included/excluded. 681 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 682 "A String", 683 ], 684 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 685 "A String", 686 ], 687 }, 688 "deviceCategoryTargeting": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # IDs of device categories to be included/excluded. 689 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 690 "A String", 691 ], 692 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 693 "A String", 694 ], 695 }, 696 "operatingSystemTargeting": { # Represents targeting information for operating systems. # Operating system related targeting information. 697 "operatingSystemCriteria": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # IDs of operating systems to be included/excluded. 698 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 699 "A String", 700 ], 701 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 702 "A String", 703 ], 704 }, 705 "operatingSystemVersionCriteria": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # IDs of operating system versions to be included/excluded. 706 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 707 "A String", 708 ], 709 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 710 "A String", 711 ], 712 }, 713 }, 714 }, 715 "userListTargeting": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # Buyer user list targeting information. User lists can be uploaded via https://developers.google.com/authorized-buyers/rtb/bulk-uploader. 716 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 717 "A String", 718 ], 719 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 720 "A String", 721 ], 722 }, 723 "videoTargeting": { # Represents targeting information about video. # Output only. Video targeting information. 724 "excludedPositionTypes": [ # A list of video positions to be excluded. When this field is populated, the targeted_position_types field must be empty. 725 "A String", 726 ], 727 "targetedPositionTypes": [ # A list of video positions to be included. When this field is populated, the excluded_position_types field must be empty. 728 "A String", 729 ], 730 }, 731 }, 732 "updateTime": "A String", # Output only. The time when the deal was last updated. 733}</pre> 734</div> 735 736<div class="method"> 737 <code class="details" id="list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</code> 738 <pre>Lists all deals in a proposal. To retrieve only the finalized revision deals regardless if a deal is being renegotiated, see the FinalizedDeals resource. 739 740Args: 741 parent: string, Required. The name of the proposal containing the deals to retrieve. Format: buyers/{accountId}/proposals/{proposalId} (required) 742 pageSize: integer, Requested page size. The server may return fewer results than requested. If requested more than 500, the server will return 500 results per page. If unspecified, the server will pick a default page size of 100. 743 pageToken: string, The page token as returned from ListDealsResponse. 744 x__xgafv: string, V1 error format. 745 Allowed values 746 1 - v1 error format 747 2 - v2 error format 748 749Returns: 750 An object of the form: 751 752 { # Response message for listing deals in a proposal. 753 "deals": [ # The list of deals. 754 { # A deal represents a segment of inventory for displaying ads that contains the terms and targeting information that is used for serving as well as the deal stats and status. Note: A proposal may contain multiple deals. 755 "billedBuyer": "A String", # Output only. When the client field is populated, this field refers to the buyer who creates and manages the client buyer and gets billed on behalf of the client buyer; when the buyer field is populated, this field is the same value as buyer. Format : `buyers/{buyerAccountId}` 756 "buyer": "A String", # Output only. Refers to a buyer in The Realtime-bidding API. Format: `buyers/{buyerAccountId}` 757 "client": "A String", # Output only. Refers to a Client. Format: `buyers/{buyerAccountId}/clients/{clientAccountid}` 758 "createTime": "A String", # Output only. The time of the deal creation. 759 "creativeRequirements": { # Message captures data about the creatives in the deal. # Output only. Metadata about the creatives of this deal. 760 "creativePreApprovalPolicy": "A String", # Output only. Specifies the creative pre-approval policy. 761 "creativeSafeFrameCompatibility": "A String", # Output only. Specifies whether the creative is safeFrame compatible. 762 "programmaticCreativeSource": "A String", # Output only. Specifies the creative source for programmatic deals. PUBLISHER means creative is provided by seller and ADVERTISER means creative is provided by the buyer. 763 }, 764 "dealType": "A String", # Output only. Type of deal. 765 "deliveryControl": { # Message contains details about how the deal will be paced. # Output only. Specifies the pacing set by the publisher. 766 "companionDeliveryType": "A String", # Output only. Specifies roadblocking in a master companion lineitem. 767 "creativeRotationType": "A String", # Output only. Specifies strategy to use for selecting a creative when multiple creatives of the same size are available. 768 "deliveryRateType": "A String", # Output only. Specifies how the impression delivery will be paced. 769 "frequencyCap": [ # Output only. Specifies any frequency caps. Cannot be filtered within ListDealsRequest. 770 { # Message contains details about publisher-set frequency caps of the delivery. 771 "maxImpressions": 42, # The maximum number of impressions that can be served to a user within the specified time period. 772 "timeUnitType": "A String", # The time unit. Along with num_time_units defines the amount of time over which impressions per user are counted and capped. 773 "timeUnitsCount": 42, # The amount of time, in the units specified by time_unit_type. Defines the amount of time over which impressions per user are counted and capped. 774 }, 775 ], 776 "roadblockingType": "A String", # Output only. Specifies the roadblocking type in display creatives. 777 }, 778 "description": "A String", # Output only. Free text description for the deal terms. 779 "displayName": "A String", # Output only. The name of the deal. Maximum length of 255 unicode characters is allowed. Control characters are not allowed. Buyers cannot update this field. Note: Not to be confused with name, which is a unique identifier of the deal. 780 "estimatedGrossSpend": { # Represents an amount of money with its currency type. # Specified by buyers in request for proposal (RFP) to notify publisher the total estimated spend for the proposal. Publishers will receive this information and send back proposed deals accordingly. 781 "currencyCode": "A String", # The three-letter currency code defined in ISO 4217. 782 "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000. 783 "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar. 784 }, 785 "flightEndTime": "A String", # Proposed flight end time of the deal. This will generally be stored in a granularity of a second. A value is not necessary for Private Auction deals. 786 "flightStartTime": "A String", # Proposed flight start time of the deal. This will generally be stored in the granularity of one second since deal serving starts at seconds boundary. Any time specified with more granularity (e.g., in milliseconds) will be truncated towards the start of time in seconds. 787 "name": "A String", # Immutable. The unique identifier of the deal. Auto-generated by the server when a deal is created. Format: buyers/{accountId}/proposals/{proposalId}/deals/{dealId} 788 "preferredDealTerms": { # Pricing terms for Preferred Deals. # The terms for preferred deals. 789 "fixedPrice": { # Represents a price and a pricing type for a deal. # Fixed price for the deal. 790 "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified. 791 "currencyCode": "A String", # The three-letter currency code defined in ISO 4217. 792 "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000. 793 "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar. 794 }, 795 "type": "A String", # The pricing type for the deal. 796 }, 797 }, 798 "privateAuctionTerms": { # Pricing terms for Private Auctions. # The terms for private auction deals. 799 "floorPrice": { # Represents a price and a pricing type for a deal. # The minimum price buyer has to bid to compete in the private auction. 800 "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified. 801 "currencyCode": "A String", # The three-letter currency code defined in ISO 4217. 802 "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000. 803 "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar. 804 }, 805 "type": "A String", # The pricing type for the deal. 806 }, 807 "openAuctionAllowed": True or False, # Output only. True if open auction buyers are allowed to compete with invited buyers in this private auction. 808 }, 809 "programmaticGuaranteedTerms": { # Pricing terms for Programmatic Guaranteed Deals. # The terms for programmatic guaranteed deals. 810 "fixedPrice": { # Represents a price and a pricing type for a deal. # Fixed price for the deal. 811 "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified. 812 "currencyCode": "A String", # The three-letter currency code defined in ISO 4217. 813 "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000. 814 "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar. 815 }, 816 "type": "A String", # The pricing type for the deal. 817 }, 818 "guaranteedLooks": "A String", # Count of guaranteed looks. 819 "impressionCap": "A String", # The lifetime impression cap for CPM Sponsorship deals. Deal will stop serving when cap is reached. 820 "minimumDailyLooks": "A String", # Daily minimum looks for CPD deal types. 821 "percentShareOfVoice": "A String", # For sponsorship deals, this is the percentage of the seller's eligible impressions that the deal will serve until the cap is reached. Valid value is within range 0~100. 822 "reservationType": "A String", # The reservation type for a Programmatic Guaranteed deal. This indicates whether the number of impressions is fixed, or a percent of available impressions. If not specified, the default reservation type is STANDARD. 823 }, 824 "proposalRevision": "A String", # Output only. The revision number for the proposal and is the same value as proposal.proposal_revision. Each update to deal causes the proposal revision number to auto-increment. The buyer keeps track of the last revision number they know of and pass it in when making an update. If the head revision number on the server has since incremented, then an ABORTED error is returned during the update operation to let the buyer know that a subsequent update was made. 825 "publisherProfile": "A String", # Immutable. Reference to the seller on the deal. Format: `buyers/{buyerAccountId}/publisherProfiles/{publisherProfileId}` 826 "sellerTimeZone": { # Represents a time zone from the [IANA Time Zone Database](https://www.iana.org/time-zones). # Output only. Time zone of the seller used to mark the boundaries of a day for daypart targeting and CPD billing. 827 "id": "A String", # IANA Time Zone Database time zone, e.g. "America/New_York". 828 "version": "A String", # Optional. IANA Time Zone Database version number, e.g. "2019a". 829 }, 830 "targeting": { # Targeting represents different criteria that can be used to target inventory. For example, they can choose to target inventory only if the user is in the US. Multiple types of targeting are always applied as a logical AND, unless noted otherwise. # Specifies the subset of inventory targeted by the deal. Can be updated by the buyer before the deal is finalized. 831 "daypartTargeting": { # Represents Daypart targeting. # Daypart targeting information. 832 "dayParts": [ # The targeted weekdays and times 833 { # Defines targeting for a period of time on a specific week day. 834 "dayOfWeek": "A String", # Day of week for the period. 835 "endTime": { # Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. # Hours in 24 hour time between 0 and 24, inclusive. Note: 24 is logically equivalent to 0, but is supported since in some cases there may need to be differentiation made between midnight on one day and midnight on the next day. Accepted values for minutes are [0, 15, 30, 45]. 0 is the only acceptable minute value for hour 24. Seconds and nanos are ignored. 836 "hours": 42, # Hours of day in 24 hour format. Should be from 0 to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time. 837 "minutes": 42, # Minutes of hour of day. Must be from 0 to 59. 838 "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999. 839 "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds. 840 }, 841 "startTime": { # Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. # Hours in 24 hour time between 0 and 24, inclusive. Note: 24 is logically equivalent to 0, but is supported since in some cases there may need to be differentiation made between midnight on one day and midnight on the next day. Accepted values for minutes are [0, 15, 30, 45]. 0 is the only acceptable minute value for hour 24. Seconds and nanos are ignored. 842 "hours": 42, # Hours of day in 24 hour format. Should be from 0 to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time. 843 "minutes": 42, # Minutes of hour of day. Must be from 0 to 59. 844 "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999. 845 "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds. 846 }, 847 }, 848 ], 849 "timeZoneType": "A String", # The time zone type of the day parts 850 }, 851 "geoTargeting": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # Output only. Geo criteria IDs to be included/excluded. 852 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 853 "A String", 854 ], 855 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 856 "A String", 857 ], 858 }, 859 "inventorySizeTargeting": { # Represents the size of an ad unit that can be targeted on a bid request. # Output only. Inventory sizes to be included/excluded. 860 "excludedInventorySizes": [ # A list of inventory sizes to be excluded. 861 { # Represents size of a single ad slot, or a creative. 862 "height": "A String", # The height of the ad slot in pixels. This field will be present only when size type is `PIXEL`. 863 "type": "A String", # The type of the ad slot size. 864 "width": "A String", # The width of the ad slot in pixels. This field will be present only when size type is `PIXEL`. 865 }, 866 ], 867 "targetedInventorySizes": [ # A list of inventory sizes to be included. 868 { # Represents size of a single ad slot, or a creative. 869 "height": "A String", # The height of the ad slot in pixels. This field will be present only when size type is `PIXEL`. 870 "type": "A String", # The type of the ad slot size. 871 "width": "A String", # The width of the ad slot in pixels. This field will be present only when size type is `PIXEL`. 872 }, 873 ], 874 }, 875 "placementTargeting": { # Represents targeting about where the ads can appear, e.g., certain sites or mobile applications. Different placement targeting types will be logically OR'ed. # Output only. Placement targeting information, e.g., URL, mobile applications. 876 "mobileApplicationTargeting": { # Mobile application targeting settings. # Mobile application targeting information in a deal. This doesn't apply to Auction Packages. 877 "firstPartyTargeting": { # Represents a list of targeted and excluded mobile application IDs that publishers own. Android App ID, for example, com.google.android.apps.maps, can be found in Google Play Store URL. iOS App ID (which is a number) can be found at the end of iTunes store URL. First party mobile applications is either included or excluded. # Publisher owned apps to be targeted or excluded by the publisher to display the ads in. 878 "excludedAppIds": [ # A list of application IDs to be excluded. 879 "A String", 880 ], 881 "targetedAppIds": [ # A list of application IDs to be included. 882 "A String", 883 ], 884 }, 885 }, 886 "uriTargeting": { # Represents a list of targeted and excluded URLs (e.g., google.com). For Private Auction Deals, URLs are either included or excluded. For Programmatic Guaranteed and Preferred Deals, this doesn't apply. # URLs to be included/excluded. 887 "excludedUris": [ # A list of URLs to be excluded. 888 "A String", 889 ], 890 "targetedUris": [ # A list of URLs to be included. 891 "A String", 892 ], 893 }, 894 }, 895 "technologyTargeting": { # Represents targeting about various types of technology. # Output only. Technology targeting information, e.g., operating system, device category. 896 "deviceCapabilityTargeting": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # IDs of device capabilities to be included/excluded. 897 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 898 "A String", 899 ], 900 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 901 "A String", 902 ], 903 }, 904 "deviceCategoryTargeting": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # IDs of device categories to be included/excluded. 905 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 906 "A String", 907 ], 908 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 909 "A String", 910 ], 911 }, 912 "operatingSystemTargeting": { # Represents targeting information for operating systems. # Operating system related targeting information. 913 "operatingSystemCriteria": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # IDs of operating systems to be included/excluded. 914 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 915 "A String", 916 ], 917 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 918 "A String", 919 ], 920 }, 921 "operatingSystemVersionCriteria": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # IDs of operating system versions to be included/excluded. 922 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 923 "A String", 924 ], 925 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 926 "A String", 927 ], 928 }, 929 }, 930 }, 931 "userListTargeting": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # Buyer user list targeting information. User lists can be uploaded via https://developers.google.com/authorized-buyers/rtb/bulk-uploader. 932 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 933 "A String", 934 ], 935 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 936 "A String", 937 ], 938 }, 939 "videoTargeting": { # Represents targeting information about video. # Output only. Video targeting information. 940 "excludedPositionTypes": [ # A list of video positions to be excluded. When this field is populated, the targeted_position_types field must be empty. 941 "A String", 942 ], 943 "targetedPositionTypes": [ # A list of video positions to be included. When this field is populated, the excluded_position_types field must be empty. 944 "A String", 945 ], 946 }, 947 }, 948 "updateTime": "A String", # Output only. The time when the deal was last updated. 949 }, 950 ], 951 "nextPageToken": "A String", # Token to fetch the next page of results. 952}</pre> 953</div> 954 955<div class="method"> 956 <code class="details" id="list_next">list_next(previous_request, previous_response)</code> 957 <pre>Retrieves the next page of results. 958 959Args: 960 previous_request: The request for the previous page. (required) 961 previous_response: The response from the request for the previous page. (required) 962 963Returns: 964 A request object that you can call 'execute()' on to request the next 965 page. Returns None if there are no more items in the collection. 966 </pre> 967</div> 968 969<div class="method"> 970 <code class="details" id="patch">patch(name, body=None, updateMask=None, x__xgafv=None)</code> 971 <pre>Updates the given deal at the buyer known revision number. If the server revision has advanced since the passed-in proposal.proposal_revision an ABORTED error message will be returned. The revision number is incremented by the server whenever the proposal or its constituent deals are updated. Note: The revision number is kept at a proposal level. The buyer of the API is expected to keep track of the revision number after the last update operation and send it in as part of the next update request. This way, if there are further changes on the server (e.g., seller making new updates), then the server can detect conflicts and reject the proposed changes. 972 973Args: 974 name: string, Immutable. The unique identifier of the deal. Auto-generated by the server when a deal is created. Format: buyers/{accountId}/proposals/{proposalId}/deals/{dealId} (required) 975 body: object, The request body. 976 The object takes the form of: 977 978{ # A deal represents a segment of inventory for displaying ads that contains the terms and targeting information that is used for serving as well as the deal stats and status. Note: A proposal may contain multiple deals. 979 "billedBuyer": "A String", # Output only. When the client field is populated, this field refers to the buyer who creates and manages the client buyer and gets billed on behalf of the client buyer; when the buyer field is populated, this field is the same value as buyer. Format : `buyers/{buyerAccountId}` 980 "buyer": "A String", # Output only. Refers to a buyer in The Realtime-bidding API. Format: `buyers/{buyerAccountId}` 981 "client": "A String", # Output only. Refers to a Client. Format: `buyers/{buyerAccountId}/clients/{clientAccountid}` 982 "createTime": "A String", # Output only. The time of the deal creation. 983 "creativeRequirements": { # Message captures data about the creatives in the deal. # Output only. Metadata about the creatives of this deal. 984 "creativePreApprovalPolicy": "A String", # Output only. Specifies the creative pre-approval policy. 985 "creativeSafeFrameCompatibility": "A String", # Output only. Specifies whether the creative is safeFrame compatible. 986 "programmaticCreativeSource": "A String", # Output only. Specifies the creative source for programmatic deals. PUBLISHER means creative is provided by seller and ADVERTISER means creative is provided by the buyer. 987 }, 988 "dealType": "A String", # Output only. Type of deal. 989 "deliveryControl": { # Message contains details about how the deal will be paced. # Output only. Specifies the pacing set by the publisher. 990 "companionDeliveryType": "A String", # Output only. Specifies roadblocking in a master companion lineitem. 991 "creativeRotationType": "A String", # Output only. Specifies strategy to use for selecting a creative when multiple creatives of the same size are available. 992 "deliveryRateType": "A String", # Output only. Specifies how the impression delivery will be paced. 993 "frequencyCap": [ # Output only. Specifies any frequency caps. Cannot be filtered within ListDealsRequest. 994 { # Message contains details about publisher-set frequency caps of the delivery. 995 "maxImpressions": 42, # The maximum number of impressions that can be served to a user within the specified time period. 996 "timeUnitType": "A String", # The time unit. Along with num_time_units defines the amount of time over which impressions per user are counted and capped. 997 "timeUnitsCount": 42, # The amount of time, in the units specified by time_unit_type. Defines the amount of time over which impressions per user are counted and capped. 998 }, 999 ], 1000 "roadblockingType": "A String", # Output only. Specifies the roadblocking type in display creatives. 1001 }, 1002 "description": "A String", # Output only. Free text description for the deal terms. 1003 "displayName": "A String", # Output only. The name of the deal. Maximum length of 255 unicode characters is allowed. Control characters are not allowed. Buyers cannot update this field. Note: Not to be confused with name, which is a unique identifier of the deal. 1004 "estimatedGrossSpend": { # Represents an amount of money with its currency type. # Specified by buyers in request for proposal (RFP) to notify publisher the total estimated spend for the proposal. Publishers will receive this information and send back proposed deals accordingly. 1005 "currencyCode": "A String", # The three-letter currency code defined in ISO 4217. 1006 "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000. 1007 "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar. 1008 }, 1009 "flightEndTime": "A String", # Proposed flight end time of the deal. This will generally be stored in a granularity of a second. A value is not necessary for Private Auction deals. 1010 "flightStartTime": "A String", # Proposed flight start time of the deal. This will generally be stored in the granularity of one second since deal serving starts at seconds boundary. Any time specified with more granularity (e.g., in milliseconds) will be truncated towards the start of time in seconds. 1011 "name": "A String", # Immutable. The unique identifier of the deal. Auto-generated by the server when a deal is created. Format: buyers/{accountId}/proposals/{proposalId}/deals/{dealId} 1012 "preferredDealTerms": { # Pricing terms for Preferred Deals. # The terms for preferred deals. 1013 "fixedPrice": { # Represents a price and a pricing type for a deal. # Fixed price for the deal. 1014 "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified. 1015 "currencyCode": "A String", # The three-letter currency code defined in ISO 4217. 1016 "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000. 1017 "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar. 1018 }, 1019 "type": "A String", # The pricing type for the deal. 1020 }, 1021 }, 1022 "privateAuctionTerms": { # Pricing terms for Private Auctions. # The terms for private auction deals. 1023 "floorPrice": { # Represents a price and a pricing type for a deal. # The minimum price buyer has to bid to compete in the private auction. 1024 "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified. 1025 "currencyCode": "A String", # The three-letter currency code defined in ISO 4217. 1026 "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000. 1027 "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar. 1028 }, 1029 "type": "A String", # The pricing type for the deal. 1030 }, 1031 "openAuctionAllowed": True or False, # Output only. True if open auction buyers are allowed to compete with invited buyers in this private auction. 1032 }, 1033 "programmaticGuaranteedTerms": { # Pricing terms for Programmatic Guaranteed Deals. # The terms for programmatic guaranteed deals. 1034 "fixedPrice": { # Represents a price and a pricing type for a deal. # Fixed price for the deal. 1035 "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified. 1036 "currencyCode": "A String", # The three-letter currency code defined in ISO 4217. 1037 "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000. 1038 "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar. 1039 }, 1040 "type": "A String", # The pricing type for the deal. 1041 }, 1042 "guaranteedLooks": "A String", # Count of guaranteed looks. 1043 "impressionCap": "A String", # The lifetime impression cap for CPM Sponsorship deals. Deal will stop serving when cap is reached. 1044 "minimumDailyLooks": "A String", # Daily minimum looks for CPD deal types. 1045 "percentShareOfVoice": "A String", # For sponsorship deals, this is the percentage of the seller's eligible impressions that the deal will serve until the cap is reached. Valid value is within range 0~100. 1046 "reservationType": "A String", # The reservation type for a Programmatic Guaranteed deal. This indicates whether the number of impressions is fixed, or a percent of available impressions. If not specified, the default reservation type is STANDARD. 1047 }, 1048 "proposalRevision": "A String", # Output only. The revision number for the proposal and is the same value as proposal.proposal_revision. Each update to deal causes the proposal revision number to auto-increment. The buyer keeps track of the last revision number they know of and pass it in when making an update. If the head revision number on the server has since incremented, then an ABORTED error is returned during the update operation to let the buyer know that a subsequent update was made. 1049 "publisherProfile": "A String", # Immutable. Reference to the seller on the deal. Format: `buyers/{buyerAccountId}/publisherProfiles/{publisherProfileId}` 1050 "sellerTimeZone": { # Represents a time zone from the [IANA Time Zone Database](https://www.iana.org/time-zones). # Output only. Time zone of the seller used to mark the boundaries of a day for daypart targeting and CPD billing. 1051 "id": "A String", # IANA Time Zone Database time zone, e.g. "America/New_York". 1052 "version": "A String", # Optional. IANA Time Zone Database version number, e.g. "2019a". 1053 }, 1054 "targeting": { # Targeting represents different criteria that can be used to target inventory. For example, they can choose to target inventory only if the user is in the US. Multiple types of targeting are always applied as a logical AND, unless noted otherwise. # Specifies the subset of inventory targeted by the deal. Can be updated by the buyer before the deal is finalized. 1055 "daypartTargeting": { # Represents Daypart targeting. # Daypart targeting information. 1056 "dayParts": [ # The targeted weekdays and times 1057 { # Defines targeting for a period of time on a specific week day. 1058 "dayOfWeek": "A String", # Day of week for the period. 1059 "endTime": { # Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. # Hours in 24 hour time between 0 and 24, inclusive. Note: 24 is logically equivalent to 0, but is supported since in some cases there may need to be differentiation made between midnight on one day and midnight on the next day. Accepted values for minutes are [0, 15, 30, 45]. 0 is the only acceptable minute value for hour 24. Seconds and nanos are ignored. 1060 "hours": 42, # Hours of day in 24 hour format. Should be from 0 to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time. 1061 "minutes": 42, # Minutes of hour of day. Must be from 0 to 59. 1062 "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999. 1063 "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds. 1064 }, 1065 "startTime": { # Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. # Hours in 24 hour time between 0 and 24, inclusive. Note: 24 is logically equivalent to 0, but is supported since in some cases there may need to be differentiation made between midnight on one day and midnight on the next day. Accepted values for minutes are [0, 15, 30, 45]. 0 is the only acceptable minute value for hour 24. Seconds and nanos are ignored. 1066 "hours": 42, # Hours of day in 24 hour format. Should be from 0 to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time. 1067 "minutes": 42, # Minutes of hour of day. Must be from 0 to 59. 1068 "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999. 1069 "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds. 1070 }, 1071 }, 1072 ], 1073 "timeZoneType": "A String", # The time zone type of the day parts 1074 }, 1075 "geoTargeting": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # Output only. Geo criteria IDs to be included/excluded. 1076 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 1077 "A String", 1078 ], 1079 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 1080 "A String", 1081 ], 1082 }, 1083 "inventorySizeTargeting": { # Represents the size of an ad unit that can be targeted on a bid request. # Output only. Inventory sizes to be included/excluded. 1084 "excludedInventorySizes": [ # A list of inventory sizes to be excluded. 1085 { # Represents size of a single ad slot, or a creative. 1086 "height": "A String", # The height of the ad slot in pixels. This field will be present only when size type is `PIXEL`. 1087 "type": "A String", # The type of the ad slot size. 1088 "width": "A String", # The width of the ad slot in pixels. This field will be present only when size type is `PIXEL`. 1089 }, 1090 ], 1091 "targetedInventorySizes": [ # A list of inventory sizes to be included. 1092 { # Represents size of a single ad slot, or a creative. 1093 "height": "A String", # The height of the ad slot in pixels. This field will be present only when size type is `PIXEL`. 1094 "type": "A String", # The type of the ad slot size. 1095 "width": "A String", # The width of the ad slot in pixels. This field will be present only when size type is `PIXEL`. 1096 }, 1097 ], 1098 }, 1099 "placementTargeting": { # Represents targeting about where the ads can appear, e.g., certain sites or mobile applications. Different placement targeting types will be logically OR'ed. # Output only. Placement targeting information, e.g., URL, mobile applications. 1100 "mobileApplicationTargeting": { # Mobile application targeting settings. # Mobile application targeting information in a deal. This doesn't apply to Auction Packages. 1101 "firstPartyTargeting": { # Represents a list of targeted and excluded mobile application IDs that publishers own. Android App ID, for example, com.google.android.apps.maps, can be found in Google Play Store URL. iOS App ID (which is a number) can be found at the end of iTunes store URL. First party mobile applications is either included or excluded. # Publisher owned apps to be targeted or excluded by the publisher to display the ads in. 1102 "excludedAppIds": [ # A list of application IDs to be excluded. 1103 "A String", 1104 ], 1105 "targetedAppIds": [ # A list of application IDs to be included. 1106 "A String", 1107 ], 1108 }, 1109 }, 1110 "uriTargeting": { # Represents a list of targeted and excluded URLs (e.g., google.com). For Private Auction Deals, URLs are either included or excluded. For Programmatic Guaranteed and Preferred Deals, this doesn't apply. # URLs to be included/excluded. 1111 "excludedUris": [ # A list of URLs to be excluded. 1112 "A String", 1113 ], 1114 "targetedUris": [ # A list of URLs to be included. 1115 "A String", 1116 ], 1117 }, 1118 }, 1119 "technologyTargeting": { # Represents targeting about various types of technology. # Output only. Technology targeting information, e.g., operating system, device category. 1120 "deviceCapabilityTargeting": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # IDs of device capabilities to be included/excluded. 1121 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 1122 "A String", 1123 ], 1124 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 1125 "A String", 1126 ], 1127 }, 1128 "deviceCategoryTargeting": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # IDs of device categories to be included/excluded. 1129 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 1130 "A String", 1131 ], 1132 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 1133 "A String", 1134 ], 1135 }, 1136 "operatingSystemTargeting": { # Represents targeting information for operating systems. # Operating system related targeting information. 1137 "operatingSystemCriteria": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # IDs of operating systems to be included/excluded. 1138 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 1139 "A String", 1140 ], 1141 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 1142 "A String", 1143 ], 1144 }, 1145 "operatingSystemVersionCriteria": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # IDs of operating system versions to be included/excluded. 1146 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 1147 "A String", 1148 ], 1149 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 1150 "A String", 1151 ], 1152 }, 1153 }, 1154 }, 1155 "userListTargeting": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # Buyer user list targeting information. User lists can be uploaded via https://developers.google.com/authorized-buyers/rtb/bulk-uploader. 1156 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 1157 "A String", 1158 ], 1159 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 1160 "A String", 1161 ], 1162 }, 1163 "videoTargeting": { # Represents targeting information about video. # Output only. Video targeting information. 1164 "excludedPositionTypes": [ # A list of video positions to be excluded. When this field is populated, the targeted_position_types field must be empty. 1165 "A String", 1166 ], 1167 "targetedPositionTypes": [ # A list of video positions to be included. When this field is populated, the excluded_position_types field must be empty. 1168 "A String", 1169 ], 1170 }, 1171 }, 1172 "updateTime": "A String", # Output only. The time when the deal was last updated. 1173} 1174 1175 updateMask: string, List of fields to be updated. If empty or unspecified, the service will update all fields populated in the update request excluding the output only fields and primitive fields with default value. Note that explicit field mask is required in order to reset a primitive field back to its default value, e.g. false for boolean fields, 0 for integer fields. A special field mask consisting of a single path "*" can be used to indicate full replacement(the equivalent of PUT method), updatable fields unset or unspecified in the input will be cleared or set to default value. Output only fields will be ignored regardless of the value of updateMask. 1176 x__xgafv: string, V1 error format. 1177 Allowed values 1178 1 - v1 error format 1179 2 - v2 error format 1180 1181Returns: 1182 An object of the form: 1183 1184 { # A deal represents a segment of inventory for displaying ads that contains the terms and targeting information that is used for serving as well as the deal stats and status. Note: A proposal may contain multiple deals. 1185 "billedBuyer": "A String", # Output only. When the client field is populated, this field refers to the buyer who creates and manages the client buyer and gets billed on behalf of the client buyer; when the buyer field is populated, this field is the same value as buyer. Format : `buyers/{buyerAccountId}` 1186 "buyer": "A String", # Output only. Refers to a buyer in The Realtime-bidding API. Format: `buyers/{buyerAccountId}` 1187 "client": "A String", # Output only. Refers to a Client. Format: `buyers/{buyerAccountId}/clients/{clientAccountid}` 1188 "createTime": "A String", # Output only. The time of the deal creation. 1189 "creativeRequirements": { # Message captures data about the creatives in the deal. # Output only. Metadata about the creatives of this deal. 1190 "creativePreApprovalPolicy": "A String", # Output only. Specifies the creative pre-approval policy. 1191 "creativeSafeFrameCompatibility": "A String", # Output only. Specifies whether the creative is safeFrame compatible. 1192 "programmaticCreativeSource": "A String", # Output only. Specifies the creative source for programmatic deals. PUBLISHER means creative is provided by seller and ADVERTISER means creative is provided by the buyer. 1193 }, 1194 "dealType": "A String", # Output only. Type of deal. 1195 "deliveryControl": { # Message contains details about how the deal will be paced. # Output only. Specifies the pacing set by the publisher. 1196 "companionDeliveryType": "A String", # Output only. Specifies roadblocking in a master companion lineitem. 1197 "creativeRotationType": "A String", # Output only. Specifies strategy to use for selecting a creative when multiple creatives of the same size are available. 1198 "deliveryRateType": "A String", # Output only. Specifies how the impression delivery will be paced. 1199 "frequencyCap": [ # Output only. Specifies any frequency caps. Cannot be filtered within ListDealsRequest. 1200 { # Message contains details about publisher-set frequency caps of the delivery. 1201 "maxImpressions": 42, # The maximum number of impressions that can be served to a user within the specified time period. 1202 "timeUnitType": "A String", # The time unit. Along with num_time_units defines the amount of time over which impressions per user are counted and capped. 1203 "timeUnitsCount": 42, # The amount of time, in the units specified by time_unit_type. Defines the amount of time over which impressions per user are counted and capped. 1204 }, 1205 ], 1206 "roadblockingType": "A String", # Output only. Specifies the roadblocking type in display creatives. 1207 }, 1208 "description": "A String", # Output only. Free text description for the deal terms. 1209 "displayName": "A String", # Output only. The name of the deal. Maximum length of 255 unicode characters is allowed. Control characters are not allowed. Buyers cannot update this field. Note: Not to be confused with name, which is a unique identifier of the deal. 1210 "estimatedGrossSpend": { # Represents an amount of money with its currency type. # Specified by buyers in request for proposal (RFP) to notify publisher the total estimated spend for the proposal. Publishers will receive this information and send back proposed deals accordingly. 1211 "currencyCode": "A String", # The three-letter currency code defined in ISO 4217. 1212 "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000. 1213 "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar. 1214 }, 1215 "flightEndTime": "A String", # Proposed flight end time of the deal. This will generally be stored in a granularity of a second. A value is not necessary for Private Auction deals. 1216 "flightStartTime": "A String", # Proposed flight start time of the deal. This will generally be stored in the granularity of one second since deal serving starts at seconds boundary. Any time specified with more granularity (e.g., in milliseconds) will be truncated towards the start of time in seconds. 1217 "name": "A String", # Immutable. The unique identifier of the deal. Auto-generated by the server when a deal is created. Format: buyers/{accountId}/proposals/{proposalId}/deals/{dealId} 1218 "preferredDealTerms": { # Pricing terms for Preferred Deals. # The terms for preferred deals. 1219 "fixedPrice": { # Represents a price and a pricing type for a deal. # Fixed price for the deal. 1220 "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified. 1221 "currencyCode": "A String", # The three-letter currency code defined in ISO 4217. 1222 "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000. 1223 "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar. 1224 }, 1225 "type": "A String", # The pricing type for the deal. 1226 }, 1227 }, 1228 "privateAuctionTerms": { # Pricing terms for Private Auctions. # The terms for private auction deals. 1229 "floorPrice": { # Represents a price and a pricing type for a deal. # The minimum price buyer has to bid to compete in the private auction. 1230 "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified. 1231 "currencyCode": "A String", # The three-letter currency code defined in ISO 4217. 1232 "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000. 1233 "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar. 1234 }, 1235 "type": "A String", # The pricing type for the deal. 1236 }, 1237 "openAuctionAllowed": True or False, # Output only. True if open auction buyers are allowed to compete with invited buyers in this private auction. 1238 }, 1239 "programmaticGuaranteedTerms": { # Pricing terms for Programmatic Guaranteed Deals. # The terms for programmatic guaranteed deals. 1240 "fixedPrice": { # Represents a price and a pricing type for a deal. # Fixed price for the deal. 1241 "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified. 1242 "currencyCode": "A String", # The three-letter currency code defined in ISO 4217. 1243 "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000. 1244 "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar. 1245 }, 1246 "type": "A String", # The pricing type for the deal. 1247 }, 1248 "guaranteedLooks": "A String", # Count of guaranteed looks. 1249 "impressionCap": "A String", # The lifetime impression cap for CPM Sponsorship deals. Deal will stop serving when cap is reached. 1250 "minimumDailyLooks": "A String", # Daily minimum looks for CPD deal types. 1251 "percentShareOfVoice": "A String", # For sponsorship deals, this is the percentage of the seller's eligible impressions that the deal will serve until the cap is reached. Valid value is within range 0~100. 1252 "reservationType": "A String", # The reservation type for a Programmatic Guaranteed deal. This indicates whether the number of impressions is fixed, or a percent of available impressions. If not specified, the default reservation type is STANDARD. 1253 }, 1254 "proposalRevision": "A String", # Output only. The revision number for the proposal and is the same value as proposal.proposal_revision. Each update to deal causes the proposal revision number to auto-increment. The buyer keeps track of the last revision number they know of and pass it in when making an update. If the head revision number on the server has since incremented, then an ABORTED error is returned during the update operation to let the buyer know that a subsequent update was made. 1255 "publisherProfile": "A String", # Immutable. Reference to the seller on the deal. Format: `buyers/{buyerAccountId}/publisherProfiles/{publisherProfileId}` 1256 "sellerTimeZone": { # Represents a time zone from the [IANA Time Zone Database](https://www.iana.org/time-zones). # Output only. Time zone of the seller used to mark the boundaries of a day for daypart targeting and CPD billing. 1257 "id": "A String", # IANA Time Zone Database time zone, e.g. "America/New_York". 1258 "version": "A String", # Optional. IANA Time Zone Database version number, e.g. "2019a". 1259 }, 1260 "targeting": { # Targeting represents different criteria that can be used to target inventory. For example, they can choose to target inventory only if the user is in the US. Multiple types of targeting are always applied as a logical AND, unless noted otherwise. # Specifies the subset of inventory targeted by the deal. Can be updated by the buyer before the deal is finalized. 1261 "daypartTargeting": { # Represents Daypart targeting. # Daypart targeting information. 1262 "dayParts": [ # The targeted weekdays and times 1263 { # Defines targeting for a period of time on a specific week day. 1264 "dayOfWeek": "A String", # Day of week for the period. 1265 "endTime": { # Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. # Hours in 24 hour time between 0 and 24, inclusive. Note: 24 is logically equivalent to 0, but is supported since in some cases there may need to be differentiation made between midnight on one day and midnight on the next day. Accepted values for minutes are [0, 15, 30, 45]. 0 is the only acceptable minute value for hour 24. Seconds and nanos are ignored. 1266 "hours": 42, # Hours of day in 24 hour format. Should be from 0 to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time. 1267 "minutes": 42, # Minutes of hour of day. Must be from 0 to 59. 1268 "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999. 1269 "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds. 1270 }, 1271 "startTime": { # Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. # Hours in 24 hour time between 0 and 24, inclusive. Note: 24 is logically equivalent to 0, but is supported since in some cases there may need to be differentiation made between midnight on one day and midnight on the next day. Accepted values for minutes are [0, 15, 30, 45]. 0 is the only acceptable minute value for hour 24. Seconds and nanos are ignored. 1272 "hours": 42, # Hours of day in 24 hour format. Should be from 0 to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time. 1273 "minutes": 42, # Minutes of hour of day. Must be from 0 to 59. 1274 "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999. 1275 "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds. 1276 }, 1277 }, 1278 ], 1279 "timeZoneType": "A String", # The time zone type of the day parts 1280 }, 1281 "geoTargeting": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # Output only. Geo criteria IDs to be included/excluded. 1282 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 1283 "A String", 1284 ], 1285 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 1286 "A String", 1287 ], 1288 }, 1289 "inventorySizeTargeting": { # Represents the size of an ad unit that can be targeted on a bid request. # Output only. Inventory sizes to be included/excluded. 1290 "excludedInventorySizes": [ # A list of inventory sizes to be excluded. 1291 { # Represents size of a single ad slot, or a creative. 1292 "height": "A String", # The height of the ad slot in pixels. This field will be present only when size type is `PIXEL`. 1293 "type": "A String", # The type of the ad slot size. 1294 "width": "A String", # The width of the ad slot in pixels. This field will be present only when size type is `PIXEL`. 1295 }, 1296 ], 1297 "targetedInventorySizes": [ # A list of inventory sizes to be included. 1298 { # Represents size of a single ad slot, or a creative. 1299 "height": "A String", # The height of the ad slot in pixels. This field will be present only when size type is `PIXEL`. 1300 "type": "A String", # The type of the ad slot size. 1301 "width": "A String", # The width of the ad slot in pixels. This field will be present only when size type is `PIXEL`. 1302 }, 1303 ], 1304 }, 1305 "placementTargeting": { # Represents targeting about where the ads can appear, e.g., certain sites or mobile applications. Different placement targeting types will be logically OR'ed. # Output only. Placement targeting information, e.g., URL, mobile applications. 1306 "mobileApplicationTargeting": { # Mobile application targeting settings. # Mobile application targeting information in a deal. This doesn't apply to Auction Packages. 1307 "firstPartyTargeting": { # Represents a list of targeted and excluded mobile application IDs that publishers own. Android App ID, for example, com.google.android.apps.maps, can be found in Google Play Store URL. iOS App ID (which is a number) can be found at the end of iTunes store URL. First party mobile applications is either included or excluded. # Publisher owned apps to be targeted or excluded by the publisher to display the ads in. 1308 "excludedAppIds": [ # A list of application IDs to be excluded. 1309 "A String", 1310 ], 1311 "targetedAppIds": [ # A list of application IDs to be included. 1312 "A String", 1313 ], 1314 }, 1315 }, 1316 "uriTargeting": { # Represents a list of targeted and excluded URLs (e.g., google.com). For Private Auction Deals, URLs are either included or excluded. For Programmatic Guaranteed and Preferred Deals, this doesn't apply. # URLs to be included/excluded. 1317 "excludedUris": [ # A list of URLs to be excluded. 1318 "A String", 1319 ], 1320 "targetedUris": [ # A list of URLs to be included. 1321 "A String", 1322 ], 1323 }, 1324 }, 1325 "technologyTargeting": { # Represents targeting about various types of technology. # Output only. Technology targeting information, e.g., operating system, device category. 1326 "deviceCapabilityTargeting": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # IDs of device capabilities to be included/excluded. 1327 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 1328 "A String", 1329 ], 1330 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 1331 "A String", 1332 ], 1333 }, 1334 "deviceCategoryTargeting": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # IDs of device categories to be included/excluded. 1335 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 1336 "A String", 1337 ], 1338 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 1339 "A String", 1340 ], 1341 }, 1342 "operatingSystemTargeting": { # Represents targeting information for operating systems. # Operating system related targeting information. 1343 "operatingSystemCriteria": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # IDs of operating systems to be included/excluded. 1344 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 1345 "A String", 1346 ], 1347 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 1348 "A String", 1349 ], 1350 }, 1351 "operatingSystemVersionCriteria": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # IDs of operating system versions to be included/excluded. 1352 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 1353 "A String", 1354 ], 1355 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 1356 "A String", 1357 ], 1358 }, 1359 }, 1360 }, 1361 "userListTargeting": { # Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. This cannot be filtered using list filter syntax. # Buyer user list targeting information. User lists can be uploaded via https://developers.google.com/authorized-buyers/rtb/bulk-uploader. 1362 "excludedCriteriaIds": [ # A list of numeric IDs to be excluded. 1363 "A String", 1364 ], 1365 "targetedCriteriaIds": [ # A list of numeric IDs to be included. 1366 "A String", 1367 ], 1368 }, 1369 "videoTargeting": { # Represents targeting information about video. # Output only. Video targeting information. 1370 "excludedPositionTypes": [ # A list of video positions to be excluded. When this field is populated, the targeted_position_types field must be empty. 1371 "A String", 1372 ], 1373 "targetedPositionTypes": [ # A list of video positions to be included. When this field is populated, the excluded_position_types field must be empty. 1374 "A String", 1375 ], 1376 }, 1377 }, 1378 "updateTime": "A String", # Output only. The time when the deal was last updated. 1379}</pre> 1380</div> 1381 1382</body></html>