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