python-amazon-ad-api 0.6.4__tar.gz → 0.6.6__tar.gz

{python_amazon_ad_api-0.6.4 → python_amazon_ad_api-0.6.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-amazon-ad-api
-Version: 0.6.4
+Version: 0.6.6
 Summary: Python wrapper for the Amazon Advertising API
 Home-page: https://github.com/denisneuf/python-amazon-ad-api
 Author: Daniel Alvaro
@@ -14,8 +14,8 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: requests<2.33.0,>=2.27.1
 Requires-Dist: six<1.18,>=1.16
-Requires-Dist: cachetools<5.6,>=5.0
-Requires-Dist: pycryptodome<3.23,>=3.13
+Requires-Dist: cachetools<6.2,>=5.0
+Requires-Dist: pycryptodome<3.24,>=3.13
 Requires-Dist: pytz<2026.0,>=2021.3
 Requires-Dist: confuse<2.1,>=1.7
 Dynamic: author
@@ -346,6 +346,7 @@ There is a new version 3 of Sponsored Product API, please check the [migration g
 * [Moderation](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/moderation.html)
 * [Reports](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/reports.html)
 * [Snapshots](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/snapshots.html)
+* [Themes](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/themes.html)
 
 ### [Modules Available Sponsored Brands 4.0](https://python-amazon-ad-api.readthedocs.io/en/latest/sb_v4.html)
 

{python_amazon_ad_api-0.6.4 → python_amazon_ad_api-0.6.6}/README.md

@@ -318,6 +318,7 @@ There is a new version 3 of Sponsored Product API, please check the [migration g
 * [Moderation](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/moderation.html)
 * [Reports](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/reports.html)
 * [Snapshots](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/snapshots.html)
+* [Themes](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/themes.html)
 
 ### [Modules Available Sponsored Brands 4.0](https://python-amazon-ad-api.readthedocs.io/en/latest/sb_v4.html)
 

{python_amazon_ad_api-0.6.4 → python_amazon_ad_api-0.6.6}/ad_api/api/sb/__init__.py

@@ -21,6 +21,7 @@ from .media import Media
 from .reports import Reports
 from .snapshots import Snapshots
 from .benchmarks import Benchmarks
+from .themes import Themes
 
 __all__ = [
     "Brands",
@@ -45,5 +46,6 @@ __all__ = [
     "Media",
     "Reports",
     "Snapshots",
-    "Benchmarks"
+    "Benchmarks",
+    "Themes"
 ]

python_amazon_ad_api-0.6.6/ad_api/api/sb/themes.py

@@ -0,0 +1,79 @@
+from ad_api.base import Client, sp_endpoint, ApiResponse, Utils
+
+
+class Themes(Client):
+    """
+    Amazon Ads API - Sponsored Brands - Theme Targeting
+    
+    Theme targeting automatically targets keywords related to your brand or landing pages.
+    """
+
+    @sp_endpoint('/sb/themes/list', method='POST')
+    def list_themes(self, **kwargs) -> ApiResponse:
+        r"""
+        Gets a list of theme targets associated with the client identifier, filtered by specified criteria.
+
+        Request Body
+            | '**nextToken**': *string*, {'description': 'Token for pagination. Operations that return paginated results include a pagination token in this field.'}
+            | '**maxResults**': *number*, {'description': 'Maximum number of results to return. Defaults to API maximum.'}
+            | '**campaignIdFilter**': *object*, {'description': 'List of campaign identifiers to filter by (max 100).'}
+            | '**adGroupIdFilter**': *object*, {'description': 'List of ad group identifiers to filter by (max 100).'}
+            | '**themeIdFilter**': *object*, {'description': 'List of theme target identifiers to filter by (max 100).'}
+            | '**stateFilter**': *object*, {'description': 'List of theme target states to filter by. Valid values: enabled, paused, archived. Default: enabled, paused.'}
+            | '**themeTypeFilter**': *object*, {'description': 'List of theme types to filter by. Valid values: KEYWORDS_RELATED_TO_YOUR_BRAND, KEYWORDS_RELATED_TO_YOUR_LANDING_PAGES.'}
+
+        Returns:
+            | ApiResponse
+        """
+        headers = {'Accept': 'application/vnd.sbthemeslistresponse.v3+json'}
+        body = Utils.convert_body(kwargs.pop('body'), wrap=False)
+        return self._request(kwargs.pop('path'), data=body, params=kwargs, headers=headers)
+
+    @sp_endpoint('/sb/themes', method='POST')
+    def create_themes(self, **kwargs) -> ApiResponse:
+        r"""
+        Create one or more theme targets.
+
+        Note that theme targets can be created on multi-adGroup campaigns where campaign serving status is not archived, terminated, rejected, or ended.
+        Note that ad group state must not be archived.
+        Note that only one target can be created for each themeType per adGroup.
+        Note that this operation supports a maximum list size of 100 theme targets.
+
+        Request Body
+            | '**themes**': *array*, {'description': 'List of theme targets to create (max 100).'}
+                | '**adGroupId**': *string*, {'description': 'The identifier of the ad group'}
+                | '**campaignId**': *string*, {'description': 'The identifier of the campaign'}
+                | '**themeType**': *string*, {'description': 'Theme type', 'Enum': 'KEYWORDS_RELATED_TO_YOUR_BRAND, KEYWORDS_RELATED_TO_YOUR_LANDING_PAGES'}
+                | '**bid**': *number*, {'description': 'The bid amount'}
+
+        Returns:
+            | ApiResponse
+        """
+        headers = {'Accept': 'application/vnd.sbthemescreateresponse.v3+json'}
+        body = Utils.convert_body(kwargs.pop('body'), wrap=False)
+        return self._request(kwargs.pop('path'), data=body, params=kwargs, headers=headers)
+
+    @sp_endpoint('/sb/themes', method='PUT')
+    def update_themes(self, **kwargs) -> ApiResponse:
+        r"""
+        Updates one or more theme targets.
+
+        Note that theme targets can be updated on multi-adGroup campaigns where campaign serving status is not archived, terminated, rejected, or ended.
+        Note that ad group state must not be archived.
+        Note that this operation supports a maximum list size of 100 theme targets.
+        Note that bid is only mutable when the corresponding campaign does not have any enabled optimization rule.
+
+        Request Body
+            | '**themes**': *array*, {'description': 'List of theme targets to update (max 100).'}
+                | '**themeId**': *string*, {'description': 'The identifier of the theme target'}
+                | '**adGroupId**': *string*, {'description': 'The identifier of the ad group'}
+                | '**campaignId**': *string*, {'description': 'The identifier of the campaign'}
+                | '**state**': *string*, {'description': 'Theme target state', 'Enum': 'enabled, paused, archived'}
+                | '**bid**': *number*, {'description': 'The bid amount'}
+
+        Returns:
+            | ApiResponse
+        """
+        headers = {'Accept': 'application/vnd.sbthemesupdateresponse.v3+json'}
+        body = Utils.convert_body(kwargs.pop('body'), wrap=False)
+        return self._request(kwargs.pop('path'), data=body, params=kwargs, headers=headers)

{python_amazon_ad_api-0.6.4 → python_amazon_ad_api-0.6.6}/ad_api/auth/access_token_response.py

@@ -2,5 +2,5 @@ class AccessTokenResponse:
     def __init__(self, **kwargs):
         self.access_token = kwargs.get('access_token')
         self.refresh_token = kwargs.get('refresh_token')
-        self.expires_in = kwargs.get('expires')
+        self.expires_in = kwargs.get('expires_in')
         self.token_type = kwargs.get('token_type')

{python_amazon_ad_api-0.6.4 → python_amazon_ad_api-0.6.6}/ad_api/base/marketplaces.py

@@ -62,10 +62,12 @@ class Locales(Enum):
     JP = "ja_JP"
     SG = "en_SG"
     CN = "zh_CN"
+    IE = "en_IE"
+
 
 
 class Currencies(Enum):
-    EU = ES = DE = FR = IT = NL = BE = "EUR"
+    EU = ES = DE = FR = IT = NL = BE = IE = "EUR"
     SE = "SEK"
     PL = "PLN"
     TR = "TRY"
@@ -105,6 +107,7 @@ class MarketplacesIds(Enum):
     SG = 'A19VAU5U5O7RUS'
     AU = 'A39IBJ37TRP1C6'
     JP = 'A1VC38T7YXB528'
+    IE = 'A28R8C7NBKEWEA'
 
 
 class Marketplaces(Enum):
@@ -146,7 +149,7 @@ class Marketplaces(Enum):
         'token_url': 'api.amazon.co.jp/auth/o2/token'
     }
     # Europe
-    EU = ES = DE = FR = IT = NL = BE = {
+    EU = ES = DE = FR = IT = NL = BE = IE = {
         'prod': 'advertising-api-eu.amazon.com',
         'currency': 'EUR',
         'token_url': 'api.amazon.co.uk/auth/o2/token'

python_amazon_ad_api-0.6.6/ad_api/version.py

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

{python_amazon_ad_api-0.6.4 → python_amazon_ad_api-0.6.6}/python_amazon_ad_api.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-amazon-ad-api
-Version: 0.6.4
+Version: 0.6.6
 Summary: Python wrapper for the Amazon Advertising API
 Home-page: https://github.com/denisneuf/python-amazon-ad-api
 Author: Daniel Alvaro
@@ -14,8 +14,8 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: requests<2.33.0,>=2.27.1
 Requires-Dist: six<1.18,>=1.16
-Requires-Dist: cachetools<5.6,>=5.0
-Requires-Dist: pycryptodome<3.23,>=3.13
+Requires-Dist: cachetools<6.2,>=5.0
+Requires-Dist: pycryptodome<3.24,>=3.13
 Requires-Dist: pytz<2026.0,>=2021.3
 Requires-Dist: confuse<2.1,>=1.7
 Dynamic: author
@@ -346,6 +346,7 @@ There is a new version 3 of Sponsored Product API, please check the [migration g
 * [Moderation](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/moderation.html)
 * [Reports](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/reports.html)
 * [Snapshots](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/snapshots.html)
+* [Themes](https://python-amazon-ad-api.readthedocs.io/en/latest/sb/themes.html)
 
 ### [Modules Available Sponsored Brands 4.0](https://python-amazon-ad-api.readthedocs.io/en/latest/sb_v4.html)
 

{python_amazon_ad_api-0.6.4 → python_amazon_ad_api-0.6.6}/python_amazon_ad_api.egg-info/SOURCES.txt

@@ -58,6 +58,7 @@ ad_api/api/sb/reports.py
 ad_api/api/sb/snapshots.py
 ad_api/api/sb/stores.py
 ad_api/api/sb/targeting_recommendations.py
+ad_api/api/sb/themes.py
 ad_api/api/sd/__init__.py
 ad_api/api/sd/ad_groups.py
 ad_api/api/sd/bid_recommendations.py

{python_amazon_ad_api-0.6.4 → python_amazon_ad_api-0.6.6}/python_amazon_ad_api.egg-info/requires.txt

@@ -1,6 +1,6 @@
 requests<2.33.0,>=2.27.1
 six<1.18,>=1.16
-cachetools<5.6,>=5.0
-pycryptodome<3.23,>=3.13
+cachetools<6.2,>=5.0
+pycryptodome<3.24,>=3.13
 pytz<2026.0,>=2021.3
 confuse<2.1,>=1.7

{python_amazon_ad_api-0.6.4 → python_amazon_ad_api-0.6.6}/setup.cfg

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

{python_amazon_ad_api-0.6.4 → python_amazon_ad_api-0.6.6}/setup.py

@@ -2,12 +2,12 @@ from setuptools import setup
 
 setup(
     name='python-amazon-ad-api',
-    version='0.6.4',
+    version='0.6.6',
     install_requires=[
         "requests>=2.27.1,<2.33.0",
         "six>=1.16,<1.18",
-        "cachetools>=5.0,<5.6",
-        "pycryptodome>=3.13,<3.23",
+        "cachetools>=5.0,<6.2",
+        "pycryptodome>=3.13,<3.24",
         "pytz>=2021.3,<2026.0",
         "confuse>=1.7,<2.1",
     ],

python_amazon_ad_api-0.6.4/ad_api/version.py

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