python-amazon-ad-api 1.1.6__py3-none-any.whl → 1.1.7__py3-none-any.whl

ad_api/api/sb/ad_creatives_v4.py

@@ -128,6 +128,92 @@ class AdCreativesV4(Client):
 
         return self._request(kwargs.pop('path'), data=Utils.convert_body(kwargs.pop('body'), False), params=kwargs, headers=headers)
 
+    @sp_endpoint('/sb/ads/creatives/autoCollection', method='POST')
+    def create_auto_collection_ad_creative(self, version: int = 4, **kwargs) -> ApiResponse:
+        """
+        Creates a new version of an auto collection creative for an existing ad.
+
+        Request Body [Required]
+            | **ads** (array): [required] One entry per ad.
+                | **adId** (string): [required] Sponsored Brands ad identifier.
+                | **creative** ({}): [required]
+                    | **brandName** (string): [required]
+                    | **brandLogoAssetID** (string): [optional]
+                    | **brandLogoCrop** ({}): [optional] ``top``, ``left``,
+                      ``width`` and ``height``.
+                    | **asinExclusions** (array of string): [optional]
+
+        Returns:
+            | ApiResponse
+
+        .. note::
+            This route takes ``application/vnd.sbadresource.v4+json``, the same
+            media type as the ads family, not the creative one.
+        """
+        json_version = 'application/vnd.sbadresource.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/ads/creatives/manualCollection', method='POST')
+    def create_manual_collection_ad_creative(self, version: int = 4, **kwargs) -> ApiResponse:
+        """
+        Creates a new version of a manual collection creative for an existing ad.
+
+        Request Body [Required]
+            | **ads** (array): [required] One entry per ad, each with ``adId``
+              and a ``creative`` block.
+
+        Returns:
+            | ApiResponse
+
+        .. note::
+            Also takes ``application/vnd.sbadresource.v4+json``.
+        """
+        json_version = 'application/vnd.sbadresource.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/ads/creatives/productCollectionExtended', method='POST')
+    @Utils.deprecated
+    def create_new_version_product_collection_extended_ad_creative(self, version: int = 4, **kwargs) -> ApiResponse:
+        """
+        Creates a new version of an extended product collection creative.
+
+        This route is flagged deprecated in the 4.0 contract. It still answers on
+        the live service, which is why it stays available, but new integrations
+        should use ``create_auto_collection_ad_creative`` or
+        ``create_manual_collection_ad_creative``.
+
+        Request Body [Required]
+            | **adId** (string): [required] Sponsored Brands ad identifier.
+            | **creative** ({}): [required]
+                | **asins** (array of string): [required]
+                | **brandName** (string): [required]
+                | **brandLogoAssetId** (string): [required]
+                | **headline** (string): [required]
+                | **landingPage** ({}): [optional] ``type``, ``url`` or ``asins``.
+                | **brandLogoCrop** ({}): [optional] ``top``, ``left``,
+                  ``width`` and ``height``.
+                | **customImages** (array): [optional] Each with ``assetId``,
+                  ``url`` and a ``crop``.
+                | **consentToTranslate** (boolean): [optional]
+
+        Returns:
+            | ApiResponse
+
+        .. note::
+            Unlike its siblings this route takes a single ``adId`` and
+            ``creative``, not an ``ads`` list, and it uses
+            ``application/vnd.sbAdCreativeResource.v4+json``. An empty body names
+            both required members.
+        """
+        json_version = 'application/vnd.sbAdCreativeResource.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/ads/creatives/list', method='POST')
     def list_ad_creatives(self, version: int = 4, **kwargs) -> ApiResponse:
         """

ad_api/api/sb/ads_v4.py

@@ -165,6 +165,85 @@ class AdsV4(Client):
 
         return self._request(kwargs.pop('path'), data=Utils.convert_body(kwargs.pop('body'), False), params=kwargs, headers=headers)
 
+    @sp_endpoint('/sb/v4/ads/autoCollection', method='POST')
+    def create_auto_collection_ads(self, version: int = 4, **kwargs) -> ApiResponse:
+        """
+        Creates Sponsored Brands auto collection ads.
+
+        Request Body [Required]
+            | **ads** (array): [required] One entry per ad.
+                | **adGroupId** (string): [required] Ad group the ad belongs to.
+                | **name** (string): [required] Ad name.
+                | **state** (string): [required] ``ENABLED``, ``PAUSED`` or
+                  ``ARCHIVED``.
+                | **creative** ({}): [required]
+                    | **brandName** (string): [required]
+                    | **brandLogoAssetID** (string): [optional]
+                    | **brandLogoCrop** ({}): [optional] ``top``, ``left``,
+                      ``width`` and ``height``.
+                    | **asinExclusions** (array of string): [optional]
+
+        Returns:
+            | ApiResponse
+
+        .. note::
+            An empty body answers ``400 INVALID_ARGUMENT`` with
+            *"Ad list cannot be empty."*, and ``application/json`` answers
+            ``404 Could not find resource``, so the versioned media type is what
+            routes the call.
+        """
+        json_version = 'application/vnd.sbadresource.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/ads/manualCollection', method='POST')
+    def create_manual_collection_ads(self, version: int = 4, **kwargs) -> ApiResponse:
+        """
+        Creates Sponsored Brands manual collection ads.
+
+        Request Body [Required]
+            | **ads** (array): [required] One entry per ad, each with
+              ``adGroupId``, ``name``, ``state`` and a ``creative`` block.
+
+        Returns:
+            | ApiResponse
+
+        .. note::
+            An empty body answers ``400 INVALID_ARGUMENT`` with
+            *"Ad list cannot be empty."*
+        """
+        json_version = 'application/vnd.sbadresource.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/ads/productCollectionExtended', method='POST')
+    @Utils.deprecated
+    def create_product_collection_extended_ads(self, version: int = 4, **kwargs) -> ApiResponse:
+        """
+        Creates Sponsored Brands extended product collection ads.
+
+        This route is flagged deprecated in the 4.0 contract, together with the
+        creative side of the same name. It still answers on the live service,
+        which is why it stays available, but new integrations should use
+        ``create_auto_collection_ads`` or ``create_manual_collection_ads``.
+
+        Request Body [Required]
+            | **ads** (array): [required] One entry per ad.
+
+        Returns:
+            | ApiResponse
+
+        .. note::
+            An empty body answers ``400 INVALID_ARGUMENT`` with
+            *"Ad list cannot be empty."*
+        """
+        json_version = 'application/vnd.sbadresource.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/ads/delete', method='POST')
     def delete_ads(self, version: int = 4, **kwargs) -> ApiResponse:
         """

