python-amazon-ad-api 0.9.8__py3-none-any.whl → 1.0.0__py3-none-any.whl

ad_api/api/__init__.py

@@ -12,6 +12,7 @@ from .audiences import Audiences
 from .portfolios import Portfolios
 from .portfolios_v3 import PortfoliosV3
 from .insights import Insights
+from . import v1
 from . import sp as sponsored_products
 from . import sb as sponsored_brands
 from . import sd as sponsored_display
@@ -26,6 +27,7 @@ from .exports import Exports
 from .stores import Stores
 
 __all__ = [
+    "v1",
     "sp",
     "sb",
     "sd",

ad_api/api/sp/campaigns.py

@@ -396,167 +396,3 @@ class Campaigns(Client):
     #     """
     #     return self._request(fill_query_params(kwargs.pop('path'), campaignId), params=kwargs)
     #
-    @sp_endpoint('/adsApi/v1/query/campaigns', method='POST')
-    def query_campaigns(self, **kwargs) -> ApiResponse:
-        r"""
-        query_campaigns(body: dict) -> ApiResponse
-
-        Amazon Ads API v1 - Query Campaigns (operationId: QueryCampaign)
-
-        Request Body [Required]
-            | **adProductFilter** (dict): [required]
-                | **include** (list<AdProduct>) : Enum [ AMAZON_DSP, SPONSORED_BRANDS, SPONSORED_DISPLAY, SPONSORED_PRODUCTS, SPONSORED_TELEVISION ]
-            | **campaignIdFilter** (dict) [optional]
-                | **include** (list<string>) : Campaign identifiers
-            | **goalFilter** (dict) [optional]
-                | **include** (list<Goal>) : Enum [ AWARENESS, CONSIDERATION, CONVERSIONS ]
-            | **marketplaceScopeFilter** (dict) [optional]
-                | **include** (list<MarketplaceScope>) : Enum [ GLOBAL, SINGLE_MARKETPLACE ]
-            | **nameFilter** (dict) [optional]
-                | **include** (list<string>) : Campaign names
-                | **queryTermMatchType** (string) : [required] Enum [ BROAD_MATCH, EXACT_MATCH ]
-            | **portfolioIdFilter** (dict) [optional]
-                | **include** (list<string>) : Portfolio identifiers
-            | **retailerScopeFilter** (dict) [optional]
-                | **include** (list<RetailerScope>) : Enum [ AMAZON, OTHER_RETAILERS ]
-            | **stateFilter** (dict) [optional]
-                | **include** (list<State>) : Enum [ ARCHIVED, DRAFT, ENABLED, PAUSED ]
-            | **maxResults** (int) [optional] Minimum 1, Maximum 1000
-            | **nextToken** (string) [optional] Token to navigate to the next page
-
-        Headers
-            | **Amazon-Ads-AccountId** (string) [optional] Advertiser account identifier
-
-        Returns
-            ApiResponse
-                | **campaigns** (list), **nextToken** (string)
-
-        """
-        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)
-
-    @sp_endpoint('/adsApi/v1/delete/campaigns', method='POST')
-    def delete_campaigns(self, **kwargs) -> ApiResponse:
-        r"""
-        delete_campaigns(body: dict) -> ApiResponse
-
-        Amazon Ads API v1 - Delete Campaigns (operationId: DeleteCampaign)
-
-        Request Body [Required]
-            | **campaignIds** (list<string>) : [required] Campaign identifiers to delete
-
-        Headers
-            | **Amazon-Ads-AccountId** (string) [optional] Advertiser account identifier
-
-        Returns
-            ApiResponse
-                | **207** MultiStatus response with partial errors. Inspect the payload
-                  to know which campaign ids succeeded and which failed.
-
-        """
-        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)
-
-    @sp_endpoint('/adsApi/v1/update/campaigns', method='POST')
-    def update_campaigns(self, **kwargs) -> ApiResponse:
-        r"""
-        update_campaigns(body: dict) -> ApiResponse
-
-        Amazon Ads API v1 - Update Campaigns (operationId: UpdateCampaign)
-
-        Request Body [Required]
-            | **campaigns** (list<dict>) : [required] One or more campaign objects to update.
-              Each object requires **campaignId** and may include any of the fields below.
-
-        Campaign fields [optional except campaignId]
-            | **campaignId** (string) : [required] The identifier of the campaign to update.
-            | **adProduct** (string) : Enum [ AMAZON_DSP, SPONSORED_BRANDS, SPONSORED_DISPLAY, SPONSORED_PRODUCTS, SPONSORED_TELEVISION ]
-            | **name** (string) : The name of the campaign.
-            | **state** (string) : Enum [ DRAFT, ENABLED, PAUSED ]
-            | **budgets** (list<dict>) : Budget objects for the campaign.
-            | **startDateTime** (string) : Campaign start date and time.
-            | **endDateTime** (string) : Campaign end date and time.
-            | **portfolioId** (string) : The identifier of the portfolio.
-            | **purchaseOrderNumber** (string) : Advertiser purchase order number.
-            | **tags** (list<dict>) : Advertiser-specified custom identifiers.
-            | **marketplaces** (list<dict>) : Marketplaces where the campaign runs.
-            | **marketplaceConfigurations** (list<dict>) : Per-marketplace overrides.
-            | **countries** (list<string>) : Country codes.
-            | **costType** (string) : Enum [ CPC, CPM, FIXED_PRICE, VCPM ]
-            | **fees** (list<dict>) : Fee definitions.
-            | **flights** (list<dict>) : Flight schedules.
-            | **frequencies** (list<dict>) : Frequency cap definitions.
-            | **optimizations** (dict) : Campaign optimization settings.
-            | **siteRestrictions** (list<dict>) : Site restrictions.
-            | **skanAppId** (string) : SKAdNetwork app id.
-            | **targetedPGDealId** (string) : Targeted programmatic guaranteed deal id.
-            | **adomains** (list<string>) : Ad domains.
-
-        Headers
-            | **Amazon-Ads-AccountId** (string) [optional] Advertiser account identifier
-
-        Returns
-            ApiResponse
-                | **207** MultiStatus response with partial errors. Inspect the payload
-                  to know which campaigns succeeded and which failed.
-
-        """
-        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)
-
-    @sp_endpoint('/adsApi/v1/create/campaigns', method='POST')
-    def create_campaigns(self, **kwargs) -> ApiResponse:
-        r"""
-        create_campaigns(body: dict) -> ApiResponse
-
-        Amazon Ads API v1 - Create Campaigns (operationId: CreateCampaign)
-
-        Request Body [Required]
-            | **campaigns** (list<dict>) : [required] One or more campaign objects to create.
-              Each object requires **adProduct**, **name** and **state**.
-
-        Campaign fields
-            | **adProduct** (string) : [required] Enum [ AMAZON_DSP, SPONSORED_BRANDS, SPONSORED_DISPLAY, SPONSORED_PRODUCTS, SPONSORED_TELEVISION ]
-            | **name** (string) : [required] The name of the campaign.
-            | **state** (string) : [required] Enum [ DRAFT, ENABLED, PAUSED ]
-            | **budgets** (list<dict>) : Budget objects for the campaign.
-                | **budgetType** (string) : [required] Budget type.
-                | **budgetValue** (dict) : [required] Budget amount.
-                | **recurrenceTimePeriod** (string) : [required] Recurrence period.
-            | **startDateTime** (string) : Campaign start date and time.
-            | **endDateTime** (string) : Campaign end date and time.
-            | **portfolioId** (string) : The identifier of the portfolio.
-            | **purchaseOrderNumber** (string) : Advertiser purchase order number.
-            | **tags** (list<dict>) : [required key+value] Advertiser-specified custom identifiers.
-            | **marketplaces** (list<dict>) : Marketplaces where the campaign runs.
-            | **marketplaceConfigurations** (list<dict>) : Per-marketplace overrides, each with
-              **marketplace** and **overrides** (both required).
-            | **countries** (list<string>) : Country codes.
-            | **costType** (string) : Enum [ CPC, CPM, FIXED_PRICE, VCPM ]
-            | **fees** (list<dict>) : [required feeType+feeValue+feeValueType] Fee definitions.
-            | **flights** (list<dict>) : [required budget+startDateTime+endDateTime] Flight schedules.
-            | **frequencies** (list<dict>) : [required eventMaxCount+frequencyTargetingSetting+
-              timeCount+timeUnit] Frequency cap definitions.
-            | **optimizations** (dict) : Campaign optimization settings.
-            | **siteRestrictions** (list<dict>) : Site restrictions.
-            | **brandId** (string) : Brand identifier.
-            | **skanAppId** (string) : SKAdNetwork app id.
-            | **targetedPGDealId** (string) : Targeted programmatic guaranteed deal id.
-            | **adomains** (list<string>) : Ad domains.
-            | **autoCreationSettings** (dict) : Automatic creation settings.
-
-        Headers
-            | **Amazon-Ads-AccountId** (string) [optional] Advertiser account identifier
-
-        Returns
-            ApiResponse
-                | **207** MultiStatus response with partial errors. Inspect the payload
-                  to know which campaigns were created and which failed.
-
-        """
-        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)

