brandon14/ebay-sdk-php

View on GitHub
src/Buy/Browse/V1/docs/Model/ItemSummary.md

Summary

Maintainability
Test Coverage
# # ItemSummary

## Properties

Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**additional_images** | [**\TNT\Ebay\Buy\Browse\V1\Model\Image[]**](Image.md) | An array of containers with the URLs for the images that are in addition to the primary image.  The primary image is returned in the <b> image.imageUrl</b> field. | [optional]
**adult_only** | **bool** | This indicates if the item is for adults only. For more information about adult-only items on eBay, see <a href=\"https://pages.ebay.com/help/policies/adult-only.html \" target=\"_blank\">Adult items policy</a> for sellers and <a href=\"https://www.ebay.com/help/terms-conditions/default/searching-adult-items?id=4661 \" target=\"_blank\">Adult-Only items on eBay</a> for buyers. | [optional]
**available_coupons** | **bool** | This boolean attribute indicates if coupons are available for the item. | [optional]
**bid_count** | **int** | This integer value indicates the total number of bids that have been placed for an auction item. This field is only returned for auction items. | [optional]
**buying_options** | **string[]** | A comma separated list of all the purchase options available for the item. <br><br><b> Values Returned:</b><ul><li><b>FIXED_PRICE</b> - Indicates the buyer can purchase the item for a set price using the Buy It Now button. </li>  <li><b> AUCTION</b> - Indicates the buyer can place a bid for the item. After the first bid is placed, this becomes a live auction item and is the only buying option for this item.</li>  <li><b> BEST_OFFER</b> - Items where the buyer can send the seller a price they're willing to pay for the item. The seller can accept, reject, or send a counter offer. For details about Best Offer, see <a href=\"https://www.ebay.com/help/selling/listings/selling-buy-now/adding-best-offer-listing?id=4144 \" target=\"_blank\">Best Offer</a>.</li><li><b>CLASSIFIED_AD</b> - Indicates that the final sales transaction is to be completed outside of the eBay environment.</li></ul> Code so that your app gracefully handles any future changes to this list. | [optional]
**categories** | [**\TNT\Ebay\Buy\Browse\V1\Model\Category[]**](Category.md) | This array returns the name and ID of each category associated with the item, including top level, branch, and leaf categories. | [optional]
**compatibility_match** | **string** | This indicates how well the item matches the <b>compatibility_filter</b> product attributes.  <br><br><b> Valid Values: </b> EXACT or POSSIBLE <br /><br />Code so that your app gracefully handles any future changes to this list. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/buy/browse/types/gct:CompatibilityMatchEnum'>eBay API documentation</a> | [optional]
**compatibility_properties** | [**\TNT\Ebay\Buy\Browse\V1\Model\CompatibilityProperty[]**](CompatibilityProperty.md) | This container returns only the product attributes that are compatible with the item. These attributes were specified in the <b>compatibility_filter</b> in the request. This means that if you passed in 5 attributes and only 4 are compatible, only those 4 are returned. If none of the attributes are compatible, this container is not returned. | [optional]
**condition** | **string** | The text describing the condition of the item, such as New or Used. For a list of condition names, see <a href=\"https://developer.ebay.com/devzone/finding/callref/enums/conditionIdList.html \" target=\"_blank\">Item Condition IDs and Names</a>.  <br /><br />Code so that your app gracefully handles any future changes to this list.</span> | [optional]
**condition_id** | **string** | The identifier of the condition of the item. For example, 1000 is the identifier for NEW. For a list of condition names and IDs, see <a href=\"https://developer.ebay.com/devzone/finding/callref/enums/conditionIdList.html \" target=\"_blank\">Item Condition IDs and Names</a>. <br /><br />Code so that your app gracefully handles any future changes to this list. | [optional]
**current_bid_price** | [**\TNT\Ebay\Buy\Browse\V1\Model\ConvertedAmount**](ConvertedAmount.md) |  | [optional]
**distance_from_pickup_location** | [**\TNT\Ebay\Buy\Browse\V1\Model\TargetLocation**](TargetLocation.md) |  | [optional]
**energy_efficiency_class** | **string** | This indicates the <a href=\"https://en.wikipedia.org/wiki/European_Union_energy_label \">European energy efficiency</a> rating (EEK) of the item.  Energy efficiency ratings apply to products listed by commercial vendors in electronics categories only. <br /><br />Currently, this field is only applicable for the Germany site, and  is only returned if the seller specified the energy efficiency rating through item specifics at listing time. Rating values include <code>A+++</code>, <code>A++</code>, <code>A+</code>, <code>A</code>, <code>B</code>, <code>C</code>, <code>D</code>, <code>E</code>, <code>F</code>, and <code>G</code>. | [optional]
**epid** | **string** | An ePID is the eBay product identifier of a product from the eBay product catalog.  This indicates the product in which the item belongs. | [optional]
**image** | [**\TNT\Ebay\Buy\Browse\V1\Model\Image**](Image.md) |  | [optional]
**item_affiliate_web_url** | **string** | The URL to the View Item page of the item, which includes the affiliate tracking ID. This field is only returned if the seller enables affiliate tracking for the item by including the <code><a href=\"/api-docs/buy/static/api-browse.html#Headers\">X-EBAY-C-ENDUSERCTX</a></code> request header in the method.  <br /> <br /><span class=\"tablenote\"><b>Note: </b> eBay Partner Network, in order to receive a commission for your sales, you must use this URL to forward your buyer to the ebay.com site. </span> | [optional]
**item_creation_date** | **string** | The date and time when the item listing was created.  This value is returned in UTC format (yyyy-MM-ddThh:mm:ss.sssZ), which you can convert into the local time of the buyer. | [optional]
**item_end_date** | **string** | The date and time up to which the item can be purchased.  This value is returned in UTC format (yyyy-MM-ddThh:mm:ss.sssZ), which you can convert into the local time of the buyer.<br /><br /><span class=\"tablenote\"><b> Note: </b>This field is not returned for Good 'Til Cancelled (GTC) listings.</span> | [optional]
**item_group_href** | **string** | The HATEOAS reference of the parent page of the item group. An item group is an item that has various aspect differences, such as color, size, storage capacity, etc. <br /> <br /><span class=\"tablenote\"> <b>  Note: </b>This field is returned only for item groups.</span> | [optional]
**item_group_type** | **string** | The indicates the item group type. An item group is an item that has various aspect differences, such as color, size, storage capacity, etc. <br /><br />Currently only the <code>SELLER_DEFINED_VARIATIONS</code> is supported and indicates this is an item group created by the seller. <br /> <br /><span class=\"tablenote\"> <b> Note: </b>This field is returned only for item groups.</span><br /><br />Code so that your app gracefully handles any future changes to this list. | [optional]
**item_href** | **string** | The URI for the Browse API <a href=\"/api-docs/buy/browse/resources/item/methods/getItem\">getItem</a> method, which can be used to retrieve more details about items in the search results. | [optional]
**item_id** | **string** | The unique RESTful identifier of the item. | [optional]
**item_location** | [**\TNT\Ebay\Buy\Browse\V1\Model\ItemLocationImpl**](ItemLocationImpl.md) |  | [optional]
**item_web_url** | **string** | The URL to the View Item page of the item.  This enables you to include a \"Report Item on eBay\" hyperlink that takes the buyer to the View Item page on eBay. From there they can report any issues regarding this item to eBay. | [optional]
**leaf_category_ids** | **string[]** | The leaf category IDs of the item. When the item belongs to two leaf categories, the ID values are returned in the order primary, secondary. | [optional]
**legacy_item_id** | **string** | The unique identifier of the eBay listing that contains the item. This is the traditional/legacy ID that is often seen in the URL of the listing View Item page. | [optional]
**listing_marketplace_id** | **string** | The ID of the eBay marketplace where the item is listed. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/buy/browse/types/ba:MarketplaceIdEnum'>eBay API documentation</a> | [optional]
**marketing_price** | [**\TNT\Ebay\Buy\Browse\V1\Model\MarketingPrice**](MarketingPrice.md) |  | [optional]
**pickup_options** | [**\TNT\Ebay\Buy\Browse\V1\Model\PickupOptionSummary[]**](PickupOptionSummary.md) | This container returns the local pickup options available to the buyer. This container is only returned if the user is searching for local pickup items and set the local pickup filters in the method request. | [optional]
**price** | [**\TNT\Ebay\Buy\Browse\V1\Model\ConvertedAmount**](ConvertedAmount.md) |  | [optional]
**price_display_condition** | **string** | Indicates when in the buying flow the item's price can appear for minimum advertised price (MAP) items, which is the lowest price a retailer can advertise/show for this item. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/buy/browse/types/gct:PriceDisplayConditionEnum'>eBay API documentation</a> | [optional]
**priority_listing** | **bool** | This field is returned as <code>true</code> if the listing is part of a Promoted Listing campaign. Promoted Listings are available to Above Standard and Top Rated sellers with recent sales activity.<br /><br /><span class=\"tablenote\"><b>Note:</b> Priority Listing is returned only with a Best Match sort and will not be returned for other sort options.</span> | [optional]
**qualified_programs** | **string[]** | An array of the qualified programs available for the item, such as EBAY_PLUS, AUTHENTICITY_GUARANTEE, and AUTHENTICITY_VERIFICATION.<br /><br />eBay Plus is a premium account option for buyers, which provides benefits such as fast free domestic shipping and free returns on selected items. Top-Rated eBay sellers must opt in to eBay Plus to be able to offer the program on qualifying listings. Sellers must commit to next-day delivery of those items.<br /><br /><span class=\"tablenote\"><b>Note: </b> eBay Plus is available only to buyers in Germany, Austria, and Australia marketplaces.</span><br /><br />The eBay <a href=\"https://pages.ebay.com/authenticity-guarantee/ \" target=\"_blank\">Authenticity Guarantee</a> program enables third-party authenticators to perform authentication verification inspections on items such as watches and sneakers. | [optional]
**seller** | [**\TNT\Ebay\Buy\Browse\V1\Model\Seller**](Seller.md) |  | [optional]
**shipping_options** | [**\TNT\Ebay\Buy\Browse\V1\Model\ShippingOptionSummary[]**](ShippingOptionSummary.md) | This container returns the shipping options available to ship the item. | [optional]
**short_description** | **string** | This text string is derived from the item condition and the item aspects (such as size, color, capacity, model, brand, etc.). Sometimes the title doesn't give enough information but the description is too big. Surfacing the <b>shortDescription</b> can often provide buyers with the additional information that could help them make a buying decision.  <br /><br />For example: <br /><br />    <code>   \"<b> title</b>\": \"Petrel U42W FPV Drone RC Quadcopter w/HD Camera Live Video One Key Off / Landing\", <br />\"<b>shortDescription</b>\": \"1 U42W Quadcopter. Syma X5SW-V3 Wifi FPV RC Drone Quadcopter 2.4Ghz 6-Axis Gyro with Headless Mode. Syma X20 Pocket Drone 2.4Ghz Mini RC Quadcopter Headless Mode Altitude Hold. One Key Take Off / Landing function: allow beginner to easy to fly the drone without any skill.\",</code>       <br /><br /><b>Restriction: </b> This field is returned by the <b> search</b> method only when <b> fieldgroups</b> = <code>EXTENDED</code>. | [optional]
**thumbnail_images** | [**\TNT\Ebay\Buy\Browse\V1\Model\Image[]**](Image.md) | An array of thumbnail images for the item. | [optional]
**title** | **string** | The seller-created title of the item. <br><br><b>Maximum Length: </b> 80 characters | [optional]
**top_rated_buying_experience** | **bool** | This indicates if the item is a top-rated plus item. There are three benefits of a top-rated plus item: a  minimum 30-day money-back return policy, shipping the item in 1 business day with tracking provided, and the added comfort of knowing that this item is from an experienced seller with the highest buyer ratings. See the <a href=\"https://pages.ebay.com/topratedplus/index.html \" target=\"_blank\">Top Rated Plus Items </a> and <a href=\"https://pages.ebay.com/help/sell/top-rated.html \" target=\"_blank\">Becoming a Top Rated Seller and qualifying for Top Rated Plus</a> help topics for more information. | [optional]
**tyre_label_image_url** | **string** | The URL to the image that shows the information on the tyre label. | [optional]
**unit_price** | [**\TNT\Ebay\Buy\Browse\V1\Model\ConvertedAmount**](ConvertedAmount.md) |  | [optional]
**unit_pricing_measure** | **string** | The designation, such as size, weight, volume, count, etc., that was used to specify the quantity of the item. This helps buyers compare prices. <br /><br />For example, the following tells the buyer that the item is 7.99 per 100 grams. <br /><br /><code>\"unitPricingMeasure\": \"100g\",<br /> \"unitPrice\": {<br />  \"value\": \"7.99\",<br />  \"currency\": \"GBP\"</code> | [optional]
**watch_count** | **int** | The number of users that have added the item to their watch list.<br /><br /><span class=\"tablenote\"> <strong>Note:</strong> This field is restricted to applications that have been granted permission to access this feature. You must submit an <a href=\"https://developer.ebay.com/my/support/tickets?tab=app-check \">App Check ticket</a> to request this access. In the App Check form, add a note to the <b>Application Title/Summary</b> and/or <b>Application Details</b> fields that you want access to Watch Count data in the Browse API.</span> | [optional]

[[Back to Model list]](../../README.md#models) [[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)