• 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="dfareporting_v3_2.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v3_2.orderDocuments.html">orderDocuments</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 document by ID.</p>
80<p class="toc_element">
81  <code><a href="#list">list(profileId, projectId, pageToken=None, sortOrder=None, orderId=None, maxResults=None, siteId=None, approved=None, searchString=None, sortField=None, ids=None)</a></code></p>
82<p class="firstline">Retrieves a list of order documents, 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 document by ID.
90
91Args:
92  profileId: string, User profile ID associated with this request. (required)
93  projectId: string, Project ID for order documents. (required)
94  id: string, Order document ID. (required)
95
96Returns:
97  An object of the form:
98
99    { # Contains properties of a Planning order document.
100    "orderId": "A String", # ID of the order from which this order document is created.
101    "approvedByUserProfileIds": [ # IDs of users who have approved this order document.
102      "A String",
103    ],
104    "kind": "dfareporting#orderDocument", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#orderDocument".
105    "subaccountId": "A String", # Subaccount ID of this order document.
106    "effectiveDate": "A String", # Effective date of this order document.
107    "lastSentTime": "A String", # Timestamp of the last email sent with this order document.
108    "lastSentRecipients": [ # List of email addresses that received the last sent document.
109      "A String",
110    ],
111    "title": "A String", # Title of this order document.
112    "amendedOrderDocumentId": "A String", # The amended order document ID of this order document. An order document can be created by optionally amending another order document so that the change history can be preserved.
113    "signed": True or False, # Whether this order document has been signed.
114    "createdInfo": { # Modification timestamp. # Information about the creation of this order document.
115      "time": "A String", # Timestamp of the last change in milliseconds since epoch.
116    },
117    "advertiserId": "A String", # Advertiser ID of this order document.
118    "projectId": "A String", # Project ID of this order document.
119    "cancelled": True or False, # Whether this order document is cancelled.
120    "type": "A String", # Type of this order document
121    "id": "A String", # ID of this order document.
122    "accountId": "A String", # Account ID of this order document.
123  }</pre>
124</div>
125
126<div class="method">
127    <code class="details" id="list">list(profileId, projectId, pageToken=None, sortOrder=None, orderId=None, maxResults=None, siteId=None, approved=None, searchString=None, sortField=None, ids=None)</code>
128  <pre>Retrieves a list of order documents, possibly filtered. This method supports paging.
129
130Args:
131  profileId: string, User profile ID associated with this request. (required)
132  projectId: string, Project ID for order documents. (required)
133  pageToken: string, Value of the nextPageToken from the previous result page.
134  sortOrder: string, Order of sorted results.
135    Allowed values
136      ASCENDING -
137      DESCENDING -
138  orderId: string, Select only order documents for specified orders. (repeated)
139  maxResults: integer, Maximum number of results to return.
140  siteId: string, Select only order documents that are associated with these sites. (repeated)
141  approved: boolean, Select only order documents that have been approved by at least one user.
142  searchString: string, Allows searching for order documents by name or ID. Wildcards (*) are allowed. For example, "orderdocument*2015" will return order documents with names like "orderdocument June 2015", "orderdocument April 2015", or simply "orderdocument 2015". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of "orderdocument" will match order documents with name "my orderdocument", "orderdocument 2015", or simply "orderdocument".
143  sortField: string, Field by which to sort the list.
144    Allowed values
145      ID -
146      NAME -
147  ids: string, Select only order documents with these IDs. (repeated)
148
149Returns:
150  An object of the form:
151
152    { # Order document List Response
153    "nextPageToken": "A String", # Pagination token to be used for the next list operation.
154    "kind": "dfareporting#orderDocumentsListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#orderDocumentsListResponse".
155    "orderDocuments": [ # Order document collection
156      { # Contains properties of a Planning order document.
157        "orderId": "A String", # ID of the order from which this order document is created.
158        "approvedByUserProfileIds": [ # IDs of users who have approved this order document.
159          "A String",
160        ],
161        "kind": "dfareporting#orderDocument", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#orderDocument".
162        "subaccountId": "A String", # Subaccount ID of this order document.
163        "effectiveDate": "A String", # Effective date of this order document.
164        "lastSentTime": "A String", # Timestamp of the last email sent with this order document.
165        "lastSentRecipients": [ # List of email addresses that received the last sent document.
166          "A String",
167        ],
168        "title": "A String", # Title of this order document.
169        "amendedOrderDocumentId": "A String", # The amended order document ID of this order document. An order document can be created by optionally amending another order document so that the change history can be preserved.
170        "signed": True or False, # Whether this order document has been signed.
171        "createdInfo": { # Modification timestamp. # Information about the creation of this order document.
172          "time": "A String", # Timestamp of the last change in milliseconds since epoch.
173        },
174        "advertiserId": "A String", # Advertiser ID of this order document.
175        "projectId": "A String", # Project ID of this order document.
176        "cancelled": True or False, # Whether this order document is cancelled.
177        "type": "A String", # Type of this order document
178        "id": "A String", # ID of this order document.
179        "accountId": "A String", # Account ID of this order document.
180      },
181    ],
182  }</pre>
183</div>
184
185<div class="method">
186    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
187  <pre>Retrieves the next page of results.
188
189Args:
190  previous_request: The request for the previous page. (required)
191  previous_response: The response from the request for the previous page. (required)
192
193Returns:
194  A request object that you can call 'execute()' on to request the next
195  page. Returns None if there are no more items in the collection.
196    </pre>
197</div>
198
199</body></html>