blob: 3cf882e2e89ea637c5051eeaa0bcc8e46933f592 [file] [log] [blame]
Bu Sun Kim65020912020-05-20 12:08:20 -07001<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="dfareporting_v3_4.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v3_4.orders.html">orders</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78 <code><a href="#get">get(profileId, projectId, id)</a></code></p>
79<p class="firstline">Gets one order by ID.</p>
80<p class="toc_element">
81 <code><a href="#list">list(profileId, projectId, ids=None, maxResults=None, pageToken=None, searchString=None, siteId=None, sortField=None, sortOrder=None)</a></code></p>
82<p class="firstline">Retrieves a list of orders, possibly filtered. This method supports paging.</p>
83<p class="toc_element">
84 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
85<p class="firstline">Retrieves the next page of results.</p>
86<h3>Method Details</h3>
87<div class="method">
88 <code class="details" id="get">get(profileId, projectId, id)</code>
89 <pre>Gets one order by ID.
90
91Args:
92 profileId: string, User profile ID associated with this request. (required)
93 projectId: string, Project ID for orders. (required)
94 id: string, Order ID. (required)
95
96Returns:
97 An object of the form:
98
99 { # Describes properties of a Planning order.
100 &quot;accountId&quot;: &quot;A String&quot;, # Account ID of this order.
101 &quot;advertiserId&quot;: &quot;A String&quot;, # Advertiser ID of this order.
102 &quot;approverUserProfileIds&quot;: [ # IDs for users that have to approve documents created for this order.
103 &quot;A String&quot;,
104 ],
105 &quot;buyerInvoiceId&quot;: &quot;A String&quot;, # Buyer invoice ID associated with this order.
106 &quot;buyerOrganizationName&quot;: &quot;A String&quot;, # Name of the buyer organization.
107 &quot;comments&quot;: &quot;A String&quot;, # Comments in this order.
108 &quot;contacts&quot;: [ # Contacts for this order.
109 { # Contact of an order.
110 &quot;contactInfo&quot;: &quot;A String&quot;, # Free-form information about this contact. It could be any information related to this contact in addition to type, title, name, and signature user profile ID.
111 &quot;contactName&quot;: &quot;A String&quot;, # Name of this contact.
112 &quot;contactTitle&quot;: &quot;A String&quot;, # Title of this contact.
113 &quot;contactType&quot;: &quot;A String&quot;, # Type of this contact.
114 &quot;signatureUserProfileId&quot;: &quot;A String&quot;, # ID of the user profile containing the signature that will be embedded into order documents.
115 },
116 ],
117 &quot;id&quot;: &quot;A String&quot;, # ID of this order. This is a read-only, auto-generated field.
118 &quot;kind&quot;: &quot;dfareporting#order&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;dfareporting#order&quot;.
119 &quot;lastModifiedInfo&quot;: { # Modification timestamp. # Information about the most recent modification of this order.
120 &quot;time&quot;: &quot;A String&quot;, # Timestamp of the last change in milliseconds since epoch.
121 },
122 &quot;name&quot;: &quot;A String&quot;, # Name of this order.
123 &quot;notes&quot;: &quot;A String&quot;, # Notes of this order.
124 &quot;planningTermId&quot;: &quot;A String&quot;, # ID of the terms and conditions template used in this order.
125 &quot;projectId&quot;: &quot;A String&quot;, # Project ID of this order.
126 &quot;sellerOrderId&quot;: &quot;A String&quot;, # Seller order ID associated with this order.
127 &quot;sellerOrganizationName&quot;: &quot;A String&quot;, # Name of the seller organization.
128 &quot;siteId&quot;: [ # Site IDs this order is associated with.
129 &quot;A String&quot;,
130 ],
131 &quot;siteNames&quot;: [ # Free-form site names this order is associated with.
132 &quot;A String&quot;,
133 ],
134 &quot;subaccountId&quot;: &quot;A String&quot;, # Subaccount ID of this order.
135 &quot;termsAndConditions&quot;: &quot;A String&quot;, # Terms and conditions of this order.
136 }</pre>
137</div>
138
139<div class="method">
140 <code class="details" id="list">list(profileId, projectId, ids=None, maxResults=None, pageToken=None, searchString=None, siteId=None, sortField=None, sortOrder=None)</code>
141 <pre>Retrieves a list of orders, possibly filtered. This method supports paging.
142
143Args:
144 profileId: string, User profile ID associated with this request. (required)
145 projectId: string, Project ID for orders. (required)
146 ids: string, Select only orders with these IDs. (repeated)
147 maxResults: integer, Maximum number of results to return.
148 pageToken: string, Value of the nextPageToken from the previous result page.
149 searchString: string, Allows searching for orders by name or ID. Wildcards (*) are allowed. For example, &quot;order*2015&quot; will return orders with names like &quot;order June 2015&quot;, &quot;order April 2015&quot;, or simply &quot;order 2015&quot;. Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of &quot;order&quot; will match orders with name &quot;my order&quot;, &quot;order 2015&quot;, or simply &quot;order&quot;.
150 siteId: string, Select only orders that are associated with these site IDs. (repeated)
151 sortField: string, Field by which to sort the list.
152 Allowed values
153 ID -
154 NAME -
155 sortOrder: string, Order of sorted results.
156 Allowed values
157 ASCENDING -
158 DESCENDING -
159
160Returns:
161 An object of the form:
162
163 { # Order List Response
164 &quot;kind&quot;: &quot;dfareporting#ordersListResponse&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;dfareporting#ordersListResponse&quot;.
165 &quot;nextPageToken&quot;: &quot;A String&quot;, # Pagination token to be used for the next list operation.
166 &quot;orders&quot;: [ # Order collection.
167 { # Describes properties of a Planning order.
168 &quot;accountId&quot;: &quot;A String&quot;, # Account ID of this order.
169 &quot;advertiserId&quot;: &quot;A String&quot;, # Advertiser ID of this order.
170 &quot;approverUserProfileIds&quot;: [ # IDs for users that have to approve documents created for this order.
171 &quot;A String&quot;,
172 ],
173 &quot;buyerInvoiceId&quot;: &quot;A String&quot;, # Buyer invoice ID associated with this order.
174 &quot;buyerOrganizationName&quot;: &quot;A String&quot;, # Name of the buyer organization.
175 &quot;comments&quot;: &quot;A String&quot;, # Comments in this order.
176 &quot;contacts&quot;: [ # Contacts for this order.
177 { # Contact of an order.
178 &quot;contactInfo&quot;: &quot;A String&quot;, # Free-form information about this contact. It could be any information related to this contact in addition to type, title, name, and signature user profile ID.
179 &quot;contactName&quot;: &quot;A String&quot;, # Name of this contact.
180 &quot;contactTitle&quot;: &quot;A String&quot;, # Title of this contact.
181 &quot;contactType&quot;: &quot;A String&quot;, # Type of this contact.
182 &quot;signatureUserProfileId&quot;: &quot;A String&quot;, # ID of the user profile containing the signature that will be embedded into order documents.
183 },
184 ],
185 &quot;id&quot;: &quot;A String&quot;, # ID of this order. This is a read-only, auto-generated field.
186 &quot;kind&quot;: &quot;dfareporting#order&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;dfareporting#order&quot;.
187 &quot;lastModifiedInfo&quot;: { # Modification timestamp. # Information about the most recent modification of this order.
188 &quot;time&quot;: &quot;A String&quot;, # Timestamp of the last change in milliseconds since epoch.
189 },
190 &quot;name&quot;: &quot;A String&quot;, # Name of this order.
191 &quot;notes&quot;: &quot;A String&quot;, # Notes of this order.
192 &quot;planningTermId&quot;: &quot;A String&quot;, # ID of the terms and conditions template used in this order.
193 &quot;projectId&quot;: &quot;A String&quot;, # Project ID of this order.
194 &quot;sellerOrderId&quot;: &quot;A String&quot;, # Seller order ID associated with this order.
195 &quot;sellerOrganizationName&quot;: &quot;A String&quot;, # Name of the seller organization.
196 &quot;siteId&quot;: [ # Site IDs this order is associated with.
197 &quot;A String&quot;,
198 ],
199 &quot;siteNames&quot;: [ # Free-form site names this order is associated with.
200 &quot;A String&quot;,
201 ],
202 &quot;subaccountId&quot;: &quot;A String&quot;, # Subaccount ID of this order.
203 &quot;termsAndConditions&quot;: &quot;A String&quot;, # Terms and conditions of this order.
204 },
205 ],
206 }</pre>
207</div>
208
209<div class="method">
210 <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
211 <pre>Retrieves the next page of results.
212
213Args:
214 previous_request: The request for the previous page. (required)
215 previous_response: The response from the request for the previous page. (required)
216
217Returns:
218 A request object that you can call &#x27;execute()&#x27; on to request the next
219 page. Returns None if there are no more items in the collection.
220 </pre>
221</div>
222
223</body></html>