=head1 NAME

eBay::API::XML::Call::GetCategories::GetCategoriesRequestType

=head1 DESCRIPTION

Retrieves the latest category hierarchy available on a given site.
(By default, this is the site to which you submit the request.)
You can retrieve all categories on the site, or you can use
CategoryParent to retrieve one particular category and its
subcategories.<br>
<br>
For each category, the call returns the category name, its unique ID
(within the site to which you sent the request), and meta-data that
helps you determine where the category fits in the hierarchy.
eBay requires sellers to specify a category ID for most new listings.
You can only list in leaf categories.<br>
<br>
The call also identifies a few eBay features that are only supported
in some categories. For example, some categories support
immediate payment (AutoPay), and some categories don't.
For information about additional features that vary by category,
use GetCategoryFeatures and/or GetCategory2CS.<br>
<br>
The API provides other calls that supplement GetCategories.
For example, consider using GetSuggestedCategories to help the seller
choose a category ID. In certain cases, it may be helpful to
use GetCategoryMappings to update locally stored item data
(although most applications can use the simpler
CategoryMappingAllowed flag in AddItem for this purpose).



=head1 SYNOPSIS


=cut

=head1 Methods


=cut

=head2 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'


=cut

=head2 getCategoryParent()

#    Returns: reference to an array  
                      of 'xs:string'


=cut

=head2 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'


=cut

=head2 getCategorySiteID()

#    Returns: 'xs:string'


=cut

=head2 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'


=cut

=head2 getLevelLimit()

#    Returns: 'xs:int'


=cut

=head2 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'


=cut

=head2 isViewAllNodes()

#    Returns: 'xs:boolean'


=cut

=head1 SEE ALSO

L<eBay::API>

=head1 JOIN US

Please visit http://developer.ebay.com for more eBay API information. 

Web:
L<http://developer.ebay.com>

Community Forums:
L<http://developer.ebay.com/community/forums/>

=cut

