@congminh1254/shopee-sdk 0.10.0 → 1.0.0

package/lib/managers/add-on-deal.manager.js

@@ -0,0 +1,240 @@
+import { BaseManager } from "./base.manager.js";
+import { ShopeeFetch } from "../fetch.js";
+export class AddOnDealManager extends BaseManager {
+    constructor(config) {
+        super(config);
+    }
+    /**
+     * Create a new add-on deal activity
+     * @param {AddAddOnDealParams} params - Parameters for creating a new add-on deal
+     * @returns {Promise<AddAddOnDealResponse>} The response containing the created add-on deal ID
+     *
+     * Note: A maximum of 1000 add-on deals can be created.
+     * The start time must be 1 hour later than current time.
+     * The end time must be 1 hour later than start time.
+     */
+    async addAddOnDeal(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/add_on_deal/add_add_on_deal", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Add main items to an existing add-on deal activity
+     * @param {AddAddOnDealMainItemParams} params - Parameters for adding main items to an add-on deal
+     * @returns {Promise<AddAddOnDealMainItemResponse>} The response containing the list of added main items
+     *
+     * Main items are the products that customers must purchase to be eligible for the add-on deal.
+     */
+    async addAddOnDealMainItem(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/add_on_deal/add_add_on_deal_main_item", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Add sub items (discounted or gift items) to an existing add-on deal activity
+     * @param {AddAddOnDealSubItemParams} params - Parameters for adding sub items to an add-on deal
+     * @returns {Promise<AddAddOnDealSubItemResponse>} The response containing any failed sub items
+     *
+     * Sub items are the products offered at a discount or as gifts when customers purchase main items.
+     * The response includes a list of items that failed to be added with error details.
+     */
+    async addAddOnDealSubItem(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/add_on_deal/add_add_on_deal_sub_item", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Delete an existing add-on deal activity
+     * @param {DeleteAddOnDealParams} params - Parameters for deleting an add-on deal
+     * @returns {Promise<DeleteAddOnDealResponse>} The response containing the deleted add-on deal ID
+     *
+     * Note: Can only delete upcoming add-on deals that haven't started yet.
+     * Will return an error if attempting to delete an add-on deal that has already started.
+     */
+    async deleteAddOnDeal(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/add_on_deal/delete_add_on_deal", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Delete main items from an existing add-on deal activity
+     * @param {DeleteAddOnDealMainItemParams} params - Parameters for deleting main items from an add-on deal
+     * @returns {Promise<DeleteAddOnDealMainItemResponse>} The response containing any failed item deletions
+     *
+     * The response includes:
+     * - add_on_deal_id: The ID of the add-on deal
+     * - failed_item_id_list: List of item IDs that failed to be deleted
+     */
+    async deleteAddOnDealMainItem(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/add_on_deal/delete_add_on_deal_main_item", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Delete sub items from an existing add-on deal activity
+     * @param {DeleteAddOnDealSubItemParams} params - Parameters for deleting sub items from an add-on deal
+     * @returns {Promise<DeleteAddOnDealSubItemResponse>} The response containing any failed sub item deletions
+     *
+     * The response includes a list of sub items that failed to be deleted with error details.
+     * Note: At least one sub item should remain in the add-on deal.
+     */
+    async deleteAddOnDealSubItem(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/add_on_deal/delete_add_on_deal_sub_item", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * End an ongoing add-on deal activity immediately
+     * @param {EndAddOnDealParams} params - Parameters for ending an add-on deal
+     * @returns {Promise<EndAddOnDealResponse>} The response containing the ended add-on deal ID
+     *
+     * Note: Can only end add-on deals that are currently ongoing/active.
+     * Will return an error if attempting to end an upcoming or expired add-on deal.
+     */
+    async endAddOnDeal(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/add_on_deal/end_add_on_deal", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Get detailed information about an add-on deal activity
+     * @param {GetAddOnDealParams} params - Parameters for getting add-on deal details
+     * @returns {Promise<GetAddOnDealResponse>} The response containing comprehensive add-on deal information
+     *
+     * The response includes:
+     * - Basic add-on deal details (ID, name, start/end time, etc.)
+     * - Promotion type and configuration
+     * - Purchase limits and requirements
+     * - Sub item display priority
+     * - Source information
+     */
+    async getAddOnDeal(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/add_on_deal/get_add_on_deal", {
+            method: "GET",
+            auth: true,
+            params,
+        });
+        return response;
+    }
+    /**
+     * Get a list of add-on deal activities with pagination
+     * @param {GetAddOnDealListParams} params - Parameters for retrieving add-on deal list
+     * @param {AddOnDealPromotionStatus} params.promotion_status - Filter by promotion status (all, ongoing, upcoming, expired)
+     * @param {number} [params.page_no] - Page number to retrieve (default: 1, max: 1000)
+     * @param {number} [params.page_size] - Number of items per page (default: 100, max: 100)
+     * @returns {Promise<GetAddOnDealListResponse>} The response containing a paginated list of add-on deals
+     *
+     * The response includes:
+     * - add_on_deal_list: List of add-on deals with full details
+     * - more: Boolean indicating if there are more pages
+     */
+    async getAddOnDealList(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/add_on_deal/get_add_on_deal_list", {
+            method: "GET",
+            auth: true,
+            params,
+        });
+        return response;
+    }
+    /**
+     * Get main items in an add-on deal activity
+     * @param {GetAddOnDealMainItemParams} params - Parameters for getting main items
+     * @returns {Promise<GetAddOnDealMainItemResponse>} The response containing the list of main items
+     *
+     * Main items are the products that customers must purchase to be eligible for the add-on deal.
+     */
+    async getAddOnDealMainItem(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/add_on_deal/get_add_on_deal_main_item", {
+            method: "GET",
+            auth: true,
+            params,
+        });
+        return response;
+    }
+    /**
+     * Get sub items (discounted or gift items) in an add-on deal activity
+     * @param {GetAddOnDealSubItemParams} params - Parameters for getting sub items
+     * @returns {Promise<GetAddOnDealSubItemResponse>} The response containing the list of sub items
+     *
+     * Sub items are the products offered at a discount or as gifts when customers purchase main items.
+     */
+    async getAddOnDealSubItem(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/add_on_deal/get_add_on_deal_sub_item", {
+            method: "GET",
+            auth: true,
+            params,
+        });
+        return response;
+    }
+    /**
+     * Update an existing add-on deal activity
+     * @param {UpdateAddOnDealParams} params - Parameters for updating an add-on deal
+     * @returns {Promise<UpdateAddOnDealResponse>} The response containing the updated add-on deal information
+     *
+     * Note: For ongoing add-on deals, update capabilities may be limited.
+     * Only certain fields can be modified depending on the add-on deal status.
+     * The start time of upcoming add-on deals cannot be shortened.
+     * Promotion end time can only be changed to an earlier timing.
+     */
+    async updateAddOnDeal(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/add_on_deal/update_add_on_deal", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Update main items in an existing add-on deal activity
+     * @param {UpdateAddOnDealMainItemParams} params - Parameters for updating main items
+     * @returns {Promise<UpdateAddOnDealMainItemResponse>} The response containing the updated main items
+     *
+     * Main items are the products that customers must purchase to be eligible for the add-on deal.
+     */
+    async updateAddOnDealMainItem(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/add_on_deal/update_add_on_deal_main_item", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Update sub items in an existing add-on deal activity
+     * @param {UpdateAddOnDealSubItemParams} params - Parameters for updating sub items
+     * @returns {Promise<UpdateAddOnDealSubItemResponse>} The response containing any failed sub item updates
+     *
+     * Sub items are the products offered at a discount or as gifts when customers purchase main items.
+     * The response includes a list of sub items that failed to be updated with error details.
+     */
+    async updateAddOnDealSubItem(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/add_on_deal/update_add_on_deal_sub_item", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+}
+//# sourceMappingURL=add-on-deal.manager.js.map

package/lib/managers/add-on-deal.manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-on-deal.manager.js","sourceRoot":"","sources":["../../src/managers/add-on-deal.manager.ts"],"names":[],"mappings":"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"}

package/lib/managers/ads.manager.d.ts

@@ -1,6 +1,6 @@
 import { ShopeeConfig } from "../sdk.js";
 import { BaseManager } from "./base.manager.js";
-import { GetTotalBalanceResponse, GetShopToggleInfoResponse, GetRecommendedKeywordListParams, GetRecommendedKeywordListResponse, GetRecommendedItemListResponse, GetAllCpcAdsHourlyPerformanceParams, GetAllCpcAdsHourlyPerformanceResponse, GetAllCpcAdsDailyPerformanceParams, GetAllCpcAdsDailyPerformanceResponse, GetProductCampaignDailyPerformanceParams, GetProductCampaignDailyPerformanceResponse, GetProductCampaignHourlyPerformanceParams, GetProductCampaignHourlyPerformanceResponse, GetProductLevelCampaignIdListParams, GetProductLevelCampaignIdListResponse, GetProductLevelCampaignSettingInfoParams, GetProductLevelCampaignSettingInfoResponse, GetProductRecommendedRoiTargetParams, GetProductRecommendedRoiTargetResponse } from "../schemas/ads.js";
+import { GetTotalBalanceResponse, GetShopToggleInfoResponse, GetRecommendedKeywordListParams, GetRecommendedKeywordListResponse, GetRecommendedItemListResponse, GetAllCpcAdsHourlyPerformanceParams, GetAllCpcAdsHourlyPerformanceResponse, GetAllCpcAdsDailyPerformanceParams, GetAllCpcAdsDailyPerformanceResponse, GetProductCampaignDailyPerformanceParams, GetProductCampaignDailyPerformanceResponse, GetProductCampaignHourlyPerformanceParams, GetProductCampaignHourlyPerformanceResponse, GetProductLevelCampaignIdListParams, GetProductLevelCampaignIdListResponse, GetProductLevelCampaignSettingInfoParams, GetProductLevelCampaignSettingInfoResponse, GetProductRecommendedRoiTargetParams, GetProductRecommendedRoiTargetResponse, CheckCreateGmsProductCampaignEligibilityResponse, CreateAutoProductAdsParams, CreateAutoProductAdsResponse, CreateGmsProductCampaignParams, CreateGmsProductCampaignResponse, CreateManualProductAdsParams, CreateManualProductAdsResponse, EditAutoProductAdsParams, EditAutoProductAdsResponse, EditGmsItemProductCampaignParams, EditGmsItemProductCampaignResponse, EditGmsProductCampaignParams, EditGmsProductCampaignResponse, EditManualProductAdKeywordsParams, EditManualProductAdKeywordsResponse, EditManualProductAdsParams, EditManualProductAdsResponse, GetAdsFacilShopRateResponse, GetCreateProductAdBudgetSuggestionParams, GetCreateProductAdBudgetSuggestionResponse, GetGmsCampaignPerformanceParams, GetGmsCampaignPerformanceResponse, GetGmsItemPerformanceParams, GetGmsItemPerformanceResponse, ListGmsUserDeletedItemParams, ListGmsUserDeletedItemResponse } from "../schemas/ads.js";
 export declare class AdsManager extends BaseManager {
     constructor(config: ShopeeConfig);
     /**
@@ -270,4 +270,220 @@ export declare class AdsManager extends BaseManager {
      * based on competitive marketplace data.
      */
     getProductRecommendedRoiTarget(params: GetProductRecommendedRoiTargetParams): Promise<GetProductRecommendedRoiTargetResponse>;
+    /**
+     * Check the seller's eligibility in creating a GMS campaign
+     * @returns {Promise<CheckCreateGmsProductCampaignEligibilityResponse>} Response containing eligibility status
+     *
+     * This API is used to check if the seller is eligible to create a GMS (Gross Merchandise Sales) Campaign.
+     * The response indicates eligibility and provides a reason if the seller is not eligible.
+     *
+     * Possible reasons for ineligibility:
+     * - active_campaign: There is already an existing GMS Campaign that is active
+     * - not_whitelisted: The seller is not whitelisted to sz_shop_gmv_max_feature
+     * - not_have_enough_sku: The seller does not have enough valid items in the shop
+     * - exclusive_with_other_campaign: Seller is whitelisted to sz_ads_auto_boost
+     */
+    checkCreateGmsProductCampaignEligibility(): Promise<CheckCreateGmsProductCampaignEligibilityResponse>;
+    /**
+     * Create Auto Product Ads
+     * @param {CreateAutoProductAdsParams} params Request parameters
+     * @param {string} params.reference_id A random string used to prevent duplicate ads
+     * @param {number} params.budget The budget set for the Auto Product Ads
+     * @param {string} params.start_date Start date of the campaign (DD-MM-YYYY format)
+     * @param {string} [params.end_date] End date of the campaign (DD-MM-YYYY format). Leave empty for unlimited duration
+     * @returns {Promise<CreateAutoProductAdsResponse>} Response containing the created campaign ID
+     *
+     * This API is used to create Auto Product Ads. Auto Product Ads automatically promote
+     * products based on their performance and potential.
+     *
+     * Important notes:
+     * - reference_id prevents duplicate ad creation. If an ad is created successfully,
+     *   subsequent requests using the same reference_id will fail
+     * - For unlimited campaign duration, pass today's date as start_date and leave end_date empty
+     */
+    createAutoProductAds(params: CreateAutoProductAdsParams): Promise<CreateAutoProductAdsResponse>;
+    /**
+     * Create a GMS product campaign
+     * @param {CreateGmsProductCampaignParams} params Request parameters
+     * @param {string} params.start_date Start date of Campaign (DD-MM-YYYY format). Cannot be earlier than today.
+     * @param {string} [params.end_date] End date of Campaign (DD-MM-YYYY format). Do not fill if no end date.
+     * @param {number} params.daily_budget Daily budget for Campaign
+     * @param {string} [params.reference_id] A random string used to prevent duplicate ads
+     * @param {number} [params.roas_target] ROAS target (0 or undefined for GMV Max Auto Bidding, >0 for Custom ROAS)
+     * @returns {Promise<CreateGmsProductCampaignResponse>} Response containing the created campaign ID
+     *
+     * This API is used to create a GMS (Gross Merchandise Sales) Campaign.
+     *
+     * ROAS Target behavior:
+     * - No input or 0: GMV Max Auto Bidding (Shop)
+     * - Greater than 0: GMV Max Custom ROAS (Shop)
+     * - Value is rounded to 1 decimal place (e.g., 10.123456 becomes 10.1)
+     */
+    createGmsProductCampaign(params: CreateGmsProductCampaignParams): Promise<CreateGmsProductCampaignResponse>;
+    /**
+     * Create Manual Selection Product Ads
+     * @param {CreateManualProductAdsParams} params Request parameters
+     * @param {string} params.reference_id A random string used to prevent duplicate ads
+     * @param {number} params.budget The budget set for the Manual Product Ads
+     * @param {string} params.start_date Start date of the campaign (DD-MM-YYYY format)
+     * @param {string} [params.end_date] End date of the campaign (DD-MM-YYYY format). Leave empty for unlimited duration
+     * @param {string} params.bidding_method Bidding method: "auto" or "manual"
+     * @param {number} params.item_id Product ID
+     * @param {number} [params.roas_target] ROAS target for campaigns with auto bidding. If 0, GMV Max / ROI feature is not enabled
+     * @param {Array} [params.selected_keywords] Selected keywords, required for manual bidding mode
+     * @param {Array} [params.discovery_ads_locations] Location settings for manual bidding method
+     * @param {boolean} [params.enhanced_cpc] Enhanced CPC functionality toggle
+     * @param {string} [params.smart_creative_setting] Smart Creative setting: "", "default", "on", or "off"
+     * @returns {Promise<CreateManualProductAdsResponse>} Response containing the created campaign ID
+     *
+     * This API is used to create Manual Selection Product Ads, which allow you to manually
+     * select products, keywords, and bidding strategies for your advertising campaigns.
+     *
+     * For manual bidding mode, you must specify selected_keywords and/or discovery_ads_locations.
+     * For auto bidding mode, you can set the roas_target parameter.
+     */
+    createManualProductAds(params: CreateManualProductAdsParams): Promise<CreateManualProductAdsResponse>;
+    /**
+     * Edit Auto Product Ads
+     * @param {EditAutoProductAdsParams} params Request parameters
+     * @param {string} params.reference_id A random string used to prevent duplicate ads
+     * @param {number} params.campaign_id The unique identifier for the campaign
+     * @param {string} params.edit_action The update action: "status", "budget", or "duration"
+     * @param {number} [params.budget] The budget set for the Auto Product Ads
+     * @param {string} [params.start_date] Start date of the campaign (DD-MM-YYYY format)
+     * @param {string} [params.end_date] End date of the campaign (DD-MM-YYYY format)
+     * @returns {Promise<EditAutoProductAdsResponse>} Response containing the campaign ID
+     *
+     * This API is used to edit existing Auto Product Ads.
+     * You can update the campaign status, budget, or duration based on the edit_action parameter.
+     */
+    editAutoProductAds(params: EditAutoProductAdsParams): Promise<EditAutoProductAdsResponse>;
+    /**
+     * Add/remove items to/from the GMS Campaign
+     * @param {EditGmsItemProductCampaignParams} params Request parameters
+     * @param {number} [params.campaign_id] The GMS Campaign ID
+     * @param {string} params.edit_action The action to perform: "add" or "remove"
+     * @param {number[]} params.item_id_list Item IDs to add/remove (minimum 1, maximum 30)
+     * @returns {Promise<EditGmsItemProductCampaignResponse>} Response containing the campaign ID
+     *
+     * This API is used to add or remove items from a GMS Campaign.
+     * You can add or remove between 1 and 30 items per request.
+     */
+    editGmsItemProductCampaign(params: EditGmsItemProductCampaignParams): Promise<EditGmsItemProductCampaignResponse>;
+    /**
+     * Edit a GMS product campaign
+     * @param {EditGmsProductCampaignParams} params Request parameters
+     * @param {number} params.campaign_id The GMS Campaign ID
+     * @param {string} params.edit_action The action to perform
+     * @param {number} [params.daily_budget] Daily budget for Campaign
+     * @param {string} [params.start_date] Start date of Campaign (DD-MM-YYYY format)
+     * @param {string} [params.end_date] End date of Campaign (DD-MM-YYYY format)
+     * @param {number} [params.roas_target] ROAS target for the campaign
+     * @returns {Promise<EditGmsProductCampaignResponse>} Response containing the campaign ID
+     *
+     * This API is used to edit existing GMS Campaign settings such as budget,
+     * campaign duration, and ROAS target.
+     */
+    editGmsProductCampaign(params: EditGmsProductCampaignParams): Promise<EditGmsProductCampaignResponse>;
+    /**
+     * Edit Manual Selection Product Ad Keywords
+     * @param {EditManualProductAdKeywordsParams} params Request parameters
+     * @param {string} params.reference_id A random string used to prevent duplicate ads
+     * @param {number} params.campaign_id The unique identifier for the campaign
+     * @param {string} params.edit_action The action to perform: "add", "edit", or "delete"
+     * @param {Array} [params.selected_keywords] Selected keywords to add, edit, or delete
+     * @returns {Promise<EditManualProductAdKeywordsResponse>} Response containing the campaign ID
+     *
+     * This API is used to edit keywords for Manual Selection Product Ads.
+     * You can add new keywords, edit existing keywords, or delete keywords.
+     */
+    editManualProductAdKeywords(params: EditManualProductAdKeywordsParams): Promise<EditManualProductAdKeywordsResponse>;
+    /**
+     * Edit Manual Selection Product Ads
+     * @param {EditManualProductAdsParams} params Request parameters
+     * @param {string} params.reference_id A random string used to prevent duplicate ads
+     * @param {number} params.campaign_id The unique identifier for the campaign
+     * @param {string} params.edit_action The update action
+     * @param {number} [params.budget] The budget set for the Manual Product Ads
+     * @param {string} [params.start_date] Start date of the campaign (DD-MM-YYYY format)
+     * @param {string} [params.end_date] End date of the campaign (DD-MM-YYYY format)
+     * @param {number} [params.roas_target] ROAS target for campaigns with auto bidding
+     * @param {Array} [params.discovery_ads_locations] Location settings for manual bidding method
+     * @param {boolean} [params.enhanced_cpc] Enhanced CPC functionality toggle
+     * @param {string} [params.smart_creative_setting] Smart Creative setting
+     * @returns {Promise<EditManualProductAdsResponse>} Response containing the campaign ID
+     *
+     * This API is used to edit existing Manual Selection Product Ads.
+     * You can update various campaign settings including budget, duration, bidding settings,
+     * and ad placement locations.
+     */
+    editManualProductAds(params: EditManualProductAdsParams): Promise<EditManualProductAdsResponse>;
+    /**
+     * Get shop rate for Ads Facil Program
+     * @returns {Promise<GetAdsFacilShopRateResponse>} Response containing the shop rate
+     *
+     * This API is used to get the shop rate for the Ads Facil Program,
+     * which is a special advertising program available in certain regions.
+     */
+    getAdsFacilShopRate(): Promise<GetAdsFacilShopRateResponse>;
+    /**
+     * Get budget suggestion for product ads creation
+     * @param {GetCreateProductAdBudgetSuggestionParams} params Request parameters
+     * @param {string} params.reference_id A random string used to prevent duplicate ads
+     * @param {string} params.product_selection Product selection: "auto" or "manual"
+     * @param {string} params.campaign_placement Campaign placement: "search", "discovery", or "all"
+     * @param {string} params.bidding_method Bidding method: "auto" or "manual"
+     * @param {string} [params.enhanced_cpc] Enhanced CPC toggle: "true" or "false"
+     * @param {string} [params.discovery_ads_location_names] Comma-separated location values
+     * @param {number} [params.roas_target] ROAS target for campaigns with auto bidding
+     * @param {number} [params.item_id] Product ID (mandatory for manual product selection)
+     * @returns {Promise<GetCreateProductAdBudgetSuggestionResponse>} Response containing budget suggestions
+     *
+     * This API is used to get budget suggestions before creating product ads.
+     * The suggestions include minimum, maximum, and recommended budget values
+     * based on the campaign parameters.
+     */
+    getCreateProductAdBudgetSuggestion(params: GetCreateProductAdBudgetSuggestionParams): Promise<GetCreateProductAdBudgetSuggestionResponse>;
+    /**
+     * Get GMS Campaign performance
+     * @param {GetGmsCampaignPerformanceParams} params Request parameters
+     * @param {number} [params.campaign_id] The GMS Campaign ID
+     * @param {string} params.start_date Start date (DD-MM-YYYY format). Maximum 3 months duration, earliest 6 months ago
+     * @param {string} params.end_date End date (DD-MM-YYYY format). Maximum 3 months duration
+     * @returns {Promise<GetGmsCampaignPerformanceResponse>} Response containing campaign performance data
+     *
+     * This API is used to get performance data for a GMS Campaign.
+     * The date range can span up to 3 months and go back up to 6 months from today.
+     *
+     * Performance metrics include impressions, clicks, CTR, expense, GMV, ROAS, and orders.
+     */
+    getGmsCampaignPerformance(params: GetGmsCampaignPerformanceParams): Promise<GetGmsCampaignPerformanceResponse>;
+    /**
+     * Get GMS Item performance
+     * @param {GetGmsItemPerformanceParams} params Request parameters
+     * @param {number} [params.campaign_id] The GMS Campaign ID
+     * @param {string} params.start_date Start date (DD-MM-YYYY format). Maximum 3 months duration, earliest 6 months ago
+     * @param {string} params.end_date End date (DD-MM-YYYY format). Maximum 3 months duration
+     * @param {number} [params.offset] Pagination offset (default: 0)
+     * @param {number} [params.limit] Maximum number of records to show (default: 50, max: 100)
+     * @returns {Promise<GetGmsItemPerformanceResponse>} Response containing item performance data
+     *
+     * This API is used to get performance data for items in a GMS Campaign.
+     * The response is sorted by item_id and only items with performance data are returned.
+     *
+     * The date range can span up to 3 months and go back up to 6 months from today.
+     * Results are paginated with offset and limit parameters.
+     */
+    getGmsItemPerformance(params: GetGmsItemPerformanceParams): Promise<GetGmsItemPerformanceResponse>;
+    /**
+     * List GMS items that have been removed from the Campaign by seller
+     * @param {ListGmsUserDeletedItemParams} [params] Request parameters
+     * @param {number} [params.offset] Pagination offset (default: 0)
+     * @param {number} [params.limit] Maximum number of records to show (default: 50, max: 100)
+     * @returns {Promise<ListGmsUserDeletedItemResponse>} Response containing deleted item IDs
+     *
+     * This API is used to list items that have been removed from a GMS Campaign by the seller.
+     * Results are paginated with offset and limit parameters.
+     */
+    listGmsUserDeletedItem(params?: ListGmsUserDeletedItemParams): Promise<ListGmsUserDeletedItemResponse>;
 }