• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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="#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
100Args:
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
110Args:
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
114Returns:
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
193Args:
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
270Returns:
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
349Args:
350  accountId: string, The account id to get the pretargeting configs for. (required)
351
352Returns:
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
436Args:
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
514Returns:
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
593Args:
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
671Returns:
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>