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

{python_amazon_ad_api-1.5.3 → python_amazon_ad_api-1.5.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-amazon-ad-api
-Version: 1.5.3
+Version: 1.5.5
 Summary: Python wrapper for the Amazon Advertising API
 Home-page: https://github.com/denisneuf/python-amazon-ad-api
 Author: Daniel Alvaro
@@ -315,6 +315,8 @@ The v1 API lives under `/adsApi/v1/` and is **not** split by product: every call
 * [Labels](https://python-amazon-ad-api.readthedocs.io/en/latest/v1/labels.html#ad_api.api.v1.Labels.Labels.query_labels)
 * [Manager Accounts](https://python-amazon-ad-api.readthedocs.io/en/latest/v1/manager_accounts.html#ad_api.api.v1.ManagerAccounts.ManagerAccounts.query_manager_accounts)
 * [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)
 
 
 ### [Modules Available Sponsored Products](https://python-amazon-ad-api.readthedocs.io/en/latest/sp.html)

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

@@ -287,6 +287,8 @@ The v1 API lives under `/adsApi/v1/` and is **not** split by product: every call
 * [Labels](https://python-amazon-ad-api.readthedocs.io/en/latest/v1/labels.html#ad_api.api.v1.Labels.Labels.query_labels)
 * [Manager Accounts](https://python-amazon-ad-api.readthedocs.io/en/latest/v1/manager_accounts.html#ad_api.api.v1.ManagerAccounts.ManagerAccounts.query_manager_accounts)
 * [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)
 
 
 ### [Modules Available Sponsored Products](https://python-amazon-ad-api.readthedocs.io/en/latest/sp.html)

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

@@ -13,6 +13,8 @@ from .reports import Reports
 from .labels import Labels
 from .manager_accounts import ManagerAccounts
 from .recommendations import Recommendations
+from .selling_accounts import SellingAccounts
+from .label_object_associations import LabelObjectAssociations
 
 __all__ = [
     "Campaigns",
@@ -30,4 +32,6 @@ __all__ = [
     "Labels",
     "ManagerAccounts",
     "Recommendations",
+    "SellingAccounts",
+    "LabelObjectAssociations",
 ]

python_amazon_ad_api-1.5.5/ad_api/api/v1/label_object_associations.py

@@ -0,0 +1,57 @@
+from ad_api.base import Client, sp_endpoint, ApiResponse, Utils
+
+
+class LabelObjectAssociations(Client):
+    r"""
+    LabelObjectAssociations(account='default', marketplace: Marketplaces = Marketplaces.EU, credentials=None, debug=False)
+
+    Amazon Ads API v1 - label to object associations
+
+    One route, read only:
+
+        POST /adsApi/v1/query/labelObjectAssociations
+
+    Labels itself lists the labels that exist. This family lists what each
+    label is applied to, so the pair answers "which labels do I have" and
+    "what is tagged".
+
+    The required member is ``labelObjectTypeFilter``, not the adProductFilter
+    the campaign families carry, and it takes exactly one value:
+
+        AD_GROUP, CAMPAIGN, DEAL, INVENTORY_GROUP
+    """
+
+    @sp_endpoint('/adsApi/v1/query/labelObjectAssociations', method='POST')
+    def query_label_object_associations(self, **kwargs) -> ApiResponse:
+        r"""
+        query_label_object_associations(body: dict) -> ApiResponse
+
+        Amazon Ads API v1 - Query Label Object Associations (operationId: QueryLabelObjectAssociation)
+
+        Request Body [Required]
+            | **labelObjectTypeFilter** (dict) : [required] exactly one value
+                | **include** (list<LabelObjectType>) : Enum [ AD_GROUP, CAMPAIGN, DEAL, INVENTORY_GROUP ]
+            | **adProductFilter** (dict) : [optional] exactly one value
+            | **labelIdFilter** (dict) : [optional] 1..50 ids
+            | **labelObjectIdFilter** (dict) : [optional] 1..50 ids
+            | **maxResults** (int) : 1..5000, default 100
+            | **nextToken** (string)
+
+        Returns
+            | **labelObjectAssociations** (list<LabelObjectAssociation>) : 0..5000
+                | **labelObjectAssociationId** (string) : [required]
+                | **labelId** (string) : [required] the label being applied
+                | **labelObjectId** (string) : [required] the object, e.g. a deal id or an ad group id
+                | **labelObjectType** (LabelObjectType) : [required]
+                | **adProduct** (AdProduct)
+            | **nextToken** (string)
+
+        maxResults reaches 5000 here, far above the 100 of the campaign
+        families, because associations grow with the number of tagged objects.
+
+        Requires one of these permissions:
+            campaign_edit, 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.5/ad_api/api/v1/selling_accounts.py

@@ -0,0 +1,47 @@
+from ad_api.base import Client, sp_endpoint, ApiResponse, Utils
+
+
+class SellingAccounts(Client):
+    r"""
+    SellingAccounts(account='default', marketplace: Marketplaces = Marketplaces.EU, credentials=None, debug=False)
+
+    Amazon Ads API v1 - selling accounts
+
+    One route, read only:
+
+        POST /adsApi/v1/query/sellingAccounts
+
+    No adProductFilter here: a selling account is the account behind the ads,
+    not an ad product. Every member of the request is optional, so an empty
+    body is a valid request.
+    """
+
+    @sp_endpoint('/adsApi/v1/query/sellingAccounts', method='POST')
+    def query_selling_accounts(self, **kwargs) -> ApiResponse:
+        r"""
+        query_selling_accounts(body: dict) -> ApiResponse
+
+        Amazon Ads API v1 - Query Selling Accounts (operationId: QuerySellingAccount)
+
+        Request Body [All optional]
+            | **sellingAccountLinkTokenFilter** (dict)
+            | **sellingProgramFilter** (dict)
+            | **maxResults** (int) : 10..100, default 100
+            | **nextToken** (string)
+
+        Returns
+            | **sellingAccounts** (list<SellingAccount>) : 0..100
+                | **sellingAccountLinkToken** (string) : [required] the token that locates the account
+                | **portals** (list<Portal>) : [required] 1..6
+                | **sellingProgram** (SellingProgram) : [required]
+                | **displayName** (string)
+                | **countryCodes** (list<CountryCode>) : 0..30
+                | **business** (SellingAccountBusiness)
+            | **nextToken** (string)
+
+        maxResults starts at 10, so a smaller value is a rejected body rather
+        than a shorter page.
+        """
+        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.5/ad_api/version.py

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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-amazon-ad-api
-Version: 1.5.3
+Version: 1.5.5
 Summary: Python wrapper for the Amazon Advertising API
 Home-page: https://github.com/denisneuf/python-amazon-ad-api
 Author: Daniel Alvaro
@@ -315,6 +315,8 @@ The v1 API lives under `/adsApi/v1/` and is **not** split by product: every call
 * [Labels](https://python-amazon-ad-api.readthedocs.io/en/latest/v1/labels.html#ad_api.api.v1.Labels.Labels.query_labels)
 * [Manager Accounts](https://python-amazon-ad-api.readthedocs.io/en/latest/v1/manager_accounts.html#ad_api.api.v1.ManagerAccounts.ManagerAccounts.query_manager_accounts)
 * [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)
 
 
 ### [Modules Available Sponsored Products](https://python-amazon-ad-api.readthedocs.io/en/latest/sp.html)

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

@@ -105,10 +105,12 @@ 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/label_object_associations.py
 ad_api/api/v1/labels.py
 ad_api/api/v1/manager_accounts.py
 ad_api/api/v1/recommendations.py
 ad_api/api/v1/reports.py
+ad_api/api/v1/selling_accounts.py
 ad_api/api/v1/targets.py
 ad_api/auth/__init__.py
 ad_api/auth/access_token_client.py

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

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

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

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

python_amazon_ad_api-1.5.3/ad_api/version.py

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