ebay-mcp 1.14.0 → 1.14.2

package/build/api/marketing-and-promotions/ads.js

@@ -0,0 +1,621 @@
+import { buildEndpointParams, requestDeleteEffect, requestGetEffect, requestPostEffect, requestPutEffect, } from '../../api/shared/request.js';
+import { MARKETING_BASE_PATH } from './shared.js';
+/** Marketing API — ads methods closed over a shared client. */
+export const createMarketingAdsMethods = (client) => ({
+    /**
+     * Bulk create ads by inventory reference through the eBay Marketing API.
+     *
+     * @param input - Path, query, header, and request body values for bulkCreateAdsByInventoryReference.
+     * @returns An Effect that succeeds with eBay's generated bulkCreateAdsByInventoryReference response DTO.
+     *
+     * @example
+     * ```ts
+     * const response = await Effect.runPromise(marketingApi.bulkCreateAdsByInventoryReference({ campaignId: 'campaign-1', request: { ... } }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad/methods/bulkCreateAdsByInventoryReference
+     */
+    bulkCreateAdsByInventoryReference: (input) => {
+        const path = `${MARKETING_BASE_PATH}/ad_campaign/${input.campaignId}/bulk_create_ads_by_inventory_reference`;
+        return requestPostEffect(client, path, input.request);
+    },
+    /**
+     * Bulk create ads by listing id through the eBay Marketing API.
+     *
+     * @param input - Path, query, header, and request body values for bulkCreateAdsByListingId.
+     * @returns An Effect that succeeds with eBay's generated bulkCreateAdsByListingId response DTO.
+     *
+     * @example
+     * ```ts
+     * const response = await Effect.runPromise(marketingApi.bulkCreateAdsByListingId({ campaignId: 'campaign-1', request: { ... } }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad/methods/bulkCreateAdsByListingId
+     */
+    bulkCreateAdsByListingId: (input) => {
+        const path = `${MARKETING_BASE_PATH}/ad_campaign/${input.campaignId}/bulk_create_ads_by_listing_id`;
+        return requestPostEffect(client, path, input.request);
+    },
+    /**
+     * Bulk delete ads by inventory reference through the eBay Marketing API.
+     *
+     * @param input - Path, query, header, and request body values for bulkDeleteAdsByInventoryReference.
+     * @returns An Effect that succeeds with eBay's generated bulkDeleteAdsByInventoryReference response DTO.
+     *
+     * @example
+     * ```ts
+     * const response = await Effect.runPromise(marketingApi.bulkDeleteAdsByInventoryReference({ campaignId: 'campaign-1', request: { ... } }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad/methods/bulkDeleteAdsByInventoryReference
+     */
+    bulkDeleteAdsByInventoryReference: (input) => {
+        const path = `${MARKETING_BASE_PATH}/ad_campaign/${input.campaignId}/bulk_delete_ads_by_inventory_reference`;
+        return requestPostEffect(client, path, input.request);
+    },
+    /**
+     * Bulk delete ads by listing id through the eBay Marketing API.
+     *
+     * @param input - Path, query, header, and request body values for bulkDeleteAdsByListingId.
+     * @returns An Effect that succeeds with eBay's generated bulkDeleteAdsByListingId response DTO.
+     *
+     * @example
+     * ```ts
+     * const response = await Effect.runPromise(marketingApi.bulkDeleteAdsByListingId({ campaignId: 'campaign-1', request: { ... } }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad/methods/bulkDeleteAdsByListingId
+     */
+    bulkDeleteAdsByListingId: (input) => {
+        const path = `${MARKETING_BASE_PATH}/ad_campaign/${input.campaignId}/bulk_delete_ads_by_listing_id`;
+        return requestPostEffect(client, path, input.request);
+    },
+    /**
+     * Bulk update ads bid by inventory reference through the eBay Marketing API.
+     *
+     * @param input - Path, query, header, and request body values for bulkUpdateAdsBidByInventoryReference.
+     * @returns An Effect that succeeds with eBay's generated bulkUpdateAdsBidByInventoryReference response DTO.
+     *
+     * @example
+     * ```ts
+     * const response = await Effect.runPromise(marketingApi.bulkUpdateAdsBidByInventoryReference({ campaignId: 'campaign-1', request: { ... } }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad/methods/bulkUpdateAdsBidByInventoryReference
+     */
+    bulkUpdateAdsBidByInventoryReference: (input) => {
+        const path = `${MARKETING_BASE_PATH}/ad_campaign/${input.campaignId}/bulk_update_ads_bid_by_inventory_reference`;
+        return requestPostEffect(client, path, input.request);
+    },
+    /**
+     * Bulk update ads bid by listing id through the eBay Marketing API.
+     *
+     * @param input - Path, query, header, and request body values for bulkUpdateAdsBidByListingId.
+     * @returns An Effect that succeeds with eBay's generated bulkUpdateAdsBidByListingId response DTO.
+     *
+     * @example
+     * ```ts
+     * const response = await Effect.runPromise(marketingApi.bulkUpdateAdsBidByListingId({ campaignId: 'campaign-1', request: { ... } }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad/methods/bulkUpdateAdsBidByListingId
+     */
+    bulkUpdateAdsBidByListingId: (input) => {
+        const path = `${MARKETING_BASE_PATH}/ad_campaign/${input.campaignId}/bulk_update_ads_bid_by_listing_id`;
+        return requestPostEffect(client, path, input.request);
+    },
+    /**
+     * Bulk update ads status through the eBay Marketing API.
+     *
+     * @param input - Path, query, header, and request body values for bulkUpdateAdsStatus.
+     * @returns An Effect that succeeds with eBay's generated bulkUpdateAdsStatus response DTO.
+     *
+     * @example
+     * ```ts
+     * const response = await Effect.runPromise(marketingApi.bulkUpdateAdsStatus({ campaignId: 'campaign-1', request: { ... } }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad/methods/bulkUpdateAdsStatus
+     */
+    bulkUpdateAdsStatus: (input) => {
+        const path = `${MARKETING_BASE_PATH}/ad_campaign/${input.campaignId}/bulk_update_ads_status`;
+        return requestPostEffect(client, path, input.request);
+    },
+    /**
+     * Bulk update ads status by listing id through the eBay Marketing API.
+     *
+     * @param input - Path, query, header, and request body values for bulkUpdateAdsStatusByListingId.
+     * @returns An Effect that succeeds with eBay's generated bulkUpdateAdsStatusByListingId response DTO.
+     *
+     * @example
+     * ```ts
+     * const response = await Effect.runPromise(marketingApi.bulkUpdateAdsStatusByListingId({ campaignId: 'campaign-1', request: { ... } }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad/methods/bulkUpdateAdsStatusByListingId
+     */
+    bulkUpdateAdsStatusByListingId: (input) => {
+        const path = `${MARKETING_BASE_PATH}/ad_campaign/${input.campaignId}/bulk_update_ads_status_by_listing_id`;
+        return requestPostEffect(client, path, input.request);
+    },
+    /**
+     * Get ads through the eBay Marketing API.
+     *
+     * @param input - Path, query, header, and request body values for getAds.
+     * @returns An Effect that succeeds with eBay's generated getAds response DTO.
+     *
+     * @example
+     * ```ts
+     * const response = await Effect.runPromise(marketingApi.getAds({ campaignId: 'campaign-1' }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad/methods/getAds
+     */
+    getAds: (input) => {
+        const path = `${MARKETING_BASE_PATH}/ad_campaign/${input.campaignId}/ad`;
+        const params = buildEndpointParams({
+            adGroupIds: { wireName: 'ad_group_ids', value: input.adGroupIds },
+            adStatus: { wireName: 'ad_status', value: input.adStatus },
+            limit: { wireName: 'limit', value: input.limit },
+            listingIds: { wireName: 'listing_ids', value: input.listingIds },
+            offset: { wireName: 'offset', value: input.offset },
+        });
+        return requestGetEffect(client, path, params);
+    },
+    /**
+     * Create ad by listing id through the eBay Marketing API.
+     *
+     * @param input - Path, query, header, and request body values for createAdByListingId.
+     * @returns An Effect that succeeds with eBay's generated createAdByListingId response DTO.
+     *
+     * @example
+     * ```ts
+     * const response = await Effect.runPromise(marketingApi.createAdByListingId({ campaignId: 'campaign-1', request: { ... } }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad/methods/createAdByListingId
+     */
+    createAdByListingId: (input) => {
+        const path = `${MARKETING_BASE_PATH}/ad_campaign/${input.campaignId}/ad`;
+        return requestPostEffect(client, path, input.request);
+    },
+    /**
+     * Create ads by inventory reference through the eBay Marketing API.
+     *
+     * @param input - Path, query, header, and request body values for createAdsByInventoryReference.
+     * @returns An Effect that succeeds with eBay's generated createAdsByInventoryReference response DTO.
+     *
+     * @example
+     * ```ts
+     * const response = await Effect.runPromise(marketingApi.createAdsByInventoryReference({ campaignId: 'campaign-1', request: { ... } }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad/methods/createAdsByInventoryReference
+     */
+    createAdsByInventoryReference: (input) => {
+        const path = `${MARKETING_BASE_PATH}/ad_campaign/${input.campaignId}/create_ads_by_inventory_reference`;
+        return requestPostEffect(client, path, input.request);
+    },
+    /**
+     * Get ad through the eBay Marketing API.
+     *
+     * @param input - Path, query, header, and request body values for getAd.
+     * @returns An Effect that succeeds with eBay's generated getAd response DTO.
+     *
+     * @example
+     * ```ts
+     * const response = await Effect.runPromise(marketingApi.getAd({ adId: 'ad-1', campaignId: 'campaign-1' }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad/methods/getAd
+     */
+    getAd: (input) => {
+        const path = `${MARKETING_BASE_PATH}/ad_campaign/${input.campaignId}/ad/${input.adId}`;
+        return requestGetEffect(client, path);
+    },
+    /**
+     * Delete ad through the eBay Marketing API.
+     *
+     * @param input - Path, query, header, and request body values for deleteAd.
+     * @returns An Effect that succeeds with eBay's generated deleteAd response DTO.
+     *
+     * @example
+     * ```ts
+     * const response = await Effect.runPromise(marketingApi.deleteAd({ adId: 'ad-1', campaignId: 'campaign-1' }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad/methods/deleteAd
+     */
+    deleteAd: (input) => {
+        const path = `${MARKETING_BASE_PATH}/ad_campaign/${input.campaignId}/ad/${input.adId}`;
+        return requestDeleteEffect(client, path);
+    },
+    /**
+     * Delete ads by inventory reference through the eBay Marketing API.
+     *
+     * @param input - Path, query, header, and request body values for deleteAdsByInventoryReference.
+     * @returns An Effect that succeeds with eBay's generated deleteAdsByInventoryReference response DTO.
+     *
+     * @example
+     * ```ts
+     * const response = await Effect.runPromise(marketingApi.deleteAdsByInventoryReference({ campaignId: 'campaign-1', request: { ... } }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad/methods/deleteAdsByInventoryReference
+     */
+    deleteAdsByInventoryReference: (input) => {
+        const path = `${MARKETING_BASE_PATH}/ad_campaign/${input.campaignId}/delete_ads_by_inventory_reference`;
+        return requestPostEffect(client, path, input.request);
+    },
+    /**
+     * Get ads by inventory reference through the eBay Marketing API.
+     *
+     * @param input - Path, query, header, and request body values for getAdsByInventoryReference.
+     * @returns An Effect that succeeds with eBay's generated getAdsByInventoryReference response DTO.
+     *
+     * @example
+     * ```ts
+     * const response = await Effect.runPromise(marketingApi.getAdsByInventoryReference({ campaignId: 'campaign-1', inventoryReferenceId: 'inventoryReference-1', inventoryReferenceType: 'inventoryReferenceType-1' }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad/methods/getAdsByInventoryReference
+     */
+    getAdsByInventoryReference: (input) => {
+        const path = `${MARKETING_BASE_PATH}/ad_campaign/${input.campaignId}/get_ads_by_inventory_reference`;
+        const params = buildEndpointParams({
+            inventoryReferenceId: {
+                wireName: 'inventory_reference_id',
+                value: input.inventoryReferenceId,
+            },
+            inventoryReferenceType: {
+                wireName: 'inventory_reference_type',
+                value: input.inventoryReferenceType,
+            },
+        });
+        return requestGetEffect(client, path, params);
+    },
+    /**
+     * Update bid through the eBay Marketing API.
+     *
+     * @param input - Path, query, header, and request body values for updateBid.
+     * @returns An Effect that succeeds with eBay's generated updateBid response DTO.
+     *
+     * @example
+     * ```ts
+     * const response = await Effect.runPromise(marketingApi.updateBid({ adId: 'ad-1', campaignId: 'campaign-1', request: { ... } }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad/methods/updateBid
+     */
+    updateBid: (input) => {
+        const path = `${MARKETING_BASE_PATH}/ad_campaign/${input.campaignId}/ad/${input.adId}/update_bid`;
+        return requestPostEffect(client, path, input.request);
+    },
+    /**
+     * Get ad groups through the eBay Marketing API.
+     *
+     * @param input - Path, query, header, and request body values for getAdGroups.
+     * @returns An Effect that succeeds with eBay's generated getAdGroups response DTO.
+     *
+     * @example
+     * ```ts
+     * const response = await Effect.runPromise(marketingApi.getAdGroups({ campaignId: 'campaign-1' }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad_group/methods/getAdGroups
+     */
+    getAdGroups: (input) => {
+        const path = `${MARKETING_BASE_PATH}/ad_campaign/${input.campaignId}/ad_group`;
+        const params = buildEndpointParams({
+            adGroupStatus: { wireName: 'ad_group_status', value: input.adGroupStatus },
+            limit: { wireName: 'limit', value: input.limit },
+            offset: { wireName: 'offset', value: input.offset },
+        });
+        return requestGetEffect(client, path, params);
+    },
+    /**
+     * Create ad group through the eBay Marketing API.
+     *
+     * @param input - Path, query, header, and request body values for createAdGroup.
+     * @returns An Effect that succeeds with eBay's generated createAdGroup response DTO.
+     *
+     * @example
+     * ```ts
+     * const response = await Effect.runPromise(marketingApi.createAdGroup({ campaignId: 'campaign-1', request: { ... } }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad_group/methods/createAdGroup
+     */
+    createAdGroup: (input) => {
+        const path = `${MARKETING_BASE_PATH}/ad_campaign/${input.campaignId}/ad_group`;
+        return requestPostEffect(client, path, input.request);
+    },
+    /**
+     * Get ad group through the eBay Marketing API.
+     *
+     * @param input - Path, query, header, and request body values for getAdGroup.
+     * @returns An Effect that succeeds with eBay's generated getAdGroup response DTO.
+     *
+     * @example
+     * ```ts
+     * const response = await Effect.runPromise(marketingApi.getAdGroup({ adGroupId: 'adGroup-1', campaignId: 'campaign-1' }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad_group/methods/getAdGroup
+     */
+    getAdGroup: (input) => {
+        const path = `${MARKETING_BASE_PATH}/ad_campaign/${input.campaignId}/ad_group/${input.adGroupId}`;
+        return requestGetEffect(client, path);
+    },
+    /**
+     * Update ad group through the eBay Marketing API.
+     *
+     * @param input - Path, query, header, and request body values for updateAdGroup.
+     * @returns An Effect that succeeds with eBay's generated updateAdGroup response DTO.
+     *
+     * @example
+     * ```ts
+     * const response = await Effect.runPromise(marketingApi.updateAdGroup({ adGroupId: 'adGroup-1', campaignId: 'campaign-1', request: { ... } }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad_group/methods/updateAdGroup
+     */
+    updateAdGroup: (input) => {
+        const path = `${MARKETING_BASE_PATH}/ad_campaign/${input.campaignId}/ad_group/${input.adGroupId}`;
+        return requestPutEffect(client, path, input.request);
+    },
+    /**
+     * Suggest bids through the eBay Marketing API.
+     *
+     * @param input - Path, query, header, and request body values for suggestBids.
+     * @returns An Effect that succeeds with eBay's generated suggestBids response DTO.
+     *
+     * @example
+     * ```ts
+     * const response = await Effect.runPromise(marketingApi.suggestBids({ adGroupId: 'adGroup-1', campaignId: 'campaign-1', request: { ... } }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad_group/methods/suggestBids
+     */
+    suggestBids: (input) => {
+        const path = `${MARKETING_BASE_PATH}/ad_campaign/${input.campaignId}/ad_group/${input.adGroupId}/suggest_bids`;
+        return requestPostEffect(client, path, input.request);
+    },
+    /**
+     * Suggest keywords through the eBay Marketing API.
+     *
+     * @param input - Path, query, header, and request body values for suggestKeywords.
+     * @returns An Effect that succeeds with eBay's generated suggestKeywords response DTO.
+     *
+     * @example
+     * ```ts
+     * const response = await Effect.runPromise(marketingApi.suggestKeywords({ adGroupId: 'adGroup-1', campaignId: 'campaign-1', request: { ... } }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad_group/methods/suggestKeywords
+     */
+    suggestKeywords: (input) => {
+        const path = `${MARKETING_BASE_PATH}/ad_campaign/${input.campaignId}/ad_group/${input.adGroupId}/suggest_keywords`;
+        return requestPostEffect(client, path, input.request);
+    },
+    /**
+     * Bulk create keyword through the eBay Marketing API.
+     *
+     * @param input - Path, query, header, and request body values for bulkCreateKeyword.
+     * @returns An Effect that succeeds with eBay's generated bulkCreateKeyword response DTO.
+     *
+     * @example
+     * ```ts
+     * const response = await Effect.runPromise(marketingApi.bulkCreateKeyword({ campaignId: 'campaign-1', request: { ... } }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/marketing/resources/keyword/methods/bulkCreateKeyword
+     */
+    bulkCreateKeyword: (input) => {
+        const path = `${MARKETING_BASE_PATH}/ad_campaign/${input.campaignId}/bulk_create_keyword`;
+        return requestPostEffect(client, path, input.request);
+    },
+    /**
+     * Bulk update keyword through the eBay Marketing API.
+     *
+     * @param input - Path, query, header, and request body values for bulkUpdateKeyword.
+     * @returns An Effect that succeeds with eBay's generated bulkUpdateKeyword response DTO.
+     *
+     * @example
+     * ```ts
+     * const response = await Effect.runPromise(marketingApi.bulkUpdateKeyword({ campaignId: 'campaign-1', request: { ... } }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/marketing/resources/keyword/methods/bulkUpdateKeyword
+     */
+    bulkUpdateKeyword: (input) => {
+        const path = `${MARKETING_BASE_PATH}/ad_campaign/${input.campaignId}/bulk_update_keyword`;
+        return requestPostEffect(client, path, input.request);
+    },
+    /**
+     * Get keywords through the eBay Marketing API.
+     *
+     * @param input - Path, query, header, and request body values for getKeywords.
+     * @returns An Effect that succeeds with eBay's generated getKeywords response DTO.
+     *
+     * @example
+     * ```ts
+     * const response = await Effect.runPromise(marketingApi.getKeywords({ campaignId: 'campaign-1' }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/marketing/resources/keyword/methods/getKeywords
+     */
+    getKeywords: (input) => {
+        const path = `${MARKETING_BASE_PATH}/ad_campaign/${input.campaignId}/keyword`;
+        const params = buildEndpointParams({
+            adGroupIds: { wireName: 'ad_group_ids', value: input.adGroupIds },
+            keywordStatus: { wireName: 'keyword_status', value: input.keywordStatus },
+            limit: { wireName: 'limit', value: input.limit },
+            offset: { wireName: 'offset', value: input.offset },
+        });
+        return requestGetEffect(client, path, params);
+    },
+    /**
+     * Create keyword through the eBay Marketing API.
+     *
+     * @param input - Path, query, header, and request body values for createKeyword.
+     * @returns An Effect that succeeds with eBay's generated createKeyword response DTO.
+     *
+     * @example
+     * ```ts
+     * const response = await Effect.runPromise(marketingApi.createKeyword({ campaignId: 'campaign-1', request: { ... } }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/marketing/resources/keyword/methods/createKeyword
+     */
+    createKeyword: (input) => {
+        const path = `${MARKETING_BASE_PATH}/ad_campaign/${input.campaignId}/keyword`;
+        return requestPostEffect(client, path, input.request);
+    },
+    /**
+     * Get keyword through the eBay Marketing API.
+     *
+     * @param input - Path, query, header, and request body values for getKeyword.
+     * @returns An Effect that succeeds with eBay's generated getKeyword response DTO.
+     *
+     * @example
+     * ```ts
+     * const response = await Effect.runPromise(marketingApi.getKeyword({ campaignId: 'campaign-1', keywordId: 'keyword-1' }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/marketing/resources/keyword/methods/getKeyword
+     */
+    getKeyword: (input) => {
+        const path = `${MARKETING_BASE_PATH}/ad_campaign/${input.campaignId}/keyword/${input.keywordId}`;
+        return requestGetEffect(client, path);
+    },
+    /**
+     * Update keyword through the eBay Marketing API.
+     *
+     * @param input - Path, query, header, and request body values for updateKeyword.
+     * @returns An Effect that succeeds with eBay's generated updateKeyword response DTO.
+     *
+     * @example
+     * ```ts
+     * const response = await Effect.runPromise(marketingApi.updateKeyword({ campaignId: 'campaign-1', keywordId: 'keyword-1', request: { ... } }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/marketing/resources/keyword/methods/updateKeyword
+     */
+    updateKeyword: (input) => {
+        const path = `${MARKETING_BASE_PATH}/ad_campaign/${input.campaignId}/keyword/${input.keywordId}`;
+        return requestPutEffect(client, path, input.request);
+    },
+    /**
+     * Bulk create negative keyword through the eBay Marketing API.
+     *
+     * @param input - Path, query, header, and request body values for bulkCreateNegativeKeyword.
+     * @returns An Effect that succeeds with eBay's generated bulkCreateNegativeKeyword response DTO.
+     *
+     * @example
+     * ```ts
+     * const response = await Effect.runPromise(marketingApi.bulkCreateNegativeKeyword({ request: { ... } }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/marketing/resources/negative_keyword/methods/bulkCreateNegativeKeyword
+     */
+    bulkCreateNegativeKeyword: (input) => {
+        const path = `${MARKETING_BASE_PATH}/bulk_create_negative_keyword`;
+        return requestPostEffect(client, path, input.request);
+    },
+    /**
+     * Bulk update negative keyword through the eBay Marketing API.
+     *
+     * @param input - Path, query, header, and request body values for bulkUpdateNegativeKeyword.
+     * @returns An Effect that succeeds with eBay's generated bulkUpdateNegativeKeyword response DTO.
+     *
+     * @example
+     * ```ts
+     * const response = await Effect.runPromise(marketingApi.bulkUpdateNegativeKeyword({ request: { ... } }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/marketing/resources/negative_keyword/methods/bulkUpdateNegativeKeyword
+     */
+    bulkUpdateNegativeKeyword: (input) => {
+        const path = `${MARKETING_BASE_PATH}/bulk_update_negative_keyword`;
+        return requestPostEffect(client, path, input.request);
+    },
+    /**
+     * Get negative keywords through the eBay Marketing API.
+     *
+     * @param input - Path, query, header, and request body values for getNegativeKeywords.
+     * @returns An Effect that succeeds with eBay's generated getNegativeKeywords response DTO.
+     *
+     * @example
+     * ```ts
+     * const response = await Effect.runPromise(marketingApi.getNegativeKeywords());
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/marketing/resources/negative_keyword/methods/getNegativeKeywords
+     */
+    getNegativeKeywords: (input = {}) => {
+        const path = `${MARKETING_BASE_PATH}/negative_keyword`;
+        const params = buildEndpointParams({
+            adGroupIds: { wireName: 'ad_group_ids', value: input.adGroupIds },
+            campaignIds: { wireName: 'campaign_ids', value: input.campaignIds },
+            limit: { wireName: 'limit', value: input.limit },
+            negativeKeywordStatus: {
+                wireName: 'negative_keyword_status',
+                value: input.negativeKeywordStatus,
+            },
+            offset: { wireName: 'offset', value: input.offset },
+        });
+        return requestGetEffect(client, path, params);
+    },
+    /**
+     * Create negative keyword through the eBay Marketing API.
+     *
+     * @param input - Path, query, header, and request body values for createNegativeKeyword.
+     * @returns An Effect that succeeds with eBay's generated createNegativeKeyword response DTO.
+     *
+     * @example
+     * ```ts
+     * const response = await Effect.runPromise(marketingApi.createNegativeKeyword({ request: { ... } }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/marketing/resources/negative_keyword/methods/createNegativeKeyword
+     */
+    createNegativeKeyword: (input) => {
+        const path = `${MARKETING_BASE_PATH}/negative_keyword`;
+        return requestPostEffect(client, path, input.request);
+    },
+    /**
+     * Get negative keyword through the eBay Marketing API.
+     *
+     * @param input - Path, query, header, and request body values for getNegativeKeyword.
+     * @returns An Effect that succeeds with eBay's generated getNegativeKeyword response DTO.
+     *
+     * @example
+     * ```ts
+     * const response = await Effect.runPromise(marketingApi.getNegativeKeyword({ negativeKeywordId: 'negativeKeyword-1' }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/marketing/resources/negative_keyword/methods/getNegativeKeyword
+     */
+    getNegativeKeyword: (input) => {
+        const path = `${MARKETING_BASE_PATH}/negative_keyword/${input.negativeKeywordId}`;
+        return requestGetEffect(client, path);
+    },
+    /**
+     * Update negative keyword through the eBay Marketing API.
+     *
+     * @param input - Path, query, header, and request body values for updateNegativeKeyword.
+     * @returns An Effect that succeeds with eBay's generated updateNegativeKeyword response DTO.
+     *
+     * @example
+     * ```ts
+     * const response = await Effect.runPromise(marketingApi.updateNegativeKeyword({ negativeKeywordId: 'negativeKeyword-1', request: { ... } }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/marketing/resources/negative_keyword/methods/updateNegativeKeyword
+     */
+    updateNegativeKeyword: (input) => {
+        const path = `${MARKETING_BASE_PATH}/negative_keyword/${input.negativeKeywordId}`;
+        return requestPutEffect(client, path, input.request);
+    },
+});