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

Overview

Information that describes an item’s condition.

@ingroup FindingServicePortType

Tasks

  •   conditionId

    The numeric ID (e.g., 1000) for the item condition.



    In item results, this is only returned when the seller listed the
    item with a condition ID.
    Some categories don’t support or require condition IDs
    (e.g., most Antiques categories don’t). Also, until spring 2011,
    some GTC listings may define the item condition in item specifics
    instead, so no ID is returned.



    If you specify Condition in itemFilter, the response returns items
    with the correctly matching condition(s), even if conditionId is
    not returned. For example, if you specify a value of “New"
    or "1000” in the item filter, the response only returns new items.

    property
  •   conditionDisplayName

    The human-readable label for the item condition.
    Display names are localized for the site on which they’re listed
    (not necessarily the site on which they’re viewed).



    In item results, this is only returned when the seller specified the item’s condition
    using a structured format eBay recognizes (e.g., conditionId or an
    older item specifics format).



    When conditionId is also present:
    Most categories use the same display name for the same
    condition ID. Some categories may override the display name based
    on buyer expectations for items in the category.
    For example, condition ID 1000 could be called “New"
    in one category and "New with tags” in another.
    If an item is listed in two categories, the primary category
    controls the display name.



    Behind the scenes, eBay’s search engine uses the ID (not the
    display name) to determine whether items are new, used, or
    refurbished. So, if you need to normalize the conditions
    across categories (such as to group items by condition),
    it may be easier to use the ID and then show the varying
    display names for reference.



    In condition histograms: If you search against
    a specific category and some items match based on their
    secondary category, the histogram only shows the display name
    if the secondary category supports the condition.
    (Condition IDs and names are dependent on the primary category.)
    However, the histogram shows the condition ID and item counts.
    This should only occur in a very small percent of results.
    Histograms may support display names in these cases later in 2011.
    As a workaround, you can fill in the missing name based on the
    “Item Condition IDs and Names” (link below) or based on
    the condition from an applicable item in the results.



    For example, suppose a seller lists a concert T-shirt in a
    clothing category with the condition “New without tags” (1500),
    and also in a music accessories secondary category (where
    “New without tags” isn’t a recognized condition).
    If you specify the music accessories category in your request,
    the condition ID (1500) is shown in the histogram, but not the
    display name. However, the display name is shown within the items.

    property
  •   delimiter

    (public property)

    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

Finding_Condition.h

conditionDisplayName

The human-readable label for the item condition.
Display names are localized for the site on which they’re listed
(not necessarily the site on which they’re viewed).



In item results, this is only returned when the seller specified the item’s condition
using a structured format eBay recognizes (e.g., conditionId or an
older item specifics format).



When conditionId is also present:
Most categories use the same display name for the same
condition ID. Some categories may override the display name based
on buyer expectations for items in the category.
For example, condition ID 1000 could be called “New"
in one category and "New with tags” in another.
If an item is listed in two categories, the primary category
controls the display name.



Behind the scenes, eBay’s search engine uses the ID (not the
display name) to determine whether items are new, used, or
refurbished. So, if you need to normalize the conditions
across categories (such as to group items by condition),
it may be easier to use the ID and then show the varying
display names for reference.



In condition histograms: If you search against
a specific category and some items match based on their
secondary category, the histogram only shows the display name
if the secondary category supports the condition.
(Condition IDs and names are dependent on the primary category.)
However, the histogram shows the condition ID and item counts.
This should only occur in a very small percent of results.
Histograms may support display names in these cases later in 2011.
As a workaround, you can fill in the missing name based on the
“Item Condition IDs and Names” (link below) or based on
the condition from an applicable item in the results.



For example, suppose a seller lists a concert T-shirt in a
clothing category with the condition “New without tags” (1500),
and also in a music accessories secondary category (where
“New without tags” isn’t a recognized condition).
If you specify the music accessories category in your request,
the condition ID (1500) is shown in the histogram, but not the
display name. However, the display name is shown within the items.

@property (nonatomic, retain) NSString *conditionDisplayName

Discussion

The human-readable label for the item condition.
Display names are localized for the site on which they’re listed
(not necessarily the site on which they’re viewed).



In item results, this is only returned when the seller specified the item’s condition
using a structured format eBay recognizes (e.g., conditionId or an
older item specifics format).



When conditionId is also present:
Most categories use the same display name for the same
condition ID. Some categories may override the display name based
on buyer expectations for items in the category.
For example, condition ID 1000 could be called “New"
in one category and "New with tags” in another.
If an item is listed in two categories, the primary category
controls the display name.



Behind the scenes, eBay’s search engine uses the ID (not the
display name) to determine whether items are new, used, or
refurbished. So, if you need to normalize the conditions
across categories (such as to group items by condition),
it may be easier to use the ID and then show the varying
display names for reference.



In condition histograms: If you search against
a specific category and some items match based on their
secondary category, the histogram only shows the display name
if the secondary category supports the condition.
(Condition IDs and names are dependent on the primary category.)
However, the histogram shows the condition ID and item counts.
This should only occur in a very small percent of results.
Histograms may support display names in these cases later in 2011.
As a workaround, you can fill in the missing name based on the
“Item Condition IDs and Names” (link below) or based on
the condition from an applicable item in the results.



For example, suppose a seller lists a concert T-shirt in a
clothing category with the condition “New without tags” (1500),
and also in a music accessories secondary category (where
“New without tags” isn’t a recognized condition).
If you specify the music accessories category in your request,
the condition ID (1500) is shown in the histogram, but not the
display name. However, the display name is shown within the items.

type : NSString, wrapper for primitive string

Declared In

Finding_Condition.h

conditionId

The numeric ID (e.g., 1000) for the item condition.



In item results, this is only returned when the seller listed the
item with a condition ID.
Some categories don’t support or require condition IDs
(e.g., most Antiques categories don’t). Also, until spring 2011,
some GTC listings may define the item condition in item specifics
instead, so no ID is returned.



If you specify Condition in itemFilter, the response returns items
with the correctly matching condition(s), even if conditionId is
not returned. For example, if you specify a value of “New"
or "1000” in the item filter, the response only returns new items.

@property (nonatomic, retain) NSNumber *conditionId

Discussion

The numeric ID (e.g., 1000) for the item condition.



In item results, this is only returned when the seller listed the
item with a condition ID.
Some categories don’t support or require condition IDs
(e.g., most Antiques categories don’t). Also, until spring 2011,
some GTC listings may define the item condition in item specifics
instead, so no ID is returned.



If you specify Condition in itemFilter, the response returns items
with the correctly matching condition(s), even if conditionId is
not returned. For example, if you specify a value of “New"
or "1000” in the item filter, the response only returns new items.

type : NSNumber, wrapper for primitive int

Declared In

Finding_Condition.h

delimiter

(public property)

@property (nonatomic, retain) NSString *delimiter

Discussion

(public property)

type : NSString, wrapper for primitive string

Declared In

Finding_Condition.h