Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / google-api-python-client / edf2d2e21acf56ae108d86a712ddc679386a4843 / . / docs / dyn / content_v2.datafeedstatuses.html
blob: 401677b0cf852a18ada86d63bc00cf20c788a39d [file] [log] [blame]
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]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="content_v2.html">Content API for Shopping</a> . <a href="content_v2.datafeedstatuses.html">datafeedstatuses</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]78 <code><a href="#custombatch">custombatch(body)</a></code></p>
79<p class="firstline">A description of how to use this function</p>
80<p class="toc_element">
81 <code><a href="#get">get(merchantId, datafeedId)</a></code></p>
82<p class="firstline">Retrieves the status of a datafeed from your Merchant Center account.</p>
83<p class="toc_element">
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]84 <code><a href="#list">list(merchantId, pageToken=None, maxResults=None)</a></code></p>
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]85<p class="firstline">Lists the statuses of the datafeeds in your Merchant Center account.</p>
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]86<p class="toc_element">
87 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
88<p class="firstline">Retrieves the next page of results.</p>
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]89<h3>Method Details</h3>
90<div class="method">
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]91 <code class="details" id="custombatch">custombatch(body)</code>
92 <pre>A description of how to use this function
93
94Args:
95 body: object, The request body. (required)
96 The object takes the form of:
97
98{
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]99 "entries": [ # The request entries to be processed in the batch.
100 { # A batch entry encoding a single non-batch datafeedstatuses request.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]101 "batchId": 42, # An entry ID, unique within the batch request.
102 "datafeedId": "A String", # The ID of the data feed to get or delete.
103 "merchantId": "A String", # The ID of the managing account.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]104 "method": "A String",
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]105 },
106 ],
107 }
108
109
110Returns:
111 An object of the form:
112
113 {
114 "kind": "content#datafeedstatusesCustomBatchResponse", # Identifies what kind of resource this is. Value: the fixed string "content#datafeedstatusesCustomBatchResponse".
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]115 "entries": [ # The result of the execution of the batch requests.
116 { # A batch entry encoding a single non-batch datafeedstatuses response.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]117 "batchId": 42, # The ID of the request entry this entry responds to.
118 "errors": { # A list of errors returned by a failed batch entry. # A list of errors defined if and only if the request failed.
119 "message": "A String", # The message of the first error in errors.
120 "code": 42, # The HTTP status of the first error in errors.
121 "errors": [ # A list of errors.
122 { # An error returned by the API.
123 "reason": "A String", # The error code.
124 "domain": "A String", # The domain of the error.
125 "message": "A String", # A description of the error.
126 },
127 ],
128 },
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]129 "datafeedStatus": { # The status of a datafeed, i.e., the result of the last retrieval of the datafeed computed asynchronously when the feed processing is finished. # The requested data feed status. Defined if and only if the request was successful.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]130 "kind": "content#datafeedStatus", # Identifies what kind of resource this is. Value: the fixed string "content#datafeedStatus".
131 "errors": [ # The list of errors occurring in the feed.
132 { # An error occurring in the feed, like "invalid price".
Craig Citro0e5b9bf2014-10-15 10:26:14 -0700[diff] [blame]133 "count": "A String", # The number of occurrences of the error in the feed.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]134 "message": "A String", # The error message, e.g., "Invalid price".
135 "code": "A String", # The code of the error, e.g., "validation/invalid_value".
136 "examples": [ # A list of example occurrences of the error, grouped by product.
137 { # An example occurrence for a particular error.
138 "itemId": "A String", # The ID of the example item.
139 "value": "A String", # The problematic value.
Craig Citro0e5b9bf2014-10-15 10:26:14 -0700[diff] [blame]140 "lineNumber": "A String", # Line number in the data feed where the example is found.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]141 },
142 ],
143 },
144 ],
145 "processingStatus": "A String", # The processing status of the feed.
Craig Citro0e5b9bf2014-10-15 10:26:14 -0700[diff] [blame]146 "itemsTotal": "A String", # The number of items in the feed that were processed.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]147 "warnings": [ # The list of errors occurring in the feed.
148 { # An error occurring in the feed, like "invalid price".
Craig Citro0e5b9bf2014-10-15 10:26:14 -0700[diff] [blame]149 "count": "A String", # The number of occurrences of the error in the feed.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]150 "message": "A String", # The error message, e.g., "Invalid price".
151 "code": "A String", # The code of the error, e.g., "validation/invalid_value".
152 "examples": [ # A list of example occurrences of the error, grouped by product.
153 { # An example occurrence for a particular error.
154 "itemId": "A String", # The ID of the example item.
155 "value": "A String", # The problematic value.
Craig Citro0e5b9bf2014-10-15 10:26:14 -0700[diff] [blame]156 "lineNumber": "A String", # Line number in the data feed where the example is found.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]157 },
158 ],
159 },
160 ],
Craig Citro0e5b9bf2014-10-15 10:26:14 -0700[diff] [blame]161 "itemsValid": "A String", # The number of items in the feed that were valid.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]162 "datafeedId": "A String", # The ID of the feed for which the status is reported.
163 },
164 },
165 ],
166 }</pre>
167</div>
168
169<div class="method">
170 <code class="details" id="get">get(merchantId, datafeedId)</code>
171 <pre>Retrieves the status of a datafeed from your Merchant Center account.
172
173Args:
174 merchantId: string, A parameter (required)
175 datafeedId: string, A parameter (required)
176
177Returns:
178 An object of the form:
179
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]180 { # The status of a datafeed, i.e., the result of the last retrieval of the datafeed computed asynchronously when the feed processing is finished.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]181 "kind": "content#datafeedStatus", # Identifies what kind of resource this is. Value: the fixed string "content#datafeedStatus".
182 "errors": [ # The list of errors occurring in the feed.
183 { # An error occurring in the feed, like "invalid price".
Craig Citro0e5b9bf2014-10-15 10:26:14 -0700[diff] [blame]184 "count": "A String", # The number of occurrences of the error in the feed.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]185 "message": "A String", # The error message, e.g., "Invalid price".
186 "code": "A String", # The code of the error, e.g., "validation/invalid_value".
187 "examples": [ # A list of example occurrences of the error, grouped by product.
188 { # An example occurrence for a particular error.
189 "itemId": "A String", # The ID of the example item.
190 "value": "A String", # The problematic value.
Craig Citro0e5b9bf2014-10-15 10:26:14 -0700[diff] [blame]191 "lineNumber": "A String", # Line number in the data feed where the example is found.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]192 },
193 ],
194 },
195 ],
196 "processingStatus": "A String", # The processing status of the feed.
Craig Citro0e5b9bf2014-10-15 10:26:14 -0700[diff] [blame]197 "itemsTotal": "A String", # The number of items in the feed that were processed.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]198 "warnings": [ # The list of errors occurring in the feed.
199 { # An error occurring in the feed, like "invalid price".
Craig Citro0e5b9bf2014-10-15 10:26:14 -0700[diff] [blame]200 "count": "A String", # The number of occurrences of the error in the feed.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]201 "message": "A String", # The error message, e.g., "Invalid price".
202 "code": "A String", # The code of the error, e.g., "validation/invalid_value".
203 "examples": [ # A list of example occurrences of the error, grouped by product.
204 { # An example occurrence for a particular error.
205 "itemId": "A String", # The ID of the example item.
206 "value": "A String", # The problematic value.
Craig Citro0e5b9bf2014-10-15 10:26:14 -0700[diff] [blame]207 "lineNumber": "A String", # Line number in the data feed where the example is found.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]208 },
209 ],
210 },
211 ],
Craig Citro0e5b9bf2014-10-15 10:26:14 -0700[diff] [blame]212 "itemsValid": "A String", # The number of items in the feed that were valid.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]213 "datafeedId": "A String", # The ID of the feed for which the status is reported.
214 }</pre>
215</div>
216
217<div class="method">
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]218 <code class="details" id="list">list(merchantId, pageToken=None, maxResults=None)</code>
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]219 <pre>Lists the statuses of the datafeeds in your Merchant Center account.
220
221Args:
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]222 merchantId: string, The ID of the managing account. (required)
223 pageToken: string, The token returned by the previous request.
224 maxResults: integer, The maximum number of products to return in the response, used for paging.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]225
226Returns:
227 An object of the form:
228
229 {
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]230 "nextPageToken": "A String", # The token for the retrieval of the next page of datafeed statuses.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]231 "kind": "content#datafeedstatusesListResponse", # Identifies what kind of resource this is. Value: the fixed string "content#datafeedstatusesListResponse".
232 "resources": [
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]233 { # The status of a datafeed, i.e., the result of the last retrieval of the datafeed computed asynchronously when the feed processing is finished.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]234 "kind": "content#datafeedStatus", # Identifies what kind of resource this is. Value: the fixed string "content#datafeedStatus".
235 "errors": [ # The list of errors occurring in the feed.
236 { # An error occurring in the feed, like "invalid price".
Craig Citro0e5b9bf2014-10-15 10:26:14 -0700[diff] [blame]237 "count": "A String", # The number of occurrences of the error in the feed.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]238 "message": "A String", # The error message, e.g., "Invalid price".
239 "code": "A String", # The code of the error, e.g., "validation/invalid_value".
240 "examples": [ # A list of example occurrences of the error, grouped by product.
241 { # An example occurrence for a particular error.
242 "itemId": "A String", # The ID of the example item.
243 "value": "A String", # The problematic value.
Craig Citro0e5b9bf2014-10-15 10:26:14 -0700[diff] [blame]244 "lineNumber": "A String", # Line number in the data feed where the example is found.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]245 },
246 ],
247 },
248 ],
249 "processingStatus": "A String", # The processing status of the feed.
Craig Citro0e5b9bf2014-10-15 10:26:14 -0700[diff] [blame]250 "itemsTotal": "A String", # The number of items in the feed that were processed.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]251 "warnings": [ # The list of errors occurring in the feed.
252 { # An error occurring in the feed, like "invalid price".
Craig Citro0e5b9bf2014-10-15 10:26:14 -0700[diff] [blame]253 "count": "A String", # The number of occurrences of the error in the feed.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]254 "message": "A String", # The error message, e.g., "Invalid price".
255 "code": "A String", # The code of the error, e.g., "validation/invalid_value".
256 "examples": [ # A list of example occurrences of the error, grouped by product.
257 { # An example occurrence for a particular error.
258 "itemId": "A String", # The ID of the example item.
259 "value": "A String", # The problematic value.
Craig Citro0e5b9bf2014-10-15 10:26:14 -0700[diff] [blame]260 "lineNumber": "A String", # Line number in the data feed where the example is found.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]261 },
262 ],
263 },
264 ],
Craig Citro0e5b9bf2014-10-15 10:26:14 -0700[diff] [blame]265 "itemsValid": "A String", # The number of items in the feed that were valid.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]266 "datafeedId": "A String", # The ID of the feed for which the status is reported.
267 },
268 ],
269 }</pre>
270</div>
271
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]272<div class="method">
273 <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
274 <pre>Retrieves the next page of results.
275
276Args:
277 previous_request: The request for the previous page. (required)
278 previous_response: The response from the request for the previous page. (required)
279
280Returns:
281 A request object that you can call 'execute()' on to request the next
282 page. Returns None if there are no more items in the collection.
283 </pre>
284</div>
285
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]286</body></html>