ad_api/version.py

@@ -1 +1 @@
-__version__ = "1.1.6"
+__version__ = "1.1.7"

{python_amazon_ad_api-1.1.6.dist-info → python_amazon_ad_api-1.1.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-amazon-ad-api
-Version: 1.1.6
+Version: 1.1.7
 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.6.dist-info → python_amazon_ad_api-1.1.7.dist-info}/RECORD

@@ -1,5 +1,5 @@
 ad_api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-ad_api/version.py,sha256=fe1i7ytQ67cmOi4fKSpfB74e36dkRgec1zdg71uuRFM,22
+ad_api/version.py,sha256=p2qAfdU7zHOShJi2f1FW-_7Tbm0-KCPE7CI7284QiHg,22
 ad_api/api/__init__.py,sha256=E9c0ZyK4vplMlKKEBF8CV5u7P4uSkTMSQsAuSQu5bfY,1514
 ad_api/api/account.py,sha256=CmOvCfHoPWaeTUJvtB0pNoNulZVSz4oMMCKIpVTpHos,2931
 ad_api/api/advertising_test_account.py,sha256=btOVbdk2tBDmyKSJaQbcIFyzNG8KFJVUmTe4p9xMhpU,1507
@@ -25,10 +25,10 @@ ad_api/api/stores.py,sha256=7W3RJKZyZOQ3nHzInvK9FDhWTXCH6Xe9a6dCBatEZ-o,2484
 ad_api/api/stream.py,sha256=JpnF8SKniOAHiEnEq1RPrh6tNy-Q2-8GPBTmnlxEXqQ,2989
 ad_api/api/validation_configurations.py,sha256=V3o06uWGwvA_Ly1x2lAiCk35Wo7DC_k8AtHgMdpm6wU,3830
 ad_api/api/sb/__init__.py,sha256=APbCAkWM1gzYuhpEUU98XDIKJKJx1NXALjLBXA9zdBU,1538
