Skip to content

Commit 0e5b9bf

Browse files
committed
Version 1.3 release.
Updates CHANGELOG, version, docs.
1 parent 63caac0 commit 0e5b9bf

File tree

181 files changed

+19072
-2091
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

181 files changed

+19072
-2091
lines changed

CHANGELOG

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,12 @@
1+
v1.3
2+
Version 1.3
3+
4+
Add support for the Google Application Default Credentials.
5+
Require python 2.6 as a minimum version.
6+
Update several API samples.
7+
Finish splitting out oauth2client repo and update tests.
8+
Various doc cleanup and bugfixes.
9+
110
v1.2
211
Version 1.2
312

LICENSE

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
Copyright 2014-2014 Google Inc. All Rights Reserved.
1+
Copyright 2014 Google Inc. All Rights Reserved.
22

33
Licensed under the Apache License, Version 2.0 (the "License");
44
you may not use this file except in compliance with the License.

docs/dyn/adexchangebuyer_v1_3.billingInfo.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -92,7 +92,7 @@ <h3>Method Details</h3>
9292
An object of the form:
9393

9494
{ # The configuration data for an Ad Exchange billing info.
95-
"billingId": [ # Billing info id.
95+
"billingId": [ # A list of adgroup IDs associated with this particular account. These IDs may show up as part of a realtime bidding BidRequest, which indicates a bid request for this account.
9696
"A String",
9797
],
9898
"accountName": "A String", # Account name.
@@ -113,7 +113,7 @@ <h3>Method Details</h3>
113113
{ # A billing info feed lists Billing Info the Ad Exchange buyer account has access to. Each entry in the feed corresponds to a single billing info.
114114
"items": [ # A list of billing info relevant for your account.
115115
{ # The configuration data for an Ad Exchange billing info.
116-
"billingId": [ # Billing info id.
116+
"billingId": [ # A list of adgroup IDs associated with this particular account. These IDs may show up as part of a realtime bidding BidRequest, which indicates a bid request for this account.
117117
"A String",
118118
],
119119
"accountName": "A String", # Account name.

docs/dyn/adexchangebuyer_v1_3.creatives.html

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -134,7 +134,7 @@ <h3>Method Details</h3>
134134
],
135135
},
136136
],
137-
"filteringReasons": { # The filtering reasons for the creative. Read-only. This field should not be set in requests.
137+
"filteringReasons": { # The filtering reasons for the creative. If this feature is not enabled, please ask your technical account manager. Read-only. This field should not be set in requests.
138138
"date": "A String", # The date in ISO 8601 format for the data. The data is collected from 00:00:00 to 23:59:59 in PST.
139139
"reasons": [ # The filtering reasons.
140140
{
@@ -202,7 +202,7 @@ <h3>Method Details</h3>
202202
],
203203
},
204204
],
205-
"filteringReasons": { # The filtering reasons for the creative. Read-only. This field should not be set in requests.
205+
"filteringReasons": { # The filtering reasons for the creative. If this feature is not enabled, please ask your technical account manager. Read-only. This field should not be set in requests.
206206
"date": "A String", # The date in ISO 8601 format for the data. The data is collected from 00:00:00 to 23:59:59 in PST.
207207
"reasons": [ # The filtering reasons.
208208
{
@@ -265,7 +265,7 @@ <h3>Method Details</h3>
265265
],
266266
},
267267
],
268-
"filteringReasons": { # The filtering reasons for the creative. Read-only. This field should not be set in requests.
268+
"filteringReasons": { # The filtering reasons for the creative. If this feature is not enabled, please ask your technical account manager. Read-only. This field should not be set in requests.
269269
"date": "A String", # The date in ISO 8601 format for the data. The data is collected from 00:00:00 to 23:59:59 in PST.
270270
"reasons": [ # The filtering reasons.
271271
{
@@ -346,7 +346,7 @@ <h3>Method Details</h3>
346346
],
347347
},
348348
],
349-
"filteringReasons": { # The filtering reasons for the creative. Read-only. This field should not be set in requests.
349+
"filteringReasons": { # The filtering reasons for the creative. If this feature is not enabled, please ask your technical account manager. Read-only. This field should not be set in requests.
350350
"date": "A String", # The date in ISO 8601 format for the data. The data is collected from 00:00:00 to 23:59:59 in PST.
351351
"reasons": [ # The filtering reasons.
352352
{

docs/dyn/adexchangebuyer_v1_3.directDeals.html

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -99,6 +99,7 @@ <h3>Method Details</h3>
9999
"fixedCpm": "A String", # The fixed price for this direct deal. In cpm micros of currency according to currency_code. If set, then this deal is eligible for the fixed price tier of buying (highest priority, pay exactly the configured fixed price).
100100
"privateExchangeMinCpm": "A String", # The minimum price for this direct deal. In cpm micros of currency according to currency_code. If set, then this deal is eligible for the private exchange tier of buying (below fixed price priority, run as a second price auction).
101101
"startTime": "A String", # Start time for when this deal becomes active. If not set then this deal is active immediately upon creation. In seconds since the epoch.
102+
"publisherBlocksOverriden": True or False, # If true, the publisher has opted to have their blocks ignored when a creative is bid with for this deal.
102103
"endTime": "A String", # End time for when this deal stops being active. If not set then this deal is valid until manually disabled by the publisher. In seconds since the epoch.
103104
"sellerNetwork": "A String", # The name of the publisher offering this direct deal.
104105
"id": "A String", # Deal id.
@@ -126,6 +127,7 @@ <h3>Method Details</h3>
126127
"fixedCpm": "A String", # The fixed price for this direct deal. In cpm micros of currency according to currency_code. If set, then this deal is eligible for the fixed price tier of buying (highest priority, pay exactly the configured fixed price).
127128
"privateExchangeMinCpm": "A String", # The minimum price for this direct deal. In cpm micros of currency according to currency_code. If set, then this deal is eligible for the private exchange tier of buying (below fixed price priority, run as a second price auction).
128129
"startTime": "A String", # Start time for when this deal becomes active. If not set then this deal is active immediately upon creation. In seconds since the epoch.
130+
"publisherBlocksOverriden": True or False, # If true, the publisher has opted to have their blocks ignored when a creative is bid with for this deal.
129131
"endTime": "A String", # End time for when this deal stops being active. If not set then this deal is valid until manually disabled by the publisher. In seconds since the epoch.
130132
"sellerNetwork": "A String", # The name of the publisher offering this direct deal.
131133
"id": "A String", # Deal id.

docs/dyn/adexchangebuyer_v1_3.pretargetingConfig.html

Lines changed: 32 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -147,9 +147,7 @@ <h3>Method Details</h3>
147147
"type": "A String", # The type of the placement.
148148
},
149149
],
150-
"creativeType": [ # List must contain exactly one of PRETARGETING_CREATIVE_TYPE_HTML or PRETARGETING_CREATIVE_TYPE_VIDEO.
151-
"A String",
152-
],
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.
153151
"geoCriteriaIds": [ # Requests containing any of these geo criteria ids will match.
154152
"A String",
155153
],
@@ -176,6 +174,9 @@ <h3>Method Details</h3>
176174
"userLists": [ # Requests containing any of these user list ids will match.
177175
"A String",
178176
],
177+
"creativeType": [ # List must contain exactly one of PRETARGETING_CREATIVE_TYPE_HTML or PRETARGETING_CREATIVE_TYPE_VIDEO.
178+
"A String",
179+
],
179180
"placements": [ # Requests containing any of these placements will match.
180181
{
181182
"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.
@@ -227,9 +228,7 @@ <h3>Method Details</h3>
227228
"type": "A String", # The type of the placement.
228229
},
229230
],
230-
"creativeType": [ # List must contain exactly one of PRETARGETING_CREATIVE_TYPE_HTML or PRETARGETING_CREATIVE_TYPE_VIDEO.
231-
"A String",
232-
],
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.
233232
"geoCriteriaIds": [ # Requests containing any of these geo criteria ids will match.
234233
"A String",
235234
],
@@ -256,6 +255,9 @@ <h3>Method Details</h3>
256255
"userLists": [ # Requests containing any of these user list ids will match.
257256
"A String",
258257
],
258+
"creativeType": [ # List must contain exactly one of PRETARGETING_CREATIVE_TYPE_HTML or PRETARGETING_CREATIVE_TYPE_VIDEO.
259+
"A String",
260+
],
259261
"placements": [ # Requests containing any of these placements will match.
260262
{
261263
"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.
@@ -301,9 +303,7 @@ <h3>Method Details</h3>
301303
"type": "A String", # The type of the placement.
302304
},
303305
],
304-
"creativeType": [ # List must contain exactly one of PRETARGETING_CREATIVE_TYPE_HTML or PRETARGETING_CREATIVE_TYPE_VIDEO.
305-
"A String",
306-
],
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.
307307
"geoCriteriaIds": [ # Requests containing any of these geo criteria ids will match.
308308
"A String",
309309
],
@@ -330,6 +330,9 @@ <h3>Method Details</h3>
330330
"userLists": [ # Requests containing any of these user list ids will match.
331331
"A String",
332332
],
333+
"creativeType": [ # List must contain exactly one of PRETARGETING_CREATIVE_TYPE_HTML or PRETARGETING_CREATIVE_TYPE_VIDEO.
334+
"A String",
335+
],
333336
"placements": [ # Requests containing any of these placements will match.
334337
{
335338
"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.
@@ -384,9 +387,7 @@ <h3>Method Details</h3>
384387
"type": "A String", # The type of the placement.
385388
},
386389
],
387-
"creativeType": [ # List must contain exactly one of PRETARGETING_CREATIVE_TYPE_HTML or PRETARGETING_CREATIVE_TYPE_VIDEO.
388-
"A String",
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.
390391
"geoCriteriaIds": [ # Requests containing any of these geo criteria ids will match.
391392
"A String",
392393
],
@@ -413,6 +414,9 @@ <h3>Method Details</h3>
413414
"userLists": [ # Requests containing any of these user list ids will match.
414415
"A String",
415416
],
417+
"creativeType": [ # List must contain exactly one of PRETARGETING_CREATIVE_TYPE_HTML or PRETARGETING_CREATIVE_TYPE_VIDEO.
418+
"A String",
419+
],
416420
"placements": [ # Requests containing any of these placements will match.
417421
{
418422
"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.
@@ -468,9 +472,7 @@ <h3>Method Details</h3>
468472
"type": "A String", # The type of the placement.
469473
},
470474
],
471-
"creativeType": [ # List must contain exactly one of PRETARGETING_CREATIVE_TYPE_HTML or PRETARGETING_CREATIVE_TYPE_VIDEO.
472-
"A String",
473-
],
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.
474476
"geoCriteriaIds": [ # Requests containing any of these geo criteria ids will match.
475477
"A String",
476478
],
@@ -497,6 +499,9 @@ <h3>Method Details</h3>
497499
"userLists": [ # Requests containing any of these user list ids will match.
498500
"A String",
499501
],
502+
"creativeType": [ # List must contain exactly one of PRETARGETING_CREATIVE_TYPE_HTML or PRETARGETING_CREATIVE_TYPE_VIDEO.
503+
"A String",
504+
],
500505
"placements": [ # Requests containing any of these placements will match.
501506
{
502507
"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.
@@ -542,9 +547,7 @@ <h3>Method Details</h3>
542547
"type": "A String", # The type of the placement.
543548
},
544549
],
545-
"creativeType": [ # List must contain exactly one of PRETARGETING_CREATIVE_TYPE_HTML or PRETARGETING_CREATIVE_TYPE_VIDEO.
546-
"A String",
547-
],
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.
548551
"geoCriteriaIds": [ # Requests containing any of these geo criteria ids will match.
549552
"A String",
550553
],
@@ -571,6 +574,9 @@ <h3>Method Details</h3>
571574
"userLists": [ # Requests containing any of these user list ids will match.
572575
"A String",
573576
],
577+
"creativeType": [ # List must contain exactly one of PRETARGETING_CREATIVE_TYPE_HTML or PRETARGETING_CREATIVE_TYPE_VIDEO.
578+
"A String",
579+
],
574580
"placements": [ # Requests containing any of these placements will match.
575581
{
576582
"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.
@@ -623,9 +629,7 @@ <h3>Method Details</h3>
623629
"type": "A String", # The type of the placement.
624630
},
625631
],
626-
"creativeType": [ # List must contain exactly one of PRETARGETING_CREATIVE_TYPE_HTML or PRETARGETING_CREATIVE_TYPE_VIDEO.
627-
"A String",
628-
],
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.
629633
"geoCriteriaIds": [ # Requests containing any of these geo criteria ids will match.
630634
"A String",
631635
],
@@ -652,6 +656,9 @@ <h3>Method Details</h3>
652656
"userLists": [ # Requests containing any of these user list ids will match.
653657
"A String",
654658
],
659+
"creativeType": [ # List must contain exactly one of PRETARGETING_CREATIVE_TYPE_HTML or PRETARGETING_CREATIVE_TYPE_VIDEO.
660+
"A String",
661+
],
655662
"placements": [ # Requests containing any of these placements will match.
656663
{
657664
"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.
@@ -697,9 +704,7 @@ <h3>Method Details</h3>
697704
"type": "A String", # The type of the placement.
698705
},
699706
],
700-
"creativeType": [ # List must contain exactly one of PRETARGETING_CREATIVE_TYPE_HTML or PRETARGETING_CREATIVE_TYPE_VIDEO.
701-
"A String",
702-
],
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.
703708
"geoCriteriaIds": [ # Requests containing any of these geo criteria ids will match.
704709
"A String",
705710
],
@@ -726,6 +731,9 @@ <h3>Method Details</h3>
726731
"userLists": [ # Requests containing any of these user list ids will match.
727732
"A String",
728733
],
734+
"creativeType": [ # List must contain exactly one of PRETARGETING_CREATIVE_TYPE_HTML or PRETARGETING_CREATIVE_TYPE_VIDEO.
735+
"A String",
736+
],
729737
"placements": [ # Requests containing any of these placements will match.
730738
{
731739
"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.
Lines changed: 126 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,126 @@
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="adexchangeseller_v2_0.html">Ad Exchange Seller API</a> . <a href="adexchangeseller_v2_0.accounts.html">accounts</a> . <a href="adexchangeseller_v2_0.accounts.adclients.html">adclients</a></h1>
76+
<h2>Instance Methods</h2>
77+
<p class="toc_element">
78+
<code><a href="#list">list(accountId, pageToken=None, maxResults=None)</a></code></p>
79+
<p class="firstline">List all ad clients in this Ad Exchange account.</p>
80+
<p class="toc_element">
81+
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
82+
<p class="firstline">Retrieves the next page of results.</p>
83+
<h3>Method Details</h3>
84+
<div class="method">
85+
<code class="details" id="list">list(accountId, pageToken=None, maxResults=None)</code>
86+
<pre>List all ad clients in this Ad Exchange account.
87+
88+
Args:
89+
accountId: string, Account to which the ad client belongs. (required)
90+
pageToken: string, A continuation token, used to page through ad clients. To retrieve the next page, set this parameter to the value of "nextPageToken" from the previous response.
91+
maxResults: integer, The maximum number of ad clients to include in the response, used for paging.
92+
93+
Returns:
94+
An object of the form:
95+
96+
{
97+
"nextPageToken": "A String", # Continuation token used to page through ad clients. To retrieve the next page of results, set the next request's "pageToken" value to this.
98+
"items": [ # The ad clients returned in this list response.
99+
{
100+
"productCode": "A String", # This ad client's product code, which corresponds to the PRODUCT_CODE report dimension.
101+
"kind": "adexchangeseller#adClient", # Kind of resource this is, in this case adexchangeseller#adClient.
102+
"id": "A String", # Unique identifier of this ad client.
103+
"arcOptIn": True or False, # Whether this ad client is opted in to ARC.
104+
"supportsReporting": True or False, # Whether this ad client supports being reported on.
105+
},
106+
],
107+
"kind": "adexchangeseller#adClients", # Kind of list this is, in this case adexchangeseller#adClients.
108+
"etag": "A String", # ETag of this response for caching purposes.
109+
}</pre>
110+
</div>
111+
112+
<div class="method">
113+
<code class="details" id="list_next">list_next(previous_request, previous_response)</code>
114+
<pre>Retrieves the next page of results.
115+
116+
Args:
117+
previous_request: The request for the previous page. (required)
118+
previous_response: The response from the request for the previous page. (required)
119+
120+
Returns:
121+
A request object that you can call 'execute()' on to request the next
122+
page. Returns None if there are no more items in the collection.
123+
</pre>
124+
</div>
125+
126+
</body></html>

0 commit comments

Comments
 (0)