| Index: third_party/gsutil/boto/boto/mws/connection.py
|
| diff --git a/third_party/gsutil/boto/boto/mws/connection.py b/third_party/gsutil/boto/boto/mws/connection.py
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..db58e6d74453dd00abb36264a03a27bbc1cb90cb
|
| --- /dev/null
|
| +++ b/third_party/gsutil/boto/boto/mws/connection.py
|
| @@ -0,0 +1,813 @@
|
| +# Copyright (c) 2012 Andy Davidoff http://www.disruptek.com/
|
| +#
|
| +# Permission is hereby granted, free of charge, to any person obtaining a
|
| +# copy of this software and associated documentation files (the
|
| +# "Software"), to deal in the Software without restriction, including
|
| +# without limitation the rights to use, copy, modify, merge, publish, dis-
|
| +# tribute, sublicense, and/or sell copies of the Software, and to permit
|
| +# persons to whom the Software is furnished to do so, subject to the fol-
|
| +# lowing conditions:
|
| +#
|
| +# The above copyright notice and this permission notice shall be included
|
| +# in all copies or substantial portions of the Software.
|
| +#
|
| +# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
|
| +# OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABIL-
|
| +# ITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT
|
| +# SHALL THE AUTHOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
|
| +# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
| +# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
|
| +# IN THE SOFTWARE.
|
| +import xml.sax
|
| +import hashlib
|
| +import base64
|
| +import string
|
| +from boto.connection import AWSQueryConnection
|
| +from boto.mws.exception import ResponseErrorFactory
|
| +from boto.mws.response import ResponseFactory, ResponseElement
|
| +from boto.handler import XmlHandler
|
| +import boto.mws.response
|
| +
|
| +__all__ = ['MWSConnection']
|
| +
|
| +api_version_path = {
|
| + 'Feeds': ('2009-01-01', 'Merchant', '/'),
|
| + 'Reports': ('2009-01-01', 'Merchant', '/'),
|
| + 'Orders': ('2011-01-01', 'SellerId', '/Orders/2011-01-01'),
|
| + 'Products': ('2011-10-01', 'SellerId', '/Products/2011-10-01'),
|
| + 'Sellers': ('2011-07-01', 'SellerId', '/Sellers/2011-07-01'),
|
| + 'Inbound': ('2010-10-01', 'SellerId',
|
| + '/FulfillmentInboundShipment/2010-10-01'),
|
| + 'Outbound': ('2010-10-01', 'SellerId',
|
| + '/FulfillmentOutboundShipment/2010-10-01'),
|
| + 'Inventory': ('2010-10-01', 'SellerId',
|
| + '/FulfillmentInventory/2010-10-01'),
|
| +}
|
| +content_md5 = lambda c: base64.encodestring(hashlib.md5(c).digest()).strip()
|
| +decorated_attrs = ('action', 'response', 'section',
|
| + 'quota', 'restore', 'version')
|
| +
|
| +
|
| +def add_attrs_from(func, to):
|
| + for attr in decorated_attrs:
|
| + setattr(to, attr, getattr(func, attr, None))
|
| + return to
|
| +
|
| +
|
| +def structured_lists(*fields):
|
| +
|
| + def decorator(func):
|
| +
|
| + def wrapper(self, *args, **kw):
|
| + for key, acc in [f.split('.') for f in fields]:
|
| + if key in kw:
|
| + newkey = key + '.' + acc + (acc and '.' or '')
|
| + for i in range(len(kw[key])):
|
| + kw[newkey + str(i + 1)] = kw[key][i]
|
| + kw.pop(key)
|
| + return func(self, *args, **kw)
|
| + wrapper.__doc__ = "{0}\nLists: {1}".format(func.__doc__,
|
| + ', '.join(fields))
|
| + return add_attrs_from(func, to=wrapper)
|
| + return decorator
|
| +
|
| +
|
| +def http_body(field):
|
| +
|
| + def decorator(func):
|
| +
|
| + def wrapper(*args, **kw):
|
| + if filter(lambda x: not x in kw, (field, 'content_type')):
|
| + message = "{0} requires {1} and content_type arguments for " \
|
| + "building HTTP body".format(func.action, field)
|
| + raise KeyError(message)
|
| + kw['body'] = kw.pop(field)
|
| + kw['headers'] = {
|
| + 'Content-Type': kw.pop('content_type'),
|
| + 'Content-MD5': content_md5(kw['body']),
|
| + }
|
| + return func(*args, **kw)
|
| + wrapper.__doc__ = "{0}\nRequired HTTP Body: " \
|
| + "{1}".format(func.__doc__, field)
|
| + return add_attrs_from(func, to=wrapper)
|
| + return decorator
|
| +
|
| +
|
| +def destructure_object(value, into={}, prefix=''):
|
| + if isinstance(value, ResponseElement):
|
| + for name, attr in value.__dict__.items():
|
| + if name.startswith('_'):
|
| + continue
|
| + destructure_object(attr, into=into, prefix=prefix + '.' + name)
|
| + elif filter(lambda x: isinstance(value, x), (list, set, tuple)):
|
| + for index, element in [(prefix + '.' + str(i + 1), value[i])
|
| + for i in range(len(value))]:
|
| + destructure_object(element, into=into, prefix=index)
|
| + elif isinstance(value, bool):
|
| + into[prefix] = str(value).lower()
|
| + else:
|
| + into[prefix] = value
|
| +
|
| +
|
| +def structured_objects(*fields):
|
| +
|
| + def decorator(func):
|
| +
|
| + def wrapper(*args, **kw):
|
| + for field in filter(kw.has_key, fields):
|
| + destructure_object(kw.pop(field), into=kw, prefix=field)
|
| + return func(*args, **kw)
|
| + wrapper.__doc__ = "{0}\nObjects: {1}".format(func.__doc__,
|
| + ', '.join(fields))
|
| + return add_attrs_from(func, to=wrapper)
|
| + return decorator
|
| +
|
| +
|
| +def requires(*groups):
|
| +
|
| + def decorator(func):
|
| +
|
| + def wrapper(*args, **kw):
|
| + hasgroup = lambda x: len(x) == len(filter(kw.has_key, x))
|
| + if 1 != len(filter(hasgroup, groups)):
|
| + message = ' OR '.join(['+'.join(g) for g in groups])
|
| + message = "{0} requires {1} argument(s)" \
|
| + "".format(func.action, message)
|
| + raise KeyError(message)
|
| + return func(*args, **kw)
|
| + message = ' OR '.join(['+'.join(g) for g in groups])
|
| + wrapper.__doc__ = "{0}\nRequired: {1}".format(func.__doc__,
|
| + message)
|
| + return add_attrs_from(func, to=wrapper)
|
| + return decorator
|
| +
|
| +
|
| +def exclusive(*groups):
|
| +
|
| + def decorator(func):
|
| +
|
| + def wrapper(*args, **kw):
|
| + hasgroup = lambda x: len(x) == len(filter(kw.has_key, x))
|
| + if len(filter(hasgroup, groups)) not in (0, 1):
|
| + message = ' OR '.join(['+'.join(g) for g in groups])
|
| + message = "{0} requires either {1}" \
|
| + "".format(func.action, message)
|
| + raise KeyError(message)
|
| + return func(*args, **kw)
|
| + message = ' OR '.join(['+'.join(g) for g in groups])
|
| + wrapper.__doc__ = "{0}\nEither: {1}".format(func.__doc__,
|
| + message)
|
| + return add_attrs_from(func, to=wrapper)
|
| + return decorator
|
| +
|
| +
|
| +def dependent(field, *groups):
|
| +
|
| + def decorator(func):
|
| +
|
| + def wrapper(*args, **kw):
|
| + hasgroup = lambda x: len(x) == len(filter(kw.has_key, x))
|
| + if field in kw and 1 > len(filter(hasgroup, groups)):
|
| + message = ' OR '.join(['+'.join(g) for g in groups])
|
| + message = "{0} argument {1} requires {2}" \
|
| + "".format(func.action, field, message)
|
| + raise KeyError(message)
|
| + return func(*args, **kw)
|
| + message = ' OR '.join(['+'.join(g) for g in groups])
|
| + wrapper.__doc__ = "{0}\n{1} requires: {2}".format(func.__doc__,
|
| + field,
|
| + message)
|
| + return add_attrs_from(func, to=wrapper)
|
| + return decorator
|
| +
|
| +
|
| +def requires_some_of(*fields):
|
| +
|
| + def decorator(func):
|
| +
|
| + def wrapper(*args, **kw):
|
| + if not filter(kw.has_key, fields):
|
| + message = "{0} requires at least one of {1} argument(s)" \
|
| + "".format(func.action, ', '.join(fields))
|
| + raise KeyError(message)
|
| + return func(*args, **kw)
|
| + wrapper.__doc__ = "{0}\nSome Required: {1}".format(func.__doc__,
|
| + ', '.join(fields))
|
| + return add_attrs_from(func, to=wrapper)
|
| + return decorator
|
| +
|
| +
|
| +def boolean_arguments(*fields):
|
| +
|
| + def decorator(func):
|
| +
|
| + def wrapper(*args, **kw):
|
| + for field in filter(lambda x: isinstance(kw.get(x), bool), fields):
|
| + kw[field] = str(kw[field]).lower()
|
| + return func(*args, **kw)
|
| + wrapper.__doc__ = "{0}\nBooleans: {1}".format(func.__doc__,
|
| + ', '.join(fields))
|
| + return add_attrs_from(func, to=wrapper)
|
| + return decorator
|
| +
|
| +
|
| +def api_action(section, quota, restore, *api):
|
| +
|
| + def decorator(func, quota=int(quota), restore=float(restore)):
|
| + version, accesskey, path = api_version_path[section]
|
| + action = ''.join(api or map(str.capitalize, func.func_name.split('_')))
|
| + if hasattr(boto.mws.response, action + 'Response'):
|
| + response = getattr(boto.mws.response, action + 'Response')
|
| + else:
|
| + response = ResponseFactory(action)
|
| + response._action = action
|
| +
|
| + def wrapper(self, *args, **kw):
|
| + kw.setdefault(accesskey, getattr(self, accesskey, None))
|
| + if kw[accesskey] is None:
|
| + message = "{0} requires {1} argument. Set the " \
|
| + "MWSConnection.{2} attribute?" \
|
| + "".format(action, accesskey, accesskey)
|
| + raise KeyError(message)
|
| + kw['Action'] = action
|
| + kw['Version'] = version
|
| + return func(self, path, response, *args, **kw)
|
| + for attr in decorated_attrs:
|
| + setattr(wrapper, attr, locals().get(attr))
|
| + wrapper.__doc__ = "MWS {0}/{1} API call; quota={2} restore={3:.2f}\n" \
|
| + "{4}".format(action, version, quota, restore,
|
| + func.__doc__)
|
| + return wrapper
|
| + return decorator
|
| +
|
| +
|
| +class MWSConnection(AWSQueryConnection):
|
| +
|
| + ResponseError = ResponseErrorFactory
|
| +
|
| + def __init__(self, *args, **kw):
|
| + kw.setdefault('host', 'mws.amazonservices.com')
|
| + self.Merchant = kw.pop('Merchant', None) or kw.get('SellerId')
|
| + self.SellerId = kw.pop('SellerId', None) or self.Merchant
|
| + AWSQueryConnection.__init__(self, *args, **kw)
|
| +
|
| + def _required_auth_capability(self):
|
| + return ['mws']
|
| +
|
| + def post_request(self, path, params, cls, body='', headers={}, isXML=True):
|
| + """Make a POST request, optionally with a content body,
|
| + and return the response, optionally as raw text.
|
| + Modelled off of the inherited get_object/make_request flow.
|
| + """
|
| + request = self.build_base_http_request('POST', path, None, data=body,
|
| + params=params, headers=headers, host=self.server_name())
|
| + response = self._mexe(request, override_num_retries=None)
|
| + body = response.read()
|
| + boto.log.debug(body)
|
| + if not body:
|
| + boto.log.error('Null body %s' % body)
|
| + raise self.ResponseError(response.status, response.reason, body)
|
| + if response.status != 200:
|
| + boto.log.error('%s %s' % (response.status, response.reason))
|
| + boto.log.error('%s' % body)
|
| + raise self.ResponseError(response.status, response.reason, body)
|
| + if not isXML:
|
| + digest = response.getheader('Content-MD5')
|
| + assert content_md5(body) == digest
|
| + return body
|
| + obj = cls(self)
|
| + h = XmlHandler(obj, self)
|
| + xml.sax.parseString(body, h)
|
| + return obj
|
| +
|
| + def method_for(self, name):
|
| + """Return the MWS API method referred to in the argument.
|
| + The named method can be in CamelCase or underlined_lower_case.
|
| + This is the complement to MWSConnection.any_call.action
|
| + """
|
| + # this looks ridiculous but it should be better than regex
|
| + action = '_' in name and string.capwords(name, '_') or name
|
| + attribs = [getattr(self, m) for m in dir(self)]
|
| + ismethod = lambda m: type(m) is type(self.method_for)
|
| + ismatch = lambda m: getattr(m, 'action', None) == action
|
| + method = filter(ismatch, filter(ismethod, attribs))
|
| + return method and method[0] or None
|
| +
|
| + def iter_call(self, call, *args, **kw):
|
| + """Pass a call name as the first argument and a generator
|
| + is returned for the initial response and any continuation
|
| + call responses made using the NextToken.
|
| + """
|
| + method = self.method_for(call)
|
| + assert method, 'No call named "{0}"'.format(call)
|
| + return self.iter_response(method(*args, **kw))
|
| +
|
| + def iter_response(self, response):
|
| + """Pass a call's response as the initial argument and a
|
| + generator is returned for the initial response and any
|
| + continuation call responses made using the NextToken.
|
| + """
|
| + yield response
|
| + more = self.method_for(response._action + 'ByNextToken')
|
| + while more and response._result.HasNext == 'true':
|
| + response = more(NextToken=response._result.NextToken)
|
| + yield response
|
| +
|
| + @boolean_arguments('PurgeAndReplace')
|
| + @http_body('FeedContent')
|
| + @structured_lists('MarketplaceIdList.Id')
|
| + @requires(['FeedType'])
|
| + @api_action('Feeds', 15, 120)
|
| + def submit_feed(self, path, response, headers={}, body='', **kw):
|
| + """Uploads a feed for processing by Amazon MWS.
|
| + """
|
| + return self.post_request(path, kw, response, body=body,
|
| + headers=headers)
|
| +
|
| + @structured_lists('FeedSubmissionIdList.Id', 'FeedTypeList.Type',
|
| + 'FeedProcessingStatusList.Status')
|
| + @api_action('Feeds', 10, 45)
|
| + def get_feed_submission_list(self, path, response, **kw):
|
| + """Returns a list of all feed submissions submitted in the
|
| + previous 90 days.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @requires(['NextToken'])
|
| + @api_action('Feeds', 0, 0)
|
| + def get_feed_submission_list_by_next_token(self, path, response, **kw):
|
| + """Returns a list of feed submissions using the NextToken parameter.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @structured_lists('FeedTypeList.Type', 'FeedProcessingStatusList.Status')
|
| + @api_action('Feeds', 10, 45)
|
| + def get_feed_submission_count(self, path, response, **kw):
|
| + """Returns a count of the feeds submitted in the previous 90 days.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @structured_lists('FeedSubmissionIdList.Id', 'FeedTypeList.Type')
|
| + @api_action('Feeds', 10, 45)
|
| + def cancel_feed_submissions(self, path, response, **kw):
|
| + """Cancels one or more feed submissions and returns a
|
| + count of the feed submissions that were canceled.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @requires(['FeedSubmissionId'])
|
| + @api_action('Feeds', 15, 60)
|
| + def get_feed_submission_result(self, path, response, **kw):
|
| + """Returns the feed processing report.
|
| + """
|
| + return self.post_request(path, kw, response, isXML=False)
|
| +
|
| + def get_service_status(self, **kw):
|
| + """Instruct the user on how to get service status.
|
| + """
|
| + message = "Use {0}.get_(section)_service_status(), " \
|
| + "where (section) is one of the following: " \
|
| + "{1}".format(self.__class__.__name__,
|
| + ', '.join(map(str.lower, api_version_path.keys())))
|
| + raise AttributeError(message)
|
| +
|
| + @structured_lists('MarketplaceIdList.Id')
|
| + @boolean_arguments('ReportOptions=ShowSalesChannel')
|
| + @requires(['ReportType'])
|
| + @api_action('Reports', 15, 60)
|
| + def request_report(self, path, response, **kw):
|
| + """Creates a report request and submits the request to Amazon MWS.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @structured_lists('ReportRequestIdList.Id', 'ReportTypeList.Type',
|
| + 'ReportProcessingStatusList.Status')
|
| + @api_action('Reports', 10, 45)
|
| + def get_report_request_list(self, path, response, **kw):
|
| + """Returns a list of report requests that you can use to get the
|
| + ReportRequestId for a report.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @requires(['NextToken'])
|
| + @api_action('Reports', 0, 0)
|
| + def get_report_request_list_by_next_token(self, path, response, **kw):
|
| + """Returns a list of report requests using the NextToken,
|
| + which was supplied by a previous request to either
|
| + GetReportRequestListByNextToken or GetReportRequestList, where
|
| + the value of HasNext was true in that previous request.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @structured_lists('ReportTypeList.Type',
|
| + 'ReportProcessingStatusList.Status')
|
| + @api_action('Reports', 10, 45)
|
| + def get_report_request_count(self, path, response, **kw):
|
| + """Returns a count of report requests that have been submitted
|
| + to Amazon MWS for processing.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @api_action('Reports', 10, 45)
|
| + def cancel_report_requests(self, path, response, **kw):
|
| + """Cancel one or more report requests, returning the count of the
|
| + canceled report requests and the report request information.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @boolean_arguments('Acknowledged')
|
| + @structured_lists('ReportRequestIdList.Id', 'ReportTypeList.Type')
|
| + @api_action('Reports', 10, 60)
|
| + def get_report_list(self, path, response, **kw):
|
| + """Returns a list of reports that were created in the previous
|
| + 90 days that match the query parameters.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @requires(['NextToken'])
|
| + @api_action('Reports', 0, 0)
|
| + def get_report_list_by_next_token(self, path, response, **kw):
|
| + """Returns a list of reports using the NextToken, which
|
| + was supplied by a previous request to either
|
| + GetReportListByNextToken or GetReportList, where the
|
| + value of HasNext was true in the previous call.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @boolean_arguments('Acknowledged')
|
| + @structured_lists('ReportTypeList.Type')
|
| + @api_action('Reports', 10, 45)
|
| + def get_report_count(self, path, response, **kw):
|
| + """Returns a count of the reports, created in the previous 90 days,
|
| + with a status of _DONE_ and that are available for download.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @requires(['ReportId'])
|
| + @api_action('Reports', 15, 60)
|
| + def get_report(self, path, response, **kw):
|
| + """Returns the contents of a report.
|
| + """
|
| + return self.post_request(path, kw, response, isXML=False)
|
| +
|
| + @requires(['ReportType', 'Schedule'])
|
| + @api_action('Reports', 10, 45)
|
| + def manage_report_schedule(self, path, response, **kw):
|
| + """Creates, updates, or deletes a report request schedule for
|
| + a specified report type.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @structured_lists('ReportTypeList.Type')
|
| + @api_action('Reports', 10, 45)
|
| + def get_report_schedule_list(self, path, response, **kw):
|
| + """Returns a list of order report requests that are scheduled
|
| + to be submitted to Amazon MWS for processing.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @requires(['NextToken'])
|
| + @api_action('Reports', 0, 0)
|
| + def get_report_schedule_list_by_next_token(self, path, response, **kw):
|
| + """Returns a list of report requests using the NextToken,
|
| + which was supplied by a previous request to either
|
| + GetReportScheduleListByNextToken or GetReportScheduleList,
|
| + where the value of HasNext was true in that previous request.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @structured_lists('ReportTypeList.Type')
|
| + @api_action('Reports', 10, 45)
|
| + def get_report_schedule_count(self, path, response, **kw):
|
| + """Returns a count of order report requests that are scheduled
|
| + to be submitted to Amazon MWS.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @boolean_arguments('Acknowledged')
|
| + @requires(['ReportIdList'])
|
| + @structured_lists('ReportIdList.Id')
|
| + @api_action('Reports', 10, 45)
|
| + def update_report_acknowledgements(self, path, response, **kw):
|
| + """Updates the acknowledged status of one or more reports.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @requires(['ShipFromAddress', 'InboundShipmentPlanRequestItems'])
|
| + @structured_objects('ShipFromAddress', 'InboundShipmentPlanRequestItems')
|
| + @api_action('Inbound', 30, 0.5)
|
| + def create_inbound_shipment_plan(self, path, response, **kw):
|
| + """Returns the information required to create an inbound shipment.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @requires(['ShipmentId', 'InboundShipmentHeader', 'InboundShipmentItems'])
|
| + @structured_objects('InboundShipmentHeader', 'InboundShipmentItems')
|
| + @api_action('Inbound', 30, 0.5)
|
| + def create_inbound_shipment(self, path, response, **kw):
|
| + """Creates an inbound shipment.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @requires(['ShipmentId'])
|
| + @structured_objects('InboundShipmentHeader', 'InboundShipmentItems')
|
| + @api_action('Inbound', 30, 0.5)
|
| + def update_inbound_shipment(self, path, response, **kw):
|
| + """Updates an existing inbound shipment. Amazon documentation
|
| + is ambiguous as to whether the InboundShipmentHeader and
|
| + InboundShipmentItems arguments are required.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @requires_some_of('ShipmentIdList', 'ShipmentStatusList')
|
| + @structured_lists('ShipmentIdList.Id', 'ShipmentStatusList.Status')
|
| + @api_action('Inbound', 30, 0.5)
|
| + def list_inbound_shipments(self, path, response, **kw):
|
| + """Returns a list of inbound shipments based on criteria that
|
| + you specify.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @requires(['NextToken'])
|
| + @api_action('Inbound', 30, 0.5)
|
| + def list_inbound_shipments_by_next_token(self, path, response, **kw):
|
| + """Returns the next page of inbound shipments using the NextToken
|
| + parameter.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @requires(['ShipmentId'], ['LastUpdatedAfter', 'LastUpdatedBefore'])
|
| + @api_action('Inbound', 30, 0.5)
|
| + def list_inbound_shipment_items(self, path, response, **kw):
|
| + """Returns a list of items in a specified inbound shipment, or a
|
| + list of items that were updated within a specified time frame.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @requires(['NextToken'])
|
| + @api_action('Inbound', 30, 0.5)
|
| + def list_inbound_shipment_items_by_next_token(self, path, response, **kw):
|
| + """Returns the next page of inbound shipment items using the
|
| + NextToken parameter.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @api_action('Inbound', 2, 300, 'GetServiceStatus')
|
| + def get_inbound_service_status(self, path, response, **kw):
|
| + """Returns the operational status of the Fulfillment Inbound
|
| + Shipment API section.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @requires(['SellerSkus'], ['QueryStartDateTime'])
|
| + @structured_lists('SellerSkus.member')
|
| + @api_action('Inventory', 30, 0.5)
|
| + def list_inventory_supply(self, path, response, **kw):
|
| + """Returns information about the availability of a seller's
|
| + inventory.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @requires(['NextToken'])
|
| + @api_action('Inventory', 30, 0.5)
|
| + def list_inventory_supply_by_next_token(self, path, response, **kw):
|
| + """Returns the next page of information about the availability
|
| + of a seller's inventory using the NextToken parameter.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @api_action('Inventory', 2, 300, 'GetServiceStatus')
|
| + def get_inventory_service_status(self, path, response, **kw):
|
| + """Returns the operational status of the Fulfillment Inventory
|
| + API section.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @structured_objects('Address', 'Items')
|
| + @requires(['Address', 'Items'])
|
| + @api_action('Outbound', 30, 0.5)
|
| + def get_fulfillment_preview(self, path, response, **kw):
|
| + """Returns a list of fulfillment order previews based on items
|
| + and shipping speed categories that you specify.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @structured_objects('DestinationAddress', 'Items')
|
| + @requires(['SellerFulfillmentOrderId', 'DisplayableOrderId',
|
| + 'ShippingSpeedCategory', 'DisplayableOrderDateTime',
|
| + 'DestinationAddress', 'DisplayableOrderComment',
|
| + 'Items'])
|
| + @api_action('Outbound', 30, 0.5)
|
| + def create_fulfillment_order(self, path, response, **kw):
|
| + """Requests that Amazon ship items from the seller's inventory
|
| + to a destination address.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @requires(['SellerFulfillmentOrderId'])
|
| + @api_action('Outbound', 30, 0.5)
|
| + def get_fulfillment_order(self, path, response, **kw):
|
| + """Returns a fulfillment order based on a specified
|
| + SellerFulfillmentOrderId.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @api_action('Outbound', 30, 0.5)
|
| + def list_all_fulfillment_orders(self, path, response, **kw):
|
| + """Returns a list of fulfillment orders fulfilled after (or
|
| + at) a specified date or by fulfillment method.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @requires(['NextToken'])
|
| + @api_action('Outbound', 30, 0.5)
|
| + def list_all_fulfillment_orders_by_next_token(self, path, response, **kw):
|
| + """Returns the next page of inbound shipment items using the
|
| + NextToken parameter.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @requires(['SellerFulfillmentOrderId'])
|
| + @api_action('Outbound', 30, 0.5)
|
| + def cancel_fulfillment_order(self, path, response, **kw):
|
| + """Requests that Amazon stop attempting to fulfill an existing
|
| + fulfillment order.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @api_action('Outbound', 2, 300, 'GetServiceStatus')
|
| + def get_outbound_service_status(self, path, response, **kw):
|
| + """Returns the operational status of the Fulfillment Outbound
|
| + API section.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @requires(['CreatedAfter'], ['LastUpdatedAfter'])
|
| + @exclusive(['CreatedAfter'], ['LastUpdatedAfter'])
|
| + @dependent('CreatedBefore', ['CreatedAfter'])
|
| + @exclusive(['LastUpdatedAfter'], ['BuyerEmail'], ['SellerOrderId'])
|
| + @dependent('LastUpdatedBefore', ['LastUpdatedAfter'])
|
| + @exclusive(['CreatedAfter'], ['LastUpdatedBefore'])
|
| + @requires(['MarketplaceId'])
|
| + @structured_objects('OrderTotal', 'ShippingAddress',
|
| + 'PaymentExecutionDetail')
|
| + @structured_lists('MarketplaceId.Id', 'OrderStatus.Status',
|
| + 'FulfillmentChannel.Channel', 'PaymentMethod.')
|
| + @api_action('Orders', 6, 60)
|
| + def list_orders(self, path, response, **kw):
|
| + """Returns a list of orders created or updated during a time
|
| + frame that you specify.
|
| + """
|
| + toggle = set(('FulfillmentChannel.Channel.1',
|
| + 'OrderStatus.Status.1', 'PaymentMethod.1',
|
| + 'LastUpdatedAfter', 'LastUpdatedBefore'))
|
| + for do, dont in {
|
| + 'BuyerEmail': toggle.union(['SellerOrderId']),
|
| + 'SellerOrderId': toggle.union(['BuyerEmail']),
|
| + }.items():
|
| + if do in kw and filter(kw.has_key, dont):
|
| + message = "Don't include {0} when specifying " \
|
| + "{1}".format(' or '.join(dont), do)
|
| + raise AssertionError(message)
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @requires(['NextToken'])
|
| + @api_action('Orders', 6, 60)
|
| + def list_orders_by_next_token(self, path, response, **kw):
|
| + """Returns the next page of orders using the NextToken value
|
| + that was returned by your previous request to either
|
| + ListOrders or ListOrdersByNextToken.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @requires(['AmazonOrderId'])
|
| + @structured_lists('AmazonOrderId.Id')
|
| + @api_action('Orders', 6, 60)
|
| + def get_order(self, path, response, **kw):
|
| + """Returns an order for each AmazonOrderId that you specify.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @requires(['AmazonOrderId'])
|
| + @api_action('Orders', 30, 2)
|
| + def list_order_items(self, path, response, **kw):
|
| + """Returns order item information for an AmazonOrderId that
|
| + you specify.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @requires(['NextToken'])
|
| + @api_action('Orders', 30, 2)
|
| + def list_order_items_by_next_token(self, path, response, **kw):
|
| + """Returns the next page of order items using the NextToken
|
| + value that was returned by your previous request to either
|
| + ListOrderItems or ListOrderItemsByNextToken.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @api_action('Orders', 2, 300, 'GetServiceStatus')
|
| + def get_orders_service_status(self, path, response, **kw):
|
| + """Returns the operational status of the Orders API section.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @requires(['MarketplaceId', 'Query'])
|
| + @api_action('Products', 20, 20)
|
| + def list_matching_products(self, path, response, **kw):
|
| + """Returns a list of products and their attributes, ordered
|
| + by relevancy, based on a search query that you specify.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @requires(['MarketplaceId', 'ASINList'])
|
| + @structured_lists('ASINList.ASIN')
|
| + @api_action('Products', 20, 20)
|
| + def get_matching_product(self, path, response, **kw):
|
| + """Returns a list of products and their attributes, based on
|
| + a list of ASIN values that you specify.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @requires(['MarketplaceId', 'IdType', 'IdList'])
|
| + @structured_lists('IdList.Id')
|
| + @api_action('Products', 20, 20)
|
| + def get_matching_product_for_id(self, path, response, **kw):
|
| + """Returns a list of products and their attributes, based on
|
| + a list of Product IDs that you specify.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @requires(['MarketplaceId', 'SellerSKUList'])
|
| + @structured_lists('SellerSKUList.SellerSKU')
|
| + @api_action('Products', 20, 10, 'GetCompetitivePricingForSKU')
|
| + def get_competitive_pricing_for_sku(self, path, response, **kw):
|
| + """Returns the current competitive pricing of a product,
|
| + based on the SellerSKUs and MarketplaceId that you specify.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @requires(['MarketplaceId', 'ASINList'])
|
| + @structured_lists('ASINList.ASIN')
|
| + @api_action('Products', 20, 10, 'GetCompetitivePricingForASIN')
|
| + def get_competitive_pricing_for_asin(self, path, response, **kw):
|
| + """Returns the current competitive pricing of a product,
|
| + based on the ASINs and MarketplaceId that you specify.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @requires(['MarketplaceId', 'SellerSKUList'])
|
| + @structured_lists('SellerSKUList.SellerSKU')
|
| + @api_action('Products', 20, 5, 'GetLowestOfferListingsForSKU')
|
| + def get_lowest_offer_listings_for_sku(self, path, response, **kw):
|
| + """Returns the lowest price offer listings for a specific
|
| + product by item condition and SellerSKUs.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @requires(['MarketplaceId', 'ASINList'])
|
| + @structured_lists('ASINList.ASIN')
|
| + @api_action('Products', 20, 5, 'GetLowestOfferListingsForASIN')
|
| + def get_lowest_offer_listings_for_asin(self, path, response, **kw):
|
| + """Returns the lowest price offer listings for a specific
|
| + product by item condition and ASINs.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @requires(['MarketplaceId', 'SellerSKU'])
|
| + @api_action('Products', 20, 20, 'GetProductCategoriesForSKU')
|
| + def get_product_categories_for_sku(self, path, response, **kw):
|
| + """Returns the product categories that a SellerSKU belongs to.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @requires(['MarketplaceId', 'ASIN'])
|
| + @api_action('Products', 20, 20, 'GetProductCategoriesForASIN')
|
| + def get_product_categories_for_asin(self, path, response, **kw):
|
| + """Returns the product categories that an ASIN belongs to.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @api_action('Products', 2, 300, 'GetServiceStatus')
|
| + def get_products_service_status(self, path, response, **kw):
|
| + """Returns the operational status of the Products API section.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @api_action('Sellers', 15, 60)
|
| + def list_marketplace_participations(self, path, response, **kw):
|
| + """Returns a list of marketplaces that the seller submitting
|
| + the request can sell in, and a list of participations that
|
| + include seller-specific information in that marketplace.
|
| + """
|
| + return self.post_request(path, kw, response)
|
| +
|
| + @requires(['NextToken'])
|
| + @api_action('Sellers', 15, 60)
|
| + def list_marketplace_participations_by_next_token(self, path, response,
|
| + **kw):
|
| + """Returns the next page of marketplaces and participations
|
| + using the NextToken value that was returned by your
|
| + previous request to either ListMarketplaceParticipations
|
| + or ListMarketplaceParticipationsByNextToken.
|
| + """
|
| + return self.post_request(path, kw, response)
|
|
|