python-amazon-ad-api 1.5.5__tar.gz → 1.5.7__tar.gz

{python_amazon_ad_api-1.5.5/python_amazon_ad_api.egg-info → python_amazon_ad_api-1.5.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-amazon-ad-api
-Version: 1.5.5
+Version: 1.5.7
 Summary: Python wrapper for the Amazon Advertising API
 Home-page: https://github.com/denisneuf/python-amazon-ad-api
 Author: Daniel Alvaro
@@ -317,6 +317,8 @@ The v1 API lives under `/adsApi/v1/` and is **not** split by product: every call
 * [Recommendations](https://python-amazon-ad-api.readthedocs.io/en/latest/v1/recommendations.html#ad_api.api.v1.Recommendations.Recommendations.query_recommendations)
 * [Selling Accounts](https://python-amazon-ad-api.readthedocs.io/en/latest/v1/selling_accounts.html#ad_api.api.v1.SellingAccounts.SellingAccounts.query_selling_accounts)
 * [Label Object Associations](https://python-amazon-ad-api.readthedocs.io/en/latest/v1/label_object_associations.html#ad_api.api.v1.LabelObjectAssociations.LabelObjectAssociations.query_label_object_associations)
+* [Geo Locations](https://python-amazon-ad-api.readthedocs.io/en/latest/v1/geo_locations.html#ad_api.api.v1.GeoLocations.GeoLocations.create_geo_locations)
+* [Recommendation Types](https://python-amazon-ad-api.readthedocs.io/en/latest/v1/recommendation_types.html#ad_api.api.v1.RecommendationTypes.RecommendationTypes.query_sb_recommendation_types)
 
 
 ### [Modules Available Sponsored Products](https://python-amazon-ad-api.readthedocs.io/en/latest/sp.html)

{python_amazon_ad_api-1.5.5 → python_amazon_ad_api-1.5.7}/README.md

@@ -289,6 +289,8 @@ The v1 API lives under `/adsApi/v1/` and is **not** split by product: every call
 * [Recommendations](https://python-amazon-ad-api.readthedocs.io/en/latest/v1/recommendations.html#ad_api.api.v1.Recommendations.Recommendations.query_recommendations)
 * [Selling Accounts](https://python-amazon-ad-api.readthedocs.io/en/latest/v1/selling_accounts.html#ad_api.api.v1.SellingAccounts.SellingAccounts.query_selling_accounts)
 * [Label Object Associations](https://python-amazon-ad-api.readthedocs.io/en/latest/v1/label_object_associations.html#ad_api.api.v1.LabelObjectAssociations.LabelObjectAssociations.query_label_object_associations)
+* [Geo Locations](https://python-amazon-ad-api.readthedocs.io/en/latest/v1/geo_locations.html#ad_api.api.v1.GeoLocations.GeoLocations.create_geo_locations)
+* [Recommendation Types](https://python-amazon-ad-api.readthedocs.io/en/latest/v1/recommendation_types.html#ad_api.api.v1.RecommendationTypes.RecommendationTypes.query_sb_recommendation_types)
 
 
 ### [Modules Available Sponsored Products](https://python-amazon-ad-api.readthedocs.io/en/latest/sp.html)

{python_amazon_ad_api-1.5.5 → python_amazon_ad_api-1.5.7}/ad_api/api/v1/__init__.py

@@ -15,6 +15,8 @@ from .manager_accounts import ManagerAccounts
 from .recommendations import Recommendations
 from .selling_accounts import SellingAccounts
 from .label_object_associations import LabelObjectAssociations
+from .geo_locations import GeoLocations
+from .recommendation_types import RecommendationTypes
 
 __all__ = [
     "Campaigns",
@@ -34,4 +36,6 @@ __all__ = [
     "Recommendations",
     "SellingAccounts",
     "LabelObjectAssociations",
+    "GeoLocations",
+    "RecommendationTypes",
 ]

python_amazon_ad_api-1.5.7/ad_api/api/v1/geo_locations.py

@@ -0,0 +1,54 @@
+from ad_api.base import Client, sp_endpoint, ApiResponse, Utils
+
+
+class GeoLocations(Client):
+    r"""
+    GeoLocations(account='default', marketplace: Marketplaces = Marketplaces.EU, credentials=None, debug=False)
+
+    Amazon Ads API v1 - geographic locations for targeting
+
+    One route, and it only creates:
+
+        POST /adsApi/v1/create/geoLocations
+
+    The contract declares no query and no delete, so a location created here
+    cannot be read back or removed through this family. Treat it as a write
+    that leaves an object in the account rather than as a lookup.
+
+    Two shapes sit under ``location``, exactly one of them per entry:
+
+        radiusLocation   a point of interest and a radius around it
+        smartLocation    postal codes picked by a sales index percentile
+    """
+
+    @sp_endpoint('/adsApi/v1/create/geoLocations', method='POST')
+    def create_geo_locations(self, **kwargs) -> ApiResponse:
+        r"""
+        create_geo_locations(body: dict) -> ApiResponse
+
+        Amazon Ads API v1 - Create Geo Locations (operationId: CreateGeoLocation)
+
+        Request Body [Required]
+            | **geoLocations** (list<GeoLocationCreate>) : [required] 1..100
+                | **location** (CreateGeoLocationUnion) : [required] one of:
+                    | **radiusLocation** (CreateRadiusLocation)
+                        | **pointOfInterestRadius** (double) : [required] kilometres or miles
+                        | **units** (DistanceUnit) : [required] Enum [ KILOMETERS, MILES ]
+                        | **coordinates** (CreateGeoLocationCoordinates) : latitude and longitude
+                        | **pointOfInterestAddress** (string) : an address or a place name
+                    | **smartLocation** (CreateSmartLocation)
+                        | **locationIndexId** (string) : [required] the index the selection is based on
+                        | **name** (string) : [required]
+                        | **minIndexValuePercentile** (int) : 0..100
+                        | **maxIndexValuePercentile** (int) : 0..100, greater than the minimum
+
+        Answer
+            207 MultiStatus with success[] and error[] indexed the same way;
+            each success carries the created GeoLocation and its position.
+
+        A radius needs at least 0.37 miles (2000 ft, 0.6 km), and the two
+        percentile values must not cross.
+        """
+        schema_version = 'application/json'
+        headers = {"Accept": schema_version, "Content-Type": schema_version}
+        return self._request(kwargs.pop('path'), data=Utils.convert_body(kwargs.pop('body'), False), params=kwargs, headers=headers)

python_amazon_ad_api-1.5.7/ad_api/api/v1/recommendation_types.py

@@ -0,0 +1,48 @@
+from ad_api.base import Client, sp_endpoint, ApiResponse, Utils
+
+
+class RecommendationTypes(Client):
+    r"""
+    RecommendationTypes(account='default', marketplace: Marketplaces = Marketplaces.EU, credentials=None, debug=False)
+
+    Amazon Ads API v1 - recommendation types for Sponsored Brands
+
+    One route, read only, and the product is in the path:
+
+        POST /adsApi/v1/query/recommendationTypes/sb
+
+    This family lists the kinds of recommendation that exist. Recommendations
+    itself, in ad_api.api.v1.Recommendations, lists the ones the account
+    actually has.
+
+    Only the Sponsored Brands segment is published, and its schemas are
+    prefixed SB. The route keeps no SB in its name, so another product would
+    arrive as .../sp or .../sd beside it.
+    """
+
+    @sp_endpoint('/adsApi/v1/query/recommendationTypes/sb', method='POST')
+    def query_sb_recommendation_types(self, **kwargs) -> ApiResponse:
+        r"""
+        query_sb_recommendation_types(body: dict) -> ApiResponse
+
+        Amazon Ads API v1 - Query SB Recommendation Types (operationId: SBQueryRecommendationType)
+
+        Request Body [All optional]
+            | **maxResults** (int) : 50..500, default 50
+            | **nextToken** (string) : token to navigate to the next page
+
+        Returns
+            | **recommendationTypes** (list<SBRecommendationType>) : 0..500
+                | **recommendationTypeId** (string) : [required] a UUID or a unique descriptive string
+                | **recommendationTypeTitle** (string) : [required]
+            | **nextToken** (string)
+
+        maxResults starts at 50, so a smaller value is a rejected body rather
+        than a shorter page. An empty body is valid and asks for the defaults.
+
+        Requires one of these permissions:
+            advertiser_campaign_view
+        """
+        schema_version = 'application/json'
+        headers = {"Accept": schema_version, "Content-Type": schema_version}
+        return self._request(kwargs.pop('path'), data=Utils.convert_body(kwargs.pop('body'), False), params=kwargs, headers=headers)

python_amazon_ad_api-1.5.7/ad_api/version.py

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

{python_amazon_ad_api-1.5.5 → python_amazon_ad_api-1.5.7/python_amazon_ad_api.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-amazon-ad-api
-Version: 1.5.5
+Version: 1.5.7
 Summary: Python wrapper for the Amazon Advertising API
 Home-page: https://github.com/denisneuf/python-amazon-ad-api
 Author: Daniel Alvaro
@@ -317,6 +317,8 @@ The v1 API lives under `/adsApi/v1/` and is **not** split by product: every call
 * [Recommendations](https://python-amazon-ad-api.readthedocs.io/en/latest/v1/recommendations.html#ad_api.api.v1.Recommendations.Recommendations.query_recommendations)
 * [Selling Accounts](https://python-amazon-ad-api.readthedocs.io/en/latest/v1/selling_accounts.html#ad_api.api.v1.SellingAccounts.SellingAccounts.query_selling_accounts)
 * [Label Object Associations](https://python-amazon-ad-api.readthedocs.io/en/latest/v1/label_object_associations.html#ad_api.api.v1.LabelObjectAssociations.LabelObjectAssociations.query_label_object_associations)
+* [Geo Locations](https://python-amazon-ad-api.readthedocs.io/en/latest/v1/geo_locations.html#ad_api.api.v1.GeoLocations.GeoLocations.create_geo_locations)
+* [Recommendation Types](https://python-amazon-ad-api.readthedocs.io/en/latest/v1/recommendation_types.html#ad_api.api.v1.RecommendationTypes.RecommendationTypes.query_sb_recommendation_types)
 
 
 ### [Modules Available Sponsored Products](https://python-amazon-ad-api.readthedocs.io/en/latest/sp.html)

{python_amazon_ad_api-1.5.5 → python_amazon_ad_api-1.5.7}/python_amazon_ad_api.egg-info/SOURCES.txt

@@ -105,9 +105,11 @@ ad_api/api/v1/brand_store_editions.py
 ad_api/api/v1/brand_store_pages.py
 ad_api/api/v1/brand_stores.py
 ad_api/api/v1/campaigns.py
+ad_api/api/v1/geo_locations.py
 ad_api/api/v1/label_object_associations.py
 ad_api/api/v1/labels.py
 ad_api/api/v1/manager_accounts.py
+ad_api/api/v1/recommendation_types.py
 ad_api/api/v1/recommendations.py
 ad_api/api/v1/reports.py
 ad_api/api/v1/selling_accounts.py

{python_amazon_ad_api-1.5.5 → python_amazon_ad_api-1.5.7}/setup.cfg

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

{python_amazon_ad_api-1.5.5 → python_amazon_ad_api-1.5.7}/setup.py

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

python_amazon_ad_api-1.5.5/ad_api/version.py

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