Finding_FindItemsByImageRequest Class Reference
| Inherits from | Finding_BestMatchFindingServiceRequest : Finding_BaseServiceRequest : NSObject |
| Declared in | Finding_FindItemsByImageRequest.h Finding_FindItemsByImageRequest.m |
Overview
Find items based on the image similarity to the specified item.
@ingroup FindingServicePortType
Tasks
-
itemIdSpecifies the item that the customer wants to use for retrieving
property
more listings with similar images. The item must active and it must
be listed in a Clothing, Shoes & Accessories category (parent
category ID 11450 on the eBay US site). In addition, the item ID you
specify must exist on either the US, UK, or DE the sites. -
categoryIdSpecifies the leaf category from which you want to retrieve item
property
listings with similar images. If no category is specified, search
results can come from any Clothing, Shoes & Accessories leaf
category. This field can be repeated (up to 3 times) to include
multiple categories.
Image similarity searches are only supported in Clothing, Shoes &
Accessories leaf categories on the eBay US, UK, and Germany sites.
If a specified category ID doesn’t match an existing category for the
site, eBay returns an invalid-category error message. To determine
valid leaf categories, use the Shopping API <b
class=“con”>GetCategoryInfo call. -
itemFilterReduce the number of items returned by a find request using item
property
filters. Use itemFilter to specify
name/value pairs. You can include multiple item filters in a single
request. -
aspectFilterAspect filters refine (limit) the number of items returned by a find
property
request. Obtain input values for aspectFilter fields from an
aspectHistogramContainer returned in the response of a previous
query.
By issuing a series of find queries, you can continually refine the
items returned in your responses. Do this by repeating a query using
the aspect values returned in one response as the input values to
your next query.
For example, the aspectHistogramContainer in a response on Men's
Shoes could contain an aspect of Size, along with “aspect values” for
the different sizes currently available in Men’s Shoes. By populating
aspectFilter fields with the values returned in an
aspectHistogramContainer, you can refine the item results returned by
your new query.
Note: If a call that specifies an
outputSelector value of
AspectHistogram returns
aspectHistogramContainer.domainName, this is a sign
that aspect histogram data might not be returned if you also specify an
aspectFilter in the next call. To ensure that
aspect histogram data is returned for the next call, add a
domainFilter to the call as well.
-
domainFilterRestricts results to items listed within the specified domain.
property
Domains are a buy-side grouping of items. such as shoes or digital
cameras. A domain can span multiple eBay categories. -
outputSelectorDefines what data to return, in addition to the default set of data,
property
in a response.
If you don’t specify this field, eBay returns a default set of item
fields. Use outputSelector to include more information in the
response. The additional data is grouped into discrete nodes. You can
specify multiple nodes by including this field multiple times, as
needed, in the request.
If you specify this field, the additional fields returned can affect
the call’s response time (performance), including in the case with
feedback data.
Properties
aspectFilter
Aspect filters refine (limit) the number of items returned by a find
request. Obtain input values for aspectFilter fields from an
aspectHistogramContainer returned in the response of a previous
query.
By issuing a series of find queries, you can continually refine the
items returned in your responses. Do this by repeating a query using
the aspect values returned in one response as the input values to
your next query.
For example, the aspectHistogramContainer in a response on Men's
Shoes could contain an aspect of Size, along with “aspect values” for
the different sizes currently available in Men’s Shoes. By populating
aspectFilter fields with the values returned in an
aspectHistogramContainer, you can refine the item results returned by
your new query.
Note: If a call that specifies an
outputSelector value of
AspectHistogram returns
aspectHistogramContainer.domainName, this is a sign
that aspect histogram data might not be returned if you also specify an
aspectFilter in the next call. To ensure that
aspect histogram data is returned for the next call, add a
domainFilter to the call as well.
@property (nonatomic, retain) NSMutableArray *aspectFilterDiscussion
Aspect filters refine (limit) the number of items returned by a find
request. Obtain input values for aspectFilter fields from an
aspectHistogramContainer returned in the response of a previous
query.
By issuing a series of find queries, you can continually refine the
items returned in your responses. Do this by repeating a query using
the aspect values returned in one response as the input values to
your next query.
For example, the aspectHistogramContainer in a response on Men's
Shoes could contain an aspect of Size, along with “aspect values” for
the different sizes currently available in Men’s Shoes. By populating
aspectFilter fields with the values returned in an
aspectHistogramContainer, you can refine the item results returned by
your new query.
Note: If a call that specifies an
outputSelector value of
AspectHistogram returns
aspectHistogramContainer.domainName, this is a sign
that aspect histogram data might not be returned if you also specify an
aspectFilter in the next call. To ensure that
aspect histogram data is returned for the next call, add a
domainFilter to the call as well.
entry type : class Finding_AspectFilter
Declared In
Finding_FindItemsByImageRequest.hcategoryId
Specifies the leaf category from which you want to retrieve item
listings with similar images. If no category is specified, search
results can come from any Clothing, Shoes & Accessories leaf
category. This field can be repeated (up to 3 times) to include
multiple categories.
Image similarity searches are only supported in Clothing, Shoes &
Accessories leaf categories on the eBay US, UK, and Germany sites.
If a specified category ID doesn’t match an existing category for the
site, eBay returns an invalid-category error message. To determine
valid leaf categories, use the Shopping API <b
class=“con”>GetCategoryInfo call.
@property (nonatomic, retain) NSMutableArray *categoryIdDiscussion
Specifies the leaf category from which you want to retrieve item
listings with similar images. If no category is specified, search
results can come from any Clothing, Shoes & Accessories leaf
category. This field can be repeated (up to 3 times) to include
multiple categories.
Image similarity searches are only supported in Clothing, Shoes &
Accessories leaf categories on the eBay US, UK, and Germany sites.
If a specified category ID doesn’t match an existing category for the
site, eBay returns an invalid-category error message. To determine
valid leaf categories, use the Shopping API <b
class=“con”>GetCategoryInfo call.
entry type : NSString, wrapper for primitive string
Declared In
Finding_FindItemsByImageRequest.hdomainFilter
Restricts results to items listed within the specified domain.
Domains are a buy-side grouping of items. such as shoes or digital
cameras. A domain can span multiple eBay categories.
@property (nonatomic, retain) NSMutableArray *domainFilterDiscussion
Restricts results to items listed within the specified domain.
Domains are a buy-side grouping of items. such as shoes or digital
cameras. A domain can span multiple eBay categories.
entry type : class Finding_DomainFilter
Declared In
Finding_FindItemsByImageRequest.hitemFilter
Reduce the number of items returned by a find request using item
filters. Use itemFilter to specify
name/value pairs. You can include multiple item filters in a single
request.
@property (nonatomic, retain) NSMutableArray *itemFilterDiscussion
Reduce the number of items returned by a find request using item
filters. Use itemFilter to specify
name/value pairs. You can include multiple item filters in a single
request.
entry type : class Finding_ItemFilter
Declared In
Finding_FindItemsByImageRequest.hitemId
Specifies the item that the customer wants to use for retrieving
more listings with similar images. The item must active and it must
be listed in a Clothing, Shoes & Accessories category (parent
category ID 11450 on the eBay US site). In addition, the item ID you
specify must exist on either the US, UK, or DE the sites.
@property (nonatomic, retain) NSString *itemIdDiscussion
Specifies the item that the customer wants to use for retrieving
more listings with similar images. The item must active and it must
be listed in a Clothing, Shoes & Accessories category (parent
category ID 11450 on the eBay US site). In addition, the item ID you
specify must exist on either the US, UK, or DE the sites.
type : NSString, wrapper for primitive string
Declared In
Finding_FindItemsByImageRequest.houtputSelector
Defines what data to return, in addition to the default set of data,
in a response.
If you don’t specify this field, eBay returns a default set of item
fields. Use outputSelector to include more information in the
response. The additional data is grouped into discrete nodes. You can
specify multiple nodes by including this field multiple times, as
needed, in the request.
If you specify this field, the additional fields returned can affect
the call’s response time (performance), including in the case with
feedback data.
@property (nonatomic, retain) NSMutableArray *outputSelectorDiscussion
Defines what data to return, in addition to the default set of data,
in a response.
If you don’t specify this field, eBay returns a default set of item
fields. Use outputSelector to include more information in the
response. The additional data is grouped into discrete nodes. You can
specify multiple nodes by including this field multiple times, as
needed, in the request.
If you specify this field, the additional fields returned can affect
the call’s response time (performance), including in the case with
feedback data.
entry type : string constant in Finding_OutputSelectorType.h
Declared In
Finding_FindItemsByImageRequest.h