ebay-mcp 1.17.0 → 1.18.2

package/build/api/listing-metadata/metadataShipping.js

@@ -0,0 +1,117 @@
+import { decodeEndpointInputEffect, requestGetEffect, } from '../../api/shared/request.js';
+import { shippingMetadataInputSchema } from '../../schemas/metadata/shipping.js';
+import { Effect } from 'effect';
+const SHIPPING_MARKETPLACE_PATH = '/sell/metadata/v1/shipping/marketplace';
+/**
+ * Creates the Metadata API `shipping:marketplace` endpoint methods composed into MetadataApi.
+ *
+ * @param client - Shared authenticated eBay REST client.
+ * @returns Endpoint Effects keyed by their eBay operationId.
+ *
+ * @example
+ * ```ts
+ * const shipping = createMetadataShippingMethods(client);
+ * const carriers = await Effect.runPromise(
+ *   shipping.getShippingCarriers({ marketplaceId: MarketplaceId.EBAY_US }),
+ * );
+ * ```
+ */
+export const createMetadataShippingMethods = (client) => {
+    const getShippingResource = (input, resource) => Effect.gen(function* () {
+        const { marketplaceId, acceptLanguage } = yield* decodeEndpointInputEffect(shippingMetadataInputSchema, input);
+        const path = `${SHIPPING_MARKETPLACE_PATH}/${encodeURIComponent(marketplaceId)}/${resource}`;
+        const config = acceptLanguage === undefined
+            ? undefined
+            : { headers: { 'Accept-Language': acceptLanguage } };
+        return yield* requestGetEffect(client, path, undefined, config);
+    });
+    /**
+     * Retrieves the locations a seller can exclude from shipping on a marketplace.
+     *
+     * @param input - Marketplace ID and optional Accept-Language (fr-CA, fr-BE, nl-BE).
+     * @returns An Effect that succeeds with eBay's ShippingExcludeLocationResponse.
+     *
+     * @example
+     * ```ts
+     * const excluded = await Effect.runPromise(
+     *   metadataApi.getExcludeShippingLocations({ marketplaceId: MarketplaceId.EBAY_US }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/metadata/resources/shipping:marketplace/methods/getExcludeShippingLocations
+     */
+    const getExcludeShippingLocations = (input) => getShippingResource(input, 'get_exclude_shipping_locations');
+    /**
+     * Retrieves the handling times a marketplace allows for shipping after cleared payment.
+     *
+     * @param input - Marketplace ID and optional Accept-Language (fr-CA, fr-BE, nl-BE).
+     * @returns An Effect that succeeds with eBay's ShippingHandlingTimeResponse.
+     *
+     * @example
+     * ```ts
+     * const times = await Effect.runPromise(
+     *   metadataApi.getHandlingTimes({ marketplaceId: MarketplaceId.EBAY_GB }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/metadata/resources/shipping:marketplace/methods/getHandlingTimes
+     */
+    const getHandlingTimes = (input) => getShippingResource(input, 'get_handling_times');
+    /**
+     * Retrieves the shipping carriers supported on a marketplace, including the carrier enum
+     * values required when supplying shipment tracking.
+     *
+     * @param input - Marketplace ID and optional Accept-Language (fr-CA, fr-BE, nl-BE).
+     * @returns An Effect that succeeds with eBay's ShippingCarrierResponse.
+     *
+     * @example
+     * ```ts
+     * const carriers = await Effect.runPromise(
+     *   metadataApi.getShippingCarriers({ marketplaceId: MarketplaceId.EBAY_US }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/metadata/resources/shipping:marketplace/methods/getShippingCarriers
+     */
+    const getShippingCarriers = (input) => getShippingResource(input, 'get_shipping_carriers');
+    /**
+     * Retrieves the regions, countries, and special locations a seller can ship to.
+     *
+     * @param input - Marketplace ID and optional Accept-Language (fr-CA, fr-BE, nl-BE).
+     * @returns An Effect that succeeds with eBay's ShippingLocationResponse.
+     *
+     * @example
+     * ```ts
+     * const locations = await Effect.runPromise(
+     *   metadataApi.getShippingLocations({ marketplaceId: MarketplaceId.EBAY_DE }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/metadata/resources/shipping:marketplace/methods/getShippingLocations
+     */
+    const getShippingLocations = (input) => getShippingResource(input, 'get_shipping_locations');
+    /**
+     * Retrieves the shipping services available on a marketplace, with shipping times and
+     * package limits.
+     *
+     * @param input - Marketplace ID and optional Accept-Language (fr-CA, fr-BE, nl-BE).
+     * @returns An Effect that succeeds with eBay's ShippingServiceResponse.
+     *
+     * @example
+     * ```ts
+     * const services = await Effect.runPromise(
+     *   metadataApi.getShippingServices({ marketplaceId: MarketplaceId.EBAY_CA, acceptLanguage: 'fr-CA' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/metadata/resources/shipping:marketplace/methods/getShippingServices
+     */
+    const getShippingServices = (input) => getShippingResource(input, 'get_shipping_services');
+    return {
+        getExcludeShippingLocations,
+        getHandlingTimes,
+        getShippingCarriers,
+        getShippingLocations,
+        getShippingServices,
+    };
+};

