NAME
eBay::API::XML::Call::GetCategories
DESCRIPTION
SYNOPSIS
Methods
setCategoryParent()
Specifies the ID of the highest-level category to return, along with its subcategories. If no parent category is specified, all categories are returned for the specified site. (Please do not pass a value of 0; zero (0) is an invalid value for CategoryParent.) To determine available category IDs, call GetCategories with no filters and use a DetailLevel value of ReturnAll. If you specify multiple parent categories, the hierarchy for each one is returned.
RequiredInput: No
Default:
# Argument: reference to an array
of 'xs:string'setCategorySiteID()
Specifies the eBay site for which to retrieve the category hierarchy. Use the numeric site code (e.g., 77 for eBay Germany). Only necessary if you want to retrieve category data for a site other than the site to which you are submitting the request.
RequiredInput: No
Default: The site ID of the request
# Argument: 'xs:string'setLevelLimit()
Specifies the maximum depth of the category hierarchy to retrieve, where the top-level categories (meta-categories) are at level 1. Retrieves all category nodes with a category level less than or equal to this value. If not specified, retrieves categories at all applicable levels. As with all calls, the actual data returned will vary depending on how you configure other fields in the request (including DetailLevel).
RequiredInput: No
Default: 0
# Argument: 'xs:int'setViewAllNodes()
If false or omitted, retrieves only leaf categories. (You can only list in leaf categories.) If true, retrieves both leaf and internal (non-leaf) categories. As with all calls, the actual data returned will vary depending on how you configure other fields in the request.
RequiredInput: No
Default: false
# Argument: 'xs:boolean'getCategoryArray()
List of the returned categories. The category array contains one CategoryType object for each returned category. Returns empty if no detail level is specified.
Returned: Always
Details: DetailLevel: ReturnAll
# Returns: 'ns:CategoryArrayType'getCategoryCount()
Indicates the number of categories returned (i.e., the number of CategoryType objects in CategoryArray).
Returned: Always
Details: DetailLevel: ReturnAll
# Returns: 'xs:int'getCategoryVersion()
Indicates the version of the category hierarchy on the specified eBay site.
Returned: Always
Details: DetailLevel: ReturnAll, none
# Returns: 'xs:string'getMinimumReservePrice()
Indicates the lowest possible reserve price allowed for any item listed in any category on the site. You can use the fields returned by GetCategoryFeatures to determine if a different Minimum Reserve Price is defined for the category you want to use.
Returned: Always
Details: DetailLevel: ReturnAll, none
# Returns: 'xs:double'isReduceReserveAllowed()
If true, ReduceReserveAllowed indicates that all categories on the site allow the seller to reduce an item's reserve price. If false, this field is not returned in the response and all categories on the site do not normally allow sellers to reduce an item's reserve price. The Category.ORRA (override reduce reserve price) field can override (or toggle) the reserve price reduction setting for a given category. For example, if ReduceReserveAllowed is false and Category.ORRA is true, the category overrides the site setting and supports reducing reserve prices. If ReduceReserveAllowed is true and Category.ORRA is true, the category overrides the site setting and does does not support reducing reserve prices.
Returned: Always
Details: DetailLevel: ReturnAll, none
# Returns: 'xs:boolean'isReservePriceAllowed()
If true, ReservePriceAllowed indicates that all categories on the site allow the seller to specify a reserve price for an item. If false, this field is not returned in the response and all categories on the site do not normally allow sellers to specify reserve prices. The Category.ORPA (override reserve price allowed) field can override (or toggle) the reserve price allowed setting for a given category. For example, if ReservePriceAllowed is false and Category.ORPA is true, the category overrides the site setting and supports reserve prices. If ReservePriceAllowed is true and Category.ORPA is true, the category overrides the site setting and does does not support reserve prices.
Returned: Always
Details: DetailLevel: ReturnAll, none
# Returns: 'xs:boolean'getUpdateTime()
Indicates the last date and time that eBay modified the category hierarchy for the specified eBay site.
Returned: Always
Details: DetailLevel: ReturnAll, none
# Returns: 'xs:dateTime'SEE ALSO
JOIN US
Please visit http://developer.ebay.com for more eBay API information.
Web: http://developer.ebay.com
Community Forums: http://developer.ebay.com/community/forums/