python-amazon-ad-api 1.1.7__tar.gz → 1.1.8__tar.gz

{python_amazon_ad_api-1.1.7 → python_amazon_ad_api-1.1.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-amazon-ad-api
-Version: 1.1.7
+Version: 1.1.8
 Summary: Python wrapper for the Amazon Advertising API
 Home-page: https://github.com/denisneuf/python-amazon-ad-api
 Author: Daniel Alvaro

{python_amazon_ad_api-1.1.7 → python_amazon_ad_api-1.1.8}/ad_api/api/sb/campaigns_v4.py

@@ -77,6 +77,34 @@ class CampaignsV4(Client):
 
         return self._request(kwargs.pop('path'), data=Utils.convert_body(kwargs.pop('body'), False), params=kwargs, headers=headers)
 
+    @sp_endpoint('/sb/campaigns/insights', method='POST')
+    def get_campaign_insights(self, version: int = 4, **kwargs) -> ApiResponse:
+        """
+        Gets insights for campaign ad groups.
+
+        Request Body [Required]
+            | **adGroups** (array): [required] One entry per ad group.
+                | **adFormat** (string): [required] Ad format of the ad group.
+                | **keywords** (array): [optional] Each entry needs
+                  ``keywordText``, ``matchType`` and ``bid``.
+
+        Returns:
+            | ApiResponse, ``200``.
+
+        .. note::
+            This route takes ``application/vnd.sbinsights.v4+json``, not the
+            campaigns media type. With ``application/json`` it answers ``404
+            Could not find resource``, so the versioned type is what routes it.
+
+        .. note::
+            An empty body answers ``400`` naming ``adGroups``, which is the only
+            required member.
+        """
+        json_version = 'application/vnd.sbinsights.v' + str(version) + "+json"
+        headers = {'Accept': json_version}
+
+        return self._request(kwargs.pop('path'), data=Utils.convert_body(kwargs.pop('body'), False), params=kwargs, headers=headers)
+
     @sp_endpoint('/sb/v4/campaigns/list', method='POST')
     def list_campaigns(self, version: int = 4, **kwargs) -> ApiResponse:
         """

{python_amazon_ad_api-1.1.7 → python_amazon_ad_api-1.1.8}/ad_api/api/sb/targeting_categories.py

@@ -67,6 +67,29 @@ class TargetingCategories(Client):
                              params=kwargs,
                              headers={'Accept': self._MEDIA, 'Content-Type': self._MEDIA})
 
+    @sp_endpoint('/sb/negativeTargets/brands/recommendations', method='GET')
+    def list_negative_brand_recommendations(self, **kwargs) -> ApiResponse:
+        """
+        Gets brand recommendations for negative targeting.
+
+        Keyword Args
+            | query **nextToken** (string): [optional] Pagination token.
+
+        Returns:
+            | ApiResponse, ``200``, with brands under ``brands``, each carrying
+              ``brandRefinementId`` and ``name``.
+
+        Example::
+
+            {"brands": [{"brandRefinementId": "19897490031", "name": "YEYIAN"}]}
+
+        .. note::
+            Lives here because it shares this class media type. It is the one
+            route in this class that is not about the category tree.
+        """
+        return self._request(kwargs.pop('path'), params=kwargs,
+                             headers={'Accept': self._MEDIA, 'Content-Type': self._MEDIA})
+
     @sp_endpoint('/sb/targets/products/count', method='POST')
     def get_product_count(self, category, **kwargs) -> ApiResponse:
         """

python_amazon_ad_api-1.1.8/ad_api/version.py

@@ -0,0 +1 @@
+__version__ = "1.1.8"

{python_amazon_ad_api-1.1.7 → python_amazon_ad_api-1.1.8}/python_amazon_ad_api.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-amazon-ad-api
-Version: 1.1.7
+Version: 1.1.8
 Summary: Python wrapper for the Amazon Advertising API
 Home-page: https://github.com/denisneuf/python-amazon-ad-api
 Author: Daniel Alvaro

{python_amazon_ad_api-1.1.7 → python_amazon_ad_api-1.1.8}/setup.cfg

@@ -1,6 +1,6 @@
 [metadata]
 name = python-amazon-ad-api
-version = 1.1.7
+version = 1.1.8
 author = Daniel Alvaro
 author_email = denisneuf@hotmail.com
 description = Python wrapper for the Amazon Advertising API

{python_amazon_ad_api-1.1.7 → python_amazon_ad_api-1.1.8}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup
 
 setup(
     name='python-amazon-ad-api',
-    version='1.1.7',
+    version='1.1.8',
     install_requires=[
         "requests>=2.27.1,<2.35.0",
         "six>=1.16,<1.18",

python_amazon_ad_api-1.1.7/ad_api/version.py

@@ -1 +0,0 @@
-__version__ = "1.1.7"