python-amazon-ad-api 1.2.8__tar.gz → 1.2.9__tar.gz

{python_amazon_ad_api-1.2.8 → python_amazon_ad_api-1.2.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-amazon-ad-api
-Version: 1.2.8
+Version: 1.2.9
 Summary: Python wrapper for the Amazon Advertising API
 Home-page: https://github.com/denisneuf/python-amazon-ad-api
 Author: Daniel Alvaro
@@ -274,7 +274,7 @@ curl \
 * [Localization](https://python-amazon-ad-api.readthedocs.io/en/latest/api/localization.html)
 * [Product Selector](https://python-amazon-ad-api.readthedocs.io/en/latest/api/metadata.html)
 * [Validation Configurations](https://python-amazon-ad-api.readthedocs.io/en/latest/api/validation_configurations.html)
-* [Tactical recommendations beta](https://python-amazon-ad-api.readthedocs.io/en/latest/api/recommendations.html)
+* [Tactical recommendations](https://python-amazon-ad-api.readthedocs.io/en/latest/api/recommendations.html)
 * [Exports](https://advertising.amazon.com/API/docs/en-us/exports)
 
 

{python_amazon_ad_api-1.2.8 → python_amazon_ad_api-1.2.9}/README.md

@@ -246,7 +246,7 @@ curl \
 * [Localization](https://python-amazon-ad-api.readthedocs.io/en/latest/api/localization.html)
 * [Product Selector](https://python-amazon-ad-api.readthedocs.io/en/latest/api/metadata.html)
 * [Validation Configurations](https://python-amazon-ad-api.readthedocs.io/en/latest/api/validation_configurations.html)
-* [Tactical recommendations beta](https://python-amazon-ad-api.readthedocs.io/en/latest/api/recommendations.html)
+* [Tactical recommendations](https://python-amazon-ad-api.readthedocs.io/en/latest/api/recommendations.html)
 * [Exports](https://advertising.amazon.com/API/docs/en-us/exports)
 
 

{python_amazon_ad_api-1.2.8 → python_amazon_ad_api-1.2.9}/ad_api/api/recommendations.py

@@ -13,7 +13,7 @@ class Recommendations(Client):
             | ListRecommendationsRequest {
             | **maxResults** (integer) default: 500 minimum: 1 maximum: 500
             | **nextToken** (string) Token to retrieve the next page of results.
-            | **filters**\* (array) minItems: 1 maxItems: 10 [
+            | **filters** (array) minItems: 1 maxItems: 10 [
             |   ListRecommendationsFilter {
             |       **include** (boolean): Flag to specify if the filter should be included or excluded. default: true
             |       **field**\* FilterField (string): Field to filter by. Enum: ['RECOMMENDATION_ID', 'AD_PRODUCT', 'RECOMMENDATION_TYPE', 'STATUS', 'GROUPING_TYPE', 'CAMPAIGN_ID']
@@ -24,8 +24,27 @@ class Recommendations(Client):
             |       }
             |   ]
             | }
+
+        The values ``STATUS`` accepts are not the states of a campaign. They are
+        the stages a recommendation passes through, and the service names them in
+        its rejection message: ``PUBLISHED``, ``APPLY_IN_PROGRESS``,
+        ``APPLY_SUCCESS``, ``APPLY_FAILED`` and ``REJECTED``. ``ENABLED`` and
+        ``ACTIVE`` are refused.
+
+        ``filters`` behaves oddly. An empty list answers
+        ``400 Member must have length greater than or equal to 1``, yet leaving
+        the member out altogether answers ``200`` with the account's
+        recommendations. So it is required when present, and optional in
+        practice.
+
+        A body is required: without one the call fails before reaching the
+        service, with ``KeyError: 'body'``.
+
         Returns
-            ApiResponse
+            ApiResponse with ``recommendations``, ``totalResults`` and
+            ``nextToken``. The list is empty for an account that has none, which
+            is a fact about the account rather than a failed call.
+
         """
         schema_version = 'application/vnd.listRecommendationsRequest.v' + str(version) + '+json'
         headers = {"Accept": schema_version, "Content-Type": schema_version}
@@ -42,6 +61,15 @@ class Recommendations(Client):
             |       (string) Recommendation identifier.
             |   ]
             | }
+
+        .. warning::
+
+            This changes campaigns. Applying a recommendation edits real bidding
+            and budgets on the account, and there is no undo richer than
+            changing them back by hand.
+
+            Not exercised: no recommendation existed on the account to apply.
+
         Returns
             ApiResponse
         """
@@ -79,6 +107,15 @@ class Recommendations(Client):
             |       }
             |   }
             | }
+
+        .. warning::
+
+            This edits a recommendation before it is applied. Read one first with
+            ``list_recommendations`` for the shape it expects, since the fields
+            change with ``recommendationType``.
+
+            Not exercised, for the same reason as ``apply_recommendations``.
+
         Returns
             ApiResponse
 

python_amazon_ad_api-1.2.9/ad_api/version.py

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

{python_amazon_ad_api-1.2.8 → python_amazon_ad_api-1.2.9}/python_amazon_ad_api.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-amazon-ad-api
-Version: 1.2.8
+Version: 1.2.9
 Summary: Python wrapper for the Amazon Advertising API
 Home-page: https://github.com/denisneuf/python-amazon-ad-api
 Author: Daniel Alvaro
@@ -274,7 +274,7 @@ curl \
 * [Localization](https://python-amazon-ad-api.readthedocs.io/en/latest/api/localization.html)
 * [Product Selector](https://python-amazon-ad-api.readthedocs.io/en/latest/api/metadata.html)
 * [Validation Configurations](https://python-amazon-ad-api.readthedocs.io/en/latest/api/validation_configurations.html)
-* [Tactical recommendations beta](https://python-amazon-ad-api.readthedocs.io/en/latest/api/recommendations.html)
+* [Tactical recommendations](https://python-amazon-ad-api.readthedocs.io/en/latest/api/recommendations.html)
 * [Exports](https://advertising.amazon.com/API/docs/en-us/exports)
 
 

{python_amazon_ad_api-1.2.8 → python_amazon_ad_api-1.2.9}/setup.cfg

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

{python_amazon_ad_api-1.2.8 → python_amazon_ad_api-1.2.9}/setup.py

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

python_amazon_ad_api-1.2.8/ad_api/version.py

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