-ad_api/api/sb/ad_creatives_v4.py,sha256=86sF2lhSc3AC6d4P5TXyEnJMBjn9HvsJe4bbCQbSWK0,10508
+ad_api/api/sb/ad_creatives_v4.py,sha256=zQzTivDkGzX3I5ZfCWIlzRUGWfTRsXJZCKQrKMaMDpc,14512
 ad_api/api/sb/ad_groups.py,sha256=W06Fk0CCsuEYen1Bd8obR6aHpOMhk6tGWNWApecw59c,2882
 ad_api/api/sb/ad_groups_v4.py,sha256=f6KpOrJ2RsCa4aznP8vdGbXp0HGsCmLOvC9yXX2pESc,3669
-ad_api/api/sb/ads_v4.py,sha256=EOn-ts0cPqCwt5vdGq6rkDHyYPoT6vbDP8UQE-TFjmE,7931
+ad_api/api/sb/ads_v4.py,sha256=s31OYVO6nyyKRgQAvMc4YtCcHhCo-Anx-r2kq22rPG8,11373
 ad_api/api/sb/benchmarks.py,sha256=eeWv2rrRf4ttK-oI1EEEiui_rl_sxJk9yXcu6sDSfhg,3645
 ad_api/api/sb/bid_recommendations.py,sha256=ssO9XwYC9wK2GFaLtcsC-D3cZhDpCclcu1r01LTkZAw,2297
 ad_api/api/sb/brands.py,sha256=XIMDzV0tJoPiOcY0KoCKcyIwYLPMlJ-zkB2SeRVMF4Q,1376
@@ -108,8 +108,8 @@ ad_api/base/exceptions.py,sha256=9D3M40ZIlLS0fA-aQh1BTWPOW-Nvf0tRhbA85jFnDJ4,438
 ad_api/base/helpers.py,sha256=naUkDLK466x_OBCPXxMlzRc2nPC6iQ6H_vyUji0MJJ0,2282
 ad_api/base/marketplaces.py,sha256=44lvCcluXNpqTprWQ80e3weSQmQbJoWL-WDSOWVbCyQ,4657
 ad_api/base/utils.py,sha256=_qnCBOvyJTLgaZjJzUWTi38GGLHkQszXELs79133Rb4,5618
-python_amazon_ad_api-1.1.6.dist-info/licenses/LICENSE,sha256=h2rpqlmmLy-4l1tN6KpWAFxx1JEMYeEFrMrZUbx_B_o,1105
-python_amazon_ad_api-1.1.6.dist-info/METADATA,sha256=z5F7aaY5WflWIew3RRAup1tAxtWYyE7sTzzSd2lwIfw,20486
-python_amazon_ad_api-1.1.6.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-python_amazon_ad_api-1.1.6.dist-info/top_level.txt,sha256=nN9twUos-8pkP514ZwpvRU9YL9L2XyQyHsMQFfudGTU,7
-python_amazon_ad_api-1.1.6.dist-info/RECORD,,
+python_amazon_ad_api-1.1.7.dist-info/licenses/LICENSE,sha256=h2rpqlmmLy-4l1tN6KpWAFxx1JEMYeEFrMrZUbx_B_o,1105
+python_amazon_ad_api-1.1.7.dist-info/METADATA,sha256=ySlzzw2eMqLcY38Pk2d32nnEH-zGKjcnpoB-PQ5fz2E,20486
+python_amazon_ad_api-1.1.7.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+python_amazon_ad_api-1.1.7.dist-info/top_level.txt,sha256=nN9twUos-8pkP514ZwpvRU9YL9L2XyQyHsMQFfudGTU,7
+python_amazon_ad_api-1.1.7.dist-info/RECORD,,