NAME
eBay::API::XML::Call::GetProducts::GetProductsRequestType
DESCRIPTION
Searches for stock information and reviews for certain kinds of products, such as a particular digital camera model. <p> GetProducts is designed to be useful to applications that support shopping comparison, product reviews, or basic supply and demand data. </p> <p> GetProducts also supports tracking so that members of the eBay Affiliates Program can get commissions for driving traffic to eBay. </p> <p class="tablenote"><b>Note:</b> For selling use cases, use GetProductSearchResults and GetProductSellingPages instead. </p> <p> To use this call, you typically pass in keywords, and GetProducts finds products with matching words in the product title, description, and/or Item Specifics. <p> For each product of interest, you call GetProducts again to retrieve additional details that would be useful to buyers: </p> <ul> <li>Top reviews of the product by eBay members, including part of the review text, plus links to the full text on the eBay Web site.</li> <li>Relevant buying guides (shopping advice) written by eBay members and by eBay staff, including part of the guide text, plus links to the full text on the eBay Web site.</li> <li>Up to 200 matching items on eBay (if any). (To find more matching items, use GetSearchResults.)</li> </ul> <p> <span class="tablenote"><b>Note:</b> As catalog queries can take longer than item queries, GetProducts can be slower than GetSearchResults. Also, due to the way product data is cached, you may get a faster response when you run the same query a second time.</span>
SYNOPSIS
INHERITANCE
eBay::API::XML::Call::GetProducts::GetProductsRequestType inherits from the eBay::API::XML::RequestDataType class
Subroutines:
setAffiliateTrackingDetails()
See the <a href="https://www.ebaypartnernetwork.com/" target="_blank">eBay Partner Network</a>. eBay uses the specified details to build a View Item URL string in the response that includes your affiliate tracking information in the correct format. When a user clicks through the URL to eBay and performs certain tasks, you may get a commission (see the URL above). Only applicable when IncludeItemArray is specified (because the View Item URL is only returned in item information, not in product information).
SeeLink: URL: http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=AffiliateTrackingConcepts Title: Affiliate Tracking Concepts
RequiredInput: No
# Argument: 'ns:AffiliateTrackingDetailsType'getAffiliateTrackingDetails()
# Returns: 'ns:AffiliateTrackingDetailsType'
setIncludeBuyingGuideDetails()
If true, the response includes up to 5 buying guides (if any) for the product specified in ExternalProductID or ProductReferenceID. Not applicable with QueryKeywords.
RequiredInput: No
Default: false
# Argument: 'xs:boolean'isIncludeBuyingGuideDetails()
# Returns: 'xs:boolean'
setIncludeHistogram()
If true, the response includes a histogram that lists the number of matching products found and the domains in which they were found. (A domain is like a high-level category.) Including the histogram can affect the call's performance. You may see significantly slower response times when many matching products are found.
RequiredInput: No
Default: false
# Argument: 'xs:boolean'isIncludeHistogram()
# Returns: 'xs:boolean'
setIncludeItemArray()
If true, the response includes items (if any) that match the product specified in ExternalProductID or ProductReferenceID. Not applicable with QueryKeywords.
RequiredInput: No
Default: false
# Argument: 'xs:boolean'isIncludeItemArray()
# Returns: 'xs:boolean'
setIncludeReviewDetails()
If true, the response includes up to 20 reviews (if any) for the product specified in ExternalProductID or ProductReferenceID. The reviews are sorted by most helpful (most votes) first. When you include review details, please note that response times may be longer than 60 seconds. Not applicable with QueryKeywords.
RequiredInput: No
Default: false
# Argument: 'xs:boolean'isIncludeReviewDetails()
# Returns: 'xs:boolean'
setProductSearch()
Contains the fields that form the search query. You can query against keywords, an eBay product reference ID (not to be confused with an eBay product ID), or external product ID (like an ISBN).
RequiredInput: Yes
# Argument: 'ns:ProductSearchType'getProductSearch()
# Returns: 'ns:ProductSearchType'
setProductSort()
Sorts the list of products returned. This is mostly only useful with QueryKeywords. (When you use ExternalProductID or ProductReferenceID, eBay usually only returns one product.)
RequiredInput: No
# Argument: 'ns:ProductSortCodeType'getProductSort()
# Returns: 'ns:ProductSortCodeType'