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="adexchangebuyer_v1_3.html">Ad Exchange Buyer API</a> . <a href="adexchangebuyer_v1_3.pretargetingConfig.html">pretargetingConfig</a></h1> 76<h2>Instance Methods</h2> 77<p class="toc_element"> 78 <code><a href="#close">close()</a></code></p> 79<p class="firstline">Close httplib2 connections.</p> 80<p class="toc_element"> 81 <code><a href="#delete">delete(accountId, configId)</a></code></p> 82<p class="firstline">Deletes an existing pretargeting config.</p> 83<p class="toc_element"> 84 <code><a href="#get">get(accountId, configId)</a></code></p> 85<p class="firstline">Gets a specific pretargeting configuration</p> 86<p class="toc_element"> 87 <code><a href="#insert">insert(accountId, body=None)</a></code></p> 88<p class="firstline">Inserts a new pretargeting configuration.</p> 89<p class="toc_element"> 90 <code><a href="#list">list(accountId)</a></code></p> 91<p class="firstline">Retrieves a list of the authenticated user's pretargeting configurations.</p> 92<p class="toc_element"> 93 <code><a href="#patch">patch(accountId, configId, body=None)</a></code></p> 94<p class="firstline">Updates an existing pretargeting config. This method supports patch semantics.</p> 95<p class="toc_element"> 96 <code><a href="#update">update(accountId, configId, body=None)</a></code></p> 97<p class="firstline">Updates an existing pretargeting config.</p> 98<h3>Method Details</h3> 99<div class="method"> 100 <code class="details" id="close">close()</code> 101 <pre>Close httplib2 connections.</pre> 102</div> 103 104<div class="method"> 105 <code class="details" id="delete">delete(accountId, configId)</code> 106 <pre>Deletes an existing pretargeting config. 107 108Args: 109 accountId: string, The account id to delete the pretargeting config for. (required) 110 configId: string, The specific id of the configuration to delete. (required) 111</pre> 112</div> 113 114<div class="method"> 115 <code class="details" id="get">get(accountId, configId)</code> 116 <pre>Gets a specific pretargeting configuration 117 118Args: 119 accountId: string, The account id to get the pretargeting config for. (required) 120 configId: string, The specific id of the configuration to retrieve. (required) 121 122Returns: 123 An object of the form: 124 125 { 126 "billingId": "A String", # The id for billing purposes, provided for reference. Leave this field blank for insert requests; the id will be generated automatically. 127 "configId": "A String", # The config id; generated automatically. Leave this field blank for insert requests. 128 "configName": "A String", # The name of the config. Must be unique. Required for all requests. 129 "creativeType": [ # List must contain exactly one of PRETARGETING_CREATIVE_TYPE_HTML or PRETARGETING_CREATIVE_TYPE_VIDEO. 130 "A String", 131 ], 132 "dimensions": [ # Requests which allow one of these (width, height) pairs will match. All pairs must be supported ad dimensions. 133 { 134 "height": "A String", # Height in pixels. 135 "width": "A String", # Width in pixels. 136 }, 137 ], 138 "excludedContentLabels": [ # Requests with any of these content labels will not match. Values are from content-labels.txt in the downloadable files section. 139 "A String", 140 ], 141 "excludedGeoCriteriaIds": [ # Requests containing any of these geo criteria ids will not match. 142 "A String", 143 ], 144 "excludedPlacements": [ # Requests containing any of these placements will not match. 145 { 146 "token": "A String", # The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement. 147 "type": "A String", # The type of the placement. 148 }, 149 ], 150 "excludedUserLists": [ # Requests containing any of these users list ids will not match. 151 "A String", 152 ], 153 "excludedVerticals": [ # Requests containing any of these vertical ids will not match. Values are from the publisher-verticals.txt file in the downloadable files section. 154 "A String", 155 ], 156 "geoCriteriaIds": [ # Requests containing any of these geo criteria ids will match. 157 "A String", 158 ], 159 "isActive": True or False, # Whether this config is active. Required for all requests. 160 "kind": "adexchangebuyer#pretargetingConfig", # The kind of the resource, i.e. "adexchangebuyer#pretargetingConfig". 161 "languages": [ # Request containing any of these language codes will match. 162 "A String", 163 ], 164 "maximumQps": "A String", # The maximum QPS allocated to this pretargeting configuration, used for pretargeting-level QPS limits. By default, this is not set, which indicates that there is no QPS limit at the configuration level (a global or account-level limit may still be imposed). 165 "mobileCarriers": [ # Requests containing any of these mobile carrier ids will match. Values are from mobile-carriers.csv in the downloadable files section. 166 "A String", 167 ], 168 "mobileDevices": [ # Requests containing any of these mobile device ids will match. Values are from mobile-devices.csv in the downloadable files section. 169 "A String", 170 ], 171 "mobileOperatingSystemVersions": [ # Requests containing any of these mobile operating system version ids will match. Values are from mobile-os.csv in the downloadable files section. 172 "A String", 173 ], 174 "placements": [ # Requests containing any of these placements will match. 175 { 176 "token": "A String", # The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement. 177 "type": "A String", # The type of the placement. 178 }, 179 ], 180 "platforms": [ # Requests matching any of these platforms will match. Possible values are PRETARGETING_PLATFORM_MOBILE, PRETARGETING_PLATFORM_DESKTOP, and PRETARGETING_PLATFORM_TABLET. 181 "A String", 182 ], 183 "supportedCreativeAttributes": [ # Creative attributes should be declared here if all creatives corresponding to this pretargeting configuration have that creative attribute. Values are from pretargetable-creative-attributes.txt in the downloadable files section. 184 "A String", 185 ], 186 "userLists": [ # Requests containing any of these user list ids will match. 187 "A String", 188 ], 189 "vendorTypes": [ # Requests that allow any of these vendor ids will match. Values are from vendors.txt in the downloadable files section. 190 "A String", 191 ], 192 "verticals": [ # Requests containing any of these vertical ids will match. 193 "A String", 194 ], 195}</pre> 196</div> 197 198<div class="method"> 199 <code class="details" id="insert">insert(accountId, body=None)</code> 200 <pre>Inserts a new pretargeting configuration. 201 202Args: 203 accountId: string, The account id to insert the pretargeting config for. (required) 204 body: object, The request body. 205 The object takes the form of: 206 207{ 208 "billingId": "A String", # The id for billing purposes, provided for reference. Leave this field blank for insert requests; the id will be generated automatically. 209 "configId": "A String", # The config id; generated automatically. Leave this field blank for insert requests. 210 "configName": "A String", # The name of the config. Must be unique. Required for all requests. 211 "creativeType": [ # List must contain exactly one of PRETARGETING_CREATIVE_TYPE_HTML or PRETARGETING_CREATIVE_TYPE_VIDEO. 212 "A String", 213 ], 214 "dimensions": [ # Requests which allow one of these (width, height) pairs will match. All pairs must be supported ad dimensions. 215 { 216 "height": "A String", # Height in pixels. 217 "width": "A String", # Width in pixels. 218 }, 219 ], 220 "excludedContentLabels": [ # Requests with any of these content labels will not match. Values are from content-labels.txt in the downloadable files section. 221 "A String", 222 ], 223 "excludedGeoCriteriaIds": [ # Requests containing any of these geo criteria ids will not match. 224 "A String", 225 ], 226 "excludedPlacements": [ # Requests containing any of these placements will not match. 227 { 228 "token": "A String", # The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement. 229 "type": "A String", # The type of the placement. 230 }, 231 ], 232 "excludedUserLists": [ # Requests containing any of these users list ids will not match. 233 "A String", 234 ], 235 "excludedVerticals": [ # Requests containing any of these vertical ids will not match. Values are from the publisher-verticals.txt file in the downloadable files section. 236 "A String", 237 ], 238 "geoCriteriaIds": [ # Requests containing any of these geo criteria ids will match. 239 "A String", 240 ], 241 "isActive": True or False, # Whether this config is active. Required for all requests. 242 "kind": "adexchangebuyer#pretargetingConfig", # The kind of the resource, i.e. "adexchangebuyer#pretargetingConfig". 243 "languages": [ # Request containing any of these language codes will match. 244 "A String", 245 ], 246 "maximumQps": "A String", # The maximum QPS allocated to this pretargeting configuration, used for pretargeting-level QPS limits. By default, this is not set, which indicates that there is no QPS limit at the configuration level (a global or account-level limit may still be imposed). 247 "mobileCarriers": [ # Requests containing any of these mobile carrier ids will match. Values are from mobile-carriers.csv in the downloadable files section. 248 "A String", 249 ], 250 "mobileDevices": [ # Requests containing any of these mobile device ids will match. Values are from mobile-devices.csv in the downloadable files section. 251 "A String", 252 ], 253 "mobileOperatingSystemVersions": [ # Requests containing any of these mobile operating system version ids will match. Values are from mobile-os.csv in the downloadable files section. 254 "A String", 255 ], 256 "placements": [ # Requests containing any of these placements will match. 257 { 258 "token": "A String", # The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement. 259 "type": "A String", # The type of the placement. 260 }, 261 ], 262 "platforms": [ # Requests matching any of these platforms will match. Possible values are PRETARGETING_PLATFORM_MOBILE, PRETARGETING_PLATFORM_DESKTOP, and PRETARGETING_PLATFORM_TABLET. 263 "A String", 264 ], 265 "supportedCreativeAttributes": [ # Creative attributes should be declared here if all creatives corresponding to this pretargeting configuration have that creative attribute. Values are from pretargetable-creative-attributes.txt in the downloadable files section. 266 "A String", 267 ], 268 "userLists": [ # Requests containing any of these user list ids will match. 269 "A String", 270 ], 271 "vendorTypes": [ # Requests that allow any of these vendor ids will match. Values are from vendors.txt in the downloadable files section. 272 "A String", 273 ], 274 "verticals": [ # Requests containing any of these vertical ids will match. 275 "A String", 276 ], 277} 278 279 280Returns: 281 An object of the form: 282 283 { 284 "billingId": "A String", # The id for billing purposes, provided for reference. Leave this field blank for insert requests; the id will be generated automatically. 285 "configId": "A String", # The config id; generated automatically. Leave this field blank for insert requests. 286 "configName": "A String", # The name of the config. Must be unique. Required for all requests. 287 "creativeType": [ # List must contain exactly one of PRETARGETING_CREATIVE_TYPE_HTML or PRETARGETING_CREATIVE_TYPE_VIDEO. 288 "A String", 289 ], 290 "dimensions": [ # Requests which allow one of these (width, height) pairs will match. All pairs must be supported ad dimensions. 291 { 292 "height": "A String", # Height in pixels. 293 "width": "A String", # Width in pixels. 294 }, 295 ], 296 "excludedContentLabels": [ # Requests with any of these content labels will not match. Values are from content-labels.txt in the downloadable files section. 297 "A String", 298 ], 299 "excludedGeoCriteriaIds": [ # Requests containing any of these geo criteria ids will not match. 300 "A String", 301 ], 302 "excludedPlacements": [ # Requests containing any of these placements will not match. 303 { 304 "token": "A String", # The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement. 305 "type": "A String", # The type of the placement. 306 }, 307 ], 308 "excludedUserLists": [ # Requests containing any of these users list ids will not match. 309 "A String", 310 ], 311 "excludedVerticals": [ # Requests containing any of these vertical ids will not match. Values are from the publisher-verticals.txt file in the downloadable files section. 312 "A String", 313 ], 314 "geoCriteriaIds": [ # Requests containing any of these geo criteria ids will match. 315 "A String", 316 ], 317 "isActive": True or False, # Whether this config is active. Required for all requests. 318 "kind": "adexchangebuyer#pretargetingConfig", # The kind of the resource, i.e. "adexchangebuyer#pretargetingConfig". 319 "languages": [ # Request containing any of these language codes will match. 320 "A String", 321 ], 322 "maximumQps": "A String", # The maximum QPS allocated to this pretargeting configuration, used for pretargeting-level QPS limits. By default, this is not set, which indicates that there is no QPS limit at the configuration level (a global or account-level limit may still be imposed). 323 "mobileCarriers": [ # Requests containing any of these mobile carrier ids will match. Values are from mobile-carriers.csv in the downloadable files section. 324 "A String", 325 ], 326 "mobileDevices": [ # Requests containing any of these mobile device ids will match. Values are from mobile-devices.csv in the downloadable files section. 327 "A String", 328 ], 329 "mobileOperatingSystemVersions": [ # Requests containing any of these mobile operating system version ids will match. Values are from mobile-os.csv in the downloadable files section. 330 "A String", 331 ], 332 "placements": [ # Requests containing any of these placements will match. 333 { 334 "token": "A String", # The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement. 335 "type": "A String", # The type of the placement. 336 }, 337 ], 338 "platforms": [ # Requests matching any of these platforms will match. Possible values are PRETARGETING_PLATFORM_MOBILE, PRETARGETING_PLATFORM_DESKTOP, and PRETARGETING_PLATFORM_TABLET. 339 "A String", 340 ], 341 "supportedCreativeAttributes": [ # Creative attributes should be declared here if all creatives corresponding to this pretargeting configuration have that creative attribute. Values are from pretargetable-creative-attributes.txt in the downloadable files section. 342 "A String", 343 ], 344 "userLists": [ # Requests containing any of these user list ids will match. 345 "A String", 346 ], 347 "vendorTypes": [ # Requests that allow any of these vendor ids will match. Values are from vendors.txt in the downloadable files section. 348 "A String", 349 ], 350 "verticals": [ # Requests containing any of these vertical ids will match. 351 "A String", 352 ], 353}</pre> 354</div> 355 356<div class="method"> 357 <code class="details" id="list">list(accountId)</code> 358 <pre>Retrieves a list of the authenticated user's pretargeting configurations. 359 360Args: 361 accountId: string, The account id to get the pretargeting configs for. (required) 362 363Returns: 364 An object of the form: 365 366 { 367 "items": [ # A list of pretargeting configs 368 { 369 "billingId": "A String", # The id for billing purposes, provided for reference. Leave this field blank for insert requests; the id will be generated automatically. 370 "configId": "A String", # The config id; generated automatically. Leave this field blank for insert requests. 371 "configName": "A String", # The name of the config. Must be unique. Required for all requests. 372 "creativeType": [ # List must contain exactly one of PRETARGETING_CREATIVE_TYPE_HTML or PRETARGETING_CREATIVE_TYPE_VIDEO. 373 "A String", 374 ], 375 "dimensions": [ # Requests which allow one of these (width, height) pairs will match. All pairs must be supported ad dimensions. 376 { 377 "height": "A String", # Height in pixels. 378 "width": "A String", # Width in pixels. 379 }, 380 ], 381 "excludedContentLabels": [ # Requests with any of these content labels will not match. Values are from content-labels.txt in the downloadable files section. 382 "A String", 383 ], 384 "excludedGeoCriteriaIds": [ # Requests containing any of these geo criteria ids will not match. 385 "A String", 386 ], 387 "excludedPlacements": [ # Requests containing any of these placements will not match. 388 { 389 "token": "A String", # The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement. 390 "type": "A String", # The type of the placement. 391 }, 392 ], 393 "excludedUserLists": [ # Requests containing any of these users list ids will not match. 394 "A String", 395 ], 396 "excludedVerticals": [ # Requests containing any of these vertical ids will not match. Values are from the publisher-verticals.txt file in the downloadable files section. 397 "A String", 398 ], 399 "geoCriteriaIds": [ # Requests containing any of these geo criteria ids will match. 400 "A String", 401 ], 402 "isActive": True or False, # Whether this config is active. Required for all requests. 403 "kind": "adexchangebuyer#pretargetingConfig", # The kind of the resource, i.e. "adexchangebuyer#pretargetingConfig". 404 "languages": [ # Request containing any of these language codes will match. 405 "A String", 406 ], 407 "maximumQps": "A String", # The maximum QPS allocated to this pretargeting configuration, used for pretargeting-level QPS limits. By default, this is not set, which indicates that there is no QPS limit at the configuration level (a global or account-level limit may still be imposed). 408 "mobileCarriers": [ # Requests containing any of these mobile carrier ids will match. Values are from mobile-carriers.csv in the downloadable files section. 409 "A String", 410 ], 411 "mobileDevices": [ # Requests containing any of these mobile device ids will match. Values are from mobile-devices.csv in the downloadable files section. 412 "A String", 413 ], 414 "mobileOperatingSystemVersions": [ # Requests containing any of these mobile operating system version ids will match. Values are from mobile-os.csv in the downloadable files section. 415 "A String", 416 ], 417 "placements": [ # Requests containing any of these placements will match. 418 { 419 "token": "A String", # The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement. 420 "type": "A String", # The type of the placement. 421 }, 422 ], 423 "platforms": [ # Requests matching any of these platforms will match. Possible values are PRETARGETING_PLATFORM_MOBILE, PRETARGETING_PLATFORM_DESKTOP, and PRETARGETING_PLATFORM_TABLET. 424 "A String", 425 ], 426 "supportedCreativeAttributes": [ # Creative attributes should be declared here if all creatives corresponding to this pretargeting configuration have that creative attribute. Values are from pretargetable-creative-attributes.txt in the downloadable files section. 427 "A String", 428 ], 429 "userLists": [ # Requests containing any of these user list ids will match. 430 "A String", 431 ], 432 "vendorTypes": [ # Requests that allow any of these vendor ids will match. Values are from vendors.txt in the downloadable files section. 433 "A String", 434 ], 435 "verticals": [ # Requests containing any of these vertical ids will match. 436 "A String", 437 ], 438 }, 439 ], 440 "kind": "adexchangebuyer#pretargetingConfigList", # Resource type. 441}</pre> 442</div> 443 444<div class="method"> 445 <code class="details" id="patch">patch(accountId, configId, body=None)</code> 446 <pre>Updates an existing pretargeting config. This method supports patch semantics. 447 448Args: 449 accountId: string, The account id to update the pretargeting config for. (required) 450 configId: string, The specific id of the configuration to update. (required) 451 body: object, The request body. 452 The object takes the form of: 453 454{ 455 "billingId": "A String", # The id for billing purposes, provided for reference. Leave this field blank for insert requests; the id will be generated automatically. 456 "configId": "A String", # The config id; generated automatically. Leave this field blank for insert requests. 457 "configName": "A String", # The name of the config. Must be unique. Required for all requests. 458 "creativeType": [ # List must contain exactly one of PRETARGETING_CREATIVE_TYPE_HTML or PRETARGETING_CREATIVE_TYPE_VIDEO. 459 "A String", 460 ], 461 "dimensions": [ # Requests which allow one of these (width, height) pairs will match. All pairs must be supported ad dimensions. 462 { 463 "height": "A String", # Height in pixels. 464 "width": "A String", # Width in pixels. 465 }, 466 ], 467 "excludedContentLabels": [ # Requests with any of these content labels will not match. Values are from content-labels.txt in the downloadable files section. 468 "A String", 469 ], 470 "excludedGeoCriteriaIds": [ # Requests containing any of these geo criteria ids will not match. 471 "A String", 472 ], 473 "excludedPlacements": [ # Requests containing any of these placements will not match. 474 { 475 "token": "A String", # The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement. 476 "type": "A String", # The type of the placement. 477 }, 478 ], 479 "excludedUserLists": [ # Requests containing any of these users list ids will not match. 480 "A String", 481 ], 482 "excludedVerticals": [ # Requests containing any of these vertical ids will not match. Values are from the publisher-verticals.txt file in the downloadable files section. 483 "A String", 484 ], 485 "geoCriteriaIds": [ # Requests containing any of these geo criteria ids will match. 486 "A String", 487 ], 488 "isActive": True or False, # Whether this config is active. Required for all requests. 489 "kind": "adexchangebuyer#pretargetingConfig", # The kind of the resource, i.e. "adexchangebuyer#pretargetingConfig". 490 "languages": [ # Request containing any of these language codes will match. 491 "A String", 492 ], 493 "maximumQps": "A String", # The maximum QPS allocated to this pretargeting configuration, used for pretargeting-level QPS limits. By default, this is not set, which indicates that there is no QPS limit at the configuration level (a global or account-level limit may still be imposed). 494 "mobileCarriers": [ # Requests containing any of these mobile carrier ids will match. Values are from mobile-carriers.csv in the downloadable files section. 495 "A String", 496 ], 497 "mobileDevices": [ # Requests containing any of these mobile device ids will match. Values are from mobile-devices.csv in the downloadable files section. 498 "A String", 499 ], 500 "mobileOperatingSystemVersions": [ # Requests containing any of these mobile operating system version ids will match. Values are from mobile-os.csv in the downloadable files section. 501 "A String", 502 ], 503 "placements": [ # Requests containing any of these placements will match. 504 { 505 "token": "A String", # The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement. 506 "type": "A String", # The type of the placement. 507 }, 508 ], 509 "platforms": [ # Requests matching any of these platforms will match. Possible values are PRETARGETING_PLATFORM_MOBILE, PRETARGETING_PLATFORM_DESKTOP, and PRETARGETING_PLATFORM_TABLET. 510 "A String", 511 ], 512 "supportedCreativeAttributes": [ # Creative attributes should be declared here if all creatives corresponding to this pretargeting configuration have that creative attribute. Values are from pretargetable-creative-attributes.txt in the downloadable files section. 513 "A String", 514 ], 515 "userLists": [ # Requests containing any of these user list ids will match. 516 "A String", 517 ], 518 "vendorTypes": [ # Requests that allow any of these vendor ids will match. Values are from vendors.txt in the downloadable files section. 519 "A String", 520 ], 521 "verticals": [ # Requests containing any of these vertical ids will match. 522 "A String", 523 ], 524} 525 526 527Returns: 528 An object of the form: 529 530 { 531 "billingId": "A String", # The id for billing purposes, provided for reference. Leave this field blank for insert requests; the id will be generated automatically. 532 "configId": "A String", # The config id; generated automatically. Leave this field blank for insert requests. 533 "configName": "A String", # The name of the config. Must be unique. Required for all requests. 534 "creativeType": [ # List must contain exactly one of PRETARGETING_CREATIVE_TYPE_HTML or PRETARGETING_CREATIVE_TYPE_VIDEO. 535 "A String", 536 ], 537 "dimensions": [ # Requests which allow one of these (width, height) pairs will match. All pairs must be supported ad dimensions. 538 { 539 "height": "A String", # Height in pixels. 540 "width": "A String", # Width in pixels. 541 }, 542 ], 543 "excludedContentLabels": [ # Requests with any of these content labels will not match. Values are from content-labels.txt in the downloadable files section. 544 "A String", 545 ], 546 "excludedGeoCriteriaIds": [ # Requests containing any of these geo criteria ids will not match. 547 "A String", 548 ], 549 "excludedPlacements": [ # Requests containing any of these placements will not match. 550 { 551 "token": "A String", # The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement. 552 "type": "A String", # The type of the placement. 553 }, 554 ], 555 "excludedUserLists": [ # Requests containing any of these users list ids will not match. 556 "A String", 557 ], 558 "excludedVerticals": [ # Requests containing any of these vertical ids will not match. Values are from the publisher-verticals.txt file in the downloadable files section. 559 "A String", 560 ], 561 "geoCriteriaIds": [ # Requests containing any of these geo criteria ids will match. 562 "A String", 563 ], 564 "isActive": True or False, # Whether this config is active. Required for all requests. 565 "kind": "adexchangebuyer#pretargetingConfig", # The kind of the resource, i.e. "adexchangebuyer#pretargetingConfig". 566 "languages": [ # Request containing any of these language codes will match. 567 "A String", 568 ], 569 "maximumQps": "A String", # The maximum QPS allocated to this pretargeting configuration, used for pretargeting-level QPS limits. By default, this is not set, which indicates that there is no QPS limit at the configuration level (a global or account-level limit may still be imposed). 570 "mobileCarriers": [ # Requests containing any of these mobile carrier ids will match. Values are from mobile-carriers.csv in the downloadable files section. 571 "A String", 572 ], 573 "mobileDevices": [ # Requests containing any of these mobile device ids will match. Values are from mobile-devices.csv in the downloadable files section. 574 "A String", 575 ], 576 "mobileOperatingSystemVersions": [ # Requests containing any of these mobile operating system version ids will match. Values are from mobile-os.csv in the downloadable files section. 577 "A String", 578 ], 579 "placements": [ # Requests containing any of these placements will match. 580 { 581 "token": "A String", # The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement. 582 "type": "A String", # The type of the placement. 583 }, 584 ], 585 "platforms": [ # Requests matching any of these platforms will match. Possible values are PRETARGETING_PLATFORM_MOBILE, PRETARGETING_PLATFORM_DESKTOP, and PRETARGETING_PLATFORM_TABLET. 586 "A String", 587 ], 588 "supportedCreativeAttributes": [ # Creative attributes should be declared here if all creatives corresponding to this pretargeting configuration have that creative attribute. Values are from pretargetable-creative-attributes.txt in the downloadable files section. 589 "A String", 590 ], 591 "userLists": [ # Requests containing any of these user list ids will match. 592 "A String", 593 ], 594 "vendorTypes": [ # Requests that allow any of these vendor ids will match. Values are from vendors.txt in the downloadable files section. 595 "A String", 596 ], 597 "verticals": [ # Requests containing any of these vertical ids will match. 598 "A String", 599 ], 600}</pre> 601</div> 602 603<div class="method"> 604 <code class="details" id="update">update(accountId, configId, body=None)</code> 605 <pre>Updates an existing pretargeting config. 606 607Args: 608 accountId: string, The account id to update the pretargeting config for. (required) 609 configId: string, The specific id of the configuration to update. (required) 610 body: object, The request body. 611 The object takes the form of: 612 613{ 614 "billingId": "A String", # The id for billing purposes, provided for reference. Leave this field blank for insert requests; the id will be generated automatically. 615 "configId": "A String", # The config id; generated automatically. Leave this field blank for insert requests. 616 "configName": "A String", # The name of the config. Must be unique. Required for all requests. 617 "creativeType": [ # List must contain exactly one of PRETARGETING_CREATIVE_TYPE_HTML or PRETARGETING_CREATIVE_TYPE_VIDEO. 618 "A String", 619 ], 620 "dimensions": [ # Requests which allow one of these (width, height) pairs will match. All pairs must be supported ad dimensions. 621 { 622 "height": "A String", # Height in pixels. 623 "width": "A String", # Width in pixels. 624 }, 625 ], 626 "excludedContentLabels": [ # Requests with any of these content labels will not match. Values are from content-labels.txt in the downloadable files section. 627 "A String", 628 ], 629 "excludedGeoCriteriaIds": [ # Requests containing any of these geo criteria ids will not match. 630 "A String", 631 ], 632 "excludedPlacements": [ # Requests containing any of these placements will not match. 633 { 634 "token": "A String", # The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement. 635 "type": "A String", # The type of the placement. 636 }, 637 ], 638 "excludedUserLists": [ # Requests containing any of these users list ids will not match. 639 "A String", 640 ], 641 "excludedVerticals": [ # Requests containing any of these vertical ids will not match. Values are from the publisher-verticals.txt file in the downloadable files section. 642 "A String", 643 ], 644 "geoCriteriaIds": [ # Requests containing any of these geo criteria ids will match. 645 "A String", 646 ], 647 "isActive": True or False, # Whether this config is active. Required for all requests. 648 "kind": "adexchangebuyer#pretargetingConfig", # The kind of the resource, i.e. "adexchangebuyer#pretargetingConfig". 649 "languages": [ # Request containing any of these language codes will match. 650 "A String", 651 ], 652 "maximumQps": "A String", # The maximum QPS allocated to this pretargeting configuration, used for pretargeting-level QPS limits. By default, this is not set, which indicates that there is no QPS limit at the configuration level (a global or account-level limit may still be imposed). 653 "mobileCarriers": [ # Requests containing any of these mobile carrier ids will match. Values are from mobile-carriers.csv in the downloadable files section. 654 "A String", 655 ], 656 "mobileDevices": [ # Requests containing any of these mobile device ids will match. Values are from mobile-devices.csv in the downloadable files section. 657 "A String", 658 ], 659 "mobileOperatingSystemVersions": [ # Requests containing any of these mobile operating system version ids will match. Values are from mobile-os.csv in the downloadable files section. 660 "A String", 661 ], 662 "placements": [ # Requests containing any of these placements will match. 663 { 664 "token": "A String", # The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement. 665 "type": "A String", # The type of the placement. 666 }, 667 ], 668 "platforms": [ # Requests matching any of these platforms will match. Possible values are PRETARGETING_PLATFORM_MOBILE, PRETARGETING_PLATFORM_DESKTOP, and PRETARGETING_PLATFORM_TABLET. 669 "A String", 670 ], 671 "supportedCreativeAttributes": [ # Creative attributes should be declared here if all creatives corresponding to this pretargeting configuration have that creative attribute. Values are from pretargetable-creative-attributes.txt in the downloadable files section. 672 "A String", 673 ], 674 "userLists": [ # Requests containing any of these user list ids will match. 675 "A String", 676 ], 677 "vendorTypes": [ # Requests that allow any of these vendor ids will match. Values are from vendors.txt in the downloadable files section. 678 "A String", 679 ], 680 "verticals": [ # Requests containing any of these vertical ids will match. 681 "A String", 682 ], 683} 684 685 686Returns: 687 An object of the form: 688 689 { 690 "billingId": "A String", # The id for billing purposes, provided for reference. Leave this field blank for insert requests; the id will be generated automatically. 691 "configId": "A String", # The config id; generated automatically. Leave this field blank for insert requests. 692 "configName": "A String", # The name of the config. Must be unique. Required for all requests. 693 "creativeType": [ # List must contain exactly one of PRETARGETING_CREATIVE_TYPE_HTML or PRETARGETING_CREATIVE_TYPE_VIDEO. 694 "A String", 695 ], 696 "dimensions": [ # Requests which allow one of these (width, height) pairs will match. All pairs must be supported ad dimensions. 697 { 698 "height": "A String", # Height in pixels. 699 "width": "A String", # Width in pixels. 700 }, 701 ], 702 "excludedContentLabels": [ # Requests with any of these content labels will not match. Values are from content-labels.txt in the downloadable files section. 703 "A String", 704 ], 705 "excludedGeoCriteriaIds": [ # Requests containing any of these geo criteria ids will not match. 706 "A String", 707 ], 708 "excludedPlacements": [ # Requests containing any of these placements will not match. 709 { 710 "token": "A String", # The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement. 711 "type": "A String", # The type of the placement. 712 }, 713 ], 714 "excludedUserLists": [ # Requests containing any of these users list ids will not match. 715 "A String", 716 ], 717 "excludedVerticals": [ # Requests containing any of these vertical ids will not match. Values are from the publisher-verticals.txt file in the downloadable files section. 718 "A String", 719 ], 720 "geoCriteriaIds": [ # Requests containing any of these geo criteria ids will match. 721 "A String", 722 ], 723 "isActive": True or False, # Whether this config is active. Required for all requests. 724 "kind": "adexchangebuyer#pretargetingConfig", # The kind of the resource, i.e. "adexchangebuyer#pretargetingConfig". 725 "languages": [ # Request containing any of these language codes will match. 726 "A String", 727 ], 728 "maximumQps": "A String", # The maximum QPS allocated to this pretargeting configuration, used for pretargeting-level QPS limits. By default, this is not set, which indicates that there is no QPS limit at the configuration level (a global or account-level limit may still be imposed). 729 "mobileCarriers": [ # Requests containing any of these mobile carrier ids will match. Values are from mobile-carriers.csv in the downloadable files section. 730 "A String", 731 ], 732 "mobileDevices": [ # Requests containing any of these mobile device ids will match. Values are from mobile-devices.csv in the downloadable files section. 733 "A String", 734 ], 735 "mobileOperatingSystemVersions": [ # Requests containing any of these mobile operating system version ids will match. Values are from mobile-os.csv in the downloadable files section. 736 "A String", 737 ], 738 "placements": [ # Requests containing any of these placements will match. 739 { 740 "token": "A String", # The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement. 741 "type": "A String", # The type of the placement. 742 }, 743 ], 744 "platforms": [ # Requests matching any of these platforms will match. Possible values are PRETARGETING_PLATFORM_MOBILE, PRETARGETING_PLATFORM_DESKTOP, and PRETARGETING_PLATFORM_TABLET. 745 "A String", 746 ], 747 "supportedCreativeAttributes": [ # Creative attributes should be declared here if all creatives corresponding to this pretargeting configuration have that creative attribute. Values are from pretargetable-creative-attributes.txt in the downloadable files section. 748 "A String", 749 ], 750 "userLists": [ # Requests containing any of these user list ids will match. 751 "A String", 752 ], 753 "vendorTypes": [ # Requests that allow any of these vendor ids will match. Values are from vendors.txt in the downloadable files section. 754 "A String", 755 ], 756 "verticals": [ # Requests containing any of these vertical ids will match. 757 "A String", 758 ], 759}</pre> 760</div> 761 762</body></html>