Information about the schema location is in the Schema Location section of the Making an API Call topic.
Are you just getting started with the Shopping API? The following describes how to join the eBay Developers Program:
|
|
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
These release notes go back four quarters. For older release notes, see the
Release Notes archive.
*Release 647
was delayed until the beginning of January in 2010, instead of being released
at the beginning of December, 2009.
Documentation Changes and Errata - 685
For a current list of known issues, see System Announcements and the Knowledge Base.
These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.
No new calls in this release.
No changed calls in this release.
None for this release.
See the System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.
This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 685.
None for this release.
This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.
None for this release.
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 685 and Changed Functionality - 685.
None for this release.
Documentation Changes and Errata - 681
For a current list of known issues, see System Announcements and the Knowledge Base.
These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.
No new calls in this release.
No changed calls in this release.
None for this release.
See the System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.
This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 681.
None for this release.
This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.
None for this release.
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 681 and Changed Functionality - 681.
None for this release.
Documentation Changes and Errata - 679
For a current list of known issues, see System Announcements and the Knowledge Base.
These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.
No changed calls in this release.
| Name | Part of Schema | Type of Change |
|---|---|---|
QuantityAvailableHintCodeType |
Enumerated type | New |
SimpleItemType.QuantityAvailableHint |
Element | New |
SimpleItemType.QuantityThreshold |
Element | New |
See the System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.
This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 679.
For versions beginning with 679, you can now conceal the available quantity of fixed price listings using a new element, SimpleItemType.QuantityThreshold.
For Daily Deal and flash sales, the tag QuantityAvailableHint with the value "Limited" will be returned by GetSingleItem and GetMultipleItems.
For other multiple-item listings, you can set a QuantityThreshold of 10. When this is set, GetSingleItem and GetMultipleItems will return the tag QuantityAvailableHint with a value of "MoreThan" and the tag QuantityThreshold with the value of the quantity threshold, as long as the actual quantity of available items is greater than the threshold. Currently, 10 is the only available value for QuantityThreshold.
This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.
None for this release.
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 679 and Changed Functionality - 679.
Added two new call samples to the GetCategoryInfo call, including one sample that instructs users how to build a partial or complete local category hierarchy, and another sample that instruct users how to construct a call when only the category version and the date of the last update is sought.
Documentation Changes and Errata - 677
For a current list of known issues, see System Announcements and the Knowledge Base.
These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.
No new calls in this release.
No changed calls in this release.
None for this release.
See the System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.
This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 677.
None for this release.
This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.
None for this release.
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 677 and Changed Functionality - 677.
None for this release.
Documentation Changes and Errata - 675
For a current list of known issues, see System Announcements and the Knowledge Base.
These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.
No new calls in this release.
No changed calls in this release.
None for this release.
See the System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.
This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 675.
None for this release.
This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.
None for this release.
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 675 and Changed Functionality - 675.
None for this release.
Documentation Changes and Errata - 673
For a current list of known issues, see System Announcements and the Knowledge Base.
These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.
No new calls in this release.
No changed calls in this release.
None for this release.
See the System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.
This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 673.
None for this release.
This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.
None for this release.
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 673 and Changed Functionality - 673.
None for this release.
No 671 schema was released.
No new calls in this release.
No changed calls in this release.
Documentation Changes and Errata - 669
For a current list of known issues, see System Announcements and the Knowledge Base.
These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.
No new calls in this release.
No changed calls in this release.
None for this release.
See the System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.
This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 669.
None for this release.
This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.
None for this release.
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 669 and Changed Functionality - 669.
None for this release.
Documentation Changes and Errata - 667
For a current list of known issues, see System Announcements and the Knowledge Base.
These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.
No new calls in this release.
No changed calls in this release.
None for this release.
See the System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.
This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 667.
None for this release.
This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.
None for this release.
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 667 and Changed Functionality - 667.
None for this release.
Documentation Changes and Errata - 665
For a current list of known issues, see System Announcements and the Knowledge Base.
These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.
No new calls in this release.
Schema changes in pink (for example, SomeType.Somedata) are for future use. Monitor upcoming release notes for descriptions of their purpose and use.
Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.
| Name | Part of Schema | Type of Change |
|---|---|---|
ShippingDetailsType.ExcludeShipToLocation |
Element | New |
See the System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.
This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 665.
None for this release.
This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.
| Summary of change | Request version lower than 665 | Request version of 665 or higher |
|---|---|---|
| A. For multi-quantity listings, ShippingServiceCost now reflects the total cost of all items. | (out)ShippingServiceCost matches (in)ShippingServiceCost.
ShippingServiceAdditionalCost is required. |
(out)ShippingServiceCost is a total cost ((in)ShippingServiceCost + (additional quantity * (in)ShippingServiceAdditionalCost) + miscellaneous costs).
ShippingServiceAdditionalCost is optional. If not provided, it is set to (in)ShippingServiceCost. |
| Example: The seller of a multi-quantity listing has specified ShippingServiceCost = $11 and ShippingServiceAdditionalCost = $2 for each additional item. A buyer buys five items. | Example: The seller of a multi-quantity listing has specified ShippingServiceCost = $11 and ShippingServiceAdditionalCost = $2 for each additional item. A buyer buys five items. | |
| (out)ShippingServiceCost is $11. | (out)ShippingServiceCost is $19 (that is, $11 + (4 * $2)) | |
| B. Promotional shipping savings is reflected in the total shipping cost. | Promotional shipping is not considered, period. |
If promotional shipping could apply to this listing:
|
| C. Shipping services are filtered for the buyer, as needed. | The shipping services offered by the seller were presented to the buyer even if such services were not available to the buyer in the buyer's region. In the event that no services remain, ShippingCostSummary is returned empty. No warning is returned. | The shipping services are filtered before being returned to the buyer so that the buyer is not presented with shipping services not applicable to the buyer's region. In the event that no services remain, ShippingCostSummary is returned empty and a warning is returned. |
| D. The total shipping cost now includes any surcharge, and surcharge is no longer returned as an individual tag. | The total shipping cost does not include surcharge. If there is a surcharge, it is returned in its own tag. | The total shipping cost includes surcharge. Surcharge is not returned as its own tag. |
| E. The following are now returned:
|
Not returned. | Returned. |
| F. Since GetSingleItem and GetMultipleItems can only calculate shipping costs if postal code is known (and since postal code is not one of the inputs for these calls), a warning is returned if postal code is not known. | Not returned. | Returned. |
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 665 and Changed Functionality - 665.
None for this release.
Documentation Changes and Errata - 663
For a current list of known issues, see System Announcements and the Knowledge Base.
These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.
No new calls in this release.
No changed calls in this release.
Schema changes in pink (for example, SomeType.Somedata) are for future use. Monitor upcoming release notes for descriptions of their purpose and use.
Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.
No schema changes in this release.
See the System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.
This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 663.
None for this release.
This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.
Beginning with the 663 release, all versions of these calls will return Item.Seller.TopRatedSeller when the seller is a top-rated seller and when the IncludeSelector value in the request is Details.
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 663 and Changed Functionality - 663.
None for this release.
Documentation Changes and Errata - 661
For a current list of known issues, see System Announcements and the Knowledge Base.
These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.
No new calls in this release.
None for this release.
See the System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.
This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 661.
We are releasing a new way of specifying Item Condition with the API. Previously items showed the condition in ItemSpecifics. Now GetSingleItem and GetMultipleItems can return ConditionID and a human-readable label in ConditionDisplayName instead for many categories.
All categories and sites use consistent IDs for each condition, although the list of conditions that are supported can vary for each category and site. For example, 1000 is always used for brand new items in their original retail packaging (or equivalent).
Here is an example of the new fields in GetSingleItem:
<Item> <Title>Apple MacBook Pro MB990LL/A 13.3 in. Notebook NEW</Title> <PrimaryCategoryID>111422</PrimaryCategoryID> <ConditionID>1000</ConditionID> <ConditionDisplayName>New</ConditionDisplayName>
Please note the following timing:
This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.
None for this release.
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 661 and Changed Functionality - 661.
None for this release.
Documentation Changes and Errata - 659
For a current list of known issues, see System Announcements and the Knowledge Base.
These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.
No new calls in this release.
No changed calls in this release.
None for this release.
See the System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.
This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 659.
None for this release.
This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.
None for this release.
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 659 and Changed Functionality - 659.
None for this release.
Documentation Changes and Errata - 657
For a current list of known issues, see System Announcements and the Knowledge Base.
These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.
No new calls in this release.
No changed calls in this release.
Schema changes in pink (for example, SomeType.Somedata) are for future use. Monitor upcoming release notes for descriptions of their purpose and use.
Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.
No schema changes in this release.
See the System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.
This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 657.
None for this release.
This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.
None for this release.
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 657 and Changed Functionality - 657.
None for this release.
Documentation Changes and Errata - 655
For a current list of known issues, see System Announcements and the Knowledge Base.
These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.
No changed calls in this release.
Schema changes in pink (for example, SomeType.Somedata) are for future use. Monitor upcoming release notes for descriptions of their purpose and use.
Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.
| Name | Part of Schema | Type of Change |
|---|---|---|
SimpleItemType.ConditionDisplayName |
Element | New. Reserved for future use. |
SimpleItemType.ConditionID |
Element | New. Reserved for future use. |
See the System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.
This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 655.
None for this release.
This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.
None for this release.
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 655 and Changed Functionality - 655.
None for this release.
Documentation Changes and Errata - 653
For a current list of known issues, see System Announcements and the Knowledge Base.
These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.
No new calls in this release.
No changed calls in this release.
Schema changes in pink (for example, SomeType.Somedata) are for future use. Monitor upcoming release notes for descriptions of their purpose and use.
Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.
No schema changes in this release.
See the System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.
This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 653.
None for this release.
This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.
None for this release.
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 653 and Changed Functionality - 653.
None for this release.
No 651 schema was released.
No new calls in this release.
No changed calls in this release.
No 649 schema was released.
No new calls in this release.
No changed calls in this release.
Documentation Changes and Errata - 647
For a current list of known issues, see System Announcements and the Knowledge Base.
These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.
No new calls in this release.
No changed calls in this release.
Schema changes in pink (for example, SomeType.Somedata) are for future use. Monitor upcoming release notes for descriptions of their purpose and use.
Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.
No schema changes in this release.
See the System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.
This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 647.
None for this release.
This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.
None for this release.
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 647 and Changed Functionality - 647.
None for this release.
No 645 schema was released.
No new calls in this release.
No changed calls in this release.
Documentation Changes and Errata - 643
For a current list of known issues, see System Announcements and the Knowledge Base.
These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.
No new calls in this release.
No changed calls in this release.
Schema changes in pink (for example, SomeType.Somedata) are for future use. Monitor upcoming release notes for descriptions of their purpose and use.
Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.
No schema changes in this release.
See the System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.
This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 643.
None for this release.
This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.
None for this release.
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 643 and Changed Functionality - 643.
None for this release.
No 641 schema was released.
No new calls in this release.
No changed calls in this release.
Documentation Changes and Errata - 639
For a current list of known issues, see System Announcements and the Knowledge Base.
These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.
No new calls in this release.
No changed calls in this release.
None for this release.
See the System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.
This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 639.
None for this release.
This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.
None for this release.
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 639 and Changed Functionality - 639.
None for this release.
This documentation and the API may only be used in accordance with the eBay Developers Program and API License Agreement.
© 2007–2010 eBay Inc. All rights reserved.
eBay and the eBay logo are registered trademarks of eBay Inc.
All other brands are the property of their respective owners.
