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

ad_api/api/sp/campaigns.py

@@ -10,417 +10,551 @@ class Campaigns(Client):
 
     """
 
-    @sp_endpoint('/v2/sp/campaigns', method='PUT')
-    @Utils.deprecated
-    def edit_single_campaign_assistant(
-        self,
-        campaign_id: int,
-        portfolio_id: int = None,
-        campaign_name: str = None,
-        po_number: str = None,
-        account_manager: str = None,
-        campaign_status: str = None,
-        daily_budget: int = None,
-        start_date: str = None,
-        end_date: str = None,
-        premium_bid_adjustment: bool = None,
-        strategy: str = None,
-        predicate: str or tuple = None,
-        percentage: str or tuple = None,
-        **kwargs,
-    ) -> ApiResponse:
-        r"""
-        edit_single_campaign_assistant(campaign_id: int, portfolio_id: int = None, campaign_name: str, po_number: str = None, account_manager: str = None, campaign_status: str = None, daily_budget: int, start_date: str, end_date: str = None, premium_bid_adjustment: bool = None, strategy:str = None, predicate:str or tuple = None, percentage:int or tuple = None, **kwargs) -> ApiResponse
-
-        Edit one campaigns and create the body based on the params provided, at least one of the optional params need to be set or a INVALID_ARGUMENT code is thorwn
-
-        Kwargs:
-            | **campaign_id** (number): [required] The identifier of an existing campaign to update.
-            | **portfolio_id** (number): [optional] The identifier of an existing portfolio to which the campaign is associated
-            | **campaign_name** (string): [optional] A name for the campaign
-            | **po_number** (string): [optional] 'A list of advertiser-specified custom identifiers for the campaign. Each customer identifier is a key-value pair. You can specify a maximum of 50 identifiers
-            | **account_manager** (string): [optional] A list of advertiser-specified custom identifiers for the campaign. Each customer identifier is a key-value pair. You can specify a maximum of 50 identifiers
-            | **campaign_status**': (string): [optional] The current resource state Values: enabled, paused, archived. Default: enabled
-            | **daily_budget** (float): [optional] A daily budget for the campaign
-            | **start_date** (string): [optional] A starting date for the campaign to go live. The format of the date is YYYYMMDD
-            | **end_date** (string): [optional] An ending date for the campaign to stop running. The format of the date is YYYYMMDD
-            | **premium_bid_adjustment**' (boolean): [optional] If set to true, Amazon increases the default bid for ads that are eligible to appear in this placement. See developer notes for more information. Tip: When Campaign has been adopted to enhanced bidding premiumBidAdjustment can not be set
-            | **strategy** (string): [optional] The bidding strategy. 'Values': legacyForSales (Dynamic bids - down only), autoForSales (Dynamic bids - up and down), manual (Fixed bid)
-            | **predicate** (string or tuple(str)): [optional] You can enable controls to adjust your bid based on the placement location. Specify a location where you want to use bid controls. The percentage value set is the percentage of the original bid for which you want to have your bid adjustment increased. For example, a 50% adjustment on a $1.00 bid would increase the bid to $1.50 for the opportunity to win a specified placement. 'Values':  placementTop (str), placementProductPage (str), ("placementTop", "placementProductPage") (tuple)
-            | **percentage** (float or tuple(float)): [optional] The bid adjustment percentage value. Example: 15 (float), (15, 25) (tuple)
-
-        Returns:
-
-            ApiResponse
-
-        """
-
-        optional = {}
-
-        if portfolio_id is not None:
-            optional.update({'portfolioId': portfolio_id})
-
-        if campaign_name is not None:
-            optional.update({'name': campaign_name})
-
-        if po_number is not None and account_manager is not None:
-            optional.update({"tags": {'PONumber': po_number, 'accountManager': account_manager}})
-
-        if campaign_status is not None:
-            optional.update({'state': campaign_status})
-
-        if daily_budget is not None:
-            optional.update({'dailyBudget': daily_budget})
-
-        if start_date is not None:
-            optional.update({'startDate': start_date})
-
-        if end_date is not None:
-            optional.update({'endDate': end_date})
-
-        if premium_bid_adjustment is not None:
-            optional.update({'premiumBidAdjustment': premium_bid_adjustment})
-
-        if strategy is not None and predicate is None and percentage is None:
-            optional.update({'bidding': {'strategy': strategy, 'adjustments': []}})
-
-        if strategy is not None and predicate is not None and percentage is not None:
-            if isinstance(predicate, str):
-                optional.update(
-                    {
-                        'bidding': {
-                            'strategy': strategy,
-                            'adjustments': [{'predicate': predicate, 'percentage': percentage}],
-                        }
-                    }
-                )
-
-            if isinstance(predicate, tuple) and len(predicate) == 2 and len(percentage) == 2:
-                options = []
-                for i in range(len(predicate)):
-                    option = {"predicate": predicate[i], "percentage": percentage[i]}
-                    options.append(option)
-
-                bidding = {'strategy': strategy, 'adjustments': options}
-
-                dictionary = {}
-                dictionary["bidding"] = bidding
-
-                optional.update(dictionary)
-
-        required = {
-            'campaignId': campaign_id,
-        }
-
-        if not optional:
-            description = 'No changes submitted for entity %s' % campaign_id
-            obj = [{'code': 'INVALID_ARGUMENT', 'description': description}]
-            return ApiResponse(obj)
-        else:
-            required.update(optional)
-            data_str = json.dumps([required])
-            return self._request(kwargs.pop('path'), data=data_str, params=kwargs)
-
-    @sp_endpoint('/v2/sp/campaigns', method='POST')
-    @Utils.deprecated
-    def create_single_campaign_assistant(
-        self,
-        campaign_name: str,
-        targeting_type: str,
-        daily_budget: int,
-        start_date: str,
-        end_date: str = None,
-        campaign_status: str = "enabled",
-        portfolio_id: int = None,
-        po_number: str = None,
-        account_manager: str = None,
-        premium_bid_adjustment: bool = None,
-        strategy: str = None,
-        predicate: str or tuple = None,
-        percentage: int or tuple = None,
-        **kwargs,
-    ) -> ApiResponse:
-        r"""
-        create_single_campaign_assistant(campaign_name: str,targeting_type: str, daily_budget: int, start_date: str, end_date: str = None, campaign_status: str = "enabled", portfolio_id: int = None, po_number: str = None, account_manager: str = None, premium_bid_adjustment: bool = False, strategy:str = None, predicate:str = None, percentage:int = None, **kwargs) -> ApiResponse
-
-        Creates one campaigns and create the body based on the params provided
-
-        Kwargs:
-
-            | **campaign_name** (string): [required] A name for the campaign
-            | **campaign_type** (string): [fixed] The advertising product managed by this campaign. Value: sponsoredProducts
-            | **targeting_type** (string): [required] The type of targeting for the campaign. Values: manual, auto
-            | **daily_budget** (float): [required] A daily budget for the campaign
-            | **start_date** (string): [required] A starting date for the campaign to go live. The format of the date is YYYYMMDD
-            | **end_date** (string): [optional] An ending date for the campaign to stop running. The format of the date is YYYYMMDD
-            | **campaign_status**': (string): [optional] The current resource state Values: enabled, paused, archived. Default: enabled
-            | **portfolio_id** (number): [optional] The identifier of an existing portfolio to which the campaign is associated
-            | **po_number** (string): [optional] 'A list of advertiser-specified custom identifiers for the campaign. Each customer identifier is a key-value pair. You can specify a maximum of 50 identifiers
-            | **account_manager** (string): [optional] A list of advertiser-specified custom identifiers for the campaign. Each customer identifier is a key-value pair. You can specify a maximum of 50 identifiers
-            | **premium_bid_adjustment**' (boolean) If set to true, Amazon increases the default bid for ads that are eligible to appear in this placement. See developer notes for more information.
-            | **strategy** (string): [optional] The bidding strategy. 'Values': legacyForSales (Dynamic bids - down only), autoForSales (Dynamic bids - up and down), manual (Fixed bid)
-            | **predicate** (string): [optional] You can enable controls to adjust your bid based on the placement location. Specify a location where you want to use bid controls. The percentage value set is the percentage of the original bid for which you want to have your bid adjustment increased. For example, a 50% adjustment on a $1.00 bid would increase the bid to $1.50 for the opportunity to win a specified placement. 'Values':  placementTop, placementProductPage
-            | **percentage** (float): [optional] The bid adjustment percentage value.
-
-        Returns:
-
-            ApiResponse
-
-        """
-
-        optional = {}
-
-        if portfolio_id is not None:
-            optional.update({'portfolioId': portfolio_id})
-
-        if po_number is not None and account_manager is not None:
-            optional.update({"tags": {'PONumber': po_number, 'accountManager': account_manager}})
-
-        if end_date is not None:
-            optional.update({'endDate': end_date})
-
-        if premium_bid_adjustment is not None:
-            optional.update({'premiumBidAdjustment': premium_bid_adjustment})
-
-        if strategy is not None and predicate is not None and percentage is not None:
-            if isinstance(predicate, str):
-                optional.update(
-                    {
-                        'bidding': {
-                            'strategy': strategy,
-                            'adjustments': [{'predicate': predicate, 'percentage': percentage}],
-                        }
-                    }
-                )
-
-            if isinstance(predicate, tuple) and len(predicate) == 2 and len(percentage) == 2:
-                options = []
-                for i in range(len(predicate)):
-                    option = {"predicate": predicate[i], "percentage": percentage[i]}
-                    options.append(option)
-
-                bidding = {'strategy': strategy, 'adjustments': options}
-
-                dictionary = {}
-                dictionary["bidding"] = bidding
-
-                optional.update(dictionary)
-
-        required = {
-            'name': campaign_name,
-            'campaignType': 'sponsoredProducts',
-            'targetingType': targeting_type,
-            'state': campaign_status,
-            'dailyBudget': daily_budget,
-            'startDate': start_date,
-        }
-
-        if optional:
-            required.update(optional)
-
-        data_str = json.dumps([required])
-        return self._request(kwargs.pop('path'), data=data_str, params=kwargs)
-
-    @sp_endpoint('/v2/sp/campaigns', method='POST')
-    @Utils.deprecated
-    def create_campaigns(self, **kwargs) -> ApiResponse:
-        r"""
-        create_campaigns(body: (dict, str, list)) -> ApiResponse
-
-        Creates one or more campaigns.
-
-        body: | REQUIRED {'description': 'An array of campaigns.}'
-
-            | '**portfolioId**': *number*, {'description': 'The identifier of an existing portfolio to which the campaign is associated'}
-            | '**name**': *string*, {'description': 'A name for the campaign'}
-            | '**tags**': *string*, {'description': 'A list of advertiser-specified custom identifiers for the campaign. Each customer identifier is a key-value pair. You can specify a maximum of 50 identifiers.'}
-            | '**campaignType**': *string*, {'description': 'The advertising product managed by this campaign', 'Enum': '[ sponsoredProducts ]'}
-            | '**targetingType**': *string*, {'description': 'The type of targeting for the campaign.', 'Enum': '[ manual, auto ]'}
-            | '**state**': *string*, {'description': 'The current resource state.', 'Enum': '[ enabled, paused, archived ]'}
-            | '**dailyBudget**': *number($float)*, {'description': 'A daily budget for the campaign.'}
-            | '**startDate**': *string*, {'description': 'A starting date for the campaign to go live. The format of the date is YYYYMMDD.'}
-            | '**endDate**': *string* nullable: true, {'description': 'An ending date for the campaign to stop running. The format of the date is YYYYMMDD.'}
-            | '**premiumBidAdjustment**': *boolean*, {'description': 'If set to true, Amazon increases the default bid for ads that are eligible to appear in this placement. See developer notes for more information.'}
-            | '**bidding**': *Bidding*, {'strategy': 'string', 'Enum': '[ legacyForSales, autoForSales, manual ]', 'adjustments': '{...}'}
-
-        Returns:
-
-            ApiResponse
-
-        """
-        body = Utils.convert_body(kwargs.pop('body'))
-        return self._request(kwargs.pop('path'), data=body, params=kwargs)
-
-    @sp_endpoint('/v2/sp/campaigns', method='PUT')
-    @Utils.deprecated
-    def edit_campaigns(self, **kwargs) -> ApiResponse:
-        r"""
-        edit_campaigns(body: (dict, str, list)) -> ApiResponse
-
-        Updates one or more campaigns.
-
-        body: | REQUIRED {'description': 'An array of campaigns.}'
-
-            | '**campaignId**': *number*, {'description': 'The identifier of an existing campaign to update.'}
-            | '**portfolioId**': *number*, {'description': 'The identifier of an existing portfolio to which the campaign is associated'}
-            | '**name**': *string*, {'description': 'The name for the campaign'}
-            | '**tags**': *CampaignTags*, {'description': 'A list of advertiser-specified custom identifiers for the campaign. Each customer identifier is a key-value pair. You can specify a maximum of 50 identifiers.'}
-            | '**state**': *string*, {'description': 'The current resource state.', 'Enum': '[ enabled, paused, archived ]'}
-            | '**dailyBudget**': *number($float)*, {'description': 'The daily budget for the campaign.'}
-            | '**startDate**': *string*, {'description': 'The starting date for the campaign to go live. The format of the date is YYYYMMDD.'}
-            | '**endDate**': *string* nullable: true, {'description': 'The ending date for the campaign to stop running. The format of the date is YYYYMMDD.'}
-            | '**premiumBidAdjustment**': *boolean*, {'description': 'If set to true, Amazon increases the default bid for ads that are eligible to appear in this placement. See developer notes for more information.'}
-            | '**bidding**': *Bidding*, {'strategy': 'string', 'Enum': '[ legacyForSales, autoForSales, manual ]', 'adjustments': '{...}'}
-
-        Returns:
-
-            ApiResponse
-
-        """
-        body = Utils.convert_body(kwargs.pop('body'))
-        return self._request(kwargs.pop('path'), data=body, params=kwargs)
-
-    @sp_endpoint('/v2/sp/campaigns', method='GET')
-    @Utils.deprecated
-    def list_campaigns(self, **kwargs) -> ApiResponse:
-        r"""
-        list_campaigns(**kwargs) -> ApiResponse
-
-        Gets an array of campaigns.
-
-            query **startIndex**:*integer* | Optional. 0-indexed record offset for the result set. Default value : 0
-
-            query **count**:*integer* | Optional. Number of records to include in the paged response. Defaults to max page size.
-
-            query **stateFilter**:*string* | Optional. The returned array is filtered to include only ad groups with state set to one of the values in the specified comma-delimited list. Available values : enabled, paused, archived, enabled, paused, enabled, archived, paused, archived, enabled, paused, archived Default value : enabled, paused, archived.
-
-            query **name**:*string* | Optional. Restricts results to campaigns with the specified name.
-
-            query **portfolioIdFilter**:*string* | Optional. A comma-delimited list of portfolio identifiers.
-
-            query **campaignIdFilter**:*string* | Optional. A comma-delimited list of campaign identifiers.
-
-        Returns:
-
-            ApiResponse
-
-        """
-        return self._request(kwargs.pop('path'), params=kwargs)
-
-    @sp_endpoint('/v2/sp/campaigns/{}', method='GET')
-    @Utils.deprecated
-    def get_campaign(self, campaignId, **kwargs) -> ApiResponse:
-        r"""
-
-        get_campaign(campaignId: int) -> ApiResponse
-
-        Gets a campaign specified by identifier.
-
-            path **campaignId**:*number* | Required. The identifier of an existing campaign.
-
-        Returns:
-
-            ApiResponse
-
-        """
-        return self._request(fill_query_params(kwargs.pop('path'), campaignId), params=kwargs)
-
-    @sp_endpoint('/v2/sp/campaigns/{}', method='DELETE')
-    @Utils.deprecated
-    def delete_campaign(self, campaignId, **kwargs) -> ApiResponse:
+    # DEPRECATED v2 — superseded by v1 endpoints. Kept commented for reference.
+    # @sp_endpoint('/v2/sp/campaigns', method='PUT')
+    # @Utils.deprecated
+    # def edit_single_campaign_assistant(
+    #     self,
+    #     campaign_id: int,
+    #     portfolio_id: int = None,
+    #     campaign_name: str = None,
+    #     po_number: str = None,
+    #     account_manager: str = None,
+    #     campaign_status: str = None,
+    #     daily_budget: int = None,
+    #     start_date: str = None,
+    #     end_date: str = None,
+    #     premium_bid_adjustment: bool = None,
+    #     strategy: str = None,
+    #     predicate: str or tuple = None,
+    #     percentage: str or tuple = None,
+    #     **kwargs,
+    # ) -> ApiResponse:
+    #     r"""
+    #     edit_single_campaign_assistant(campaign_id: int, portfolio_id: int = None, campaign_name: str, po_number: str = None, account_manager: str = None, campaign_status: str = None, daily_budget: int, start_date: str, end_date: str = None, premium_bid_adjustment: bool = None, strategy:str = None, predicate:str or tuple = None, percentage:int or tuple = None, **kwargs) -> ApiResponse
+    #
+    #     Edit one campaigns and create the body based on the params provided, at least one of the optional params need to be set or a INVALID_ARGUMENT code is thorwn
+    #
+    #     Kwargs:
+    #         | **campaign_id** (number): [required] The identifier of an existing campaign to update.
+    #         | **portfolio_id** (number): [optional] The identifier of an existing portfolio to which the campaign is associated
+    #         | **campaign_name** (string): [optional] A name for the campaign
+    #         | **po_number** (string): [optional] 'A list of advertiser-specified custom identifiers for the campaign. Each customer identifier is a key-value pair. You can specify a maximum of 50 identifiers
+    #         | **account_manager** (string): [optional] A list of advertiser-specified custom identifiers for the campaign. Each customer identifier is a key-value pair. You can specify a maximum of 50 identifiers
+    #         | **campaign_status**': (string): [optional] The current resource state Values: enabled, paused, archived. Default: enabled
+    #         | **daily_budget** (float): [optional] A daily budget for the campaign
+    #         | **start_date** (string): [optional] A starting date for the campaign to go live. The format of the date is YYYYMMDD
+    #         | **end_date** (string): [optional] An ending date for the campaign to stop running. The format of the date is YYYYMMDD
+    #         | **premium_bid_adjustment**' (boolean): [optional] If set to true, Amazon increases the default bid for ads that are eligible to appear in this placement. See developer notes for more information. Tip: When Campaign has been adopted to enhanced bidding premiumBidAdjustment can not be set
+    #         | **strategy** (string): [optional] The bidding strategy. 'Values': legacyForSales (Dynamic bids - down only), autoForSales (Dynamic bids - up and down), manual (Fixed bid)
+    #         | **predicate** (string or tuple(str)): [optional] You can enable controls to adjust your bid based on the placement location. Specify a location where you want to use bid controls. The percentage value set is the percentage of the original bid for which you want to have your bid adjustment increased. For example, a 50% adjustment on a $1.00 bid would increase the bid to $1.50 for the opportunity to win a specified placement. 'Values':  placementTop (str), placementProductPage (str), ("placementTop", "placementProductPage") (tuple)
+    #         | **percentage** (float or tuple(float)): [optional] The bid adjustment percentage value. Example: 15 (float), (15, 25) (tuple)
+    #
+    #     Returns:
+    #
+    #         ApiResponse
+    #
+    #     """
+    #
+    #     optional = {}
+    #
+    #     if portfolio_id is not None:
+    #         optional.update({'portfolioId': portfolio_id})
+    #
+    #     if campaign_name is not None:
+    #         optional.update({'name': campaign_name})
+    #
+    #     if po_number is not None and account_manager is not None:
+    #         optional.update({"tags": {'PONumber': po_number, 'accountManager': account_manager}})
+    #
+    #     if campaign_status is not None:
+    #         optional.update({'state': campaign_status})
+    #
+    #     if daily_budget is not None:
+    #         optional.update({'dailyBudget': daily_budget})
+    #
+    #     if start_date is not None:
+    #         optional.update({'startDate': start_date})
+    #
+    #     if end_date is not None:
+    #         optional.update({'endDate': end_date})
+    #
+    #     if premium_bid_adjustment is not None:
+    #         optional.update({'premiumBidAdjustment': premium_bid_adjustment})
+    #
+    #     if strategy is not None and predicate is None and percentage is None:
+    #         optional.update({'bidding': {'strategy': strategy, 'adjustments': []}})
+    #
+    #     if strategy is not None and predicate is not None and percentage is not None:
+    #         if isinstance(predicate, str):
+    #             optional.update(
+    #                 {
+    #                     'bidding': {
+    #                         'strategy': strategy,
+    #                         'adjustments': [{'predicate': predicate, 'percentage': percentage}],
+    #                     }
+    #                 }
+    #             )
+    #
+    #         if isinstance(predicate, tuple) and len(predicate) == 2 and len(percentage) == 2:
+    #             options = []
+    #             for i in range(len(predicate)):
+    #                 option = {"predicate": predicate[i], "percentage": percentage[i]}
+    #                 options.append(option)
+    #
+    #             bidding = {'strategy': strategy, 'adjustments': options}
+    #
+    #             dictionary = {}
+    #             dictionary["bidding"] = bidding
+    #
+    #             optional.update(dictionary)
+    #
+    #     required = {
+    #         'campaignId': campaign_id,
+    #     }
+    #
+    #     if not optional:
+    #         description = 'No changes submitted for entity %s' % campaign_id
+    #         obj = [{'code': 'INVALID_ARGUMENT', 'description': description}]
+    #         return ApiResponse(obj)
+    #     else:
+    #         required.update(optional)
+    #         data_str = json.dumps([required])
+    #         return self._request(kwargs.pop('path'), data=data_str, params=kwargs)
+    #
+    # DEPRECATED v2 — superseded by v1 endpoints. Kept commented for reference.
+    # @sp_endpoint('/v2/sp/campaigns', method='POST')
+    # @Utils.deprecated
+    # def create_single_campaign_assistant(
+    #     self,
+    #     campaign_name: str,
+    #     targeting_type: str,
+    #     daily_budget: int,
+    #     start_date: str,
+    #     end_date: str = None,
+    #     campaign_status: str = "enabled",
+    #     portfolio_id: int = None,
+    #     po_number: str = None,
+    #     account_manager: str = None,
+    #     premium_bid_adjustment: bool = None,
+    #     strategy: str = None,
+    #     predicate: str or tuple = None,
+    #     percentage: int or tuple = None,
+    #     **kwargs,
+    # ) -> ApiResponse:
+    #     r"""
+    #     create_single_campaign_assistant(campaign_name: str,targeting_type: str, daily_budget: int, start_date: str, end_date: str = None, campaign_status: str = "enabled", portfolio_id: int = None, po_number: str = None, account_manager: str = None, premium_bid_adjustment: bool = False, strategy:str = None, predicate:str = None, percentage:int = None, **kwargs) -> ApiResponse
+    #
+    #     Creates one campaigns and create the body based on the params provided
+    #
+    #     Kwargs:
+    #
+    #         | **campaign_name** (string): [required] A name for the campaign
+    #         | **campaign_type** (string): [fixed] The advertising product managed by this campaign. Value: sponsoredProducts
+    #         | **targeting_type** (string): [required] The type of targeting for the campaign. Values: manual, auto
+    #         | **daily_budget** (float): [required] A daily budget for the campaign
+    #         | **start_date** (string): [required] A starting date for the campaign to go live. The format of the date is YYYYMMDD
+    #         | **end_date** (string): [optional] An ending date for the campaign to stop running. The format of the date is YYYYMMDD
+    #         | **campaign_status**': (string): [optional] The current resource state Values: enabled, paused, archived. Default: enabled
+    #         | **portfolio_id** (number): [optional] The identifier of an existing portfolio to which the campaign is associated
+    #         | **po_number** (string): [optional] 'A list of advertiser-specified custom identifiers for the campaign. Each customer identifier is a key-value pair. You can specify a maximum of 50 identifiers
+    #         | **account_manager** (string): [optional] A list of advertiser-specified custom identifiers for the campaign. Each customer identifier is a key-value pair. You can specify a maximum of 50 identifiers
+    #         | **premium_bid_adjustment**' (boolean) If set to true, Amazon increases the default bid for ads that are eligible to appear in this placement. See developer notes for more information.
+    #         | **strategy** (string): [optional] The bidding strategy. 'Values': legacyForSales (Dynamic bids - down only), autoForSales (Dynamic bids - up and down), manual (Fixed bid)
+    #         | **predicate** (string): [optional] You can enable controls to adjust your bid based on the placement location. Specify a location where you want to use bid controls. The percentage value set is the percentage of the original bid for which you want to have your bid adjustment increased. For example, a 50% adjustment on a $1.00 bid would increase the bid to $1.50 for the opportunity to win a specified placement. 'Values':  placementTop, placementProductPage
+    #         | **percentage** (float): [optional] The bid adjustment percentage value.
+    #
+    #     Returns:
+    #
+    #         ApiResponse
+    #
+    #     """
+    #
+    #     optional = {}
+    #
+    #     if portfolio_id is not None:
+    #         optional.update({'portfolioId': portfolio_id})
+    #
+    #     if po_number is not None and account_manager is not None:
+    #         optional.update({"tags": {'PONumber': po_number, 'accountManager': account_manager}})
+    #
+    #     if end_date is not None:
+    #         optional.update({'endDate': end_date})
+    #
+    #     if premium_bid_adjustment is not None:
+    #         optional.update({'premiumBidAdjustment': premium_bid_adjustment})
+    #
+    #     if strategy is not None and predicate is not None and percentage is not None:
+    #         if isinstance(predicate, str):
+    #             optional.update(
+    #                 {
+    #                     'bidding': {
+    #                         'strategy': strategy,
+    #                         'adjustments': [{'predicate': predicate, 'percentage': percentage}],
+    #                     }
+    #                 }
+    #             )
+    #
+    #         if isinstance(predicate, tuple) and len(predicate) == 2 and len(percentage) == 2:
+    #             options = []
+    #             for i in range(len(predicate)):
+    #                 option = {"predicate": predicate[i], "percentage": percentage[i]}
+    #                 options.append(option)
+    #
+    #             bidding = {'strategy': strategy, 'adjustments': options}
+    #
+    #             dictionary = {}
+    #             dictionary["bidding"] = bidding
+    #
+    #             optional.update(dictionary)
+    #
+    #     required = {
+    #         'name': campaign_name,
+    #         'campaignType': 'sponsoredProducts',
+    #         'targetingType': targeting_type,
+    #         'state': campaign_status,
+    #         'dailyBudget': daily_budget,
+    #         'startDate': start_date,
+    #     }
+    #
+    #     if optional:
+    #         required.update(optional)
+    #
+    #     data_str = json.dumps([required])
+    #     return self._request(kwargs.pop('path'), data=data_str, params=kwargs)
+    #
+    # DEPRECATED v2 — superseded by v1 endpoints. Kept commented for reference.
+    # @sp_endpoint('/v2/sp/campaigns', method='POST')
+    # @Utils.deprecated
+    # def create_campaigns(self, **kwargs) -> ApiResponse:
+    #     r"""
+    #     create_campaigns(body: (dict, str, list)) -> ApiResponse
+    #
+    #     Creates one or more campaigns.
+    #
+    #     body: | REQUIRED {'description': 'An array of campaigns.}'
+    #
+    #         | '**portfolioId**': *number*, {'description': 'The identifier of an existing portfolio to which the campaign is associated'}
+    #         | '**name**': *string*, {'description': 'A name for the campaign'}
+    #         | '**tags**': *string*, {'description': 'A list of advertiser-specified custom identifiers for the campaign. Each customer identifier is a key-value pair. You can specify a maximum of 50 identifiers.'}
+    #         | '**campaignType**': *string*, {'description': 'The advertising product managed by this campaign', 'Enum': '[ sponsoredProducts ]'}
+    #         | '**targetingType**': *string*, {'description': 'The type of targeting for the campaign.', 'Enum': '[ manual, auto ]'}
+    #         | '**state**': *string*, {'description': 'The current resource state.', 'Enum': '[ enabled, paused, archived ]'}
+    #         | '**dailyBudget**': *number($float)*, {'description': 'A daily budget for the campaign.'}
+    #         | '**startDate**': *string*, {'description': 'A starting date for the campaign to go live. The format of the date is YYYYMMDD.'}
+    #         | '**endDate**': *string* nullable: true, {'description': 'An ending date for the campaign to stop running. The format of the date is YYYYMMDD.'}
+    #         | '**premiumBidAdjustment**': *boolean*, {'description': 'If set to true, Amazon increases the default bid for ads that are eligible to appear in this placement. See developer notes for more information.'}
+    #         | '**bidding**': *Bidding*, {'strategy': 'string', 'Enum': '[ legacyForSales, autoForSales, manual ]', 'adjustments': '{...}'}
+    #
+    #     Returns:
+    #
+    #         ApiResponse
+    #
+    #     """
+    #     body = Utils.convert_body(kwargs.pop('body'))
+    #     return self._request(kwargs.pop('path'), data=body, params=kwargs)
+    #
+    # DEPRECATED v2 — superseded by v1 endpoints. Kept commented for reference.
+    # @sp_endpoint('/v2/sp/campaigns', method='PUT')
+    # @Utils.deprecated
+    # def edit_campaigns(self, **kwargs) -> ApiResponse:
+    #     r"""
+    #     edit_campaigns(body: (dict, str, list)) -> ApiResponse
+    #
+    #     Updates one or more campaigns.
+    #
+    #     body: | REQUIRED {'description': 'An array of campaigns.}'
+    #
+    #         | '**campaignId**': *number*, {'description': 'The identifier of an existing campaign to update.'}
+    #         | '**portfolioId**': *number*, {'description': 'The identifier of an existing portfolio to which the campaign is associated'}
+    #         | '**name**': *string*, {'description': 'The name for the campaign'}
+    #         | '**tags**': *CampaignTags*, {'description': 'A list of advertiser-specified custom identifiers for the campaign. Each customer identifier is a key-value pair. You can specify a maximum of 50 identifiers.'}
+    #         | '**state**': *string*, {'description': 'The current resource state.', 'Enum': '[ enabled, paused, archived ]'}
+    #         | '**dailyBudget**': *number($float)*, {'description': 'The daily budget for the campaign.'}
+    #         | '**startDate**': *string*, {'description': 'The starting date for the campaign to go live. The format of the date is YYYYMMDD.'}
+    #         | '**endDate**': *string* nullable: true, {'description': 'The ending date for the campaign to stop running. The format of the date is YYYYMMDD.'}
+    #         | '**premiumBidAdjustment**': *boolean*, {'description': 'If set to true, Amazon increases the default bid for ads that are eligible to appear in this placement. See developer notes for more information.'}
+    #         | '**bidding**': *Bidding*, {'strategy': 'string', 'Enum': '[ legacyForSales, autoForSales, manual ]', 'adjustments': '{...}'}
+    #
+    #     Returns:
+    #
+    #         ApiResponse
+    #
+    #     """
+    #     body = Utils.convert_body(kwargs.pop('body'))
+    #     return self._request(kwargs.pop('path'), data=body, params=kwargs)
+    #
+    # DEPRECATED v2 — superseded by v1 endpoints. Kept commented for reference.
+    # @sp_endpoint('/v2/sp/campaigns', method='GET')
+    # @Utils.deprecated
+    # def list_campaigns(self, **kwargs) -> ApiResponse:
+    #     r"""
+    #     list_campaigns(**kwargs) -> ApiResponse
+    #
+    #     Gets an array of campaigns.
+    #
+    #         query **startIndex**:*integer* | Optional. 0-indexed record offset for the result set. Default value : 0
+    #
+    #         query **count**:*integer* | Optional. Number of records to include in the paged response. Defaults to max page size.
+    #
+    #         query **stateFilter**:*string* | Optional. The returned array is filtered to include only ad groups with state set to one of the values in the specified comma-delimited list. Available values : enabled, paused, archived, enabled, paused, enabled, archived, paused, archived, enabled, paused, archived Default value : enabled, paused, archived.
+    #
+    #         query **name**:*string* | Optional. Restricts results to campaigns with the specified name.
+    #
+    #         query **portfolioIdFilter**:*string* | Optional. A comma-delimited list of portfolio identifiers.
+    #
+    #         query **campaignIdFilter**:*string* | Optional. A comma-delimited list of campaign identifiers.
+    #
+    #     Returns:
+    #
+    #         ApiResponse
+    #
+    #     """
+    #     return self._request(kwargs.pop('path'), params=kwargs)
+    #
+    # DEPRECATED v2 — superseded by v1 endpoints. Kept commented for reference.
+    # @sp_endpoint('/v2/sp/campaigns/{}', method='GET')
+    # @Utils.deprecated
+    # def get_campaign(self, campaignId, **kwargs) -> ApiResponse:
+    #     r"""
+    #
+    #     get_campaign(campaignId: int) -> ApiResponse
+    #
+    #     Gets a campaign specified by identifier.
+    #
+    #         path **campaignId**:*number* | Required. The identifier of an existing campaign.
+    #
+    #     Returns:
+    #
+    #         ApiResponse
+    #
+    #     """
+    #     return self._request(fill_query_params(kwargs.pop('path'), campaignId), params=kwargs)
+    #
+    # DEPRECATED v2 — superseded by v1 endpoints. Kept commented for reference.
+    # @sp_endpoint('/v2/sp/campaigns/{}', method='DELETE')
+    # @Utils.deprecated
+    # def delete_campaign(self, campaignId, **kwargs) -> ApiResponse:
+    #     r"""
+    #
+    #     delete_campaign(campaignId: int) -> ApiResponse
+    #
+    #     Sets the campaign status to archived. Archived entities cannot be made active again. See developer notes for more information.
+    #
+    #         path **campaignId**:*number* | Required. The identifier of an existing campaign.
+    #
+    #     Returns:
+    #
+    #         ApiResponse
+    #
+    #     """
+    #     return self._request(fill_query_params(kwargs.pop('path'), campaignId), params=kwargs)
+    #
+    # DEPRECATED v2 — superseded by v1 endpoints. Kept commented for reference.
+    # @sp_endpoint('/v2/sp/campaigns/extended', method='GET')
+    # @Utils.deprecated
+    # def list_campaigns_extended(self, **kwargs) -> ApiResponse:
+    #     r"""
+    #     list_campaigns_extended(**kwargs) -> ApiResponse
+    #
+    #     Gets an array of campaigns with extended data fields.
+    #
+    #         query **startIndex**:*integer* | Optional. 0-indexed record offset for the result set. Default value : 0
+    #
+    #         query **count**:*integer* | Optional. Number of records to include in the paged response. Defaults to max page size.
+    #
+    #         query **stateFilter**:*string* | Optional. The returned array is filtered to include only ad groups with state set to one of the values in the specified comma-delimited list. Available values : enabled, paused, archived, enabled, paused, enabled, archived, paused, archived, enabled, paused, archived Default value : enabled, paused, archived.
+    #
+    #         query **name**:*string* | Optional. Restricts results to campaigns with the specified name.
+    #
+    #         query **portfolioIdFilter**:*string* | Optional. A comma-delimited list of portfolio identifiers.
+    #
+    #         query **campaignIdFilter**:*string* | Optional. A comma-delimited list of campaign identifiers.
+    #
+    #     Returns:
+    #
+    #         ApiResponse
+    #
+    #     """
+    #     return self._request(kwargs.pop('path'), params=kwargs)
+    #
+    # DEPRECATED v2 — superseded by v1 endpoints. Kept commented for reference.
+    # @sp_endpoint('/v2/sp/campaigns/extended/{}', method='GET')
+    # @Utils.deprecated
+    # def get_campaign_extended(self, campaignId, **kwargs) -> ApiResponse:
+    #     r"""
+    #     get_campaign_extended(campaignId: int) -> ApiResponse
+    #
+    #     Gets an array of campaigns with extended data fields.
+    #
+    #         path **campaignId**:*number* | Required. The identifier of an existing campaign.
+    #
+    #     Returns:
+    #
+    #         ApiResponse
+    #
+    #     """
+    #     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
 
-        delete_campaign(campaignId: int) -> ApiResponse
-
-        Sets the campaign status to archived. Archived entities cannot be made active again. See developer notes for more information.
+        Amazon Ads API v1 - Query Campaigns (operationId: QueryCampaign)
 
-            path **campaignId**:*number* | Required. The identifier of an existing campaign.
+        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
 
-        Returns:
+        Headers
+            | **Amazon-Ads-AccountId** (string) [optional] Advertiser account identifier
 
+        Returns
             ApiResponse
+                | **campaigns** (list), **nextToken** (string)
 
         """
-        return self._request(fill_query_params(kwargs.pop('path'), campaignId), params=kwargs)
+        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('/v2/sp/campaigns/extended', method='GET')
-    @Utils.deprecated
-    def list_campaigns_extended(self, **kwargs) -> ApiResponse:
+    @sp_endpoint('/adsApi/v1/delete/campaigns', method='POST')
+    def delete_campaigns(self, **kwargs) -> ApiResponse:
         r"""
-        list_campaigns_extended(**kwargs) -> ApiResponse
-
-        Gets an array of campaigns with extended data fields.
-
-            query **startIndex**:*integer* | Optional. 0-indexed record offset for the result set. Default value : 0
+        delete_campaigns(body: dict) -> ApiResponse
 
-            query **count**:*integer* | Optional. Number of records to include in the paged response. Defaults to max page size.
+        Amazon Ads API v1 - Delete Campaigns (operationId: DeleteCampaign)
 
-            query **stateFilter**:*string* | Optional. The returned array is filtered to include only ad groups with state set to one of the values in the specified comma-delimited list. Available values : enabled, paused, archived, enabled, paused, enabled, archived, paused, archived, enabled, paused, archived Default value : enabled, paused, archived.
-
-            query **name**:*string* | Optional. Restricts results to campaigns with the specified name.
-
-            query **portfolioIdFilter**:*string* | Optional. A comma-delimited list of portfolio identifiers.
-
-            query **campaignIdFilter**:*string* | Optional. A comma-delimited list of campaign identifiers.
+        Request Body [Required]
+            | **campaignIds** (list<string>) : [required] Campaign identifiers to delete
 
-        Returns:
+        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.
 
         """
-        return self._request(kwargs.pop('path'), params=kwargs)
+        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('/v2/sp/campaigns/extended/{}', method='GET')
-    @Utils.deprecated
-    def get_campaign_extended(self, campaignId, **kwargs) -> ApiResponse:
+    @sp_endpoint('/adsApi/v1/update/campaigns', method='POST')
+    def update_campaigns(self, **kwargs) -> ApiResponse:
         r"""
-        get_campaign_extended(campaignId: int) -> ApiResponse
+        update_campaigns(body: dict) -> ApiResponse
 
-        Gets an array of campaigns with extended data fields.
+        Amazon Ads API v1 - Update Campaigns (operationId: UpdateCampaign)
 
-            path **campaignId**:*number* | Required. The identifier of an existing campaign.
+        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.
 
-        Returns:
+        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.
 
         """
-        return self._request(fill_query_params(kwargs.pop('path'), campaignId), params=kwargs)
+        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/query/campaigns', method='POST')
-    def query_campaigns(self, **kwargs) -> ApiResponse:
+    @sp_endpoint('/adsApi/v1/create/campaigns', method='POST')
+    def create_campaigns(self, **kwargs) -> ApiResponse:
         r"""
-        query_campaigns(body: dict) -> ApiResponse
+        create_campaigns(body: dict) -> ApiResponse
 
-        Amazon Ads API v1 - Query Campaigns (operationId: QueryCampaign)
+        Amazon Ads API v1 - Create Campaigns (operationId: CreateCampaign)
 
         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
+            | **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
-                | **campaigns** (list), **nextToken** (string)
+                | **207** MultiStatus response with partial errors. Inspect the payload
+                  to know which campaigns were created and which failed.
 
         """
         schema_version = 'application/json'

ad_api/version.py

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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-amazon-ad-api
-Version: 0.9.7
+Version: 0.9.8
 Summary: Python wrapper for the Amazon Advertising API
 Home-page: https://github.com/denisneuf/python-amazon-ad-api
 Author: Daniel Alvaro
@@ -299,6 +299,34 @@ 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)
+
+New unified endpoint generation. Campaigns are queried with a single `POST /adsApi/v1/query/campaigns` resource instead of the versioned v2/v3 endpoints.
+
+| Method | Endpoint | Body |
+|---|---|---|
+| `query_campaigns` | `POST /adsApi/v1/query/campaigns` | filters + `maxResults`/`nextToken` |
+| `create_campaigns` | `POST /adsApi/v1/create/campaigns` | `campaigns[]` (`adProduct`, `name`, `state` required) |
+| `update_campaigns` | `POST /adsApi/v1/update/campaigns` | `campaigns[]` (`campaignId` required) |
+| `delete_campaigns` | `POST /adsApi/v1/delete/campaigns` | `campaignIds[]` |
+
+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
+
+result = sponsored_products.Campaigns(credentials=credentials, debug=True).query_campaigns(
+    body={
+        "adProductFilter": {"include": ["SPONSORED_PRODUCTS"]},
+        "stateFilter": {"include": ["ENABLED"]},
+        "maxResults": 100,
+    }
+)
+
+campaigns = result.payload.get("campaigns")
+next_token = result.payload.get("nextToken")
+```
+
 ### [Modules Available Sponsored Products 2.0](https://python-amazon-ad-api.readthedocs.io/en/latest/sp_v2.html)
 
 Warning: [PLANNED DEPRECATION 6/30/2023]
@@ -307,6 +335,8 @@ There is a new version 3 of Sponsored Product API, please check the [migration g
 
 ### [Modules Available Sponsored Products 3.0](https://python-amazon-ad-api.readthedocs.io/en/latest/sp_v3.html)
 
+Warning: `list_campaigns` is deprecated. Use the v1 `query_campaigns` method instead.
+
 
 * [ThemeBased Bid Recommendation](https://python-amazon-ad-api.readthedocs.io/en/latest/sp/bid_recommendations_v3.html)
 * [Keyword Recommendations](https://python-amazon-ad-api.readthedocs.io/en/latest/sp/ranked_keywords_recommendations.html)
@@ -375,7 +405,9 @@ There is a new version 3 of Sponsored Product API, please check the [migration g
 
 * [Reports](https://python-amazon-ad-api.readthedocs.io/en/latest/dsp/reports.html)
 
-### Simple Example Usage Campaigns with Credentials
+### Simple Example Usage Campaigns with Credentials (v3, legacy)
+
+Warning: this example uses `CampaignsV3.list_campaigns`, which is deprecated. See the v1 `query_campaigns` example above.
 
 ```python
 import logging
@@ -443,4 +475,4 @@ We are not affiliated with Amazon but they used our api :)
 
 
 ---
-*Last release: v0.8.9 (via electroduende automated release random access memory)*
+*Last release: v0.9.7*

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

@@ -1,5 +1,5 @@
 ad_api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-ad_api/version.py,sha256=RcQa7EaTs304WhxJ7lAJ_lelzmRpmed8pgcM1EYP3bo,22
+ad_api/version.py,sha256=GI3Cr15wC6XhdahtMoSOf62d2gYve5G_PiR_xx_RGKc,22
 ad_api/api/__init__.py,sha256=rurlFrTJZgSGNdkEahAJGjDAVll2KyCqpLpV40ZKI6o,1487
 ad_api/api/account.py,sha256=CmOvCfHoPWaeTUJvtB0pNoNulZVSz4oMMCKIpVTpHos,2931
 ad_api/api/advertising_test_account.py,sha256=btOVbdk2tBDmyKSJaQbcIFyzNG8KFJVUmTe4p9xMhpU,1507
@@ -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=wd-pymoFGTs9dY2C0GJfLUPrb6QDqot9dshOCp_Rsck,22142
+ad_api/api/sp/campaigns.py,sha256=L_6lHAT3mrwyP9K4xqwgMBTzth5_oSMSNZNhpaVoH6o,30910
 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.7.dist-info/licenses/LICENSE,sha256=h2rpqlmmLy-4l1tN6KpWAFxx1JEMYeEFrMrZUbx_B_o,1105
-python_amazon_ad_api-0.9.7.dist-info/METADATA,sha256=mz_J6Z90WCi6dWmxvtaoRUindIHVgmdkwhgzZgHYtCM,19168
-python_amazon_ad_api-0.9.7.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-python_amazon_ad_api-0.9.7.dist-info/top_level.txt,sha256=nN9twUos-8pkP514ZwpvRU9YL9L2XyQyHsMQFfudGTU,7
-python_amazon_ad_api-0.9.7.dist-info/RECORD,,
+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,,