@congminh1254/shopee-sdk 0.4.0 → 0.6.0

package/README.md

@@ -11,19 +11,19 @@ npm install shopee-sdk
 ## Usage
 
 ```typescript
-import { ShopeeClient } from 'shopee-sdk';
+import { ShopeeClient } from "shopee-sdk";
 
 // Initialize the client
 const client = new ShopeeClient({
   partner_id: 123456,
-  partner_key: 'your-partner-key',
-  base_url: 'https://partner.test-stable.shopeemobile.com', // For sandbox
+  partner_key: "your-partner-key",
+  base_url: "https://partner.test-stable.shopeemobile.com", // For sandbox
   // base_url: 'https://partner.shopeemobile.com', // For production
 });
 
 // Authenticate (if working with shop-level APIs)
 await client.auth.getToken({
-  code: 'authorization-code',
+  code: "authorization-code",
   shop_id: 123456,
 });
 
@@ -43,7 +43,7 @@ const voucher = await client.voucher.addVoucher({
   reward_type: 1, // fixed amount
   usage_quantity: 100,
   min_basket_price: 20,
-  discount_amount: 10
+  discount_amount: 10,
 });
 
 // Example: Get lost push messages (partner-level API, no auth required)
@@ -73,6 +73,7 @@ Examples of commit messages:
 This project uses [Release Please](https://github.com/googleapis/release-please) to automate version management and releases.
 
 The release process follows these steps:
+
 1. Commits to the main branch are automatically analyzed
 2. When conventional commit messages are detected, Release Please creates or updates a release PR
 3. When the release PR is merged:
@@ -82,4 +83,4 @@ The release process follows these steps:
 
 ## License
 
-MIT
+MIT

package/lib/errors.js

@@ -1,13 +1,13 @@
 export class ShopeeSdkError extends Error {
     constructor(message) {
         super(message);
-        this.name = 'ShopeeSdkError';
+        this.name = "ShopeeSdkError";
     }
 }
 export class ShopeeApiError extends Error {
     constructor(status, data) {
         super(`API Error: ${status} - ${JSON.stringify(data)}`);
-        this.name = 'ShopeeApiError';
+        this.name = "ShopeeApiError";
         this.status = status;
         this.data = data;
     }

package/lib/fetch.d.ts

@@ -1,5 +1,5 @@
-import { ShopeeConfig } from './sdk.js';
-import { FetchOptions } from './schemas/fetch.js';
+import { ShopeeConfig } from "./sdk.js";
+import { FetchOptions } from "./schemas/fetch.js";
 export declare class ShopeeFetch {
     static fetch<T>(config: ShopeeConfig, path: string, options?: FetchOptions): Promise<T>;
 }

package/lib/fetch.js

@@ -1,9 +1,9 @@
-import fetch, { Headers } from 'node-fetch';
-import { ShopeeApiError, ShopeeSdkError } from './errors.js';
-import { generateSignature } from './utils/signature.js';
+import fetch, { Headers } from "node-fetch";
+import { ShopeeApiError, ShopeeSdkError } from "./errors.js";
+import { generateSignature } from "./utils/signature.js";
 export class ShopeeFetch {
     static async fetch(config, path, options = {}) {
-        const { method = 'GET', params = {}, body, ...restOptions } = options;
+        const { method = "GET", params = {}, body } = options;
         const url = new URL(`${config.base_url}${path}`);
         // Add required parameters
         const timestamp = Math.floor(Date.now() / 1000);
@@ -21,9 +21,12 @@ export class ShopeeFetch {
         };
         let authParams = {};
         if (options.auth) {
-            const token = await config.sdk?.getAuthToken();
+            let token = await config.sdk?.getAuthToken();
+            if (token?.expired_at && token.expired_at < Date.now()) {
+                token = await config.sdk?.refreshToken();
+            }
             if (!token) {
-                throw new ShopeeSdkError('No access token found');
+                throw new ShopeeSdkError("No access token found");
             }
             authParams = {
                 access_token: token?.access_token,
@@ -39,7 +42,7 @@ export class ShopeeFetch {
         }
         Object.entries({ ...allParams, ...authParams, sign: signature }).forEach(([key, value]) => {
             if (Array.isArray(value)) {
-                value.forEach(item => {
+                value.forEach((item) => {
                     url.searchParams.append(key, String(item));
                 });
             }
@@ -49,7 +52,7 @@ export class ShopeeFetch {
         });
         // Prepare headers
         const headers = new Headers();
-        headers.set('Content-Type', 'application/json');
+        headers.set("Content-Type", "application/json");
         if (options.headers) {
             Object.entries(options.headers).forEach(([key, value]) => {
                 headers.set(key, value);
@@ -63,14 +66,14 @@ export class ShopeeFetch {
         };
         try {
             const response = await fetch(url.toString(), requestOptions);
-            const responseType = response.headers.get('Content-Type');
-            const responseData = responseType?.indexOf('application/json') !== -1
+            const responseType = response.headers.get("Content-Type");
+            const responseData = responseType?.indexOf("application/json") !== -1
                 ? await response.json()
                 : await response.text();
-            if (responseType?.indexOf('application/json') !== -1) {
+            if (responseType?.indexOf("application/json") !== -1) {
                 if (responseData.error) {
                     // Handle invalid access token error
-                    if (responseData.error === 'invalid_acceess_token' && options.auth) {
+                    if (responseData.error === "invalid_acceess_token" && options.auth) {
                         try {
                             // Attempt to refresh the access token
                             await config.sdk?.refreshToken();
@@ -91,14 +94,14 @@ export class ShopeeFetch {
         }
         catch (error) {
             if (error instanceof Error) {
-                if (error.name === 'FetchError') {
+                if (error.name === "FetchError") {
                     // Network error
                     throw new ShopeeSdkError(`Network error: ${error.message}`);
                 }
                 // Other errors
                 throw new ShopeeSdkError(`Unexpected error: ${error.message}`);
             }
-            throw new ShopeeSdkError('Unknown error occurred');
+            throw new ShopeeSdkError("Unknown error occurred");
         }
     }
 }

package/lib/fetch.js.map

@@ -1 +1 @@
-{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../src/fetch.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../src/fetch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAyB,OAAO,EAAe,MAAM,YAAY,CAAC;AAGhF,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,MAAM,OAAO,WAAW;IACf,MAAM,CAAC,KAAK,CAAC,KAAK,CACvB,MAAoB,EACpB,IAAY,EACZ,UAAwB,EAAE;QAE1B,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,MAAM,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;QACtD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,MAAM,CAAC,QAAQ,GAAG,IAAI,EAAE,CAAC,CAAC;QACjD,0BAA0B;QAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAChD,IAAI,SAAS,GAAG,iBAAiB,CAAC,MAAM,CAAC,WAAW,EAAE;YACpD,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE;YAC5B,GAAG,CAAC,QAAQ;YACZ,SAAS,CAAC,QAAQ,EAAE;SACrB,CAAC,CAAC;QAEH,uBAAuB;QACvB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5F,MAAM,SAAS,GAAG;YAChB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,SAAS;YACT,GAAG,MAAM;SACV,CAAC;QAEF,IAAI,UAAU,GAAG,EAAE,CAAC;QAEpB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,IAAI,KAAK,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,YAAY,EAAE,CAAC;YAC7C,IAAI,KAAK,EAAE,UAAU,IAAI,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;gBACvD,KAAK,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,YAAY,EAAE,CAAC;YAC3C,CAAC;YACD,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,IAAI,cAAc,CAAC,uBAAuB,CAAC,CAAC;YACpD,CAAC;YACD,UAAU,GAAG;gBACX,YAAY,EAAE,KAAK,EAAE,YAAY;gBACjC,OAAO,EAAE,KAAK,EAAE,OAAO;aACxB,CAAC;YACF,SAAS,GAAG,iBAAiB,CAAC,MAAM,CAAC,WAAW,EAAE;gBAChD,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE;gBAC5B,GAAG,CAAC,QAAQ;gBACZ,SAAS,CAAC,QAAQ,EAAE;gBACpB,KAAK,EAAE,YAAY;gBACnB,KAAK,EAAE,OAAQ,CAAC,QAAQ,EAAE;aAC3B,CAAC,CAAC;QACL,CAAC;QACD,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,SAAS,EAAE,GAAG,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YACxF,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;oBACrB,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC7C,CAAC,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,kBAAkB;QAClB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;QAChD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;gBACvD,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAe,CAAC,CAAC;YACpC,CAAC,CAAC,CAAC;QACL,CAAC;QAED,wBAAwB;QACxB,MAAM,cAAc,GAAgB;YAClC,MAAM;YACN,OAAO,EAAE,OAAiC;YAC1C,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;SAC9C,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAa,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,cAAc,CAAC,CAAC;YACvE,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YAC1D,MAAM,YAAY,GAChB,YAAY,EAAE,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;gBAC9C,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE;gBACvB,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAE5B,IAAI,YAAY,EAAE,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;gBACrD,IAAI,YAAY,CAAC,KAAK,EAAE,CAAC;oBACvB,oCAAoC;oBACpC,IAAI,YAAY,CAAC,KAAK,KAAK,uBAAuB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;wBACnE,IAAI,CAAC;4BACH,sCAAsC;4BACtC,MAAM,MAAM,CAAC,GAAG,EAAE,YAAY,EAAE,CAAC;4BACjC,uCAAuC;4BACvC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;wBAC3C,CAAC;wBAAC,OAAO,YAAY,EAAE,CAAC;4BACtB,6CAA6C;4BAC7C,MAAM,IAAI,cAAc,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;wBAC1D,CAAC;oBACH,CAAC;oBACD,MAAM,IAAI,cAAc,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;gBAC1D,CAAC;gBAED,MAAM,IAAI,GAAG,YAAiB,CAAC;gBAC/B,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,IAAI,cAAc,CAAC,0BAA0B,YAAY,KAAK,YAAY,EAAE,CAAC,CAAC;QACtF,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;oBAChC,gBAAgB;oBAChB,MAAM,IAAI,cAAc,CAAC,kBAAkB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC9D,CAAC;gBACD,eAAe;gBACf,MAAM,IAAI,cAAc,CAAC,qBAAqB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACjE,CAAC;YACD,MAAM,IAAI,cAAc,CAAC,wBAAwB,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;CACF"}

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 } from "../schemas/ads.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";
 export declare class AdsManager extends BaseManager {
     constructor(config: ShopeeConfig);
     /**
@@ -50,4 +50,224 @@ export declare class AdsManager extends BaseManager {
      * Use this API to get keyword suggestions to improve item discoverability in search results.
      */
     getRecommendedKeywordList(params: GetRecommendedKeywordListParams): Promise<GetRecommendedKeywordListResponse>;
+    /**
+     * Get the list of recommended SKUs (Shop level) with the corresponding tag
+     * @returns {Promise<GetRecommendedItemListResponse>} Response containing recommended items
+     *
+     * This API is used to get the list of recommended SKU (Shop level) with the corresponding tag,
+     * i.e top search/best selling/best ROI tag.
+     *
+     * The response includes an array of items with the following details for each item:
+     * - item_id: Recommended SKU's item id
+     * - item_status_list: Status of items (indicates whether an item is eligible for ads or not)
+     * - sku_tag_list: Tags such as "best selling", "best ROI", "top search"
+     * - ongoing_ad_type_list: Current status of ads on this item (e.g., search ads, discovery ads)
+     *
+     * Use this API to identify high-potential items for advertising campaigns.
+     */
+    getRecommendedItemList(): Promise<GetRecommendedItemListResponse>;
+    /**
+     * Get shop level CPC ads single-date hourly performance data
+     * @param {GetAllCpcAdsHourlyPerformanceParams} params Request parameters
+     * @param {string} params.performance_date Single date for hourly performance data in DD-MM-YYYY format
+     * @returns {Promise<GetAllCpcAdsHourlyPerformanceResponse>} Response containing hourly performance metrics
+     *
+     * This API is used to get Shop level CPC ads single-date hourly performance.
+     * The date must be today or earlier than today (up to 6 months ago).
+     *
+     * The response includes an array of hourly performance metrics with the following details for each hour:
+     * - hour: The hour the performance record belongs to
+     * - date: The date the performance record belongs to
+     * - impression: Number of times buyers see ads
+     * - clicks: Total number of clicks on the ad
+     * - ctr: Click-through rate (Clicks / Impressions)
+     * - direct_order: Orders placed within 7 days after clicking on the clicked ad
+     * - broad_order: Orders placed within 7 days after clicking on any ad from the same shop
+     * - direct_conversions: Direct conversion rate (clicked ad orders / total clicks)
+     * - broad_conversions: Broad conversion rate (any shop orders / total clicks)
+     * - direct_item_sold: Items sold from the clicked ad
+     * - broad_item_sold: Items sold from the shop after any ad click
+     * - direct_gmv: Total sales from the clicked ad
+     * - broad_gmv: Total sales from the shop after any ad click
+     * - expense: Ad expenditure
+     * - cost_per_conversion: Average cost per sales conversion
+     * - direct_roas: Direct return on ad spend (direct GMV / expense)
+     * - broad_roas: Broad return on ad spend (broad GMV / expense)
+     *
+     * Use this API to analyze hourly ad performance patterns for optimization.
+     */
+    getAllCpcAdsHourlyPerformance(params: GetAllCpcAdsHourlyPerformanceParams): Promise<GetAllCpcAdsHourlyPerformanceResponse>;
+    /**
+     * Get shop level CPC ads daily performance data for a date range
+     * @param {GetAllCpcAdsDailyPerformanceParams} params Request parameters
+     * @param {string} params.start_date Start date of the performance data range in DD-MM-YYYY format
+     * @param {string} params.end_date End date of the performance data range in DD-MM-YYYY format
+     * @returns {Promise<GetAllCpcAdsDailyPerformanceResponse>} Response containing daily performance metrics
+     *
+     * This API is used to get Shop level CPC ads multiple-days daily performance.
+     * The date range must be today or earlier than today (up to 6 months ago), and cannot exceed 1 month.
+     * Start date must be earlier than end date and cannot be equal to end date.
+     *
+     * The response includes an array of daily performance metrics with the following details for each day:
+     * - date: The date the performance record belongs to
+     * - impression: Number of times buyers see ads
+     * - clicks: Total number of clicks on the ad
+     * - ctr: Click-through rate (Clicks / Impressions)
+     * - direct_order: Orders placed within 7 days after clicking on the clicked ad
+     * - broad_order: Orders placed within 7 days after clicking on any ad from the same shop
+     * - direct_conversions: Direct conversion rate (clicked ad orders / total clicks)
+     * - broad_conversions: Broad conversion rate (any shop orders / total clicks)
+     * - direct_item_sold: Items sold from the clicked ad
+     * - broad_item_sold: Items sold from the shop after any ad click
+     * - direct_gmv: Total sales from the clicked ad
+     * - broad_gmv: Total sales from the shop after any ad click
+     * - expense: Ad expenditure
+     * - cost_per_conversion: Average cost per sales conversion
+     * - direct_roas: Direct return on ad spend (direct GMV / expense)
+     * - broad_roas: Broad return on ad spend (broad GMV / expense)
+     *
+     * Use this API to analyze daily ad performance trends over a time period.
+     */
+    getAllCpcAdsDailyPerformance(params: GetAllCpcAdsDailyPerformanceParams): Promise<GetAllCpcAdsDailyPerformanceResponse>;
+    /**
+     * Get product-level campaign performance data for a date range
+     * @param {GetProductCampaignDailyPerformanceParams} params Request parameters
+     * @param {string} params.start_date Start date of the performance data range in DD-MM-YYYY format
+     * @param {string} params.end_date End date of the performance data range in DD-MM-YYYY format
+     * @param {string} params.campaign_id_list Comma-separated list of campaign IDs to fetch performance for (max 100)
+     * @returns {Promise<GetProductCampaignDailyPerformanceResponse>} Response containing detailed campaign performance metrics
+     *
+     * This API is used to get product-level ads performance data across multiple days.
+     * The date range must be today or earlier than today (up to 6 months ago), and cannot exceed 1 month.
+     * Start date must be earlier than end date and cannot be equal to end date.
+     *
+     * The response is structured hierarchically with:
+     * - shop_id and region information
+     * - Detailed campaign list with campaign_id, ad_type, campaign_placement, and ad_name
+     * - Comprehensive daily metrics for each campaign including:
+     *   - Impressions, clicks, and CTR
+     *   - Expense (ad spend)
+     *   - Direct and broad performance metrics (orders, GMV, ROI)
+     *   - Conversion rates and cost efficiency metrics
+     *
+     * Direct metrics refer to performance of the advertised product specifically, while
+     * broad metrics account for any purchases from the shop after an ad click.
+     *
+     * Use this API to analyze campaign effectiveness at the product level and optimize
+     * your advertising strategy based on detailed performance data.
+     */
+    getProductCampaignDailyPerformance(params: GetProductCampaignDailyPerformanceParams): Promise<GetProductCampaignDailyPerformanceResponse>;
+    /**
+     * Get product-level campaign hourly performance data for a single day
+     * @param {GetProductCampaignHourlyPerformanceParams} params Request parameters
+     * @param {string} params.performance_date Single date for the hourly performance data in DD-MM-YYYY format
+     * @param {string} params.campaign_id_list Comma-separated list of campaign IDs to fetch performance for (max 100)
+     * @returns {Promise<GetProductCampaignHourlyPerformanceResponse>} Response containing detailed hourly campaign performance metrics
+     *
+     * This API is used to get product-level ads hourly performance data for a single day.
+     * The date must be today or earlier than today (up to 6 months ago).
+     *
+     * The response is structured hierarchically with:
+     * - shop_id and region information
+     * - Detailed campaign list with campaign_id, ad_type, campaign_placement, and ad_name
+     * - Comprehensive hourly metrics for each campaign including:
+     *   - Hour the performance record belongs to
+     *   - Impressions, clicks, and CTR
+     *   - Expense (ad spend)
+     *   - Direct and broad performance metrics (orders, GMV, ROI)
+     *   - Conversion rates and cost efficiency metrics
+     *
+     * Direct metrics refer to performance of the advertised product specifically, while
+     * broad metrics account for any purchases from the shop after an ad click.
+     *
+     * Use this API to analyze hourly campaign patterns and performance fluctuations
+     * throughout the day to optimize timing of ad campaigns and budget allocation.
+     */
+    getProductCampaignHourlyPerformance(params: GetProductCampaignHourlyPerformanceParams): Promise<GetProductCampaignHourlyPerformanceResponse>;
+    /**
+     * Get a list of all product-level campaign IDs for a shop
+     * @param {GetProductLevelCampaignIdListParams} [params] Optional request parameters
+     * @param {string} [params.ad_type] Filter campaigns by ad type (can be "", "all", "auto", or "manual")
+     * @param {number} [params.offset] Pagination offset for fetching subsequent pages
+     * @param {number} [params.limit] Page size limit (number of results to return)
+     * @returns {Promise<GetProductLevelCampaignIdListResponse>} Response containing campaign IDs and pagination info
+     *
+     * This API is used to fetch all product campaign IDs displayed on the advertiser platform
+     * for a specific shop. The results can be filtered by ad type and paginated using
+     * offset and limit parameters.
+     *
+     * The response contains:
+     * - shop_id: The unique identifier for the shop
+     * - region: The region where the shop is located
+     * - has_next_page: Indicates if there are more campaigns on the next page
+     * - campaign_list: List of campaigns with ad_type and campaign_id
+     *
+     * Use this API to retrieve campaign IDs that can then be used with other APIs
+     * like getProductCampaignDailyPerformance or getProductCampaignHourlyPerformance
+     * to fetch detailed performance metrics.
+     */
+    getProductLevelCampaignIdList(params?: GetProductLevelCampaignIdListParams): Promise<GetProductLevelCampaignIdListResponse>;
+    /**
+     * Get detailed settings information for product-level campaigns
+     * @param {GetProductLevelCampaignSettingInfoParams} params Request parameters
+     * @param {string} params.info_type_list Comma-separated list of info types to retrieve (1: Common Info, 2: Manual Bidding Info, 3: Auto Bidding Info, 4: Auto Product Ads Info)
+     * @param {string} params.campaign_id_list Comma-separated list of campaign IDs to fetch settings for (max 100)
+     * @returns {Promise<GetProductLevelCampaignSettingInfoResponse>} Response containing detailed campaign settings
+     *
+     * This API is used to retrieve detailed configuration settings for product-level ad campaigns.
+     * Depending on the info_type_list parameter, different types of information will be returned:
+     *
+     * Info type 1 (Common Info) includes:
+     * - Ad type (auto or manual)
+     * - Ad name and status
+     * - Bidding method and placement
+     * - Campaign budget and duration
+     * - List of item IDs in the campaign
+     *
+     * Info type 2 (Manual Bidding Info) includes:
+     * - Enhanced CPC setting
+     * - Selected keywords with match types and bid prices
+     * - Discovery ads placement settings
+     *
+     * Info type 3 (Auto Bidding Info) includes:
+     * - ROAS (Return on Ad Spend) target
+     *
+     * Info type 4 (Auto Product Ads Info) includes:
+     * - Product name and status
+     * - Item IDs
+     *
+     * Use this API to analyze and understand the detailed settings of your ad campaigns,
+     * which can help with optimization and decision-making for future campaign management.
+     */
+    getProductLevelCampaignSettingInfo(params: GetProductLevelCampaignSettingInfoParams): Promise<GetProductLevelCampaignSettingInfoResponse>;
+    /**
+     * Get recommended ROI target values for a product's ad campaign
+     * @param {GetProductRecommendedRoiTargetParams} params Request parameters
+     * @param {string} params.reference_id A random string used to prevent duplicate ads
+     * @param {number} params.item_id Unique identifier for a product
+     * @returns {Promise<GetProductRecommendedRoiTargetResponse>} Response containing recommended ROI targets
+     *
+     * This API is used to get recommended Return on Investment (ROI) target values for
+     * a product's ad campaign. These recommendations help sellers set competitive ROI
+     * targets for their advertising campaigns.
+     *
+     * The response includes three recommendation levels:
+     *
+     * - Lower bound: A more competitive target (e.g., value=3.5, percentile=80) that makes
+     *   the ad more competitive than 80% of similar ads.
+     *
+     * - Exact (mid-level): A balanced target (e.g., value=5.9, percentile=50) that makes
+     *   the ad more competitive than 50% of similar ads.
+     *
+     * - Upper bound: A less competitive target (e.g., value=10.8, percentile=20) that makes
+     *   the ad more competitive than 20% of similar ads.
+     *
+     * Each recommendation includes:
+     * - value: The recommended ROI target value
+     * - percentile: Indicates how competitive this target is compared to similar ads
+     *
+     * Use this API to help determine optimal ROI targets for your advertising strategy
+     * based on competitive marketplace data.
+     */
+    getProductRecommendedRoiTarget(params: GetProductRecommendedRoiTargetParams): Promise<GetProductRecommendedRoiTargetResponse>;
 }