Inherits from NSObject
Conforms to PicoBindable
Declared in Trading_GetRecommendationsRequestContainerType.h
Trading_GetRecommendationsRequestContainerType.m

Overview

Specifies the data for a single item and configures the recommendation engines to use
when processing the item with GetItemRecommendations.

@ingroup EBayAPIInterface

Tasks

  •   listingFlow

    The listing flow for which the seller is seeking Listing Analyzer recommendations.
    Not applicable to results from other recommendation engines
    (i.e., the Suggested Attributes engine or the Product Pricing engine).
    The default flow is AddItem.

    property
  •   item

    Contains fields that describe the item for which you are seeking recommendations.



    If the Listing Analyzer recommendation engine is run, the applicable fields are
    the same as the fields for AddItem, ReviseItem, or RelistItem
    requests, as determined by the value specified in ListingFlow.
    The item ID (Item.ItemID) is required when the ListingFlow is ReviseItem or RelistItem,
    and it is not applicable when the ListingFlow is AddItem.
    All other item fields are optional, even if listed as required for other calls.
    However, as some tips are dependent on the properties of the item, and as some properties
    have dependencies on other properties, we strongly recommend that you include all the item properties
    that will be included in the AddItem, ReviseItem, or RelistItem request.
    When the Listing Analyzer engine is run, tips will only be returned for fields that are specfied on the item.



    When the Product Pricing engine is run, pricing data will be based on the catalog product you specify.

    property
  •   recommendationEngine

    A recommendation engine to run. If no engines are specified, all available
    recommendation engines will run. Some engines require additional fields,
    such as Item.PrimaryCategory.CategoryID, to be specified.
    If the ProductPricing engine is specified but Item.ProductListingDetails is not specified,
    no Product Pricing engine results are returned.

    property
  •   query

    One or more keywords to search for when using the Suggested Attributes engine.
    Required when SuggestedAttributes is specified as the recommendation engine
    (including when no recommendation engines are specified). Only the listing title
    is searched. The words “and” and “or” are treated like any other word.
    Blank searches are not allowed (and result in a warning).

    property
  •   correlationID

    Unique key to identify the response that matches this recommendation request container.
    Use this key to distinguish between responses when multiple
    recommendation containers are specified (i.e., for batch requests).
    You define the key. To be useful, each correlation ID should be unique within
    the same call. That is, define a different correlation ID for each recommendation
    request container. (eBay does not validate the uniqueness of these IDs.)
    If specified, the same correlation ID will be returned in the corresponding
    recommendation response (or error response).
    We recommend that you use this when retrieving recommendations for multiple items at once.

    property
  •   deletedField

    Specifies the name of the field to remove from a listing.
    Applicable when the ListingFlow is ReviseItem or RelistItem.
    See ReviseItem and RelistItem for applicable values.

    property
  •   excludeRelationships

    If true, the Relationship node is not returned for any
    recommendations. Relationship recommendations tell you whether
    an Item Specific value has a logical dependency on another
    Item Specific.



    For example, in a clothing category, Size Type could be
    recommended as a parent of Size, because Size=Small would
    mean something different to buyers depending on whether
    Size Type=Petite or Size Type=Plus.



    In general, it is a good idea to retrieve and use relationship
    recommendations, as this data can help buyers find the items
    they want more easily.



    Only applicable when RecommendationEngine=ItemSpecifics.

    property
  •   includeConfidence

    If true, returns eBay’s level of confidence for each
    name and value. Some sellers may find this useful when choosing
    whether to use eBay’s recommendation or their own name or value.




    Only applicable when RecommendationEngine=ItemSpecifics.

    property
  •   any

    (public property)

    property

Properties

any

(public property)

@property (nonatomic, retain) NSMutableArray *any

Discussion

(public property)

entry type : PicoAnyElement, wrapper for primitive anyelement

Declared In

Trading_GetRecommendationsRequestContainerType.h

correlationID

Unique key to identify the response that matches this recommendation request container.
Use this key to distinguish between responses when multiple
recommendation containers are specified (i.e., for batch requests).
You define the key. To be useful, each correlation ID should be unique within
the same call. That is, define a different correlation ID for each recommendation
request container. (eBay does not validate the uniqueness of these IDs.)
If specified, the same correlation ID will be returned in the corresponding
recommendation response (or error response).
We recommend that you use this when retrieving recommendations for multiple items at once.

@property (nonatomic, retain) NSString *correlationID

Discussion

Unique key to identify the response that matches this recommendation request container.
Use this key to distinguish between responses when multiple
recommendation containers are specified (i.e., for batch requests).
You define the key. To be useful, each correlation ID should be unique within
the same call. That is, define a different correlation ID for each recommendation
request container. (eBay does not validate the uniqueness of these IDs.)
If specified, the same correlation ID will be returned in the corresponding
recommendation response (or error response).
We recommend that you use this when retrieving recommendations for multiple items at once.

type : NSString, wrapper for primitive string

Declared In

Trading_GetRecommendationsRequestContainerType.h

deletedField

Specifies the name of the field to remove from a listing.
Applicable when the ListingFlow is ReviseItem or RelistItem.
See ReviseItem and RelistItem for applicable values.

@property (nonatomic, retain) NSMutableArray *deletedField

Discussion

Specifies the name of the field to remove from a listing.
Applicable when the ListingFlow is ReviseItem or RelistItem.
See ReviseItem and RelistItem for applicable values.

entry type : NSString, wrapper for primitive string

Declared In

Trading_GetRecommendationsRequestContainerType.h

excludeRelationships

If true, the Relationship node is not returned for any
recommendations. Relationship recommendations tell you whether
an Item Specific value has a logical dependency on another
Item Specific.



