openapi: 3.0.0
servers:
  - description: Production
    url: https://api.ebay.com{basePath}
    variables:
      basePath:
        default: /sell/marketing/v1
info:
  contact:
    name: eBay Inc,
    x-twitter: ebay
  description: <p>The <i>Marketing API </i> offers two platforms that sellers can use to promote and advertise their products:</p> <ul><li><b>Promoted Listings</b> is an eBay ad service that lets sellers set up <i>ad campaigns </i> for the products they want to promote. eBay displays the ads in search results and in other marketing modules as <b>SPONSORED</b> listings. If an item in a Promoted Listings campaign sells, the seller is assessed a Promoted Listings fee, which is a seller-specified percentage applied to the sales price. For complete details, refer to the <a href="/api-docs/sell/static/marketing/pl-landing.html">Promoted Listings playbook</a>.</li><li><b>Promotions Manager</b> gives sellers a way to offer discounts on specific items as a way to attract buyers to their inventory. Sellers can set up discounts (such as "20% off" and other types of offers) on specific items or on an entire customer order. To further attract buyers, eBay prominently displays promotion <i>teasers</i> throughout buyer flows. For complete details, see <a href="/api-docs/sell/static/marketing/promotions-manager.html">Promotions Manager</a>.</li></ul>  <p><b>Marketing reports</b>, on both the Promoted Listings and Promotions Manager platforms, give sellers information that shows the effectiveness of their marketing strategies. The data gives sellers the ability to review and fine tune their marketing efforts.</p> <p class="tablenote"><b>Important!</b> Sellers must have an active eBay Store subscription, and they must accept the <b>Terms and Conditions</b> before they can make requests to these APIs in the Production environment. There are also site-specific listings requirements and restrictions associated with these marketing tools, as listed in the "requirements and restrictions" sections for <a href="/api-docs/sell/marketing/static/overview.html#PL-requirements">Promoted Listings</a> and <a href="/api-docs/sell/marketing/static/overview.html#PM-requirements">Promotions Manager</a>.</p> <p>The table below lists all the Marketing API calls grouped by resource.</p>
  license:
    name: eBay API License Agreement
    url: https://go.developer.ebay.com/api-license-agreement
  title: Marketing API
  version: v1.15.0
  x-apisguru-categories:
    - ecommerce
  x-logo:
    backgroundColor: "#FFFFFF"
    url: https://twitter.com/ebay/profile_image?size=original
  x-origin:
    - format: openapi
      url: https://developer.ebay.com/api-docs/master/sell/marketing/openapi/3/sell_marketing_v1_oas3.json
      version: "3.0"
  x-providerName: ebay.com
  x-serviceName: sell-marketing
paths:
  /ad_campaign:
    get:
      description: This method retrieves the details for all of the seller's defined campaigns. Request parameters can be used to retrieve a specific campaign, such as the campaign's name, the start and end date, the status, and the funding model (Cost Per Sale (CPS) or Cost Per Click (CPC). <p>You can filter the result set by a campaign name, end date range, start date range, or campaign status. You can also paginate the records returned from the result set using the <b>limit</b> query parameter, and control which records to return using the  <b>offset</b> parameter.</p>
      operationId: getCampaigns
      parameters:
        - description: "Specifies the campaign name. The results are filtered to include only the campaign by the specified name.<br /><br /><b>Note: </b>The results might be null if other filters exclude the campaign with this name. <br /><br /><b>Maximum: </b> 1 campaign name"
          in: query
          name: campaign_name
          required: false
          schema:
            type: string
        - description: 'Include this filter and input a specific campaign status to retrieve campaigns currently in that state. <br /><br /><b>Note: </b>The results might not include all the campaigns with this status if other filters exclude them. <br /><br /><b>Valid values:</b> See <a href="/api-docs/sell/marketing/types/pls:CampaignStatusEnum">CampaignStatusEnum</a> <br /><br /><b>Maximum: </b> 1 status'
          in: query
          name: campaign_status
          required: false
          schema:
            type: string
        - description: "Specifies the range of a campaign's end date. The results are filtered to include only campaigns with an end date that is within specified range. <br><br><b>Valid format (UTC)</b>: <ul><li><code> yyyy-MM-ddThh:mm:ssZ..yyyy-MM-ddThh:mm:ssZ </code>  (campaign ends within this range)</li><li><code>yyyy-MM-ddThh:mm:ssZ..</code> (campaign ends on or after this date)</li><li><code>..yyyy-MM-ddThh:mm:ssZ </code> (campaign ends on or before this date)</li><li><code>2016-09-08T00:00.00.000Z..2016-09-09T00:00:00Z</code> (campaign ends on September 08, 2016)</li></ul> <br /><br /><b>Note: </b>The results might not include all the campaigns ending on this date if other filters exclude them."
          in: query
          name: end_date_range
          required: false
          schema:
            type: string
        - description: Specifies the funding strategy for the campaign.<br /><br />The results will be filtered to only include campaigns with the specified funding model. If not specified, all campaigns matching the other filter parameters will be returned. The results might not include these campaigns if other search conditions exclude them.<br /><br /><b>Valid Values:</b><ul><li><code>COST_PER_SALE</code></li><li><code>COST_PER_CLICK</code></li></ul>
          in: query
          name: funding_strategy
          required: false
          schema:
            type: string
        - description: "<p>Specifies the maximum number of campaigns to return on a page in the paginated response.</p>  <b>Default: </b>10 <br><b>Maximum: </b> 500"
          in: query
          name: limit
          required: false
          schema:
            type: string
        - description: Specifies the number of campaigns to skip in the result set before returning the first report in the paginated response.  <p>Combine <b>offset</b> with the <b>limit</b> query parameter to control the items returned in the response. For example, if you supply an <b>offset</b> of <code>0</code> and a <b>limit</b> of <code>10</code>, the first page of the response contains the first 10 items from the complete list of items retrieved by the call. If <b>offset</b> is <code>10</code> and <b>limit</b> is <code>20</code>, the first page of the response contains items 11-30 from the complete result set.</p> <p><b>Default:</b> 0</p>
          in: query
          name: offset
          required: false
          schema:
            type: string
        - description: "Specifies the range of a campaign's start date in which to filter the results. The results are filtered to include only campaigns with a start date that is equal to this date or is within specified range.<br><br><b>Valid format (UTC): </b> <ul><li><code>yyyy-MM-ddThh:mm:ssZ..yyyy-MM-ddThh:mm:ssZ</code> (starts within this range)</li><li><code>yyyy-MM-ddThh:mm:ssZ</code> (campaign starts on or after this date)</li><li><code>..yyyy-MM-ddThh:mm:ssZ </code>(campaign starts on or before this date)</li><li><code>2016-09-08T00:00.00.000Z..2016-09-09T00:00:00Z</code> (campaign starts on September 08, 2016)</li></ul><br /><br /><b>Note: </b>The results might not include all the campaigns with this start date if other filters exclude them."
          in: query
          name: start_date_range
          required: false
          schema:
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/CampaignPagedCollectionResponse"
          description: Success
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35020":
                category: REQUEST
                description: The campaign name cannot be more than {maxCampaignNameLength} characters.
                domain: API_MARKETING
              "35023":
                category: REQUEST
                description: The request contains invalid characters. {notAllowedCharacters} are not allowed.
                domain: API_MARKETING
              "35027":
                category: REQUEST
                description: The date range {dateRange} is not valid. Ensure the beginning of the range is before the end of the range.
                domain: API_MARKETING
              "35028":
                category: REQUEST
                description: The format of the date range {dateRange} is invalid. The format for a date range is yyyy-MM-ddThh:mm:ss.sssZ..yyyy-MM-ddThh:mm:ss.sssZ or yyyy-MM-ddThh:mm:ss.sssZ.. or ..yyyy-MM-ddThh:mm:ss.sssZ.
                domain: API_MARKETING
              "35029":
                category: REQUEST
                description: The 'limit' has to be greater than zero and less than {maxLimitValue}.
                domain: API_MARKETING
              "35030":
                category: REQUEST
                description: The 'offset' cannot be less than zero.
                domain: API_MARKETING
              "35043":
                category: REQUEST
                description: The campaign status of {campaignStatus} is either invalid or not supported for this operation.
                domain: API_MARKETING
              "35079":
                category: REQUEST
                description: Funding strategy needs to be one of {fundingStrategy} types.
                domain: API_MARKETING
        "409":
          description: Conflict
          x-response-codes:
            errors:
              "35077":
                category: BUSINESS
                description: To use promoted listings, you need to improve your seller level to Top Rated or Above Standard and have enough recent sales activity.
                domain: API_MARKETING
        "500":
          description: Internal Server error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing.readonly
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - campaign
    post:
      description: 'This method creates a Promoted Listings ad campaign. <p>A Promoted Listings <i>campaign</i> is the structure into which you place the ads or ad group for the listings you want to promote.</p>  <p>Identify the items you want to place into a campaign either by "key" or by "rule" as follows:</p> <ul><li><b>Rules-based campaigns</b> &ndash; A rules-based campaign adds items to the campaign according to the <i>criteria</i> you specify in your call to <b>createCampaign</b>. You can set the <b>autoSelectFutureInventory</b> request field to <code>true</code> so that after your campaign launches, eBay will regularly assess your new, revised, or newly-eligible listings to determine whether any should be added or removed from your campaign according to the rules you set. If there are, eBay will add or remove them automatically on a daily basis.</li> <li><b>Key-based campaigns</b> &ndash; Add items to an existing campaign using either listing ID values or Inventory Reference values: <ul><li>Add <b>listingId</b> values to an existing campaign by calling either <b>createAdByListingID</b> or <b>bulkCreateAdsByListingId</b>.</li>  <li>Add <b>inventoryReference</b> values to an existing campaign by calling either <b>createAdByInventoryReference</b> or <b>bulkCreateAdsByInventoryReference</b>.</li><li>Add an <b>ad group</b> to an existing campaign by calling <b>createAdGroup</b>.</li></ul><p class="tablenote"><b>Note:</b> No matter how you add items to a Promoted Listings campaign, each campaign can contain ads for a maximum of 50,000 items. <br><br>If a rules-based campaign identifies more than 50,000 items, ads are created for only the first 50,000 items identified by the specified criteria, and ads are not created for the remaining items.</p>  <p><b>Creating a campaign</b></p> <p>To create a basic campaign, supply:</p>  <ul><li>The user-defined campaign name</li> <li>The start date (and optionally the end date) of the campaign</li> <li>The eBay marketplace on which the campaign is hosted</li> <li>Details on the campaign funding model</li></ul>  <p>The campaign funding model specifies how the Promoted Listings fee is calculated. Currently, the supported funding models are <code>COST_PER_SALE</code> and <code>COST_PER_CLICK</code>. For complete information on how the fee is calculated and when it applies, see <a href="/api-docs/sell/static/marketing/pl-overview.html#pl-fees">Promoted Listings fees</a>.</p>   <p>If you populate the <b>campaignCriterion</b> object in your <b>createCampaign</b> request, campaign "ads" are created by "rule" for the listings that meet the criteria you specify, and these ads are associated with the newly created campaign.</p>  <p>For details on creating Promoted Listings campaigns and how to select the items to be included in your campaigns, see <a href="/api-docs/sell/static/marketing/pl-create-campaign.html">Promoted Listings campaign creation</a>.</p>  <p>For recommendations on which listings are prime for a Promoted Listings ad campaign and to get guidance on how to set the <b>bidPercentage</b> field, see <a href="/api-docs/sell/static/marketing/pl-reco-api.html">Using the Recommendation API to help configure campaigns</a>.</p>  <p class="tablenote"><b>Tip:</b> See <a href="/api-docs/sell/marketing/static/overview.html#PL-requirements">Promoted Listings requirements and restrictions</a> for the details on the marketplaces that support Promoted Listings via the API. See <a href="/api-docs/sell/static/marketing/pl-restrictions">Promoted Listings restrictions</a> for details about campaign limitations and restrictions.</p>'
      operationId: createCampaign
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/CreateCampaignRequest"
              description: This type defines the fields for the create campaign request.
        description: This type defines the fields for the create campaign request.
        required: true
      responses:
        "201":
          content:
            application/json:
              schema:
                type: object
          description: Created
          headers:
            Location:
              schema:
                description: The <b>location</b> response header contains the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaign">getCampaign</a> URI to the newly created campaign. The URL includes the eBay-assigned <code>campaignId</code>, which you can use to reference the campaign.
                type: string
          x-response-codes:
            errors:
              "35103":
                category: BUSINESS
                description: This campaign has reached maximum capacity of {maxSupportedNumber} listings. To continue promoting listings, create a new campaign.
                domain: API_MARKETING
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35003":
                category: REQUEST
                description: "'campaignCriterion' is required for a criterion based campaign."
                domain: API_MARKETING
              "35004":
                category: REQUEST
                description: "One of the selectionRule containers is empty. You must specify at least one rule in each selectionRule container. Note: 'categoryScope' is not a rule."
                domain: API_MARKETING
              "35005":
                category: REQUEST
                description: "'selectionRules' is required for criterion based campaigns."
                domain: API_MARKETING
              "35006":
                category: REQUEST
                description: "'fundingStrategy' is required for this call."
                domain: API_MARKETING
              "35007":
                category: REQUEST
                description: "The 'bidPercentage' {bidPercentage} is not valid. The bid percentage should be a single precision value. Minimum value: {minBidPercent} , Maximum value:{maxBidPercent}."
                domain: API_MARKETING
              "35008":
                category: REQUEST
                description: The category ID {categoryId} is not valid.
                domain: API_MARKETING
              "35009":
                category: REQUEST
                description: The listing Condition ID {listingConditionId} is not valid. Refer to the API call documentation for a list of valid values.
                domain: API_MARKETING
              "35015":
                category: REQUEST
                description: The 'maxPrice' or 'minPrice' value is missing or invalid. The value cannot be less than or equal to zero.
                domain: API_MARKETING
              "35016":
                category: REQUEST
                description: The 'minPrice' {minPrice} cannot be greater than the 'maxPrice' {maxPrice}.
                domain: API_MARKETING
              "35017":
                category: REQUEST
                description: "'currency' is not valid or missing."
                domain: API_MARKETING
              "35019":
                category: REQUEST
                description: Campaign name is required for this call.
                domain: API_MARKETING
              "35020":
                category: REQUEST
                description: The campaign name cannot be more than {maxCampaignNameLength} characters.
                domain: API_MARKETING
              "35021":
                category: REQUEST
                description: A campaign with the name of {campaignName} already exists. Please provide a different name.
                domain: API_MARKETING
              "35022":
                category: REQUEST
                description: The brand name {brandName} is not valid.
                domain: API_MARKETING
              "35023":
                category: REQUEST
                description: The request contains invalid characters. {notAllowedCharacters} are not allowed.
                domain: API_MARKETING
              "35024":
                category: REQUEST
                description: The campaign start date {startDate} cannot be after the end date {endDate}.
                domain: API_MARKETING
              "35025":
                category: REQUEST
                description: A campaign start date is required.
                domain: API_MARKETING
              "35026":
                category: REQUEST
                description: A campaign start or end date {date} cannot be in the past.
                domain: API_MARKETING
              "35038":
                category: REQUEST
                description: "The funding model is required. Valid values for 'fundingModel' are: {fundingModelValues}."
                domain: API_MARKETING
              "35039":
                category: REQUEST
                description: "The 'categoryScope' is required for criterion based campaigns using category based listing selection rules. Valid values are: {categoryScopeValues}"
                domain: API_MARKETING
              "35041":
                category: REQUEST
                description: The 'marketplaceId' is required.
                domain: API_MARKETING
              "35042":
                category: REQUEST
                description: "The criterion type is required for criterion based campaigns. Valid values are: {criterionTypeValues}."
                domain: API_MARKETING
              "36101":
                category: REQUEST
                description: The daily budget value format is a maximum of two decimal points.
                domain: API_MARKETING
        "409":
          description: Conflict
          x-response-codes:
            errors:
              "35051":
                category: BUSINESS
                description: "'marketplaceId' {marketplaceId} is not supported. Promoted Listings is supported only on these marketplaces: {supportedMarketplaces}."
                domain: API_MARKETING
              "35052":
                category: BUSINESS
                description: The category {categoryId} is not supported by the Promoted Listing service for multi-quantity listings.
                domain: API_MARKETING
              "35053":
                category: BUSINESS
                description: "MarketplaceId: {marketplaceId} and Currency: {currency} for the listing selection rule do not match."
                domain: API_MARKETING
              "35067":
                category: BUSINESS
                description: The seller must accept the Promoted Listing terms and conditions. For the requirements to use the Promoted Listing API, refer to the documentation.
                domain: API_MARKETING
              "35069":
                category: BUSINESS
                description: No more than {maxNumberOfSelectionRules} listing selection rules are allowed in a campaign.
                domain: API_MARKETING
              "35072":
                category: BUSINESS
                description: The number of listings that result from the rules exceeds the maximum number of listings allowed in a campaign, which is {maxSupportedNumber}. Refine the rules and submit the call again.
                domain: API_MARKETING
              "35074":
                category: BUSINESS
                description: There were no eligible listings found for the selection rules provided. Please check the rules and submit the call again.
                domain: API_MARKETING
              "35075":
                category: BUSINESS
                description: The category {categoryId} is not supported by the Promoted Listing service for single-quantity listings.
                domain: API_MARKETING
              "35077":
                category: BUSINESS
                description: To use promoted listings, you need to improve your seller level to Top Rated or Above Standard and have enough recent sales activity.
                domain: API_MARKETING
              "35078":
                category: BUSINESS
                description: To gain access to Promoted Listings, you must be in good standing with recent sales activity.
                domain: API_MARKETING
              "35089":
                category: BUSINESS
                description: We are currently testing a premium ads product with a small invite-only group. We will share more information when we are ready to expand.
                domain: API_MARKETING
              "35104":
                category: BUSINESS
                description: "'categoryScope' STORE can not be found. Please define the store categories first or use 'categoryScope' MARKETPLACE to select categories."
                domain: API_MARKETING
              "35106":
                category: BUSINESS
                description: "'BidPercentage' should be provided when selected 'adRateStrategy' is 'FIXED'."
                domain: API_MARKETING
              "35107":
                category: BUSINESS
                description: "'dynamicAdRatePreferences' can be provided only when selected 'adRateStrategy' is 'DYNAMIC'."
                domain: API_MARKETING
              "35108":
                category: BUSINESS
                description: The 'adRateAdjustmentPercent' {adRateAdjustmentPercent} is not valid. Please set 'adRateAdjustmentPercent' {adRateAdjustmentPercent} between {minAllowedAdRateAdjustmentPercent}% - {maxAllowedAdRateAdjustmentPercent}%.
                domain: API_MARKETING
              "35109":
                category: BUSINESS
                description: The 'adRateCapPercent' {adRateCapPercent} is not valid. Please set 'adRateCapPercent' between {minAllowedAdRateCapPercent}% - {maxAllowedAdRateCapPercent}%.
                domain: API_MARKETING
              "35110":
                category: BUSINESS
                description: The 'adRateStrategy' is not supported for CPC funding model.
                domain: API_MARKETING
              "35111":
                category: BUSINESS
                description: The 'dynamicAdRatePreferences' is not supported for CPC funding model.
                domain: API_MARKETING
              "35112":
                category: BUSINESS
                description: The 'adRateStrategy' is currently only supported for criterion based campaign with 'autoselectFutureInventory' as True.
                domain: API_MARKETING
              "35114":
                category: BUSINESS
                description: The 'dynamicAdRatePreferences' list currently can only support one element containing dynamicAdRatePreference. Please remove additional elements and try again.
                domain: API_MARKETING
              "36151":
                category: BUSINESS
                description: "'campaignCriterion' {campaignCriterion} is not supported for CPC funding model."
                domain: API_MARKETING
              "36152":
                category: BUSINESS
                description: The 'bidPercentage' is not supported for CPC funding model.
                domain: API_MARKETING
              "36153":
                category: BUSINESS
                description: The daily budget currency {currency} is not supported for {fieldName}. The supported currency for the {marketplaceId} marketplace is {supportedCurrencyCode}.
                domain: API_MARKETING
              "36154":
                category: BUSINESS
                description: The daily budget below minimum allowed {minAllowed}.
                domain: API_MARKETING
              "36155":
                category: BUSINESS
                description: The daily budget above maximum allowed {maxAllowed}.
                domain: API_MARKETING
              "36156":
                category: BUSINESS
                description: campaignBudget is not supported for CPS funding model.
                domain: API_MARKETING
              "36157":
                category: BUSINESS
                description: The daily budget is required for campaigns with CPC funding model.
                domain: API_MARKETING
              "36158":
                category: BUSINESS
                description: The daily budget value format {dailyBudgetValue} cannot have more than 2 decimal places.
                domain: API_MARKETING
              "36159":
                category: BUSINESS
                description: "'marketplaceId' {marketPlaceId} is not supported. Promoted Listings with CPC funding model is supported only on these marketplaces: {supportedMarketplaces}."
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - campaign
  /ad_campaign/find_campaign_by_ad_reference:
    get:
      description: This method retrieves the campaigns containing the listing that is specified using either a listing ID, or an inventory reference ID and inventory reference type pair. The request accepts either a <b>listing_id</b>, <i>or</i> an <b>inventory_reference_id</b> and <b>inventory_reference_type</b> pair, as used in the Inventory API.<br /><br />eBay <i>listing IDs</i> are generated by either the <a href="/Devzone/XML/docs/Reference/eBay/index.html" title="Trading API Reference">Trading API</a> or the <a href="/api-docs/sell/inventory/resources/methods">Inventory API</a> when you create a listing.<br /><br />An <i>inventory reference ID</i> can be either a seller-defined <b>SKU</b> or <b>inventoryItemGroupKey</b>, as specified in the Inventory API.<br /><br /><span class="tablenote"><b>Note:</b> This method only applies to the Cost Per Sale (CPS) funding model; it does not apply to the Cost Per Click (CPC) funding model. See <a href="/api-docs/sell/static/marketing/pl-overview.html#funding-model">Funding Models</a> in the <i>Promoted Listings Playbook</i> for more information.</span>
      operationId: findCampaignByAdReference
      parameters:
        - description: The seller's inventory reference ID of the listing to be used to find the campaign in which it is associated.  This will either be a seller-defined <b>SKU</b> value or inventory item group ID, depending on the reference type specified. You must always pass in both  <b>inventory_reference_id</b> and <b>inventory_reference_type</b>.
          in: query
          name: inventory_reference_id
          required: false
          schema:
            type: string
        - description: The type of the seller's inventory reference ID, which is a listing or group of items. You must always pass in both <b>inventory_reference_id</b> and <b>inventory_reference_type</b>.
          in: query
          name: inventory_reference_type
          required: false
          schema:
            type: string
        - description: Identifier of the eBay listing associated with the ad.
          in: query
          name: listing_id
          required: false
          schema:
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Campaigns"
          description: Success
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35013":
                category: REQUEST
                description: The listing ID {listingId} is not valid.
                domain: API_MARKETING
              "35014":
                category: REQUEST
                description: The listing ID is required for this call.
                domain: API_MARKETING
              "35031":
                category: REQUEST
                description: A 'listing_id' or an 'inventory_reference_id' and 'inventory_reference_type' is required for this call.
                domain: API_MARKETING
              "35032":
                category: REQUEST
                description: A 'listing_id' and an 'inventory_reference_id' cannot be used together in the same call. To use both in a campaign, you must submit two calls.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Business error
        "500":
          description: Internal Server error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing.readonly
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - campaign
  /ad_campaign/get_campaign_by_name:
    get:
      description: This method retrieves the details of a single campaign, as specified with the <b>campaign_name</b> query parameter. Note that the campaign name you specify must be an exact, case-sensitive match of the name of the campaign you want to retrieve.</p><p>Call <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> to retrieve a list of the seller's campaign names.</p>
      operationId: getCampaignByName
      parameters:
        - description: The name of the campaign.
          in: query
          name: campaign_name
          required: true
          schema:
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Campaign"
          description: Success
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35019":
                category: REQUEST
                description: Campaign name is required for this call.
                domain: API_MARKETING
              "35020":
                category: REQUEST
                description: The campaign name cannot be more than {maxCampaignNameLength} characters.
                domain: API_MARKETING
              "35023":
                category: REQUEST
                description: The request contains invalid characters. {notAllowedCharacters} are not allowed.
                domain: API_MARKETING
              "35046":
                category: REQUEST
                description: No campaign found with the name {campaign_name}.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Business error
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing.readonly
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - campaign
  "/ad_campaign/{campaign_id}":
    delete:
      description: "This method deletes the campaign specified by the <code>campaign_id</code> query parameter.<br /><br /><span class=\"tablenote\"><b>Note: </b> You can only delete campaigns that have ended.</span><br /><br />Call <a href=\"/api-docs/sell/marketing/resources/campaign/methods/getCampaigns\">getCampaigns</a> to retrieve the <b>campaign_id</b> and the campaign status (<code>RUNNING</code>, <code>PAUSED</code>, <code>ENDED</code>, and so on) for all the seller's campaigns."
      operationId: deleteCampaign
      parameters:
        - description: A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.<br /><br /><span class="tablenote"><b>Note:</b> You can retrieve the campaign IDs for a specified seller using the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method.</span>
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
      responses:
        "204":
          description: No Content
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Conflict
          x-response-codes:
            errors:
              "35056":
                category: BUSINESS
                description: The state of the campaign cannot be changed as requested.
                domain: API_MARKETING
              "35077":
                category: BUSINESS
                description: To use Promoted Listings, you need to improve your seller level to Top Rated or Above Standard and have enough recent sales activity.
                domain: API_MARKETING
              "35078":
                category: BUSINESS
                description: To gain access to Promoted Listings, you must be in good standing with recent sales activity.
                domain: API_MARKETING
              "35089":
                category: BUSINESS
                description: We are currently testing a premium ads product with a small invite-only group. We will share more information when we are ready to expand.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - campaign
    get:
      description: This method retrieves the details of a single campaign, as specified with the <b>campaign_id</b> query parameter.  <p>This method returns all the details of a campaign (including the campaign's the selection rules), except the for the listing IDs or inventory reference IDs included in the campaign. These IDs are returned by <a href="/api-docs/sell/marketing/resources/ad/methods/getAds">getAds</a>.</p>  <p>Call <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> to retrieve a list of the seller's campaign IDs.</p>
      operationId: getCampaign
      parameters:
        - description: A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.<br /><br /><span class="tablenote"><b>Note:</b> You can retrieve the campaign IDs for a specified seller using the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method.</span>
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Campaign"
          description: Success
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Business error
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developers support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing.readonly
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - campaign
  "/ad_campaign/{campaign_id}/ad":
    get:
      description: This method retrieves Promoted Listings ads that are associated with listings created with either the <a href="/Devzone/XML/docs/Reference/eBay/index.html" title="Trading API Reference">Trading API</a> or the <a href="/api-docs/sell/inventory/resources/methods" title="Inventory API Reference">Inventory API</a>. <p>The method retrieves ads related to the specified campaign. Specify the Promoted Listings campaign to target with the <b>campaign_id</b> path parameter.</p>  <p>Because of the large number of possible results, you can use query parameters to paginate the result set by specifying a <b>limit</b>, which dictates how many ads to return on each page of the response. You can also specify how many ads to skip in the result set before returning the first result using the <b>offset</b> path parameter.</p>  <p>Call <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> to retrieve the current campaign IDs for the seller.</p>
      operationId: getAds
      parameters:
        - description: A comma-separated list of ad group IDs. The results will be filtered to only include active ads for these ad groups. Call <a href="/api-docs/sell/marketing/resources/adgroup/methods/getAdGroups">getAdGroups</a> to retrieve the ad group ID for the ad group.<br /><br /><span class="tablenote"><b>Note:</b> This field only applies to the Cost Per Click (CPC) funding model; it does not apply to the Cost Per Sale (CPS) funding model.</span>
          in: query
          name: ad_group_ids
          required: false
          schema:
            type: string
        - description: A comma-separated list of ad statuses. The results will be filtered to only include the given statuses of the ad. If none are provided, all ads are returned.
          in: query
          name: ad_status
          required: false
          schema:
            type: string
        - description: A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.<br /><br /><span class="tablenote"><b>Note:</b> You can retrieve the campaign IDs for a specified seller using the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method.</span>
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
        - description: "Specifies the maximum number of ads to return on a page in the paginated response. <p><b>Default: </b>10 <br><b>Maximum:</b> 500</p>"
          in: query
          name: limit
          required: false
          schema:
            type: string
        - description: A comma-separated list of listing IDs. The response includes only active ads (ads associated with a RUNNING campaign). The results do not include listing IDs that are excluded by other conditions.
          in: query
          name: listing_ids
          required: false
          schema:
            type: string
        - description: Specifies the number of ads to skip in the result set before returning the first ad in the paginated response.  <p>Combine <b>offset</b> with the <b>limit</b> query parameter to control the items returned in the response. For example, if you supply an <b>offset</b> of <code>0</code> and a <b>limit</b> of <code>10</code>, the first page of the response contains the first 10 items from the complete list of items retrieved by the call. If <b>offset</b> is <code>10</code> and <b>limit</b> is <code>20</code>, the first page of the response contains items 11-30 from the complete result set.</p> <p><b>Default:</b> 0</p>
          in: query
          name: offset
          required: false
          schema:
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AdPagedCollectionResponse"
          description: Success
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35013":
                category: REQUEST
                description: The listing ID {listingId} is not valid.
                domain: API_MARKETING
              "35029":
                category: REQUEST
                description: The 'limit' has to be greater than zero and less than {maxLimitValue}.
                domain: API_MARKETING
              "35030":
                category: REQUEST
                description: The 'offset' cannot be less than zero.
                domain: API_MARKETING
              "35035":
                category: REQUEST
                description: The campaign with campaign id {campaign_id} has ended.
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
              "35083":
                category: REQUEST
                description: The requested 'adStatus' is not valid.
                domain: API_MARKETING
              "36106":
                category: REQUEST
                description: The 'ad_group_ids' is not supported for CPS funding model.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Conflict
          x-response-codes:
            errors:
              "35068":
                category: BUSINESS
                description: You have exceeded the maximum number of listing IDs. Only {maxSupportedNumber} listings are supported per call.
                domain: API_MARKETING
              "35077":
                category: BUSINESS
                description: To use promoted listings, you need to improve your seller level to Top Rated or Above Standard and have enough recent sales activity.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing.readonly
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - ad
    post:
      description: This method adds a listing to an existing Promoted Listings campaign using a <b>listingId</b> value generated by the <a href="/Devzone/XML/docs/Reference/eBay/index.html" title="Trading API Reference">Trading API</a> or <a href="/api-docs/sell/inventory/resources/methods" title="Inventory API Reference">Inventory API</a>, or using a value generated by an ad group ID. <p>For Promoted Listings Standard (PLS) campaigns using the Cost Per Sale (CPS) funding model, an ad may be directly created for the listing.</p><p>For the listing ID specified in the request, this method:</p>  <ul><li>Creates an ad for the listing.</li> <li>Sets the bid percentage (also known as the <i>ad rate</i>) for the ad.</li> <li>Associates the ad with the specified campaign.</li></ul>  <p>To create an ad for a listing, specify its <b>listingId</b>, plus the <b>bidPercentage</b> for the ad in the payload of the request. Specify the campaign to associate the ad with using the <b>campaign_id</b> path parameter. Listing IDs are generated by eBay when a seller creates listings with the Trading API.</p><p>For Promoted Listings Advanced (PLA) campaigns using the Cost Per Click (CPC) funding model, an ad group must be created first. If no ad group has been created for the campaign, an ad cannot be created.</p><p>For the ad group specified in the request, this method associates the ad with the specified ad group.</p><p>To create an ad for an ad group, specify the name of the ad group in the payload of the request. Specify the campaign to associate the ads with using the <b>campaign_id</b> path parameter. Ad groups are generated using the <a href="/api-docs/sell/marketing/resources/adgroup/methods/createAdGroup">createAdGroup</a> method.</p> <p>You can specify one or more ad groups per campaign.</p><p>Use <a href="/api-docs/sell/marketing/resources/campaign/methods/createCampaign">createCampaign</a> to create a new campaign and use <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> to get a list of existing campaigns.</p><p>This call has no response payload. If the ad is successfully created, a <code>201 Created</code> HTTP status code and the <a href="/api-docs/sell/marketing/resources/ad/methods/getAd">getAd</a> URI of the ad are returned in the location header.</p>
      operationId: createAdByListingId
      parameters:
        - description: A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.<br /><br /><span class="tablenote"><b>Note:</b> You can retrieve the campaign IDs for a specified seller using the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method.</span>
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/CreateAdRequest"
              description: This request object defines the fields used in the <b>createAdByListingId</b> request.
        description: This request object defines the fields used in the <b>createAdByListingId</b> request.
        required: true
      responses:
        "201":
          content:
            application/json:
              schema:
                type: object
          description: Created
          headers:
            Location:
              schema:
                description: The <b>location</b> response header contains the getAd URI of the newly created ad. The URI includes the newly created <code>adID</code>, which you can use to reference the ad.
                type: string
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35007":
                category: REQUEST
                description: "The 'bidPercentage' {bidPercentage} is not valid. The bid percentage should be a single precision value. Minimum value: {minBidPercent} , Maximum value:{maxBidPercent}."
                domain: API_MARKETING
              "35010":
                category: REQUEST
                description: The bidPercentage should not be provided when selected adRateStrategy is DYNAMIC for the campaign.
                domain: API_MARKETING
              "35013":
                category: REQUEST
                description: The listing ID {listingId} is not valid.
                domain: API_MARKETING
              "35014":
                category: REQUEST
                description: The listing ID is required for this call.
                domain: API_MARKETING
              "35035":
                category: REQUEST
                description: The campaign with campaign id {campaign_id} has ended.
                domain: API_MARKETING
              "35036":
                category: REQUEST
                description: An ad for listing ID {listingId} already exists.
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
              "35048":
                category: REQUEST
                description: The listing ID {listingId} is invalid or has ended.
                domain: API_MARKETING
              "35080":
                category: REQUEST
                description: The 'bidPercentage' is not supported for CPC funding model.
                domain: API_MARKETING
              "36106":
                category: REQUEST
                description: The 'adGroupId' {adGroupId} is not supported for CPS funding model.
                domain: API_MARKETING
              "36210":
                category: REQUEST
                description: No adgroup found for adgroup id {ad_group_id}.
                domain: API_MARKETING
              "36219":
                category: REQUEST
                description: The ad group with ad_group id {ad_group_id} has been archived.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Business error
          x-response-codes:
            errors:
              "35052":
                category: BUSINESS
                description: The category {categoryId} is not supported by the Promoted Listing service for multi-quantity listings.
                domain: API_MARKETING
              "35054":
                category: BUSINESS
                description: The listing ID {listingId} was created on a different marketplace than the campaign. The listing and campaign must reside on the same marketplace.
                domain: API_MARKETING
              "35057":
                category: BUSINESS
                description: The listing ID {listingId} does not belong to the seller making this call.
                domain: API_MARKETING
              "35058":
                category: BUSINESS
                description: The listing ID {listingId} is not a fixed price item. This is a requirement for a promoted listing.
                domain: API_MARKETING
              "35059":
                category: BUSINESS
                description: The listing ID {listingId} is not a multi-quantity item. This is a requirement for a promoted listing.
                domain: API_MARKETING
              "35061":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is being synced to match the specifications of the campaign. Please wait a few minutes and try the call again.
                domain: API_MARKETING
              "35063":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is ending soon. No update operations are allowed on this campaign until it ends.
                domain: API_MARKETING
              "35064":
                category: BUSINESS
                description: This operation is only supported for key based campaigns.
                domain: API_MARKETING
              "35075":
                category: BUSINESS
                description: The category {categoryId} is not supported by the Promoted Listing service for single-quantity listings.
                domain: API_MARKETING
              "35077":
                category: BUSINESS
                description: To use Promoted Listings, you need to improve your seller level to Top Rated or Above Standard and have enough recent sales activity.
                domain: API_MARKETING
              "35078":
                category: BUSINESS
                description: To gain access to Promoted Listings, you must be in good standing with recent sales activity.
                domain: API_MARKETING
              "35089":
                category: BUSINESS
                description: We are currently testing a premium ads product with a small invite-only group. We will share more information when we are ready to expand.
                domain: API_MARKETING
              "36221":
                category: BUSINESS
                description: You have exceeded the maximum number of ads supported in a ad group with this request. Only {maxItemsLimit} ads are allowed per ad group.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - ad
  "/ad_campaign/{campaign_id}/ad/{ad_id}":
    delete:
      description: This method removes the specified ad from the specified campaign.<br /><br />Pass the ID of the ad to delete with the ID of the campaign associated with the ad as path parameters to the call.<br /><br />Call <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> to get the current list of the seller's campaign IDs.<br /><br /><span class="tablenote"><b>Note:</b> This method only applies to the Cost Per Sale (CPS) funding model; it does not apply to the Cost Per Click (CPC) funding model. See <a href="/api-docs/sell/static/marketing/pl-overview.html#funding-model">Funding Models</a> in the <i>Promoted Listings Playbook</i> for more information.</span><br /><br />When using the CPC funding model, use the <b>bulkUpdateAdsStatusByListingId</b> method to change the status of ads to ARCHIVED.
      operationId: deleteAd
      parameters:
        - description: Identifier of an ad. This ID was generated when the ad was created.
          in: path
          name: ad_id
          required: true
          schema:
            type: string
        - description: A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.<br /><br /><span class="tablenote"><b>Note:</b> You can retrieve the campaign IDs for a specified seller using the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method.</span>
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
      responses:
        "204":
          description: No Content
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35035":
                category: REQUEST
                description: The campaign with campaign id {campaign_id} has ended.
                domain: API_MARKETING
              "35044":
                category: REQUEST
                description: No Ad found for 'ad_id' {ad_id}. Please correct the 'ad_id' and try again.
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
              "36101":
                category: REQUEST
                description: This functionality is not supported for the CPC funding model.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Conflict
          x-response-codes:
            errors:
              "35061":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is being synced to match the specifications of the campaign. Please wait a few minutes and try the call again.
                domain: API_MARKETING
              "35063":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is ending soon. No update operations are allowed on this campaign until it ends.
                domain: API_MARKETING
              "35064":
                category: BUSINESS
                description: This operation is only supported for key based campaigns.
                domain: API_MARKETING
              "35077":
                category: BUSINESS
                description: To use Promoted Listings, you need to improve your seller level to Top Rated or Above Standard and have enough recent sales activity.
                domain: API_MARKETING
              "35078":
                category: BUSINESS
                description: To gain access to Promoted Listings, you must be in good standing with recent sales activity.
                domain: API_MARKETING
              "35089":
                category: BUSINESS
                description: We are currently testing a premium ads product with a small invite-only group. We will share more information when we are ready to expand.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - ad
    get:
      description: This method retrieves the specified ad from the specified campaign.  <p>In the request, supply the <b>campaign_id</b> and <b>ad_id</b> as path parameters.</p> <p>Call <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> to retrieve a list of the seller's current campaign IDs and call <a href="/api-docs/sell/marketing/resources/ad/methods/getAds">getAds</a> to retrieve their current ad IDs.</p>
      operationId: getAd
      parameters:
        - description: A unique identifier for an ad. This ID is generated when the ad is created.
          in: path
          name: ad_id
          required: true
          schema:
            type: string
        - description: A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.<br /><br /><span class="tablenote"><b>Note:</b> You can retrieve the campaign IDs for a specified seller using the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method.</span>
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Ad"
          description: Success
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35035":
                category: REQUEST
                description: The campaign with campaign id {campaign_id} has ended.
                domain: API_MARKETING
              "35044":
                category: REQUEST
                description: No Ad found for 'ad_id' {ad_id}. Please correct the 'ad_id' and try again.
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Business error
        "500":
          description: Internal Server error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing.readonly
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - ad
  "/ad_campaign/{campaign_id}/ad/{ad_id}/update_bid":
    post:
      description: This method updates the bid percentage (also known as the "ad rate") for the specified ad in the specified campaign. <p>In the request, supply the <b>campaign_id</b> and <b>ad_id</b> as path parameters, and supply the new <b>bidPercentage</b> value in the payload of the call.</p>  <p>Call <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> to retrieve a seller's current campaign IDs and call <a href="/api-docs/sell/marketing/resources/ad/methods/getAds">getAds</a> to get their ad IDs.</p><span class="tablenote"><b>Note:</b> This method only applies to the Cost Per Sale (CPS) funding model; it does not apply to the Cost Per Click (CPC) funding model. See <a href="/api-docs/sell/static/marketing/pl-overview.html#funding-model">Funding Models</a> in the <i>Promoted Listings Playbook</i> for more information.</span>
      operationId: updateBid
      parameters:
        - description: A unique eBay-assigned ID for an ad that's generated when an ad is created.
          in: path
          name: ad_id
          required: true
          schema:
            type: string
        - description: A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.<br /><br /><span class="tablenote"><b>Note:</b> You can retrieve the campaign IDs for a specified seller using the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method.</span>
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/UpdateBidPercentageRequest"
              description: This type defines the fields for the <b>updateBid</b> request.
        description: This type defines the fields for the <b>updateBid</b> request.
        required: true
      responses:
        "204":
          description: No content
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35007":
                category: REQUEST
                description: "The 'bidPercentage' {bidPercentage} is not valid. The bid percentage should be a single precision value. Minimum value: {minBidPercent} , Maximum value:{maxBidPercent}."
                domain: API_MARKETING
              "35035":
                category: REQUEST
                description: The campaign with campaign id {campaign_id} has ended.
                domain: API_MARKETING
              "35044":
                category: REQUEST
                description: No Ad found for 'ad_id' {ad_id}. Please correct the 'ad_id' and try again.
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
              "35048":
                category: REQUEST
                description: The listing ID {listingId} is invalid or has ended.
                domain: API_MARKETING
              "36101":
                category: REQUEST
                description: This functionality is not supported for the CPC funding model.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Conflict
          x-response-codes:
            errors:
              "35052":
                category: BUSINESS
                description: The category {categoryId} is not supported by the Promoted Listing service for multi-quantity listings.
                domain: API_MARKETING
              "35058":
                category: BUSINESS
                description: The listing ID {listingId} is not a fixed price item. This is a requirement for a promoted listing.
                domain: API_MARKETING
              "35059":
                category: BUSINESS
                description: The listing ID {listingId} is not a multi-quantity item. This is a requirement for a promoted listing.
                domain: API_MARKETING
              "35061":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is being synced to match the specifications of the campaign. Please wait a few minutes and try the call again.
                domain: API_MARKETING
              "35063":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is ending soon. No update operations are allowed on this campaign until it ends.
                domain: API_MARKETING
              "35064":
                category: BUSINESS
                description: This operation is only supported for key based campaigns.
                domain: API_MARKETING
              "35075":
                category: BUSINESS
                description: The category {categoryId} is not supported by the Promoted Listing service for single-quantity listings.
                domain: API_MARKETING
              "35077":
                category: BUSINESS
                description: To use Promoted Listings, you need to improve your seller level to Top Rated or Above Standard and have enough recent sales activity.
                domain: API_MARKETING
              "35078":
                category: BUSINESS
                description: To gain access to Promoted Listings, you must be in good standing with recent sales activity.
                domain: API_MARKETING
              "35089":
                category: BUSINESS
                description: We are currently testing a premium ads product with a small invite-only group. We will share more information when we are ready to expand.
                domain: API_MARKETING
              "35113":
                category: BUSINESS
                description: This operation is not supported when selected adRateStratergy is DYNAMIC for the campaign.
                domain: API_MARKETING
        "500":
          description: Internal Server error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - ad
  "/ad_campaign/{campaign_id}/ad_group":
    get:
      description: <span class="tablenote"><b>Note:</b> This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program. For information about how to request access to this program, refer to <a href="/api-docs/sell/static/marketing/pl-verify-eligibility.html#access-requests " target="_blank "> Promoted Listings Advanced Access Requests</a> in the Promoted Listings Playbook. To determine if a seller qualifies for PLA, use the <a href="/api-docs/sell/account/resources/advertising_eligibility/methods/getAdvertisingEligibility " target="_blank ">getAdvertisingEligibility</a> method in Account API.</span><br />This method retrieves ad groups for the specified campaigns.<br /><br />Each campaign can only have <b>one</b> ad group.<br /><br />In the request, supply the <b>campaign_ids</b> as path parameters.<br /><br />Call <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> to retrieve a list of the current campaign IDs for a seller.
      operationId: getAdGroups
      parameters:
        - description: A comma-separated list of ad group statuses. The results will be filtered to only include the given statuses of the ad group.<br /><br />The results might not include these ad groups if other search conditions exclude them.
          in: query
          name: ad_group_status
          required: false
          schema:
            type: string
        - description: A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.<br /><br /><span class="tablenote"><b>Note:</b> You can retrieve the campaign IDs for a specified seller using the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method.</span>
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
        - description: The number of results, from the current result set, to be returned in a single page.
          in: query
          name: limit
          required: false
          schema:
            type: string
        - description: "The number of results that will be skipped in the result set. This is used with the <b>limit</b> field to control the pagination of the output.<br /><br />For example, if the <b>offset</b> is set to <code>0</code> and the <b>limit</b> is set to <code>10</code>, the method will retrieve items 1 through 10 from the list of items returned. If the <b>offset</b> is set to <code>10</code> and the <b>limit</b> is set to <code>10</code>, the method will retrieve items 11 through 20 from the list of items returned.<br><br><b>Default</b>: <code>0</code>"
          in: query
          name: offset
          required: false
          schema:
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AdGroupPagedCollectionResponse"
          description: Success
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35029":
                category: REQUEST
                description: The 'limit' has to be greater than zero and less than {maxLimitValue}.
                domain: API_MARKETING
              "35030":
                category: REQUEST
                description: The 'offset' cannot be less than zero.
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Business error
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing.readonly
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - ad_group
    post:
      description: <span class="tablenote"><b>Note:</b> This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program. For information about how to request access to this program, refer to <a href="/api-docs/sell/static/marketing/pl-verify-eligibility.html#access-requests " target="_blank "> Promoted Listings Advanced Access Requests</a> in the Promoted Listings Playbook. To determine if a seller qualifies for PLA, use the <a href="/api-docs/sell/account/resources/advertising_eligibility/methods/getAdvertisingEligibility " target="_blank ">getAdvertisingEligibility</a> method in Account API.</span><br />This method adds an ad group to an existing PLA campaign that uses the Cost Per Click (CPC) funding model.<br /><br />To create an ad group for a campaign, specify the <b>defaultBid</b> for the ad group in the payload of the request. Then specify the campaign to which the ad group should be associated using the <b>campaign_id</b> path parameter.<br /><br />Each campaign can have one or more associated ad groups.
      operationId: createAdGroup
      parameters:
        - description: A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.<br /><br /><span class="tablenote"><b>Note:</b> You can retrieve the campaign IDs for a specified seller using the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method.</span>
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/CreateAdGroupRequest"
              description: This type defines the fields for the <b>createAdGroup</b> request.
        description: This type defines the fields for the <b>createAdGroup</b> request.
        required: true
      responses:
        "201":
          content:
            application/json:
              schema:
                type: object
          description: Created
          headers:
            Location:
              schema:
                description: The <b>location</b> response header contains the getAdGroup URL to the newly created ad group. The URL includes the newly assigned <code>adGroupID</code>, which you can use to retrieve the ad group.
                type: string
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35035":
                category: REQUEST
                description: The campaign with campaign id {campaign_id} has ended.
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
              "36201":
                category: REQUEST
                description: An ad group with name {name} already exists for this campaign.
                domain: API_MARKETING
              "36202":
                category: REQUEST
                description: The ad group name cannot be more than {maxAdGroupNameLength} characters.
                domain: API_MARKETING
              "36203":
                category: REQUEST
                description: The 'defaultBid' value {defaultBidValue} is not valid. The default bid value should be a double precision value.
                domain: API_MARKETING
              "36204":
                category: REQUEST
                description: The 'defaultBid' currency {defaultBidCurrency} is not valid or missing.
                domain: API_MARKETING
              "36205":
                category: REQUEST
                description: The 'defaultBid' value {defaultBidValue} is below floor value {bidFloorValue}.
                domain: API_MARKETING
              "36206":
                category: REQUEST
                description: The 'defaultBid' value {defaultBidValue} is above max value {bidMaxValue}.
                domain: API_MARKETING
              "36207":
                category: REQUEST
                description: The 'defaultBid' value {defaultBidValue} is more than daily budget.
                domain: API_MARKETING
              "36212":
                category: REQUEST
                description: The 'defaultBid' currency {defaultBidCurrency} should be the same as the daily budget.
                domain: API_MARKETING
              "36214":
                category: REQUEST
                description: Ad Group name is required for this call.
                domain: API_MARKETING
              "36215":
                category: REQUEST
                description: The 'defaultBid' is required for this call.
                domain: API_MARKETING
              "36216":
                category: REQUEST
                description: The 'defaultBid' value is required for this call.
                domain: API_MARKETING
              "36217":
                category: REQUEST
                description: The Ad Group name contains invalid characters. {notAllowedCharacters} are not allowed.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Business error
          x-response-codes:
            errors:
              "35089":
                category: BUSINESS
                description: We are currently testing a premium ads product with a small invite-only group. We will share more information when we are ready to expand.
                domain: API_MARKETING
              "36213":
                category: BUSINESS
                description: The campaign funding model should be CPC. Please check funding model for provided campaign id.
                domain: API_MARKETING
        "500":
          description: Internal Server error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - ad_group
  "/ad_campaign/{campaign_id}/ad_group/{ad_group_id}":
    get:
      description: <span class="tablenote"><b>Note:</b> This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program. For information about how to request access to this program, refer to <a href="/api-docs/sell/static/marketing/pl-verify-eligibility.html#access-requests " target="_blank "> Promoted Listings Advanced Access Requests</a> in the Promoted Listings Playbook. To determine if a seller qualifies for PLA, use the <a href="/api-docs/sell/account/resources/advertising_eligibility/methods/getAdvertisingEligibility " target="_blank ">getAdvertisingEligibility</a> method in Account API.</span><br />This method retrieves the details of a specified ad group, such as the ad group’s default bid and status.<br /><br />In the request, specify the <b>campaign_id</b> and <b>ad_group_id</b> as path parameters.<br /><br />Call <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> to retrieve a list of the current campaign IDs for a seller and call <a href="/api-docs/sell/marketing/resources/adgroup/methods/getAdGroups">getAdGroups</a> for the ad group ID of the ad group you wish to retrieve.
      operationId: getAdGroup
      parameters:
        - description: The ID of the ad group that shall be retrieved.
          in: path
          name: ad_group_id
          required: true
          schema:
            type: string
        - description: A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.<br /><br /><span class="tablenote"><b>Note:</b> You can retrieve the campaign IDs for a specified seller using the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method.</span>
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AdGroup"
          description: Success
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
              "36210":
                category: REQUEST
                description: No ad group found for ad group id {ad_group_id}.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Business error
          x-response-codes:
            errors:
              "36213":
                category: BUSINESS
                description: The campaign funding model should be CPC. Please check funding model for provided campaign id.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing.readonly
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - ad_group
    put:
      description: <span class="tablenote"><b>Note:</b> This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program. For information about how to request access to this program, refer to <a href="/api-docs/sell/static/marketing/pl-verify-eligibility.html#access-requests " target="_blank "> Promoted Listings Advanced Access Requests</a> in the Promoted Listings Playbook. To determine if a seller qualifies for PLA, use the <a href="/api-docs/sell/account/resources/advertising_eligibility/methods/getAdvertisingEligibility " target="_blank ">getAdvertisingEligibility</a> method in Account API.</span><br />This method updates the ad group associated with a campaign.<br /><br />With this method, you can modify the <b>default bid</b> for the ad group, change the state of the ad group, or change the name of the ad group. Pass the <b>ad_group_id</b> you want to update as a URI parameter, and configure the <b>adGroupStatus</b> and <b>defaultBid</b> in the request payload.<br /><br />Call <a href="/api-docs/sell/marketing/resources/adgroup/methods/getAdGroup">getAdGroup</a> to retrieve the current default bid and status of the ad group that you would like to update.
      operationId: updateAdGroup
      parameters:
        - description: The ID of the ad group that shall be updated.
          in: path
          name: ad_group_id
          required: true
          schema:
            type: string
        - description: A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.<br /><br /><span class="tablenote"><b>Note:</b> You can retrieve the campaign IDs for a specified seller using the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method.</span>
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/UpdateAdGroupRequest"
              description: This type defines the fields for the <b>UpdateAdGroup</b> request.
        description: This type defines the fields for the <b>UpdateAdGroup</b> request.
        required: true
      responses:
        "204":
          description: No Content
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35035":
                category: REQUEST
                description: The campaign with campaign id {campaign_id} has ended.
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
              "36201":
                category: REQUEST
                description: An ad group with name {name} already exists for this campaign.
                domain: API_MARKETING
              "36202":
                category: REQUEST
                description: The ad group name cannot be more than {maxAdGroupNameLength} characters.
                domain: API_MARKETING
              "36203":
                category: REQUEST
                description: The 'defaultBid' value {defaultBidValue} is not valid. The default bid value should be a double precision value.
                domain: API_MARKETING
              "36204":
                category: REQUEST
                description: The 'defaultBid' currency {defaultBidCurrency} is not valid or missing.
                domain: API_MARKETING
              "36205":
                category: REQUEST
                description: The 'defaultBid' value {defaultBidValue} is below floor value {bidFloorValue}.
                domain: API_MARKETING
              "36206":
                category: REQUEST
                description: The 'defaultBid' value {defaultBidValue} is above max value {bidMaxValue}.
                domain: API_MARKETING
              "36207":
                category: REQUEST
                description: The 'defaultBid' value {defaultBidValue} is more than daily budget.
                domain: API_MARKETING
              "36210":
                category: REQUEST
                description: No ad group found for ad group id {ad_group_id}.
                domain: API_MARKETING
              "36212":
                category: REQUEST
                description: The 'defaultBid' currency {defaultBidCurrency} should be the same as the daily budget.
                domain: API_MARKETING
              "36216":
                category: REQUEST
                description: The 'defaultBid' value {defaultBidValue} is not valid or missing.
                domain: API_MARKETING
              "36217":
                category: REQUEST
                description: The Ad Group name contains invalid characters. {notAllowedCharacters} are not allowed.
                domain: API_MARKETING
              "36224":
                category: REQUEST
                description: The 'defaultBid' or 'adGroupStatus' or 'name' value is required for this call.
                domain: API_MARKETING
              "36225":
                category: REQUEST
                description: "'ad_group_statuses' value is invalid. It should be either ACTIVE, PAUSED or ARCHIVED."
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Business error
          x-response-codes:
            errors:
              "35089":
                category: BUSINESS
                description: We are currently testing a premium ads product with a small invite-only group. We will share more information when we are ready to expand.
                domain: API_MARKETING
              "36213":
                category: BUSINESS
                description: The campaign funding model should be CPC. Please check funding model for provided campaign id.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - ad_group
  "/ad_campaign/{campaign_id}/ad_group/{ad_group_id}/suggest_bids":
    post:
      description: <span class="tablenote"><b>Note:</b> This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program. For information about how to request access to this program, refer to <a href="/api-docs/sell/static/marketing/pl-verify-eligibility.html#access-requests " target="_blank "> Promoted Listings Advanced Access Requests</a> in the Promoted Listings Playbook. To determine if a seller qualifies for PLA, use the <a href="/api-docs/sell/account/resources/advertising_eligibility/methods/getAdvertisingEligibility " target="_blank ">getAdvertisingEligibility</a> method in Account API.</span><br />This method allows sellers to retrieve the suggested bids for input keywords and match type.
      operationId: suggestBids
      parameters:
        - description: The ID of the ad group containing the keywords for which the bid suggestions will be provided.
          in: path
          name: ad_group_id
          required: true
          schema:
            type: string
        - description: A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.<br /><br /><span class="tablenote"><b>Note:</b> You can retrieve the campaign IDs for a specified seller using the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method.</span>
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/TargetedBidRequest"
              description: The data requested to retrieve the suggested bids.
        description: The data requested to retrieve the suggested bids.
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TargetedBidsPagedCollection"
          description: Success
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35041":
                category: REQUEST
                description: The 'marketplaceId' is required.
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
              "35091":
                category: REQUEST
                description: You have exceeded the maximum number of requests. Only {maxSupportedNumber} are supported per call.
                domain: API_MARKETING
              "36210":
                category: REQUEST
                description: No ad group found for ad group id {ad_group_id}.
                domain: API_MARKETING
              "36301":
                category: REQUEST
                description: "The provided keyword match type is not supported. Valid values are: {matchTypeValues}."
                domain: API_MARKETING
              "36304":
                category: REQUEST
                description: The keywordText {keywordText} cannot be more than {maxKeywordTextLength} characters.
                domain: API_MARKETING
              "36311":
                category: REQUEST
                description: The keywordText cannot be null or empty.
                domain: API_MARKETING
              "36312":
                category: REQUEST
                description: The keywordText contains invalid characters {invalidCharacters}
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Conflict
          x-response-codes:
            errors:
              "35051":
                category: BUSINESS
                description: "'marketplaceId' {marketplaceId} is not supported. Promoted Listings is supported only on these marketplaces: {supportedMarketplaces}."
                domain: API_MARKETING
              "36320":
                category: BUSINESS
                description: The keywordText {keywordText} cannot have total number of words more than {maxWordsInKeyword} words
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - ad_group
  "/ad_campaign/{campaign_id}/ad_group/{ad_group_id}/suggest_keywords":
    post:
      description: <span class="tablenote"><b>Note:</b> This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program. For information about how to request access to this program, refer to <a href="/api-docs/sell/static/marketing/pl-verify-eligibility.html#access-requests " target="_blank "> Promoted Listings Advanced Access Requests</a> in the Promoted Listings Playbook. To determine if a seller qualifies for PLA, use the <a href="/api-docs/sell/account/resources/advertising_eligibility/methods/getAdvertisingEligibility " target="_blank ">getAdvertisingEligibility</a> method in Account API.</span><br />This method allows sellers to retrieve a list of keyword ideas to be targeted for Promoted Listings campaigns.
      operationId: suggestKeywords
      parameters:
        - description: The ID of the ad group for which the keyword suggestions will be provided.
          in: path
          name: ad_group_id
          required: true
          schema:
            type: string
        - description: A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.<br /><br /><span class="tablenote"><b>Note:</b> You can retrieve the campaign IDs for a specified seller using the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method.</span>
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/TargetedKeywordRequest"
              description: The required data to retrieve suggested keywords.
        description: The required data to retrieve suggested keywords.
        required: false
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TargetedKeywordsPagedCollection"
          description: Success
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35013":
                category: REQUEST
                description: The listing Id {listingId} is not valid.
                domain: API_MARKETING
              "35041":
                category: REQUEST
                description: The 'marketplaceId' is required.
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
              "36210":
                category: REQUEST
                description: No ad group found for ad group id {ad_group_id}.
                domain: API_MARKETING
              "36301":
                category: REQUEST
                description: "The provided keyword match type is not supported. Valid values are: {matchTypeValues}."
                domain: API_MARKETING
              "70006":
                category: REQUEST
                description: The provided exclusion is not supported. Valid values are {supportedExclusions}.
                domain: API_MARKETING
              "70007":
                category: REQUEST
                description: The provided additionalInfo is not supported. Valid values are {supportedAdditionalInfo}.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Business error
          x-response-codes:
            errors:
              "35051":
                category: BUSINESS
                description: "'marketplaceId' {marketplaceId} is not supported. Promoted Listings is supported only on these marketplaces: {supportedMarketplaces}."
                domain: API_MARKETING
              "35054":
                category: BUSINESS
                description: The listing Id {listingId} was created on a different marketplace than the campaign. The listing and campaign must reside on the same marketplace.
                domain: API_MARKETING
              "35057":
                category: BUSINESS
                description: The listing Id {listingId} does not belong to the seller making this call.
                domain: API_MARKETING
              "35068":
                category: BUSINESS
                description: You have exceeded the maximum number of listing Ids. Only {maxSupportedNumber} listings are supported per call.
                domain: API_MARKETING
        "500":
          description: Internal Server error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - ad_group
  "/ad_campaign/{campaign_id}/bulk_create_ads_by_inventory_reference":
    post:
      description: This method adds multiple listings that are managed with the <a href="/api-docs/sell/inventory/resources/methods" title="Inventory API Reference">Inventory API</a> to an existing Promoted Listings campaign.<br /><br />For Promoted Listings Standard (PLS) campaigns using the Cost Per Sale (CPS) model, bulk ads may be directly created for the listing.<br /><br />For each listing specified in the request, this method:<br /><ul><li>Creates an ad for the listing.</li> <li>Sets the bid percentage (also known as the <i>ad rate</i>) for the ads created.</li> <li>Associates the ads created with the specified campaign.</li></ul><br />To create ads for a listing, specify their <b>inventoryReferenceId</b> and <b>inventoryReferenceType</b>, plus the <b>bidPercentage</b> for the ad in the payload of the request. Specify the campaign to which you want to associate the ads using the <b>campaign_id</b> path parameter.<br /><br /><span class="tablenote"><b>Note:</b> This method only applies to the Cost Per Sale (CPS) funding model; it does not apply to the Cost Per Click (CPC) funding model. See <a href="/api-docs/sell/static/marketing/pl-overview.html#funding-model">Funding Models</a> in the <i>Promoted Listings Playbook</i> for more information.</span><br /><br />Use <a href="/api-docs/sell/marketing/resources/campaign/methods/createCampaign">createCampaign</a> to create a new campaign and use <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> to get a list of existing campaigns.
      operationId: bulkCreateAdsByInventoryReference
      parameters:
        - description: A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. Get a seller's campaign IDs by calling <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a>.
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/BulkCreateAdsByInventoryReferenceRequest"
              description: The container for the bulk request to create ads for eBay inventory reference IDs. eBay inventory reference IDs are seller-defined IDs used by theInventory API.
        description: The container for the bulk request to create ads for eBay inventory reference IDs. eBay inventory reference IDs are seller-defined IDs used by theInventory API.
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/BulkCreateAdsByInventoryReferenceResponse"
          description: Success
        "207":
          description: Multi Status
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35007":
                category: REQUEST
                description: "The 'bidPercentage' {bidPercentage} is not valid. The bid percentage should be a single precision value. Minimum value: {minBidPercent} , Maximum value:{maxBidPercent}."
                domain: API_MARKETING
              "35010":
                category: REQUEST
                description: The bidPercentage should not be provided when selected adRateStrategy is DYNAMIC for the campaign.
                domain: API_MARKETING
              "35012":
                category: REQUEST
                description: The inventory reference ID {inventoryReferenceId} is not valid.
                domain: API_MARKETING
              "35018":
                category: REQUEST
                description: There are duplicate listing IDs or inventoryReference IDs in this request. You must remove the duplicate.
                domain: API_MARKETING
              "35033":
                category: REQUEST
                description: At least one request is required for bulk requests.
                domain: API_MARKETING
              "35035":
                category: REQUEST
                description: The campaign with campaign id {campaign_id} has ended.
                domain: API_MARKETING
              "35040":
                category: REQUEST
                description: "The inventory reference type is not valid. Valid values are: {inventoryReferenceTypeValues}."
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
              "36106":
                category: REQUEST
                description: The 'adGroupId' is not supported for CPS funding model.
                domain: API_MARKETING
              "36108":
                category: REQUEST
                description: The 'adGroupId' is required for CPC funding model.
                domain: API_MARKETING
              "36210":
                category: REQUEST
                description: No adgroup found for adgroup id {ad_group_id}.
                domain: API_MARKETING
              "36219":
                category: REQUEST
                description: The ad group with ad group id {ad_group_id} has been archived.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Conflict
          x-response-codes:
            errors:
              "35061":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is being synced to match the specifications of the campaign. Please wait a few minutes and try the call again.
                domain: API_MARKETING
              "35063":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is ending soon. No update operations are allowed on this campaign until it ends.
                domain: API_MARKETING
              "35064":
                category: BUSINESS
                description: This operation is only supported for key based campaigns.
                domain: API_MARKETING
              "35071":
                category: BUSINESS
                description: You have exceeded the maximum number of listing IDs or inventory reference IDs. Only {maxSupportedNumber} IDs are supported per call.
                domain: API_MARKETING
              "35072":
                category: BUSINESS
                description: InventoryReferenceId {inventoryReferenceId} is not eligible for Promoted Listings because it is a variation and variations can only be promoted using the parent ID to which it belongs. Replace this ID with the InventoryReferenceId of the parent and set 'inventoryReferenceType' to 'INVENTORY_ITEM_GROUP'.
                domain: API_MARKETING
              "35077":
                category: BUSINESS
                description: To use Promoted Listings, you need to improve your seller level to Top Rated or Above Standard and have enough recent sales activity.
                domain: API_MARKETING
              "35078":
                category: BUSINESS
                description: To gain access to Promoted Listings, you must be in good standing with recent sales activity.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - ad
  "/ad_campaign/{campaign_id}/bulk_create_ads_by_listing_id":
    post:
      description: This method adds multiple listings to an existing Promoted Listings campaign using <b>listingId</b> values generated by the <a href="/Devzone/XML/docs/Reference/eBay/index.html" title="Trading API Reference">Trading API</a> or <a href="/api-docs/sell/inventory/resources/methods" title="Inventory API Reference">Inventory API</a>, or using values generated by an ad group ID.<p>For Promoted Listings Standard (PLS) campaigns using the Cost Per Sale (CPS) funding model, bulk ads may be directly created for the listing.</p><p>For each listing ID specified in the request, this method:</p>  <ul><li>Creates an ad for the listing.</li> <li>Sets the bid percentage (also known as the <i>ad rate</i>) for the ad.</li> <li>Associates the ad with the specified campaign.</li></ul><p>To create an ad for a listing, specify its <b>listingId</b>, plus the <b>bidPercentage</b> for the ad in the payload of the request. Specify the campaign to associate the ads with using the <b>campaign_id</b> path parameter. Listing IDs are generated by eBay when a seller creates listings with the Trading API.</p><p>You can specify a maximum of <b>500 listings per call</b> and each campaign can have ads for a maximum of 50,000 items. Be aware when using this call that each variation in a multiple-variation listing creates an individual ad.</p><p>For Promoted Listings Advanced (PLA) campaigns using the Cost Per Click (CPC) funding model, an ad group must be created first. If no ad group has been created for the campaign, ads cannot be created.</p><p>For the ad group specified in the request, this method associates the ad with the specified ad group.</p><p>To create an ad for an ad group, specify the name of the ad group plus the <b>defaultBid</b> for the ad in the payload of the request. Specify the campaign to associate the ads with using the <b>campaign_id</b> path parameter. Ad groups are generated using the <a href="/api-docs/sell/marketing/resources/adgroup/methods/createAdGroup">createAdGroup</a>  method.</p> <p>You can specify one or more ad groups per campaign.</p><p>Use <a href="/api-docs/sell/marketing/resources/campaign/methods/createCampaign">createCampaign</a> to create a new campaign and use <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> to get a list of existing campaigns.</p>
      operationId: bulkCreateAdsByListingId
      parameters:
        - description: A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get a seller's campaign IDs by calling <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a>.
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/BulkCreateAdRequest"
              description: The container for the bulk request to create ads for eBay listing IDs. eBay listing IDs are generated by the Trading API and Inventory API when the listing is created on eBay.
        description: The container for the bulk request to create ads for eBay listing IDs. eBay listing IDs are generated by the Trading API and Inventory API when the listing is created on eBay.
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/BulkAdResponse"
          description: Success
        "207":
          description: Multi Status
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35007":
                category: REQUEST
                description: "The 'bidPercentage' {bidPercentage} is not valid. The bid percentage should be a single precision value. Minimum value: {minBidPercent} , Maximum value:{maxBidPercent}."
                domain: API_MARKETING
              "35010":
                category: REQUEST
                description: The bidPercentage should not be provided when selected adRateStrategy is DYNAMIC for the campaign.
                domain: API_MARKETING
              "35013":
                category: REQUEST
                description: The listing ID {listingId} is not valid.
                domain: API_MARKETING
              "35014":
                category: REQUEST
                description: The listing Id is required for this call.
                domain: API_MARKETING
              "35018":
                category: REQUEST
                description: There are duplicate listing IDs or inventoryReference IDs in this request. You must remove the duplicate.
                domain: API_MARKETING
              "35033":
                category: REQUEST
                description: At least one request is required for bulk requests.
                domain: API_MARKETING
              "35035":
                category: REQUEST
                description: The campaign with campaign id {campaign_id} has ended.
                domain: API_MARKETING
              "35036":
                category: REQUEST
                description: An ad for listing ID {listingId} already exists.
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
              "35048":
                category: REQUEST
                description: The listing ID {listingId} is invalid or has ended.
                domain: API_MARKETING
              "35080":
                category: REQUEST
                description: The 'bidPercentage' is not supported for CPC funding model.
                domain: API_MARKETING
              "36106":
                category: REQUEST
                description: The 'adGroupId' is not supported for CPS funding model.
                domain: API_MARKETING
              "36108":
                category: REQUEST
                description: The 'adGroupId' is required for CPC funding model.
                domain: API_MARKETING
              "36210":
                category: REQUEST
                description: No ad group found for ad group id {ad_group_id}.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Conflict
          x-response-codes:
            errors:
              "35052":
                category: BUSINESS
                description: The category {categoryId} is not supported by the Promoted Listing service for multi-quantity listings.
                domain: API_MARKETING
              "35054":
                category: BUSINESS
                description: The listing ID {listingId} was created on a different marketplace than the campaign. The listing and campaign must reside on the same marketplace.
                domain: API_MARKETING
              "35057":
                category: BUSINESS
                description: The listing ID {listingId} does not belong to the seller making this call.
                domain: API_MARKETING
              "35058":
                category: BUSINESS
                description: The listing ID {listingId} is not a fixed price item. This is a requirement for a promoted listing.
                domain: API_MARKETING
              "35059":
                category: BUSINESS
                description: The listing ID {listingId} is not a multi-quantity item. This is a requirement for a promoted listing.
                domain: API_MARKETING
              "35061":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is being synced to match the specifications of the campaign. Please wait a few minutes and try the call again.
                domain: API_MARKETING
              "35063":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is ending soon. No update operations are allowed on this campaign until it ends.
                domain: API_MARKETING
              "35071":
                category: BUSINESS
                description: You have exceeded the maximum number of listing IDs or inventory reference IDs. Only {maxSupportedNumber} IDs are supported per call.
                domain: API_MARKETING
              "35075":
                category: BUSINESS
                description: The category {categoryId} is not supported by the Promoted Listing service for single-quantity listings.
                domain: API_MARKETING
              "35077":
                category: BUSINESS
                description: To use Promoted Listings, you need to improve your seller level to Top Rated or Above Standard and have enough recent sales activity.
                domain: API_MARKETING
              "35078":
                category: BUSINESS
                description: To gain access to Promoted Listings, you must be in good standing with recent sales activity.
                domain: API_MARKETING
              "35089":
                category: BUSINESS
                description: We are currently testing a premium ads product with a small invite-only group. We will share more information when we are ready to expand.
                domain: API_MARKETING
              "36152":
                category: BUSINESS
                description: The 'bidPercentage' is not supported for CPC funding model.
                domain: API_MARKETING
              "36221":
                category: BUSINESS
                description: You have exceeded the maximum number of ads supported in a ad group with this request. Only {maxItemsLimit} ads are allowed per ad group.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - ad
  "/ad_campaign/{campaign_id}/bulk_create_keyword":
    post:
      description: <span class="tablenote"><b>Note:</b> This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program. For information about how to request access to this program, refer to <a href="/api-docs/sell/static/marketing/pl-verify-eligibility.html#access-requests " target="_blank "> Promoted Listings Advanced Access Requests</a> in the Promoted Listings Playbook. To determine if a seller qualifies for PLA, use the <a href="/api-docs/sell/account/resources/advertising_eligibility/methods/getAdvertisingEligibility " target="_blank ">getAdvertisingEligibility</a> method in Account API.</span><br />This method adds keywords, in bulk, to an existing PLA ad group in a campaign that uses the Cost Per Click (CPC) funding model.<br /><br />This method also sets the CPC rate for each keyword.<br /><br />In the request, supply the <b>campaign_id</b> as a path parameter.<br /><br />Call the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method to retrieve a list of current campaign IDs for a specified seller.
      operationId: bulkCreateKeyword
      parameters:
        - description: A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.<br /><br /><span class="tablenote"><b>Note:</b> You can retrieve the campaign IDs for a specified seller using the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method.</span>
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/BulkCreateKeywordRequest"
              description: A type that defines the fields for the bulk request to create keywords.
        description: A type that defines the fields for the bulk request to create keywords.
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/BulkCreateKeywordResponse"
          description: Success
        "207":
          description: Multi Status
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35033":
                category: REQUEST
                description: At least one request is required for bulk requests.
                domain: API_MARKETING
              "35035":
                category: REQUEST
                description: The campaign with campaign id {campaign_id} has ended.
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
              "36210":
                category: REQUEST
                description: No ad group found for ad group id {ad_group_id}.
                domain: API_MARKETING
              "36219":
                category: REQUEST
                description: The ad group with ad group id {ad_group_id} has been archived.
                domain: API_MARKETING
              "36301":
                category: REQUEST
                description: "The keyword match type {matchType} is not supported. Valid values are: {matchTypeValues}."
                domain: API_MARKETING
              "36303":
                category: REQUEST
                description: A keyword with text {keywordText} and match type {matchType} already exists for this Ad Group.
                domain: API_MARKETING
              "36304":
                category: REQUEST
                description: The keywordText {keywordText} cannot be more than {maxKeywordTextLength} characters.
                domain: API_MARKETING
              "36305":
                category: REQUEST
                description: The 'bid' value {bidValue} is not valid. The default bid value should be a double precision value.
                domain: API_MARKETING
              "36306":
                category: REQUEST
                description: The 'bid' value {bidValue} is below floor value {bidFloorValue}.
                domain: API_MARKETING
              "36307":
                category: REQUEST
                description: The 'bid' value {bidValue} is above max value {bidMaxValue}.
                domain: API_MARKETING
              "36308":
                category: REQUEST
                description: The 'bid' currency {bidCurrency} is not valid or missing.
                domain: API_MARKETING
              "36309":
                category: REQUEST
                description: The 'bid' currency {bidCurrency} should be the same as the daily budget.
                domain: API_MARKETING
              "36311":
                category: REQUEST
                description: The keywordText cannot be null or empty.
                domain: API_MARKETING
              "36312":
                category: REQUEST
                description: The keywordText contains invalid characters {invalidCharacters}
                domain: API_MARKETING
              "36313":
                category: REQUEST
                description: The 'bid' value {bidValue} is more than maximum daily budget {maxDailyBudget}.
                domain: API_MARKETING
              "36315":
                category: REQUEST
                description: There are duplicate KeywordText and matchType combination in this request. You must remove the duplicate.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Business error
          x-response-codes:
            errors:
              "35089":
                category: BUSINESS
                description: We are currently testing a premium ads product with a small invite-only group. We will share more information when we are ready to expand.
                domain: API_MARKETING
              "36316":
                category: BUSINESS
                description: You have exceeded the maximum number of Keyword requests in a bulk request. Only {maxSupportedRequestNumberInBulk} Ids are supported per call.
                domain: API_MARKETING
              "36319":
                category: BUSINESS
                description: You have exceeded the maximum number of create Keyword for an Ad Group. Only {maxSupportedNumber} Ids are supported per Ad Group.
                domain: API_MARKETING
              "36320":
                category: BUSINESS
                description: The keywordText {keywordText} cannot have total number of words more than {maxWordsInKeyword} words.
                domain: API_MARKETING
              "36322":
                category: BUSINESS
                description: Total keyword requests exceed the current AdGroup keyword capacity, which is {maxSupportedRequestNumber}.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - keyword
  "/ad_campaign/{campaign_id}/bulk_delete_ads_by_inventory_reference":
    post:
      description: This method works with listings created with the <a href="/api-docs/sell/inventory/resources/methods" title="Inventory API Reference">Inventory API</a>.<br /><br />The method deletes a set of ads, as specified by a list of inventory reference IDs, from the specified campaign. <i>Inventory reference IDs</i> are seller-defined IDs that are used with the Inventory API</a>.<br /><br />Pass the <b>campaign_id</b> as a path parameter and populate the payload with a list of <b>inventoryReferenceId</b> and <b>inventoryReferenceType</b> pairs that you want to delete.<br /><br />Get the campaign IDs for a seller by calling <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> and call <a href="/api-docs/sell/marketing/resources/ad/methods/getAds">getAds</a> to get a list of the seller's inventory reference IDs.<br /><br /><span class="tablenote"><b>Note:</b> This method only applies to the Cost Per Sale (CPS) funding model; it does not apply to the Cost Per Click (CPC) funding model. See <a href="/api-docs/sell/static/marketing/pl-overview.html#funding-model">Funding Models</a> in the <i>Promoted Listings Playbook</i> for more information.</span>
      operationId: bulkDeleteAdsByInventoryReference
      parameters:
        - description: A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get a seller's campaign IDs by calling <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a>.
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/BulkDeleteAdsByInventoryReferenceRequest"
              description: This request works with listings created via the <a href="/api-docs/sell/inventory/resources/methods">Inventory API</a>.<br /><br />The request is to delete a set of ads in bulk, as specified by a list of inventory reference IDs from the specified campaign.
        description: This request works with listings created via the <a href="/api-docs/sell/inventory/resources/methods">Inventory API</a>.<br /><br />The request is to delete a set of ads in bulk, as specified by a list of inventory reference IDs from the specified campaign.
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/BulkDeleteAdsByInventoryReferenceResponse"
          description: Success
        "207":
          description: Multi Status
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35007":
                category: REQUEST
                description: "The 'bidPercentage' {bidPercentage} is not valid. The bid percentage should be a single precision value. Minimum value: {minBidPercent} , Maximum value:{maxBidPercent}."
                domain: API_MARKETING
              "35012":
                category: REQUEST
                description: The inventory reference ID {inventoryReferenceId} is not valid.
                domain: API_MARKETING
              "35018":
                category: REQUEST
                description: There are duplicate listing IDs or inventoryReference IDs in this request. You must remove the duplicate.
                domain: API_MARKETING
              "35033":
                category: REQUEST
                description: At least one request is required for bulk requests.
                domain: API_MARKETING
              "35035":
                category: REQUEST
                description: The campaign with campaign id {campaign_id} has ended.
                domain: API_MARKETING
              "35040":
                category: REQUEST
                description: "The inventory reference type is not valid. Valid values are: {inventoryReferenceTypeValues}."
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
              "36101":
                category: REQUEST
                description: This functionality is not supported for the CPC funding model.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Conflict
          x-response-codes:
            errors:
              "35061":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is being synced to match the specifications of the campaign. Please wait a few minutes and try the call again.
                domain: API_MARKETING
              "35063":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is ending soon. No update operations are allowed on this campaign until it ends.
                domain: API_MARKETING
              "35064":
                category: BUSINESS
                description: This operation is only supported for key based campaigns.
                domain: API_MARKETING
              "35071":
                category: BUSINESS
                description: You have exceeded the maximum number of listing IDs or inventory reference IDs. Only {maxSupportedNumber} IDs are supported per call.
                domain: API_MARKETING
              "35072":
                category: BUSINESS
                description: InventoryReferenceId {inventoryReferenceId} is not eligible for Promoted Listings because it is a variation and variations can only be promoted using the parent ID to which it belongs. Replace this ID with the InventoryReferenceId of the parent and set 'inventoryReferenceType' to 'INVENTORY_ITEM_GROUP'
                domain: API_MARKETING
              "35077":
                category: BUSINESS
                description: To use Promoted Listings, you need to improve your seller level to Top Rated or Above Standard and have enough recent sales activity.
                domain: API_MARKETING
              "35078":
                category: BUSINESS
                description: To gain access to Promoted Listings, you must be in good standing with recent sales activity.
                domain: API_MARKETING
              "35089":
                category: BUSINESS
                description: We are currently testing a premium ads product with a small invite-only group. We will share more information when we are ready to expand.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - ad
  "/ad_campaign/{campaign_id}/bulk_delete_ads_by_listing_id":
    post:
      description: This method works with listing IDs created with either the <a href="/Devzone/XML/docs/Reference/eBay/index.html" title="Trading API Reference">Trading API</a> or the <a href="/api-docs/sell/inventory/resources/methods" title="Inventory API Reference">Inventory API</a>.<br /><br />The method deletes a set of ads, as specified by a list of <b>listingID</b> values from a Promoted Listings campaign. A listing ID value is generated by eBay when a seller creates a listing with either the Trading API and Inventory API.<br /><br />Pass the <b>campaign_id</b> as a path parameter and populate the payload with the set of listing IDs that you want to delete.<br /><br />Get the campaign IDs for a seller by calling <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> and call <a href="/api-docs/sell/marketing/resources/ad/methods/getAds">getAds</a> to get a list of the seller's inventory reference IDs.<br /><br /><span class="tablenote"><b>Note:</b> This method only applies to the Cost Per Sale (CPS) funding model; it does not apply to the Cost Per Click (CPC) funding model. See <a href="/api-docs/sell/static/marketing/pl-overview.html#funding-model">Funding Models</a> in the <i>Promoted Listings Playbook</i> for more information.</span><br /><br />When using the CPC funding model, use the <a href="/api-docs/sell/marketing/resources/ad/methods/bulkUpdateAdsStatusByListingId">bulkUpdateAdsStatusByListingId</a> method to change the status of ads to ARCHIVED.
      operationId: bulkDeleteAdsByListingId
      parameters:
        - description: A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get a seller's campaign IDs by calling <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a>.
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/BulkDeleteAdRequest"
              description: This request object defines the fields for the <b>bulkDeleteAdsByListingId</b> request.
        description: This request object defines the fields for the <b>bulkDeleteAdsByListingId</b> request.
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/BulkDeleteAdResponse"
          description: Success
        "207":
          description: Multi Status
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35013":
                category: REQUEST
                description: The listing ID {listingId} is not valid.
                domain: API_MARKETING
              "35014":
                category: REQUEST
                description: The listing ID is required for this call.
                domain: API_MARKETING
              "35018":
                category: REQUEST
                description: There are duplicate listing IDs or inventoryReference IDs in this request. You must remove the duplicate.
                domain: API_MARKETING
              "35033":
                category: REQUEST
                description: At least one request is required for bulk requests.
                domain: API_MARKETING
              "35035":
                category: REQUEST
                description: The campaign with campaign id {campaign_id} has ended.
                domain: API_MARKETING
              "35040":
                category: REQUEST
                description: "The inventory reference type is not valid. Valid values are: {inventoryReferenceTypeValues}."
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
              "36101":
                category: REQUEST
                description: This functionality is not supported for the CPC funding model.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Conflict
          x-response-codes:
            errors:
              "35061":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is being synced to match the specifications of the campaign. Please wait a few minutes and try the call again.
                domain: API_MARKETING
              "35063":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is ending soon. No update operations are allowed on this campaign until it ends.
                domain: API_MARKETING
              "35064":
                category: BUSINESS
                description: This operation is only supported for key based campaigns.
                domain: API_MARKETING
              "35071":
                category: BUSINESS
                description: You have exceeded the maximum number of listing IDs or inventory reference IDs. Only {maxSupportedNumber} IDs are supported per call.
                domain: API_MARKETING
              "35077":
                category: BUSINESS
                description: To use promoted listings, you need to improve your seller level to Top Rated or Above Standard and have enough recent sales activity.
                domain: API_MARKETING
              "35078":
                category: BUSINESS
                description: To gain access to Promoted Listings, you must be in good standing with recent sales activity.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - ad
  "/ad_campaign/{campaign_id}/bulk_update_ads_bid_by_inventory_reference":
    post:
      description: This method works with listings created with either the <a href="/Devzone/XML/docs/Reference/eBay/index.html" title="Trading API Reference">Trading API</a> or the <a href="/api-docs/sell/inventory/resources/methods" title="Inventory API Reference">Inventory API</a>.  <p>The method updates the <b>bidPercentage</b> values for a set of ads associated with the specified campaign.</p>  <p>Specify the <b>campaign_id</b> as a path parameter and supply a set of listing IDs with their associated updated <b>bidPercentage</b> values in the request body. An eBay listing ID is generated when a listing is created with the Trading API.</p>  <p>Get the campaign IDs for a seller by calling <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> and call <a href="/api-docs/sell/marketing/resources/ad/methods/getAds">getAds</a> to get a list of the seller's inventory reference IDs.</p><span class="tablenote"><b>Note:</b> This method only applies to the Cost Per Sale (CPS) funding model; it does not apply to the Cost Per Click (CPC) funding model. See <a href="/api-docs/sell/static/marketing/pl-overview.html#funding-model">Funding Models</a> in the <i>Promoted Listings Playbook</i> for more information.</span>
      operationId: bulkUpdateAdsBidByInventoryReference
      parameters:
        - description: A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get a seller's campaign IDs by calling <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a>.
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/BulkCreateAdsByInventoryReferenceRequest"
              description: This request object defines the fields for the <b>BulkCreateAdsByInventoryReference</b> request.
        description: This request object defines the fields for the <b>BulkCreateAdsByInventoryReference</b> request.
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/BulkUpdateAdsByInventoryReferenceResponse"
          description: Success
        "207":
          description: Multi Status
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35007":
                category: REQUEST
                description: "The 'bidPercentage' {bidPercentage} is not valid. The bid percentage should be a single precision value. Minimum value: {minBidPercent} , Maximum value:{maxBidPercent}."
                domain: API_MARKETING
              "35012":
                category: REQUEST
                description: The inventory reference ID {inventoryReferenceId} is not valid.
                domain: API_MARKETING
              "35018":
                category: REQUEST
                description: There are duplicate listing IDs or inventoryReference IDs in this request. You must remove the duplicate.
                domain: API_MARKETING
              "35033":
                category: REQUEST
                description: At least one request is required for bulk requests.
                domain: API_MARKETING
              "35035":
                category: REQUEST
                description: The campaign with campaign id {campaign_id} has ended.
                domain: API_MARKETING
              "35040":
                category: REQUEST
                description: "The inventory reference type is not valid. Valid values are: {inventoryReferenceTypeValues}."
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
              "36101":
                category: REQUEST
                description: This functionality is not supported for the CPC funding model.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Conflict
          x-response-codes:
            errors:
              "35061":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is being synced to match the specifications of the campaign. Please wait a few minutes and try the call again.
                domain: API_MARKETING
              "35063":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is ending soon. No update operations are allowed on this campaign until it ends.
                domain: API_MARKETING
              "35064":
                category: BUSINESS
                description: This operation is only supported for key based campaigns.
                domain: API_MARKETING
              "35071":
                category: BUSINESS
                description: You have exceeded the maximum number of listing IDs or inventory reference IDs. Only {maxSupportedNumber} IDs are supported per call.
                domain: API_MARKETING
              "35072":
                category: BUSINESS
                description: InventoryReferenceId {inventoryReferenceId} is not eligible for Promoted Listings because it is a variation and variations can only be promoted using the parent ID to which it belongs. Replace this ID with the InventoryReferenceId of the parent and set 'inventoryReferenceType' to 'INVENTORY_ITEM_GROUP'
                domain: API_MARKETING
              "35077":
                category: BUSINESS
                description: To use Promoted Listings, you need to improve your seller level to Top Rated or Above Standard and have enough recent sales activity.
                domain: API_MARKETING
              "35078":
                category: BUSINESS
                description: To gain access to Promoted Listings, you must be in good standing with recent sales activity.
                domain: API_MARKETING
              "35089":
                category: BUSINESS
                description: We are currently testing a premium ads product with a small invite-only group. We will share more information when we are ready to expand.
                domain: API_MARKETING
              "35113":
                category: BUSINESS
                description: This operation is not supported when selected adRateStratergy is DYNAMIC for the campaign.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - ad
  "/ad_campaign/{campaign_id}/bulk_update_ads_bid_by_listing_id":
    post:
      description: This method works with listings created with either the <a href="/Devzone/XML/docs/Reference/eBay/index.html" title="Trading API Reference">Trading API</a> or the <a href="/api-docs/sell/inventory/resources/methods" title="Inventory API Reference">Inventory API</a>.  <p>The method updates the <b>bidPercentage</b> values for a set of ads associated with the specified campaign.</p>  <p>Specify the <b>campaign_id</b> as a path parameter and supply a set of listing IDs with their associated updated <b>bidPercentage</b> values in the request body. An eBay listing ID is generated when a listing is created with the Trading API.</p>  <p>Get the campaign IDs for a seller by calling <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> and call <a href="/api-docs/sell/marketing/resources/ad/methods/getAds">getAds</a> to get a list of the seller's inventory reference IDs.</p><span class="tablenote"><b>Note:</b> This method only applies to the Cost Per Sale (CPS) funding model; it does not apply to the Cost Per Click (CPC) funding model. See <a href="/api-docs/sell/static/marketing/pl-overview.html#funding-model">Funding Models</a> in the <i>Promoted Listings Playbook</i> for more information.</span>
      operationId: bulkUpdateAdsBidByListingId
      parameters:
        - description: A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get a seller's campaign IDs by calling <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a>.
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/BulkCreateAdRequest"
              description: This request object defines the fields for the <b>BulkCreateAdsByListingId</b> request.
        description: This request object defines the fields for the <b>BulkCreateAdsByListingId</b> request.
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/BulkAdUpdateResponse"
          description: Success
        "207":
          description: Multi Status
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35007":
                category: REQUEST
                description: "The 'bidPercentage' {bidPercentage} is not valid. The bid percentage should be a single precision value. Minimum value: {minBidPercent} , Maximum value:{maxBidPercent}."
                domain: API_MARKETING
              "35013":
                category: REQUEST
                description: The listing ID {listingId} is not valid.
                domain: API_MARKETING
              "35014":
                category: REQUEST
                description: The listing Id is required for this call.
                domain: API_MARKETING
              "35018":
                category: REQUEST
                description: There are duplicate listing IDs or inventoryReference IDs in this request. You must remove the duplicate.
                domain: API_MARKETING
              "35033":
                category: REQUEST
                description: At least one request is required for bulk requests.
                domain: API_MARKETING
              "35035":
                category: REQUEST
                description: The campaign with campaign id {campaign_id} has ended.
                domain: API_MARKETING
              "35044":
                category: REQUEST
                description: No Ad found for 'ad_id' {ad_id}. Please correct the 'ad_id' and try again.
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
              "35048":
                category: REQUEST
                description: The listing ID {listingId} is invalid or has ended.
                domain: API_MARKETING
              "36101":
                category: REQUEST
                description: This functionality is not supported for the CPC funding model.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Business error
          x-response-codes:
            errors:
              "35052":
                category: BUSINESS
                description: The category {categoryId}  is not supported by the Promoted Listing service for multi-quantity listings.
                domain: API_MARKETING
              "35058":
                category: BUSINESS
                description: The listing ID {listingId} is not a fixed price item. This is a requirement for a promoted listing.
                domain: API_MARKETING
              "35059":
                category: BUSINESS
                description: The listing ID {listingId} is not a multi-quantity item. This is a requirement for a promoted listing.
                domain: API_MARKETING
              "35061":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is being synced to match the specifications of the campaign. Please wait a few minutes and try the call again.
                domain: API_MARKETING
              "35063":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is ending soon. No update operations are allowed on this campaign until it ends.
                domain: API_MARKETING
              "35064":
                category: BUSINESS
                description: This operation is only supported for key based campaigns.
                domain: API_MARKETING
              "35071":
                category: BUSINESS
                description: You have exceeded the maximum number of listing IDs or inventory reference IDs. Only {maxSupportedNumber} IDs are supported per call.
                domain: API_MARKETING
              "35075":
                category: BUSINESS
                description: The category {categoryId} is not supported by the Promoted Listing service for single-quantity listings.
                domain: API_MARKETING
              "35077":
                category: BUSINESS
                description: To use Promoted Listings, you need to improve your seller level to Top Rated or Above Standard and have enough recent sales activity.
                domain: API_MARKETING
              "35078":
                category: BUSINESS
                description: To gain access to Promoted Listings, you must be in good standing with recent sales activity.
                domain: API_MARKETING
              "35089":
                category: BUSINESS
                description: We are currently testing a premium ads product with a small invite-only group. We will share more information when we are ready to expand.
                domain: API_MARKETING
              "35113":
                category: BUSINESS
                description: This operation is not supported when selected adRateStratergy is DYNAMIC for the campaign.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - ad
  "/ad_campaign/{campaign_id}/bulk_update_ads_status":
    post:
      description: <span class="tablenote"><b>Note:</b> This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program. For information about how to request access to this program, refer to <a href="/api-docs/sell/static/marketing/pl-verify-eligibility.html#access-requests " target="_blank "> Promoted Listings Advanced Access Requests</a> in the Promoted Listings Playbook. To determine if a seller qualifies for PLA, use the <a href="/api-docs/sell/account/resources/advertising_eligibility/methods/getAdvertisingEligibility " target="_blank ">getAdvertisingEligibility</a> method in Account API.</span><br />This method works with listings created with either the <a href= "/Devzone/XML/docs/Reference/eBay/index.html">Trading API</a> or the <a href="/api-docs/sell/inventory/resources/methods">Inventory API</a>.<br /><br />This method updates the status of ads in bulk.<br /><br />Specify the <b>campaign_id</b> you want to update as a URI parameter, and configure the <b>adGroupStatus</b> in the request payload.
      operationId: bulkUpdateAdsStatus
      parameters:
        - description: A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.<br /><br /><span class="tablenote"><b>Note:</b> You can retrieve the campaign IDs for a specified seller using the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method.</span>
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/BulkUpdateAdStatusRequest"
              description: The bulk request to update the ads.
        description: The bulk request to update the ads.
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/BulkAdUpdateStatusResponse"
          description: Success
        "207":
          description: Multi Status
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35033":
                category: REQUEST
                description: At least one request is required for bulk requests.
                domain: API_MARKETING
              "35035":
                category: REQUEST
                description: The campaign with campaign id {campaign_id} has ended.
                domain: API_MARKETING
              "35044":
                category: REQUEST
                description: No Ad found for 'ad_id' {ad_id}. Please correct the 'ad_id' and try again.
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
              "35083":
                category: REQUEST
                description: The requested 'adStatus' is not valid.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Conflict
          x-response-codes:
            errors:
              "35052":
                category: BUSINESS
                description: The category {categoryId}  is not supported by the Promoted Listing service for multi-quantity listings.
                domain: API_MARKETING
              "35061":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is being synced to match the specifications of the campaign. Please wait a few minutes and try the call again.
                domain: API_MARKETING
              "35063":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is ending soon. No update operations are allowed on this campaign until it ends.
                domain: API_MARKETING
              "35064":
                category: BUSINESS
                description: This operation is only supported for key based campaigns.
                domain: API_MARKETING
              "35071":
                category: BUSINESS
                description: You have exceeded the maximum number of listing Ids or inventory reference Ids. Only {maxSupportedNumber} Ids are supported per call.
                domain: API_MARKETING
              "35077":
                category: BUSINESS
                description: To use promoted listings, you need to improve your seller level to Top Rated or Above Standard and have enough recent sales activity.
                domain: API_MARKETING
              "35078":
                category: BUSINESS
                description: To gain access to Promoted Listings, you must be in good standing with recent sales activity.
                domain: API_MARKETING
              "35089":
                category: BUSINESS
                description: We are currently testing a premium ads product with a small invite-only group. We will share more information when we are ready to expand.
                domain: API_MARKETING
              "36160":
                category: BUSINESS
                description: This functionality is only supported for CPC funding model.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - ad
  "/ad_campaign/{campaign_id}/bulk_update_ads_status_by_listing_id":
    post:
      description: <span class="tablenote"><b>Note:</b> This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program. For information about how to request access to this program, refer to <a href="/api-docs/sell/static/marketing/pl-verify-eligibility.html#access-requests " target="_blank "> Promoted Listings Advanced Access Requests</a> in the Promoted Listings Playbook. To determine if a seller qualifies for PLA, use the <a href="/api-docs/sell/account/resources/advertising_eligibility/methods/getAdvertisingEligibility " target="_blank ">getAdvertisingEligibility</a> method in Account API.</span><br />This method works with listings created with either the <a href="/Devzone/XML/docs/Reference/eBay/index.html">Trading API</a> or the <a href="/api-docs/sell/inventory/resources/methods">Inventory API</a>.<br /><br />The method updates the status of ads in bulk, based on listing ID values.<br /><br />Specify the <b>campaign_id</b> as a path parameter and supply a set of listing IDs with their updated <b>adStatus</b> values in the request body. An eBay listing ID is generated when a listing is created with the Trading API.<br /><br />Get the campaign IDs for a seller by calling <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> and call <a href="/api-docs/sell/marketing/resources/ad/methods/getAds">getAds</a> to retrieve a list of seller inventory reference IDs.
      operationId: bulkUpdateAdsStatusByListingId
      parameters:
        - description: A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.<br /><br /><span class="tablenote"><b>Note:</b> You can retrieve the campaign IDs for a specified seller using the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method.</span>
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/BulkUpdateAdStatusByListingIdRequest"
              description: The bulk request to update ads.
        description: The bulk request to update ads.
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/BulkAdUpdateStatusByListingIdResponse"
          description: Success
        "207":
          description: Multi Status
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35013":
                category: REQUEST
                description: The listing Id {listingId} is not valid.
                domain: API_MARKETING
              "35014":
                category: REQUEST
                description: The listing Id is required for this call.
                domain: API_MARKETING
              "35018":
                category: REQUEST
                description: There are duplicate listing Ids or inventoryReference Ids in this request. You must remove the duplicate.
                domain: API_MARKETING
              "35033":
                category: REQUEST
                description: At least one request is required for bulk requests.
                domain: API_MARKETING
              "35035":
                category: REQUEST
                description: The campaign with campaign id {campaign_id} has ended.
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
              "35048":
                category: REQUEST
                description: The listing Id {listingId} is invalid or has ended.
                domain: API_MARKETING
              "35083":
                category: REQUEST
                description: The requested 'adStatus' is not valid.
                domain: API_MARKETING
              "36210":
                category: REQUEST
                description: No ad group found for ad group id {ad_group_id}.
                domain: API_MARKETING
              "36219":
                category: REQUEST
                description: The ad group with ad group id {ad_group_id} has been archived.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Conflict
          x-response-codes:
            errors:
              "35052":
                category: BUSINESS
                description: The category {categoryId}  is not supported by the Promoted Listing service for multi-quantity listings.
                domain: API_MARKETING
              "35058":
                category: BUSINESS
                description: The listing Id {listingId} is not a fixed price item. This is a requirement for a promoted listing.
                domain: API_MARKETING
              "35059":
                category: BUSINESS
                description: The listing Id {listingId} is not a multi-quantity item. This is a requirement for a promoted listing.
                domain: API_MARKETING
              "35061":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is being synced to match the specifications of the campaign. Please wait a few minutes and try the call again.
                domain: API_MARKETING
              "35063":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is ending soon. No update operations are allowed on this campaign until it ends.
                domain: API_MARKETING
              "35064":
                category: BUSINESS
                description: This operation is only supported for key based campaigns.
                domain: API_MARKETING
              "35071":
                category: BUSINESS
                description: You have exceeded the maximum number of listing Ids or inventory reference Ids. Only {maxSupportedNumber} Ids are supported per call.
                domain: API_MARKETING
              "35075":
                category: BUSINESS
                description: The category {categoryId} is not supported by the Promoted Listing service for single-quantity listings.
                domain: API_MARKETING
              "35077":
                category: BUSINESS
                description: To use promoted listings, you need to improve your seller level to Top Rated or Above Standard and have enough recent sales activity.
                domain: API_MARKETING
              "35078":
                category: BUSINESS
                description: To gain access to Promoted Listings, you must be in good standing with recent sales activity.
                domain: API_MARKETING
              "35084":
                category: BUSINESS
                description: The Ad associated with listing Id {listingId} is archived.
                domain: API_MARKETING
              "35085":
                category: BUSINESS
                description: The 'adGroupId' {ad_group_id} does not exist under campaign {campaign_id}.
                domain: API_MARKETING
              "35089":
                category: BUSINESS
                description: We are currently testing a premium ads product with a small invite-only group. We will share more information when we are ready to expand.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - ad
  "/ad_campaign/{campaign_id}/bulk_update_keyword":
    post:
      description: <span class="tablenote"><b>Note:</b> This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program. For information about how to request access to this program, refer to <a href="/api-docs/sell/static/marketing/pl-verify-eligibility.html#access-requests " target="_blank "> Promoted Listings Advanced Access Requests</a> in the Promoted Listings Playbook. To determine if a seller qualifies for PLA, use the <a href="/api-docs/sell/account/resources/advertising_eligibility/methods/getAdvertisingEligibility " target="_blank ">getAdvertisingEligibility</a> method in Account API.</span><br />This method updates the bids and statuses of keywords, in bulk, for an existing PLA campaign.<br /><br />In the request, supply the <b>campaign_id</b> as a path parameter.<br /><br />Call the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method to retrieve a list of current campaign IDs for a specified seller.
      operationId: bulkUpdateKeyword
      parameters:
        - description: A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.<br /><br /><span class="tablenote"><b>Note:</b> You can retrieve the campaign IDs for a specified seller using the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method.</span>
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/BulkUpdateKeywordRequest"
              description: A type that defines the fields for the bulk request to update keywords.
        description: A type that defines the fields for the bulk request to update keywords.
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/BulkUpdateKeywordResponse"
          description: Success
        "207":
          description: Multi Status
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35035":
                category: REQUEST
                description: The campaign with campaign id {campaign_id} has ended.
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
              "36305":
                category: REQUEST
                description: The 'bid' value {bidValue} is not valid. The default bid value should be a double precision value.
                domain: API_MARKETING
              "36306":
                category: REQUEST
                description: The 'bid' value {bidValue} is below floor value {bidFloorValue}.
                domain: API_MARKETING
              "36307":
                category: REQUEST
                description: The 'bid' value {bidValue} is above max value {bidMaxValue}.
                domain: API_MARKETING
              "36308":
                category: REQUEST
                description: The 'bid' currency {bidCurrency} is not valid or missing.
                domain: API_MARKETING
              "36309":
                category: REQUEST
                description: The 'bid' currency {bidCurrency} should be the same as the daily budget.
                domain: API_MARKETING
              "36310":
                category: REQUEST
                description: No keyword found for keyword id {keyword_id}.
                domain: API_MARKETING
              "36313":
                category: REQUEST
                description: The 'bid' value {bidValue} is more than maximum daily budget {maxDailyBudget}.
                domain: API_MARKETING
              "36317":
                category: REQUEST
                description: The 'bid' or 'keywordStatus' is missing, either one is required for update.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Conflict
          x-response-codes:
            errors:
              "35089":
                category: BUSINESS
                description: We are currently testing a premium ads product with a small invite-only group. We will share more information when we are ready to expand.
                domain: API_MARKETING
              "36316":
                category: BUSINESS
                description: You have exceeded the maximum number of Keyword requests in a bulk. Only {maxSupportedNumberInBulk} Ids are supported per call.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - keyword
  "/ad_campaign/{campaign_id}/clone":
    post:
      description: "This method clones (makes a copy of) the specified campaign's <b>campaign criterion</b>. The <b>campaign criterion</b> is a container for the fields that define the criteria for a rule-based campaign.<p>To clone a campaign, supply the <b>campaign_id</b> as a path parameter in your call. There is no request payload.</p>  <p>The ID of the newly-cloned campaign is returned in the <b>Location</b> response header.</p><p>Call <a href=\"/api-docs/sell/marketing/resources/campaign/methods/getCampaigns\">getCampaigns</a> to retrieve a seller's current campaign IDs.</p>  <p><b>Requirement: </b>In order to clone a campaign, the <b>campaignStatus</b> must be <code>ENDED</code> and the campaign must define a set of selection rules (it must be a rules-based campaign).</p><span class=\"tablenote\"><b>Note:</b> This method only applies to the Cost Per Sale (CPS) funding model; it does not apply to the Cost Per Click (CPC) funding model. See <a href=\"/api-docs/sell/static/marketing/pl-overview.html#funding-model\">Funding Models</a> in the <i>Promoted Listings Playbook</i> for more information.</span>"
      operationId: cloneCampaign
      parameters:
        - description: A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. This ID is the campaign ID of the campaign being cloned.<br /><br /><span class="tablenote"><b>Note:</b> You can retrieve the campaign IDs for a specified seller using the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method.</span>
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/CloneCampaignRequest"
              description: This type defines the fields for a clone campaign request.
        description: This type defines the fields for a clone campaign request.
        required: true
      responses:
        "201":
          content:
            application/json:
              schema:
                type: object
          description: Success
          headers:
            Location:
              schema:
                description: The <b>location</b> response header contains the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaign">getCampaign</a> URI to the retrieve the newly created campaign.
                type: string
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35006":
                category: REQUEST
                description: "'fundingStrategy' is required for this call."
                domain: API_MARKETING
              "35007":
                category: REQUEST
                description: "The 'bidPercentage' {bidPercentage} is not valid. The bid percentage should be a single precision value. Minimum value: {minBidPercent} , Maximum value:{maxBidPercent}."
                domain: API_MARKETING
              "35019":
                category: REQUEST
                description: Campaign name is required for this call.
                domain: API_MARKETING
              "35020":
                category: REQUEST
                description: The campaign name cannot be more than {maxCampaignNameLength} characters.
                domain: API_MARKETING
              "35021":
                category: REQUEST
                description: A campaign with the name of {campaignName} already exists. Please provide a different name.
                domain: API_MARKETING
              "35023":
                category: REQUEST
                description: The request contains invalid characters. {notAllowedCharacters} are not allowed.
                domain: API_MARKETING
              "35024":
                category: REQUEST
                description: The campaign start date {startDate} cannot be after the end date {endDate}.
                domain: API_MARKETING
              "35025":
                category: REQUEST
                description: A campaign start date is required.
                domain: API_MARKETING
              "35026":
                category: REQUEST
                description: A campaign start or end date {date} cannot be in the past.
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
              "36101":
                category: REQUEST
                description: This functionality is not supported for the CPC funding model.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Conflict
          x-response-codes:
            errors:
              "35062":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} has not ended yet. cloneCampaign is supported only for criterion based campaigns that have ended.
                domain: API_MARKETING
              "35065":
                category: BUSINESS
                description: This operation is only supported for criterion based campaigns.
                domain: API_MARKETING
              "35077":
                category: BUSINESS
                description: To use Promoted Listings, you need to improve your seller level to Top Rated or Above Standard and have enough recent sales activity.
                domain: API_MARKETING
              "35078":
                category: BUSINESS
                description: To gain access to Promoted Listings, you must be in good standing with recent sales activity.
                domain: API_MARKETING
              "35089":
                category: BUSINESS
                description: We are currently testing a premium ads product with a small invite-only group. We will share more information when we are ready to expand.
                domain: API_MARKETING
              "35106":
                category: BUSINESS
                description: "'BidPercentage' should be provided when selected 'adRateStrategy' is 'FIXED'."
                domain: API_MARKETING
              "35107":
                category: BUSINESS
                description: "'dynamicAdRatePreferences' can be provided only when selected 'adRateStrategy' is 'DYNAMIC'."
                domain: API_MARKETING
              "35108":
                category: BUSINESS
                description: The 'adRateAdjustmentPercent' {adRateAdjustmentPercent} is not valid. Please set 'adRateAdjustmentPercent' {adRateAdjustmentPercent} between {minAllowedAdRateAdjustmentPercent}% - {maxAllowedAdRateAdjustmentPercent}%.
                domain: API_MARKETING
              "35109":
                category: BUSINESS
                description: The 'adRateCapPercent' {adRateCapPercent} is not valid. Please set 'adRateCapPercent' between {minAllowedAdRateCapPercent}% - {maxAllowedAdRateCapPercent}%.
                domain: API_MARKETING
              "35110":
                category: BUSINESS
                description: The 'adRateStrategy' is not supported for CPC funding model.
                domain: API_MARKETING
              "35111":
                category: BUSINESS
                description: The 'dynamicAdRatePreferences' is not supported for CPC funding model.
                domain: API_MARKETING
              "35112":
                category: BUSINESS
                description: The 'adRateStrategy' is currently only supported for criterion based campaign with 'autoselectFutureInventory' as True.
                domain: API_MARKETING
              "35113":
                category: BUSINESS
                description: The 'dynamicAdRatePreferences' is currently only supported for criterion based campaign with 'autoselectFutureInventory' as True.
                domain: API_MARKETING
              "35114":
                category: BUSINESS
                description: The 'dynamicAdRatePreferences' list currently can only support one element containing dynamicAdRatePreference. Please remove additional elements and try again.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - campaign
  "/ad_campaign/{campaign_id}/create_ads_by_inventory_reference":
    post:
      description: This method adds a listing that is managed with the <a href="/api-docs/sell/inventory/resources/methods" title="Inventory API Reference">Inventory API</a> to an existing Promoted Listings campaign.<br /><br />For Promoted Listings Standard (PLS) campaigns using the Cost Per Sale (CPS) funding model, an ad may be directly created for the listing.<br /><br />For each listing specified in the request, this method:<br /><ul><li>Creates an ad for the listing.</li> <li>Sets the bid percentage (also known as the <i>ad rate</i>) for the ads created.</li> <li>Associates the created ad with the specified campaign.</li></ul><br />To create an ad for a listing, specify its <b>inventoryReferenceId</b> and <b>inventoryReferenceType</b>, plus the <b>bidPercentage</b> for the ad in the payload of the request. Specify the campaign to associate the ad with using the <b>campaign_id</b> path parameter.<br /><br /><span class="tablenote"><b>Note:</b> This method only applies to the Cost Per Sale (CPS) funding model; it does not apply to the Cost Per Click (CPC) funding model. See <a href="/api-docs/sell/static/marketing/pl-overview.html#funding-model">Funding Models</a> in the <i>Promoted Listings Playbook</i> for more information.</span><br /><br />Use <a href="/api-docs/sell/marketing/resources/campaign/methods/createCampaign">createCampaign</a> to create a new campaign and use <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> to get a list of existing campaigns.
      operationId: createAdsByInventoryReference
      parameters:
        - description: A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.<br /><br /><span class="tablenote"><b>Note:</b> You can retrieve the campaign IDs for a specified seller using the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method.</span>
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/CreateAdsByInventoryReferenceRequest"
              description: This request object defines the fields used in the <b>createAdsByInventoryReference</b> request.
        description: This request object defines the fields used in the <b>createAdsByInventoryReference</b> request.
        required: true
      responses:
        "201":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AdReferences"
          description: Created
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35007":
                category: REQUEST
                description: "The 'bidPercentage' {bidPercentage} is not valid. The bid percentage should be a single precision value. Minimum value: {minBidPercent} , Maximum value:{maxBidPercent}."
                domain: API_MARKETING
              "35010":
                category: REQUEST
                description: The bidPercentage should not be provided when selected adRateStrategy is DYNAMIC for the campaign.
                domain: API_MARKETING
              "35012":
                category: REQUEST
                description: The inventory reference ID {inventoryReferenceId} is not valid.
                domain: API_MARKETING
              "35035":
                category: REQUEST
                description: The campaign with campaign id {campaign_id} has ended.
                domain: API_MARKETING
              "35040":
                category: REQUEST
                description: "The inventory reference type is not valid. Valid values are: {inventoryReferenceTypeValues}."
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
              "35080":
                category: REQUEST
                description: The 'bidPercentage' is not supported for CPC funding model
                domain: API_MARKETING
              "36106":
                category: REQUEST
                description: The 'adGroupId' is not supported for CPS funding model.
                domain: API_MARKETING
              "36210":
                category: REQUEST
                description: No ad group found for ad group id {ad_group_id}.
                domain: API_MARKETING
              "36219":
                category: REQUEST
                description: The ad group with ad group id {ad_group_id} has been archived.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Conflict
          x-response-codes:
            errors:
              "35061":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is being synced to match the specifications of the campaign. Please wait a few minutes and try the call again.
                domain: API_MARKETING
              "35063":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is ending soon. No update operations are allowed on this campaign until it ends.
                domain: API_MARKETING
              "35064":
                category: BUSINESS
                description: This operation is only supported for key based campaigns.
                domain: API_MARKETING
              "35072":
                category: BUSINESS
                description: InventoryReferenceId {inventoryReferenceId} is not eligible for Promoted Listings because it is a variation and variations can only be promoted using the parent ID to which it belongs. Replace this ID with the InventoryReferenceId of the parent and set 'inventoryReferenceType' to 'INVENTORY_ITEM_GROUP'
                domain: API_MARKETING
              "35077":
                category: BUSINESS
                description: To use Promoted Listings, you need to improve your seller level to Top Rated or Above Standard and have enough recent sales activity.
                domain: API_MARKETING
              "35078":
                category: BUSINESS
                description: To gain access to Promoted Listings, you must be in good standing with recent sales activity.
                domain: API_MARKETING
              "35089":
                category: BUSINESS
                description: We are currently testing a premium ads product with a small invite-only group. We will share more information when we are ready to expand.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - ad
  "/ad_campaign/{campaign_id}/delete_ads_by_inventory_reference":
    post:
      description: This method works with listings that are managed with the <a href="/api-docs/sell/inventory/resources/methods" title="Inventory API Reference">Inventory API</a>.  <p>The method deletes ads using a list of seller-defined inventory reference IDs, used with the Inventory API, that are associated with the specified campaign ID.</p> <p>Specify the campaign ID (as a path parameter) and a list of <b>inventoryReferenceId</b> and <b>inventoryReferenceType</b> pairs to be deleted.</p>  <p>Call <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> to get a list of the seller's current campaign IDs.</p><span class="tablenote"><b>Note:</b> This method only applies to the Cost Per Sale (CPS) funding model; it does not apply to the Cost Per Click (CPC) funding model. See <a href="/api-docs/sell/static/marketing/pl-overview.html#funding-model">Funding Models</a> in the <i>Promoted Listings Playbook</i> for more information.</span><br /><br />When using the CPC funding model, use the bulkUpdateAdsStatusByInventoryReference method to change the status of ads to ARCHIVED.
      operationId: deleteAdsByInventoryReference
      parameters:
        - description: A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.<br /><br /><span class="tablenote"><b>Note:</b> You can retrieve the campaign IDs for a specified seller using the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method.</span>
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/DeleteAdsByInventoryReferenceRequest"
              description: This request object defines the fields for the <b>deleteAdsByInventoryReference</b> request.
        description: This request object defines the fields for the <b>deleteAdsByInventoryReference</b> request.
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AdIds"
          description: Success
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35012":
                category: REQUEST
                description: The inventory reference ID {inventoryReferenceId} is not valid.
                domain: API_MARKETING
              "35035":
                category: REQUEST
                description: The campaign with campaign id {campaign_id} has ended.
                domain: API_MARKETING
              "35040":
                category: REQUEST
                description: "The inventory reference type is not valid. Valid values are: {inventoryReferenceTypeValues}."
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
              "36101":
                category: REQUEST
                description: This functionality is not supported for the CPC funding model.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Conflict
          x-response-codes:
            errors:
              "35061":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is being synced to match the specifications of the campaign. Please wait a few minutes and try the call again.
                domain: API_MARKETING
              "35063":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is ending soon. No update operations are allowed on this campaign until it ends.
                domain: API_MARKETING
              "35064":
                category: BUSINESS
                description: This operation is only supported for key based campaigns.
                domain: API_MARKETING
              "35072":
                category: BUSINESS
                description: InventoryReferenceId {inventoryReferenceId} is not eligible for Promoted Listings because it is a variation and variations can only be promoted using the parent ID to which it belongs. Replace this ID with the inventoryReferenceId of the parent and set 'inventoryReferenceType' to 'INVENTORY_ITEM_GROUP'
                domain: API_MARKETING
              "35077":
                category: BUSINESS
                description: To use Promoted Listings, you need to improve your seller level to Top Rated or Above Standard and have enough recent sales activity.
                domain: API_MARKETING
              "35078":
                category: BUSINESS
                description: To gain access to Promoted Listings, you must be in good standing with recent sales activity.
                domain: API_MARKETING
              "35089":
                category: BUSINESS
                description: We are currently testing a premium ads product with a small invite-only group. We will share more information when we are ready to expand.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - ad
  "/ad_campaign/{campaign_id}/end":
    post:
      description: This method ends an active (<code>RUNNING</code>) or paused campaign. Specify the campaign you want to end by supplying its campaign ID in a query parameter.  <p>Call <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> to retrieve the <b>campaign_id</b> and the campaign status (<code>RUNNING</code>, <code>PAUSED</code>, <code>ENDED</code>, and so on) for all the seller's campaigns.</p>
      operationId: endCampaign
      parameters:
        - description: A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.<br /><br /><span class="tablenote"><b>Note:</b> You can retrieve the campaign IDs for a specified seller using the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method.</span>
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
      responses:
        "204":
          description: No Content
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35035":
                category: REQUEST
                description: The campaign with campaign id {campaign_id} has ended.
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Business error
          x-response-codes:
            errors:
              "35056":
                category: BUSINESS
                description: The state of the campaign cannot be changed as requested.
                domain: API_MARKETING
              "35061":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is being synced to match the specifications of the campaign. Please wait a few minutes and try the call again.
                domain: API_MARKETING
              "35063":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is ending soon. No update operations are allowed on this campaign until it ends.
                domain: API_MARKETING
              "35077":
                category: BUSINESS
                description: To use Promoted Listings, you need to improve your seller level to Top Rated or Above Standard and have enough recent sales activity.
                domain: API_MARKETING
              "35078":
                category: BUSINESS
                description: To gain access to Promoted Listings, you must be in good standing with recent sales activity.
                domain: API_MARKETING
              "35089":
                category: BUSINESS
                description: We are currently testing a premium ads product with a small invite-only group. We will share more information when we are ready to expand.
                domain: API_MARKETING
        "500":
          description: Internal Server error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - campaign
  "/ad_campaign/{campaign_id}/get_ads_by_inventory_reference":
    get:
      description: This method retrieves Promoted Listings ads associated with listings that are managed with the <a href="/api-docs/sell/inventory/resources/methods" title="Inventory API Reference">Inventory API</a> from the specified campaign.<br /><br />Supply the <b>campaign_id</b> as a path parameter and use query parameters to specify the <b>inventory_reference_id</b> and <b>inventory_reference_type</b> pairs.<br /><br />In the Inventory API, an <i>inventory reference ID</i> is either a seller-defined <b>SKU</b> value or an <b>inventoryItemGroupKey</b> (a seller-defined ID for an inventory item group, which is an entity that's used in the Inventory API to create a multiple-variation listing). To indicate a listing managed by the Inventory API, you must always specify both an <b>inventory_reference_id</b> and the associated <b>inventory_reference_type</b>.<br /><br />Call <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> to retrieve all of the seller's the current campaign IDs.<br /><br /><span class="tablenote"><b>Note:</b> This method only applies to the Cost Per Sale (CPS) funding model; it does not apply to the Cost Per Click (CPC) funding model. See <a href="/api-docs/sell/static/marketing/pl-overview.html#funding-model">Funding Models</a> in the <i>Promoted Listings Playbook</i> for more information.</span>
      operationId: getAdsByInventoryReference
      parameters:
        - description: A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.<br /><br /><span class="tablenote"><b>Note:</b> You can retrieve the campaign IDs for a specified seller using the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method.</span>
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
        - description: The inventory reference ID associated with the ad you want returned. A seller's inventory reference ID is the ID of either a listing or the ID of an inventory item group (the parent of a multi-variation listing, such as a shirt that is available in multiple sizes and colors). You must always supply in both an <b>inventory_reference_id</b> and an <b>inventory_reference_type</b>.
          in: query
          name: inventory_reference_id
          required: true
          schema:
            type: string
        - description: "The type of the inventory reference ID. Set this value to either <code>INVENTORY_ITEM</CODE> (a single listing) or <code>INVENTORY_ITEM_GROUP</CODE> (a multi-variation listing). You must always pass in both an <b>inventory_reference_id</b> and an <b>inventory_reference_type</b>. "
          in: query
          name: inventory_reference_type
          required: true
          schema:
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Ads"
          description: Success
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35012":
                category: REQUEST
                description: The inventory reference ID {inventoryReferenceId} is not valid.
                domain: API_MARKETING
              "35035":
                category: REQUEST
                description: The campaign with campaign id {campaign_id} has ended.
                domain: API_MARKETING
              "35040":
                category: REQUEST
                description: "The inventory reference type is not valid. Valid values are: {inventoryReferenceTypeValues}."
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
              "36106":
                category: REQUEST
                description: The 'adGroupId' is not supported for CPS funding model.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Business error
          x-response-codes:
            errors:
              "35064":
                category: BUSINESS
                description: This operation is only supported for key based campaigns.
                domain: API_MARKETING
              "35077":
                category: BUSINESS
                description: To use promoted listings, you need to improve your seller level to Top Rated or Above Standard and have enough recent sales activity.
                domain: API_MARKETING
        "500":
          description: Internal Server error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing.readonly
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - ad
  "/ad_campaign/{campaign_id}/keyword":
    get:
      description: <span class="tablenote"><b>Note:</b> This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program. For information about how to request access to this program, refer to <a href="/api-docs/sell/static/marketing/pl-verify-eligibility.html#access-requests " target="_blank "> Promoted Listings Advanced Access Requests</a> in the Promoted Listings Playbook. To determine if a seller qualifies for PLA, use the <a href="/api-docs/sell/account/resources/advertising_eligibility/methods/getAdvertisingEligibility " target="_blank ">getAdvertisingEligibility</a> method in Account API.</span><br />This method can be used to retrieve all of the keywords for ad groups in PLA campaigns that use the Cost Per Click (CPC) funding model.<br /><br />In the request, specify the <b>campaign_id</b> as a path parameter. If one or more <b>ad_group_ids</b> are passed in the request body, the keywords for those ad groups will be returned. If <b>ad_group_ids</b> are not passed in the response body, the call will return all the keywords in the campaign.<br /><br />Call the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method to retrieve a list of current campaign IDs for a seller.
      operationId: getKeywords
      parameters:
        - description: A comma-separated list of ad group IDs. This query parameter is used if the seller wants to retrieve keywords from one or more specific ad groups. If this query parameter is not used, all keywords that are part of the CPC campaign are returned.<span class="tablenote"><b>Note:</b>You can call the <a href="/api-docs/sell/marketing/resources/adgroup/methods/getAdGroups">getAdGroups</a>  method to retrieve the ad group IDs for a seller.</span>
          in: query
          name: ad_group_ids
          required: false
          schema:
            type: string
        - description: A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.<br /><br /><span class="tablenote"><b>Note:</b> You can retrieve the campaign IDs for a specified seller using the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method.</span>
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
        - description: A comma-separated list of keyword statuses. The results will be filtered to only include the given statuses of the keyword. If none are provided, all keywords are returned.
          in: query
          name: keyword_status
          required: false
          schema:
            type: string
        - description: "<p>Specifies the maximum number of results to return on a page in the paginated response.</p>  <b>Default: </b>10 <br><b>Maximum: </b> 500"
          in: query
          name: limit
          required: false
          schema:
            type: string
        - description: Specifies the number of results to skip in the result set before returning the first report in the paginated response.  <p>Combine <b>offset</b> with the <b>limit</b> query parameter to control the items returned in the response. For example, if you supply an <b>offset</b> of <code>0</code> and a <b>limit</b> of <code>10</code>, the first page of the response contains the first 10 items from the complete list of items retrieved by the call. If <b>offset</b> is <code>10</code> and <b>limit</b> is <code>20</code>, the first page of the response contains items 11-30 from the complete result set.</p> <p><b>Default:</b> 0</p>
          in: query
          name: offset
          required: false
          schema:
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/KeywordPagedCollectionResponse"
          description: Success
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35029":
                category: REQUEST
                description: The 'limit' has to be greater than zero and less than {maxLimitValue}.
                domain: API_MARKETING
              "35030":
                category: REQUEST
                description: The 'offset' cannot be less than zero.
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
              "36314":
                category: REQUEST
                description: Ad Group Ids should be delimited by {adGroupIdsDelimiter}
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Business error
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing.readonly
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - keyword
    post:
      description: <span class="tablenote"><b>Note:</b> This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program. For information about how to request access to this program, refer to <a href="/api-docs/sell/static/marketing/pl-verify-eligibility.html#access-requests " target="_blank "> Promoted Listings Advanced Access Requests</a> in the Promoted Listings Playbook. To determine if a seller qualifies for PLA, use the <a href="/api-docs/sell/account/resources/advertising_eligibility/methods/getAdvertisingEligibility " target="_blank ">getAdvertisingEligibility</a> method in Account API.</span><br />This method creates keywords using a specified campaign ID for an existing PLA campaign.<br /><br />In the request, supply the <b>campaign_id</b> as a path parameter.<br /><br />Call the <a href="/api-docs/sell/marketing/resources/campaign/methods/suggestKeywords">suggestKeywords</a> method to retrieve a list of keyword ideas to be targeted for PLA campaigns, and call the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method to retrieve a list of current campaign IDs for a seller.
      operationId: createKeyword
      parameters:
        - description: A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.<br /><br /><span class="tablenote"><b>Note:</b> You can retrieve the campaign IDs for a specified seller using the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method.</span>
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/CreateKeywordRequest"
              description: A type that defines the fields for the request to create a keyword.
        description: A type that defines the fields for the request to create a keyword.
        required: true
      responses:
        "201":
          content:
            application/json:
              schema:
                type: object
          description: Created
          headers:
            Location:
              schema:
                description: The <b>location</b> response header contains the getKeyword URI of the newly created keyword.  The URI includes the newly created <code>keywordId</code>, which you can use to reference the keyword.
                type: string
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35035":
                category: REQUEST
                description: The campaign with campaign id {campaign_id} has ended.
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
              "36210":
                category: REQUEST
                description: No ad group found for ad group id {ad_group_id}.
                domain: API_MARKETING
              "36219":
                category: REQUEST
                description: The ad group with ad group id {ad_group_id} has been archived.
                domain: API_MARKETING
              "36301":
                category: REQUEST
                description: "The keyword match type {matchType} is not supported. Valid values are: {matchTypeValues}."
                domain: API_MARKETING
              "36303":
                category: REQUEST
                description: A keyword with text {keywordText} and match type {matchType} already exists for this Ad Group.
                domain: API_MARKETING
              "36304":
                category: REQUEST
                description: The keywordText {keywordText} cannot be more than {maxKeywordTextLength} characters.
                domain: API_MARKETING
              "36305":
                category: REQUEST
                description: The 'bid' value {bidValue} is not valid. The default bid value should be a double precision value.
                domain: API_MARKETING
              "36306":
                category: REQUEST
                description: The 'bid' value {bidValue} is below floor value {bidFloorValue}.
                domain: API_MARKETING
              "36307":
                category: REQUEST
                description: The 'bid' value {bidValue} is above max value {bidMaxValue}.
                domain: API_MARKETING
              "36308":
                category: REQUEST
                description: The 'bid' currency {bidCurrency} is not valid or missing.
                domain: API_MARKETING
              "36309":
                category: REQUEST
                description: The 'bid' currency {bidCurrency} should be the same as the daily budget.
                domain: API_MARKETING
              "36311":
                category: REQUEST
                description: The keywordText cannot be null or empty.
                domain: API_MARKETING
              "36312":
                category: REQUEST
                description: The keywordText contains invalid characters {invalidCharacters}
                domain: API_MARKETING
              "36313":
                category: REQUEST
                description: The 'bid' value {bidValue} is more than maximum daily budget {maxDailyBudget}.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Business error
          x-response-codes:
            errors:
              "35089":
                category: BUSINESS
                description: We are currently testing a premium ads product with a small invite-only group. We will share more information when we are ready to expand.
                domain: API_MARKETING
              "36319":
                category: BUSINESS
                description: You have exceeded the maximum number of create Keyword for an Ad Group. Only {maxSupportedNumber} Ids are supported per Ad Group.
                domain: API_MARKETING
              "36320":
                category: BUSINESS
                description: The keywordText {keywordText} cannot have total number of words more than {maxWordsInKeyword} words.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - keyword
  "/ad_campaign/{campaign_id}/keyword/{keyword_id}":
    get:
      description: <span class="tablenote"><b>Note:</b> This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program. For information about how to request access to this program, refer to <a href="/api-docs/sell/static/marketing/pl-verify-eligibility.html#access-requests " target="_blank "> Promoted Listings Advanced Access Requests</a> in the Promoted Listings Playbook. To determine if a seller qualifies for PLA, use the <a href="/api-docs/sell/account/resources/advertising_eligibility/methods/getAdvertisingEligibility " target="_blank ">getAdvertisingEligibility</a> method in Account API.</span><br />This method retrieves details on a specific keyword from an ad group within a PLA campaign that uses the Cost Per Click (CPC) funding model.<br /><br />In the request, specify the <b>campaign_id</b> and <b>keyword_id</b> as path parameters.<br /><br />Call the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method to retrieve a list of current campaign IDs for a seller and call the <a href="/api-docs/sell/marketing/resources/keyword/methods/getKeywords">getKeywords</a> method to retrieve their keyword IDs.
      operationId: getKeyword
      parameters:
        - description: A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.<br /><br /><span class="tablenote"><b>Note:</b> You can retrieve the campaign IDs for a specified seller using the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method.</span>
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
        - description: This path parameter is used to identify the keyword to retrieve.
          in: path
          name: keyword_id
          required: true
          schema:
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Keyword"
          description: Success
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
              "36310":
                category: REQUEST
                description: No keyword found for keyword id {keyword_id}.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Business error
        "500":
          description: Internal Server error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing.readonly
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - keyword
    put:
      description: <span class="tablenote"><b>Note:</b> This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program. For information about how to request access to this program, refer to <a href="/api-docs/sell/static/marketing/pl-verify-eligibility.html#access-requests " target="_blank "> Promoted Listings Advanced Access Requests</a> in the Promoted Listings Playbook. To determine if a seller qualifies for PLA, use the <a href="/api-docs/sell/account/resources/advertising_eligibility/methods/getAdvertisingEligibility " target="_blank ">getAdvertisingEligibility</a> method in Account API.</span><br />This method updates keywords using a campaign ID and keyword ID for an existing PLA campaign.<br /><br />In the request, specify the <b>campaign_id</b> and <b>keyword_id</b> as path parameters.<br /><br />Call the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method to retrieve a list of current campaign IDs for a seller and call the <a href="/api-docs/sell/marketing/resources/keyword/methods/getKeywords">getKeywords</a> method to retrieve their keyword IDs.
      operationId: updateKeyword
      parameters:
        - description: A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.<br /><br /><span class="tablenote"><b>Note:</b> You can retrieve the campaign IDs for a specified seller using the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method.</span>
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
        - description: A unique eBay-assigned ID that is generated when a keyword is created.
          in: path
          name: keyword_id
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/UpdateKeywordRequest"
              description: A type that defines the fields for the request to update a keyword.
        description: A type that defines the fields for the request to update a keyword.
        required: true
      responses:
        "204":
          description: Success
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35035":
                category: REQUEST
                description: The campaign with campaign id {campaign_id} has ended.
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
              "36305":
                category: REQUEST
                description: The 'bid' value {bidValue} is not valid. The default bid value should be a double precision value.
                domain: API_MARKETING
              "36306":
                category: REQUEST
                description: The 'bid' value {bidValue} is below floor value {bidFloorValue}.
                domain: API_MARKETING
              "36307":
                category: REQUEST
                description: The 'bid' value {bidValue} is above max value {bidMaxValue}.
                domain: API_MARKETING
              "36308":
                category: REQUEST
                description: The 'bid' currency {bidCurrency} is not valid or missing.
                domain: API_MARKETING
              "36309":
                category: REQUEST
                description: The 'bid' currency {bidCurrency} should be the same as the daily budget.
                domain: API_MARKETING
              "36310":
                category: REQUEST
                description: No keyword found for keyword id {keyword_id}.
                domain: API_MARKETING
              "36313":
                category: REQUEST
                description: The 'bid' value {bidValue} is more than maximum daily budget {maxDailyBudget}.
                domain: API_MARKETING
              "36317":
                category: REQUEST
                description: The 'bid' or 'keywordStatus' is missing, either one is required for update.
                domain: API_MARKETING
              "36318":
                category: REQUEST
                description: The keyword with 'keyword_id' {keyword_Id} is already archived and cannot be updated.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Conflict
          x-response-codes:
            errors:
              "35089":
                category: BUSINESS
                description: We are currently testing a premium ads product with a small invite-only group. We will share more information when we are ready to expand.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - keyword
  "/ad_campaign/{campaign_id}/pause":
    post:
      description: "This method pauses an active (RUNNING) campaign.  <p>You can restart the campaign by calling <a href=\"/api-docs/sell/marketing/resources/campaign/methods/resumeCampaign\">resumeCampaign</a>, as long as the campaign's end date is in the future.</p>  <p><b>Note: </b> The listings associated with a paused campaign cannot be added into another campaign.</p>  <p>Call <a href=\"/api-docs/sell/marketing/resources/campaign/methods/getCampaigns\">getCampaigns</a> to retrieve the <b>campaign_id</b> and the campaign status (<code>RUNNING</code>, <code>PAUSED</code>, <code>ENDED</code>, and so on) for all the seller's campaigns.</p>"
      operationId: pauseCampaign
      parameters:
        - description: A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.<br /><br /><span class="tablenote"><b>Note:</b> You can retrieve the campaign IDs for a specified seller using the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method.</span>
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
      responses:
        "204":
          description: No Content
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35035":
                category: REQUEST
                description: The campaign with campaign id {campaign_id} has ended.
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Conflict
          x-response-codes:
            errors:
              "35056":
                category: BUSINESS
                description: The state of the campaign cannot be changed as requested.
                domain: API_MARKETING
              "35061":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is being synced to match the specifications of the campaign. Please wait a few minutes and try the call again.
                domain: API_MARKETING
              "35063":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is ending soon. No update operations are allowed on this campaign until it ends.
                domain: API_MARKETING
              "35077":
                category: BUSINESS
                description: To use Promoted Listings, you need to improve your seller level to Top Rated or Above Standard and have enough recent sales activity.
                domain: API_MARKETING
              "35078":
                category: BUSINESS
                description: To gain access to Promoted Listings, you must be in good standing with recent sales activity.
                domain: API_MARKETING
              "35089":
                category: BUSINESS
                description: We are currently testing a premium ads product with a small invite-only group. We will share more information when we are ready to expand.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - campaign
  "/ad_campaign/{campaign_id}/resume":
    post:
      description: This method resumes a paused campaign, as long as its end date is in the future. Supply the <b>campaign_id</b> for the campaign you want to restart as a query parameter in the request.  <p>Call <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> to retrieve the <b>campaign_id</b> and the campaign status (<code>RUNNING</code>, <code>PAUSED</code>, <code>ENDED</code>, and so on) for all the seller's campaigns.</p>
      operationId: resumeCampaign
      parameters:
        - description: A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.<br /><br /><span class="tablenote"><b>Note:</b> You can retrieve the campaign IDs for a specified seller using the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method.</span>
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
      responses:
        "204":
          description: No content
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35035":
                category: REQUEST
                description: The campaign with campaign id {campaign_id} has ended.
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Business error
          x-response-codes:
            errors:
              "35056":
                category: BUSINESS
                description: The state of the campaign cannot be changed as requested.
                domain: API_MARKETING
              "35061":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is being synced to match the specifications of the campaign. Please wait a few minutes and try the call again.
                domain: API_MARKETING
              "35063":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is ending soon. No update operations are allowed on this campaign until it ends.
                domain: API_MARKETING
              "35077":
                category: BUSINESS
                description: To use Promoted Listings, you need to improve your seller level to Top Rated or Above Standard and have enough recent sales activity.
                domain: API_MARKETING
              "35078":
                category: BUSINESS
                description: To gain access to Promoted Listings, you must be in good standing with recent sales activity.
                domain: API_MARKETING
              "35089":
                category: BUSINESS
                description: We are currently testing a premium ads product with a small invite-only group. We will share more information when we are ready to expand.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - campaign
  "/ad_campaign/{campaign_id}/suggest_items":
    get:
      description: <span class="tablenote"><b>Note:</b> This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program. For information about how to request access to this program, refer to <a href="/api-docs/sell/static/marketing/pl-verify-eligibility.html#access-requests " target="_blank "> Promoted Listings Advanced Access Requests</a> in the Promoted Listings Playbook. To determine if a seller qualifies for PLA, use the <a href="/api-docs/sell/account/resources/advertising_eligibility/methods/getAdvertisingEligibility " target="_blank ">getAdvertisingEligibility</a> method in Account API.</span><br />This method allows sellers to obtain ideas for listings, which can be targeted for Promoted Listings campaigns.
      operationId: suggestItems
      parameters:
        - description: A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.<br /><br /><span class="tablenote"><b>Note:</b> You can retrieve the campaign IDs for a specified seller using the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method.</span>
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
        - description: "Specifies the category ID that is used to limit the results. This refers to an exact leaf category (the lowest level in that category and has no children). This field can have one category ID, or a comma-separated list of IDs. To return all category IDs, set to <code>null</code>. <br /><br /><b>Maximum: </b> 10 "
          in: query
          name: category_ids
          required: false
          schema:
            type: string
        - description: "Specifies the maximum number of campaigns to return on a page in the paginated response. If no value is specified, the default value is used. <br /><br /><b>Default: </b>10 <br /><br /><b>Minimum: </b> 1<br /><br /><b>Maximum: </b> 1000"
          in: query
          name: limit
          required: false
          schema:
            type: string
        - description: Specifies the number of campaigns to skip in the result set before returning the first report in the paginated response.  <p>Combine <b>offset</b> with the <b>limit</b> query parameter to control the items returned in the response. For example, if you supply an <b>offset</b> of <code>0</code> and a <b>limit</b> of <code>10</code>, the first page of the response contains the first 10 items from the complete list of items retrieved by the call. If <b>offset</b> is <code>10</code> and <b>limit</b> is <code>20</code>, the first page of the response contains items 11-30 from the complete result set.</p> <p><b>Default:</b> 0</p>
          in: query
          name: offset
          required: false
          schema:
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TargetedAdsPagedCollection"
          description: Success
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35008":
                category: REQUEST
                description: The category Id {categoryId} is not valid.
                domain: API_MARKETING
              "35029":
                category: REQUEST
                description: The 'limit' has to be greater than zero and less than {maxLimitValue}.
                domain: API_MARKETING
              "35030":
                category: REQUEST
                description: The 'offset' cannot be less than zero.
                domain: API_MARKETING
              "35041":
                category: REQUEST
                description: The 'marketplaceId' is required.
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
              "35090":
                category: REQUEST
                description: Category ID limit exceeded. You can pass up to a maximum of {maxCategoryLimit} category IDs per request.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Business error
          x-response-codes:
            errors:
              "35051":
                category: BUSINESS
                description: "'marketplaceId' {marketplaceId} is not supported. Promoted Listings is supported only on these marketplaces: {supportedMarketplaces}."
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - campaign
  "/ad_campaign/{campaign_id}/update_ad_rate_strategy":
    post:
      description: This method updates the ad rate strategy for an existing Promoted Listings Standard (PLS) rules-based ad campaign that uses the Cost Per Sale (CPS) funding model.<br /><br />Specify the <b>campaign_id</b> as a path parameter. You can retrieve the campaign IDs for a seller by calling the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method.<br /><br /><span class="tablenote"><b>Note:</b> This method only applies to the CPS funding model; it does not apply to the Cost Per Click (CPC) funding model. See <a href="/api-docs/sell/static/marketing/pl-overview.html#funding-model">Funding Models</a> in the <i>Promoted Listings Playbook</i> for more information.</span>
      operationId: updateAdRateStrategy
      parameters:
        - description: A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.<br /><br /><span class="tablenote"><b>Note:</b> You can retrieve the campaign IDs for a specified seller using the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method.</span>
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/UpdateAdrateStrategyRequest"
              description: This type defines the request fields for the ad rate strategy that shall be updated.
        description: This type defines the request fields for the ad rate strategy that shall be updated.
        required: true
      responses:
        "204":
          description: No content
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35007":
                category: REQUEST
                description: "The 'bidPercentage' {bidPercentage} is not valid. The bid percentage should be a single precision value. Minimum value: {minBidPercent} , Maximum value:{maxBidPercent}."
                domain: API_MARKETING
              "35035":
                category: REQUEST
                description: The campaign with campaign id {campaign_id} has ended.
                domain: API_MARKETING
              "35043":
                category: REQUEST
                description: The campaign status of {campaignStatus} is either invalid or not supported for this operation.
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Conflict
          x-response-codes:
            errors:
              "35061":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is being synced to match the specifications of the campaign. Please wait a few minutes and try the call again.
                domain: API_MARKETING
              "35063":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is ending soon. No update operations are allowed on this campaign until it ends.
                domain: API_MARKETING
              "35077":
                category: BUSINESS
                description: To use promoted listings, you need to improve your seller level to Top Rated or Above Standard and have enough recent sales activity.
                domain: API_MARKETING
              "35078":
                category: BUSINESS
                description: To gain access to Promoted Listings, you must be in good standing with recent sales activity.
                domain: API_MARKETING
              "35106":
                category: BUSINESS
                description: "'BidPercentage' should be provided when selected 'adRateStrategy' is 'FIXED'."
                domain: API_MARKETING
              "35107":
                category: BUSINESS
                description: "'dynamicAdRatePreferences' can be provided only when selected 'adRateStrategy' is 'DYNAMIC'."
                domain: API_MARKETING
              "35108":
                category: BUSINESS
                description: The 'adRateAdjustmentPercent' {adRateAdjustmentPercent} is not valid. Please set 'adRateAdjustmentPercent' {adRateAdjustmentPercent} between {minAllowedAdRateAdjustmentPercent}% - {maxAllowedAdRateAdjustmentPercent}%.
                domain: API_MARKETING
              "35109":
                category: BUSINESS
                description: The 'adRateCapPercent' {adRateCapPercent} is not valid. Please set 'adRateCapPercent' between {minAllowedAdRateCapPercent}% - {maxAllowedAdRateCapPercent}%.
                domain: API_MARKETING
              "35110":
                category: BUSINESS
                description: The 'adRateStrategy' is not supported for CPC funding model.
                domain: API_MARKETING
              "35111":
                category: BUSINESS
                description: The 'dynamicAdRatePreferences' is not supported for CPC funding model.
                domain: API_MARKETING
              "35112":
                category: BUSINESS
                description: The 'adRateStrategy' is currently only supported for criterion based campaign with 'autoselectFutureInventory' as True.
                domain: API_MARKETING
              "35113":
                category: BUSINESS
                description: This operation is currently only supported for criterion based campaigns.
                domain: API_MARKETING
              "35114":
                category: BUSINESS
                description: The 'dynamicAdRatePreferences' list currently can only support one element containing dynamicAdRatePreference. Please remove additional elements and try again.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - campaign
  "/ad_campaign/{campaign_id}/update_campaign_budget":
    post:
      description: <span class="tablenote"><b>Note:</b> This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program. For information about how to request access to this program, refer to <a href="/api-docs/sell/static/marketing/pl-verify-eligibility.html#access-requests " target="_blank "> Promoted Listings Advanced Access Requests</a> in the Promoted Listings Playbook. To determine if a seller qualifies for PLA, use the <a href="/api-docs/sell/account/resources/advertising_eligibility/methods/getAdvertisingEligibility " target="_blank ">getAdvertisingEligibility</a> method in Account API.</span><br />This method updates the daily budget for a PLA campaign that uses the Cost Per Click (CPC) funding model.<br /><br />A click occurs when an eBay user finds and clicks on the seller’s listing (within the search results) after using a keyword that the seller has created for the campaign. For each ad in an ad group in the campaign, each click triggers a cost, which gets subtracted from the campaign’s daily budget. If the cost of the clicks exceeds the daily budget, the Promoted Listings campaign will be paused until the next day.<br /><br />Specify the <b>campaign_id</b> as a path parameter. You can retrieve the campaign IDs for a seller by calling the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method.
      operationId: updateCampaignBudget
      parameters:
        - description: A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.<br /><br /><span class="tablenote"><b>Note:</b> You can retrieve the campaign IDs for a specified seller using the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method.</span>
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/UpdateCampaignBudgetRequest"
              description: This type defines the request fields for the budget details that shall be updated.
        description: This type defines the request fields for the budget details that shall be updated.
        required: true
      responses:
        "204":
          description: No content
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35035":
                category: REQUEST
                description: The campaign with campaign id {campaign_id} has ended.
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
              "36100":
                category: REQUEST
                description: This functionality is not supported for CPS funding model.
                domain: API_MARKETING
              "36101":
                category: REQUEST
                description: The daily budget value format is a maximum of two decimal points.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Conflict
          x-response-codes:
            errors:
              "35077":
                category: BUSINESS
                description: To use promoted listings, you need to improve your seller level to Top Rated or Above Standard and have enough recent sales activity.
                domain: API_MARKETING
              "35089":
                category: BUSINESS
                description: We are currently testing a premium ads product with a small invite-only group. We will share more information when we are ready to expand.
                domain: API_MARKETING
              "36153":
                category: BUSINESS
                description: The daily budget currency {currency} is not supported for {fieldName}. The supported currency for the {marketplaceId} marketplace is {supportedCurrencyCode}.
                domain: API_MARKETING
              "36154":
                category: BUSINESS
                description: The daily budget below minimum allowed {minAllowed}.
                domain: API_MARKETING
              "36155":
                category: BUSINESS
                description: The daily budget above maximum allowed {maxAllowed}.
                domain: API_MARKETING
              "36156":
                category: BUSINESS
                description: campaignBudget is not supported for CPS funding model.
                domain: API_MARKETING
              "36157":
                category: BUSINESS
                description: The daily budget is required for campaigns with CPC funding model.
                domain: API_MARKETING
              "36158":
                category: BUSINESS
                description: The daily budget value format {dailyBudgetValue} cannot have more than 2 decimal places.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - campaign
  "/ad_campaign/{campaign_id}/update_campaign_identification":
    post:
      description: This method can be used to change the name of a campaign, as well as modify the start or end dates. <p>Specify the <b>campaign_id</b> you want to update as a URI parameter, and configure the <b>campaignName</b> and <b>startDate</b> in the request payload.  <p>If you want to change only the end date of the campaign, specify the current campaign name, set <b>endDate</b> as desired, and set <b>startDate</b> to the actual start date of the campaign. This applies if the campaign status is <code>RUNNING</code> or <code>PAUSED</code>. You can retrieve the <b>startDate</b> using the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaign#response.startDate">getCampaign</a> method.</p> <p>Note that if you do not set a new end date in this call, any current <b>endDate</b> value will be set to <code>null</code>. To preserve the currently-set end date, you must specify the value again in your request.</p>  <p>Call <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> to retrieve a seller's campaign details, including the campaign ID, campaign name, and the start and end dates of the campaign.
      operationId: updateCampaignIdentification
      parameters:
        - description: A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.<br /><br /><span class="tablenote"><b>Note:</b> You can retrieve the campaign IDs for a specified seller using the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method.</span>
          in: path
          name: campaign_id
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/UpdateCampaignIdentificationRequest"
              description: This type defines the fields to update the campaign name and start and end dates.
        description: This type defines the fields to update the campaign name and start and end dates.
        required: true
      responses:
        "204":
          description: No content
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35019":
                category: REQUEST
                description: Campaign name is required for this call.
                domain: API_MARKETING
              "35020":
                category: REQUEST
                description: The campaign name cannot be more than {maxCampaignNameLength} characters.
                domain: API_MARKETING
              "35021":
                category: REQUEST
                description: A campaign with the name of {campaignName} already exists. Please provide a different name.
                domain: API_MARKETING
              "35023":
                category: REQUEST
                description: The request contains invalid characters. {notAllowedCharacters} are not allowed.
                domain: API_MARKETING
              "35024":
                category: REQUEST
                description: The campaign start date {startDate} cannot be after the end date {endDate}.
                domain: API_MARKETING
              "35025":
                category: REQUEST
                description: A campaign start date is required.
                domain: API_MARKETING
              "35026":
                category: REQUEST
                description: A campaign start or end date {date} cannot be in the past.
                domain: API_MARKETING
              "35035":
                category: REQUEST
                description: The campaign with campaign id {campaign_id} has ended.
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Conflict
          x-response-codes:
            errors:
              "35055":
                category: BUSINESS
                description: The start date cannot be modified for an active campaign.
                domain: API_MARKETING
              "35061":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is being synced to match the specifications of the campaign. Please wait a few minutes and try the call again.
                domain: API_MARKETING
              "35063":
                category: BUSINESS
                description: The campaign with 'campaign_id' {campaign_id} is ending soon. No update operations are allowed on this campaign until it ends.
                domain: API_MARKETING
              "35077":
                category: BUSINESS
                description: To use Promoted Listings, you need to improve your seller level to Top Rated or Above Standard and have enough recent sales activity.
                domain: API_MARKETING
              "35078":
                category: BUSINESS
                description: To gain access to Promoted Listings, you must be in good standing with recent sales activity.
                domain: API_MARKETING
              "35089":
                category: BUSINESS
                description: We are currently testing a premium ads product with a small invite-only group. We will share more information when we are ready to expand.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
              "35002":
                category: APPLICATION
                description: Internal error. Please wait a few minutes and try the call again.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - campaign
  "/ad_report/{report_id}":
    get:
      description: 'This call downloads the report as specified by the <b>report_id</b> path parameter.  <br><br>Call <a href="/api-docs/sell/marketing/resources/ad_report_task/methods/createReportTask" title="createReportTask API docs">createReportTask</a> to schedule and generate a Promoted Listings report. All date values are returned in UTC format (<code>yyyy-MM-ddThh:mm:ss.sssZ</code>).<br/><br/><span class="tablenote"><b>Note:</b> The reporting of some data related to sales and ad-fees may require a 72-hour (<b>maximum</b>) adjustment period which is often referred to as the <i>Reconciliation Period</i>. Such adjustment periods should, on average, be minimal. However, at any given time, the <b>payments</b> tab may be used to view those amounts that have actually been charged.</span><br/><div class="msgbox_important"><p class="msgbox_importantInDiv" data-mc-autonum="&lt;b&gt;&lt;span style=&quot;color: #dd1e31;&quot; class=&quot;mcFormatColor&quot;&gt;Important! &lt;/span&gt;&lt;/b&gt;"><span class="autonumber"><span><b><span style="color: #dd1e31;" class="mcFormatColor">Important!</span></b></span></span>For <b>ad_report</b> and <b>ad_report_task</b> methods, the API call limit is subject to a per user quota. These API calls can <b>only</b> be executed a maximum of 200 times per hour for each seller/user. If the number of calls per hour exceeds this limit, any new calls will be blocked for the next hour.</p></div>'
      operationId: getReport
      parameters:
        - description: The unique ID of the Promoted Listings report you want to get. <p>This ID is generated by eBay when you run a report task with a call to <a href="/api-docs/sell/marketing/resources/ad_report_task/methods/createReportTask">createReportTask</a>. Get all the seller's report IDs by calling <a href="/api-docs/sell/marketing/resources/ad_report_task/methods/getReportTasks">getReportTasks</a>.</p>
          in: path
          name: report_id
          required: true
          schema:
            type: string
      responses:
        "200":
          content:
            text/tab-separated-values:
              schema:
                type: object
          description: Success
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35110":
                category: REQUEST
                description: The 'report_id' {report_id} was not found. Correct the 'report_id' and try the call again.
                domain: API_MARKETING
        "404":
          description: Not Found
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - ad_report
  /ad_report_metadata:
    get:
      description: This call retrieves information that details the fields used in each of the Promoted Listings reports. Use the returned information to configure the different types of Promoted Listings reports.</br></br>The request for this method does not use a payload or any URI parameters.<br/><br/><span class="tablenote"><b>Note:</b> The reporting of some data related to sales and ad-fees may require a 72-hour (<b>maximum</b>) adjustment period which is often referred to as the <i>Reconciliation Period</i>. Such adjustment periods should, on average, be minimal. However, at any given time, the <b>payments</b> tab may be used to view those amounts that have actually been charged.</span>
      operationId: getReportMetadata
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ReportMetadatas"
          description: Success
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope
      tags:
        - ad_report_metadata
  "/ad_report_metadata/{report_type}":
    get:
      description: This call retrieves metadata that details the fields used by a specific Promoted Listings report type. Use the <b>report_type</b> path parameter to indicate metadata to retrieve.<br/><br/>This method does not use a request payload.<br/><br/><span class="tablenote"><b>Note:</b> The reporting of some data related to sales and ad-fees may require a 72-hour (<b>maximum</b>) adjustment period which is often referred to as the <i>Reconciliation Period</i>. Such adjustment periods should, on average, be minimal. However, at any given time, the <b>payments</b> tab may be used to view those amounts that have actually been charged.</span>
      operationId: getReportMetadataForReportType
      parameters:
        - description: The name of the report type whose metadata you want to retrieve.<br /><br /><span class="tablenote"><b>Tip:</b> For details about available report types and their descriptions, refer to the <a href="/api-docs/sell/marketing/types/plr:ReportTypeEnum">ReportTypeEnum</a>.</span>
          in: path
          name: report_type
          required: true
          schema:
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ReportMetadata"
          description: Success
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35116":
                category: REQUEST
                description: "Supplied 'report_type' not found. Valid values are: {supportedReportTypes}."
                domain: API_MARKETING
        "403":
          description: Forbidden
          x-response-codes:
            errors:
              "35089":
                category: REQUEST
                description: You are currently not authorized to access the Promoted Listings Advanced program. Please contact support
                domain: API_MARKETING
        "404":
          description: Not Found
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope
      tags:
        - ad_report_metadata
  /ad_report_task:
    get:
      description: 'This method returns information on all the existing report tasks related to a seller. <p>Use the <b>report_task_statuses</b> query parameter to control which reports to return. You can paginate the result set by specifying a <b>limit</b>, which dictates how many report tasks to return on each page of the response. Use the <b>offset</b> parameter to specify how many reports to skip in the result set before returning the first result.</p><br/><div class="msgbox_important"><p class="msgbox_importantInDiv" data-mc-autonum="&lt;b&gt;&lt;span style=&quot;color: #dd1e31;&quot; class=&quot;mcFormatColor&quot;&gt;Important! &lt;/span&gt;&lt;/b&gt;"><span class="autonumber"><span><b><span style="color: #dd1e31;" class="mcFormatColor">Important!</span></b></span></span>For <b>ad_report</b> and <b>ad_report_task</b> methods, the API call limit is subject to a per user quota. These API calls can <b>only</b> be executed a maximum of 200 times per hour for each seller/user. If the number of calls per hour exceeds this limit, any new calls will be blocked for the next hour.</p></div>'
      operationId: getReportTasks
      parameters:
        - description: Specifies the maximum number of report tasks to return on a page in the paginated response.  <p><b>Default:</b> 10<br><b>Maximum:</b> 500</p>
          in: query
          name: limit
          required: false
          schema:
            type: string
        - description: Specifies the number of report tasks to skip in the result set before returning the first report in the paginated response.  <p>Combine <b>offset</b> with the <b>limit</b> query parameter to control the reports returned in the response. For example, if you supply an <b>offset</b> of <code>0</code> and a <b>limit</b> of <code>10</code>, the response contains the first 10 reports from the complete list of report tasks retrieved by the call. If <b>offset</b> is <code>10</code> and <b>limit</b> is <code>10</code>, the first page of the response contains reports 11-20 from the complete result set.</p> <b>Default:</b> 0
          in: query
          name: offset
          required: false
          schema:
            type: string
        - description: 'This parameter filters the returned report tasks by their status. Supply a comma-separated list of the report statuses you want returned. The results are filtered to include only the report statuses you specify.<br /><br /><span class="tablenote"><span style="color:#004680"><strong>Note:</strong></span> The results might not include some report tasks if other search conditions exclude them.</span><br /><br /><b>Valid values: </b> <br>&nbsp;&nbsp;&nbsp;<code>PENDING</code> <br>&nbsp;&nbsp;&nbsp;<code>SUCCESS</code> <br>&nbsp;&nbsp;&nbsp;<code>FAILED</code>'
          in: query
          name: report_task_statuses
          required: false
          schema:
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ReportTaskPagedCollection"
          description: Success
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35029":
                category: REQUEST
                description: The 'limit' has to be greater than zero and less than {maxLimitValue}.
                domain: API_MARKETING
              "35030":
                category: REQUEST
                description: The 'offset' cannot be less than zero {offset}.
                domain: API_MARKETING
              "35109":
                category: REQUEST
                description: "The 'report_task_statuses' {invalid_report_task_statuses} is invalid. Valid values are: {supportedReportTaskStatuses}."
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - ad_report_task
    post:
      description: "<span class=\"tablenote\"><b>Note:</b> Using multiple funding models in one report is deprecated. If multiple funding models are used, a Warning will be returned in a header. This functionality will be decommissioned on April 3, 2023. See <a href=\"/develop/apis/api-deprecation-status\">API Deprecation Status</a> for details.</span><br /><br />This method creates a <i>report task</i>, which generates a Promoted Listings report based on the values specified in the call.<br /><br />The report is generated based on the criteria you specify, including the report type, the report's dimensions and metrics, the report's start and end dates, the listings to include in the report, and more. <i>Metrics </i>are the quantitative measurements in the report while <i>dimensions</i> specify the attributes of the data included in the reports.<br /><br />When creating a report task, you can specify the items you want included in the report. The items you specify, using either <b>listingId</b> or <b>inventoryReference</b> values, must be in a Promoted Listings campaign for them to be included in the report.<br /><br />For details on the required and optional fields for each report type, see <a href=\"/api-docs/sell/static/marketing/pl-reports.html\">Promoted Listings reporting</a>.<br /><br />This call returns the URL to the report task in the <b>Location</b> response header, and the URL includes the report-task ID.<br /><br />Reports often take time to generate and it's common for this call to return an HTTP status of <code>202</code>, which indicates the report is being generated. Call <a href=\"/api-docs/sell/marketing/resources/ad_report_task/methods/getReportTasks\">getReportTasks</a> (or <a href=\"/api-docs/sell/marketing/resources/ad_report_task/methods/getReportTask\">getReportTask</a> with the report-task ID) to determine the status of a Promoted Listings report. When a report is complete, eBay sets its status to <b>SUCCESS</b> and you can download it using the URL returned in the <b>reportHref</b> field of the <b>getReportTask</b> call. Report files are tab-separated value gzip files with a file extension of <code>.tsv.gz</code>.<br/><br/><span class=\"tablenote\"><b>Note:</b> The reporting of some data related to sales and ad-fees may require a 72-hour (<b>maximum</b>) adjustment period which is often referred to as the <i>Reconciliation Period</i>. Such adjustment periods should, on average, be minimal. However, at any given time, the <b>payments</b> tab may be used to view those amounts that have actually been charged.</span><br /><span class=\"tablenote\"><span style=\"color:#004680\"><strong>Note:</strong></span> This call fails if you don't submit all the required fields for the specified report type. Fields not supported by the specified report type are ignored. Call <a href=\"/api-docs/sell/marketing/resources/ad_report_metadata/methods/getReportMetadata\">getReportMetadata</a> to retrieve a list of the fields you need to configure for each Promoted Listings report type.</span><br/><div class=\"msgbox_important\"><p class=\"msgbox_importantInDiv\" data-mc-autonum=\"&lt;b&gt;&lt;span style=&quot;color: #dd1e31;&quot; class=&quot;mcFormatColor&quot;&gt;Important! &lt;/span&gt;&lt;/b&gt;\"><span class=\"autonumber\"><span><b><span style=\"color: #dd1e31;\" class=\"mcFormatColor\">Important!</span></b></span></span>For <b>ad_report</b> and <b>ad_report_task</b> methods, the API call limit is subject to a per user quota. These API calls can <b>only</b> be executed a maximum of 200 times per hour for each seller/user. If the number of calls per hour exceeds this limit, any new calls will be blocked for the next hour.</p></div>"
      operationId: createReportTask
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/CreateReportTask"
              description: The container for the fields that define the report task.
        description: The container for the fields that define the report task.
        required: true
      responses:
        "202":
          description: Accepted
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35012":
                category: REQUEST
                description: The 'inventoryReferenceId' {inventoryReferenceId} is not valid.
                domain: API_MARKETING
              "35013":
                category: REQUEST
                description: The 'listingId' {listingId} is not valid. Correct the 'listingId' and try the call again.
                domain: API_MARKETING
              "35040":
                category: REQUEST
                description: The 'inventoryReferenceType' {inventoryReferenceType} is not supported.
                domain: API_MARKETING
              "35041":
                category: REQUEST
                description: "A 'marketplaceId' is required. Supported marketplaces are: {supportedMarketplaces}"
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for {campaignId}.
                domain: API_MARKETING
              "35090":
                category: REQUEST
                description: dateFrom and dateTo span exceeds maximum allowed. Only up to {maxDayRange} days are supported.
                domain: API_MARKETING
              "35100":
                category: REQUEST
                description: Campaign ID is required for this call.
                domain: API_MARKETING
              "35102":
                category: REQUEST
                description: The {date_key} date is required for this call.
                domain: API_MARKETING
              "35103":
                category: REQUEST
                description: The date cannot be in future.
                domain: API_MARKETING
              "35104":
                category: REQUEST
                description: The report start date {dateFrom} cannot be after the end date {dateTo}.
                domain: API_MARKETING
              "35105":
                category: REQUEST
                description: The report 'dateFrom' {dateFrom} is out of range. Reports are limited up to {maxDays} days in the past.
                domain: API_MARKETING
              "35106":
                category: REQUEST
                description: The 'dimensionKey' {dimensionKey} is not valid. To see the supported dimension keys for a report, use one of the 'Get Metadata' calls.
                domain: API_MARKETING
              "35107":
                category: REQUEST
                description: The 'dimensionKey' {dimensionKey} is not supported for the 'reportType' {reportType}. To see the supported dimension keys for a report, use one of the 'Get Metadata' calls.
                domain: API_MARKETING
              "35108":
                category: REQUEST
                description: The 'annotationKey' {annotationKey} is not supported for the 'dimensionKey' {dimensionKey}. To see the supported annotation and dimension keys for a report, use one of the 'Get Metadata' calls.
                domain: API_MARKETING
              "35111":
                category: REQUEST
                description: The 'inventoryReferenceId' {inventoryReferenceId} is not valid.
                domain: API_MARKETING
              "35113":
                category: REQUEST
                description: The listing ID is required for this call.
                domain: API_MARKETING
              "35114":
                category: REQUEST
                description: "The 'reportType' is invalid. Valid values are: {supportedReportTypes}."
                domain: API_MARKETING
              "35115":
                category: REQUEST
                description: The 'metricKey' {metricKey} is not supported for the 'reportType' {reportType}. To see the supported metric keys for a report, use one of the 'Get Metadata' calls.
                domain: API_MARKETING
              "35118":
                category: REQUEST
                description: "The 'reportFormat' is missing or invalid. Valid values are: {supportedReportFormats}"
                domain: API_MARKETING
              "35119":
                category: REQUEST
                description: "The minimum set of 'dimensionKey' is not provided for the 'reportType' {reportType}. Minimum required dimensionKeys are: {minimumDimensionKeys}"
                domain: API_MARKETING
              "35120":
                category: REQUEST
                description: "At least  one 'metricKey' must be provided for 'reportType' {reportType}. Valid metricKeys are: {supportedMetricKeys}"
                domain: API_MARKETING
              "35121":
                category: REQUEST
                description: "The 'fundingModel' is invalid. Valid values are: {supportedFundingModels}."
                domain: API_MARKETING
              "35122":
                category: REQUEST
                description: The metric key is not supported for the funding model.
                domain: API_MARKETING
              "35123":
                category: REQUEST
                description: The 'dimensionKey' {dimensionKey} is not valid for the 'fundingModel' {fundingModel}
                domain: API_MARKETING
        "403":
          description: Forbidden
          x-response-codes:
            errors:
              "35089":
                category: REQUEST
                description: You are currently not authorized to access the Promoted Listings Advanced program. Please contact support
                domain: API_MARKETING
              "35091":
                category: REQUEST
                description: "'additionalRecords' are supported only with COST_PER_CLICK FundingModel and non-performing data is applicable for account level reports with no Day level dimension. 'additionalRecords' are applicable for reportTypes {supportedReportTypes}"
                domain: API_MARKETING
        "409":
          description: Conflict
          x-response-codes:
            errors:
              "35051":
                category: BUSINESS
                description: "The 'marketplaceId' {marketplaceId} is not supported. Supported marketplaces are: {supportedMarketplaces}"
                domain: API_MARKETING
              "35068":
                category: BUSINESS
                description: You have exceeded the maximum number of listing IDs. Only {maxSupportedListings} listings are supported per call.
                domain: API_MARKETING
              "35101":
                category: BUSINESS
                description: You have exceeded the maximum number of campaign IDs. Only {maxSupportedCampaigns} campaigns are supported per call.
                domain: API_MARKETING
              "35112":
                category: BUSINESS
                description: The maximum number {maxSupportedInventoryReferences} of inventory references has been exceeded.
                domain: API_MARKETING
        "500":
          description: Internal Server error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - ad_report_task
  "/ad_report_task/{report_task_id}":
    delete:
      description: "This call deletes the report task specified by the <b>report_task_id</b> path parameter. This method also deletes any reports generated by the report task.  <p>Report task IDs are generated by eBay when you call <a href=\"/api-docs/sell/marketing/resources/ad_report_task/methods/createReportTask\">createReportTask</a>. Get a complete list of a seller's report-task IDs by calling <a href=\"/api-docs/sell/marketing/resources/ad_report_task/methods/getReportTasks\">getReportTasks</a>.</p><br/><div class=\"msgbox_important\"><p class=\"msgbox_importantInDiv\" data-mc-autonum=\"&lt;b&gt;&lt;span style=&quot;color: #dd1e31;&quot; class=&quot;mcFormatColor&quot;&gt;Important! &lt;/span&gt;&lt;/b&gt;\"><span class=\"autonumber\"><span><b><span style=\"color: #dd1e31;\" class=\"mcFormatColor\">Important!</span></b></span></span>For <b>ad_report</b> and <b>ad_report_task</b> methods, the API call limit is subject to a per user quota. These API calls can <b>only</b> be executed a maximum of 200 times per hour for each seller/user. If the number of calls per hour exceeds this limit, any new calls will be blocked for the next hour.</p></div>"
      operationId: deleteReportTask
      parameters:
        - description: A unique eBay-assigned ID for the report task that's generated when the report task is created by a call to <a href="/api-docs/sell/marketing/resources/ad_report_task/methods/createReportTask">createReportTask</a>.
          in: path
          name: report_task_id
          required: true
          schema:
            type: string
      responses:
        "204":
          description: No Content
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35140":
                category: REQUEST
                description: No ReportTask found for 'report_task_id' {report_task_id}. Please correct the 'report_task_id' and try again.
                domain: API_MARKETING
        "404":
          description: Not found
        "409":
          description: Conflict
          x-response-codes:
            errors:
              "35141":
                category: BUSINESS
                description: The Report Task with 'report_task_id' {report_task_id} is being modified. Please wait a few minutes and try the call again.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - ad_report_task
    get:
      description: "This call returns the details of a specific Promoted Listings report task, as specified by the <b>report_task_id</b> path parameter. <p>The report task includes the report criteria (such as the report dimensions, metrics, and included listing) and the report-generation rules (such as starting and ending dates for the specified report task).</p>  <p>Report-task IDs are generated by eBay when you call <a href=\"/api-docs/sell/marketing/resources/ad_report_task/methods/createReportTask\">createReportTask</a>. Get a complete list of a seller's report-task IDs by calling <a href=\"/api-docs/sell/marketing/resources/ad_report_task/methods/getReportTasks\">getReportTasks</a>.</p><br/><div class=\"msgbox_important\"><p class=\"msgbox_importantInDiv\" data-mc-autonum=\"&lt;b&gt;&lt;span style=&quot;color: #dd1e31;&quot; class=&quot;mcFormatColor&quot;&gt;Important! &lt;/span&gt;&lt;/b&gt;\"><span class=\"autonumber\"><span><b><span style=\"color: #dd1e31;\" class=\"mcFormatColor\">Important!</span></b></span></span>For <b>ad_report</b> and <b>ad_report_task</b> methods, the API call limit is subject to a per user quota. These API calls can <b>only</b> be executed a maximum of 200 times per hour for each seller/user. If the number of calls per hour exceeds this limit, any new calls will be blocked for the next hour.</p></div>"
      operationId: getReportTask
      parameters:
        - description: A unique eBay-assigned ID for the report task that's generated when the report task is created by a call to <a href="/api-docs/sell/marketing/resources/ad_report_task/methods/createReportTask">createReportTask</a>.
          in: path
          name: report_task_id
          required: true
          schema:
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ReportTask"
          description: Success
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35140":
                category: REQUEST
                description: No ReportTask found for 'report_task_id' {report_task_id}. Please correct the 'report_task_id' and try again.
                domain: API_MARKETING
        "404":
          description: Not found
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - ad_report_task
  /bulk_create_negative_keyword:
    post:
      description: <span class="tablenote"><b>Note:</b> This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program. For information about how to request access to this program, refer to <a href="/api-docs/sell/static/marketing/pl-verify-eligibility.html#access-requests " target="_blank "> Promoted Listings Advanced Access Requests</a> in the Promoted Listings Playbook. To determine if a seller qualifies for PLA, use the <a href="/api-docs/sell/account/resources/advertising_eligibility/methods/getAdvertisingEligibility " target="_blank ">getAdvertisingEligibility</a> method in Account API.</span><br />This method adds negative keywords, in bulk, to an existing ad group in a PLA campaign that uses the Cost Per Click (CPC) funding model.<br /><br />Specify the <b>campaignId</b> and <b>adGroupId</b> in the request body, along with the <b>negativeKeywordText</b> and <b>negativeKeywordMatchType</b>.<br /><br />Call the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method to retrieve a list of current campaign IDs for a specified seller.
      operationId: bulkCreateNegativeKeyword
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/BulkCreateNegativeKeywordRequest"
              description: A type that defines the fields for the bulk request to create negative keywords.
        description: A type that defines the fields for the bulk request to create negative keywords.
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/BulkCreateNegativeKeywordResponse"
          description: Success
        "207":
          description: Multi Status
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35033":
                category: REQUEST
                description: At least one request is required for bulk requests.
                domain: API_MARKETING
              "35035":
                category: REQUEST
                description: The campaign with campaign id {campaign_id} has ended.
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
              "36210":
                category: REQUEST
                description: No ad group found for ad group id {ad_group_id}.
                domain: API_MARKETING
              "36219":
                category: REQUEST
                description: The ad group with ad group id {ad_group_id} has been archived.
                domain: API_MARKETING
              "36323":
                category: REQUEST
                description: "'negativeKeywordText' {negativeKeywordText} and 'negativeKeywordMatchType' {negativeKeywordMatchType} already exists for this Campaign."
                domain: API_MARKETING
              "36330":
                category: REQUEST
                description: "The provided negative keyword match type is not supported. Valid values are: {negativeKeywordMatchTypeValues}."
                domain: API_MARKETING
              "36331":
                category: REQUEST
                description: "'negativeKeywordText' {negativeKeywordText} and 'negativeKeywordMatchType' {negativeKeywordMatchType} already exists for this Ad Group."
                domain: API_MARKETING
              "36332":
                category: REQUEST
                description: "'negativeKeywordText' {negativeKeywordText} cannot be more than {maxNegativeKeywordTextLength} characters."
                domain: API_MARKETING
              "36333":
                category: REQUEST
                description: "'negativeKeywordText' cannot be null or empty"
                domain: API_MARKETING
              "36334":
                category: REQUEST
                description: "'negativeKeywordText' contains invalid characters {invalidCharacters}"
                domain: API_MARKETING
              "36335":
                category: REQUEST
                description: You have exceeded the maximum number of negative keyword for an ad group. Only {maxSupportedNegativeKeywordNumber} Ids are supported per ad group.
                domain: API_MARKETING
              "36336":
                category: REQUEST
                description: "'negativeKeywordText' {negativeKeywordText} cannot have total number of words more than {maxWordsInNegativeKeyword} words."
                domain: API_MARKETING
              "36337":
                category: REQUEST
                description: You have exceeded the maximum number of negative keyword requests in a bulk. Only {maxSupportedNegativeKeywordRequestNumberInBulk} Ids are supported per call.
                domain: API_MARKETING
              "36338":
                category: REQUEST
                description: There are duplicate 'negativeKeywordText' and 'negativeKeywordMatchType' combination in this request. You must remove the duplicate(s).
                domain: API_MARKETING
              "36339":
                category: REQUEST
                description: Total negative keyword requests exceed the current AdGroup negative keyword capacity, which is {maxSupportedNegativeKeywordRequestNumber}.
                domain: API_MARKETING
              "36345":
                category: REQUEST
                description: "'campaignId' and 'adGroupId' are required."
                domain: API_MARKETING
              "36346":
                category: REQUEST
                description: You have exceeded the maximum number of negative keyword for a campaign. Only {maxSupportedNegativeKeywordNumberCampaign} Ids are supported per campaign.
                domain: API_MARKETING
        "403":
          description: Forbidden
        "409":
          description: Conflict
          x-response-codes:
            errors:
              "35089":
                category: BUSINESS
                description: We are currently testing a premium ads product with a small invite-only group. We will share more information when we are ready to expand.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - negative_keyword
  /bulk_update_negative_keyword:
    post:
      description: <span class="tablenote"><b>Note:</b> This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program. For information about how to request access to this program, refer to <a href="/api-docs/sell/static/marketing/pl-verify-eligibility.html#access-requests " target="_blank "> Promoted Listings Advanced Access Requests</a> in the Promoted Listings Playbook. To determine if a seller qualifies for PLA, use the <a href="/api-docs/sell/account/resources/advertising_eligibility/methods/getAdvertisingEligibility " target="_blank ">getAdvertisingEligibility</a> method in Account API.</span><br />This method updates the statuses of existing negative keywords, in bulk.<br /><br />Specify the <b>negativeKeywordId</b> and <b>negativeKeywordStatus</b> in the request body.
      operationId: bulkUpdateNegativeKeyword
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/BulkUpdateNegativeKeywordRequest"
              description: A type that defines the fields for the bulk request to update negative keyword statuses.
        description: A type that defines the fields for the bulk request to update negative keyword statuses.
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/BulkUpdateNegativeKeywordResponse"
          description: Success
        "207":
          description: Multi Status
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "36337":
                category: REQUEST
                description: You have exceeded the maximum number of negative keyword requests in a bulk. Only {maxSupportedNegativeKeywordRequestNumberInBulk} Ids are supported per call.
                domain: API_MARKETING
              "36340":
                category: REQUEST
                description: No negative keyword found for negative keyword id {negativeKeywordId}.
                domain: API_MARKETING
              "36341":
                category: REQUEST
                description: There are duplicate negative keyword Ids in this request. You must remove the duplicate(s).
                domain: API_MARKETING
              "36342":
                category: REQUEST
                description: NegativeKeywordStatus is missing or invalid. It is required for update.
                domain: API_MARKETING
              "36343":
                category: REQUEST
                description: Negative keyword with negative keyword id {negativeKeywordId} is already archived and cannot be updated.
                domain: API_MARKETING
              "36348":
                category: REQUEST
                description: Negative keyword id 'negativeKeywordId' is required.
                domain: API_MARKETING
              "36349":
                category: REQUEST
                description: The 'negativeKeywordId' is invalid.
                domain: API_MARKETING
        "403":
          description: Forbidden
        "409":
          description: Conflict
          x-response-codes:
            errors:
              "35089":
                category: BUSINESS
                description: We are currently testing a premium ads product with a small invite-only group. We will share more information when we are ready to expand.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - negative_keyword
  /item_price_markdown:
    post:
      description: This method creates an <b>item price markdown promotion</b> (know simply as a "markdown promotion") where a discount amount is applied directly to the items included the promotion. Discounts can be specified as either a monetary amount or a percentage off the standard sales price. eBay highlights promoted items by placing teasers for the items throughout the online sales flows.  <p>Unlike an <a href="/api-docs/sell/marketing/resources/item_promotion/methods/createItemPromotion">item promotion</a>, a markdown promotion does not require the buyer meet a "threshold" before the offer takes effect. With markdown promotions, all the buyer needs to do is purchase the item to receive the promotion benefit.</p>  <p class="tablenote"><b>Important:</b> There are some restrictions for which listings are available for price markdown promotions. For details, see <a href="/api-docs/sell/marketing/static/overview.html#PM-requirements">Promotions Manager requirements and restrictions</a>. <br><br>In addition, we recommend you list items at competitive prices before including them in your markdown promotions. For an extensive list of pricing recommendations, see the <b>Growth</b> tab in Seller Hub.</p> <p>There are two ways to add items to markdown promotions:</p> <ul><li><b>Key-based promotions</b> select items using either the listing IDs or inventory reference IDs of the items you want to promote. Note that if you use inventory reference IDs, you must specify both the <b>inventoryReferenceId</b> and the associated <b>inventoryReferenceType</b> of the item(s) you want to include the promotion.</li>  <li><b>Rule-based promotions</b> select items using a list of eBay category IDs or seller Store category IDs. Rules can further constrain items in a promotion by minimum and maximum prices, brands, and item conditions.</li></ul>  <p>New promotions must be created in either a <code>DRAFT</code> or a <code>SCHEDULED</code> state. Use the DRAFT state when you are initially creating a promotion and you want to be sure it's correctly configured before scheduling it to run. When you create a promotion, the promotion ID is returned in the <b>Location</b> response header. Use this ID to reference the promotion in subsequent requests (such as to schedule a promotion that's in a DRAFT state).</p>  <p class="tablenote"><b>Tip:</b> Refer to <a href="/api-docs/sell/static/marketing/promotions-manager.html">Promotions Manager</a> in the <i>Selling Integration Guide</i> for details and examples showing how to create and manage seller promotions.</p>  <p>Markdown promotions are available on all eBay marketplaces. For more information, see <a href="/api-docs/sell/marketing/static/overview.html#PM-requirements">Promotions Manager requirements and restrictions</a>.</p>
      operationId: createItemPriceMarkdownPromotion
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/ItemPriceMarkdown"
              description: This type defines the fields that describe an item price markdown promotion.
        description: This type defines the fields that describe an item price markdown promotion.
        required: false
      responses:
        "201":
          content:
            application/json:
              schema:
                type: object
          description: Created
          headers:
            Location:
              schema:
                description: The <b>location</b> response header contains the URL to the newly created item price markdown promotion. The URL includes the eBay-assigned <code>promotionId</code>, which you can use to reference the promotion.
                type: string
          x-response-codes:
            errors:
              "38226":
                category: REQUEST
                description: The listing ID must be numeric if you're using listingIds.
                domain: API_MARKETING
              "38227":
                category: REQUEST
                description: The listing ID is invalid.
                domain: API_MARKETING
              "38263":
                category: REQUEST
                description: The SKU or custom label used in inventoryReferenceId exceeds the maximum length, which is {skuLength}.
                domain: API_MARKETING
              "38272":
                category: BUSINESS
                description: This listing is not eligible for a promotion because it's an auction-style listing.
                domain: API_MARKETING
              "38273":
                category: BUSINESS
                description: This listing is not eligible for a promotion because it's a minimum advertised price (MAP) listing.
                domain: API_MARKETING
              "38274":
                category: BUSINESS
                description: You haven't included electronic payment method as a payment method. In order to make this listing eligible, update it to include electronic payment method.
                domain: API_MARKETING
              "38275":
                category: BUSINESS
                description: This SKU used in inventoryReferenceId matches an item that is part of a listing with variations. This SKU is only eligible if we add all of the listing variations. To add this listing, use the parent, or main, SKU (custom label).
                domain: API_MARKETING
              "345112":
                category: REQUEST
                description: Invalid Store category. Please refer to API documentation to source allowed values.
                domain: API_MARKETING
              "345113":
                category: REQUEST
                description: Invalid marketplace category ID. Please refer to API documentation for the supported values.
                domain: API_MARKETING
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "38204":
                category: REQUEST
                description: The seller is not eligible for promotions because they do not have an eBay Store or they have not accepted the terms and conditions for creating a promotion on this Marketplace, see the documentation for this call.
                domain: API_MARKETING
              "38218":
                category: REQUEST
                description: A valid entry is required for {fieldName}.
                domain: API_MARKETING
              "38219":
                category: REQUEST
                description: The start date and time must be earlier than the end date and time.
                domain: API_MARKETING
              "38220":
                category: REQUEST
                description: The end date and time must be later than the current date and time.
                domain: API_MARKETING
              "38228":
                category: REQUEST
                description: The amount value of '{fieldName}' contains decimals, only integers are supported.
                domain: API_MARKETING
              "38229":
                category: REQUEST
                description: The start date and time should be later than the current date and time.
                domain: API_MARKETING
              "38234":
                category: REQUEST
                description: HTML is not allowed in the '{fieldName}' field.
                domain: API_MARKETING
              "38235":
                category: REQUEST
                description: Invalid input for the '{fieldName}' field. For help, see the documentation for this call.
                domain: API_MARKETING
              "38238":
                category: REQUEST
                description: The 'discountBenefit' data is missing, which is required by this call. For help, see the documentation for this call.
                domain: API_MARKETING
              "38240":
                category: REQUEST
                description: Invalid input for the 'promotionStatus' field. For help, see the documentation for this call.
                domain: API_MARKETING
              "38242":
                category: REQUEST
                description: "The request can have only one of these fields: 'inventoryCriterion.inventoryItems' or 'inventoryCriterion.listingIds'."
                domain: API_MARKETING
              "38255":
                category: REQUEST
                description: The promotion description exceeds the maximum length, which is {promoDescriptionLength}.
                domain: API_MARKETING
              "38256":
                category: REQUEST
                description: The promotion name exceeds the maximum length, which is {promoNameLength}.
                domain: API_MARKETING
              "38261":
                category: REQUEST
                description: Promotions are currently limited to a maximum of {maxListingInclLimit} parent items, when entering item IDs or choosing from live inventory.
                domain: API_MARKETING
              "38262":
                category: REQUEST
                description: You can only include up to {maxSkuInclLimit} SKUs or custom labels in inventoryItems.
                domain: API_MARKETING
              "38270":
                category: REQUEST
                description: The currency type does not match what is used for the Marketplace ID submitted.
                domain: API_MARKETING
              "345056":
                category: REQUEST
                description: "The request can have only one of these field types: 'inventoryItems' or 'listingIds'."
                domain: API_MARKETING
              "345057":
                category: REQUEST
                description: "The request can have only one of these fields: 'percentageOffItem', or 'amountOffItem' in 'discountBenefit'. For help, see the documentation for this call."
                domain: API_MARKETING
              "345058":
                category: REQUEST
                description: When using multiple selectedInventoryDiscounts containers, each must have a unique percentageoffitems value. For help, see the documentation for this call.
                domain: API_MARKETING
              "345059":
                category: REQUEST
                description: If using percentageoffitems you can have between 1 and 10 selectedInventoryDiscounts containers. For help, see the documentation for this call.
                domain: API_MARKETING
              "345060":
                category: REQUEST
                description: If using amountoffitems you can only have selectedInventoryDiscounts container. For help, see the documentation for this call.
                domain: API_MARKETING
              "345061":
                category: REQUEST
                description: The discount ID value is a read only value.
                domain: API_MARKETING
              "345063":
                category: REQUEST
                description: Priority is not supported for the item_price_markdown calls.
                domain: API_MARKETING
              "345110":
                category: REQUEST
                description: You can specify only one of Inventory Items, Listing IDs or Rules in the Inventory Criterion.
                domain: API_MARKETING
              "345111":
                category: REQUEST
                description: You cannot specify Rules when using the Inventory by Value Criterion.
                domain: API_MARKETING
              "345114":
                category: REQUEST
                description: A Category scope is required for the Rule. Please refer to API documentation for allowed values.
                domain: API_MARKETING
              "345115":
                category: REQUEST
                description: At least one Category is required. Please provide a valid input for this field and try again.
                domain: API_MARKETING
              "345116":
                category: REQUEST
                description: You can specify only Marketplace categories or Store categories when creating Rules.
                domain: API_MARKETING
              "345120":
                category: REQUEST
                description: Invalid Item condition. Please refer to API documentation for allowed values.
                domain: API_MARKETING
              "345121":
                category: REQUEST
                description: You can specify only one of Inventory Items or Listing IDs in the Exclusion Criterion.
                domain: API_MARKETING
              "345122":
                category: REQUEST
                description: category ids cannot be specified with the inventory of type any.
                domain: API_MARKETING
              "345123":
                category: REQUEST
                description: brands cannot be specified with inventory of type any or Store.
                domain: API_MARKETING
              "345125":
                category: REQUEST
                description: You cannot specify a child Marketplace Category ID when the parent Marketplace Category ID is already specified. Please refer to the API documentation to source allowed values.
                domain: API_MARKETING
              "345126":
                category: REQUEST
                description: You cannot specify a child Store Category ID when the parent Store Category ID is already specified. Please refer to the API documentation to source allowed values.
                domain: API_MARKETING
        "409":
          description: Conflict
          x-response-codes:
            errors:
              "38248":
                category: BUSINESS
                description: The 'percentOffItem' value is invalid. For help, see the documentation for this call.
                domain: API_MARKETING
              "38250":
                category: BUSINESS
                description: The 'amountOffItem' value is invalid. For help, see the documentation for this call.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "38201":
                category: APPLICATION
                description: Internal server error encountered. If this problem persists, contact the eBay Developers Program for support.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - item_price_markdown
  "/item_price_markdown/{promotion_id}":
    delete:
      description: This method deletes the item price markdown promotion specified by the <b>promotion_id</b> path parameter. Call <a href="/api-docs/sell/marketing/resources/promotion/methods/getPromotions">getPromotions</a> to retrieve the IDs of a seller's promotions.  <br><br>You can delete any promotion with the exception of those that are currently active (RUNNING). To end a running promotion, call <a href="/api-docs/sell/marketing/resources/item_price_markdown/methods/updateItemPriceMarkdownPromotion">updateItemPriceMarkdownPromotion</a> and adjust the <b>endDate</b> field as appropriate.
      operationId: deleteItemPriceMarkdownPromotion
      parameters:
        - description: This path parameter takes a concatenation of the ID of the promotion you want to delete plus the marketplace ID on which the promotion is hosted. Concatenate the two values by separating them with an "at sign" (<b>@</b>).  <br><br>The ID of the promotion (<b>promotionId</b>) is a unique eBay-assigned value that's generated when the promotion is created. The Marketplace ID is the ENUM value of eBay marketplace where the promotion is hosted. <br><br><b>Example:</b> <code>1********5@EBAY_US</code>
          in: path
          name: promotion_id
          required: true
          schema:
            type: string
      responses:
        "204":
          description: No Content
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "38203":
                category: REQUEST
                description: Resource not found. Check the ID and try the call again.
                domain: API_MARKETING
              "38204":
                category: REQUEST
                description: The seller is not eligible for promotions because they do not have an eBay Store or they have not accepted the terms and conditions for creating a promotion on this Marketplace, see the documentation for this call.
                domain: API_MARKETING
              "345067":
                category: REQUEST
                description: A promotion can only be deleted if it is ended.
                domain: API_MARKETING
        "404":
          description: Not Found
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "38201":
                category: APPLICATION
                description: Internal server error encountered. If this problem persists, please contact support.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - item_price_markdown
    get:
      description: This method returns the complete details of the item price markdown promotion that's indicated by the <b>promotion_id</b> path parameter. <br><br>Call <a href="/api-docs/sell/marketing/resources/promotion/methods/getPromotions">getPromotions</a> to retrieve the IDs of a seller's promotions.
      operationId: getItemPriceMarkdownPromotion
      parameters:
        - description: This path parameter takes a concatenation of the ID of the promotion you want to get plus the marketplace ID on which the promotion is hosted. Concatenate the two values by separating them with an "at sign" (<b>@</b>).  <br><br>The ID of the promotion (<b>promotionId</b>) is a unique eBay-assigned value that's generated when the promotion is created. The Marketplace ID is the ENUM value of eBay marketplace where the promotion is hosted. <br><br><b>Example:</b> <code>1********5@EBAY_US</code>
          in: path
          name: promotion_id
          required: true
          schema:
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ItemPriceMarkdown"
          description: Success
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "38203":
                category: REQUEST
                description: Resource not found. Check the ID and try the call again.
                domain: API_MARKETING
              "38204":
                category: REQUEST
                description: The seller is not eligible for promotions because they do not have an eBay Store or they have not accepted the terms and conditions for creating a promotion on this Marketplace, see the documentation for this call.
                domain: API_MARKETING
        "404":
          description: Not Found
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "38201":
                category: APPLICATION
                description: Internal server error encountered. If this problem persists, contact the eBay Developers Program for support.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - item_price_markdown
    put:
      description: "This method updates the specified item price markdown promotion with the new configuration that you supply in the payload of the request. Specify the promotion you want to update using the <b>promotion_id</b> path parameter. Call <a href=\"/api-docs/sell/marketing/resources/promotion/methods/getPromotions\">getPromotions</a> to retrieve the IDs of a seller's promotions.  <br><br>When updating a promotion, supply all the fields that you used to configure the original promotion (and not just the fields you are updating). eBay replaces the specified promotion with the values you supply in the update request and if you don't pass a field that currently has a value, the update request fails.  <br><br>The parameters you are allowed to update with this request depend on the status of the promotion you're updating:  <ul><li>DRAFT or SCHEDULED promotions: You can update any of the parameters in these promotions that have not yet started to run, including the <b>discountRules</b>.</li> <li>RUNNING promotions: You can change the <b>endDate</b> and the item's inventory but you cannot change the promotional discount or the promotion's start date.</li> <li>ENDED promotions: Nothing can be changed.</li></ul>"
      operationId: updateItemPriceMarkdownPromotion
      parameters:
        - description: This path parameter takes a concatenation of the ID of the promotion you want to update plus the marketplace ID on which the promotion is hosted. Concatenate the two values by separating them with an "at sign" (<b>@</b>).  <br><br>The ID of the promotion (<b>promotionId</b>) is a unique eBay-assigned value that's generated when the promotion is created. The Marketplace ID is the ENUM value of eBay marketplace where the promotion is hosted. <br><br><b>Example:</b> <code>1********5@EBAY_US</code>
          in: path
          name: promotion_id
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/ItemPriceMarkdown"
              description: This type defines the fields that describe an item price markdown promotion.
        description: This type defines the fields that describe an item price markdown promotion.
        required: false
      responses:
        "200":
          content:
            application/json:
              schema:
                type: object
          description: Success
          x-response-codes:
            errors:
              "38226":
                category: REQUEST
                description: The listing ID must be numeric if you're using listingIds.
                domain: API_MARKETING
              "38227":
                category: REQUEST
                description: The listing ID is invalid.
                domain: API_MARKETING
              "38263":
                category: REQUEST
                description: The SKU or custom label used in inventoryReferenceId exceeds the maximum length, which is {skuLength}.
                domain: API_MARKETING
              "38272":
                category: BUSINESS
                description: This listing is not eligible for a promotion because it's an auction-style listing.
                domain: API_MARKETING
              "38273":
                category: BUSINESS
                description: This listing is not eligible for a promotion because it's a minimum advertised price (MAP) listing.
                domain: API_MARKETING
              "38274":
                category: BUSINESS
                description: You haven't included electronic payment method as a payment method. In order to make this listing eligible, update it to include electronic payment method.
                domain: API_MARKETING
              "38275":
                category: BUSINESS
                description: This SKU used in inventoryReferenceId matches an item that is part of a listing with variations. This SKU is only eligible if we add all of the listing variations. To add this listing, use the parent, or main, SKU (custom label).
                domain: API_MARKETING
              "345064":
                category: REQUEST
                description: You have moved inventory between discountBenefit containers or have the same inventory in multiple discountBenefit containers. For help, see the documentation for this call.
                domain: API_MARKETING
              "345112":
                category: REQUEST
                description: Invalid Store category. Please refer to API documentation to source allowed values.
                domain: API_MARKETING
              "345113":
                category: REQUEST
                description: Invalid marketplace category ID. Please refer to API documentation for the supported values.
                domain: API_MARKETING
        "204":
          description: Success
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "38203":
                category: REQUEST
                description: Resource not found. Check the ID and try the call again.
                domain: API_MARKETING
              "38204":
                category: REQUEST
                description: The seller is not eligible for promotions because they do not have an eBay Store or they have not accepted the terms and conditions for creating a promotion on this Marketplace, see the documentation for this call.
                domain: API_MARKETING
              "38218":
                category: REQUEST
                description: A valid entry is required for {fieldName}.
                domain: API_MARKETING
              "38219":
                category: REQUEST
                description: The start date and time must be earlier than the end date and time.
                domain: API_MARKETING
              "38220":
                category: REQUEST
                description: The end date and time must be later than the current date and time.
                domain: API_MARKETING
              "38225":
                category: REQUEST
                description: You cannot update a promotion that has ended.
                domain: API_MARKETING
              "38228":
                category: REQUEST
                description: The amount value of '{fieldName}' contains decimals, only integers are supported.
                domain: API_MARKETING
              "38229":
                category: REQUEST
                description: The start date and time should be later than the current date and time.
                domain: API_MARKETING
              "38232":
                category: REQUEST
                description: You cannot update the promotion discount for an active promotion.
                domain: API_MARKETING
              "38234":
                category: REQUEST
                description: HTML is not allowed in the '{fieldName}' field.
                domain: API_MARKETING
              "38235":
                category: REQUEST
                description: Invalid input for the '{fieldName}' field. For help, see the documentation for this call.
                domain: API_MARKETING
              "38238":
                category: REQUEST
                description: The 'discountBenefit' data is missing, which is required by this call. For help, see the documentation for this call.
                domain: API_MARKETING
              "38240":
                category: REQUEST
                description: Invalid input for the 'promotionStatus' field. For help, see the documentation for this call.
                domain: API_MARKETING
              "38242":
                category: REQUEST
                description: "The request can have only one of these fields: 'inventoryCriterion.inventoryItems' or 'inventoryCriterion.listingIds'."
                domain: API_MARKETING
              "38255":
                category: REQUEST
                description: The promotion description exceeds the maximum length, which is {promoDescriptionLength}.
                domain: API_MARKETING
              "38256":
                category: REQUEST
                description: The promotion name exceeds the maximum length, which is {promoNameLength}.
                domain: API_MARKETING
              "38260":
                category: REQUEST
                description: To update the start date of a promotion, the promotion must be in draft or scheduled state.
                domain: API_MARKETING
              "38261":
                category: REQUEST
                description: Promotions are currently limited to a maximum of {maxListingInclLimit} parent items, when entering item IDs or choosing from live inventory.
                domain: API_MARKETING
              "38262":
                category: REQUEST
                description: You can only include up to {maxSkuInclLimit} SKUs or custom labels in inventoryItems.
                domain: API_MARKETING
              "38269":
                category: REQUEST
                description: The promotion ID does not match any of the seller's promotions.
                domain: API_MARKETING
              "38270":
                category: REQUEST
                description: The currency type does not match what is used for the Marketplace ID submitted.
                domain: API_MARKETING
              "345056":
                category: REQUEST
                description: "The request can have only one of these field types: 'inventoryItems' or 'listingIds'."
                domain: API_MARKETING
              "345057":
                category: REQUEST
                description: "The request can have only one of these fields: 'percentageOffItem', or 'amountOffItem' in 'discountBenefit'. For help, see the documentation for this call."
                domain: API_MARKETING
              "345058":
                category: REQUEST
                description: When using multiple selectedInventoryDiscounts containers, each must have a unique percentageoffitems value. For help, see the documentation for this call.
                domain: API_MARKETING
              "345059":
                category: REQUEST
                description: If using percentageoffitems you can have between 1 and 10 selectedInventoryDiscounts containers. For help, see the documentation for this call.
                domain: API_MARKETING
              "345060":
                category: REQUEST
                description: If using amountoffitems you can only have selectedInventoryDiscounts container. For help, see the documentation for this call.
                domain: API_MARKETING
              "345061":
                category: REQUEST
                description: The discount ID value is a read only value.
                domain: API_MARKETING
              "345063":
                category: REQUEST
                description: Priority is not supported for the item_price_markdown calls.
                domain: API_MARKETING
              "345065":
                category: REQUEST
                description: You cannot change the status of aa SCHEDULED promotion to DRAFT. For help, see the documentation for this call.
                domain: API_MARKETING
              "345070":
                category: REQUEST
                description: The giving discount ID does not exist in the promotion. For help, see the documentation for this call.
                domain: API_MARKETING
              "345071":
                category: REQUEST
                description: The giving discount type is not consistent with existing active promotion. For help, see the documentation for this call.
                domain: API_MARKETING
              "345072":
                category: REQUEST
                description: The giving inventory criterion type is not consistent with existing active promotion. For help, see the documentation for this call.
                domain: API_MARKETING
              "345110":
                category: REQUEST
                description: You can specify only one of Inventory Items, Listing IDs or Rules in the Inventory Criterion.
                domain: API_MARKETING
              "345111":
                category: REQUEST
                description: You cannot specify Rules when using the Inventory by Value Criterion.
                domain: API_MARKETING
              "345114":
                category: REQUEST
                description: A Category scope is required for the Rule. Please refer to API documentation for allowed values.
                domain: API_MARKETING
              "345115":
                category: REQUEST
                description: At least one Category is required. Please provide a valid input for this field and try again.
                domain: API_MARKETING
              "345116":
                category: REQUEST
                description: You can specify only Marketplace categories or Store categories when creating Rules.
                domain: API_MARKETING
              "345120":
                category: REQUEST
                description: Invalid Item condition. Please refer to API documentation for allowed values.
                domain: API_MARKETING
              "345121":
                category: REQUEST
                description: You cannot specify Rules or inventory items when using the Inventory by ALL Criterion.
                domain: API_MARKETING
              "345122":
                category: REQUEST
                description: category ids cannot be specified with the inventory of type any.
                domain: API_MARKETING
              "345123":
                category: REQUEST
                description: brands cannot be specified with inventory of type any or Store.
                domain: API_MARKETING
              "345125":
                category: REQUEST
                description: You cannot specify a child Marketplace Category ID when the parent Marketplace Category ID is already specified. Please refer to the API documentation to source allowed values.
                domain: API_MARKETING
              "345126":
                category: REQUEST
                description: You cannot specify a child Store Category ID when the parent Store Category ID is already specified. Please refer to the API documentation to source allowed values.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Conflict
          x-response-codes:
            errors:
              "38248":
                category: BUSINESS
                description: The 'percentOffItem' value is invalid. For help, see the documentation for this call.
                domain: API_MARKETING
              "38250":
                category: BUSINESS
                description: The 'amountOffItem' value is invalid. For help, see the documentation for this call.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "38201":
                category: APPLICATION
                description: Internal server error encountered. If this problem persists, please contact support.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - item_price_markdown
  /item_promotion:
    post:
      description: "This method creates an <b>item promotion</b>, where the buyer receives a discount when they meet the buying criteria that's set for the promotion. Known here as \"threshold promotions\", these promotions trigger when a threshold is met.  <p>eBay highlights promoted items by placing teasers for the promoted items throughout the online buyer flows.</p>  <p><i>Discounts</i> are specified as either a monetary amount or a percentage off the standard sales price of a listing, letting you offer deals such as \"Buy 1 Get 1\" and \"Buy $50, get 20% off\".</p> <p><i>Volume pricing</i> promotions increase the value of the discount as the buyer increases the quantity they purchase.</p> <p><i>Coded Coupons</i> provide unique codes that a buyer can use during checkout to receive a discount. The seller can specify the number of times a buyer can use the coupon and the maximum amount across all purchases that can be discounted using the coupon. The coupon code can also be made public (appearing on the seller's Offer page, search pages, the item listing, and the checkout page) or private (only on the seller's Offer page, but the seller can include the code in email and social media).</p> <p class=\"tablenote\"><b>Note</b>: Coded Coupons are currently available in the US, UK, DE, FR, IT, ES, and AU marketplaces.</p><p>There are two ways to add items to a threshold promotion:</p>  <ul><li><b>Key-based promotions</b> select items using either the listing IDs or inventory reference IDs of the items you want to promote. Note that if you use inventory reference IDs, you must specify both the <b>inventoryReferenceId</b> and the associated <b>inventoryReferenceType</b> of the item(s) you want to include the promotion.</li> <li><b>Rule-based promotions</b> select items using a list of eBay category IDs or seller Store category IDs. Rules can further constrain items in a promotion by minimum and maximum prices, brands, and item conditions.</li></ul>  <p>You must create a new promotion in either a <code>DRAFT</code> or <code>SCHEDULED</code> state. Use the DRAFT state when you are initially creating a promotion and you want to be sure it's correctly configured before scheduling it to run. When you create a promotion, the promotion ID is returned in the <b>Location</b> response header. Use this ID to reference the promotion in subsequent requests.</p>  <p class=\"tablenote\"><b>Tip:</b> Refer to the <a href=\"/api-docs/sell/static/marketing/promotions-manager.html\">Selling Integration Guide</a> for details and examples showing how to create and manage threshold promotions using the Promotions Manager.</p>  <p>For information on the eBay marketplaces that support item promotions, see <a href=\"/api-docs/sell/marketing/static/overview.html#PM-requirements\">Promotions Manager requirements and restrictions</a>.</p>"
      operationId: createItemPromotion
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/ItemPromotion"
              description: This type defines the fields that describe an item promotion.
        description: This type defines the fields that describe an item promotion.
        required: false
      responses:
        "201":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/BaseResponse"
          description: Created
          headers:
            Location:
              schema:
                description: URL location of new item promotion.
                type: string
          x-response-codes:
            errors:
              "38226":
                category: REQUEST
                description: The listing ID must be numeric if you're using listingIds.
                domain: API_MARKETING
              "38227":
                category: REQUEST
                description: The listing ID is invalid.
                domain: API_MARKETING
              "38263":
                category: REQUEST
                description: The SKU or custom label used in inventoryReferenceId exceeds the maximum length, which is {skuLength}.
                domain: API_MARKETING
              "38272":
                category: BUSINESS
                description: This listing is not eligible for a promotion because it's an auction-style listing.
                domain: API_MARKETING
              "38273":
                category: BUSINESS
                description: This listing is not eligible for a promotion because it's a minimum advertised price (MAP) listing.
                domain: API_MARKETING
              "38274":
                category: BUSINESS
                description: You haven't included electronic payment method as a payment method. In order to make this listing eligible, update it to include electronic payment method.
                domain: API_MARKETING
              "38275":
                category: BUSINESS
                description: This SKU used in inventoryReferenceId matches an item that is part of a listing with variations. This SKU is only eligible if you add all of the listing variations. To add this listing, use the parent, or main, SKU (custom label).
                domain: API_MARKETING
              "345112":
                category: REQUEST
                description: Invalid Store category. Please refer to API documentation to source allowed values.
                domain: API_MARKETING
              "345113":
                category: REQUEST
                description: Invalid marketplace category ID. Please refer to API documentation for the supported values.
                domain: API_MARKETING
              "345137":
                category: REQUEST
                description: "'priority' can not be set for this promotion type. For help, see the documentation for this call."
                domain: API_MARKETING
              "345138":
                category: REQUEST
                description: "'description' can not be set for this promotion type. For help, see the documentation for this call."
                domain: API_MARKETING
              "345139":
                category: REQUEST
                description: "'applyDiscountToSingleItemOnly' can not be set for this promotion type. For help, see the documentation for this call."
                domain: API_MARKETING
              "345140":
                category: REQUEST
                description: "'promotionImageUrl' can not be set for this promotion type. For help, see the documentation for this call."
                domain: API_MARKETING
              "345142":
                category: REQUEST
                description: "'applyDiscountToSingleItemOnly' is currently not supported for this Marketplace ID. For help, see the documentation for this call."
                domain: API_MARKETING
              "345143":
                category: REQUEST
                description: "'couponType' can not be set for this promotion type. For help, see the documentation for this call."
                domain: API_MARKETING
              "345144":
                category: REQUEST
                description: "'maxCouponRedemptionPerUser' can not be set for this promotion type. For help, see the documentation for this call."
                domain: API_MARKETING
              "345145":
                category: REQUEST
                description: "'maxDiscountAmount' can not be set for this promotion type. For help, see the documentation for this call."
                domain: API_MARKETING
              "345146":
                category: REQUEST
                description: "'budget' can not be set for this promotion type. For help, see the documentation for this call."
                domain: API_MARKETING
              "345147":
                category: REQUEST
                description: "'couponCode' can not be set for this promotion type. For help, see the documentation for this call."
                domain: API_MARKETING
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "38204":
                category: REQUEST
                description: The seller is not eligible for promotions because they do not have an eBay Store or they have not accepted the terms and conditions for creating a promotion on this Marketplace, see the documentation for this call.
                domain: API_MARKETING
              "38205":
                category: REQUEST
                description: The Marketplace ID is not recognized or is not eligible for promotions.
                domain: API_MARKETING
              "38207":
                category: REQUEST
                description: The promotion priority is invalid. Please check and try the call again.
                domain: API_MARKETING
              "38218":
                category: REQUEST
                description: A valid entry is required for {fieldName}.
                domain: API_MARKETING
              "38219":
                category: REQUEST
                description: Zonks! The start date and time must be earlier than the end date and time.
                domain: API_MARKETING
              "38220":
                category: REQUEST
                description: The end date and time must be later than the current date and time.
                domain: API_MARKETING
              "38228":
                category: REQUEST
                description: The amount value of '{fieldName}' contains decimals, only integers are supported.
                domain: API_MARKETING
              "38229":
                category: REQUEST
                description: The start date and time should be later than the current date and time.
                domain: API_MARKETING
              "38234":
                category: REQUEST
                description: HTML is not allowed in the '{fieldName}' field.
                domain: API_MARKETING
              "38235":
                category: REQUEST
                description: Invalid input for the '{fieldName}' field. For help, see the documentation for this call.
                domain: API_MARKETING
              "38236":
                category: REQUEST
                description: The 'discountSpecification' data is missing, which is required by this call. For help, see the documentation for this call.
                domain: API_MARKETING
              "38237":
                category: REQUEST
                description: "The request can have only one of these fields: 'minQuantity', 'forEachQuantity', 'minAmount', or 'forEachAmount' in 'discountSpecification'. For help, see the documentation for this call."
                domain: API_MARKETING
              "38238":
                category: REQUEST
                description: The 'discountBenefit' data is missing, which is required by this call. For help, see the documentation for this call.
                domain: API_MARKETING
              "38239":
                category: REQUEST
                description: "The request can have only one of these fields: 'percentageOffOrder', 'amountOffOrder', 'percentageOffItem', or 'amountOffItem' in 'discountBenefit'. For help, see the documentation for this call."
                domain: API_MARKETING
              "38240":
                category: REQUEST
                description: Invalid input for the 'promotionStatus' field. For help, see the documentation for this call.
                domain: API_MARKETING
              "38241":
                category: REQUEST
                description: This discount rule combination is currently not supported. For help, see the documentation for this call.
                domain: API_MARKETING
              "38242":
                category: REQUEST
                description: "The request can have only one of these fields: 'inventoryCriterion.inventoryItems' or 'inventoryCriterion.listingIds'."
                domain: API_MARKETING
              "38253":
                category: REQUEST
                description: The data combination of 'DiscountSpecification' and 'DiscountBenefit' is not valid for this promotion type. For help, see the documentation for this call.
                domain: API_MARKETING
              "38255":
                category: REQUEST
                description: The promotion description exceeds the maximum length, which is {promoDescriptionLength}.
                domain: API_MARKETING
              "38256":
                category: REQUEST
                description: The promotion name exceeds the maximum length, which is {promoNameLength}.
                domain: API_MARKETING
              "38257":
                category: REQUEST
                description: This promotion type supports only one discount rule for the item promotion.
                domain: API_MARKETING
              "38260":
                category: REQUEST
                description: To update the start date of a promotion, the promotion must be in draft or scheduled state.
                domain: API_MARKETING
              "38261":
                category: REQUEST
                description: Promotions are currently limited to a maximum of {maxListingInclLimit} parent items, when entering item IDs or choosing from live inventory.
                domain: API_MARKETING
              "38262":
                category: REQUEST
                description: You can only include up to {maxSkuInclLimit} SKUs or custom labels in inventoryItems.
                domain: API_MARKETING
              "38265":
                category: REQUEST
                description: Number of discount items is greater than the quantity specified in 'DiscountSpecification'.
                domain: API_MARKETING
              "38267":
                category: REQUEST
                description: The 'DiscountBenefit.amountOffOrder' field cannot be used with the 'DiscountSpecification.numberOfDiscountedItems' field. This parameter is reserved for Buy x, Get x discounts. For help, see the documentation for this call.
                domain: API_MARKETING
              "345110":
                category: REQUEST
                description: You can specify only one of Inventory Items, Listing IDs or Rules in the Inventory Criterion.
                domain: API_MARKETING
              "345111":
                category: REQUEST
                description: You cannot specify Rules when using the Inventory by Value Criterion.
                domain: API_MARKETING
              "345114":
                category: REQUEST
                description: A Category scope is required for the Rule. Please refer to API documentation for allowed values.
                domain: API_MARKETING
              "345115":
                category: REQUEST
                description: At least one Category is required. Please provide a valid input for this field and try again.
                domain: API_MARKETING
              "345116":
                category: REQUEST
                description: You can specify only Marketplace categories or Store categories when creating Rules.
                domain: API_MARKETING
              "345118":
                category: REQUEST
                description: You can specify only one of Inventory Items or Listing IDs in the Exclusion Criterion.
                domain: API_MARKETING
              "345120":
                category: REQUEST
                description: Invalid Item condition. Please refer to API documentation for allowed values.
                domain: API_MARKETING
              "345121":
                category: REQUEST
                description: You can specify only one of Inventory Items or Listing IDs in the Exclusion Criterion.
                domain: API_MARKETING
              "345122":
                category: REQUEST
                description: category ids cannot be specified with the inventory of type any.
                domain: API_MARKETING
              "345123":
                category: REQUEST
                description: brands cannot be specified with inventory of type any or Store.
                domain: API_MARKETING
              "345124":
                category: REQUEST
                description: Exclusions are currently limited to a maximum of 100 parent items, when entering Inventory Items or Listing IDs, or choosing from live inventory.
                domain: API_MARKETING
              "345125":
                category: REQUEST
                description: You cannot specify a child Marketplace Category ID when the parent Marketplace Category ID is already specified. Please refer to the API documentation to source allowed values.
                domain: API_MARKETING
              "345126":
                category: REQUEST
                description: You cannot specify a child Store Category ID when the parent Store Category ID is already specified. Please refer to the API documentation to source allowed values.
                domain: API_MARKETING
              "345127":
                category: REQUEST
                description: Category aspects are not supported in this version.
                domain: API_MARKETING
              "345128":
                category: REQUEST
                description: The minimum discount rules required for volume discount promotions are {numOfDiscountRules}
                domain: API_MARKETING
              "345129":
                category: REQUEST
                description: The 'discountRules.ruleOrder' is missing or invalid for one of the discount rules for volume discount promotions. see the documentation for this call.
                domain: API_MARKETING
              "345130":
                category: REQUEST
                description: You can include up to a maximum of {numOfDiscountRules} discount rules in a volume discount promotion.
                domain: API_MARKETING
              "345131":
                category: REQUEST
                description: Each 'minQuantity' value should be one greater than the 'minQuantity' value of the previous discount rule.
                domain: API_MARKETING
              "345132":
                category: REQUEST
                description: The discount value is invalid for one of the discount rules for volume discount promotions. see the documentation for this call.
                domain: API_MARKETING
              "345133":
                category: REQUEST
                description: Each 'percentageOffOrder' or 'amountOffOrder' value should be greater than the 'percentageOffOrder' or 'amountOffOrder' value of the previous discount rule for volume discount promotions.
                domain: API_MARKETING
              "345134":
                category: REQUEST
                description: This promotionType is currently not supported. For help, see the documentation for this call.
                domain: API_MARKETING
              "345136":
                category: REQUEST
                description: The 'discountBenefit' specified is not supported for this promotion Type. For help, see the documentation for this call.
                domain: API_MARKETING
              "345137":
                category: REQUEST
                description: The 'couponCode' data is missing for coded coupon promotions. For help, see the documentation for this call.
                domain: API_MARKETING
              "345138":
                category: REQUEST
                description: The 'couponCode' value is invalid. For help, see the documentation for this call.
                domain: API_MARKETING
              "345139":
                category: REQUEST
                description: The 'couponType' data is missing for coded coupon promotions. For help, see the documentation for this call.
                domain: API_MARKETING
              "345140":
                category: REQUEST
                description: The 'couponType' value is invalid. For help, see the documentation for this call.
                domain: API_MARKETING
              "345141":
                category: REQUEST
                description: The 'maxDiscountAmount' data is missing for coded coupon promotions. For help, see the documentation for this call.
                domain: API_MARKETING
              "345142":
                category: REQUEST
                description: The 'maxDiscountAmount' value is invalid. For help, see the documentation for this call.
                domain: API_MARKETING
              "345143":
                category: REQUEST
                description: The 'maxCouponRedemptionPerUser' value is invalid. For help, see the documentation for this call.
                domain: API_MARKETING
              "345144":
                category: REQUEST
                description: The 'budget' value is invalid. For help, see the documentation for this call.
                domain: API_MARKETING
              "345145":
                category: REQUEST
                description: A coupon with this 'couponCode' already exists. Please try a different 'couponCode'.
                domain: API_MARKETING
              "345146":
                category: REQUEST
                description: The 'currency' for 'maxDiscountAmount' and 'budget' has to be same. For help, see the documentation for this call.
                domain: API_MARKETING
              "345147":
                category: REQUEST
                description: "'promotionType' CODED_COUPON is currently not supported for this Marketplace ID. For help, see the documentation for this call."
                domain: API_MARKETING
              "345148":
                category: REQUEST
                description: The 'discountBenefit' value cannot exceed the 'maxDiscountAmount' value.
                domain: API_MARKETING
        "409":
          description: Business Error
          x-response-codes:
            errors:
              "38243":
                category: BUSINESS
                description: The 'minQuantity' value is invalid. This value must be an integer.
                domain: API_MARKETING
              "38244":
                category: BUSINESS
                description: The 'forEachQuantity' value is invalid. This value must be an integer.
                domain: API_MARKETING
              "38245":
                category: BUSINESS
                description: The 'minAmount' value is invalid. For help, see the documentation for this call.
                domain: API_MARKETING
              "38246":
                category: BUSINESS
                description: The 'forEachAmount' value is invalid. For help, see the documentation for this call.
                domain: API_MARKETING
              "38247":
                category: BUSINESS
                description: The 'numberOfDiscountedItems' value is invalid. This value must be an integer.
                domain: API_MARKETING
              "38248":
                category: BUSINESS
                description: The 'percentOffItem' value is invalid. For help, see the documentation for this call.
                domain: API_MARKETING
              "38249":
                category: BUSINESS
                description: The 'percentOffOrder' value is invalid. For help, see the documentation for this call.
                domain: API_MARKETING
              "38250":
                category: BUSINESS
                description: The 'amountOffItem' value is invalid. For help, see the documentation for this call.
                domain: API_MARKETING
              "38251":
                category: BUSINESS
                description: The 'amountOffOrder' value is invalid. For help, see the documentation for this call.
                domain: API_MARKETING
              "38266":
                category: BUSINESS
                description: The 'discountBenefit' value cannot exceed {maxDiscPercent}% of the 'discountSpecification.maxAmount' value.
                domain: API_MARKETING
              "38268":
                category: BUSINESS
                description: The 'discountBenefit' value cannot exceed {maxDiscPercent}% of the 'discountSpecification'.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "38201":
                category: APPLICATION
                description: Internal server error encountered. If this problem persists, contact the eBay Developers Program for support.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - item_promotion
  "/item_promotion/{promotion_id}":
    delete:
      description: This method deletes the threshold promotion specified by the <b>promotion_id</b> path parameter. Call <a href="/api-docs/sell/marketing/resources/promotion/methods/getPromotions">getPromotions</a> to retrieve the IDs of a seller's promotions.  <br><br>You can delete any promotion with the exception of those that are currently active (RUNNING). To end a running threshold promotion, call <a href="/api-docs/sell/marketing/resources/item_promotion/methods/updateItemPromotion">updateItemPromotion</a> and adjust the <b>endDate</b> field as appropriate.
      operationId: deleteItemPromotion
      parameters:
        - description: This path parameter takes a concatenation of the ID of the promotion you want to delete plus the marketplace ID on which the promotion is hosted. Concatenate the two values by separating them with an "at sign" (<b>@</b>).  <br><br>The ID of the promotion (<b>promotionId</b>) is a unique eBay-assigned value that's generated when the promotion is created. The Marketplace ID is the ENUM value of eBay marketplace where the promotion is hosted. <br><br><b>Example:</b> <code>1********5@EBAY_US</code>
          in: path
          name: promotion_id
          required: true
          schema:
            type: string
      responses:
        "204":
          description: No Content
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "38203":
                category: REQUEST
                description: Resource not found. Check the ID and try the call again.
                domain: API_MARKETING
              "38204":
                category: REQUEST
                description: The seller is not eligible for promotions because they do not have an eBay Store or they have not accepted the terms and conditions for creating a promotion on this Marketplace, see the documentation for this call.
                domain: API_MARKETING
              "38216":
                category: REQUEST
                description: A promotion can only be deleted if it is paused or ended.
                domain: API_MARKETING
              "345077":
                category: REQUEST
                description: You cannot update a promotion that was not created through the API.
                domain: API_MARKETING
        "404":
          description: Not Found
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "38201":
                category: APPLICATION
                description: Internal server error encountered. If this problem persists, please contact support.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - item_promotion
    get:
      description: This method returns the complete details of the threshold promotion specified by the <b>promotion_id</b> path parameter. Call <a href="/api-docs/sell/marketing/resources/promotion/methods/getPromotions">getPromotions</a> to retrieve the IDs of a seller's promotions.
      operationId: getItemPromotion
      parameters:
        - description: This path parameter takes a concatenation of the ID of the promotion you want to retrieve plus the marketplace ID on which the promotion is hosted. Concatenate the two values by separating them with an "at sign" (<b>@</b>).  <br><br>The ID of the promotion (<b>promotionId</b>) is a unique eBay-assigned value that's generated when the promotion is created. The Marketplace ID is the ENUM value of eBay marketplace where the promotion is hosted. <br><br><b>Example:</b> <code>1********5@EBAY_US</code>
          in: path
          name: promotion_id
          required: true
          schema:
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ItemPromotionResponse"
          description: Success
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "38203":
                category: REQUEST
                description: Resource not found. Check the ID and try the call again.
                domain: API_MARKETING
              "38204":
                category: REQUEST
                description: The seller is not eligible for promotions because they do not have an eBay Store or they have not accepted the terms and conditions for creating a promotion on this Marketplace, see the documentation for this call.
                domain: API_MARKETING
              "345076":
                category: REQUEST
                description: You cannot get the details of a promotion that was not created through the API.
                domain: API_MARKETING
        "404":
          description: Not Found
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "38201":
                category: APPLICATION
                description: Internal server error encountered. If this problem persists, contact the eBay Developers Program for support.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing.readonly
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - item_promotion
    put:
      description: "This method updates the specified threshold promotion with the new configuration that you supply in the request. Indicate the promotion you want to update using the <b>promotion_id</b> path parameter.  <p>Call <a href=\"/api-docs/sell/marketing/resources/promotion/methods/getPromotions\">getPromotions</a> to retrieve the IDs of a seller's promotions.</p>  <p>When updating a promotion, supply all the fields that you used to configure the original promotion (and not just the fields you are updating). eBay replaces the specified promotion with the values you supply in the update request and if you don't pass a field that currently has a value, the update request will fail.</p>  <p>The parameters you are allowed to update with this request depend on the status of the promotion you're updating:  <ul><li>DRAFT or SCHEDULED promotions: You can update any of the parameters in these promotions that have not yet started to run, including the <b>discountRules</b>.</li> <li>RUNNING or PAUSED promotions: You can change the <b>endDate</b> and the item's inventory but you cannot change the promotional discount or the promotion's start date.</li> <li>ENDED promotions: Nothing can be changed.</li></ul> <p class=\"tablenote\"><b>Tip:</b> When updating a <code>RUNNING</code> or <code>PAUSED</code> promotion, set the <b>status</b> field to <code>SCHEDULED</code> for the update request. When the promotion is updated, the previous status (either <code>RUNNING</code> or <code>PAUSED</code>) is retained.</p>"
      operationId: updateItemPromotion
      parameters:
        - description: This path parameter takes a concatenation of the ID of the promotion you want to update plus the marketplace ID on which the promotion is hosted. Concatenate the two values by separating them with an "at sign" (<b>@</b>).  <br><br>The ID of the promotion (<b>promotionId</b>) is a unique eBay-assigned value that's generated when the promotion is created. The Marketplace ID is the ENUM value of eBay marketplace where the promotion is hosted. <br><br><b>Example:</b> <code>1********5@EBAY_US</code>
          in: path
          name: promotion_id
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/ItemPromotion"
              description: This type defines the fields that describe an item promotion.
        description: This type defines the fields that describe an item promotion.
        required: false
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/BaseResponse"
          description: Success
          x-response-codes:
            errors:
              "38226":
                category: REQUEST
                description: The listing ID must be numeric if you're using listingIds.
                domain: API_MARKETING
              "38227":
                category: REQUEST
                description: The listing ID is invalid.
                domain: API_MARKETING
              "38263":
                category: REQUEST
                description: The SKU or custom label used in inventoryReferenceId exceeds the maximum length, which is {skuLength}.
                domain: API_MARKETING
              "38272":
                category: BUSINESS
                description: This listing is not eligible for a promotion because it's an auction-style listing.
                domain: API_MARKETING
              "38273":
                category: BUSINESS
                description: This listing is not eligible for a promotion because it's a minimum advertised price (MAP) listing.
                domain: API_MARKETING
              "38274":
                category: BUSINESS
                description: You haven't included electronic payment method  as a payment method. In order to make this listing eligible, update it to include electronic payment method .
                domain: API_MARKETING
              "38275":
                category: BUSINESS
                description: This SKU used in inventoryReferenceId matches an item that is part of a listing with variations. This SKU is only eligible if you add all of the listing variations. To add this listing, use the parent, or main, SKU (custom label).
                domain: API_MARKETING
              "345112":
                category: REQUEST
                description: Invalid Store category. Please refer to API documentation to source allowed values.
                domain: API_MARKETING
              "345113":
                category: REQUEST
                description: Invalid marketplace category ID. Please refer to API documentation for the supported values.
                domain: API_MARKETING
              "345137":
                category: REQUEST
                description: "'priority' can not be set for this promotion type. For help, see the documentation for this call."
                domain: API_MARKETING
              "345138":
                category: REQUEST
                description: "'description' can not be set for this promotion type. For help, see the documentation for this call."
                domain: API_MARKETING
              "345139":
                category: REQUEST
                description: "'applyDiscountToSingleItemOnly' can not be set for this promotion type. For help, see the documentation for this call."
                domain: API_MARKETING
              "345140":
                category: REQUEST
                description: "'promotionImageUrl' can not be set for this promotion type. For help, see the documentation for this call."
                domain: API_MARKETING
              "345142":
                category: REQUEST
                description: "'applyDiscountToSingleItemOnly' is currently not supported for this Marketplace ID. For help, see the documentation for this call."
                domain: API_MARKETING
              "345143":
                category: REQUEST
                description: "'couponType' can not be set for this promotion type. For help, see the documentation for this call."
                domain: API_MARKETING
              "345144":
                category: REQUEST
                description: "'maxCouponRedemptionPerUser' can not be set for this promotion type. For help, see the documentation for this call."
                domain: API_MARKETING
              "345145":
                category: REQUEST
                description: "'maxDiscountAmount' can not be set for this promotion type. For help, see the documentation for this call."
                domain: API_MARKETING
              "345146":
                category: REQUEST
                description: "'budget' can not be set for this promotion type. For help, see the documentation for this call."
                domain: API_MARKETING
              "345147":
                category: REQUEST
                description: "'couponCode' can not be set for this promotion type. For help, see the documentation for this call."
                domain: API_MARKETING
        "204":
          description: Success
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "38203":
                category: REQUEST
                description: Resource not found. Check the ID and try the call again.
                domain: API_MARKETING
              "38204":
                category: REQUEST
                description: The seller is not eligible for promotions because they do not have an eBay Store or they have not accepted the terms and conditions for creating a promotion on this Marketplace, see the documentation for this call.
                domain: API_MARKETING
              "38207":
                category: REQUEST
                description: The promotion priority is invalid. Please check and try the call again.
                domain: API_MARKETING
              "38210":
                category: REQUEST
                description: You cannot change the priority of a promotion that is ended or deleted.
                domain: API_MARKETING
              "38218":
                category: REQUEST
                description: A valid entry is required for {fieldName}.
                domain: API_MARKETING
              "38219":
                category: REQUEST
                description: The start date and time must be earlier than the end date and time.
                domain: API_MARKETING
              "38220":
                category: REQUEST
                description: The end date and time must be later than the current date and time.
                domain: API_MARKETING
              "38225":
                category: REQUEST
                description: You cannot update a promotion that has ended.
                domain: API_MARKETING
              "38228":
                category: REQUEST
                description: The amount value of '{fieldName}' contains decimals, only integers are supported.
                domain: API_MARKETING
              "38229":
                category: REQUEST
                description: The start date and time should be later than the current date and time.
                domain: API_MARKETING
              "38232":
                category: REQUEST
                description: You cannot update the promotion discount for an active promotion.
                domain: API_MARKETING
              "38234":
                category: REQUEST
                description: HTML is not allowed in the '{fieldName}' field.
                domain: API_MARKETING
              "38235":
                category: REQUEST
                description: Invalid input for the '{fieldName}' field. For help, see the documentation for this call.
                domain: API_MARKETING
              "38236":
                category: REQUEST
                description: The 'discountSpecification' data is missing, which is required by this call. For help, see the documentation for this call.
                domain: API_MARKETING
              "38237":
                category: REQUEST
                description: "The request can have only one of these fields: 'minQuantity', 'forEachQuantity', 'minAmount', or 'forEachAmount' in 'discountSpecification'. For help, see the documentation for this call."
                domain: API_MARKETING
              "38238":
                category: REQUEST
                description: The 'discountBenefit' data is missing, which is required by this call. For help, see the documentation for this call.
                domain: API_MARKETING
              "38239":
                category: REQUEST
                description: "The request can have only one of these fields: 'percentageOffOrder', 'amountOffOrder', 'percentageOffItem', or 'amountOffItem' in 'discountBenefit'. For help, see the documentation for this call."
                domain: API_MARKETING
              "38240":
                category: REQUEST
                description: Invalid input for the 'promotionStatus' field. For help, see the documentation for this call.
                domain: API_MARKETING
              "38241":
                category: REQUEST
                description: This discount rule combination is currently not supported. For help, see the documentation for this call.
                domain: API_MARKETING
              "38242":
                category: REQUEST
                description: "The request can have only one of these fields: 'inventoryCriterion.inventoryItems' or 'inventoryCriterion.listingIds'."
                domain: API_MARKETING
              "38253":
                category: REQUEST
                description: The data combination of 'DiscountSpecification' and 'DiscountBenefit' is not valid for this promotion type. For help, see the documentation for this call.
                domain: API_MARKETING
              "38255":
                category: REQUEST
                description: The promotion description exceeds the maximum length, which is {promoDescriptionLength}.
                domain: API_MARKETING
              "38256":
                category: REQUEST
                description: The promotion name exceeds the maximum length, which is {promoNameLength}.
                domain: API_MARKETING
              "38257":
                category: REQUEST
                description: This promotion type supports only one discount rule for the item promotion.
                domain: API_MARKETING
              "38260":
                category: REQUEST
                description: To update the start date of a promotion, the promotion must be in draft or scheduled state.
                domain: API_MARKETING
              "38261":
                category: REQUEST
                description: Promotions are currently limited to a maximum of {maxListingInclLimit} parent items, when entering item IDs or choosing from live inventory.
                domain: API_MARKETING
              "38262":
                category: REQUEST
                description: You can only include up to {maxSkuInclLimit} SKUs or custom labels in inventoryItems.
                domain: API_MARKETING
              "38265":
                category: REQUEST
                description: Number of discount items is greater than the quantity specified in 'DiscountSpecification'.
                domain: API_MARKETING
              "38267":
                category: REQUEST
                description: The 'DiscountBenefit.amountOffOrder' field cannot be used with the 'DiscountSpecification.numberOfDiscountedItems' field. This parameter is reserved for Buy x, Get x discounts. For help, see the documentation for this call.
                domain: API_MARKETING
              "38269":
                category: REQUEST
                description: The promotion ID does not match any of the seller's promotions.
                domain: API_MARKETING
              "38270":
                category: REQUEST
                description: The currency type does not match what is used for the Marketplace ID submitted.
                domain: API_MARKETING
              "38271":
                category: REQUEST
                description: Only new or scheduled promotions can be saved as a draft.
                domain: API_MARKETING
              "345077":
                category: REQUEST
                description: You cannot update a promotion that was not created through the API.
                domain: API_MARKETING
              "345110":
                category: REQUEST
                description: You can specify only one of Inventory Items, Listing IDs or Rules in the Inventory Criterion.
                domain: API_MARKETING
              "345111":
                category: REQUEST
                description: You cannot specify Rules when using the Inventory by Value Criterion.
                domain: API_MARKETING
              "345114":
                category: REQUEST
                description: A Category scope is required for the Rule. Please refer to API documentation for allowed values.
                domain: API_MARKETING
              "345115":
                category: REQUEST
                description: At least one Category is required. Please provide a valid input for this field and try again.
                domain: API_MARKETING
              "345116":
                category: REQUEST
                description: You can specify only Marketplace categories or Store categories when creating Rules.
                domain: API_MARKETING
              "345118":
                category: REQUEST
                description: You can specify only one of Inventory Items or Listing IDs in the Exclusion Criterion.
                domain: API_MARKETING
              "345120":
                category: REQUEST
                description: Invalid Item condition. Please refer to API documentation for allowed values.
                domain: API_MARKETING
              "345121":
                category: REQUEST
                description: You cannot specify Rules or inventory items when using the Inventory by ALL Criterion.
                domain: API_MARKETING
              "345122":
                category: REQUEST
                description: category ids cannot be specified with the inventory of type any.
                domain: API_MARKETING
              "345123":
                category: REQUEST
                description: brands cannot be specified with inventory of type any or Store.
                domain: API_MARKETING
              "345124":
                category: REQUEST
                description: Exclusions are currently limited to a maximum of 100 parent items, when entering Inventory Items or Listing IDs, or choosing from live inventory.
                domain: API_MARKETING
              "345125":
                category: REQUEST
                description: You cannot specify a child Marketplace Category ID when the parent Marketplace Category ID is already specified. Please refer to the API documentation to source allowed values.
                domain: API_MARKETING
              "345126":
                category: REQUEST
                description: You cannot specify a child Store Category ID when the parent Store Category ID is already specified. Please refer to the API documentation to source allowed values.
                domain: API_MARKETING
              "345127":
                category: REQUEST
                description: Category aspects are not supported in this version.
                domain: API_MARKETING
              "345128":
                category: REQUEST
                description: The minimum discount rules required for volume discount promotions are {numOfDiscountRules}
                domain: API_MARKETING
              "345129":
                category: REQUEST
                description: The 'discountRules.ruleOrder' is missing or invalid for one of the discount rules for volume discount promotions. see the documentation for this call.
                domain: API_MARKETING
              "345130":
                category: REQUEST
                description: You can include up to a maximum of {numOfDiscountRules} discount rules in a volume discount promotion.
                domain: API_MARKETING
              "345131":
                category: REQUEST
                description: Each 'minQuantity' value should be one greater than the 'minQuantity' value of the previous discount rule.
                domain: API_MARKETING
              "345132":
                category: REQUEST
                description: The discount value is invalid for one of the discount rules for volume discount promotions. see the documentation for this call.
                domain: API_MARKETING
              "345133":
                category: REQUEST
                description: Each 'percentageOffOrder' or 'amountOffOrder' value should be greater than the 'percentageOffOrder' or 'amountOffOrder' value of the previous discount rule for volume discount promotions.
                domain: API_MARKETING
              "345134":
                category: REQUEST
                description: This promotionType is currently not supported. For help, see the documentation for this call.
                domain: API_MARKETING
              "345135":
                category: REQUEST
                description: You cannot update the promotion type for a promotion.
                domain: API_MARKETING
              "345136":
                category: REQUEST
                description: The 'discountBenefit' specified is not supported for this promotion Type. For help, see the documentation for this call.
                domain: API_MARKETING
              "345137":
                category: REQUEST
                description: The 'couponCode' value is invalid. For help, see the documentation for this call.
                domain: API_MARKETING
              "345138":
                category: REQUEST
                description: You cannot update the 'couponCode' for an active or paused promotion.
                domain: API_MARKETING
              "345139":
                category: REQUEST
                description: The 'couponType' data is invalid. For help, see the documentation for this call.
                domain: API_MARKETING
              "345140":
                category: REQUEST
                description: You cannot update the 'couponType' for an active or paused promotion.
                domain: API_MARKETING
              "345141":
                category: REQUEST
                description: The 'maxCouponRedemptionPerUser' value is invalid. For help, see the documentation for this call.
                domain: API_MARKETING
              "345142":
                category: REQUEST
                description: You cannot update the 'maxCouponRedemptionPerUser' for an active or paused promotion.
                domain: API_MARKETING
              "345143":
                category: REQUEST
                description: |
                  The 'maxDiscountAmount' value is invalid. For help, see the documentation for this call.
                domain: API_MARKETING
              "345144":
                category: REQUEST
                description: You cannot update the 'maxDiscountAmount' for an active or paused promotion.
                domain: API_MARKETING
              "345145":
                category: REQUEST
                description: You cannot apply a 'budget' to an active or paused promotion. For help, see the documentation for this call.
                domain: API_MARKETING
              "345146":
                category: REQUEST
                description: The 'budget' value is invalid. For help, see the documentation for this call.
                domain: API_MARKETING
              "345147":
                category: REQUEST
                description: The 'budget' value cannot be decreased. For help, see the documentation for this call.
                domain: API_MARKETING
              "345148":
                category: REQUEST
                description: A coupon with this 'couponCode' already exists. Please try a different 'couponCode'.
                domain: API_MARKETING
              "345149":
                category: REQUEST
                description: The 'currency' for 'maxDiscountAmount' and 'budget' has to be same. For help, see the documentation for this call.
                domain: API_MARKETING
              "345150":
                category: REQUEST
                description: "'promotionType' CODED_COUPON is currently not supported for this Marketplace ID. For help, see the documentation for this call."
                domain: API_MARKETING
              "345151":
                category: REQUEST
                description: The 'discountBenefit' value cannot exceed the 'maxDiscountAmount' value.
                domain: API_MARKETING
        "404":
          description: Not Found
        "409":
          description: Conflict
          x-response-codes:
            errors:
              "38243":
                category: BUSINESS
                description: The 'minQuantity' value is invalid. This value must be an integer.
                domain: API_MARKETING
              "38244":
                category: BUSINESS
                description: The 'forEachQuantity' value is invalid. This value must be an integer.
                domain: API_MARKETING
              "38245":
                category: BUSINESS
                description: The 'minAmount' value is invalid. For help, see the documentation for this call.
                domain: API_MARKETING
              "38246":
                category: BUSINESS
                description: The 'forEachAmount' value is invalid. For help, see the documentation for this call.
                domain: API_MARKETING
              "38247":
                category: BUSINESS
                description: The 'numberOfDiscountedItems' value is invalid. This value must be an integer.
                domain: API_MARKETING
              "38248":
                category: BUSINESS
                description: The 'percentOffItem' value is invalid. For help, see the documentation for this call.
                domain: API_MARKETING
              "38249":
                category: BUSINESS
                description: The 'percentOffOrder' value is invalid. For help, see the documentation for this call.
                domain: API_MARKETING
              "38250":
                category: BUSINESS
                description: The 'amountOffItem' value is invalid. For help, see the documentation for this call.
                domain: API_MARKETING
              "38251":
                category: BUSINESS
                description: The 'amountOffOrder' value is invalid. For help, see the documentation for this call.
                domain: API_MARKETING
              "38266":
                category: BUSINESS
                description: The 'discountBenefit' value cannot exceed {maxDiscPercent}% of the 'discountSpecification.maxAmount' value.
                domain: API_MARKETING
              "38268":
                category: BUSINESS
                description: The 'discountBenefit' value cannot exceed {maxDiscPercent}% of the 'discountSpecification'.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "38201":
                category: APPLICATION
                description: Internal server error encountered. If this problem persists, please contact support.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - item_promotion
  /negative_keyword:
    get:
      description: <span class="tablenote"><b>Note:</b> This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program. For information about how to request access to this program, refer to <a href="/api-docs/sell/static/marketing/pl-verify-eligibility.html#access-requests " target="_blank "> Promoted Listings Advanced Access Requests</a> in the Promoted Listings Playbook. To determine if a seller qualifies for PLA, use the <a href="/api-docs/sell/account/resources/advertising_eligibility/methods/getAdvertisingEligibility " target="_blank ">getAdvertisingEligibility</a> method in Account API.</span><br />This method can be used to retrieve all of the negative keywords for ad groups in PLA campaigns that use the Cost Per Click (CPC) funding model.<br /><br />The results can be filtered using the <b>campaign_ids</b>, <b>ad_group_ids</b>, and <b>negative_keyword_status</b> query parameters.<br /><br />Call the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method to retrieve a list of current campaign IDs for a seller.
      operationId: getNegativeKeywords
      parameters:
        - description: A comma-separated list of ad group IDs.<br /><br />This query parameter is used if the seller wants to retrieve the negative keywords from one or more specific ad groups. The results might not include these ad group IDs if other search conditions exclude them.<br /><br /><span class="tablenote"><b>Note:</b>You can call the <a href="/api-docs/sell/marketing/resources/adgroup/methods/getAdGroups">getAdGroups</a> method to retrieve the ad group IDs for a seller.</span><br /><br /><i>Required if</i> the search results must be filtered to include negative keywords created at the ad group level.
          in: query
          name: ad_group_ids
          required: false
          schema:
            type: string
        - description: A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.<br /><br />This query parameter is used if the seller wants to retrieve the negative keywords from a specific campaign. The results might not include these campaign IDs if other search conditions exclude them.<br /><br /><span class="tablenote"><b>Note:</b> Currently, only one campaign ID value is supported for each request.</span>
          in: query
          name: campaign_ids
          required: false
          schema:
            type: string
        - description: The number of results, from the current result set, to be returned in a single page.
          in: query
          name: limit
          required: false
          schema:
            type: string
        - description: A comma-separated list of negative keyword statuses.<br /><br />This query parameter is used if the seller wants to filter the search results based on one or more negative keyword statuses.
          in: query
          name: negative_keyword_status
          required: false
          schema:
            type: string
        - description: The number of results that will be skipped in the result set. This is used with the <b>limit</b> field to control the pagination of the output.<br /><br />For example, if the <b>offset</b> is set to <code>0</code> and the <b>limit</b> is set to <code>10</code>, the method will retrieve items 1 through 10 from the list of items returned. If the <b>offset</b> is set to <code>10</code> and the <b>limit</b> is set to <code>10</code>, the method will retrieve items 11 through 20 from the list of items returned.
          in: query
          name: offset
          required: false
          schema:
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/NegativeKeywordPagedCollectionResponse"
          description: Success
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35029":
                category: REQUEST
                description: The 'limit' has to be greater than zero and less than {maxLimitValue}.
                domain: API_MARKETING
              "35030":
                category: REQUEST
                description: The 'offset' cannot be less than zero.
                domain: API_MARKETING
              "36329":
                category: REQUEST
                description: The ad group Id is required.
                domain: API_MARKETING
              "36347":
                category: REQUEST
                description: Currently only one value is supported for 'campaign_ids'.
                domain: API_MARKETING
              "36350":
                category: REQUEST
                description: The 'negative_keyword_status' is invalid.
                domain: API_MARKETING
        "403":
          description: Forbidden
        "404":
          description: Not Found
        "409":
          description: Conflict
          x-response-codes:
            errors:
              "35089":
                category: BUSINESS
                description: We are currently testing a premium ads product with a small invite-only group. We will share more information when we are ready to expand.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing.readonly
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - negative_keyword
    post:
      description: <span class="tablenote"><b>Note:</b> This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program. For information about how to request access to this program, refer to <a href="/api-docs/sell/static/marketing/pl-verify-eligibility.html#access-requests " target="_blank "> Promoted Listings Advanced Access Requests</a> in the Promoted Listings Playbook. To determine if a seller qualifies for PLA, use the <a href="/api-docs/sell/account/resources/advertising_eligibility/methods/getAdvertisingEligibility " target="_blank ">getAdvertisingEligibility</a> method in Account API.</span><br />This method adds a negative keyword to an existing ad group in a PLA campaign that uses the Cost Per Click (CPC) funding model.<br /><br />Specify the <b>campaignId</b> and <b>adGroupId</b> in the request body, along with the <b>negativeKeywordText</b> and <b>negativeKeywordMatchType</b>.<br /><br />Call the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method to retrieve a list of current campaign IDs for a specified seller.
      operationId: createNegativeKeyword
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/CreateNegativeKeywordRequest"
              description: A type that defines the fields for the request to create a negative keyword.
        description: A type that defines the fields for the request to create a negative keyword.
        required: true
      responses:
        "201":
          content:
            application/json:
              schema:
                type: object
          description: Created
          headers:
            Location:
              schema:
                description: The <b>location</b> response header contains the URI of the newly created negative keyword. The URI includes the newly created <code>negativeKeywordId</code>, which you can use to reference the negative keyword.
                type: string
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "35035":
                category: REQUEST
                description: The campaign with campaign id {campaign_id} has ended.
                domain: API_MARKETING
              "35045":
                category: REQUEST
                description: No campaign found for campaign id {campaign_id}.
                domain: API_MARKETING
              "36210":
                category: REQUEST
                description: No ad group found for ad group id {ad_group_id}.
                domain: API_MARKETING
              "36219":
                category: REQUEST
                description: The ad group with ad group id {ad_group_id} has been archived.
                domain: API_MARKETING
              "36323":
                category: REQUEST
                description: "'negativeKeywordText' {negativeKeywordText} and 'negativeKeywordMatchType' {negativeKeywordMatchType} already exists for this Campaign."
                domain: API_MARKETING
              "36330":
                category: REQUEST
                description: "The provided negative keyword match type is not supported. Valid values are: {negativeKeywordMatchTypeValues}."
                domain: API_MARKETING
              "36331":
                category: REQUEST
                description: "'negativeKeywordText' {negativeKeywordText} and 'negativeKeywordMatchType' {negativeKeywordMatchType} already exists for this Ad Group."
                domain: API_MARKETING
              "36332":
                category: REQUEST
                description: "'negativeKeywordText' {negativeKeywordText} cannot be more than {maxNegativeKeywordTextLength} characters."
                domain: API_MARKETING
              "36333":
                category: REQUEST
                description: "'negativeKeywordText' cannot be null or empty"
                domain: API_MARKETING
              "36334":
                category: REQUEST
                description: "'negativeKeywordText' contains invalid characters {invalidCharacters}"
                domain: API_MARKETING
              "36335":
                category: REQUEST
                description: You have exceeded the maximum number of negative keyword for an ad group. Only {maxSupportedNegativeKeywordNumber} Ids are supported per ad group.
                domain: API_MARKETING
              "36336":
                category: REQUEST
                description: "'negativeKeywordText' {negativeKeywordText} cannot have total number of words more than {maxWordsInNegativeKeyword} words."
                domain: API_MARKETING
              "36345":
                category: REQUEST
                description: "'campaignId' and 'adGroupId' are required."
                domain: API_MARKETING
              "36346":
                category: REQUEST
                description: You have exceeded the maximum number of negative keyword for a campaign. Only {maxSupportedNegativeKeywordNumberCampaign} Ids are supported per campaign.
                domain: API_MARKETING
        "403":
          description: Forbidden
        "409":
          description: Conflict
          x-response-codes:
            errors:
              "35089":
                category: BUSINESS
                description: We are currently testing a premium ads product with a small invite-only group. We will share more information when we are ready to expand.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - negative_keyword
  "/negative_keyword/{negative_keyword_id}":
    get:
      description: <span class="tablenote"><b>Note:</b> This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program. For information about how to request access to this program, refer to <a href="/api-docs/sell/static/marketing/pl-verify-eligibility.html#access-requests " target="_blank "> Promoted Listings Advanced Access Requests</a> in the Promoted Listings Playbook. To determine if a seller qualifies for PLA, use the <a href="/api-docs/sell/account/resources/advertising_eligibility/methods/getAdvertisingEligibility " target="_blank ">getAdvertisingEligibility</a> method in Account API.</span><br />This method retrieves details on a specific negative keyword.<br /><br />In the request, specify the <b>negative_keyword_id</b> as a path parameter.
      operationId: getNegativeKeyword
      parameters:
        - description: The unique identifier for the negative keyword.<br /><br />This value is returned in the <b>Location</b> response header from the <a href="/api-docs/sell/marketing/resources/negative_keyword/methods/createNegativeKeyword">createNegativeKeyword</a> method.
          in: path
          name: negative_keyword_id
          required: true
          schema:
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/NegativeKeyword"
          description: Success
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "36340":
                category: REQUEST
                description: No negative keyword found for negative keyword id {negativeKeywordId}.
                domain: API_MARKETING
        "403":
          description: Forbidden
        "404":
          description: Not Found
        "409":
          description: Conflict
          x-response-codes:
            errors:
              "35089":
                category: BUSINESS
                description: We are currently testing a premium ads product with a small invite-only group. We will share more information when we are ready to expand.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing.readonly
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - negative_keyword
    put:
      description: <span class="tablenote"><b>Note:</b> This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program. For information about how to request access to this program, refer to <a href="/api-docs/sell/static/marketing/pl-verify-eligibility.html#access-requests " target="_blank "> Promoted Listings Advanced Access Requests</a> in the Promoted Listings Playbook. To determine if a seller qualifies for PLA, use the <a href="/api-docs/sell/account/resources/advertising_eligibility/methods/getAdvertisingEligibility " target="_blank ">getAdvertisingEligibility</a> method in Account API.</span><br />This method updates the status of an existing negative keyword.<br /><br />Specify the <b>negative_keyword_id</b> as a path parameter, and specify the <b>negativeKeywordStatus</b> in the request body.
      operationId: updateNegativeKeyword
      parameters:
        - description: The unique identifier for the negative keyword.<br /><br />This value is returned in the <b>Location</b> response header from the <a href="/api-docs/sell/marketing/resources/negative_keyword/methods/createNegativeKeyword">createNegativeKeyword</a> method.
          in: path
          name: negative_keyword_id
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/UpdateNegativeKeywordRequest"
              description: A type that defines the fields for the request to update a negative keyword.
        description: A type that defines the fields for the request to update a negative keyword.
        required: true
      responses:
        "204":
          description: Success
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "36340":
                category: REQUEST
                description: No negative keyword found for negative keyword id {negativeKeywordId}.
                domain: API_MARKETING
              "36342":
                category: REQUEST
                description: NegativeKeywordStatus is missing or invalid. It is required for update.
                domain: API_MARKETING
              "36343":
                category: REQUEST
                description: Negative keyword with negative keyword id {negativeKeywordId} is already archived and cannot be updated.
                domain: API_MARKETING
        "403":
          description: Forbidden
        "404":
          description: Not Found
        "409":
          description: Business error
          x-response-codes:
            errors:
              "35089":
                category: BUSINESS
                description: We are currently testing a premium ads product with a small invite-only group. We will share more information when we are ready to expand.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "35001":
                category: APPLICATION
                description: There was a problem with an eBay internal system or process. Contact eBay Developer Technical Support for assistance.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - negative_keyword
  /promotion:
    get:
      description: This method returns a list of a seller's undeleted promotions. <p>The call returns up to 200 currently-available promotions on the specified marketplace. While the response body does not include the promotion's <b>discountRules</b> or <b>inventoryCriterion</b> containers, it does include the <b>promotionHref</b> (which you can use to retrieve the complete details of the promotion).</p>  <p>Use query parameters to sort and filter the results by the number of promotions to return, the promotion state or type, and the eBay marketplace. You can also supply keywords to limit the response to the promotions that contain that keywords in the title of the promotion.</p> <p><b>Maximum returned:</b> 200</p>
      operationId: getPromotions
      parameters:
        - description: Specifies the maximum number of promotions returned on a page from the result set.  <br><br><b>Default:</b> 200 <br><b>Maximum:</b> 200
          in: query
          name: limit
          required: false
          schema:
            type: string
        - description: The eBay marketplace ID of the site where the promotion is hosted.  <p><b>Valid values:</b></p>  <ul><li><code>EBAY_AU</code> = Australia</li> <li><code>EBAY_DE</code> = Germany</li> <li><code>EBAY_ES</code> = Spain</li> <li><code>EBAY_FR</code> = France</li> <li><code>EBAY_GB</code> = Great Britain</li> <li><code>EBAY_IT</code> = Italy</li> <li><code>EBAY_US</code> = United States</li></ul>
          in: query
          name: marketplace_id
          required: true
          schema:
            type: string
        - description: Specifies the number of promotions to skip in the result set before returning the first promotion in the paginated response.  <p>Combine <b>offset</b> with the <b>limit</b> query parameter to control the items returned in the response. For example, if you supply an <b>offset</b> of <code>0</code> and a <b>limit</b> of <code>10</code>, the first page of the response contains the first 10 items from the complete list of items retrieved by the call. If <b>offset</b> is <code>10</code> and <b>limit</b> is <code>20</code>, the first page of the response contains items 11-30 from the complete result set.</p> <p><b>Default:</b> 0</p>
          in: query
          name: offset
          required: false
          schema:
            type: string
        - description: Specifies the promotion state by which you want to filter the results. The response contains only those promotions that match the state you specify.  <br><br><b>Valid values:</b> <ul><li><code>DRAFT</code></li> <li><code>SCHEDULED</code></li> <li><code>RUNNING</code></li> <li><code>PAUSED</code></li> <li><code>ENDED</code></li></ul><b>Maximum number of input values:</b> 1
          in: query
          name: promotion_status
          required: false
          schema:
            type: string
        - description: "Filters the returned promotions based on their campaign promotion type. Specify one of the following values to indicate the promotion type you want returned: <ul><li><code>CODED_COUPON</code> &ndash; A coupon code promotion set with <b>createItemPromotion</b>.</li> <li><code>MARKDOWN_SALE</code> &ndash; A markdown promotion set with <b>createItemPriceMarkdownPromotion</b>.</li> <li><code>ORDER_DISCOUNT</code> &ndash; A threshold promotion set with <b>createItemPromotion</b>.</li> <li><code>VOLUME_DISCOUNT</code> &ndash; A volume pricing promotion set with <b>createItemPromotion</b>.</li></ul>"
          in: query
          name: promotion_type
          required: false
          schema:
            type: string
        - description: A string consisting of one or more <i>keywords</i>. eBay filters the response by returning only the promotions that contain the supplied keywords in the promotion title.  <br><br><b>Example:</b> "iPhone" or "Harry Potter."  <br><br>Commas that separate keywords are ignored. For example, a keyword string of "iPhone, iPad" equals "iPhone iPad", and each results in a response that contains promotions with both "iPhone" and "iPad" in the title.
          in: query
          name: q
          required: false
          schema:
            type: string
        - description: Specifies the order for how to sort the response. If you precede the supplied value with a dash, the response is sorted in reverse order.  <br><br><b>Example:</b> <br>&nbsp;&nbsp;&nbsp;<code>sort=END_DATE</code> &nbsp; Sorts the promotions in the response by their end dates in ascending order <br>&nbsp;&nbsp;&nbsp;<code>sort=-PROMOTION_NAME</code> &nbsp; Sorts the promotions by their promotion name in descending alphabetical order (Z-Az-a)  <br><br><b>Valid values</b>:<ul><li><code>START_DATE</code></li> <li><code>END_DATE</code></li> <li><code>PROMOTION_NAME</code></li></ul> For implementation help, refer to eBay API documentation at https://developer.ebay.com/api-docs/sell/marketing/types/csb:SortField
          in: query
          name: sort
          required: false
          schema:
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PromotionsPagedCollection"
          description: Success
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "38204":
                category: REQUEST
                description: The seller is not eligible for promotions because they do not have an eBay Store or they have not accepted the terms and conditions for creating a promotion on this Marketplace, see the documentation for this call.
                domain: API_MARKETING
              "38211":
                category: REQUEST
                description: The offset value must be an integer value greater than or equal to zero.
                domain: API_MARKETING
              "38212":
                category: REQUEST
                description: The sort value was not valid. For the valid values, see the documentation for this call.
                domain: API_MARKETING
              "38213":
                category: REQUEST
                description: You can query a limit of between 0 and 200 promotion records at a time. Update the request and resubmit the call.
                domain: API_MARKETING
              "38240":
                category: REQUEST
                description: Invalid input for the 'promotionStatus' field. For help, see the documentation for this call.
                domain: API_MARKETING
              "345141":
                category: REQUEST
                description: Invalid input for the 'promotionType' field. For help, see the documentation for this call.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "38201":
                category: APPLICATION
                description: Internal server error encountered. If this problem persists, contact the eBay Developers Program for support.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing.readonly
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - promotion
  "/promotion/{promotion_id}/get_listing_set":
    get:
      description: "This method returns the set of listings associated with the <b>promotion_id</b> specified in the path parameter. Call <a href=\"/api-docs/sell/marketing/resources/promotion/methods/getPromotions\">getPromotions</a> to retrieve the IDs of a seller's promotions.  <p>The listing details are returned in a paginated set and you can control and results returned using the following query parameters: <b>limit</b>, <b>offset</b>, <b>q</b>, <b>sort</b>, and <b>status</b>.</p>  <ul><li><b>Maximum associated listings returned:</b> 200</li>  <li><b>Default number of listings returned:</b> 200</li></ul>"
      operationId: getListingSet
      parameters:
        - description: Specifies the maximum number of promotions returned on a page from the result set. <br><br><b>Default:</b> 200<br><b>Maximum:</b> 200
          in: query
          name: limit
          required: false
          schema:
            type: string
        - description: Specifies the number of promotions to skip in the result set before returning the first promotion in the paginated response.  <p>Combine <b>offset</b> with the <b>limit</b> query parameter to control the items returned in the response. For example, if you supply an <b>offset</b> of <code>0</code> and a <b>limit</b> of <code>10</code>, the first page of the response contains the first 10 items from the complete list of items retrieved by the call. If <b>offset</b> is <code>10</code> and <b>limit</b> is <code>20</code>, the first page of the response contains items 11-30 from the complete result set.</p> <p><b>Default:</b> 0</p>
          in: query
          name: offset
          required: false
          schema:
            type: string
        - description: This path parameter takes a concatenation of the ID of the promotion you want to get plus the marketplace ID on which the promotion is hosted. Concatenate the two values by separating them with an "at sign" (<b>@</b>).  <br><br>The ID of the promotion (<b>promotionId</b>) is a unique eBay-assigned value that's generated when the promotion is created. The Marketplace ID is the ENUM value of eBay marketplace where the promotion is hosted. <br><br><b>Example:</b> <code>1********5@EBAY_US</code>
          in: path
          name: promotion_id
          required: true
          schema:
            type: string
        - description: Reserved for future use.
          in: query
          name: q
          required: false
          schema:
            type: string
        - description: Specifies the order in which to sort the associated listings in the response. If you precede the supplied value with a dash, the response is sorted in reverse order.  <br><br><b>Example:</b> <br>&nbsp;&nbsp;&nbsp;<code>sort=PRICE</code> - Sorts the associated listings by their current price in ascending order <br>&nbsp;&nbsp;&nbsp;<code>sort=-TITLE</code> - Sorts the associated listings by their title in descending alphabetical order (Z-Az-a)  <br><br><b>Valid values</b>:<ul class="compact"><li>AVAILABLE</li> <li>PRICE</li> <li>TITLE</li></ul> For implementation help, refer to eBay API documentation at https://developer.ebay.com/api-docs/sell/marketing/types/csb:SortField
          in: query
          name: sort
          required: false
          schema:
            type: string
        - description: This query parameter applies only to markdown promotions. It filters the response based on the indicated status of the promotion. Currently, the only supported value for this parameter is <code>MARKED_DOWN</code>, which indicates active markdown promotions. For implementation help, refer to eBay API documentation at https://developer.ebay.com/api-docs/sell/marketing/types/sme:ItemMarkdownStatusEnum
          in: query
          name: status
          required: false
          schema:
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ItemsPagedCollection"
          description: Success
          x-response-codes:
            errors:
              "345062":
                category: REQUEST
                description: Sort is not supported for this promotion type. For help, see the documentation for this call.
                domain: API_MARKETING
              "345068":
                category: REQUEST
                description: The value of the 'Status' parameter is invalid. For help, see the documentation for this call.
                domain: API_MARKETING
              "345069":
                category: REQUEST
                description: The 'Status' parameter is only supported for itemPriceMarkdownPromotions. For help, see the documentation for this call.
                domain: API_MARKETING
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "38203":
                category: REQUEST
                description: Resource not found. Check the ID and try the call again.
                domain: API_MARKETING
              "38204":
                category: REQUEST
                description: The seller is not eligible for promotions because they do not have an eBay Store or they have not accepted the terms and conditions for creating a promotion on this Marketplace, see the documentation for this call.
                domain: API_MARKETING
              "38211":
                category: REQUEST
                description: The offset value must be an integer value greater than or equal to zero.
                domain: API_MARKETING
              "38212":
                category: REQUEST
                description: The sort value was not valid. For the valid values, see the documentation for this call.
                domain: API_MARKETING
              "38213":
                category: REQUEST
                description: You can query a limit of between 0 and 200 promotion records at a time. Update the request and resubmit the call.
                domain: API_MARKETING
        "404":
          description: Not Found
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "38201":
                category: APPLICATION
                description: Internal server error encountered. If this problem persists, contact the eBay Developers Program for support.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - promotion
  "/promotion/{promotion_id}/pause":
    post:
      description: This method pauses a currently-active (RUNNING) threshold promotion and changes the state of the promotion from <code>RUNNING</code> to <code>PAUSED</code>. Pausing a promotion makes the promotion temporarily unavailable to buyers and any currently-incomplete transactions will not receive the promotional offer until the promotion is resumed. Also, promotion teasers are not displayed when a promotion is paused.  <br><br>Pass the ID of the promotion you want to pause using the <b>promotion_id</b> path parameter. Call <a href="/api-docs/sell/marketing/resources/promotion/methods/getPromotions">getPromotions</a> to retrieve the IDs of the seller's promotions. <br><br><b>Note:</b> You can only pause threshold promotions (you cannot pause markdown promotions).
      operationId: pausePromotion
      parameters:
        - description: This path parameter takes a concatenation of the ID of the promotion you want to pause plus the marketplace ID on which the promotion is hosted. Concatenate the two values by separating them with an "at sign" (<b>@</b>).  <br><br>The ID of the promotion (<b>promotionId</b>) is a unique eBay-assigned value that's generated when the promotion is created. The Marketplace ID is the ENUM value of eBay marketplace where the promotion is hosted. <br><br><b>Example:</b> <code>1********5@EBAY_US</code>
          in: path
          name: promotion_id
          required: true
          schema:
            type: string
      responses:
        "204":
          description: Success
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "38203":
                category: REQUEST
                description: Resource not found. Check the ID and try the call again.
                domain: API_MARKETING
              "38204":
                category: REQUEST
                description: The seller is not eligible for promotions because they do not have an eBay Store or they have not accepted the terms and conditions for creating a promotion on this Marketplace, see the documentation for this call.
                domain: API_MARKETING
              "38214":
                category: REQUEST
                description: A promotion can only be paused if it is scheduled or running.
                domain: API_MARKETING
              "345077":
                category: REQUEST
                description: You cannot update a promotion that was not created through the API.
                domain: API_MARKETING
        "404":
          description: Not Found
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "38201":
                category: APPLICATION
                description: Internal server error encountered. If this problem persists, contact the eBay Developers Program for support.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - promotion
  "/promotion/{promotion_id}/resume":
    post:
      description: This method restarts a threshold promotion that was previously paused and changes the state of the promotion from <code>PAUSED</code> to <code>RUNNING</code>. Only promotions that have been previously paused can be resumed. Resuming a promotion reinstates the promotional teasers and any transactions that were in motion before the promotion was paused will again be eligible for the promotion.  <br><br>Pass the ID of the promotion you want to resume using the <b>promotion_id</b> path parameter. Call <a href="/api-docs/sell/marketing/resources/promotion/methods/getPromotions">getPromotions</a> to retrieve the IDs of the seller's promotions.
      operationId: resumePromotion
      parameters:
        - description: This path parameter takes a concatenation of the ID of the promotion you want to resume plus the marketplace ID on which the promotion is hosted. Concatenate the two values by separating them with an "at sign" (<b>@</b>).  <br><br>The ID of the promotion (<b>promotionId</b>) is a unique eBay-assigned value that's generated when the promotion is created. The Marketplace ID is the ENUM value of eBay marketplace where the promotion is hosted. <br><br><b>Example:</b> <code>1********5@EBAY_US</code>
          in: path
          name: promotion_id
          required: true
          schema:
            type: string
      responses:
        "204":
          description: Success
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "38203":
                category: REQUEST
                description: Resource not found. Check the ID and try the call again.
                domain: API_MARKETING
              "38204":
                category: REQUEST
                description: The seller is not eligible for promotions because they do not have an eBay Store or they have not accepted the terms and conditions for creating a promotion on this Marketplace, see the documentation for this call.
                domain: API_MARKETING
              "38209":
                category: REQUEST
                description: You cannot resume a promotion that is not paused or has already ended.
                domain: API_MARKETING
              "345077":
                category: REQUEST
                description: You cannot update a promotion that was not created through the API.
                domain: API_MARKETING
        "404":
          description: Not Found
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "38201":
                category: APPLICATION
                description: Internal server error encountered. If this problem persists, contact the eBay Developers Program for support.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - promotion
  /promotion_report:
    get:
      description: This method generates a report that lists the seller's running, paused, and ended promotions for the specified eBay marketplace. The result set can be filtered by the promotion status and the number of results to return. You can also supply <i>keywords</i> to limit the report to promotions that contain the specified keywords. <br><br>Specify the eBay marketplace for which you want the report run using the <b>marketplace_id</b> query parameter. Supply additional query parameters to control the report as needed.
      operationId: getPromotionReports
      parameters:
        - description: Specifies the maximum number of promotions returned on a page from the result set.  <br><br><b>Default:</b> 200 <br><b>Maximum:</b> 200
          in: query
          name: limit
          required: false
          schema:
            type: string
        - description: The eBay marketplace ID of the site for which you want the promotions report.  <p><b>Valid values:</b>  </p><ul><li><code>EBAY_AU</code> = Australia</li> <li><code>EBAY_DE</code> = Germany</li> <li><code>EBAY_ES</code> = Spain</li> <li><code>EBAY_FR</code> = France</li> <li><code>EBAY_GB</code> = Great Britain</li> <li><code>EBAY_IT</code> = Italy</li> <li><code>EBAY_US</code> = United States</li></ul>
          in: query
          name: marketplace_id
          required: true
          schema:
            type: string
        - description: Specifies the number of promotions to skip in the result set before returning the first promotion in the paginated response.  <p>Combine <b>offset</b> with the <b>limit</b> query parameter to control the items returned in the response. For example, if you supply an <b>offset</b> of <code>0</code> and a <b>limit</b> of <code>10</code>, the first page of the response contains the first 10 items from the complete list of items retrieved by the call. If <b>offset</b> is <code>10</code> and <b>limit</b> is <code>20</code>, the first page of the response contains items 11-30 from the complete result set.</p> <p><b>Default:</b> 0</p>
          in: query
          name: offset
          required: false
          schema:
            type: string
        - description: Limits the results to the promotions that are in the state specified by this query parameter.  <br><br><b>Valid values:</b> <ul><li><code>DRAFT</code></li> <li><code>SCHEDULED</code></li> <li><code>RUNNING</code></li> <li><code>PAUSED</code></li> <li><code>ENDED</code></li></ul><b>Maximum number of values supported:</b> 1
          in: query
          name: promotion_status
          required: false
          schema:
            type: string
        - description: "Filters the returned promotions in the report based on their campaign promotion type. Specify one of the following values to indicate the promotion type you want returned in the report: <ul><li><code>CODED_COUPON</code> &ndash; A coupon code promotion set with <b>createItemPromotion</b>.</li> <li><code>MARKDOWN_SALE</code> &ndash; A markdown promotion set with <b>createItemPriceMarkdownPromotion</b>.</li> <li><code>ORDER_DISCOUNT</code> &ndash; A threshold promotion set with <b>createItemPromotion</b>.</li> <li><code>VOLUME_DISCOUNT</code> &ndash; A volume pricing promotion set with <b>createItemPromotion</b>.</li></ul>"
          in: query
          name: promotion_type
          required: false
          schema:
            type: string
        - description: A string consisting of one or more <i>keywords</i>. eBay filters the response by returning only the promotions that contain the supplied keywords in the promotion title.  <br><br><b>Example:</b> "iPhone" or "Harry Potter."  <br><br>Commas that separate keywords are ignored. For example, a keyword string of "iPhone, iPad" equals "iPhone iPad", and each results in a response that contains promotions with both "iPhone" and "iPad" in the title.
          in: query
          name: q
          required: false
          schema:
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PromotionsReportPagedCollection"
          description: Success
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "38204":
                category: REQUEST
                description: The seller is not eligible for promotions because they do not have an eBay Store or they have not accepted the terms and conditions for creating a promotion on this Marketplace, see the documentation for this call.
                domain: API_MARKETING
              "38211":
                category: REQUEST
                description: The offset value must be an integer value greater than or equal to zero.
                domain: API_MARKETING
              "38213":
                category: REQUEST
                description: You can query a limit of between 0 and 200 promotion records at a time. Update the request and resubmit the call.
                domain: API_MARKETING
              "38240":
                category: REQUEST
                description: Invalid input for the 'promotionStatus' field. For help, see the documentation for this call.
                domain: API_MARKETING
              "345141":
                category: REQUEST
                description: Invalid input for the 'promotionType' field. For help, see the documentation for this call.
                domain: API_MARKETING
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "38201":
                category: APPLICATION
                description: Internal server error encountered. If this problem persists, contact the eBay Developers Program for support.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing.readonly
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - promotion_report
  /promotion_summary_report:
    get:
      description: This method generates a report that summarizes the seller's promotions for the specified eBay marketplace. The report returns information on <code>RUNNING</code>, <code>PAUSED</code>, and <code>ENDED</code> promotions (deleted reports are not returned) and summarizes the seller's campaign performance for all promotions on a given site.  <br><br>For information about summary reports, see <a href="/api-docs/sell/static/marketing/pm-summary-report.html">Reading the item promotion Summary report</a>.
      operationId: getPromotionSummaryReport
      parameters:
        - description: The eBay marketplace ID of the site you for which you want a promotion summary report.  <p><b>Valid values:</b></p>  <ul><li><code>EBAY_AU</code> = Australia</li> <li><code>EBAY_DE</code> = Germany</li> <li><code>EBAY_ES</code> = Spain</li> <li><code>EBAY_FR</code> = France</li> <li><code>EBAY_GB</code> = Great Britain</li> <li><code>EBAY_IT</code> = Italy</li> <li><code>EBAY_US</code> = United States</li></ul>
          in: query
          name: marketplace_id
          required: true
          schema:
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SummaryReportResponse"
          description: Success
        "400":
          description: Bad Request
          x-response-codes:
            errors:
              "38204":
                category: REQUEST
                description: The seller is not eligible for promotions because they do not have an eBay Store or they have not accepted the terms and conditions for creating a promotion on this Marketplace, see the documentation for this call.
                domain: API_MARKETING
        "404":
          description: Not Found
        "500":
          description: Internal Server Error
          x-response-codes:
            errors:
              "38201":
                category: APPLICATION
                description: Internal server error encountered. If this problem persists, contact the eBay Developers Program for support.
                domain: API_MARKETING
      security:
        - api_auth:
            - https://api.ebay.com/oauth/api_scope/sell.marketing.readonly
            - https://api.ebay.com/oauth/api_scope/sell.marketing
      tags:
        - promotion_summary_report
components:
  schemas:
    Ad:
      description: A type that defines the fields for an ad.
      properties:
        adGroupId:
          description: A unique eBay-assigned ID for an ad group in a campaign that uses the Cost Per Click (CPC) funding model. This ID is created after a successful <a href="/api-docs/sell/marketing/resources/adgroup/methods/createAdGroup">createAdGroup</a> call, and all ad groups must be associated with a CPC campaign.
          type: string
        adId:
          description: A unique eBay-assigned ID that is generated when the ad is created.
          type: string
        adStatus:
          description: The current status of the CPC ad.<br /><br /><b>Valid Values:</b><ul><li><code>ACTIVE</code></li><li><code>PAUSED</code></li><li><code>ARCHIVED</code></li></ul><span class="tablenote"><b>Note:</b> This type only applies to the Cost Per Click (CPC) funding model; it does not apply to the Cost Per Sale (CPS) funding model.</span> For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:AdStatusEnum'>eBay API documentation</a>
          type: string
        alerts:
          description: An array containing alert messages for the ad.
          items:
            $ref: "#/components/schemas/Alert"
          type: array
        bidPercentage:
          description: 'The user-defined <b>bid percentage</b> (also known as the <i>ad rate</i>) sets the level that eBay increases the visibility in search results for the associated listing. The higher the <b>bidPercentage</b> value, the more eBay promotes the listing.  <br><br>The value specified here is also used to calculate the Promoted Listings fee. This percentage value is multiplied by the final sales price to determine the fee. <br><br>The Promoted Listings fee is determined at the time the transaction completes and the seller is assessed the fee only when an item sells through a Promoted Listings ad campaign. <br><br>The <b>bidPercentage</b> is a single precision value that is guided by the following rules: <ul><li>These values are <b>valid</b>:<br>&nbsp;&nbsp;&nbsp;<code>4.1</code>, &nbsp;&nbsp;&nbsp;<code>5.0</code>, &nbsp;&nbsp;&nbsp;<code>5.5</code>, ...</li>  <li>These values are <b>not valid</b>:<br /> &nbsp;&nbsp;&nbsp;<code>0.01</code>, &nbsp;&nbsp;&nbsp;<code>10.75</code>, &nbsp;&nbsp;&nbsp;<code>99.99</code>,<br /> &nbsp;&nbsp;&nbsp;and so on.</li></ul>This is default bid percentage for the campaigns using the Cost Per Sale (CPS) funding model, and this value will be overridden by any ads in the campaign that have their own set bid percentages.<br /><br />If a bid percentage is not provided for an ad, eBay uses the default bid percentage of the associated campaign.<br /><br /><span class="tablenote"><b>Note:</b>This field will always be returned for campaigns that use the Cost Per Sale (CPS) funding model. It will not be returned for campaigns that use the Cost Per Click (CPC) funding model.</span><br /><b>Minimum value:</b> 2.0 <br><b>Maximum value:</b> 100.0'
          type: string
        inventoryReferenceId:
          description: An ID that identifies a single-item listing or multiple-variation listing that is managed with the <a href="/api-docs/sell/inventory/resources/methods" title="Inventory API Reference">Inventory API</a>. <p>The <i>inventory reference ID</i> is a seller-defined value that can be either an <b>SKU</b> for a single-item listing or an <b>inventoryItemGroupKey</b> for a multiple-value listing.</p>  <p>An <i>inventoryItemGroupKey</i> is a value that the seller defines to indicate a listing that's the parent of an inventory item group (a multiple-variation listing, such as a listing for a shirt that's available in multiple sizes and colors).</p><p>This field is only returned if the ad is associated with a SKU or an inventory item group value.</p>
          type: string
        inventoryReferenceType:
          description: The enumeration value returned here indicates the type of listing the inventoryReferenceId references. The value returned here will be <code>INVENTORY_ITEM</code> for a single-variation listing, or <code>INVENTORY_ITEM_GROUP</code> for a multiple-variation listing. <p>This field is only returned if the ad is associated with a SKU or an inventory item group value.</p> For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:InventoryReferenceTypeEnum'>eBay API documentation</a>
          type: string
        listingId:
          description: A unique eBay-assigned ID that is generated when a listing is created.
          type: string
      type: object
    AdGroup:
      description: A container for the details of an existing ad group.<br /><br />An ad group can be added to a campaign that uses the Cost Per Click (CPC) funding model. A campaign may have multiple ad groups. All listings that are promoted in the campaign are included in the ad group.<br /><br /><span class="tablenote"><b>Note:</b> This type only applies to the CPC funding model; it does not apply to the Cost Per Sale (CPS) funding model.</span>
      properties:
        adGroupId:
          description: A unique eBay-assigned ID for an ad group in a campaign that uses the Cost Per Click (CPC) funding model.
          type: string
        adGroupStatus:
          description: An enumeration value representing the current status of the ad group.<br /><br /><b>Valid Values:</b><ul><li><code>ACTIVE</code></li><li><code>PAUSED</code></li><li><code>ARCHIVED</code></li></ul> For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:AdGroupStatusEnum'>eBay API documentation</a>
          type: string
        defaultBid:
          $ref: "#/components/schemas/Amount"
          description: "A bid amount that applies to all of the keywords in an ad group that do not have individual bids. For all keywords without individual bids, the default bid is the amount that the seller will pay per click for the listings in the ad group in the promoted listings campaign.<br><br><b>Valid Values</b>: 0.5, 0.75"
        name:
          description: The seller-defined name of the ad group.
          type: string
      type: object
    AdGroupPagedCollectionResponse:
      description: A container for the details of a paged collection of ad groups.<br /><br /><span class="tablenote"><b>Note:</b> This type only applies to the Cost Per Click (CPC) funding model; it does not apply to the Cost Per Sale (CPS) funding model.</span>
      properties:
        adGroups:
          description: The details of existing ad groups, such as the name, ID, and status of the ad groups.
          items:
            $ref: "#/components/schemas/AdGroup"
          type: array
        href:
          description: The URI of the current page of results from the result set.
          type: string
        limit:
          description: The number of items returned on a single page from the result set. This value can be set in the request with the <b>limit</b> query parameter.
          format: int32
          type: integer
        next:
          description: The call URI that can be used to retrieve the next page in the result set. This value is returned only if there is an additional page of results to display from the result set.
          type: string
        offset:
          description: 'The number of results skipped in the result set before listing the first returned result. This value can be set in the request with the <b>offset</b> query parameter. <p><b>Default:</b> 0</p><br><span class="tablenote"><b>Note: </b>The items in a paginated result set use a zero-based list, where the first item in the list has an offset of <code>0</code>.</span>'
          format: int32
          type: integer
        prev:
          description: The call URI that can be used to retrieve the previous page in the result set. Basically, all of the request parameters will remain the same except the offset value, which will be decreased to retrieve the previous page of results.
          type: string
        total:
          description: 'The total number of items retrieved in the result set.<br /><br /><span class="tablenote"><b>Note: </b>If no items are found, this field is returned with a value of <code>0</code>.</span>'
          format: int32
          type: integer
      type: object
    AdIds:
      description: This type is a container for a list of ad IDs.
      properties:
        adIds:
          description: A list of ad IDs. Only one ad can be deleted per operation and only one adId value will be returned.
          items:
            type: string
          type: array
      type: object
    AdPagedCollectionResponse:
      description: This type defines the fields that paginate the ads returned by the request. The entire <i>result set</i> consists of 0 or more sequenced <i>response pages</i>, where each page consists of 0 or more items from the complete result set.
      properties:
        ads:
          description: The list of ads that matched the request criteria.
          items:
            $ref: "#/components/schemas/Ad"
          type: array
        href:
          description: The URI of the current page of results from the result set.
          type: string
        limit:
          description: "The number of items returned on a single page from the result set. This value can be set in the request with the <b>limit</b> query parameter.<p><b>Default</b>: <code>10</code>"
          format: int32
          type: integer
        next:
          description: "The call URI that can be used to retrieve the next page in the result set. Basically, all of the request parameters will remain the same except the offset value, which will be increased to retrieve the next page of results. <br><br><b>Max length</b>: 2048"
          type: string
        offset:
          description: 'The number of results skipped in the result set before listing the first result on the current page. This value can be set in the request with the <b>offset</b> query parameter. If the <b>offset</b> value is not set, it defaults to zero.<p><b>Default</b>: <code>0</code></p><p class="tablenote"><strong>Note: </strong>The items in a paginated result set use a zero-based list where the first item in the list has an offset of <code>0</code>.</p>'
          format: int32
          type: integer
        prev:
          description: "The call URI that can be used to retrieve the previous page in the result set. Basically, all of the request parameters will remain the same except the offset value, which will be decreased to retrieve the previous page of results. <br><br><b>Max length</b>: 2048"
          type: string
        total:
          description: The total number of items retrieved in the result set.  <br><br>If no items are found, this field is returned with a value of <code>0</code>.
          format: int32
          type: integer
      type: object
    AdReference:
      description: This type defines the fields for an ad ID and its associated URL.
      properties:
        adId:
          description: A unique eBay-assigned ID for an ad. This ID is generated when an ad is created.
          type: string
        href:
          description: The getAd URI of an ad. You can use this URI to retrieve the ad.
          type: string
      type: object
    AdReferences:
      description: This type is a container for a list of ad IDs and their associated URIs.
      properties:
        ads:
          description: A list of ad IDs. An ad ID is generated for each successfully created ad. Only one ad can be created per operation.
          items:
            $ref: "#/components/schemas/AdReference"
          type: array
      type: object
    AdResponse:
      description: This type defines the fields returned in an ad response.
      properties:
        adGroupId:
          description: A unique eBay-assigned ID for an ad group in a Promoted Listings Advanced (PLA) campaign that uses the Cost Per Click (CPC) funding model.<span class="tablenote"><b>Note:</b> This field will always be returned for  campaigns that use the CPC funding model. It will not be returned for campaigns that use the Cost Per Sale (CPS) funding model.</span>
          type: string
        adId:
          description: A unique eBay-assigned ID for an ad. This ID is generated when an ad is created.<span class="tablenote"><b>Note:</b>This field is only returned when an ad is successfully created for the corresponding listing.</span>
          type: string
        errors:
          description: An array of errors associated with the request.
          items:
            $ref: "#/components/schemas/Error"
          type: array
        href:
          description: The getAd URI that points to the ad.<span class="tablenote"><b>Note:</b>This field is only returned when an ad is successfully created for the corresponding listing.</span>
          type: string
        listingId:
          description: A unique eBay-assigned ID for a listing that is generated when the listing is created.
          type: string
        statusCode:
          description: An HTTP status code indicating if the corresponding ad was successfully created or not. <code>200 Successful</code> should be returned for successfully created ads.<span class="tablenote"><b>Note:</b>A status code is returned for each ad that the seller creates, or attempts to create.</span>
          format: int32
          type: integer
      type: object
    AdUpdateResponse:
      description: A type that contains the fields for the ad update response.
      properties:
        adId:
          description: A unique eBay-assigned ID that is generated when the ad is created.
          type: string
        errors:
          description: A list of errors associated with the specified listing ID.
          items:
            $ref: "#/components/schemas/Error"
          type: array
        href:
          description: The URI for the ad, which can be used to retrieve the ad.
          type: string
        listingId:
          description: A unique eBay-assigned ID that is generated when the listing is created.
          type: string
        statusCode:
          description: An HTTP status code that indicates the response-status of the request.
          format: int32
          type: integer
      type: object
    AdUpdateStatusByListingIdResponse:
      description: A type that contains the fields for the ad update status by listing ID response.
      properties:
        adGroupId:
          description: A unique eBay-assigned ID for an ad group in a campaign that uses the Cost Per Click (CPC) funding model.
          type: string
        errors:
          description: A list of errors associated with the specified listing ID.
          items:
            $ref: "#/components/schemas/Error"
          type: array
        href:
          description: The URI for the ad, which can be used to retrieve the ad.
          type: string
        listingId:
          description: A unique eBay-assigned ID that is generated when the listing is created.
          type: string
        statusCode:
          description: An HTTP status code that indicates the response-status of the request.
          format: int32
          type: integer
      type: object
    AdUpdateStatusResponse:
      description: A type that contains the fields for the ad update status response.
      properties:
        adId:
          description: A unique eBay-assigned ID that is generated when the ad is created.
          type: string
        errors:
          description: A list of errors associated with the specified listing ID.
          items:
            $ref: "#/components/schemas/Error"
          type: array
        href:
          description: The URI for the ad, which can be used to retrieve the ad.
          type: string
        statusCode:
          description: An HTTP status code that indicates the response-status of the request.
          format: int32
          type: integer
      type: object
    AdditionalInfo:
      description: A type that provides additional information for suggested keywords.
      properties:
        infoType:
          description: The type of additional information provided for the suggested keyword.<br /><br /><strong>Valid Value:</strong> <code>KEYWORD_INSIGHTS</code> For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:AdditionalInfoEnum'>eBay API documentation</a>
          type: string
        metrics:
          description: A list of additional data provided for the suggested keyword.
          items:
            $ref: "#/components/schemas/AdditionalInfoData"
          type: array
      type: object
    AdditionalInfoData:
      description: A type that defines the data produced for additional information about suggested keywords.
      properties:
        metricKey:
          description: The metric used to provide additional information for the suggested keyword.<br /><br /><strong>Valid Values:</strong> <ul><li><code>ACTIVE_SELLER_COUNT</code></li><li><code>SEARCH_VOLUME</code></li></ul> For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:MetricEnum'>eBay API documentation</a>
          type: string
        value:
          description: The data provided for the specified metric.<br /><br /><span class="tablenote"><span style="color:#004680"><strong>Note:</strong></span> All metric data is compiled for the marketplace associated with the specified campaign ID.</span>
          type: string
      type: object
    Ads:
      description: This type defines the container for an array of ads.
      properties:
        ads:
          description: A list of ad IDs. An ad ID is generated for each successfully created ad.
          items:
            $ref: "#/components/schemas/Ad"
          type: array
      type: object
    Alert:
      description: A type that contains the alert message fields for the ad.
      properties:
        alertType:
          description: The type of alert message. For example, an invalid bid percentage. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:AlertTypeEnum'>eBay API documentation</a>
          type: string
        details:
          description: A description of the alert including dimensions and aspects.
          items:
            $ref: "#/components/schemas/AlertDetails"
          type: array
      type: object
    AlertDetails:
      description: A type that contains the alert detail fields.
      properties:
        aspect:
          $ref: "#/components/schemas/Aspect"
          description: The aspect information of the alert including keys and values.
        dimension:
          $ref: "#/components/schemas/AlertDimension"
          description: The dimension information of the alert including keys and values.
      type: object
    AlertDimension:
      description: A type that contains the dimension fields.
      properties:
        key:
          description: The key field of the applied dimension. For example, the marketplace Id. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:DimensionKeyEnum'>eBay API documentation</a>
          type: string
        value:
          description: The value field of the applied dimension. For example, if the key is a <code>MARKETPLACE_ID</code>, the value would be from <a href='/api-docs/sell/marketing/types/ba:MarketplaceIdEnum'>MarketplaceIdEnum</a>.
          type: string
      type: object
    Amount:
      description: A complex type that describes the value of a monetary amount as represented by a global currency.
      properties:
        currency:
          description: The base currency applied to the <b>value</b> field to establish a monetary amount.  <br><br>The currency is represented as a 3-letter <a href="https://www.iso.org/iso-4217-currency-codes.html " title="https://www.iso.org " target="_blank">ISO 4217</a> currency code. For example, the code for the Canadian Dollar is <code>CAD</code>.  <br><br><b>Default:</b> The default currency of the eBay marketplace that hosts the listing. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/ba:CurrencyCodeEnum'>eBay API documentation</a>
          type: string
        value:
          description: The monetary amount in the specified <b>currency</b>.  <br><br><i>Required in</i> the <b>amount</b> type.
          type: string
      type: object
    Aspect:
      description: A type that contains the aspect fields.
      properties:
        key:
          description: The type of the aspect. For example, <code>MINIMUM_REQUIRED</code>. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:AspectKeyEnum'>eBay API documentation</a>
          type: string
        value:
          description: The value of the aspect. For example, if the aspect is a percentage, a value of '2.0' would equal 2%.
          type: string
      type: object
    BaseResponse:
      description: This type defines the fields for any warning error messages.
      properties:
        warnings:
          description: The container for any warning error messages generated by the request. Warnings are not fatal in that they do not prevent the call from running and returning a response, but they should be reviewed to ensure your requests are returning the responses you expect.
          items:
            $ref: "#/components/schemas/Error"
          type: array
      type: object
    Budget:
      description: A container for the budget details of a Promoted Listings campaign that uses the Cost Per Click (CPC) funding model.<br /><br /><span class="tablenote"><b>Note:</b> This container will only be returned for campaigns using the CPC funding model; it does not apply to the Cost Per Sale (CPS) funding model.</span>
      properties:
        amount:
          $ref: "#/components/schemas/Amount"
          description: The allocated budget amount for a CPC Promoted Listings campaign.
        budgetStatus:
          description: The budget status for a CPC Promoted Listings campaign. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:BudgetStatusEnum'>eBay API documentation</a>
          type: string
      type: object
    BudgetRequest:
      description: A container for the budget details of a Promoted Listings campaign that uses the Cost Per Click (CPC) funding model.<br /><br /><span class="tablenote"><b>Note:</b> This container will only be returned for campaigns using the CPC funding model; it does not apply to the Cost Per Sale (CPS) funding model.</span>
      properties:
        amount:
          $ref: "#/components/schemas/Amount"
          description: The allocated budget amount for a CPC Promoted Listings campaign.
      type: object
    BulkAdResponse:
      description: This type defines the fields for the create ads in bulk response.
      properties:
        responses:
          description: This array displays the list of ads that were successfully created. For any ads that were not created successfully, the errors array may provide more detail about why creation of one or more ads failed.
          items:
            $ref: "#/components/schemas/AdResponse"
          type: array
      type: object
    BulkAdUpdateResponse:
      description: A type that defines the fields for updated ads in the bulk response.
      properties:
        responses:
          description: A set of ad listings processed by the call.
          items:
            $ref: "#/components/schemas/AdUpdateResponse"
          type: array
      type: object
    BulkAdUpdateStatusByListingIdResponse:
      description: A type that defines the fields for the updated ad status in the bulk response.
      properties:
        responses:
          description: An array of processed ad listings in bulk.
          items:
            $ref: "#/components/schemas/AdUpdateStatusByListingIdResponse"
          type: array
      type: object
    BulkAdUpdateStatusResponse:
      description: A type that defines the fields for the updated ad status in the bulk response.
      properties:
        responses:
          description: An array of processed ad listings in bulk.
          items:
            $ref: "#/components/schemas/AdUpdateStatusResponse"
          type: array
      type: object
    BulkCreateAdRequest:
      description: This type defines the fields for the create ads in bulk by listing IDs.
      properties:
        requests:
          description: "An array of listing IDs and their associated bid percentages, which the request uses to create ads in bulk. This request accepts both listing IDs, as generated by the Inventory API, and an item IDs, as used in the eBay Traditional API set (e.g., the Trading and Finding APIs).  <br><br><b>Maximum: </b> 500 IDs per call"
          items:
            $ref: "#/components/schemas/CreateAdRequest"
          type: array
      type: object
    BulkCreateAdsByInventoryReferenceRequest:
      description: This type defines the fields used to create ads in bulk by inventory reference IDs.
      properties:
        requests:
          description: A list of inventory reference ID and inventory reference type pairs, and the bid percentage, which the call uses to create ads in bulk.
          items:
            $ref: "#/components/schemas/CreateAdsByInventoryReferenceRequest"
          type: array
      type: object
    BulkCreateAdsByInventoryReferenceResponse:
      description: This type defines the response fields used by the <b>bulkCreateAdsByInventoryReference</b> method.
      properties:
        responses:
          description: This array displays the list of ads that were successfully created. For any ads that were not created successfully, the errors array may provide more detail about why creation of one or more ads failed.
          items:
            $ref: "#/components/schemas/CreateAdsByInventoryReferenceResponse"
          type: array
      type: object
    BulkCreateKeywordRequest:
      description: A type that contains the fields for the bulk request to create keywords.
      properties:
        requests:
          description: This array is used to pass in multiple keywords for one or more ad groups that belong to a campaign that uses the Cost Per Click (CPC) funding model. Up to {max value} keywords can be created with one call.
          items:
            $ref: "#/components/schemas/CreateKeywordRequest"
          type: array
      type: object
    BulkCreateKeywordResponse:
      description: A type that contains the response fields for the bulk request to create keywords.
      properties:
        responses:
          description: A list of keywords that have been processed by the request.
          items:
            $ref: "#/components/schemas/KeywordResponse"
          type: array
      type: object
    BulkCreateNegativeKeywordRequest:
      description: A type that contains the fields for the bulk request to create negative keywords.
      properties:
        requests:
          description: This array is used to pass in multiple negative keywords for one or more ad groups that belong to a campaign that uses the Cost Per Click (CPC) funding model.
          items:
            $ref: "#/components/schemas/CreateNegativeKeywordRequest"
          type: array
      type: object
    BulkCreateNegativeKeywordResponse:
      description: A type that contains the response fields for the bulk request to create negative keywords.
      properties:
        responses:
          description: A list of negative keywords that have been processed by the request.
          items:
            $ref: "#/components/schemas/NegativeKeywordResponse"
          type: array
      type: object
    BulkDeleteAdRequest:
      description: This type defines the fields that the call uses to remove ads in bulk.
      properties:
        requests:
          description: An array of the listing IDs that identify the ads to remove.
          items:
            $ref: "#/components/schemas/DeleteAdRequest"
          type: array
      type: object
    BulkDeleteAdResponse:
      description: This type defines a container that lists the ads that <b>bulkDeleteAdsByListingId</b> deleted.
      properties:
        responses:
          description: An array of the ads that were deleted by the <b>bulkDeleteAdsByListingId</b> request, including information associated with each individual delete request.
          items:
            $ref: "#/components/schemas/DeleteAdResponse"
          type: array
      type: object
    BulkDeleteAdsByInventoryReferenceRequest:
      description: This type defines the request fields that <b>bulkDeleteAdsByInventoryReference</b> uses to delete ads in bulk.
      properties:
        requests:
          description: A list of inventory referenceID and inventory reference type pairs that specify the set of ads to remove in bulk.
          items:
            $ref: "#/components/schemas/DeleteAdsByInventoryReferenceRequest"
          type: array
      type: object
    BulkDeleteAdsByInventoryReferenceResponse:
      description: This type defines a container that lists the ads that <b>bulkDeleteAdsByInventoryReference</b> deleted.
      properties:
        responses:
          description: An array of the ads that were deleted by the <b>bulkDeleteAdsByInventoryReference</b> request, including information associated with each individual delete request.
          items:
            $ref: "#/components/schemas/DeleteAdsByInventoryReferenceResponse"
          type: array
      type: object
    BulkUpdateAdStatusByListingIdRequest:
      description: A type that defines the fields for the <b>BulkUpdateAdStatusByListingId</b> request.
      properties:
        requests:
          description: An array of listing IDs and bid percentages.
          items:
            $ref: "#/components/schemas/UpdateAdStatusByListingIdRequest"
          type: array
      type: object
    BulkUpdateAdStatusRequest:
      description: A type that defines the fields for the <b>BulkUpdateAdStatus</b> request.
      properties:
        requests:
          description: An array of listing IDs and bid percentages.
          items:
            $ref: "#/components/schemas/UpdateAdStatusRequest"
          type: array
      type: object
    BulkUpdateAdsByInventoryReferenceResponse:
      description: A type that defines the fields for the <b>BulkUpdateAdStatusByInventoryReference</b> response.
      properties:
        responses:
          description: A list of inventory references that were processed from the request.
          items:
            $ref: "#/components/schemas/UpdateAdsByInventoryReferenceResponse"
          type: array
      type: object
    BulkUpdateKeywordRequest:
      description: A type that defines the fields for the <b>BulkUpdateKeyword</b> request.
      properties:
        requests:
          description: Use this array to update the bid values and/or statuses of one or more existing keywords.
          items:
            $ref: "#/components/schemas/UpdateKeywordByKeywordIdRequest"
          type: array
      type: object
    BulkUpdateKeywordResponse:
      description: A type that defines the fields for the <b>BulkUpdateKeyword</b> response.
      properties:
        responses:
          description: A list of keywords that have been processed from the bulk request.
          items:
            $ref: "#/components/schemas/UpdateKeywordResponse"
          type: array
      type: object
    BulkUpdateNegativeKeywordRequest:
      description: A type that defines the fields for the <b>BulkUpdateNegativeKeyword</b> request.
      properties:
        requests:
          description: An array to update the statuses of one or more existing negative keywords.
          items:
            $ref: "#/components/schemas/UpdateNegativeKeywordIdRequest"
          type: array
      type: object
    BulkUpdateNegativeKeywordResponse:
      description: A type that defines the fields for the <b>BulkUpdateNegativeKeyword</b> response.
      properties:
        responses:
          description: A list of negative keywords that have been processed from the bulk request.
          items:
            $ref: "#/components/schemas/UpdateNegativeKeywordResponse"
          type: array
      type: object
    Campaign:
      description: This type defines the fields that describe an ad campaign.
      properties:
        alerts:
          description: This array contains alert messages for the campaign.
          items:
            $ref: "#/components/schemas/Alert"
          type: array
        budget:
          $ref: "#/components/schemas/CampaignBudget"
          description: The allocated budget for the Cost Per Click (CPC) Promoted Listings campaign.<span class="tablenote"><b>Note:</b> This field will only be returned for campaigns using the CPC funding model; it does not apply to the Cost Per Sale (CPS) funding model.</span>
        campaignCriterion:
          $ref: "#/components/schemas/CampaignCriterion"
          description: The selection rules (criterion) used to select the listings for a campaign. If you populate the <b>campaignCriterion</b> object in your <b>createCampaign</b> request, ads for the campaign are created by rule for the listings that meet the criteria you specify, and these ads are associated with the campaign.<span class="tablenote"><b>Note:</b> This container is only returned for rules-based campaigns using the Cost Per Sale (CPS) funding model.</span>
        campaignId:
          description: A unique eBay-assigned ID for a campaign. This ID is generated when a campaign is created.
          type: string
        campaignName:
          description: "A seller-defined name for the campaign. This value must be unique for the seller. <p>You can use any alphanumeric characters in the name, except the less than (&lt;) or greater than (&gt;) characters.</p><b>Max length: </b>80 characters"
          type: string
        campaignStatus:
          description: Indicates the status of the campaign, such as <code>RUNNING</code>, <code>PAUSED</code>, and <code>ENDED</code>. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:CampaignStatusEnum'>eBay API documentation</a>
          type: string
        endDate:
          description: The date and time the campaign ends, in UTC format (<code>yyyy-MM-ddThh:mm:ssZ</code>). If this field is omitted, the campaign will have no defined end date, and will not end until the seller makes a decision to end the campaign with an <a href="/api-docs/sell/marketing/resources/campaign/methods/endCampaign">endCampaign</a> call, or if they update the campaign at a later time with an end date.
          type: string
        fundingStrategy:
          $ref: "#/components/schemas/FundingStrategy"
          description: This container shows the funding model used for the campaign, and the default bid percentage for a campaign that uses the Cost Per Sale (CPS) funding model. <p>Currently, the supported funding models are <code>COST_PER_SALE</code> and <code>COST_PER_CLICK</code>.
        marketplaceId:
          description: The ID of the eBay marketplace where the campaign is hosted. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/ba:MarketplaceIdEnum'>eBay API documentation</a>
          type: string
        startDate:
          description: The date and time the campaign starts, in UTC format (<code>yyyy-MM-ddThh:mm:ssZ</code>). For display purposes, convert this time into the local time of the seller.  <p>On the date specified, the service derives the keywords for each listing in the campaign, creates an ad for each listing, and associates each new ad with the campaign. The campaign starts after this process is completed. The amount of time it takes the service to start the campaign depends on the number of listings in the campaign. Call <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaign">getCampaign</a> to check the status of the campaign.</p>
          type: string
      type: object
    CampaignBudget:
      description: A type that defines the budget details for a Cost Per Click (CPC) Promoted Listings campaign.
      properties:
        daily:
          $ref: "#/components/schemas/Budget"
          description: The daily budget limit for the Cost Per Click (CPC) Promoted Listings campaign.<br /><br /><i>Required if</i> the campaign's funding model is CPC.<br /><br />This will be a dollar value. All clicks using the keywords defined for the campaign will go towards expending the daily budget. Once the daily budget is exceeded for the campaign, all Promoted Listings under the campaign will be turned off until the next day.<br /><br /><b>Valid Values</b>:<ul><li><code>50.00</code></li><li><code>100.00</code></li></ul>
      type: object
    CampaignBudgetRequest:
      description: A container for the details of a Promoted Listings campaign that uses the Cost Per Click (CPC) funding model.
      properties:
        daily:
          $ref: "#/components/schemas/BudgetRequest"
          description: The daily budget limit for a CPC Promoted Listings campaign.
      type: object
    CampaignCriterion:
      description: This type defines the fields for specifying the criterion (selection rule) settings of an ad campaign. If you populate the campaignCriterion object in your <b>createCampaign</b> request, ads for the campaign are created by rule for the listings that meet the criteria you specify, and these ads are associated with the newly created campaign.
      properties:
        autoSelectFutureInventory:
          description: A field used to indicate whether listings shall be automatically added to, or removed from, a Promoted Listings campaign based on the rules that have been configured for the campaign.<br /><br />If set to <code>true</code>, eBay adds all listings matching the campaign criterion to the campaign, including any new listings created from the items in a seller's inventory.<br /><br /><b>Default:</b> <code>false</code>
          type: boolean
        criterionType:
          description: This enum defines the criterion (selection rule) types. Currently, the only criterion type supported is <code>INVENTORY_PARTITION</code>, and you must specify this value if you manage your items with the Inventory API and you want to include items based on their inventory reference IDs.  <br><br>Do not include this field if you manage your listings with Trading API/legacy model. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:CriterionTypeEnum'>eBay API documentation</a>
          type: string
        selectionRules:
          description: This container shows all of the rules/inclusion filters used to add listings to the campaign. For information on using the contained fields, see <a href= "/api-docs/sell/static/marketing/using-the-selectionrules-container.html#Campaign ">Promoted Listing campaigns</a>.
          items:
            $ref: "#/components/schemas/SelectionRule"
          type: array
      type: object
    CampaignPagedCollectionResponse:
      description: This type defines the fields that paginate the campaigns returned by the request. The entire <i>result set</i> consists of 0 or more sequenced <i>response pages</i>, where each page consists of 0 or more items from the complete result set.
      properties:
        campaigns:
          description: This array contains all of the seller's campaign that match the request criteria.
          items:
            $ref: "#/components/schemas/Campaign"
          type: array
        href:
          description: The URI of the current page of results from the result set.
          type: string
        limit:
          description: The number of items returned on a single page from the result set. This value can be set in the request with the <b>limit</b> query parameter.
          format: int32
          type: integer
        next:
          description: "The call URI that can be used to retrieve the next page in the result set. This value is returned only if there is an additional page of results to display from the result set. <br><br><b>Max length</b>: 2048"
          type: string
        offset:
          description: 'The number of results skipped in the result set before listing the first returned result. This value can be set in the request with the <b>offset</b> query parameter. <p class="tablenote"><strong>Note: </strong>The items in a paginated result set use a zero-based list where the first item in the list has an offset of <code>0</code>.</p>'
          format: int32
          type: integer
        prev:
          description: "The call URI that can be used to retrieve the previous page in the result set. Basically, all of the request parameters will remain the same except the offset value, which will be decreased to retrieve the previous page of results. <br><br><b>Max length</b>: 2048"
          type: string
        total:
          description: The total number of campaigns retrieved in the result set.  <br><br>If no campaigns are found, this field is returned with a value of <code>0</code>.
          format: int32
          type: integer
      type: object
    Campaigns:
      description: This type contains a list of campaigns.
      properties:
        campaigns:
          description: This is an array of one or campaigns that match the listing or inventory item group specified in the request.
          items:
            $ref: "#/components/schemas/Campaign"
          type: array
      type: object
    CloneCampaignRequest:
      description: This type defines the fields needed for a clone-campaign request.
      properties:
        campaignName:
          description: "A seller-defined name for the newly-cloned campaign. This value must be unique for the seller. <p>You can use any alphanumeric characters in the name, except the less than (&lt;) or greater than (&gt;) characters.</p><b>Max length: </b>80 characters"
          type: string
        endDate:
          description: The date and time the campaign ends, in UTC format (<code>yyyy-MM-ddThh:mm:ssZ</code>). If this field is omitted, the campaign will have no defined end date, and will not end until the seller makes a decision to end the campaign with an <a href="/api-docs/sell/marketing/resources/campaign/methods/endCampaign">endCampaign</a> call, or if they update the campaign at a later time with an end date.
          type: string
        fundingStrategy:
          $ref: "#/components/schemas/FundingStrategy"
          description: This container is used to set the funding model and default bid percentage for the campaign to be cloned.
        startDate:
          description: The date and time the cloned campaign starts, in UTC format (<code>yyyy-MM-ddThh:mm:ssZ</code>). For display purposes, convert this time into the local time of the seller.  <p>On the date specified, the service derives the keywords for each listing in the campaign, creates an ad for each listing, and associates each new ad with the campaign. The campaign starts after this process is completed. The amount of time it takes the service to start the campaign depends on the number of listings in the campaign. Call <b>getCampaign</b> to check the status of the campaign.</p>
          type: string
      type: object
    CouponConfiguration:
      description: This container defines a coded coupon promotion. It is required if the promotion type is CODED_COUPON.
      properties:
        couponCode:
          description: A unique code that buyers can use during checkout to receive a discount. The code must be unique across eBay. <br><br>The code must be from 8-15 alphanumeric characters and can contain no more than two dashes ( - ).<br><br>This is required when the promotion type is CODED_COUPON.
          type: string
        couponType:
          description: This indicates the type of Coded Coupon promotion, and is required when the promotion type is <b>CODED_COUPON</b>.<br><br>Supported types:<ul><li><b>PRIVATE_SINGLE_SELLER_COUPON:</b> Anyone can use and share the coupon code, but it isn't posted on eBay.</li><li><b>PUBLIC_SINGLE_SELLER_COUPON:</b> Anyone can find the coupon code on eBay and use it.</li></ul> For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/sme:CouponTypeEnum'>eBay API documentation</a>
          type: string
        maxCouponRedemptionPerUser:
          description: This sets the limit on the number of times a buyer can use this coupon. The range of values is 1-10. If no value is provided, a buyer can use the coupon an unlimited number of times.
          format: int32
          type: integer
      type: object
    CreateAdGroupRequest:
      description: A type that defines the fields for the <b>CreateAdGroup</b> request.
      properties:
        defaultBid:
          $ref: "#/components/schemas/Amount"
          description: A bid amount that applies to all of the keywords in an ad group that do not have individual bids.
        name:
          description: The seller-defined name of the ad group.
          type: string
      type: object
    CreateAdRequest:
      description: This type defines the fields for the create ad request.
      properties:
        adGroupId:
          description: A unique eBay-assigned ID for an ad group in a campaign that uses the Cost Per Click (CPC) funding model. <p><i>Required if</i> the campaign's funding model is Cost Per Click (CPC).</p><p>Create an ad group using the <a href="/api-docs/sell/marketing/resources/adgroup/methods/createAdGroup">createAdGroup</a> method.</p><p>Specify the campaign to associate the ad group with using the <b>campaign_id</b> path parameter. </p><span class="tablenote"><b>Note:</b> You can call the  <a href="/api-docs/sell/marketing/resources/adgroup/methods/getAdGroups">getAdGroups</a> method to retrieve the ad group IDs for a seller.</span>
          type: string
        bidPercentage:
          description: "The user-defined <b>bid percentage</b> (also known as the <i>ad rate</i>) sets the level that eBay increases the visibility in search results for the associated listing. The higher the <b>bidPercentage</b> value, the more eBay promotes the listing.<br><br><i>Required if</i> the campaign's funding model is Cost Per Sale (CPS).  <br><br>The value specified here is also used to calculate the Promoted Listings fee. This percentage value is multiplied by the final sales price to determine the fee. <br><br>The Promoted Listings fee is determined at the time the transaction completes and the seller is assessed the fee only when an item sells through a Promoted Listings ad campaign. <br><br>The <b>bidPercentage</b> is a single precision value that is guided by the following rules: <ul><li>These values are <b>valid</b>:<br>&nbsp;&nbsp;&nbsp;<code>4.1</code>,&nbsp;&nbsp;&nbsp;<code>5.0</code>, &nbsp;&nbsp;&nbsp;<code>5.5</code>, ...</li>  <li>These values are <b>not valid</b>:<br /> &nbsp;&nbsp;&nbsp;<code>0.01</code>, &nbsp;&nbsp;&nbsp;<code>10.75</code>, &nbsp;&nbsp;&nbsp;<code>99.99</code>,<br /> &nbsp;&nbsp;&nbsp;and so on.</li></ul>This is default bid percentage for the campaigns using the Cost Per Sale (CPS) funding model, and this value will be overridden by any ads in the campaign that have their own set bid percentages.<br /><br />If a bid percentage is not provided for an ad, eBay uses the default bid percentage of the associated campaign.<br /><br /><b>Minimum value:</b> 2.0 <br><b>Maximum value:</b> 100.0"
          type: string
        listingId:
          description: A unique eBay-assigned ID for a listing that is generated when the listing is created.  <p class="tablenote"><b>Note:</b> This field accepts listing IDs, as generated by the Inventory API, and item IDs, as used in the eBay Traditional API set (e.g., the Trading and Finding APIs).</p>
          type: string
      type: object
    CreateAdsByInventoryReferenceRequest:
      description: This type defines the fields needed to create ads by inventory reference ID request.
      properties:
        adGroupId:
          description: <span class="tablenote"><b>Note:</b> This field is not currently in use. Ad groups are only applicable to Promoted Listings Advanced (PLA) ad campaigns that use the Cost Per Click (CPC) funding model. See <a href="/api-docs/sell/static/marketing/pl-overview.html#funding-model">Funding Models</a> in the <i>Promoted Listings Playbook</i> for more information.</span>
          type: string
        bidPercentage:
          description: "The user-defined <b>bid percentage</b> (also known as the <i>ad rate</i>) sets the level that eBay increases the visibility in search results for the associated listing. The higher the <b>bidPercentage</b> value, the more eBay promotes the listing.<br /><br /><i>Required if</i> the campaign's funding model is Cost Per Sale (CPS).<br /><br />The value specified here is also used to calculate the Promoted Listings fee. This percentage value is multiplied by the final sales price to determine the fee.<br /><br />The Promoted Listings fee is determined at the time the transaction completes and the seller is assessed the fee only when an item sells through a Promoted Listings ad campaign.<br /><br />The <b>bidPercentage</b> is a single precision value that is guided by the following rules: <ul><li>These values are <b>valid</b>:<br>&nbsp;&nbsp;&nbsp;<code>4.1</code>, &nbsp;&nbsp;&nbsp;<code>5.0</code>,&nbsp;&nbsp;&nbsp;<code>5.5</code>, ...</li>  <li>These values are <b>not valid</b>:<br /> &nbsp;&nbsp;&nbsp;<code>0.01</code>, &nbsp;&nbsp;&nbsp;<code>10.75</code>, &nbsp;&nbsp;&nbsp;<code>99.99</code>,<br /> &nbsp;&nbsp;&nbsp;and so on.</li></ul>This is default bid percentage for the campaigns using the Cost Per Sale (CPS) funding model, and this value will be overridden by any ads in the campaign that have their own set bid percentages.<br /><br />If a bid percentage is not provided for an ad, eBay uses the default bid percentage of the associated campaign.<br /><br /><b>Minimum value:</b> 2.0 <br><b>Maximum value:</b> 100.0"
          type: string
        inventoryReferenceId:
          description: An ID that identifies a single-item listing or multiple-variation listing that is managed with the <a href="/api-docs/sell/inventory/resources/methods" title="Inventory API Reference">Inventory API</a>. <p>The <i>inventory reference ID</i> is a seller-defined value that can be either an <b>SKU</b> for a single-item listing or an <b>inventoryItemGroupKey</b> for a multiple-value listing.</p>  <p>An <i>inventoryItemGroupKey</i> is a value that the seller defines to indicate a listing that's the parent of an inventory item group (a multiple-variation listing, such as a listing for a shirt that's available in multiple sizes and colors).</p>  <p>You must always specify both an <b>inventoryReferenceId</b> and an <b>inventoryReferenceType</b> to indicate an item that's managed with the Inventory API.</p>
          type: string
        inventoryReferenceType:
          description: Indicates the type of item the <b>inventoryReferenceId</b> references. The item can be either an <code>INVENTORY_ITEM</code> or <code>INVENTORY_ITEM_GROUP</code>. <p>You must always pair an <b>inventoryReferenceId</b> with and <b>inventoryReferenceType</b>.</p> For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:InventoryReferenceTypeEnum'>eBay API documentation</a>
          type: string
      type: object
    CreateAdsByInventoryReferenceResponse:
      description: This type defines the fields returned when you create an ad by inventory reference ID.
      properties:
        adGroupId:
          description: A unique eBay-assigned ID for an ad group in a Promoted Listings Advanced (PLA) campaign that uses the Cost Per Click (CPC) funding model.<span class="tablenote"><b>Note:</b> This field will always be returned for campaigns that use the CPC funding model. It will not be returned for campaigns that use the Cost Per Sale (CPS) funding model.</span>
          type: string
        ads:
          description: A list of ad IDs. An ad ID is generated for each successfully created ad.
          items:
            $ref: "#/components/schemas/AdReference"
          type: array
        errors:
          description: An array of errors or warnings associated with the create-ads request.
          items:
            $ref: "#/components/schemas/Error"
          type: array
        inventoryReferenceId:
          description: An ID that identifies a single-item listing or multiple-variation listing that is managed with the <a href="/api-docs/sell/inventory/resources/methods" title="Inventory API Reference">Inventory API</a>. <p>The <i>inventory reference ID</i> is a seller-defined value that can be either an <b>SKU</b> for a single-item listing or an <b>inventoryItemGroupKey</b> for a multiple-value listing.</p>
          type: string
        inventoryReferenceType:
          description: Indicates the type of item the <b>inventoryReferenceId</b> references. The item can be either an <code>INVENTORY_ITEM</code> or <code>INVENTORY_ITEM_GROUP</code>. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:InventoryReferenceTypeEnum'>eBay API documentation</a>
          type: string
        statusCode:
          description: An HTTP status code that indicates the response-status of the request. Check this code to see if the ads were successfuly created.
          format: int32
          type: integer
      type: object
    CreateCampaignRequest:
      description: This type defines the fields needed to create a campaign. To create a campaign, you need to specify a name, start and end dates, funding, marketplace, and optionally the criterion (selection rules).
      properties:
        budget:
          $ref: "#/components/schemas/CampaignBudgetRequest"
          description: The allocated daily budget for the Cost Per Click (CPC) Promoted Listings campaign.<br /><br /><i>Required if</i> the campaign funding model is CPC.
        campaignCriterion:
          $ref: "#/components/schemas/CampaignCriterion"
          description: This container is used if the seller wishes to create one or more rules for a rules-based campaign. If you populate the <b>campaignCriterion</b> object in your <b>createCampaign</b> request, ads for the campaign are created by rule for the listings that meet the criteria you specify, and these ads are associated with the campaign to be created.
        campaignName:
          description: "A seller-defined name for the campaign. This value must be unique for the seller. <p>You can use any alphanumeric characters in the name, except the less than (&lt;) or greater than (&gt;) characters.</p><b>Max length: </b>80 characters"
          type: string
        endDate:
          description: The date and time the campaign ends, in UTC format (<code>yyyy-MM-ddThh:mm:ssZ</code>). If this field is omitted, the campaign will have no defined end date, and will not end until the seller makes a decision to end the campaign with an <a href="/api-docs/sell/marketing/resources/campaign/methods/endCampaign">endCampaign</a> call, or if they update the campaign at a later time with an end date.
          type: string
        fundingStrategy:
          $ref: "#/components/schemas/FundingStrategy"
          description: This container is used to set the funding model and default bid percentage for a Cost Per Sale (CPS) campaign.
        marketplaceId:
          description: The ID of the eBay marketplace where the campaign is hosted. See the <b>MarketplaceIdEnum</b> type to get the appropriate enumeration value for the listing marketplace. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/ba:MarketplaceIdEnum'>eBay API documentation</a>
          type: string
        startDate:
          description: The date and time the campaign starts, in UTC format (<code>yyyy-MM-ddThh:mm:ssZ</code>). For display purposes, convert this time into the local time of the seller.  <p>On the date specified, the service derives the keywords for each listing in the campaign, creates an ad for each listing, and associates each new ad with the campaign. The campaign starts after this process is completed. The amount of time it takes the service to start the campaign depends on the number of listings in the campaign. Call <b>getCampaign</b> to check the status of the campaign.</p>
          type: string
      type: object
    CreateKeywordRequest:
      description: A type that defines the fields for the <b>CreateKeyword</b> request.
      properties:
        adGroupId:
          description: This adGroupId is created when an ad group is first created and associated with a campaign. This is the ad group that the corresponding keyword will be added to. This ad group must be a part of the campaign that is specified in the call URI.<br /><br /><span class="tablenote"><b>Note:</b> You can call the  <a href="/api-docs/sell/marketing/resources/adgroup/methods/getAdGroups">getAdGroups</a> method to retrieve the ad group IDs for a seller, and <a href="/api-docs/sell/marketing/resources/keywords/methods/getKeywords">getKeywords</a> to retrieve the keyword IDs for a seller's keywords.</span>
          type: string
        bid:
          $ref: "#/components/schemas/Amount"
          description: This container is used to set the bid for the keyword. Each time a listing is retrieved in search results using this keyword and clicked on, the seller will be charged this amount. Each click goes toward the daily budget set up for the CPC campaign. If the bid is not provided, then the default bid associated with the ad group is used.<br /><br /><span class="tablenote"><b>Note:</b> You can call the  <a href="/api-docs/sell/marketing/resources/adgroup/methods/suggestBids">suggestBids</a> method to retrieve the suggested bids for keywords.</span>
        keywordText:
          description: Input the keyword into this field.
          type: string
        matchType:
          description: A field that defines the match type for the keyword.<br /><br /><b>Valid Values:</b><ul><li><code>BROAD</code></li><li><code>EXACT</code></li><li><code>PHRASE</code></li></ul> For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:MatchTypeEnum'>eBay API documentation</a>
          type: string
      type: object
    CreateNegativeKeywordRequest:
      description: A type that defines the fields for the <b>CreateNegativeKeyword</b> request.
      properties:
        adGroupId:
          description: This adGroupId is created when an ad group is first created and associated with a campaign. This is the ad group to which the corresponding negative keyword will be added.<br /><br /><span class="tablenote"><b>Note:</b> You can call the  <a href="/api-docs/sell/marketing/resources/adgroup/methods/getAdGroups">getAdGroups</a> method to retrieve the ad group IDs for a seller.</span><br /><br /><i>Required if</i> the negative keyword is being created at the ad group level.
          type: string
        campaignId:
          description: A unique eBay-assigned ID for a campaign. This ID is generated when a campaign is created.<br /><br /><i>Required if</i> the negative keyword is being created at the ad group level.
          type: string
        negativeKeywordMatchType:
          description: A field that defines the match type for the negative keyword.<br /><br /><span class="tablenote"><span style="color:#004680"><strong>Note:</strong></span> Broad matching of negative keywords is not currently supported.</span><br /><b>Valid Values:</b><ul><li><code>EXACT</code></li><li><code>PHRASE</code></li></ul> For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:NegativeKeywordMatchTypeEnum'>eBay API documentation</a>
          type: string
        negativeKeywordText:
          description: The negative keyword text.
          type: string
      type: object
    CreateReportTask:
      description: This type defines the rules that govern the generation of a report task and the criteria that's used to create the report. The report-generation rules include the starting and ending dates for the report. Report-task criteria includes the report dimensions, metrics, listings covered in the report, and so on. For information on the required and optional fields for each report type, see <a href="/api-docs/sell/static/marketing/pl-reports.html">Promoted Listings reporting</a>.
      properties:
        additionalRecords:
          description: A list of additional records that shall be included in the report, such as non-performing data.<br /><br /><span class="tablenote"><span style="color:#004680"><strong>Note:</strong></span> Additional records are only applicable to Promoted Listings Advanced (PLA) campaigns that use the Cost Per Click (CPC) funding model.</span><br /><b>Valid Value:</b> <code>NON_PERFORMING_DATA</code>
          items:
            description: " For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/plr:AdditionalRecordEnum'>eBay API documentation</a>"
            type: string
          type: array
        campaignIds:
          description: A list of campaign IDs to be included in the report task. Call <b>getCampaigns</b> to get a list of the current campaign IDs for a seller.<br /><br />For Promoted Listings Standard (PLS) sellers, this field is required if the <b>reportType</b> is set to <code>CAMPAIGN_PERFORMANCE_REPORT</code> or <code>CAMPAIGN_PERFORMANCE_SUMMARY_REPORT</code>.<br /><br />For Promoted Listings Advanced (PLA) sellers, leave this request field blank to retrieve the details for all campaigns associated with your account, or specify the campaign IDs for which you would like to retrieve the campaign-specific details.<br /><br /><span class="tablenote"><span style="color:#004680"><strong>Note:</strong></span> There is a maximum data limit that cannot be exceeded when generating reports. If this threshold is exceeded, the report will fail. Refer to <a href="/api-docs/sell/static/marketing/pl-reports.html#creation">Promoted Listings reporting</a> in the Selling Integration Guide for details.</span><br /><br /><b>Maximum:</b><ul><li>25 IDs for PLS</li><li>1,000 IDs for PLA</li></ul>
          items:
            type: string
          type: array
        dateFrom:
          description: The date defining the start of the timespan covered by the report.<br /><br />Format the timestamp as an <a href="https://www.iso.org/iso-8601-date-and-time-format.html" title="https://www.iso.org" target="_blank">ISO 8601</a> string, which is based on the 24-hour Coordinated Universal Time (UTC) clock with local offset.<br /><br /><span class="tablenote"><span style="color:#004680"><strong>Note:</strong></span> The date specified cannot be a future date.</span><br /><br /><b>Format:</b> <code>[YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].[sss]Z</code><br /><br /><b>Example:</b> <code>2021-03-15T13:00:00-07:00</code>
          type: string
        dateTo:
          description: The date defining the end of the timespan covered by the report.<br /><br />As with the <b>dateFrom</b> field, format the timestamp as an <a href="https://www.iso.org/iso-8601-date-and-time-format.html" title="https://www.iso.org" target="_blank">ISO 8601</a> string.<br /><br /><span class="tablenote"><span style="color:#004680"><strong>Note:</strong></span> The date specified cannot be a future date. Additionally, the time specified must be a later time than that specified in the <b>dateFrom</b> field.</span><br /><br /><b>Format:</b> <code>[YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].[sss]Z</code><br /><br /><b>Example:</b> <code>2021-03-17T13:00:00-07:00</code>
          type: string
        dimensions:
          description: The list of the dimensions applied to the report.  <p>A dimension is an attribute to which the report data applies. For example, if you set <b>dimensionKey</b> to <code>campaign_id</code> in a Campaign Performance Report, the data will apply to the entire ad campaign. For information on the dimensions and how to specify them, see <a href="/api-docs/sell/static/marketing/pl-reports.html">Promoted Listings reporting</a>.</p>
          items:
            $ref: "#/components/schemas/Dimension"
          type: array
        fundingModels:
          description: The funding model for the campaign that shall be included in the report.<br /><br /><span class="tablenote"><span style="color:#004680"><strong>Note:</strong></span> The default funding model for Promoted Listings reports is <code>COST_PER_SALE</code>.</span><br /><br /><span class="tablenote"><span style="color:#004680"><strong>Note:</strong></span> Multiple value support for the <b>fundingModels</b> array has been deprecated. See <a href ="/develop/apis/api-deprecation-status ">API&nbsp;Deprecation&nbsp;Status</a> for information.</span><br /><br /><b>Valid Values:</b><ul><li><code>COST_PER_SALE</code></li><li><code>COST_PER_CLICK</code></li></ul><i>Required if</i> the campaign funding model is Cost Per Click (CPC).
          items:
            description: " For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:FundingModelEnum'>eBay API documentation</a>"
            type: string
          type: array
        inventoryReferences:
          description: 'You can use this field to supply an array of items to include in the report if you manage your inventory with the <a href="/api-docs/sell/inventory/resources/methods">Inventory API</a>.  <br><br>This field is mutually exclusive with the <b>listingIds</b> field; if you populate this field, <i>do not</i> populate the <b>listingIds</b> field.  <br><br>An inventory reference identifies an item in your inventory using a pair of values, where the <b>inventoryReferenceId</b> can be either a seller-defined <b>SKU</b> value or an <b>inventoryItemGroupKey</b>, where an <b>inventoryItemGroupKey</b> is seller-defined ID for an inventory item group (a multiple-variation listing). <br><br>Couple the <b>inventoryReferenceId</b> with an <b>inventoryReferenceType</b> identifier to fully identify an item in your inventory.  <br><br><b>Maximum: </b> 500 items <br><br><i>Required if </i> you do not supply an array of <b>listingId</b> values or if you set <b>reportType</b> to <code>INVENTORY_PERFORMANCE_REPORT</code>.'
          items:
            $ref: "#/components/schemas/InventoryReference"
          type: array
        listingIds:
          description: Use this field to supply an array of listing IDs you want to include in the report.<br><br>A listing ID is the eBay listing identifier that is generated when the listing is created. This field accepts listing ID values generated with both the Inventory API and the eBay Traditional APIs, such as the Trading and Finding APIs.<br><br><span class="tablenote"><span style="color:#FF0000"><strong>Important:</strong></span> This field is mutually exclusive with the <b>inventoryReferences</b> field; if you populate this field, <i>do not</i> populate the <b>inventoryReferences</b> field.</span><br /><br />For Promoted Listings Standard (PLS) sellers, this field is required if you do not supply an array of <b>inventoryReferences</b> values or if you set the <b>reportType</b> to <code>LISTING_PERFORMANCE_REPORT</code>.<br /><br />For Promoted Listings Advanced (PLA) sellers, leave this field blank to retrieve the details for all listings associated with the specified campaign IDs (or all campaigns associated with your account, if no campaign IDs are specified), or specify the listing IDs for which you would like to retrieve the listing-specific details.<br /><br /><span class="tablenote"><span style="color:#004680"><strong>Note:</strong></span> There is a maximum data limit that cannot be exceeded when generating reports. If this threshold is exceeded, the report will fail. Refer to <a href="/api-docs/sell/static/marketing/pl-reports.html#creation">Promoted Listings reporting</a> in the Selling Integration Guide for details.</span><br /><br /><b>Maximum:</b> 500 listings
          items:
            type: string
          type: array
        marketplaceId:
          description: "The ID for the eBay marketplace on which the report is based.<br /><br /><b>Maximum: </b> 1 For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/ba:MarketplaceIdEnum'>eBay API documentation</a>"
          type: string
        metricKeys:
          description: 'The list of metrics to be included in the report.  <p>Metrics are the quantitative measurements compiled into the report and the data returned is based on the specified dimension of the report. For example, if the dimension is <code>campaign</code>, the metrics for <b>number of sales</b> would be the number of sales in the campaign. However, if the dimension is <code>listing</code>, the <b>number of sales</b> represents the number of items sold in that listing.</p>  <p>For information on metric keys and how to set them, see <a href="/api-docs/sell/static/marketing/pl-reports.html">Promoted Listings reporting</a>.</p><b>Minimum: </b> 1'
          items:
            type: string
          type: array
        reportFormat:
          description: The file format of the report. Currently, the only supported format is <code>TSV_GZIP</code>, which is a gzip file with tab separated values. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/plr:ReportFormatEnum'>eBay API documentation</a>
          type: string
        reportType:
          description: The type of report to be generated, such as <code>ACCOUNT_PERFORMANCE_REPORT</code> or <code>CAMPAIGN_PERFORMANCE_REPORT</code>.<br/><br/><span class="tablenote"><b>Note:</b> INVENTORY_PERFORMANCE_REPORT is not currently available; availability date is pending.</span><br /><br /><b>Maximum:</b> 1 For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/plr:ReportTypeEnum'>eBay API documentation</a>
          type: string
      type: object
    DeleteAdRequest:
      description: This type defines the fields used in a delete-ad request.
      properties:
        listingId:
          description: A unique eBay-assigned ID for a listing that is generated when the listing is created.  <p class="tablenote"><b>Note:</b> This request accepts both listing IDs, as generated by the Inventory API, and an item IDs, as used in the eBay Traditional API set (e.g., the Trading and Finding APIs).</p>
          type: string
      type: object
    DeleteAdResponse:
      description: This type defines the fields returned in a delete-ad response.
      properties:
        adId:
          description: The unique identifier of the ad that was deleted, or the ad that the seller attempted to delete.
          type: string
        errors:
          description: An array of the errors or warnings associated with the request.
          items:
            $ref: "#/components/schemas/Error"
          type: array
        listingId:
          description: A unique eBay-assigned ID for a listing that is generated when the listing is created.
          type: string
        statusCode:
          description: An HTTP status code that indicates the response-status of the request. Check this code to see if the ad was successfully deleted.<span class="tablenote"><b>Note:</b>A status code is returned for each ad that the seller deletes, or attempts to delete.</span>
          format: int32
          type: integer
      type: object
    DeleteAdsByInventoryReferenceRequest:
      description: This type defines the fields needed to delete an ad by its inventory reference ID.  You must always supply both <b>inventory_reference_id</b> and <b>inventory_reference_type</b>.
      properties:
        inventoryReferenceId:
          description: The inventory reference ID is a seller-defined SKU value for a single-item listing, or a seller-defined identifier for an inventory item group. Both of these values are defined when using the Inventory API, and an inventory item group is used to create a multiple-variation listing.
          type: string
        inventoryReferenceType:
          description: The enumeration value passed into this field indicates the type of value used for the corresponding <b>inventoryReferenceId</b> value. The enumeration value used here will either be <code>INVENTORY_ITEM</code> (to delete the ad for a single SKU listing) or <code>INVENTORY_ITEM_GROUP</code> (to delete the ad for a multiple-variation listing). For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:InventoryReferenceTypeEnum'>eBay API documentation</a>
          type: string
      type: object
    DeleteAdsByInventoryReferenceResponse:
      description: This type defines the fields returned by request to delete a set of ads by inventory reference ID.
      properties:
        adIds:
          description: The unique identifier of the ad that was deleted, or the ad that the seller attempted to delete.<span class="tablenote"><b>Note:</b>Although the field name is plural and it is an array, only one ad ID will be returned here since there can be only one ad per listing.</span>
          items:
            type: string
          type: array
        errors:
          description: The container for the errors associated with the request.
          items:
            $ref: "#/components/schemas/Error"
          type: array
        inventoryReferenceId:
          description: The inventory reference ID is a seller-defined SKU value for a single-item listing, or a seller-defined identifier for an inventory item group. Both of these values are defined when using the Inventory API, and an inventory item group is used to create a multiple-variation listing.
          type: string
        inventoryReferenceType:
          description: The enumeration value returned here indicates if the ad was for a single-variation listing or a multiple-variation listing. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:InventoryReferenceTypeEnum'>eBay API documentation</a>
          type: string
        statusCode:
          description: An HTTP status code indicating if the corresponding ad was successfully deleted or not. <code>200 Successful</code> should be returned for successfully deleted ads. <span class="tablenote"><b>Note:</b>A status code is returned for each ad that the seller deletes, or attempts to delete.</span>
          format: int32
          type: integer
      type: object
    Dimension:
      description: This type defines the annotation and dimension key used by the report. For information on how to set these values, see <a href="/api-docs/sell/static/marketing/pl-reports.html">Promoted Listings reporting</a>.
      properties:
        annotationKeys:
          description: A list of annotations associated with the dimension of the report.
          items:
            type: string
          type: array
        dimensionKey:
          description: The name of the dimension on which the report is based. <p>A dimension is an attribute to which the report data applies.</p>
          type: string
      type: object
    DimensionKeyAnnotation:
      description: This type defines the annotation values associated with a dimension. Annotations are metadata of the dimension. For example, annotations for a listing ID could be <code>listing_title</code> or <code>listing_quantity_sold</code>.
      properties:
        annotationKey:
          description: An annotation key associated with the dimension.
          type: string
        dataType:
          description: The data type of the annotation key value. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/plr:DataTypeEnum'>eBay API documentation</a>
          type: string
      type: object
    DimensionMetadata:
      description: This type defines the dimension used to create the report and the annotation keys associated with that dimension.
      properties:
        dataType:
          description: The data type of the dimension value used to create the report. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/plr:DataTypeEnum'>eBay API documentation</a>
          type: string
        dimensionKey:
          description: The name of the dimension used to create the report.
          type: string
        dimensionKeyAnnotations:
          description: An list of annotation keys associated with the specified dimension of the report.
          items:
            $ref: "#/components/schemas/DimensionKeyAnnotation"
          type: array
      type: object
    DiscountBenefit:
      description: 'This container defines the promotional discount as either a monetary amount or a percentage of the sales price.  <p class="tablenote"><b>Important!:</b> You must populate one and only one of the fields in this container: <ul><li><b>amountOffItem</b></li> <li><b>amountOffOrder</b></li> <li><b>percentageOffItem</b></li> <li><b>percentageOffOrder</b></li></ul></p>  <p class="tablenote"><b>Tip:</b> Refer to <a href="/api-docs/sell/static/marketing/pm-specifying-discounts.html">Configuring discounts for threshold promotions</a> for information and examples on how to combine <b>discountBenefit</b> and <b>discountSpecification</b> values to create different types of promotions.</p>'
      properties:
        amountOffItem:
          $ref: "#/components/schemas/Amount"
          description: 'The monetary amount that is discounted off an item (or items) when the promotion criteria is met.  <br><br>For <b>threshold promotions</b>, where the buyer triggers the discount, the valid values for this field are:  <br><code> &nbsp; 5, 6, 7, 8, 9, 10, 15, 20, 25, <br> &nbsp; 30, 35, 40, 45, 50, 55, 60, 65, <br> &nbsp; 70, 75, 80, 85, 90, 95, 100, 110, <br> &nbsp; 120, 125, 150, 200, 250</code>  <br><br>For <b>markdown</b> promotions, the range is greater, as outlined below and detailed more precisely <a href="/api-docs/sell/static/marketing/pm-amountoffitems-values.html" target="_blank">here</a>: <ul><li>$1 increments from $5 to $100</li><li>$5 increments from $105 to $1,000</li><li>$100 increments from $1,100 to $15,000</li></ul>'
        amountOffOrder:
          $ref: "#/components/schemas/Amount"
          description: "Used for threshold promotions, this is the monetary amount that is discounted off an order when the promotion criteria is met. Because this field is valid only for orders, it's not a valid combination to use with markdown promotions.  <br><br><b>Valid values</b> for the associated <code>amountOffOrder.</code><b>value</b> field:  <br><code> &nbsp; 5, 6, 7, 8, 9, 10, 15, 20, 25, <br> &nbsp; 30, 35, 40, 45, 50, 55, 60, 65, <br> &nbsp; 70, 75, 80, 85, 90, 95, 100, 110, <br> &nbsp; 120, 125, 150, 200, 250</code>"
        percentageOffItem:
          description: "The percentage applied to the sales price that is discounted off the promoted item (or items) when the promotion criteria is met.  <br><br>Valid integer values for percentage off: &nbsp;&nbsp;<b>Min:</b> <code>5</code> &nbsp;&nbsp;<b>Max:</b> <code>80</code>"
          type: string
        percentageOffOrder:
          description: "Used for threshold promotions, this is the percentage of the order price that is discounted off the order when the promotion criteria is met. This field is not value for markdown promotions.  <br><br>Valid integer values for ORDER_DISCOUNT promotions: &nbsp;&nbsp;<b>Min:</b> <code>5</code> &nbsp;&nbsp;<b>Max:</b> <code>80</code>  <br><br>For VOLUME_DISCOUNT promotions: Must be set to <code>0</code> for the first discount rule."
          type: string
      type: object
    DiscountRule:
      description: This complex type defines a promotion as being either a monetary amount or a percentage of a sales price that's subtracted from the price of an item or order. <p>Set the amount of the discount and the rules that govern when the discount triggers using the <b>discountBenefit</b> and <b>discountSpecification</b> fields.</p>  <p class="tablenote"><b>Note:</b> In <b>volume pricing promotions</b>, you must configure at least two <b>discountRule</b> containers and at most four.</p>
      properties:
        discountBenefit:
          $ref: "#/components/schemas/DiscountBenefit"
          description: This container defines the promotional discount as either a monetary amount or a percentage of the sales price.  <p><b>Note:</b> When configuring promotion benefits, populate just one of the following fields in the <b>discountBenefit</b> container:</p> <ul><li><b>amountOffItem</b></li> <li><b>amountOffOrder</b></li> <li><b>percentageOffItem</b></li> <li><b>percentageOffOrder</b></li></ul>  <p>For volume pricing, only <b>percentageOffOrder</b> is applicable as a <b>discountBenefit</b>. Also, the first <b>discountBenefit</b> container in a volume pricing configuration must set <b>percentageOffOrder</b> to <code>0</code>.</p>  <p class="tablenote"><b>Tip:</b> Refer to <a href="/api-docs/sell/static/marketing/pm-specifying-discounts.html">Configuring discounts for threshold promotions</a> for information and examples on how to combine <b>discountBenefit</b> and <b>discountSpecification</b> to create different types of promotions.</p>
        discountSpecification:
          $ref: "#/components/schemas/DiscountSpecification"
          description: This container defines the criteria for when the discounts of a promotion trigger, such as the minimum quantity that the buyer must purchase before the promotion kicks in. The promotional discount is applied each time the criteria defined by this container is met.  <p>When configuring the rules that govern when the discounts are applied, populate just one of the following fields in the <b>discountSpecification</b> container:</p>  <ul><li><b>minAmount</b></li> <li><b>minQuantity</b></li> <li><b>forEachQuantity</b></li> <li><b>forEachAmount</b></li></ul>  <p class="tablenote"><b>Important:</b> When configuring <i>volume pricing promotions</i>, only <b>minQuantity</b> is applicable as a <b>discountSpecification</b>. Also, the configuration for <b>minQuantity</b> in a volume pricing configuration is specific. In the first <b>discountSpecification</b> container, set <b>minQuantity</b> to <code>1</code>, and in the second, set <b>minQuantity</b> to <code>2</code>. If you include a third <b>discountRules</b> pair, <b>minQuantity</b> must be set to <code>3</code>, and in a fourth, it must be set to <code>4</code>. Also, you must set a <b>ruleOrder</b> value in each <b>discountRules</b> container. In the first container, <b>discountRules</b> must be set to <code>1</code>, and in each subsequent container, the value be be incremented by 1. For more, see <a href="/api-docs/sell/static/marketing/pm-volume-discounts.html" target="_blank">Configuring volume pricing discounts</a>.</p> <p class="tablenote"><b>Tip:</b> see <a href="/api-docs/sell/static/marketing/pm-specifying-discounts.html" target="_blank">Configuring discounts for threshold promotions</a> for information and examples on how to combine <b>discountBenefit</b> and <b>discountSpecification</b> to create different types of promotions.</p>
        maxDiscountAmount:
          $ref: "#/components/schemas/Amount"
          description: The limit on how much a buyer can save using a <code>CODED_COUPON</code> promotion type. Permitted values are 1-1000. Supported currency codes include USD, GBP, EUR, and AUD. <p class="tablenote"><b>Note:</b> The Currency Code for 'maxDiscountAmount' must be the same as the Currency Code for 'budget'.</p>
        ruleOrder:
          description: This field indicates the order in which the <b>discountRules</b> are presented. The value specified for this field must equal the associated <b>minQuantity</b> value. <br><br><i>Required if </i> you are creating a volume pricing promotion.
          format: int32
          type: integer
      type: object
    DiscountSpecification:
      description: This container defines the criteria for when the discounts of a promotion trigger, such as the minimum quantity the buyer must purchase before the promotion kicks in. The promotional discount is applied each time the criteria defined by this container is met.  <p><b>Note:</b> When configuring the rules that govern when the discounts are applied, populate just one of the following fields in the <b>discountSpecification</b> container:</p>  <ul><li><b>minAmount</b></li> <li><b>minQuantity</b></li> <li><b>forEachQuantity</b></li> <li><b>forEachAmount</b></li></ul> <p class="tablenote"><b>Tip:</b> Refer to <a href="/api-docs/sell/static/marketing/pm-specifying-discounts.html">Configuring discounts for threshold promotions</a> for information and examples on how to combine <b>discountBenefit</b> and <b>discountSpecification</b> to create different types of promotions.</p>
      properties:
        forEachAmount:
          $ref: "#/components/schemas/Amount"
          description: "The monetary amount that must be spent on promoted items before the promotional discount is applied.  <br><br><b>Valid values</b> for the associated <code>forEachAmount.</code><b>value</b> field: <br><code> &nbsp; 5, 10, 15, 20, 25, 30, 35, 40, 45, 49, <br> &nbsp; 50, 55, 59, 60, 65, 69, 70, 75, 79, 80, <br> &nbsp; 85, 89, 90, 95, 99, 100, 110, 120, 125, <br> &nbsp; 149, 150, 175, 199, 200, 249, 250, 299, <br> &nbsp; 300, 350, 399, 400, 450, 499, 500</code>"
        forEachQuantity:
          description: The number of items that must be purchased in order to qualify for the discount.  <br><br><b>Valid values:</b> <br><code> &nbsp; 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, <br> &nbsp; 12, 13, 14, 15, 16, 17, 18, 19 <br> &nbsp; 20, 25, 50, 75, 100</code>
          format: int32
          type: integer
        minAmount:
          $ref: "#/components/schemas/Amount"
          description: "Known as the \"threshold amount\", the minimum dollar amount that needs to be spent on promoted items in order to qualify for the promotion's discount.  <br><br><b>Valid values</b> for the associated <code>minAmount.</code><b>value</b> field: <br><code> &nbsp; 5, 10, 15, 20, 25, 30, 35, 40, 45, 49, <br> &nbsp; 50, 55, 59, 60, 65, 69, 70, 75, 79, 80, <br> &nbsp; 85, 89, 90, 95, 99, 100, 110, 120, <br> &nbsp; 125, 149, 150, 175, 199, 200, 249, 250, 299, <br> &nbsp; 300, 350, 399, 400, 450, 499, 500</code>"
        minQuantity:
          description: The minimum quantity of promoted items that needs to be bought in order to qualify for the promotion's discount.  <br><br><b>Valid values:</b> <br><code> &nbsp; 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, <br> &nbsp; 12, 13, 14, 15, 16, 17, 18, 19 <br> &nbsp; 20, 25, 50, 75, 100</code>
          format: int32
          type: integer
        numberOfDiscountedItems:
          description: Use this field to configure "Buy One Get One" (or <b>BOGO</b>) promotions.  <br><br>You must couple this field with <b>forEachQuantity</b> and an <b>amountOffItem</b> or <b>percentOffItem</b> field to configure your BOGO promotion. This field is not valid with order-based promotions. <br><br>The value of this field represents the number of items to be discounted when other promotion criteria is met. For example, when the buyer adds the number of items identified by the <b>forEachQuantity</b> value to their cart, they are then eligible to receive the stated discount from an additional number of like items (the number of which is identified by this field) when they add those items to their cart. To receive the discount, the buyer must purchase the number of items indicated by  <b>forEachQuantity</b> <i>plus</i> the number indicated by this field.  <br><br><b>Valid values:</b> <br><code> &nbsp; 1, 2, 3, 4, 5, 6, 7, 8, 9, 10</code>
          format: int32
          type: integer
      type: object
    DynamicAdRatePreference:
      description: A type that defines the ad rate details for a Promoted Listings Standard (PLS) ad campaign.
      properties:
        adRateAdjustmentPercent:
          description: The percentage above or below (-) the eBay suggested ad rate that a seller is willing to pay.<br /><br />This specifies the maximum and minimum values to which an ad rate can be dynamically adjusted.
          type: string
        adRateCapPercent:
          description: The maximum value (specified as a percentage) to which the eBay suggested ad rate can be adjusted. The adjusted ad rate will never exceed this percentage.
          type: string
      type: object
    Error:
      description: A container that defines the elements of error and warning messages.
      properties:
        category:
          description: "The category type for this error or warning. It takes an ErrorCategory object which can have one of three values:<ul><li><code>Application</code>: Indicates an exception or error occurred in the application code or at runtime. Examples include catching an exception in a service's business logic, system failures, or request errors from a dependency.</li><li><code>Business</code>: Used when your service or a dependent service refused to continue processing on the resource because of a business rule violation such as \"Seller does not ship item to Antarctica\" or \"Buyer ineligible to purchase an alcoholic item\". Business errors are not syntactical input errors.</li><li><code>Request</code>: Used when there is anything wrong with the request, such as authentication, syntactical errors, rate limiting or missing headers, bad HTTP header values, and so on.</li></ul>"
          type: string
        domain:
          description: Name of the domain containing the service or application.
          type: string
        errorId:
          description: A positive integer that uniquely identifies the specific error condition that occurred. Your application can use error codes as identifiers in your customized error-handling algorithms.
          format: int32
          type: integer
        inputRefIds:
          description: Identifies specific request elements associated with the error, if any. inputRefId's response is format specific. For JSON, use <i>JSONPath</i> notation.
          items:
            type: string
          type: array
        longMessage:
          description: An expanded version of message that should be around 100-200 characters long, but is not required to be such.
          type: string
        message:
          description: An end user and app developer friendly device agnostic message. It explains what the error or warning is, and how to fix it (in a general sense). Its value is at most 50 characters long. If applicable, the value is localized in the end user's requested locale.
          type: string
        outputRefIds:
          description: Identifies specific response elements associated with the error, if any. Path format is the same as <code>inputRefId</code>.
          items:
            type: string
          type: array
        parameters:
          description: This optional complex field type contains a list of one or more context-specific <code>ErrorParameter</code> objects, with each item in the list entry being a parameter (or input field name) that caused an error condition. Each <code>ErrorParameter</code> object consists of two fields, a <code>name</code> and a <code>value</code>.
          items:
            $ref: "#/components/schemas/ErrorParameter"
          type: array
        subdomain:
          description: Name of the domain's subsystem or subdivision. For example, checkout is a subdomain in the buying domain.
          type: string
      type: object
    ErrorParameter:
      description: Container for a error parameter.
      properties:
        name:
          description: Name of the entity that threw the error.
          type: string
        value:
          description: A description of the error.
          type: string
      type: object
    FundingStrategy:
      description: This type defines how the Promoted Listings fee is calculated for a Promoted Listings ad campaign.
      properties:
        adRateStrategy:
          description: The ad rate strategy that shall be applied to the campaign. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:AdRateStrategyEnum'>eBay API documentation</a>
          type: string
        bidPercentage:
          description: 'The user-defined <b>bid percentage</b> (also known as the <i>ad rate</i>) sets the level that eBay increases the visibility in search results for the associated listing. The higher the <b>bidPercentage</b> value, the more eBay promotes the listing.  <br><br>The value specified here is also used to calculate the Promoted Listings fee. This percentage value is multiplied by the final sales price to determine the fee. <br><br>The Promoted Listings fee is determined at the time the transaction completes and the seller is assessed the fee only when an item sells through a Promoted Listings ad campaign. <br><br>The <b>bidPercentage</b> is a single precision value that is guided by the following rules: <ul><li>These values are <b>valid</b>:<br>&nbsp;&nbsp;&nbsp;<code>4.1</code>, &nbsp;&nbsp;&nbsp;<code>5.0</code>, &nbsp;&nbsp;&nbsp;<code>5.5</code>, ...</li>  <li>These values are <b>not valid</b>:<br /> &nbsp;&nbsp;&nbsp;<code>0.01</code>, &nbsp;&nbsp;&nbsp;<code>10.75</code>, &nbsp;&nbsp;&nbsp;<code>99.99</code>,<br /> &nbsp;&nbsp;&nbsp;and so on.</li></ul>This is the default bid percentage for the campaigns using the Cost Per Sale (CPS) funding model, and this value will be overridden by any ads in the campaign that have their own set bid percentages.<br /><br />If a bid percentage is not provided for an ad, eBay uses the default bid percentage of the associated campaign.<br /><br /><span class="tablenote"><b>Note:</b>This field is only relevant for campaigns that use the CPS funding model and a fixed ad rate. It is not used for campaigns that use the Cost Per Click (CPC) funding model and should not be provided when the selected adRateStrategy for the campaign is dynamic.</span><br /><b>Minimum value:</b> 2.0 <br><b>Maximum value:</b> 100.0'
          type: string
        dynamicAdRatePreferences:
          description: A field that indicates whether a single, user-defined bid percentage (also known as the <i>ad rate</i>) should be used, or whether eBay should automatically adjust listings to maintain the daily suggested bid percentage.<br /><br /><span class="tablenote"><span style="color:#004680"><strong>Note:</strong></span> Dynamic adjustment is only applicable when the <b>adRateStrategy</b> is set to <code>DYNAMIC</code>.</span><br /><b>Default:</b> <code>FIXED</code>
          items:
            $ref: "#/components/schemas/DynamicAdRatePreference"
          type: array
        fundingModel:
          description: Indicates the model that eBay uses to calculate the Promoted Listings fee. <p>For a description of the funding model types, refer to <b>FundingModelTypeEnum</b>. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:FundingModelEnum'>eBay API documentation</a>
          type: string
      type: object
    InventoryCriterion:
      description: This type defines either the selections rules or the list of listing IDs for the promotion. The "listing IDs" are are either the seller's item IDs or the eBay listing IDs.
      properties:
        inventoryCriterionType:
          description: Indicates how the items to include in the promotion are selected. You can include inventory by ID, using rules, or globally include all your inventory.  For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/sme:InventoryCriterionEnum'>eBay API documentation</a>
          type: string
        inventoryItems:
          description: An array of containers for the seller's inventory reference IDs (also known as an "SKU" or "custom label") to be added to the promotion.  <p class="tablenote"><b>Note:</b> The request can have either <b>inventoryItems</b> or <b>listingIds</b>, but not both.</p>  <br><br><b>Required:</b> All listings in a promotion must offer an electronic payment method.  <br><b>Maximum:</b> 500 parent items  <br><b>Maximum SKU or custom label length:</b> 50 characters <br><br><i>Required if </i> <b>InventoryCriterionType</b> is set to <code>INVENTORY_BY_VALUE</code>, you must specify either <b>inventoryItems</b> or <b>listingIds</b>.
          items:
            $ref: "#/components/schemas/InventoryItem"
          type: array
        listingIds:
          description: An array of eBay listing IDs to be added to the promotion.  <p class="tablenote"><b>Note:</b> The request can have either <b>inventoryItems</b> or <b>listingIds</b>, but not both.</p>  <br><br><b>Required:</b> All listings in a promotion must offer an electronic payment method.  <br><b>Maximum:</b> 500 parent items  <br><b>Maximum SKU or custom label length:</b> 50 characters <br><br><i>Required if </i> <b>InventoryCriterionType</b> is set to <code>INVENTORY_BY_VALUE</code>, you must specify either <b>inventoryItems</b> or <b>listingIds</b>.
          items:
            type: string
          type: array
        ruleCriteria:
          $ref: "#/components/schemas/RuleCriteria"
          description: This container defines a set of inventory selection rules for a promotion.  <br><br>When defining rule criteria, you must limit item exclusions to 100 IDs when you choose from live inventory.  <br><br>Required if  <b>InventoryCriterionEnum</b> is set to <code>INVENTORY_BY_RULE</code> or <code>INVENTORY_ANY</code>.
      type: object
    InventoryItem:
      description: This type defines the fields for the seller inventory reference IDs (also known as an "SKU" or "custom label").
      properties:
        inventoryReferenceId:
          description: The seller's inventory reference ID for a listing. Also known as the "SKU" or "custom label," an inventory reference ID is either the ID of the listing or, if the listing has variations (such as a shirt that's available in multiple sizes and colors), the ID of the parent listing.
          type: string
      type: object
    InventoryReference:
      description: This complex type is used to identify an item that is managed by the Inventory API. The type defines the fields contained in an inventory reference ID.
      properties:
        inventoryReferenceId:
          description: The seller's inventory reference ID for an item that is managed with the Inventory API.  <br><br>An inventory reference is either the ID of a single listing or the ID of the parent of an item group listing (a multi-variation listing, such as a shirt that is available in multiple sizes and colors).  <br><br><i>Required if </i> if you supply an <b>inventoryReferenceType</b>.
          type: string
        inventoryReferenceType:
          description: Indicates the type of item indicated by the <b>inventoryReferenceId</b>.  <br><br>This value can be set to either <code>INVENTORY_ITEM</code> or <code>INVENTORY_ITEM_GROUP</code> (if the ID points to a multi-variation listing). <br><br><i>Required if </i> if you supply an <b>inventoryReferenceId</b>. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:InventoryReferenceTypeEnum'>eBay API documentation</a>
          type: string
      type: object
    ItemBasis:
      description: A container for details regarding the basis for an item.
      properties:
        estimatedValue:
          description: The estimated value of the search impressions for items based on the provided dimensions. <br /><br /><b>Duration:</b> 17 days<br /><br /><b>Total slots:</b> 200 <br /><br /><b>Channel:</b> Dweb, Mweb, Native
          format: int32
          type: integer
        metric:
          description: The basis of the statistics. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:TargetingMetricsEnum'>eBay API documentation</a>
          type: string
      type: object
    ItemMarkdownStatus:
      description: This type defines the status of a markdown promotion.
      properties:
        listingMarkdownStatus:
          description: Indicates the state assigned to the markdown promotion using one of the <b>status</b> values. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/sme:ItemMarkdownStatusEnum'>eBay API documentation</a>
          type: string
        statusChangedDate:
          description: Identifies the date the last time the state of the promotion changed. Both both markdown and markup events can trigger a status change.
          type: string
        statusMessage:
          description: An eBay-assigned text string that describes the status of the promotion.
          type: string
      type: object
    ItemPriceMarkdown:
      description: This type defines the fields used to describe an item price markdown promotion.
      properties:
        applyFreeShipping:
          description: If set to <code>true</code>, free shipping is applied to the first shipping service specified for the item. The first domestic shipping option is set to "free shipping," regardless if the shipping <b>optionType</b> for that service is set to <code>FLAT_RATE</code>, <code>CALCULATED</code>, or <code>NOT_SPECIFIED</code> (freight). This flag essentially adds free shipping as a promotional bonus. <br><br><b>Default:</b> <code>false</code>
          type: boolean
        autoSelectFutureInventory:
          description: If set to <code>true</code>, eBay will automatically add inventory items to the markdown promotion if they meet the <b>selectedInventoryDiscounts</b> criteria specified for the markdown promotion.  <br><br><b>Default:</b> <code>false</code>
          type: boolean
        blockPriceIncreaseInItemRevision:
          description: If set to <code>true</code>, price increases (including removing the free shipping flag) are blocked and an error message is returned if a seller attempts to adjust the price of an item that's partaking in this markdown promotion. If set to <code>false</code>, an item is dropped from the markdown promotion if the seller adjusts the price.  <br><br><b>Default:</b> <code>false</code>
          type: boolean
        description:
          description: This field is required if you are configuring an MARKDOWN_SALE promotion. <br><br>This is the seller-defined "tag line" for the offer, such as "Save on designer shoes." A tag line appears under the "offer-type text" that is generated for the promotion. The text is displayed on the offer tile that is shown on the seller's <b>All Offers</b> page and on the event page for the promotion.  <p class="tablenote"><b>Note:</b> Offer-type text is a teaser that's presented throughout the buyer's journey through the sales flow and is generated by eBay. This text is not editable by the seller&mdash;it's derived from the settings in the <b>discountRules</b> and <b>discountSpecification</b> fields&mdash;and can be, for example, "20% off".</p>  <br><b>Maximum length:</b> 50
          type: string
        endDate:
          description: The date and time the promotion ends, in UTC format (<code>yyyy-MM-ddThh:mm:ssZ</code>). The value supplied for <b>endDate</b> must be at least 24 hours after the value supplied for the <b>startDate</b> of the markdown promotion.<br><br>For display purposes, convert this time into the local time of the seller.  <br><br><b>Max value:</b><ul><li><code>14</code> days for the AT, CH, DE, ES, FR, IE, IT, and UK, marketplaces.</li>  <li><code>45</code> days for all other marketplaces.</li></ul>
          type: string
        marketplaceId:
          description: The eBay marketplace ID of the site where the markdown promotion is hosted. Markdown promotions are supported on all eBay marketplaces. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/ba:MarketplaceIdEnum'>eBay API documentation</a>
          type: string
        name:
          description: The seller-defined name or 'title' of the promotion that the seller can use to identify a promotion. This label is not displayed in end-user flows.  <br><br><b>Maximum length:</b> 90
          type: string
        priority:
          description: This field is ignored in markdown promotions. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/sme:PromotionPriorityEnum'>eBay API documentation</a>
          type: string
        promotionImageUrl:
          description: Required for CODED_COUPON, MARKDOWN_SALE, and ORDER_DISCOUNT promotions, populate this field with a URL that points to an image to be used with the promotion. This image is displayed on the seller's <b>All Offers</b> page. The URL must point to either JPEG or PNG image and it must be a minimum of 500x500 pixels in dimension and cannot exceed 12Mb in size.
          type: string
        promotionStatus:
          description: The current status of the promotion. When creating a new promotion, you must set this value to either <code>DRAFT</code> or <code>SCHEDULED</code>.  <br><br>Note that you must set this value to <code>SCHEDULED</code> when you update a <b>RUNNING</b> promotion. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/sme:PromotionStatusEnum'>eBay API documentation</a>
          type: string
        selectedInventoryDiscounts:
          description: A list that defines the sets of selected items for the markdown promotion and the discount specified for promotion.
          items:
            $ref: "#/components/schemas/SelectedInventoryDiscount"
          type: array
        startDate:
          description: The date and time the promotion starts in UTC format (<code>yyyy-MM-ddThh:mm:ssZ</code>). For display purposes, convert this time into the local time of the seller.
          type: string
      type: object
    ItemPromotion:
      description: This type defines the fields that describe a threshold promotion and includes the promotional discount, the items included in the promotion, and the rules that specify when the promotion is applied.
      properties:
        applyDiscountToSingleItemOnly:
          description: This flag is relevant in only when <b>promotionType</b> is set to <code>VOLUME_DISCOUNT</code>. For details on volume pricing promotions, see <a href="/api-docs/sell/static/marketing/pm-volume-discounts.html">Configuring volume pricing discounts</a>.  <br><br>If set to <code>true</code>, the discount is applied only when the buyer purchases multiple quantities of a single item in the promotion. Otherwise, the promotional discount applies to multiple quantities of any items in the promotion. Different variations of a multi-variation item are considered to be the same item. Note that this flag is not relevant if the <b>inventoryCriterion</b> container identifies a single listing ID for the promotion.
          type: boolean
        budget:
          $ref: "#/components/schemas/Amount"
          description: This sets the budget for the <code>CODED_COUPON</code> promotion type. Supported values range from 100-1000000. Supported currency codes include USD, GBP, EUR, and AUD. <p class="tablenote"><b>Note:</b> The budget value for an active or paused promotion can not be decreased.</p> <p class="tablenote"><b>Note:</b> The Currency Code for 'budget' must be the same as the Currency Code for 'maxDiscountAmount'.</p>
        couponConfiguration:
          $ref: "#/components/schemas/CouponConfiguration"
          description: The configuration of a coded coupon promotion.
        description:
          description: This is the seller-defined "tag line" for the offer, such as "Save on designer shoes."  <br><br>The tag line appears under the "offer-type text" that is generated for the promotion and is displayed on the offer tile that's shown on the seller's <b>All Offers</b> page, and on the event page for the promotion.  <p class="tablenote"><b>Note:</b> Offer-type text is a teaser that's presented throughout the buyer's journey through the sales flow and is generated by eBay. The offer-type text is not editable by the seller&mdash;it's derived from the settings in the <b>discountRules</b> and <b>discountSpecification</b> fields&mdash;and can be, for example, "Extra 20% off when you buy 3+".</p>  <br><b>Maximum length:</b> 50 <br><br><i>Required if</i> you are configuring CODED_COUPON, ORDER_DISCOUNT, or MARKDOWN_SALE promotions (and not valid for VOLUME_DISCOUNT promotions).
          type: string
        discountRules:
          description: 'This container defines a promotion using the following two required fields: <ul><li><b>discountBenefit</b> &ndash; Defines a discount as either a monetary amount or a percentage that is subtracted from the sales price of an item, a set of items, or an order.</li>  <li><b>discountSpecification</b> &ndash; Defines a set of rules that determine when the promotion is applied.</li></ul> <p class="tablenote"><b>Note:</b> For volume pricing, you must specify at least two and not more than four <b>discountBenefit</b>/<b>discountSpecification</b> pairs. In addition, you must define each set of rules with a <b>ruleOrder</b> value that corresponds with the order of volume discounts you present.</p>  <p><b>Tip:</b> Refer to <a href="/api-docs/sell/static/marketing/pm-specifying-discounts.html">Specifying item promotion discounts</a> for information and examples on how to combine <b>discountBenefit</b> and <b>discountSpecification</b> to create different types of promotions.</p>'
          items:
            $ref: "#/components/schemas/DiscountRule"
          type: array
        endDate:
          description: The date and time the promotion ends in UTC format (<code>yyyy-MM-ddThh:mm:ssZ</code>). For display purposes, convert this time into the local time of the seller.
          type: string
        inventoryCriterion:
          $ref: "#/components/schemas/InventoryCriterion"
          description: A container that defines either the listing IDs or the selection rules that specify the items to include in the promotion. Listing IDs can be either eBay listing IDs or a list of the seller's inventory reference IDs (know as SKUs or custom labels). See the <b>selectionRules</b> container for the rule criteria you can use to select inventory.  <p class="tablenote"><b>Note:</b> All listings in Promotions Manager promotions must support an electronic payment method.</p>
        marketplaceId:
          description: The eBay marketplace ID of the site where the threshold promotion is hosted. Threshold promotions are currently supported on a limited number of eBay marketplaces.  <p><b>Valid values:</b></p>  <ul><li><code>EBAY_AU</code> = Australia</li> <li><code>EBAY_DE</code> = Germany</li> <li><code>EBAY_ES</code> = Spain</li> <li><code>EBAY_FR</code> = France</li> <li><code>EBAY_GB</code> = Great Britain</li> <li><code>EBAY_IT</code> = Italy</li> <li><code>EBAY_US</code> = United States</li></ul> For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/ba:MarketplaceIdEnum'>eBay API documentation</a>
          type: string
        name:
          description: The seller-defined name or "title" of the promotion that the seller can use to identify a promotion. This label is not displayed in end-user flows.  <br><br><b>Maximum length:</b> 90
          type: string
        priority:
          description: Applicable for only <b>ORDER_DISCOUNT</b> promotions, this field indicates the precedence of the promotion, which is used to determine the position of a promotion on the seller's <b>All Offers</b> page. If an item is associated with multiple promotions, the promotion with the higher priority takes precedence. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/sme:PromotionPriorityEnum'>eBay API documentation</a>
          type: string
        promotionImageUrl:
          description: Required for CODED_COUPON, MARKDOWN_SALE, and ORDER_DISCOUNT promotions, and not valid for VOLUME_DISCOUNT promotions.  <br><br>Populate this field with a URL that points to an image to be used with the promotion. This image is displayed on the seller's <b>All Offers</b> page. The URL must point to either JPEG or PNG image and it must be a minimum of 500x500 pixels in dimension and cannot exceed 12Mb in size.
          type: string
        promotionStatus:
          description: The current status of the promotion. When creating a new promotion, this value must be set to either <code>DRAFT</code> or <code>SCHEDULED</code>.  <br><br>Note that you must set this value to <code>SCHEDULED</code> when you update a <b>RUNNING</b> promotion. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/sme:PromotionStatusEnum'>eBay API documentation</a>
          type: string
        promotionType:
          description: Use this field to specify the type of the promotion you are creating. <p>The supported types are:</p> <ul><li><code>CODED_COUPON</code> &ndash; A coupon code promotion set with <b>createItemPromotion</b>.</li> <li><code>MARKDOWN_SALE</code> &ndash; A markdown promotion set with <b>createItemPriceMarkdownPromotion</b>.</li> <li><code>ORDER_DISCOUNT</code> &ndash; A threshold promotion set with <b>createItemPromotion</b>.</li> <li><code>VOLUME_DISCOUNT</code> &ndash; A volume pricing promotion set with <b>createItemPromotion</b>.</li></ul> <p>See the <a href="/api-docs/sell/static/marketing/promotions-manager.html" target="_blank">Promotions Manager</a> documentation for details.</p> <p><i>Required if </i> you are creating a volume pricing promotion (<code>VOLUME_DISCOUNT</code>).</p> For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/sme:PromotionTypeEnum'>eBay API documentation</a>
          type: string
        startDate:
          description: The date and time the promotion starts in UTC format (<code>yyyy-MM-ddThh:mm:ssZ</code>). For display purposes, convert this time into the local time of the seller.
          type: string
      type: object
    ItemPromotionResponse:
      description: This complex type defines the fields returned for an item (threshold) promotion.
      properties:
        applyDiscountToSingleItemOnly:
          description: If set to <code>true</code>, the discount is applied only when the buyer purchases multiple quantities of a single item in the promotion. Otherwise, the promotional discount applies to multiple quantities of any items in the promotion. Different variations of a multi-variation item are considered to be the same item. Note that this flag is not relevant if the <b>inventoryCriterion</b> container identifies a single listing ID for the promotion.
          type: boolean
        budget:
          $ref: "#/components/schemas/Amount"
          description: This sets the budget for the <code>CODED_COUPON</code> promotion type. Supported values range from 100-1000000. Supported currency codes include USD, GBP, EUR, and AUD. <p class="tablenote"><b>Note:</b> The budget value for an active or paused promotion can not be decreased.</p> <p class="tablenote"><b>Note:</b> The Currency Code for 'budget' must be the same as the Currency Code for 'maxDiscountAmount'.</p>
        couponConfiguration:
          $ref: "#/components/schemas/CouponConfiguration"
          description: The configuration of a coded coupon promotion.
        description:
          description: Required for CODED_COUPON promotions, this is the seller-defined "tag line" for the offer, such as "Save on designer shoes." The tag line appears under the "offer-type text" that is generated for the promotion and is displayed under the offer tile that is shown on the seller's <b>All Offers</b> page and on the event page for the promotion.  This tag line is not used with volume pricing promotions. <p class="tablenote"><b>Note:</b> Offer-type text is a teaser that's presented throughout the buyer's journey through the sales flow and is generated by eBay. This text is not editable by the seller&mdash;it's derived from the settings in the <b>discountRules</b> and <b>discountSpecification</b> fields&mdash;and can be, for example, "Extra 20% off when you buy 3+".</p>  <br><b>Maximum length:</b> 50
          type: string
        discountRules:
          description: A list containing the promotion benefits (<b>discountRule</b>) and the rules that define when the benefit is applied (<b>discountSpecification</b>).
          items:
            $ref: "#/components/schemas/DiscountRule"
          type: array
        endDate:
          description: The date and time the promotion ends in UTC format (<code>yyyy-MM-ddThh:mm:ssZ</code>). For display purposes, convert this time into the local time of the seller.
          type: string
        inventoryCriterion:
          $ref: "#/components/schemas/InventoryCriterion"
          description: Returns either an array of listing IDs or the selection rules used to specify the items included in the promotion. Listing IDs can be either eBay listing IDs or an array of seller's inventory reference IDs (know as SKUs or custom labels). See the <b>selectionRules</b> container for the rule criteria you can use to select inventory.
        marketplaceId:
          description: The eBay marketplace ID of the site where the threshold promotion is hosted. Threshold promotions are currently supported on a limited number of eBay marketplaces.  <p><b>Valid values:</b></p>  <ul class="compact"><li><code>EBAY_AU</code> = Australia</li> <li><code>EBAY_DE</code> = Germany</li> <li><code>EBAY_ES</code> = Spain</li> <li><code>EBAY_FR</code> = France</li> <li><code>EBAY_GB</code> = Great Britain</li> <li><code>EBAY_IT</code> = Italy</li> <li><code>EBAY_US</code> = United States</li></ul> For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/ba:MarketplaceIdEnum'>eBay API documentation</a>
          type: string
        name:
          description: The seller-defined name or "title" of the promotion that the seller can use to identify a promotion. This label is not displayed in end-user flows.  <br><br><b>Maximum length:</b> 90
          type: string
        priority:
          description: Applicable for only <b>ORDER_DISCOUNT</b> promotions, this field indicates the precedence of the promotion, which eBay uses to determine the position of a promotion on the seller's <b>All Offers</b> page. If an item is associated with multiple promotions, the promotion with the higher priority takes precedence. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/sme:PromotionPriorityEnum'>eBay API documentation</a>
          type: string
        promotionId:
          description: A unique eBay-assigned ID for the promotion that's generated when the promotion is created.
          type: string
        promotionImageUrl:
          description: Required for CODED_COUPON, MARKDOWN_SALE, and ORDER_DISCOUNT promotions, and not applicable for <b>VOLUME_DISCOUNT</b> promotions, this field is a URL that points to an image for the promotion. This image is displayed on the seller's <b>All Offers</b> page. The URL must point to either JPEG or PNG image and it must be a minimum of 500x500 pixels in dimension and cannot exceed 12Mb in size.
          type: string
        promotionStatus:
          description: The current status of the promotion. When creating a new promotion, this value must be set to either <code>DRAFT</code> or <code>SCHEDULED</code>. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/sme:PromotionStatusEnum'>eBay API documentation</a>
          type: string
        promotionType:
          description: Indicates the type of the promotion, either <code>CODED_COUPON</code>, <code>MARKDOWN_SALE</code>, <code>ORDER_DISCOUNT</code>, or <code>VOLUME_DISCOUNT</code>. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/sme:PromotionTypeEnum'>eBay API documentation</a>
          type: string
        startDate:
          description: The date and time the promotion starts in UTC format (<code>yyyy-MM-ddThh:mm:ssZ</code>). For display purposes, convert this time into the local time of the seller.
          type: string
      type: object
    ItemsPagedCollection:
      description: This type defines the fields for a paginated result set of promotions. The response consists of 0 or more sequenced pages that are returned from the complete <i>result set</i>, where each page consists of 0 or more items.
      properties:
        href:
          description: The URI of the current page of results from the result set.
          type: string
        limit:
          description: The number of items returned on a single page from the result set. This value can be set in the request with the <b>limit</b> query parameter.
          format: int32
          type: integer
        listings:
          description: An array of the listings associated with a promotion.
          items:
            $ref: "#/components/schemas/ListingDetail"
          type: array
        next:
          description: "The URI for the following page of results. This value is returned only if there is an additional page of results to display from the result set. <br><br><b>Max length</b>: 2048"
          type: string
        offset:
          description: 'The number of results skipped in the result set before listing the first returned result. This value can be set in the request with the <b>offset</b> query parameter. <p class="tablenote"><strong>Note: </strong>The items in a paginated result set use a zero-based list where the first item in the list has an offset of <code>0</code>.</p>'
          format: int32
          type: integer
        prev:
          description: "The URI for the preceding page of results. This value is returned only if there is a previous page of results to display from the result set. <br><br><b>Max length</b>: 2048"
          type: string
        total:
          description: The total number of items retrieved in the result set.  <br><br>If no items are found, this field is returned with a value of <code>0</code>.
          format: int32
          type: integer
        warnings:
          description: A list of warnings that were generated by the request. Warning do not stop processing, but should be checked to ensure that the response contains the correct information.
          items:
            $ref: "#/components/schemas/Error"
          type: array
      type: object
    Keyword:
      description: A type that contains the details for keywords that are associated with an ad group.<br /><br /><span class="tablenote"><b>Note:</b> This type only applies to the Cost Per Click (CPC) funding model; it does not apply to the Cost Per Sale (CPS) funding model.</span>
      properties:
        adGroupId:
          description: This field identifies the ad group that the keyword is associated with.
          type: string
        bid:
          $ref: "#/components/schemas/Amount"
          description: The bid associated with the keyword. This container will not be returned if the keyword does not have a defined bid value.
        keywordId:
          description: The unique identifier of a keyword.
          type: string
        keywordStatus:
          description: The status of the keyword.<br /><br /><b>Valid Values:</b><ul><li><code>ACTIVE</code></li><li><code>PAUSED</code></li><li><code>ARCHIVED</code></li></ul> For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:KeywordStatusEnum'>eBay API documentation</a>
          type: string
        keywordText:
          description: The text of the keyword.
          type: string
        matchType:
          description: A field that defines the match type for the keyword.<br /><br /><b>Valid Values:</b><ul><li><code>BROAD</code></li><li><code>EXACT</code></li><li><code>PHRASE</code></li></ul> For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:MatchTypeEnum'>eBay API documentation</a>
          type: string
      type: object
    KeywordPagedCollectionResponse:
      description: A type that defines the keywords of the paged collection.
      properties:
        href:
          description: The URI of the current page of results from the result set.
          type: string
        keywords:
          description: This array contains all of the keywords that match the request criteria. Keywords will be sorted by adGroupId, regardless of whether you searched for keywords across the entire campaign, or if you searched for keywords within one or specific ad groups.
          items:
            $ref: "#/components/schemas/Keyword"
          type: array
        limit:
          description: The number of keywords returned on a single page from the result set. This value can be set in the request with the <b>limit</b> query parameter.
          format: int32
          type: integer
        next:
          description: "The call URI that can be used to retrieve the next page in the result set. This value is returned only if there is an additional page of results to display from the result set. <br><br><b>Max length</b>: 2048"
          type: string
        offset:
          description: 'The number of results skipped in the result set before listing the first returned result. This value can be set in the request with the <b>offset</b> query parameter. <p class="tablenote"><strong>Note: </strong>The items in a paginated result set use a zero-based list where the first item in the list has an offset of <code>0</code>.</p>'
          format: int32
          type: integer
        prev:
          description: "The call URI that can be used to retrieve the previous page in the result set. Basically, all of the request parameters will remain the same except the offset value, which will be decreased to retrieve the previous page of results. <br><br><b>Max length</b>: 2048"
          type: string
        total:
          description: The total number of keywords retrieved in the result set.  <br><br>If no keywords are found, this field is returned with a value of <code>0</code>.
          format: int32
          type: integer
      type: object
    KeywordRequest:
      description: A type that defines the fields used by the <b>Keyword</b> method.
      properties:
        keywordText:
          description: "The text of the keyword. Keywords are not case sensitive and compound words can be used without additional encoding (for example, tennis ball).<br /><br /><b>Maximum number of characters: </b>100 <br /><br /><b>Maximum number of words: </b>10 "
          type: string
        matchType:
          description: A field that defines the match type for the keyword.<br /><br /><b>Valid Values:</b><ul><li><code>BROAD</code></li><li><code>EXACT</code></li><li><code>PHRASE</code></li></ul> For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:MatchTypeEnum'>eBay API documentation</a>
          type: string
      type: object
    KeywordResponse:
      description: A type that defines the response fields used by the <b>Keyword</b> method.
      properties:
        adGroupId:
          description: The identifier of the ad group that the keyword was added to.
          type: string
        errors:
          description: This container will be returned if there is an issue creating the corresponding keyword and/or adding that keyword to the corresponding ad group.
          items:
            $ref: "#/components/schemas/Error"
          type: array
        href:
          description: The getKeyword URI for the keyword, which is used to retrieve the keyword. This URI will be returned for each successfully created keyword.
          type: string
        keywordId:
          description: A unique eBay-assigned ID for a keyword that is generated for an ad group. This keyword ID will be generated for each successfully created keyword.
          type: string
        keywordText:
          description: The text of the keyword.
          type: string
        matchType:
          description: A field that defines the match type for the keyword.<br /><br /><b>Valid Values:</b><ul><li><code>BROAD</code></li><li><code>EXACT</code></li><li><code>PHRASE</code></li></ul> For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:MatchTypeEnum'>eBay API documentation</a>
          type: string
        statusCode:
          description: An HTTP status code is returned for each keyword to indicate the success or failure of adding that keyword to the ad group.
          format: int32
          type: integer
      type: object
    ListingDetail:
      description: This type defines the fields that describe a listing that is in a promotion.
      properties:
        currentPrice:
          $ref: "#/components/schemas/Amount"
          description: The container that returns the current price of the listing.
        freeShipping:
          description: If set to <code>true</code>, the seller pays for the shipping (or that the item is marked for local pickup only) In this case, the listing does not have an associated shipping cost for the first listed domestic-shipping option (even if the first domestic-shipping option specifies a flat-rate or calculated shipping option). If <code>false</code>, the buyer is required to pay for a flat-rate or calculated cost shipping service.
          type: boolean
        inventoryReferenceId:
          description: The seller's inventory reference ID for a listing. Also known as the "SKU" or "custom label," an inventory reference ID is either the ID of the listing or, if the listing has variations (such as a shirt that's available in multiple sizes and colors), the ID of the parent listing.
          type: string
        inventoryReferenceType:
          description: Indicates the type of the <b>inventoryReferenceId</b>, which can be either a single-SKU or a multi-SKU listing (<code>INVENTORY_ITEM</code> and <code>INVENTORY_ITEM_GROUP</code>, respectively).  <br><br><b>Note:</b> This value is not currently returned in the response.
          type: string
        listingCategoryId:
          description: The ID of the category that listing belongs to. The ID is a numeric and unique identifier for the category that is assigned by eBay.
          type: string
        listingCondition:
          description: An eBay-assigned value that indicates condition of the associated item. For more information, see <a href="/api-docs/sell/static/metadata/condition-id-values.html">Item condition ID and name values</a>.
          type: string
        listingConditionId:
          description: 'The ID of the condition associated with the item. For more information, see <a href="/api-docs/sell/static/metadata/condition-id-values.html">Item condition ID and name values</a>.<br /><br /><span class="tablenote"><b>Note: </b> This value is not currently returned in the response.</span>'
          type: string
        listingId:
          description: A unique eBay-assigned ID that is generated when the item is listed.
          type: string
        listingPromotionStatuses:
          description: A list of the status values assigned to the item and the date that each new status was assigned.
          items:
            $ref: "#/components/schemas/ItemMarkdownStatus"
          type: array
        quantity:
          description: The number of items being sold in the listing.
          format: int32
          type: integer
        storeCategoryId:
          description: Store CategoryId (if any) that to which the listing belongs. This field is blank if there is no seller Store category ID.
          type: string
        title:
          description: The seller-defined title of the listing that a seller can use to identify the item.  This label is not displayed in end-user flows.
          type: string
      type: object
    MetricMetadata:
      description: This type defines the name and data type of a metric.
      properties:
        dataType:
          description: The data type of the returned metric value. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/plr:DataTypeEnum'>eBay API documentation</a>
          type: string
        metricKey:
          description: The name of the metric.
          type: string
      type: object
    NegativeKeyword:
      description: A type that defines the fields for a negative keyword.
      properties:
        adGroupId:
          description: An ad group ID that is generated when an ad group is first created and associated with a campaign.<br /><br /><span class="tablenote"><b>Note:</b> You can call the  <a href="/api-docs/sell/marketing/resources/adgroup/methods/getAdGroups">getAdGroups</a> method to retrieve the ad group IDs for a seller.</span>
          type: string
        campaignId:
          description: A unique eBay-assigned ID for a campaign. This ID is generated when a campaign is created.
          type: string
        negativeKeywordId:
          description: A unique eBay-assigned ID for a negative keyword. This keyword ID will be generated for each successfully created negative keyword.
          type: string
        negativeKeywordMatchType:
          description: A field that defines the match type for the negative keyword.<br /><br /><span class="tablenote"><span style="color:#004680"><strong>Note:</strong></span> Broad matching of negative keywords is not currently supported.</span><br /><b>Valid Values:</b><ul><li><code>EXACT</code></li><li><code>PHRASE</code></li></ul> For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:NegativeKeywordMatchTypeEnum'>eBay API documentation</a>
          type: string
        negativeKeywordStatus:
          description: A field that defines the status of the negative keyword. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:NegativeKeywordStatusEnum'>eBay API documentation</a>
          type: string
        negativeKeywordText:
          description: The text for the negative keyword.
          type: string
      type: object
    NegativeKeywordPagedCollectionResponse:
      description: A type that defines the negative keywords, returned in a paged collection.
      properties:
        href:
          description: The URI of the current page of results from the result set.
          type: string
        limit:
          description: The number of items returned on a single page from the result set. This value can be set in the request with the <b>limit</b> query parameter.
          format: int32
          type: integer
        negativeKeywords:
          description: A list of negative keywords returned in the paginated collection.
          items:
            $ref: "#/components/schemas/NegativeKeyword"
          type: array
        next:
          description: The call URI that can be used to retrieve the next page in the result set. This value is returned only if there is an additional page of results to display from the result set.
          type: string
        offset:
          description: 'The number of results skipped in the result set before listing the first returned result. This value can be set in the request with the <b>offset</b> query parameter.<br /><br /><b>Default:</b> <code>0</code><br /><br /><span class="tablenote"><b>Note: </b>The items in a paginated result set use a zero-based list, where the first item in the list has an offset of <code>0</code>.</span>'
          format: int32
          type: integer
        prev:
          description: The call URI that can be used to retrieve the previous page in the result set. Basically, all of the request parameters will remain the same except the offset value, which will be decreased to retrieve the previous page of results.
          type: string
        total:
          description: The total number of result sets in the paginated collection.
          format: int32
          type: integer
      type: object
    NegativeKeywordResponse:
      description: A type that defines the negative keyword response.
      properties:
        adGroupId:
          description: A unique identifier for an ad group that is generated when an ad group is first created and associated with a campaign.
          type: string
        campaignId:
          description: A unique eBay-assigned ID for a campaign. This ID is generated when a campaign is created.
          type: string
        errors:
          description: This container will be returned if there is an issue creating the corresponding negative keyword.
          items:
            $ref: "#/components/schemas/Error"
          type: array
        href:
          description: The URI for the negative keyword, which is used to retrieve the negative keyword. This URI will be returned for each successfully created negative keyword.
          type: string
        negativeKeywordId:
          description: A unique eBay-assigned ID for a negative keyword. This negative keyword ID will be generated for each successfully created negative keyword.
          type: string
        negativeKeywordMatchType:
          description: The match type for the negative keyword.<br /><br /><span class="tablenote"><span style="color:#004680"><strong>Note:</strong></span> Broad matching of negative keywords is not currently supported.</span><br /><b>Valid Values:</b><ul><li><code>EXACT</code></li><li><code>PHRASE</code></li></ul> For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:NegativeKeywordMatchTypeEnum'>eBay API documentation</a>
          type: string
        negativeKeywordText:
          description: The text for the negative keyword.
          type: string
        statusCode:
          description: The status of the request to create a negative keyword. This field indicates whether the process was successful or not.
          format: int32
          type: integer
      type: object
    PromotionDetail:
      description: This type defines the fields that describe a promotion. This includes all the information about a promotion except for the listings that are a part of the promotion.
      properties:
        couponCode:
          description: A unique code that buyers can use during checkout to receive a discount. The code must be unique across eBay.
          type: string
        description:
          description: This is the seller-defined "tag line" for the offer, such as "Save on designer shoes." Tag lines appear under the "offer-type text" that is generated for a promotion and displayed under the offer tile that is shown on the seller's <b>All Offers</b> page and on the promotion's event page.  <p class="tablenote"><b>Note:</b> Offer-type text is a teaser that's presented throughout the buyer's journey through the sales flow and is generated by eBay. This text is not editable by the seller&mdash;it's derived from the settings in the <b>discountRules</b> and <b>discountSpecification</b> fields&mdash;and can be, for example, "Extra 20% off when you buy 3+".</p>  <br><b>Maximum length:</b> 50 <br><br><i>Required if</i> you are configuring ORDER_DISCOUNT or MARKDOWN_SALE promotions (and not valid for VOLUME_DISCOUNT promotions).
          type: string
        endDate:
          description: The date and time the promotion ends in UTC format (<code>yyyy-MM-ddThh:mm:ssZ</code>). For display purposes, convert this time into the local time of the seller.
          type: string
        marketplaceId:
          description: The eBay marketplace ID of the site where the promotion is hosted. Threshold promotions are supported on a select set of marketplaces while markdown promotions are supported on all eBay marketplaces. <p><b>Valid values for threshold promotions are as follows:</b></p>  <ul class="compact"><li><code>EBAY_AU</code> = Australia</li> <li><code>EBAY_DE</code> = Germany</li> <li><code>EBAY_ES</code> = Spain</li> <li><code>EBAY_FR</code> = France</li> <li><code>EBAY_GB</code> = Great Britain</li> <li><code>EBAY_IT</code> = Italy</li> <li><code>EBAY_US</code> = United States</li></ul> For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/ba:MarketplaceIdEnum'>eBay API documentation</a>
          type: string
        name:
          description: The seller-defined name or "title" of the promotion, such as "Buy 1 Get 1", that the seller can use to identify a promotion. This label is not displayed in end-user flows.  <br><br><b>Maximum length:</b> 90
          type: string
        priority:
          description: Applicable for only <b>ORDER_DISCOUNT</b> promotions, this field indicates the precedence of the promotion, which is used to determine the position of a promotion on the seller's <b>All Offers</b> page. If an item is associated with multiple promotions, the promotion with the higher priority takes precedence. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/sme:PromotionPriorityEnum'>eBay API documentation</a>
          type: string
        promotionHref:
          description: The URI of the promotion details.
          type: string
        promotionId:
          description: A unique eBay-assigned ID for the promotion that's generated when the promotion is created.
          type: string
        promotionImageUrl:
          description: Required for CODED_COUPON, MARKDOWN_SALE, and ORDER_DISCOUNT promotions, and not applicable for <b>VOLUME_DISCOUNT</b> promotions, this field is a URL that points to an image for the promotion. This image is displayed on the seller's <b>All Offers</b> page. The URL must point to either JPEG or PNG image and it must be a minimum of 500x500 pixels in dimension and cannot exceed 12Mb in size.
          type: string
        promotionStatus:
          description: The current status of the promotion. When creating a new promotion, you must set this value to either <code>DRAFT</code> or <code>SCHEDULED</code>. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/sme:PromotionStatusEnum'>eBay API documentation</a>
          type: string
        promotionType:
          description: Indicates type of the promotion, either <code>CODED_COUPON</code>, <code>MARKDOWN_SALE</code>, <code>ORDER_DISCOUNT</code>, or <code>VOLUME_DISCOUNT</code>. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/sme:PromotionTypeEnum'>eBay API documentation</a>
          type: string
        startDate:
          description: The date and time the promotion starts in UTC format (<code>yyyy-MM-ddThh:mm:ssZ</code>). For display purposes, convert this time into the local time of the seller.
          type: string
      type: object
    PromotionReportDetail:
      description: This type defines the fields in a promotion-level report.
      properties:
        averageItemDiscount:
          $ref: "#/components/schemas/Amount"
          description: "The <i>average item discount</i> is the average discount that has been applied to each item in a promotion. This value is calculated as follows:  <br><br><b>totalDiscount</b> / <b>itemsSoldQuantity</b> = <b>averageItemDiscount</b>"
        averageItemRevenue:
          $ref: "#/components/schemas/Amount"
          description: "The <i>average item revenue</i> is the average revenue that has been received for each item in a promotion. This value is calculated as follows:  <br><br><b>totalSales</b> / <b>itemsSoldQuantity</b> = <b>averageItemRevenue</b>"
        averageOrderDiscount:
          $ref: "#/components/schemas/Amount"
          description: "The <i>average order discount</i> is the average discount that has been applied to each order in a promotion. This value is calculated as follows:  <br><br><b>totalDiscount</b> / <b>numberOfOrdersSold</b> = <b>averageOrderDiscount</b>"
        averageOrderRevenue:
          $ref: "#/components/schemas/Amount"
          description: "The <i>average order revenue</i> is the average revenue that has been received for each order in a promotion. This value is calculated as follows:  <br><br><b>totalSales</b> / <b>numberOfOrdersSold</b> = <b>averageOrderRevenue</b>"
        averageOrderSize:
          description: "The <i>average order size</i> is the average number of items that each order contained in a promotion. This value is calculated as follows:  <br><br><b>itemsSoldQuantity</b> / <b>numberOfOrdersSold</b> = <b>averageOrderSize</b> "
          type: string
        baseSale:
          $ref: "#/components/schemas/Amount"
          description: This is the monetary amount of items purchased in a promotion where the threshold <i>wasn't met</i>, so the discount was not applied.  <br><br>For example, suppose you're running a "Buy 1, get 1 at 50%" promotion on $5 socks. One buyer purchased only one pair of socks, so they pay the full price of $5. Here, your <b>baseSale</b> amount would be $5.
        itemsSoldQuantity:
          description: This is the quantity of items purchased in a threshold promotion where the threshold <i>has been met</i> and the discount was applied. <br><br>For example, suppose you're running a "Buy 1, get 1 at 50%" promotion on $5 socks. One buyer purchases two pairs of socks, so they pay $7.50 for both pairs (rather than the full price of $10). Your number of items sold (<b>itemsSoldQuantity</b>) would be 2 and you number of orders sold (<b>numberOfOrdersSold</b>) would be 1.
          format: int32
          type: integer
        numberOfOrdersSold:
          description: This is the number of orders sold in a threshold promotion where the threshold <i>has been met</i> and the discount was applied. <br><br>For example, suppose you're running a "Buy 1, get 1 at 50%" promotion on $5 socks. One buyer purchases two pairs of socks, so they pay $7.50 for both pairs (rather than the full price of $10). Your <b>numberOfOrdersSold</b> would be 1 and your <b>itemsSoldQuantity</b> would be 2.
          format: int32
          type: integer
        percentageSalesLift:
          description: "The <i>percentage sales lift</i> is the total dollar amount gained due to promotions. This value is calculated as follows:  <br><br> <b>promotionSale</b> / <b>totalSale</b> =  <b>percentageSalesLift</b> "
          type: string
        promotionHref:
          description: The URI of the promotion report.
          type: string
        promotionId:
          description: A unique eBay-assigned ID for the promotion that's generated when the promotion is created.
          type: string
        promotionReportId:
          description: The unique eBay-assigned ID of the promotion report that is generated when the report is created.
          type: string
        promotionSale:
          $ref: "#/components/schemas/Amount"
          description: This is the monetary amount of the items sold in a threshold promotion where the threshold <i>has been met</i> and the discount was applied.  <br><br>For example, suppose you're running a "Buy 1, get 1 at 50%" promotion on $5 socks. One buyer purchases two pairs of socks, so they pay $7.50 for both pairs (rather than the full price of $10). Your <b>promotionSale</b> amount would be $7.50.
        promotionType:
          description: Indicates the type of the promotion, either <code>CODED_COUPON</code>, <code>MARKDOWN_SALE</code>, <code>ORDER_DISCOUNT</code>, or <code>VOLUME_DISCOUNT</code>. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/sme:PromotionTypeEnum'>eBay API documentation</a>
          type: string
        totalDiscount:
          $ref: "#/components/schemas/Amount"
          description: This is the monetary discount amount applied to the sale of items in a threshold promotion where the threshold <i>has been met</i> and the discount was applied.  <br><br>For example, suppose you're running a "Buy 1, get 1 at 50%" promotion on $5 socks. One buyer purchases two pairs of socks, so they pay $7.50 for both pairs (rather than the full price of $10). Your <b>totalDiscount</b> amount would be $2.50.
        totalSale:
          $ref: "#/components/schemas/Amount"
          description: "This is the total monetary sales amount of all items sold in a promotion. <br><br>For example, suppose you're running a \"Buy 1, get 1 at 50%\" promotion on $5 socks. You make one sale where the buyer purchases only one pair of socks and they pay the full price of $5 (<b>baseSale</b>). You make a second sale where the buyer purchases two pairs of socks and they pay $7.50, for both pairs (<b>promotionSale</b>). Your <b>totalSale</b> would be $12.50. This value is calculated as follows:  <br><br><b>baseSale</b> + <b>promotionSale</b> = <b>totalSale</b>"
      type: object
    PromotionsPagedCollection:
      description: This type defines the fields in a paginated result set of seller promotions. The response consists of 0 or more sequenced pages that are returned from the complete <i>result set</i>, where each page consists of 0 or more items.
      properties:
        href:
          description: The URI of the current page of results from the result set.
          type: string
        limit:
          description: The number of items returned on a single page from the result set. This value can be set in the request with the <b>limit</b> query parameter.
          format: int32
          type: integer
        next:
          description: "The URI for the following page of results. This value is returned only if there is an additional page of results to display from the result set. <br><br><b>Max length</b>: 2048"
          type: string
        offset:
          description: 'The number of results skipped in the result set before listing the first returned result. This value can be set in the request with the <b>offset</b> query parameter. <p class="tablenote"><strong>Note: </strong>The items in a paginated result set use a zero-based list where the first item in the list has an offset of <code>0</code>.</p>'
          format: int32
          type: integer
        prev:
          description: "The URI for the preceding page of results. This value is returned only if there is a previous page of results to display from the result set. <br><br><b>Max length</b>: 2048"
          type: string
        promotions:
          description: A list containing the details of each returned promotion. This includes all the information about the promotions except for the listings that are part of the promotions.
          items:
            $ref: "#/components/schemas/PromotionDetail"
          type: array
        total:
          description: The total number of items retrieved in the result set.  <br><br>If no items are found, this field is returned with a value of <code>0</code>.
          format: int32
          type: integer
      type: object
    PromotionsReportPagedCollection:
      description: This type defines the fields in a paginated result set of promotion-level reports. The response consists of 0 or more sequenced pages that are returned from the complete <i>result set</i>, where each page consists of 0 or more items.
      properties:
        href:
          description: The URI of the current page of results from the result set.
          type: string
        limit:
          description: The number of items returned on a single page from the result set. This value can be set in the request with the <b>limit</b> query parameter.
          format: int32
          type: integer
        next:
          description: "The URI for the following page of results. This value is returned only if there is an additional page of results to display from the result set. <br><br><b>Max length</b>: 2048"
          type: string
        offset:
          description: 'The number of results skipped in the result set before listing the first returned result. This value can be set in the request with the <b>offset</b> query parameter. <p class="tablenote"><strong>Note: </strong>The items in a paginated result set use a zero-based list where the first item in the list has an offset of <code>0</code>.</p>'
          format: int32
          type: integer
        prev:
          description: "The URI for the preceding page of results. This value is returned only if there is a previous page of results to display from the result set. <br><br><b>Max length</b>: 2048"
          type: string
        promotionReports:
          description: A list of <b>promotionReports</b> contained in the paginated result set.
          items:
            $ref: "#/components/schemas/PromotionReportDetail"
          type: array
        total:
          description: The total number of items retrieved in the result set.  <br><br>If no items are found, this field is returned with a value of <code>0</code>.
          format: int32
          type: integer
      type: object
    ProposedBid:
      description: A type that defines the data for a payment amount, such as the sale price.
      properties:
        currency:
          description: The base currency applied to the <b>value</b> field to establish a monetary amount.  <br><br>The currency is represented as a 3-letter <a href="https://www.iso.org/iso-4217-currency-codes.html " title="https://www.iso.org " target="_blank">ISO 4217</a> currency code. For example, the code for the Canadian Dollar is <code>CAD</code>.  <br><br><b>Default:</b> The default currency of the eBay marketplace that hosts the listing. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/ba:CurrencyCodeEnum'>eBay API documentation</a>
          type: string
        rangeEnd:
          description: The end of the range specified for the bid.
          type: string
        rangeStart:
          description: The start of the range specified for the bid.
          type: string
        value:
          description: The value of the proposed bid.
          type: string
      type: object
    ReportMetadata:
      description: This type defines the fields included in the report.
      properties:
        dimensionMetadata:
          description: A list containing the metadata for the dimension used in the report.
          items:
            $ref: "#/components/schemas/DimensionMetadata"
          type: array
        maxNumberOfDimensionsToRequest:
          description: The maximum number of dimensions that can be requested for the specified report type.
          format: int32
          type: integer
        maxNumberOfMetricsToRequest:
          description: The maximum number of metrics that can be requested for the specified report type.
          format: int32
          type: integer
        metricMetadata:
          description: A list containing the metadata for the metrics in the report.
          items:
            $ref: "#/components/schemas/MetricMetadata"
          type: array
        reportType:
          description: The <b>report_type</b>, as specified in the request to create the report task.<br/><br/><span class="tablenote"><b>Note:</b> INVENTORY_PERFORMANCE_REPORT is not currently available; availability date is pending.</span> For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/plr:ReportTypeEnum'>eBay API documentation</a>
          type: string
      type: object
    ReportMetadatas:
      description: This type defines the metadata used by the all report types.
      properties:
        reportMetadata:
          description: A list of the metadata for the associated report type.
          items:
            $ref: "#/components/schemas/ReportMetadata"
          type: array
      type: object
    ReportTask:
      description: This type defines the fields in a report task.
      properties:
        campaignIds:
          description: A list of IDs for the campaigns that are included in the report. A campaign ID is a unique eBay-assigned identifier of the campaign that's generated when the campaign is created.<br /><br />Call <b>getCampaigns</b> to return the current campaign IDs for a seller.
          items:
            type: string
          type: array
        dateFrom:
          description: The date defining the start of the timespan covered by the report, formatted as an <a href="https://www.iso.org/iso-8601-date-and-time-format.html " title="https://www.iso.org " target="_blank">ISO 8601</a> timestamp.
          type: string
        dateTo:
          description: The date defining the end of the timespan covered by the report, formatted as an <a href="https://www.iso.org/iso-8601-date-and-time-format.html " title="https://www.iso.org " target="_blank">ISO 8601</a> timestamp.
          type: string
        dimensions:
          description: A list containing the dimension in the report.
          items:
            $ref: "#/components/schemas/Dimension"
          type: array
        fundingModels:
          description: The funding model for the campaign that shall be included in the report.<br /><br /><span class="tablenote"><span style="color:#004680"><strong>Note:</strong></span> The default funding model for Promoted Listings reports is <code>COST_PER_SALE</code>.</span><br /><br /><b>Valid Values:</b><ul><li><code>COST_PER_SALE</code></li><li><code>COST_PER_CLICK</code></li></ul>
          items:
            description: " For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:FundingModelEnum'>eBay API documentation</a>"
            type: string
          type: array
        inventoryReferences:
          description: If supplied in the request, this field returns a list of the seller's inventory reference IDs included in the report.  <p>Each item is referenced by a pair of <b>inventoryRefernceID</b> and <b>inventoryReferenceType</b> values, where an inventory reference ID can be either a seller-defined <b>SKU</b> value or an <b>inventoryItemGroupKey</b>. An <b>inventoryItemGroupKey</b> is seller-defined ID for an inventory item group (a multiple-variation listing), and is created and used by the <a href="/api-docs/sell/inventory/resources/methods">Inventory API</a>.</p>
          items:
            $ref: "#/components/schemas/InventoryReference"
          type: array
        listingIds:
          description: If supplied in the request, this field returns a list of the listing IDs included in the report. A listing ID is an eBay-assigned ID that's generated when a listing is created.
          items:
            type: string
          type: array
        marketplaceId:
          description: The ID of the eBay marketplace used by the report task. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/ba:MarketplaceIdEnum'>eBay API documentation</a>
          type: string
        metricKeys:
          description: A list of metrics for the report task.
          items:
            type: string
          type: array
        reportExpirationDate:
          description: "The date after which the report is no longer be available. Reports are available for 30 days and you cannot download a report after it has expired.  <br><br><b>Format (UTC): </b> yyyy-MM-ddThh:mm:ss.sssZ"
          type: string
        reportFormat:
          description: Indicates the format of the report. Currently, only <code>TSV_GZIP</code> is supported. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/plr:ReportFormatEnum'>eBay API documentation</a>
          type: string
        reportHref:
          description: The URL of the generated report, which can be used to download the report once it has been generated.
          type: string
        reportId:
          description: A unique eBay-assigned ID for the report.
          type: string
        reportName:
          description: An eBay-assigned name for the report that's created by the <b>createReportTask</b> call. This name is unique for the seller.
          type: string
        reportTaskCompletionDate:
          description: "The date the report task completed the report generation.  <br><br><b>Format (UTC): </b> yyyy-MM-ddThh:mm:ss.sssZ"
          type: string
        reportTaskCreationDate:
          description: "The date the report task was created.  <br><br><b>Format (UTC): </b> yyyy-MM-ddThh:mm:ss.sssZ"
          type: string
        reportTaskExpectedCompletionDate:
          description: "The date the report task is expected to complete the report generation.  <br><br><b>Format (UTC): </b> yyyy-MM-ddThh:mm:ss.sssZ"
          type: string
        reportTaskId:
          description: The unique eBay-assigned ID of the report task. This value is generated when the report task is created with a call to <b>createReportTask</b>.
          type: string
        reportTaskStatus:
          description: Indicates the current state of the report task. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/plr:TaskStatusEnum'>eBay API documentation</a>
          type: string
        reportTaskStatusMessage:
          description: A status message with additional information about the report task.
          type: string
        reportType:
          description: Indicates type of report associated with the report task.<br/><br/><span class="tablenote"><b>Note:</b> INVENTORY_PERFORMANCE_REPORT is not currently available; availability date is pending.</span> For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/plr:ReportTypeEnum'>eBay API documentation</a>
          type: string
      type: object
    ReportTaskPagedCollection:
      description: This type defines the fields that paginate the reports tasks returned by the request. The entire <i>result set</i> consists of 0 or more sequenced <i>response pages</i>, where each page consists of 0 or more items from the complete result set.
      properties:
        href:
          description: The URI of the current page of results from the result set.
          type: string
        limit:
          description: The number of items returned on a single page from the result set. This value can be set in the request with the <b>limit</b> query parameter.
          format: int32
          type: integer
        next:
          description: "The URI for the following page of results. This value is returned only if there is an additional page of results to display from the result set. <br><br><b>Max length</b>: 2048"
          type: string
        offset:
          description: The number of results skipped in the result set before listing the first returned result. This value can be set in the request with the <b>offset</b> query parameter.<br /><br /><span class="tablenote"><span style="color:#004680"><strong>Note:</strong></span> The items in a paginated result set use a zero-based list where the first item in the list has an offset of <code>0</code>.</span>
          format: int32
          type: integer
        prev:
          description: "The URI for the preceding page of results. This value is returned only if there is a previous page of results to display from the result set. <br><br><b>Max length</b>: 2048"
          type: string
        reportTasks:
          description: A list of report tasks contained on this page from the paginated response.
          items:
            $ref: "#/components/schemas/ReportTask"
          type: array
        total:
          description: The total number of items retrieved in the result set.  <br><br>If no items are found, this field is returned with a value of <code>0</code>.
          format: int32
          type: integer
      type: object
    RuleCriteria:
      description: This type defines the fields for a set of inventory selection rules.  <br><br><b>Required:</b> When <b>inventoryCriterionType</b> is set to <code>INVENTORY_BY_RULE</code> or <code>INVENTORY_ANY</code>.
      properties:
        excludeInventoryItems:
          description: A list of seller inventory reference IDs to exclude from the promotion.  <br><br><p class="tablenote"><b>Note:</b> The request can have either <b>excludeInventoryItems</b> or <b>excludeListingIds</b> but not both.</p> <b>Maximum:</b> 100 parent items <br><b>Maximum SKU or custom label length:</b> 50 characters
          items:
            $ref: "#/components/schemas/InventoryItem"
          type: array
        excludeListingIds:
          description: A list of eBay listing IDs to exclude from the promotion.  <br><br><p class="tablenote"><b>Note:</b> The request can have either <b>excludeInventoryItems</b> or <b>excludeListingIds</b> but not both.</p> <b>Maximum:</b> 100 parent items <br><b>Maximum SKU or custom label length:</b> 50 characters
          items:
            type: string
          type: array
        markupInventoryItems:
          description: A list of SKUs to remove from a markdown promotion. The listed SKUs are 'marked up' to their standard price after being part of the markdown promotion.
          items:
            $ref: "#/components/schemas/InventoryItem"
          type: array
        markupListingIds:
          description: A list of listing IDs to remove from a markdown promotion. The listed items are 'marked up' to their standard price after being part of the markdown promotion.
          items:
            type: string
          type: array
        selectionRules:
          description: The container for the rules that select the items to include in a promotion.  <br><br><i>Required if </i> <b>inventoryCriterionType</b> is set to <code>INVENTORY_BY_RULE</code>. <br><br>For information on using the contained fields, see <a href= "/api-docs/sell/static/marketing/using-the-selectionrules-container.html#Promotio ">Item promotions</a>.
          items:
            $ref: "#/components/schemas/SelectionRule"
          type: array
      type: object
    SelectedInventoryDiscount:
      description: This type defines the fields that describe the discounts applied to a set of inventory items and the order in which the selection rules are applied.
      properties:
        discountBenefit:
          $ref: "#/components/schemas/DiscountBenefit"
          description: This container defines the promotional discount as either a monetary amount or a percentage applied to the sales price.
        discountId:
          description: A unique, eBay-generated ID that you can use to identify the discount. This field is ignored in POST and PUT operations.
          type: string
        inventoryCriterion:
          $ref: "#/components/schemas/InventoryCriterion"
          description: A container that defines either the listing IDs or the selection rules that specify the items to include in the promotion. Listing IDs can be either eBay listing IDs or a list of the seller's inventory reference IDs (know as SKUs or custom labels). See the <b>selectionRules</b> container for the rule criteria you can use to select inventory.  <p class="tablenote"><b>Note:</b> All listings in Promotions Manager promotions must support an electronic payment method.</p>
        ruleOrder:
          description: For markdown promotions, this field is reserved for future use. <!--This field specifies the precedence of this set of inventory criteria, which is taken into account if an item is selected for multiple discounts by different sets of criteria. The criteria with the highest priority (lowest ruleOrder value) takes precedence over criteria with a lower precedence.-->
          format: int32
          type: integer
      type: object
    SelectionRule:
      description: This type defines all rules/inclusion filters used to add listings to campaigns or promotions. Use of the specific fields is different for campaigns or promotions. See <a href= "/api-docs/sell/static/marketing/using-the-selectionrules-container.html ">Using the selectionRules container</a>.
      properties:
        brands:
          description: An array of product brands. For more details, see <a href="/api-docs/sell/static/marketing/using-the-selectionrules-container.html ">Using the selectionRules container</a>.
          items:
            type: string
          type: array
        categoryIds:
          description: This field contains an array of the associated category ID(s).<br><br>For <a href= "/api-docs/sell/static/marketing/using-the-selectionrules-container.html#Promotio ">Item promotions</a>, a single-item array containing the category ID associated with the promotion. Required when used in an Item promotion and either specifying a <b>selectionRules</b> container or when <b>inventoryCriterionType</b> is set to <code>INVENTORY_BY_RULE</code>.<br><br>For <a href= "/api-docs/sell/static/marketing/using-the-selectionrules-container.html#Campaign ">Promoted Listing campaigns</a>, an array of category ID(s) associated with the campaign. <br><br>For information on how to get category IDs, see <a href= "/api-docs/sell/static/marketing/using-the-selectionrules-container.html#eBay ">eBay Marketplace category IDs</a> and <a href= "/api-docs/sell/static/marketing/using-the-selectionrules-container.html#Seller ">Seller store category IDs</a>
          items:
            type: string
          type: array
        categoryScope:
          description: This enumerated value indicates if the category ID for the item is an identifier for eBay categories or for a seller's eBay store categories. <br><br>For <a href= "/api-docs/sell/static/marketing/using-the-selectionrules-container.html#Campaign ">Promoted Listing campaigns</a>, this field includes the type of the category ID for the item(s) to be included in the campaign.<br><br>For <a href= "/api-docs/sell/static/marketing/using-the-selectionrules-container.html#Promotio ">Item promotions</a>, this field identifies the scope for the corresponding array as eBay categories or for a seller's eBay store categories. Required when used in an Item promotion and <b>inventoryCriterionType</b> is set to <code>INVENTORY_BY_RULE</code>.  For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:CategoryScopeEnum'>eBay API documentation</a>
          type: string
        listingConditionIds:
          description: A comma-separated list of unique identifiers for the conditions of listings to be included<br><br>For <a href= "/api-docs/sell/static/marketing/using-the-selectionrules-container.html#Campaign ">Promoted Listing campaigns</a>, refer to <a href= "/api-docs/sell/static/marketing/pl-campaign-flow-pls.html#add-by-rule ">Add items to the PLS campaign</a>. Up to four IDs can be specified.<br><br>For <a href= "/api-docs/sell/static/marketing/using-the-selectionrules-container.html#Promotio ">Item promotions</a>, refer to <a href= "/api-docs/sell/static/metadata/condition-id-values.html ">Item condition ID and name values</a>.
          items:
            type: string
          type: array
        maxPrice:
          $ref: "#/components/schemas/Amount"
          description: This container sets the maximum price threshold. For more details, see <a href= "/api-docs/sell/marketing/resources/using-the-selectionrules-container.html ">Using the selectionRules container</a>.
        minPrice:
          $ref: "#/components/schemas/Amount"
          description: This container sets the minimum price threshold. For more details, see <a href= "/api-docs/sell/marketing/resources/using-the-selectionrules-container.html ">Using the selectionRules container</a>.
      type: object
    SuggestedBids:
      description: The suggested bid rate for the item.
      properties:
        keywordText:
          description: The text for the keyword.
          type: string
        matchType:
          description: A field that defines the match type for the keyword.<br /><br /><b>Valid Values:</b><ul><li><code>BROAD</code></li><li><code>EXACT</code></li><li><code>PHRASE</code></li></ul> For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:MatchTypeEnum'>eBay API documentation</a>
          type: string
        proposedBid:
          $ref: "#/components/schemas/ProposedBid"
          description: "The suggested bid associated with the keyword. "
      type: object
    SuggestedKeywords:
      description: The suggested keywords for the item.
      properties:
        additionalInfo:
          description: "A container for the additional information and compiled insight data for suggested keywords. "
          items:
            $ref: "#/components/schemas/AdditionalInfo"
          type: array
        keywordText:
          description: The text for the keyword.
          type: string
        matchType:
          description: A field that defines the match type for the keyword.<br /><br /><b>Valid Values:</b><ul><li><code>BROAD</code></li><li><code>EXACT</code></li><li><code>PHRASE</code></li></ul> For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:MatchTypeEnum'>eBay API documentation</a>
          type: string
      type: object
    SummaryReportResponse:
      description: This type defines the fields in an Promotions Manager Summary report. Reports are formatted in JSON. For more details, see <a href="/api-docs/sell/static/marketing/pm-summary-reports.html">Reading item promotion Summary reports</a>.
      properties:
        baseSale:
          $ref: "#/components/schemas/Amount"
          description: The total revenue from all the purchased items that were part of a promotion but <i>did not trigger</i> a discount during the promotion period.
        lastUpdated:
          description: The date the report was generated.
          type: string
        percentageSalesLift:
          description: "The percentage of the total dollar amount gained due to promotions. This value is calculated as follows:  <br><br><b>precentageSalesLift</b> = <b>promotionSale</b> / (<b>baseSale</b> + <b>promotionSale</b>)"
          type: string
        promotionSale:
          $ref: "#/components/schemas/Amount"
          description: The total revenue from all the purchased items that were part of a promotion and their purchase <i>did trigger</i> a discount during the promotion period.
        totalSale:
          $ref: "#/components/schemas/Amount"
          description: Total dollar sales amount of all the seller's listings, current to the date the report was generated.
      type: object
    TargetedAdsPagedCollection:
      description: A type that defines the keywords of the paged collection.
      properties:
        href:
          description: The URI of the current page of results from the result set.
          type: string
        limit:
          description: The number of items returned on a single page from the result set. This value can be set in the request with the <b>limit</b> query parameter.
          format: int32
          type: integer
        next:
          description: The call URI that can be used to retrieve the next page in the result set. This value is returned only if there is an additional page of results to display from the result set.
          type: string
        offset:
          description: 'The number of results skipped in the result set before listing the first returned result. This value can be set in the request with the <b>offset</b> query parameter. <p><b>Default:</b> 0</p><br><span class="tablenote"><b>Note: </b>The items in a paginated result set use a zero-based list, where the first item in the list has an offset of <code>0</code>.</span>'
          format: int32
          type: integer
        prev:
          description: The call URI that can be used to retrieve the previous page in the result set. Basically, all of the request parameters will remain the same except the offset value, which will be decreased to retrieve the previous page of results.
          type: string
        suggestedItems:
          description: A list of suggested items in the paginated collection.
          items:
            $ref: "#/components/schemas/TargetingItems"
          type: array
        total:
          description: 'The total number of items retrieved in the result set.<br /><br /><span class="tablenote"><b>Note: </b>If no items are found, this field is returned with a value of <code>0</code>.</span>'
          format: int32
          type: integer
      type: object
    TargetedBidRequest:
      description: A type that defines the targeted bid.
      properties:
        keywords:
          description: "A list of keywords in the paginated collection. <br /><br /><b>Maximum number of keywords: </b>500"
          items:
            $ref: "#/components/schemas/KeywordRequest"
          type: array
      type: object
    TargetedBidsPagedCollection:
      description: A type that defines the keywords of the paged collection.
      properties:
        suggestedBids:
          description: A list of bids in the paginated collection.
          items:
            $ref: "#/components/schemas/SuggestedBids"
          type: array
      type: object
    TargetedKeywordRequest:
      description: A type that provides details for the targeted keywords.
      properties:
        additionalInfo:
          description: A field used to indicate whether additional information and insight data shall be provided for suggested keywords.<br /><br /><strong>Valid Value:</strong> <code>KEYWORD_INSIGHTS</code>
          items:
            description: " For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:AdditionalInfoEnum'>eBay API documentation</a>"
            type: string
          type: array
        exclusions:
          description: A field used to indicate that the keywords already selected by sellers for the specified listing IDs should be filtered out of the response, and only new and unique keyword recommendations shall be returned.<br /><br /><strong>Valid Value:</strong> <code>ADOPTED_KEYWORDS</code>
          items:
            description: " For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:ExclusionsEnum'>eBay API documentation</a>"
            type: string
          type: array
        listingIds:
          description: "A set of comma-separated listing IDs in the paginated collection. <br /><br /><b>Maximum number of listings requested: </b>300"
          items:
            type: string
          type: array
        matchType:
          description: A field that defines the match type for the keyword.<br /><br /><b>Valid Values:</b><ul><li><code>BROAD</code></li><li><code>EXACT</code></li><li><code>PHRASE</code></li></ul> For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:MatchTypeEnum'>eBay API documentation</a>
          type: string
      type: object
    TargetedKeywordsPagedCollection:
      description: A type that defines the keywords of the paged collection.
      properties:
        suggestedKeywords:
          description: 'A list of suggested keywords in the paged collection. <p> <span class="tablenote"><strong>Note:</strong> A relevancy check with items already present in the ad-group is performed even if item IDs associated with the ad-group are not explicitly passed in the request.</span></p> '
          items:
            $ref: "#/components/schemas/SuggestedKeywords"
          type: array
      type: object
    TargetingItems:
      description: A type that defines the targeted items.
      properties:
        bases:
          description: The metrics and additional information for the items.
          items:
            $ref: "#/components/schemas/ItemBasis"
          type: array
        listingId:
          description: The listing ID of the targeted item.
          type: string
      type: object
    UpdateAdGroupRequest:
      description: A type that contains the fields used by the <b>UpdateAdGroup</b> request.
      properties:
        adGroupStatus:
          description: An enumeration value representing the current status of the ad group.<p>If the status of the ad is currently <code>ACTIVE</code>, you can change status to <code>PAUSED</code> or <code>ARCHIVED</code>. If ad group is currently in <code>PAUSED</code> status, you can change the status back to <code>ACTIVE</code>. Ads that are currently in <code>ARCHIVED</code> status cannot be made <code>ACTIVE</code> again.<br /><br /><b>Valid Values:</b><ul><li><code>ACTIVE</code></li><li><code>PAUSED</code></li><li><code>ARCHIVED</code></li></ul> For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:AdGroupStatusEnum'>eBay API documentation</a>
          type: string
        defaultBid:
          $ref: "#/components/schemas/Amount"
          description: A bid amount that applies to all of the keywords in an ad group that do not have individual bids.
        name:
          description: The updated name for the specified ad group.
          type: string
      type: object
    UpdateAdStatusByListingIdRequest:
      description: A type that contains the fields for the <b>UpdateAdStatusByListingId</b> request.
      properties:
        adGroupId:
          description: A unique eBay-assigned ID for an ad group in a campaign that uses the Cost Per Click (CPC) funding model.<br /><br /><span class="tablenote"><b>Note:</b> You can call the  <a href="/api-docs/sell/marketing/resources/adgroup/methods/getAdGroups">getAdGroups</a> method to retrieve the ad group IDs for a seller.</span>
          type: string
        adStatus:
          description: An enumeration value representing the current status of the ad.<br /><br /><b>Valid Values:</b><ul><li><code>ACTIVE</code></li><li><code>PAUSED</code></li><li><code>ARCHIVED</code></li></ul> For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:AdStatusEnum'>eBay API documentation</a>
          type: string
        listingId:
          description: A unique eBay-assigned ID for a listing that is generated when the listing is created.<br /><br /><span class="tablenote"><b>Note:</b> This field accepts both listing IDs (as generated by the Inventory API), and item IDs (as used in the eBay Traditional API set, such as the Trading and Finding APIs).</span>
          type: string
      type: object
    UpdateAdStatusRequest:
      description: A type that contains the fields for the <b>UpdateAdStatus</b> request.
      properties:
        adId:
          description: A unique eBay-assigned ID that is generated when the ad is created.
          type: string
        adStatus:
          description: An enumeration value representing the current status of the ad.<br /><br /><b>Valid Values:</b><ul><li><code>ACTIVE</code></li><li><code>PAUSED</code></li><li><code>ARCHIVED</code></li></ul> For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:AdStatusEnum'>eBay API documentation</a>
          type: string
      type: object
    UpdateAdrateStrategyRequest:
      description: A type that defines the request fields used to update the ad rate strategy for a Promoted Listings ad campaign.
      properties:
        adRateStrategy:
          description: The ad rate strategy that shall be applied to the campaign. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:AdRateStrategyEnum'>eBay API documentation</a>
          type: string
        bidPercentage:
          description: "The user-defined <b>bid percentage</b> (also known as the <i>ad rate</i>) sets the level that eBay increases the visibility in search results for the associated listing. The higher the <b>bidPercentage</b> value, the more eBay promotes the listing.  <br><br>The value specified here is also used to calculate the Promoted Listings fee. This percentage value is multiplied by the final sales price to determine the fee. <br><br>The Promoted Listings fee is determined at the time the transaction completes and the seller is assessed the fee only when an item sells through a Promoted Listings ad campaign. <br><br>The <b>bidPercentage</b> is a single precision value that is guided by the following rules: <ul><li>These values are <b>valid</b>:<br>&nbsp;&nbsp;&nbsp;<code>4.1</code>, &nbsp;&nbsp;&nbsp;<code>5.0</code>, &nbsp;&nbsp;&nbsp;<code>5.5</code>, ...</li>  <li>These values are <b>not valid</b>:<br /> &nbsp;&nbsp;&nbsp;<code>0.01</code>, &nbsp;&nbsp;&nbsp;<code>10.75</code>, &nbsp;&nbsp;&nbsp;<code>99.99</code>,<br /> &nbsp;&nbsp;&nbsp;and so on.</li></ul>This is the default bid percentage for the campaigns using the Cost Per Sale (CPS) funding model, and this value will be overridden by any ads in the campaign that have their own set bid percentages.<br /><br />If a bid percentage is not provided for an ad, eBay uses the default bid percentage of the associated campaign.<br /><br /><b>Minimum value:</b> 2.0 <br><b>Maximum value:</b> 100.0"
          type: string
        dynamicAdRatePreferences:
          description: A field that indicates whether a single, user-defined bid percentage (also known as the <i>ad rate</i>) should be used, or whether eBay should automatically adjust listings to maintain the daily suggested bid percentage.<br /><br /><span class="tablenote"><span style="color:#004680"><strong>Note:</strong></span> Dynamic adjustment is only applicable when the <b>adRateStrategy</b> is set to <code>DYNAMIC</code>.</span><br /><b>Default:</b> <code>FIXED</code>
          items:
            $ref: "#/components/schemas/DynamicAdRatePreference"
          type: array
      type: object
    UpdateAdsByInventoryReferenceResponse:
      description: A type that contains the response fields used by the <b>UpdateAdsByInventoryReference</b> method.
      properties:
        ads:
          description: A list of ad IDs and links to retrieve them.
          items:
            $ref: "#/components/schemas/AdReference"
          type: array
        errors:
          description: A container for all of the errors associated with the specified inventory reference ID.
          items:
            $ref: "#/components/schemas/Error"
          type: array
        inventoryReferenceId:
          description: The reference ID associated with the ad. The reference ID could be a SKU number or Inventory Item Group, depending on value of <code>inventoryReferenceType</code>.
          type: string
        inventoryReferenceType:
          description: The inventory reference type associated with the ad. The inventory reference type could be a SKU number or Inventory Item Group. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:InventoryReferenceTypeEnum'>eBay API documentation</a>
          type: string
        statusCode:
          description: An HTTP status code that indicates whether or not the CPS ad was successfully updated.
          format: int32
          type: integer
      type: object
    UpdateBidPercentageRequest:
      description: This type specifies the bid percentage for an ad campaign.
      properties:
        bidPercentage:
          description: "The user-defined <b>bid percentage</b> (also known as the <i>ad rate</i>) sets the level that eBay increases the visibility in search results for the associated listing. The higher the <b>bidPercentage</b> value, the more eBay promotes the listing.  <br><br>The value specified here is also used to calculate the Promoted Listings fee. This percentage value is multiplied by the final sales price to determine the fee. <br><br>The Promoted Listings fee is determined at the time the transaction completes and the seller is assessed the fee only when an item sells through a Promoted Listings ad campaign. <br><br>The <b>bidPercentage</b> is a single precision value that is guided by the following rules: <ul><li>These values are <b>valid</b>:<br>&nbsp;&nbsp;&nbsp;<code>4.1</code>, &nbsp;&nbsp;&nbsp;<code>5.0</code>, &nbsp;&nbsp;&nbsp;<code>5.5</code>, ...</li>  <li>These values are <b>not valid</b>:<br /> &nbsp;&nbsp;&nbsp;<code>0.01</code>, &nbsp;&nbsp;&nbsp;<code>10.75</code>, &nbsp;&nbsp;&nbsp;<code>99.99</code>,<br /> &nbsp;&nbsp;&nbsp;and so on.</li></ul>This is default bid percentage for the campaigns using the Cost Per Sale (CPS) funding model, and this value will be overridden by any ads in the campaign that have their own set bid percentages.<br /><br />If a bid percentage is not provided for an ad, eBay uses the default bid percentage of the associated campaign.<br /><br /><b>Minimum value:</b> 2.0 <br><b>Maximum value:</b> 100.0"
          type: string
      type: object
    UpdateCampaignBudgetRequest:
      description: A type that contains the fields for the <b>UpdateCampaignBudget</b> request.
      properties:
        daily:
          $ref: "#/components/schemas/BudgetRequest"
          description: The daily budget limit for the Cost Per Click (CPC) Promoted Listings campaign. This will be a dollar value. All clicks using the keywords defined for the campaign will go towards expending the daily budget. Once the daily budget is exceeded for the campaign, all Promoted Listings under the campaign will be turned off until the next day.<br /><br /><b>Valid Values</b>:<ul><li><code>50.00</code></li><li><code>100.00</code></li></ul>
      type: object
    UpdateCampaignIdentificationRequest:
      description: This type specifies the updated name, and start and end dates for an update-campaign request.
      properties:
        campaignName:
          description: "The new seller-defined name for the campaign. This value must be unique for the seller. <p>If you don't want to change the name of the campaign, specify the current campaign name in this field.<p>You can use any alphanumeric characters in the name, except the less than (&lt;) or greater than (&gt;) characters.</p><b>Max length: </b>80 characters."
          type: string
        endDate:
          description: The date and time the campaign ends, in UTC format (<code>yyyy-MM-ddThh:mm:ssZ</code>). If this field is omitted, the campaign will have no defined end date, and will not end until the seller makes a decision to end the campaign with an <a href="/api-docs/sell/marketing/resources/campaign/methods/endCampaign">endCampaign</a> call, or if they update the campaign at a later time with an end date.<p>If you want to change only the end date of the campaign, you must specify the current campaign name, set the <b>endDate</b> as desired, and set the <b>startDate</b> to the actual start date of the campaign. This applies if the campaign status is <code>RUNNING</code> or <code>PAUSED</code>. You can retrieve the <b>startDate</b> using the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaign#response.startDate">getCampaign</a> method.</p> <p>Note that if you do not set a new end date in this call, any current endDate value will be set to null. To preserve the currently-set end date, you must specify the value again in your request.</p>
          type: string
        startDate:
          description: The new start date for the campaign, in UTC format (<code>yyyy-MM-ddThh:mm:ssZ</code>).<p>If the campaign status is <code>RUNNING</code> or <code>PAUSED</code>, the <b>startDate</b> must be specified and must be the actual start date of the campaign, even if you are only changing the <b>endDate</b>. You can retrieve the campaign's <b>startDate</b> using the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaign#response.startDate">getCampaign</a> method.</p><p>On the date specified, the service derives the keywords for each listing in the campaign, creates an ad for each listing, and associates each new ad with the campaign. The campaign starts after this process is completed. The amount of time it takes the service to start the campaign depends on the number of listings in the campaign.</p>  <p>Call <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> to retrieve the <b>campaign_id</b> and the campaign status (<code>RUNNING</code>, <code>PAUSED</code>, <code>ENDED</code>, and so on) for all the seller's campaigns.</p>
          type: string
      type: object
    UpdateKeywordByKeywordIdRequest:
      description: A type that contains the fields for the <b>UpdateKeywordByKeywordId</b> request.
      properties:
        bid:
          $ref: "#/components/schemas/Amount"
          description: This container is used to set or change the bid percentage for the keyword. Each time a listing is retrieved in search results using this keyword and clicked on, the seller will be charged this amount. Each click goes toward the daily budget set up for the Cost Per Click (CPC) campaign.
        keywordId:
          description: This field is used to identify the keyword to be updated. The <a href="/api-docs/sell/marketing/resources/keyword/methods/getKeyword">getKeyword</a> method can be used to retrieve keywordId values.
          type: string
        keywordStatus:
          description: Include this field if you wish to change the status of the keyword. The status value specified here must be different than the keyword's current status. To confirm the current status of a keyword, you can use the <a href="/api-docs/sell/marketing/resources/keyword/methods/getKeyword">getKeyword</a> method.</p><p>If the status of the ad is currently <code>ACTIVE</code>, you can change status to <code>PAUSED</code> or <code>ARCHIVED</code>. If ad group is currently in <code>PAUSED</code> status, you can change the status back to <code>ACTIVE</code>. Ads that are currently in <code>ARCHIVED</code> status cannot be made <code>ACTIVE</code> again. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:KeywordStatusEnum'>eBay API documentation</a>
          type: string
      type: object
    UpdateKeywordRequest:
      description: A type that contains the fields for the <b>UpdateKeyword</b> request.
      properties:
        bid:
          $ref: "#/components/schemas/Amount"
          description: This container is used to set or change the bid for the keyword. Each time a listing is retrieved in search results using this keyword and clicked on, the seller will be charged this amount. Each click goes toward the daily budget set up for the CPC campaign. If the bid is not provided, then the default bid associated with the ad group is used.
        keywordStatus:
          description: Include this field if you wish to change the status of the keyword. The status value specified here must be different than the keyword's current status. To confirm the current status of a keyword, you can use the <a href="/api-docs/sell/marketing/resources/keyword/methods/getKeyword">getKeyword</a> method.</p><p>If the status of the ad is currently <code>ACTIVE</code>, you can change status to <code>PAUSED</code> or <code>ARCHIVED</code>. If ad group is currently in <code>PAUSED</code> status, you can change the status back to <code>ACTIVE</code>. Ads that are currently in <code>ARCHIVED</code> status cannot be made <code>ACTIVE</code> again. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:KeywordStatusEnum'>eBay API documentation</a>
          type: string
      type: object
    UpdateKeywordResponse:
      description: A type that contains the fields for the <b>UpdateKeyword</b> response.
      properties:
        errors:
          description: This container will be returned if there are one or more issues associated with modifying the corresponding keyword.
          items:
            $ref: "#/components/schemas/Error"
          type: array
        keywordId:
          description: This field identifies the keyword that the seller updated, or attempted to update.
          type: string
        statusCode:
          description: An HTTP status code is returned for each keyword to indicate the success or failure of updating that keyword.
          format: int32
          type: integer
      type: object
    UpdateNegativeKeywordIdRequest:
      description: A type that defines the fields used to update a negative keyword.
      properties:
        negativeKeywordId:
          description: A unique eBay-assigned ID for a negative keyword. This keyword ID will be generated for each successfully created negative keyword.
          type: string
        negativeKeywordStatus:
          description: A field that defines the status of the negative keyword. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:NegativeKeywordStatusEnum'>eBay API documentation</a>
          type: string
      type: object
    UpdateNegativeKeywordRequest:
      description: A type that contains the fields for the <b>UpdateNegativeKeyword</b> request.
      properties:
        negativeKeywordStatus:
          description: A field that defines the status of the negative keyword. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:NegativeKeywordStatusEnum'>eBay API documentation</a>
          type: string
      type: object
    UpdateNegativeKeywordResponse:
      description: A type that contains the fields for the <b>UpdateNegativeKeyword</b> response.
      properties:
        errors:
          description: A container that will be returned if there are one or more issues associated with modifying the corresponding negative keyword.
          items:
            $ref: "#/components/schemas/Error"
          type: array
        negativeKeywordId:
          description: A unique eBay-assigned ID for a negative keyword. This keyword ID will be generated for each successfully created negative keyword.
          type: string
        statusCode:
          description: An HTTP status code that indicates the success or failure of updating that negative keyword.
          format: int32
          type: integer
      type: object
  securitySchemes:
    api_auth:
      description: The security definitions for this API. Please check individual operations for applicable scopes.
      flows:
        authorizationCode:
          authorizationUrl: https://auth.ebay.com/oauth2/authorize
          scopes:
            https://api.ebay.com/oauth/api_scope/sell.marketing: View and manage your eBay marketing activities, such as ad campaigns and listing promotions
            https://api.ebay.com/oauth/api_scope/sell.marketing.readonly: View your eBay marketing activities, such as ad campaigns and listing promotions
          tokenUrl: https://api.ebay.com/identity/v1/oauth2/token
        clientCredentials:
          scopes:
            https://api.ebay.com/oauth/api_scope: View public data from eBay
          tokenUrl: https://api.ebay.com/identity/v1/oauth2/token
      type: oauth2