package/build/api/listing-metadata/taxonomy.js

@@ -1,6 +1,16 @@
-import { buildEndpointParams, requestGetEffect, requireObjectEffect, requireStringEffect, } from '../../api/shared/request.js';
+import { requestDownloadEffect, } from '../../api/shared/download.js';
+import { buildEndpointParams, decodeEndpointInputEffect, requestGetEffect, requireObjectEffect, requireStringEffect, } from '../../api/shared/request.js';
+import { categoryTreeIdInputSchema } from '../../schemas/taxonomy/categoryTree.js';
 import { Effect } from 'effect';
-/** Taxonomy API - category trees, category suggestions, and compatibility metadata. */
+/**
+ * fetchItemAspects streams a whole marketplace's aspect file before the inline-size check,
+ * so it gets more than the client's 30 s default; larger trees still end in a bounded failure.
+ */
+const ITEM_ASPECTS_DOWNLOAD = { timeoutMs: 120_000 };
+/**
+ * Taxonomy API - category trees, category suggestions, item aspects, expired-category
+ * mappings, and compatibility metadata.
+ */
 export class TaxonomyApi {
     client;
     basePath = '/commerce/taxonomy/v1';
@@ -11,7 +21,7 @@ export class TaxonomyApi {
      * Retrieves the default category tree ID for a marketplace.
      *
      * @param input - Marketplace identifier used to select the default tree.
-     * @returns An Effect that succeeds with eBay's getDefaultCategoryTreeId response.
+     * @returns An Effect that succeeds with eBay's getDefaultCategoryTreeId response, or undefined on HTTP 204.
      *
      * @example
      * ```ts
@@ -88,7 +98,7 @@ export class TaxonomyApi {
      * Retrieves category suggestions for listing search text.
      *
      * @param input - Category tree identifier and query text.
-     * @returns An Effect that succeeds with eBay's getCategorySuggestions response.
+     * @returns An Effect that succeeds with eBay's getCategorySuggestions response, or undefined on HTTP 204.
      *
      * @example
      * ```ts
@@ -116,7 +126,7 @@ export class TaxonomyApi {
      * Retrieves item aspects for a category.
      *
      * @param input - Category tree and category identifiers.
-     * @returns An Effect that succeeds with eBay's getItemAspectsForCategory response.
+     * @returns An Effect that succeeds with eBay's getItemAspectsForCategory response, or undefined on HTTP 204.
      *
      * @example
      * ```ts
@@ -144,7 +154,7 @@ export class TaxonomyApi {
      * Retrieves compatibility property names for a category.
      *
      * @param input - Category tree and compatibility-enabled category identifiers.
-     * @returns An Effect that succeeds with eBay's getCompatibilityProperties response.
+     * @returns An Effect that succeeds with eBay's getCompatibilityProperties response, or undefined on HTTP 204.
      *
      * @example
      * ```ts
@@ -172,7 +182,7 @@ export class TaxonomyApi {
      * Retrieves compatibility values for one property within a category.
      *
      * @param input - Category tree, category, and compatibility property identifiers.
-     * @returns An Effect that succeeds with eBay's getCompatibilityPropertyValues response.
+     * @returns An Effect that succeeds with eBay's getCompatibilityPropertyValues response, or undefined on HTTP 204.
      *
      * @example
      * ```ts
@@ -205,4 +215,39 @@ export class TaxonomyApi {
             return yield* requestGetEffect(client, `${basePath}/category_tree/${categoryTreeId}/get_compatibility_property_values`, params);
         });
     };
+    /**
+     * Downloads the aspects of every leaf category in a category tree as eBay's gzipped JSON file.
+     *
+     * eBay documents the file as possibly over 100 MB compressed; files above
+     * MAX_INLINE_DOWNLOAD_BYTES (25 MiB) fail with DownloadTooLargeError, so use
+     * getItemAspectsForCategory for per-category lookups.
+     *
+     * @param input - Category tree identifier.
+     * @returns An Effect with the gzipped bytes, eBay's content type, and its file name.
+     *
+     * @example
+     * ```ts
+     * const file = await Effect.runPromise(taxonomyApi.fetchItemAspects({ categoryTreeId: '3' }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/commerce/taxonomy/resources/category_tree/methods/fetchItemAspects
+     */
+    fetchItemAspects = (input) => this.categoryTreeResourcePath(input, 'fetch_item_aspects').pipe(Effect.flatMap((path) => requestDownloadEffect(this.client, path, ITEM_ASPECTS_DOWNLOAD)));
+    /**
+     * Retrieves the mappings of expired leaf categories to the active categories replacing them.
+     *
+     * @param input - Category tree identifier.
+     * @returns An Effect that succeeds with eBay's ExpiredCategories, or undefined on HTTP 204.
+     *
+     * @example
+     * ```ts
+     * const expired = await Effect.runPromise(
+     *   taxonomyApi.getExpiredCategories({ categoryTreeId: '0' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/commerce/taxonomy/resources/category_tree/methods/getExpiredCategories
+     */
+    getExpiredCategories = (input) => this.categoryTreeResourcePath(input, 'get_expired_categories').pipe(Effect.flatMap((path) => requestGetEffect(this.client, path)));
+    categoryTreeResourcePath = (input, resource) => decodeEndpointInputEffect(categoryTreeIdInputSchema, input, 'categoryTreeId').pipe(Effect.map(({ categoryTreeId }) => `${this.basePath}/category_tree/${encodeURIComponent(categoryTreeId)}/${resource}`));
 }

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

@@ -10,7 +10,7 @@ export const createMarketingAdsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const response = await Effect.runPromise(marketingApi.bulkCreateAdsByInventoryReference({ campaignId: 'campaign-1', request: { ... } }));
+     * const createdAds = await Effect.runPromise(marketingApi.bulkCreateAdsByInventoryReference({ campaignId: 'campaign-1', request: { ... } }));
      * ```
      *
      * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad/methods/bulkCreateAdsByInventoryReference
@@ -27,7 +27,7 @@ export const createMarketingAdsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const response = await Effect.runPromise(marketingApi.bulkCreateAdsByListingId({ campaignId: 'campaign-1', request: { ... } }));
+     * const createdAds = await Effect.runPromise(marketingApi.bulkCreateAdsByListingId({ campaignId: 'campaign-1', request: { ... } }));
      * ```
      *
      * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad/methods/bulkCreateAdsByListingId
@@ -44,7 +44,7 @@ export const createMarketingAdsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const response = await Effect.runPromise(marketingApi.bulkDeleteAdsByInventoryReference({ campaignId: 'campaign-1', request: { ... } }));
+     * const deletedAds = await Effect.runPromise(marketingApi.bulkDeleteAdsByInventoryReference({ campaignId: 'campaign-1', request: { ... } }));
      * ```
      *
      * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad/methods/bulkDeleteAdsByInventoryReference
@@ -61,7 +61,7 @@ export const createMarketingAdsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const response = await Effect.runPromise(marketingApi.bulkDeleteAdsByListingId({ campaignId: 'campaign-1', request: { ... } }));
+     * const deletedAds = await Effect.runPromise(marketingApi.bulkDeleteAdsByListingId({ campaignId: 'campaign-1', request: { ... } }));
      * ```
      *
      * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad/methods/bulkDeleteAdsByListingId
@@ -78,7 +78,7 @@ export const createMarketingAdsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const response = await Effect.runPromise(marketingApi.bulkUpdateAdsBidByInventoryReference({ campaignId: 'campaign-1', request: { ... } }));
+     * const adBidUpdates = await Effect.runPromise(marketingApi.bulkUpdateAdsBidByInventoryReference({ campaignId: 'campaign-1', request: { ... } }));
      * ```
      *
      * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad/methods/bulkUpdateAdsBidByInventoryReference
@@ -95,7 +95,7 @@ export const createMarketingAdsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const response = await Effect.runPromise(marketingApi.bulkUpdateAdsBidByListingId({ campaignId: 'campaign-1', request: { ... } }));
+     * const adBidUpdates = await Effect.runPromise(marketingApi.bulkUpdateAdsBidByListingId({ campaignId: 'campaign-1', request: { ... } }));
      * ```
      *
      * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad/methods/bulkUpdateAdsBidByListingId
@@ -112,7 +112,7 @@ export const createMarketingAdsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const response = await Effect.runPromise(marketingApi.bulkUpdateAdsStatus({ campaignId: 'campaign-1', request: { ... } }));
+     * const adStatusUpdates = await Effect.runPromise(marketingApi.bulkUpdateAdsStatus({ campaignId: 'campaign-1', request: { ... } }));
      * ```
      *
      * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad/methods/bulkUpdateAdsStatus
@@ -129,7 +129,7 @@ export const createMarketingAdsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const response = await Effect.runPromise(marketingApi.bulkUpdateAdsStatusByListingId({ campaignId: 'campaign-1', request: { ... } }));
+     * const adStatusUpdates = await Effect.runPromise(marketingApi.bulkUpdateAdsStatusByListingId({ campaignId: 'campaign-1', request: { ... } }));
      * ```
      *
      * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad/methods/bulkUpdateAdsStatusByListingId
@@ -146,7 +146,7 @@ export const createMarketingAdsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const response = await Effect.runPromise(marketingApi.getAds({ campaignId: 'campaign-1' }));
+     * const ads = await Effect.runPromise(marketingApi.getAds({ campaignId: 'campaign-1' }));
      * ```
      *
      * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad/methods/getAds
@@ -170,7 +170,7 @@ export const createMarketingAdsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const response = await Effect.runPromise(marketingApi.createAdByListingId({ campaignId: 'campaign-1', request: { ... } }));
+     * const createdAd = await Effect.runPromise(marketingApi.createAdByListingId({ campaignId: 'campaign-1', request: { ... } }));
      * ```
      *
      * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad/methods/createAdByListingId
@@ -187,7 +187,7 @@ export const createMarketingAdsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const response = await Effect.runPromise(marketingApi.createAdsByInventoryReference({ campaignId: 'campaign-1', request: { ... } }));
+     * const createdAds = await Effect.runPromise(marketingApi.createAdsByInventoryReference({ campaignId: 'campaign-1', request: { ... } }));
      * ```
      *
      * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad/methods/createAdsByInventoryReference
@@ -204,7 +204,7 @@ export const createMarketingAdsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const response = await Effect.runPromise(marketingApi.getAd({ adId: 'ad-1', campaignId: 'campaign-1' }));
+     * const ad = await Effect.runPromise(marketingApi.getAd({ adId: 'ad-1', campaignId: 'campaign-1' }));
      * ```
      *
      * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad/methods/getAd
@@ -221,7 +221,7 @@ export const createMarketingAdsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const response = await Effect.runPromise(marketingApi.deleteAd({ adId: 'ad-1', campaignId: 'campaign-1' }));
+     * await Effect.runPromise(marketingApi.deleteAd({ adId: 'ad-1', campaignId: 'campaign-1' }));
      * ```
      *
      * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad/methods/deleteAd
@@ -238,7 +238,7 @@ export const createMarketingAdsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const response = await Effect.runPromise(marketingApi.deleteAdsByInventoryReference({ campaignId: 'campaign-1', request: { ... } }));
+     * await Effect.runPromise(marketingApi.deleteAdsByInventoryReference({ campaignId: 'campaign-1', request: { ... } }));
      * ```
      *
      * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad/methods/deleteAdsByInventoryReference
@@ -255,7 +255,7 @@ export const createMarketingAdsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const response = await Effect.runPromise(marketingApi.getAdsByInventoryReference({ campaignId: 'campaign-1', inventoryReferenceId: 'inventoryReference-1', inventoryReferenceType: 'inventoryReferenceType-1' }));
+     * const ads = 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
@@ -282,7 +282,7 @@ export const createMarketingAdsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const response = await Effect.runPromise(marketingApi.updateBid({ adId: 'ad-1', campaignId: 'campaign-1', request: { ... } }));
+     * const updatedBid = 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
@@ -299,7 +299,7 @@ export const createMarketingAdsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const response = await Effect.runPromise(marketingApi.getAdGroups({ campaignId: 'campaign-1' }));
+     * const adGroups = await Effect.runPromise(marketingApi.getAdGroups({ campaignId: 'campaign-1' }));
      * ```
      *
      * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad_group/methods/getAdGroups
@@ -321,7 +321,7 @@ export const createMarketingAdsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const response = await Effect.runPromise(marketingApi.createAdGroup({ campaignId: 'campaign-1', request: { ... } }));
+     * const createdAdGroup = await Effect.runPromise(marketingApi.createAdGroup({ campaignId: 'campaign-1', request: { ... } }));
      * ```
      *
      * @see https://developer.ebay.com/api-docs/sell/marketing/resources/ad_group/methods/createAdGroup
@@ -338,7 +338,7 @@ export const createMarketingAdsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const response = await Effect.runPromise(marketingApi.getAdGroup({ adGroupId: 'adGroup-1', campaignId: 'campaign-1' }));
+     * const adGroup = 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
@@ -355,7 +355,7 @@ export const createMarketingAdsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const response = await Effect.runPromise(marketingApi.updateAdGroup({ adGroupId: 'adGroup-1', campaignId: 'campaign-1', request: { ... } }));
+     * const updatedAdGroup = 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
@@ -372,7 +372,7 @@ export const createMarketingAdsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const response = await Effect.runPromise(marketingApi.suggestBids({ adGroupId: 'adGroup-1', campaignId: 'campaign-1', request: { ... } }));
+     * const suggestedBids = 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
@@ -389,7 +389,7 @@ export const createMarketingAdsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const response = await Effect.runPromise(marketingApi.suggestKeywords({ adGroupId: 'adGroup-1', campaignId: 'campaign-1', request: { ... } }));
+     * const suggestedKeywords = 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
@@ -406,7 +406,7 @@ export const createMarketingAdsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const response = await Effect.runPromise(marketingApi.bulkCreateKeyword({ campaignId: 'campaign-1', request: { ... } }));
+     * const createdKeywords = await Effect.runPromise(marketingApi.bulkCreateKeyword({ campaignId: 'campaign-1', request: { ... } }));
      * ```
      *
      * @see https://developer.ebay.com/api-docs/sell/marketing/resources/keyword/methods/bulkCreateKeyword
@@ -423,7 +423,7 @@ export const createMarketingAdsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const response = await Effect.runPromise(marketingApi.bulkUpdateKeyword({ campaignId: 'campaign-1', request: { ... } }));
+     * const updatedKeywords = await Effect.runPromise(marketingApi.bulkUpdateKeyword({ campaignId: 'campaign-1', request: { ... } }));
      * ```
      *
      * @see https://developer.ebay.com/api-docs/sell/marketing/resources/keyword/methods/bulkUpdateKeyword
@@ -440,7 +440,7 @@ export const createMarketingAdsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const response = await Effect.runPromise(marketingApi.getKeywords({ campaignId: 'campaign-1' }));
+     * const keywords = await Effect.runPromise(marketingApi.getKeywords({ campaignId: 'campaign-1' }));
      * ```
      *
      * @see https://developer.ebay.com/api-docs/sell/marketing/resources/keyword/methods/getKeywords
@@ -463,7 +463,7 @@ export const createMarketingAdsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const response = await Effect.runPromise(marketingApi.createKeyword({ campaignId: 'campaign-1', request: { ... } }));
+     * const createdKeyword = await Effect.runPromise(marketingApi.createKeyword({ campaignId: 'campaign-1', request: { ... } }));
      * ```
      *
      * @see https://developer.ebay.com/api-docs/sell/marketing/resources/keyword/methods/createKeyword
@@ -480,7 +480,7 @@ export const createMarketingAdsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const response = await Effect.runPromise(marketingApi.getKeyword({ campaignId: 'campaign-1', keywordId: 'keyword-1' }));
+     * const keyword = await Effect.runPromise(marketingApi.getKeyword({ campaignId: 'campaign-1', keywordId: 'keyword-1' }));
      * ```
      *
      * @see https://developer.ebay.com/api-docs/sell/marketing/resources/keyword/methods/getKeyword
@@ -497,7 +497,7 @@ export const createMarketingAdsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const response = await Effect.runPromise(marketingApi.updateKeyword({ campaignId: 'campaign-1', keywordId: 'keyword-1', request: { ... } }));
+     * const updatedKeyword = 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
@@ -514,7 +514,7 @@ export const createMarketingAdsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const response = await Effect.runPromise(marketingApi.bulkCreateNegativeKeyword({ request: { ... } }));
+     * const createdNegativeKeywords = await Effect.runPromise(marketingApi.bulkCreateNegativeKeyword({ request: { ... } }));
      * ```
      *
      * @see https://developer.ebay.com/api-docs/sell/marketing/resources/negative_keyword/methods/bulkCreateNegativeKeyword
@@ -531,7 +531,7 @@ export const createMarketingAdsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const response = await Effect.runPromise(marketingApi.bulkUpdateNegativeKeyword({ request: { ... } }));
+     * const updatedNegativeKeywords = await Effect.runPromise(marketingApi.bulkUpdateNegativeKeyword({ request: { ... } }));
      * ```
      *
      * @see https://developer.ebay.com/api-docs/sell/marketing/resources/negative_keyword/methods/bulkUpdateNegativeKeyword
@@ -548,7 +548,7 @@ export const createMarketingAdsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const response = await Effect.runPromise(marketingApi.getNegativeKeywords());
+     * const negativeKeywords = await Effect.runPromise(marketingApi.getNegativeKeywords());
      * ```
      *
      * @see https://developer.ebay.com/api-docs/sell/marketing/resources/negative_keyword/methods/getNegativeKeywords
@@ -575,7 +575,7 @@ export const createMarketingAdsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const response = await Effect.runPromise(marketingApi.createNegativeKeyword({ request: { ... } }));
+     * const createdNegativeKeyword = await Effect.runPromise(marketingApi.createNegativeKeyword({ request: { ... } }));
      * ```
      *
      * @see https://developer.ebay.com/api-docs/sell/marketing/resources/negative_keyword/methods/createNegativeKeyword
@@ -592,7 +592,7 @@ export const createMarketingAdsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const response = await Effect.runPromise(marketingApi.getNegativeKeyword({ negativeKeywordId: 'negativeKeyword-1' }));
+     * const negativeKeyword = await Effect.runPromise(marketingApi.getNegativeKeyword({ negativeKeywordId: 'negativeKeyword-1' }));
      * ```
      *
      * @see https://developer.ebay.com/api-docs/sell/marketing/resources/negative_keyword/methods/getNegativeKeyword
@@ -609,7 +609,7 @@ export const createMarketingAdsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const response = await Effect.runPromise(marketingApi.updateNegativeKeyword({ negativeKeywordId: 'negativeKeyword-1', request: { ... } }));
+     * const updatedNegativeKeyword = await Effect.runPromise(marketingApi.updateNegativeKeyword({ negativeKeywordId: 'negativeKeyword-1', request: { ... } }));
      * ```
      *
      * @see https://developer.ebay.com/api-docs/sell/marketing/resources/negative_keyword/methods/updateNegativeKeyword