ad_api/version.py

@@ -1 +1 @@
-__version__ = "0.9.8"
+__version__ = "1.0.0"

{python_amazon_ad_api-0.9.8.dist-info → python_amazon_ad_api-1.0.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-amazon-ad-api
-Version: 0.9.8
+Version: 1.0.0
 Summary: Python wrapper for the Amazon Advertising API
 Home-page: https://github.com/denisneuf/python-amazon-ad-api
 Author: Daniel Alvaro
@@ -299,9 +299,13 @@ There is a new version 3 Portfolios API, please check the [migration guide](http
 * [Get test account information](https://python-amazon-ad-api.readthedocs.io/en/latest/api/advertising_test_account.html#ad_api.api.AdvertisingTestAccount.AdvertisingTestAccount.get_test_account)
 
 
-### Sponsored Products v1 (new)
+### Amazon Ads API v1 (new, unified)
 
-New unified endpoint generation. Campaigns are queried with a single `POST /adsApi/v1/query/campaigns` resource instead of the versioned v2/v3 endpoints.
+The v1 API lives under `/adsApi/v1/` and is **not** split by product: every call targets the same resource and the product is selected in the request body with `adProductFilter`. It supersedes the per-product v2/v3 endpoints.
+
+```python
+from ad_api.api import v1
+```
 
 | Method | Endpoint | Body |
 |---|---|---|
@@ -313,9 +317,9 @@ New unified endpoint generation. Campaigns are queried with a single `POST /adsA
 All four return a **207 MultiStatus** response (except `query_campaigns`, which returns 200), so check the payload for per-entity errors.
 
 ```python
-from ad_api.api import sponsored_products
+from ad_api.api import v1
 
-result = sponsored_products.Campaigns(credentials=credentials, debug=True).query_campaigns(
+result = v1.Campaigns(credentials=credentials, debug=True).query_campaigns(
     body={
         "adProductFilter": {"include": ["SPONSORED_PRODUCTS"]},
         "stateFilter": {"include": ["ENABLED"]},

{python_amazon_ad_api-0.9.8.dist-info → python_amazon_ad_api-1.0.0.dist-info}/RECORD

@@ -1,6 +1,6 @@
 ad_api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-ad_api/version.py,sha256=GI3Cr15wC6XhdahtMoSOf62d2gYve5G_PiR_xx_RGKc,22
-ad_api/api/__init__.py,sha256=rurlFrTJZgSGNdkEahAJGjDAVll2KyCqpLpV40ZKI6o,1487
+ad_api/version.py,sha256=J-j-u0itpEFT6irdmWmixQqYMadNl1X91TxUmoiLHMI,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
 ad_api/api/attribution.py,sha256=vHmXP0wDqhEqaS1q3tJyERxJ1JwntqoEb73LVXNHxR0,5121
@@ -83,7 +83,7 @@ ad_api/api/sp/campaign_consolidated_recommendations.py,sha256=AZS8A0ZH_GRCZ5uExq
 ad_api/api/sp/campaign_negative_keywords.py,sha256=4Jj8CFt4YX36N4YhXDDVabOiPOfCtQ2kYqYoS2Xejoc,6344
 ad_api/api/sp/campaign_negative_keywords_v3.py,sha256=3y5PHA_r6GtBAFbAXiGH5q6ByWsG2alA3DCqdRiaO3w,6592
 ad_api/api/sp/campaign_negative_targets.py,sha256=5fzt3wU1omOrGELtwSs4-R1BCcaT8z5H0StjJfCuc9k,8310
-ad_api/api/sp/campaigns.py,sha256=L_6lHAT3mrwyP9K4xqwgMBTzth5_oSMSNZNhpaVoH6o,30910
+ad_api/api/sp/campaigns.py,sha256=5N8wsB4-tgbOE61f4aNY9VZRz8EZE6zJ8pyLVcSxU14,21790
 ad_api/api/sp/campaigns_budget_usage.py,sha256=njn-Wd3xvbJbL5HMSNQK4RyxCgAflqUgVFo7XhlXmB8,862
 ad_api/api/sp/campaigns_v3.py,sha256=enxuRqoyBeidwR9J5VcPHFDRbiy2G6EEQqKRyaJPI5I,7831
 ad_api/api/sp/campaings_optimization.py,sha256=CrH9x-KNTsRc56tn_TCDxDTZIF9pYdqDT48LTepys2w,6673
@@ -118,8 +118,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-0.9.8.dist-info/licenses/LICENSE,sha256=h2rpqlmmLy-4l1tN6KpWAFxx1JEMYeEFrMrZUbx_B_o,1105
-python_amazon_ad_api-0.9.8.dist-info/METADATA,sha256=9mf-kIA1iXGxcU5F7Dn7z8L8FrWEhvHnxmJRkQcaCk4,20491
-python_amazon_ad_api-0.9.8.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-python_amazon_ad_api-0.9.8.dist-info/top_level.txt,sha256=nN9twUos-8pkP514ZwpvRU9YL9L2XyQyHsMQFfudGTU,7
-python_amazon_ad_api-0.9.8.dist-info/RECORD,,
+python_amazon_ad_api-1.0.0.dist-info/licenses/LICENSE,sha256=h2rpqlmmLy-4l1tN6KpWAFxx1JEMYeEFrMrZUbx_B_o,1105
+python_amazon_ad_api-1.0.0.dist-info/METADATA,sha256=IAMgFDqSjs6l7wOw3Ewlm3ecsx6hm9_ifctFukgK1PA,20577
+python_amazon_ad_api-1.0.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+python_amazon_ad_api-1.0.0.dist-info/top_level.txt,sha256=nN9twUos-8pkP514ZwpvRU9YL9L2XyQyHsMQFfudGTU,7
+python_amazon_ad_api-1.0.0.dist-info/RECORD,,