For example, in a clothing category, Size Type could be
recommended as a parent of Size, because Size=Small would
mean something different to buyers depending on whether
Size Type=Petite or Size Type=Plus.



In general, it is a good idea to retrieve and use relationship
recommendations, as this data can help buyers find the items
they want more easily.



Only applicable when RecommendationEngine=ItemSpecifics.

@property (nonatomic, retain) NSNumber *excludeRelationships

Discussion

If true, the Relationship node is not returned for any
recommendations. Relationship recommendations tell you whether
an Item Specific value has a logical dependency on another
Item Specific.



For example, in a clothing category, Size Type could be
recommended as a parent of Size, because Size=Small would
mean something different to buyers depending on whether
Size Type=Petite or Size Type=Plus.



In general, it is a good idea to retrieve and use relationship
recommendations, as this data can help buyers find the items
they want more easily.



Only applicable when RecommendationEngine=ItemSpecifics.

type : NSNumber, wrapper for primitive bool

Declared In

Trading_GetRecommendationsRequestContainerType.h

includeConfidence

If true, returns eBay’s level of confidence for each
name and value. Some sellers may find this useful when choosing
whether to use eBay’s recommendation or their own name or value.




Only applicable when RecommendationEngine=ItemSpecifics.

@property (nonatomic, retain) NSNumber *includeConfidence

Discussion

If true, returns eBay’s level of confidence for each
name and value. Some sellers may find this useful when choosing
whether to use eBay’s recommendation or their own name or value.




Only applicable when RecommendationEngine=ItemSpecifics.

type : NSNumber, wrapper for primitive bool

Declared In

Trading_GetRecommendationsRequestContainerType.h

item

Contains fields that describe the item for which you are seeking recommendations.



If the Listing Analyzer recommendation engine is run, the applicable fields are
the same as the fields for AddItem, ReviseItem, or RelistItem
requests, as determined by the value specified in ListingFlow.
The item ID (Item.ItemID) is required when the ListingFlow is ReviseItem or RelistItem,
and it is not applicable when the ListingFlow is AddItem.
All other item fields are optional, even if listed as required for other calls.
However, as some tips are dependent on the properties of the item, and as some properties
have dependencies on other properties, we strongly recommend that you include all the item properties
that will be included in the AddItem, ReviseItem, or RelistItem request.
When the Listing Analyzer engine is run, tips will only be returned for fields that are specfied on the item.



When the Product Pricing engine is run, pricing data will be based on the catalog product you specify.

@property (nonatomic, retain) Trading_ItemType *item

Discussion

Contains fields that describe the item for which you are seeking recommendations.



If the Listing Analyzer recommendation engine is run, the applicable fields are
the same as the fields for AddItem, ReviseItem, or RelistItem
requests, as determined by the value specified in ListingFlow.
The item ID (Item.ItemID) is required when the ListingFlow is ReviseItem or RelistItem,
and it is not applicable when the ListingFlow is AddItem.
All other item fields are optional, even if listed as required for other calls.
However, as some tips are dependent on the properties of the item, and as some properties
have dependencies on other properties, we strongly recommend that you include all the item properties
that will be included in the AddItem, ReviseItem, or RelistItem request.
When the Listing Analyzer engine is run, tips will only be returned for fields that are specfied on the item.



When the Product Pricing engine is run, pricing data will be based on the catalog product you specify.

type : class Trading_ItemType

Declared In

Trading_GetRecommendationsRequestContainerType.h

listingFlow

The listing flow for which the seller is seeking Listing Analyzer recommendations.
Not applicable to results from other recommendation engines
(i.e., the Suggested Attributes engine or the Product Pricing engine).
The default flow is AddItem.

@property (nonatomic, retain) NSString *listingFlow

Discussion

The listing flow for which the seller is seeking Listing Analyzer recommendations.
Not applicable to results from other recommendation engines
(i.e., the Suggested Attributes engine or the Product Pricing engine).
The default flow is AddItem.

type: string constant in Trading_ListingFlowCodeType.h

Declared In

Trading_GetRecommendationsRequestContainerType.h

query

One or more keywords to search for when using the Suggested Attributes engine.
Required when SuggestedAttributes is specified as the recommendation engine
(including when no recommendation engines are specified). Only the listing title
is searched. The words “and” and “or” are treated like any other word.
Blank searches are not allowed (and result in a warning).

@property (nonatomic, retain) NSString *query

Discussion

One or more keywords to search for when using the Suggested Attributes engine.
Required when SuggestedAttributes is specified as the recommendation engine
(including when no recommendation engines are specified). Only the listing title
is searched. The words “and” and “or” are treated like any other word.
Blank searches are not allowed (and result in a warning).

type : NSString, wrapper for primitive string

Declared In

Trading_GetRecommendationsRequestContainerType.h

recommendationEngine

A recommendation engine to run. If no engines are specified, all available
recommendation engines will run. Some engines require additional fields,
such as Item.PrimaryCategory.CategoryID, to be specified.
If the ProductPricing engine is specified but Item.ProductListingDetails is not specified,
no Product Pricing engine results are returned.

@property (nonatomic, retain) NSMutableArray *recommendationEngine

Discussion

A recommendation engine to run. If no engines are specified, all available
recommendation engines will run. Some engines require additional fields,
such as Item.PrimaryCategory.CategoryID, to be specified.
If the ProductPricing engine is specified but Item.ProductListingDetails is not specified,
no Product Pricing engine results are returned.

entry type : string constant in Trading_RecommendationEngineCodeType.h

Declared In

Trading_GetRecommendationsRequestContainerType.h