Marketing API release notes
Just getting started with the Marketing API? See the following documents for details on using this API:
- Using eBay RESTful APIs
- Marketing section of the Selling Integration Guide
- Marketing API overview
- Marketing API Reference
The API release history
The following table lists the releases for the Marketing API:
Summary of Release
Added seven new calls that support the new reporting feature for Promoted Listings.
Added a new call that returns the listings in a Promotion.
Added a container to support creating Promotions using a set of rules.
|Initial release of Version 1.|
The following new calls have been added to the Marketing API for Promoted Listings.
|Get Specific Report ||Downloads the specified report.|
|Get Metadata For All Reports ||Retrieves the metadata for all reports.|
|Get Metadata For a Report Type ||Retrieves the metadata for a specific report.|
|Create Report Task
||Creates a report task. A report task contains the definition of a report and is what generates the report based on that definition. You retrieve a report task using the Get Specific Report Task or the Get Report Tasks calls.|
|Delete Specific Report Task
||Deletes the specified report task.|
|Get Report Tasks ||Retrieves the report tasks based on filters.|
|Get Specific Report Task
||Retrieves the criteria, such as dimensions, metrics, listing, etc., and the generation rules, such as starting and ending date, for the specified report task.|
The following sections detail the updates that have been made for this release.
There was one new call added.
Get Listings in Specific Promotion -
This call returns a paged collection of the listings associated with the specified promotion.
The following sections detail any changes to the schema.
Added new inventoryCriterion.ruleCriteria container
The inventoryCriterion.ruleCriteria container was added to the Create Item Promotion, Get Item Promotion, and Update Item Promotion calls. This enables sellers to select the listings for a promotion by setting rules, such as a list eBay or seller's Store category Ids, constrained by min and max price, brand, or condition. You can explicitly exclude up to 100 eBay listing Ids or seller inventory reference Ids (also known as SKU or custom label). A promotion can have multiple rules.
More examples were added to the Promotion Code Examples document and it was retitled to Specifying Discounts. Note the filename and location were not changed.
This is the initial release of the Marketing API, Version 1.
For a list of the new calls, see the Marketing API Reference.