python-amazon-sp-api 1.9.57__tar.gz → 1.9.59__tar.gz

{python_amazon_sp_api-1.9.57/python_amazon_sp_api.egg-info → python_amazon_sp_api-1.9.59}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-amazon-sp-api
-Version: 1.9.57
+Version: 1.9.59
 Summary: Python wrapper for the Amazon Selling-Partner API
 Home-page: https://github.com/saleweaver/python-amazon-sp-api
 Author: Michael

{python_amazon_sp_api-1.9.57 → python_amazon_sp_api-1.9.59/python_amazon_sp_api.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-amazon-sp-api
-Version: 1.9.57
+Version: 1.9.59
 Summary: Python wrapper for the Amazon Selling-Partner API
 Home-page: https://github.com/saleweaver/python-amazon-sp-api
 Author: Michael

{python_amazon_sp_api-1.9.57 → python_amazon_sp_api-1.9.59}/python_amazon_sp_api.egg-info/SOURCES.txt

@@ -25,6 +25,8 @@ sp_api/api/catalog/__init__.py
 sp_api/api/catalog/catalog.py
 sp_api/api/catalog_items/__init__.py
 sp_api/api/catalog_items/catalog_items.py
+sp_api/api/customer_feedback/__init__.py
+sp_api/api/customer_feedback/customer_feedback.py
 sp_api/api/data_kiosk/__init__.py
 sp_api/api/data_kiosk/data_kiosk.py
 sp_api/api/easy_ship/__init__.py

{python_amazon_sp_api-1.9.57 → python_amazon_sp_api-1.9.59}/setup.py

@@ -39,6 +39,7 @@ setup(
               'sp_api.util',
               ##### DO NOT DELETE ########## INSERT PACKAGE HERE #######
               'sp_api.api.application_integrations',
+              'sp_api.api.customer_feedback',
               'sp_api.api.external_fulfillment',
               'sp_api.api.easy_ship',
               'sp_api.api.listings_restrictions',

python_amazon_sp_api-1.9.59/sp_api/__version__.py

@@ -0,0 +1 @@
+__version__ = '1.9.59'

{python_amazon_sp_api-1.9.57 → python_amazon_sp_api-1.9.59}/sp_api/api/__init__.py

@@ -26,7 +26,7 @@ from .application_integrations.application_integrations import ApplicationIntegr
 
 from .easy_ship.easy_ship import EasyShip
     
-
+from .customer_feedback.customer_feedback import CustomerFeedback
 
 from .listings_restrictions.listings_restrictions import ListingsRestrictions
 
@@ -119,7 +119,7 @@ __all__ = [
     ##### DO NOT DELETE ########## INSERT TITLE HERE #######
     "ExternalFulfillment",
     "ApplicationIntegrations",
-    
+    "CustomerFeedback",
     "FulfillmentInbound",
     
     "EasyShip",

python_amazon_sp_api-1.9.59/sp_api/api/customer_feedback/customer_feedback.py

@@ -0,0 +1,110 @@
+from sp_api.base import Client, sp_endpoint, ApiResponse, fill_query_params
+
+
+class CustomerFeedback(Client):
+    """
+    The Selling Partner API for CustomerFeedback - 2024-06-01
+
+    The Selling Partner API for Customer Feedback (Customer Feedback API) provides information about customer reviews and returns at both the item and browse node level.
+    """
+
+    @sp_endpoint(
+        "/customerFeedback/2024-06-01/items/{}/reviews/topics", method="GET"
+    )
+    def get_item_review_topics(
+        self, asin, *args, **kwargs
+    ) -> ApiResponse:
+        """
+        Retrieve an item's ten most positive and ten most negative review topics.
+        """
+
+        return self._request(
+            fill_query_params(kwargs.pop('path'), asin), params=kwargs
+        )
+
+    @sp_endpoint("/customerFeedback/2024-06-01/items/{}/browseNode", method="GET")
+    def get_item_browse_node(self, asin, *args, **kwargs) -> ApiResponse:
+        """
+        This API returns the associated browse node of the requested ASIN. A browse node is a location in a browse tree that is used for navigation, product classification, and website content on the Amazon retail website.
+        """
+
+        return self._request(
+            fill_query_params(kwargs.pop('path'), asin), params=kwargs
+        )
+
+
+    @sp_endpoint(
+        "/customerFeedback/2024-06-01/browseNodes/{}/reviews/topics",
+        method="GET",
+    )
+    def get_browse_node_review_topics(
+        self, browseNodeId, *args, **kwargs
+    ) -> ApiResponse:
+        """
+        Retrieve a browse node's ten most positive and ten most negative review topics.
+        """
+
+        return self._request(
+            fill_query_params(kwargs.pop('path'), browseNodeId), params=kwargs
+        )
+
+
+    @sp_endpoint(
+        "/customerFeedback/2024-06-01/items/{}/reviews/trends", method="GET"
+    )
+    def get_item_review_trends(
+        self, asin, *args, **kwargs
+    ) -> ApiResponse:
+        """
+        Retrieve an item's positive and negative review trends for the past six months.
+        """
+
+        return self._request(
+            fill_query_params(kwargs.pop('path'), asin), params=kwargs
+        )
+
+
+    @sp_endpoint(
+        "/customerFeedback/2024-06-01/browseNodes/{}/reviews/trends",
+        method="GET",
+    )
+    def get_browse_node_review_trends(
+        self, browseNodeId, *args, **kwargs
+    ) -> ApiResponse:
+        """
+        Retrieve the positive and negative review trends of items in a browse node for the past six months.
+        """
+
+        return self._request(
+            fill_query_params(kwargs.pop('path'), browseNodeId), params=kwargs
+        )
+
+    @sp_endpoint(
+        "/customerFeedback/2024-06-01/browseNodes/{}/returns/topics",
+        method="GET",
+    )
+    def get_browse_node_return_topics(
+        self, browseNodeId, *args, **kwargs
+    ) -> ApiResponse:
+        """
+        Retrieve the topics that customers mention when they return items in a browse node.
+        """
+
+        return self._request(
+            fill_query_params(kwargs.pop('path'), browseNodeId), params=kwargs
+        )
+
+    @sp_endpoint(
+        "/customerFeedback/2024-06-01/browseNodes/{}/returns/trends",
+        method="GET",
+    )
+    def get_browse_node_return_trends(
+        self, browseNodeId, *args, **kwargs
+    ) -> ApiResponse:
+        """
+        Retrieve the trends of topics that customers mention when they return items in a browse node.
+        """
+
+        return self._request(
+            fill_query_params(kwargs.pop('path'), browseNodeId), params=kwargs
+        )

{python_amazon_sp_api-1.9.57 → python_amazon_sp_api-1.9.59}/sp_api/base/ApiResponse.py

@@ -44,13 +44,13 @@ class ApiResponse:
         self.errors = errors
         self.pagination = pagination
         self.headers = headers
-        self.rate_limit = headers.get("x-amzn-RateLimit-Limit")
+        self.rate_limit = (headers or {}).get("x-amzn-RateLimit-Limit")
         try:
             self.next_token = (
                 nextToken
                 or self.payload.get("pagination", {}).get("nextToken", None)
                 or self.payload.get("NextToken", None)
-                or self.pagination.get("nextToken", None)
+                or (self.pagination or {}).get("nextToken", None)
                 or self.payload.get("nextPageToken", None)
                 or self.payload.get("nextToken", None)
             )

python_amazon_sp_api-1.9.57/sp_api/__version__.py

@@ -1 +0,0 @@
-__version__ = '1.9.57'