getInventoryItems
<h1>getInventoryItems</h1>
<p><strong>GET</strong> / inventory_item</p>
<p>此调用将检索为卖方帐户定义的所有库存项目记录。该限制的查询参数允许卖方控制多少条记录每页返回，和偏移查询参数是用来检索记录的特定页面。卖家可以多次打电话来扫描多页记录。此调用没有请求有效负载。</p>
<p>该authorization头是该呼叫的唯一需要的HTTP头，而且它需要所有库存API调用。有关更多信息，请参阅HTTP请求标头部分。</p>
<p>对于那些喜欢通过SKU值一次调用（一次最多25个）检索大量库存项目记录的人，可以使用bulkGetInventoryItem方法。</p>
<p><strong>input</strong></p>
<p>Resource URI (production)</p>
<pre><code>GET https://api.ebay.com/sell/inventory/v1/inventory_item?
limit=string&
offset=string</code></pre>
<p>URI parameters</p>
<table>
<thead>
<tr>
<th>Parameter</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>offset</td>
<td>string</td>
<td>此查询参数中传递的值设置要检索的页码。第一页记录的值为0，第二页记录的值为1，依此类推。如果未设置此查询参数，则其值默认为0，并返回第一页记录。出现：可选</td>
</tr>
<tr>
<td>limit</td>
<td>string</td>
<td>此查询参数中传递的值设置每页数据返回的最大记录数。虽然这个字段是一个字符串，在此字段中传递的值应为的整数1到100。如果未设置此查询参数，则每页结果最多返回100条记录。最小值：1，最大值：100出现：可选</td>
</tr>
</tbody>
</table>
<p><strong>HTTP request headers</strong>
对eBay REST操作发出的所有请求都要求您提供授权 HTTP标头以进行身份验证授权。
此方法没有其他必需的标头。请参阅HTTP请求标头- 打开其余请求组件页面以获取详细信息
<strong>OAuth scope</strong>
此请求需要使用授权代码授权流创建的访问令牌，使用以下列表中的一个范围：</p>
<p><a href="https://api.ebay.com/oauth/api_scope/sell.inventory.readonly">https://api.ebay.com/oauth/api_scope/sell.inventory.readonly</a></p>
<p><a href="https://api.ebay.com/oauth/api_scope/sell.inventory">https://api.ebay.com/oauth/api_scope/sell.inventory</a></p>
<p>有关详细信息，请参阅OAuth访问令牌。</p>
<p><strong>Request payload</strong></p>
<p>This call has no payload.</p>
<p><strong>Request fields</strong></p>
<p>This call has no field definitions.</p>
<p><strong>Output</strong>
HTTP response headers
This call has no response headers.</p>
<h6>Response payload</h6>
<pre><code>{
"href": "string",
"inventoryItems": [
{
"availability": {
"pickupAtLocationAvailability": [
{
"availabilityType": "AvailabilityTypeEnum : [IN_STOCK,OUT_OF_STOCK,SHIP_TO_STORE]",
"fulfillmentTime": {
"unit": "TimeDurationUnitEnum : [YEAR,MONTH,DAY,HOUR,CALENDAR_DAY,BUSINESS_DAY,MINUTE,SECOND,MILLISECOND]",
"value": "integer"
},
"merchantLocationKey": "string",
"quantity": "integer"
}
],
"shipToLocationAvailability": {
"quantity": "integer"
}
},
"condition": "ConditionEnum : [NEW,LIKE_NEW,NEW_OTHER,NEW_WITH_DEFECTS,MANUFACTURER_REFURBISHED,SELLER_REFURBISHED,USED_EXCELLENT,USED_VERY_GOOD,USED_GOOD,USED_ACCEPTABLE,FOR_PARTS_OR_NOT_WORKING]",
"conditionDescription": "string",
"packageWeightAndSize": {
"dimensions": {
"height": "number",
"length": "number",
"unit": "LengthUnitOfMeasureEnum : [INCH,FEET,CENTIMETER,METER]",
"width": "number"
},
"packageType": "PackageTypeEnum : [LETTER,BULKY_GOODS,CARAVAN,CARS,EUROPALLET,EXPANDABLE_TOUGH_BAGS,EXTRA_LARGE_PACK,FURNITURE,INDUSTRY_VEHICLES,LARGE_CANADA_POSTBOX,LARGE_CANADA_POST_BUBBLE_MAILER,LARGE_ENVELOPE,MAILING_BOX,MEDIUM_CANADA_POST_BOX,MEDIUM_CANADA_POST_BUBBLE_MAILER,MOTORBIKES,ONE_WAY_PALLET,PACKAGE_THICK_ENVELOPE,PADDED_BAGS,PARCEL_OR_PADDED_ENVELOPE,ROLL,SMALL_CANADA_POST_BOX,SMALL_CANADA_POST_BUBBLE_MAILER,TOUGH_BAGS,UPS_LETTER,USPS_FLAT_RATE_ENVELOPE,USPS_LARGE_PACK,VERY_LARGE_PACK,WINE_PAK]",
"weight": {
"unit": "WeightUnitOfMeasureEnum : [POUND,KILOGRAM,OUNCE,GRAM]",
"value": "number"
}
},
"product": {
"aspects": [
"string"
],
"brand": "string",
"description": "string",
"imageUrls": [
"string"
],
"mpn": "string",
"subtitle": "string",
"title": "string",
"isbn": [
"string"
],
"upc": [
"string"
],
"ean": [
"string"
],
"epid": "string"
},
"sku": "string",
"locale": "LocaleEnum : [en_US,en_CA,fr_CA,en_GB,en_AU,en_IN,de_AT,fr_BE,fr_FR,de_DE,it_IT,nl_BE,nl_NL,es_ES,de_CH,fi_FI,zh_HK,hu_HU,en_PH,pl_PL,pt_PT,ru_RU,en_SG,en_IE,en_MY]",
"groupIds": [
"string"
],
"inventoryItemGroupKeys": [
"string"
]
}
],
"next": "string",
"limit": "integer",
"prev": "string",
"size": "integer",
"total": "integer"
}</code></pre>
<p><strong>Response fields</strong></p>
<table>
<thead>
<tr>
<th>Output container/field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>href</td>
<td>string</td>
<td>This is the URL to the current page of inventory items.Occurrence: Always</td>
</tr>
<tr>
<td>inventoryItems</td>
<td>array of InventoryItemWithSkuLocaleGroupid</td>
<td>This container is an array of one or more inventory items, with detailed information on each inventory item Occurrence: Always</td>
</tr>
<tr>
<td>inventoryItems.availability</td>
<td>Availability</td>
<td>此容器用于指定可供购买的库存物料的数量。在卖方准备与SKU一起发布要约之前，此容器是可选的，此时它是必需的。如果正在更新库存项目并且该库存项目的可用性数据已存在，则还必须传递可用性数据。由于库存项目在要约中发布之前必须具有指定数量，因此该容器始终在针对已发布要约的SKU的“获取”调用中返回。如果SKU不是已发布商品的一部分，则仅在为库存商品设置时才会返回此容器。发生：有条件的</td>
</tr>
<tr>
<td>inventoryItems.availability.pickupAtLocationAvailability</td>
<td>array of PickupAtLocationAvailability</td>
<td>该容器由一个或多个商家的实体店位置组成，其中库存项目可用于店内提货订单。商家的位置，可用数量和履行时间（订单发生后物品准备好接收的时间）都在此容器中。店内提货仅适用于在美国，英国，德国和澳大利亚网站销售的大型商家。出现：可选</td>
</tr>
<tr>
<td>inventoryItems.availability.pickupAtLocationAvailability.availabilityType</td>
<td>AvailabilityTypeEnum</td>
<td>此字段中的枚举值指示由pickupAtLocationAvailability.merchantLocationKey字段指定的商家实体店中的库存项目的可用性状态。如果使用了pickupAtLocationAvailability容器，则此字段是必需的，并且始终使用pickupAtLocationAvailability容器返回。 有关使用每个枚举值的方式/ 时间的详细信息，请参阅AvailabilityTypeEnum。发生：有条件的</td>
</tr>
<tr>
<td>inventoryItems.availability.pickupAtLocationAvailability.fulfillmentTime</td>
<td>TimeDuration</td>
<td>此容器用于指示在订单发生后买方可以立即获取店内提货订单。如果使用了pickupAtLocationAvailability容器，则此容器是必需的，并且始终使用pickupAtLocationAvailability容器返回。发生：有条件的</td>
</tr>
<tr>
<td>inventoryItems.availability.pickupAtLocationAvailability.fulfillmentTime.unit</td>
<td>TimeDurationUnitEnum</td>
<td>此枚举值指示用于指定履行时间的时间单位，例如HOUR。发生：有条件的</td>
</tr>
<tr>
<td>inventoryItems.availability.pickupAtLocationAvailability.fulfillmentTime.value</td>
<td>integer</td>
<td>此字段中的整数值以及单位字段中的时间单位将指示买家在店内提货购买后多久可以在指定的商店位置领取商品。如果此字段4的值为，且单位字段的值为HOUR，则店内提货订单的履行时间为四小时，这意味着买方将能够在商店提取物品四小时交易发生后。发生：有条件的</td>
</tr>
<tr>
<td>inventoryItems.availability.pickupAtLocationAvailability.merchantLocationKey</td>
<td>string</td>
<td>店内提货库存项目当前所在的商家商店的唯一标识符，或库存将被发送到的商店。如果商家的商店当前正在等待库存，那么availabilityType值应该是SHIP_TO_STORE。如果使用了pickupAtLocationAvailability容器，则此字段是必需的，并且始终使用pickupAtLocationAvailability容器返回。最大长度：36发生：有条件的</td>
</tr>
<tr>
<td>inventoryItems.availability.pickupAtLocationAvailability.quantity</td>
<td>integer</td>
<td>此整数值表示在merchantLocationKey值标识的商店中可用于店内代答的库存项目数量 。除非库存商品缺货，否则数量值应为大于的整数值0。如果使用了pickupAtLocationAvailability容器，则此字段是必需的，并且始终使用pickupAtLocationAvailability容器返回。发生：有条件的</td>
</tr>
<tr>
<td>inventoryItems.availability.shipToLocationAvailability</td>
<td>ShipToLocationAvailability</td>
<td>此容器指定可在一个或多个eBay市场上购买的库存物料的数量。出现：可选</td>
</tr>
<tr>
<td>inventoryItems.availability.shipToLocationAvailability.quantity</td>
<td>integer</td>
<td>此容器用于设置可通过一个或多个已发布的商品购买的库存商品的总“发货到户”数量。此容器不是立即需要的，但必须在发布库存物品的报价之前设置“发货到户”数量。如果正在更新现有库存物料，并且库存物料记录已存在“发货至库存”数量，则应再次包含此容器，即使该值未更改，或者可用数量数据将丢失。发生：有条件的</td>
</tr>
<tr>
<td>inventoryItems.condition</td>
<td>ConditionEnum</td>
<td>此枚举值表示项目的条件。支持的项目条件值将因易趣网站和类别而异。要查看特定eBay类别支持的项条件值，请使用Metadata API的getItemConditionPolicies调用，将类别ID作为查询参数传递。可以在getItemConditionPolicies Call Reference页面上找到正确的语法。支持的项目条件将在getItemConditionPolicies响应的itemConditions容器下返回。该itemConditions容器将包括conditionId和conditionDescription值。该conditionId值必须与ConditionEnum类型中定义的枚举值匹配。有关映射信息，请参阅此类型文档，因为必须在条件字段中指定此类型中的一个值。在卖方准备与SKU发布要约之前，此字段是可选的，此时它将成为必需。由于必须在要约中发布之前指定库存项目的条件，因此该字段始终在作为已发布要约的一部分的SKU的“获取”调用中返回。如果SKU不是已发布商品的一部分，则仅在为库存商品设置时才会返回此容器。发生：有条件的</td>
</tr>
<tr>
<td>inventoryItems.conditionDescription</td>
<td>string</td>
<td>该字符串字段用于卖方更清楚地描述使用库存项目的条件，或对库存物料，其条件值不NEW，LIKE_NEW，NEW_OTHER，或NEW_WITH_DEFECTS。该conditionDescription场适用于所有类别的易趣。如果conditionDescription字段与其中一个新条件（前一段中提到）中的项目一起使用，eBay将忽略此字段（如果包含），eBay将向用户返回警告消息。此字段仅用于进一步阐明所用项目的状况。它不应用于品牌，促销，运输，退货，付款或与使用过的商品的状态无关的其他信息。确保条件值，条件描述，列表描述和项目图片不会相互矛盾。此字段并不总是必需的，但如果正在更新库存项目并且该库存项目已存在条件描述，则需要此字段。如果为使用过的库存项目提供了条件描述，则会在getInventoryItem和getInventoryItems调用中返回此字段。最大长度：1000。出现：可选</td>
</tr>
<tr>
<td>inventoryItems.packageWeightAndSize</td>
<td>PackageWeightAndSize</td>
<td>如果卖方为库存物品提供一个或多个计算的运输选项，或者卖方提供统一运费但包含基于物品重量的运费附加费，则使用此容器。此容器用于指定运输包装的尺寸和重量。此容器并不总是必需的，但如果正在更新库存项目并且该库存项目已存在装运包数据，则需要此容器。如果为库存项目指定了包类型，包装重量和/或包装尺寸，则在getInventoryItem和getInventoryItems调用中返回此容器。有关计算出货的详细信息，请参阅计算出货帮助页面。发生：有条件的</td>
</tr>
<tr>
<td>inventoryItems.packageWeightAndSize.dimensions</td>
<td>Dimension</td>
<td>此容器用于指示将用于运送库存物料的装运包的长度，宽度和高度。使用计算出货时，需要运输包装的尺寸。如果为库存物料设置了包装尺寸，则将返回此容器。发生：有条件的</td>
</tr>
<tr>
<td>inventoryItems.packageWeightAndSize.dimensions.height</td>
<td>number</td>
<td>运输包装的实际高度（在单位字段中指定的测量单位）。如果指定了包维，则需要维度容器的所有字段。如果运输包装的长度为21.5英寸，宽度为15.0英寸，高度为12.0英寸，则尺寸容器的外观如下："dimensions": {"length": 21.5,"width": 15.0,"height": 12.0,"unit": "INCH"} 发生：有条件的</td>
</tr>
<tr>
<td>inventoryItems.packageWeightAndSize.dimensions.length</td>
<td>number</td>
<td>运输包装的实际长度（在单位字段中指定的测量单位）。如果指定了包维，则需要维度容器的所有字段。如果运输包装的长度为21.5英寸，宽度为15.0英寸，高度为12.0英寸，则尺寸容器的外观如下："dimensions": {"length": 21.5,"width": 15.0,"height": 12.0,"unit": "INCH"} 发生：有条件的</td>
</tr>
<tr>
<td>inventoryItems.packageWeightAndSize.dimensions.unit</td>
<td>LengthUnitOfMeasureEnum</td>
<td>用于指定运输包装尺寸的计量单位。如果指定了包维，则需要维度容器的所有字段。如果使用英语测量系统，则尺寸单位的适用值为FEET和INCH。如果使用公制测量系统，则重量单位的适用值为METER和CENTIMETER。公制系统被美国以外的大多数国家使用。发生：有条件的</td>
</tr>
<tr>
<td>inventoryItems.packageWeightAndSize.dimensions.width</td>
<td>number</td>
<td>运输包装的实际宽度（在单位字段中指定的测量单位）。如果指定了包维，则需要维度容器的所有字段。如果运输包装的长度为21.5英寸，宽度为15.0英寸，高度为12.0英寸，则尺寸容器的外观如下："dimensions": {"length": 21.5,"width": 15.0,"height": 12.0,"unit": "INCH"} 发生：有条件的</td>
</tr>
<tr>
<td>inventoryItems.packageWeightAndSize.packageType</td>
<td>PackageTypeEnum</td>
<td>此枚举值指示用于运送库存物料的装运包的类型。可以在PackageTypeEnum类型中找到此字段支持的值。如果为库存项目设置了包类型，则将返回此字段。发生：有条件的</td>
</tr>
<tr>
<td>inventoryItems.packageWeightAndSize.weight</td>
<td>Weight</td>
<td>此容器用于指定将用于运送库存物料的装运包的重量。如果使用计算运费，或者使用固定运费，但需要重量附加费，则需要运输包裹的重量。如果为库存料品设置了包装重量，则会返回此栏位。发生：有条件的</td>
</tr>
<tr>
<td>inventoryItems.packageWeightAndSize.weight.unit</td>
<td>WeightUnitOfMeasureEnum</td>
<td>用于指定运输包装重量的计量单位。两个单元和值，如果字段是必需的重量，使用的容器。如果使用英制测量系统，则重量单位的适用值为POUND和OUNCE。如果使用公制测量系统，则重量单位的适用值为KILOGRAM和GRAM。公制系统被美国以外的大多数国家使用。发生：有条件的</td>
</tr>
<tr>
<td>inventoryItems.packageWeightAndSize.weight.value</td>
<td>number</td>
<td>运输包装的实际重量（在单位字段中指定的测量单位）。两个单元和值，如果字段是必需的重量，使用的容器。如果运输包装重20.5盎司，则容器看起来如下：“重量”：{ “值”：20.5，“单位”：“OUNCE” }发生：有条件的</td>
</tr>
<tr>
<td>inventoryItems.product</td>
<td>Product</td>
<td>此容器用于定义产品详细信息，例如产品标题，产品描述，产品标识符（eBay产品ID，GTIN或品牌/ MPN对），产品方面/项目细节和产品图像。请注意，可以使用易趣产品ID（ePID）或全球贸易项目编号（GTIN）值来尝试在易趣目录中查找匹配的产品。如果找到产品匹配，则库存项目记录将自动获取与eBay目录产品相关的所有产品详细信息。注意：对于美国，英国，CA（英语）和AU网站，eBay开始要求某些eBay类别中的某些产品与eBay目录产品相关联。有关此要求的详细信息，请参阅中的基于产品的购物体验手册主题销售集成指南。为了找到eBay目录产品匹配，ePID值始终优先于其他产品标识符，因为一个GTIN值可能与多个eBay目录产品相关联，如果找到多个产品，产品详细信息将不被Inventory Item对象选中。许多易趣类别不要求列表与易趣目录产品相关联，但需要至少一个产品标识符（GTIN或品牌/ MPN对）。要发现易趣类别需要或支持的产品标识符，请使用Trading API中的 GetCategoryFeatures调用。在呼叫请求中，包括四个 FeatureID字段并将这些字段中的值设置为EANEnabled，ISBNEnabled，UPCEnabled和BrandMPNIdentifierEnabled。在呼叫响应中，在“ 类别”节点下查找这些相同的字段名称。在EANEnabled，ISBNEnabled，UPCEnabled字段中返回的值将是Enabled（支持GTIN类型但不是必需的），Required（必须为库存项目提供GTIN类型），或者Disabled（类别不支持GTIN类型）。该BrandMPNIdentifierEnabled是一个布尔字段和true值表示，卖方必须提供品牌和MPN值。理想情况下，如果卖方需要/支持GTIN类型或品牌/ MPN对，则应为库存项目提供这些产品标识符。在某些情况下，可能需要产品标识符类型，但不知道/适用于产品。如果是这种情况，卖方仍必须在库存项目记录中包含相应的字段，但是传入默认文本字符串。此文本字符串可能因站点而异，因此卖家应使用Trading API 的GeteBayDetails调用来获取此字符串值。在GeteBayDetails调用中，卖方应包含一个DetailName字段，其值设置为ProductDetails。在通话响应中，卖家可以看到默认的字符串值ProductDetails.ProductIdentifierUnavailableText字段。如果产品ID未知或不适用，卖方将在一个或多个产品标识符字段（ean，isbn，upc或mpn）中使用此值。此容器最初不是必需的，但在库存项目可以作为要约发布之前和/或如果正在更新库存项目并且该库存项目的产品数据已存在之前，则需要此容器。始终为getInventoryItem，bulkGetInventoryItem和getInventoryItems中的已发布商品返回此容器 调用，因为必须为已发布的商品定义商品数据，但对于未发布的库存商品，只有在为库存商品定义了商品详细信息时才会返回此容器。发生：有条件的</td>
</tr>
<tr>
<td>inventoryItems.product.aspects</td>
<td>array of string</td>
<td>这是一组特定于项目的对，提供有关产品的更多信息，并可能使买家更容易找到。要查看特定易趣类别的必需/推荐产品方面/项目细节名称（和相应值），卖家可以使用交易API 的GetCategorySpecifics调用。或者，卖家可以在同一类别的eBay.com上查看类似的商品，以了解其他卖家正在使用的产品方面/商品细节。卖家还必须指定一个eBay的产品ID（EPID）或可选地，通过在相应的领域全球贸易项目代码（GTIN）的期权产品容器试图在易趣目录中找到产品匹配。如果根据ePID或GTIN值找到匹配项，则为新建/更新的库存项目将自动获取为eBay目录产品定义的产品方面。下面是手动输入项目细节时使用的正确JSON语法的示例："aspects": {"Brand": ["GoPro"],"Storage Type": ["Removable"]}请注意，将成为库存项目组和多变量列表一部分的库存项目应具有为库存项目组定义的相同属性。如果为库存物料定义了一个或多个物料特定对，则将返回此容器。Aspect Name的最大长度：40 Aspect值的最大长度：50;发生：有条件的</td>
</tr>
<tr>
<td>inventoryItems.product.brand</td>
<td>string</td>
<td>该产品的品牌。该字段通常与mpn字段配对，以通过制造部件号识别特定产品。如果易趣类别需要制造商部件号（MPN）值，则有条件地需要此字段。如果eBay能够在提供eBay产品ID（ePID）或GTIN值（UPC，ISBN或EAN）时在eBay目录中找到产品匹配，则该eBay目录产品的所有产品详细信息均由库存项目选取如果createOrUpdateInventoryItem调用成功，则记录（包括品牌）。如果为库存物料定义，则返回此字段。如果品牌通过createOrReplaceInventoryItem中的aspects数组作为项特定名称 - 值对传入打电话，这个价值也被品牌领域所吸引。最大长度：65;发生：有条件的</td>
</tr>
<tr>
<td>inventoryItems.product.description</td>
<td>string</td>
<td>产品说明。可以使用createOrReplaceInventoryItem调用添加或修改现有库存项的描述。如果卖方指定了易趣产品ID（ePID）或全球贸易项目编号（GTIN），并且易趣能够在易趣目录中找到匹配的产品，则会自动填充库存项目的描述。请注意，此字段是可选的，但建议使用。如果在创建和发布单变体商品时省略了listingDescription字段，则将使用此字段中的文本。如果库存项目的product.description字段和商品的listingDescription字段都不存在，则publishOffer电话会失败。如果库存项目将是库存项目组/多变量列表的一部分，则该字段应该用于指定相应的产品变体如何不同（例如，这是衬衫的绿色，超大版本）。但是，对于库存项目组，库存项目组的说明字段中的文本将成为实际eBay列表的列表描述，而不是此字段中的文本。支持基本HTML标记，包括以下标记：<code><b><strong><br><ol><ul><li></code>表标签包括<code><table>，<tr>，<td>，<th>，<thead>，<tfoot>，<tbody>，<caption>，<colgroup>和<col></code>卖家不能在其列表说明中使用任何有效内容。活动内容包括通过JavaScript，Flash，插件或表单操作的动画或视频。如果为库存物料定义，则返回此字段。如果在创建/修改库存项目并且在易趣目录中找到产品匹配时传入了其中一种GTIN类型（例如UPC），则产品描述是从目录产品中获取的详细信息之一。最大长度：4000;发生：有条件的</td>
</tr>
<tr>
<td>inventoryItems.product.imageUrls</td>
<td>array of string</td>
<td>用于产品图像的一个或多个链接的数组。URL必须使用“HTTPS”协议。图像可以由卖家自行托管，或者卖家可以使用Trading API 的UploadSiteHostedPictures调用将图像上传到eBay图片服务器。如果成功，UploadSiteHostedPictures调用的响应将包含eBay图片服务器上图像的完整URL。这是将通过imageUrls数组传递的URL 。在发布商品之前，库存商品必须至少存在一个图像。大多数eBay网站免费支持多达12张图片，eBay Motors列表最多可支持24张图片。如果卖家指定了易趣产品ID（ePID）或全球贸易项目编号（GTIN），并且易趣能够在易趣目录中找到匹配的产品，则可以自动为库存项目填充产品库存图像的链接。对于作为已发布报价的一部分的库存项目，将始终返回此容器，因为已发布的报价始终至少包含一张图片，但只有在为不属于已发布报价的库存项目定义的情况下才会返回此容器。 发生：有条件的</td>
</tr>
<tr>
<td>inventoryItems.product.mpn</td>
<td>string</td>
<td>产品的制造商部件号（MPN）。该字段与品牌字段配对以识别产品。一些易趣类别需要MPN值。Trading API 的GetCategorySpecifics调用可用于查看类别是否需要MPN。如果卖方指定了eBay产品ID（ePID）或全球贸易项目编号（GTIN），并且eBay能够在eBay目录中找到匹配的产品，则可以自动为库存项目填充产品的MPN值。如果为库存物料定义，则返回此字段。如果MPN作为特定于项目的名称 - 值对通过createOrReplaceInventoryItem调用中的aspects数组传递，则该值也由mpn拾取领域。最大长度：65;发生：有条件的</td>
</tr>
<tr>
<td>inventoryItems.product.subtitle</td>
<td>string</td>
<td>字幕是可选的列表功能，允许卖家提供有关产品的更多信息，可能包括可能有助于搜索结果的关键字。如果使用字幕，将向卖家收取额外的上市费用。有关在美国网站上使用列表字幕的详细信息，请参阅向列表帮助页面添加字幕。可以使用createOrReplaceInventoryItem调用添加，修改或删除现有库存项目的副标题。请注意，对于将成为库存项目组一部分的每个库存项目，应使用相同的字幕文本，并最终成为多变体列表中的一个产品变体。仅当为库存项目设置时，才会返回此字段。最大长度：55;出现：可选</td>
</tr>
<tr>
<td>inventoryItems.product.title</td>
<td>string</td>
<td>可以使用createOrReplaceInventoryItem调用添加或修改库存项目的标题。虽然不是立即需要，但在发布库存项目的报价之前将需要标题。如果卖方指定了易趣产品ID（ePID）或全球贸易项目编号（GTIN），并且易趣能够在易趣目录中找到匹配的产品，则会自动填充库存项目的标题。如果库存项目将成为单一变更要约的一部分，并且该列表不是基于产品的列表，则此字段中的文本将成为已发布要约的实际列表标题。但是，如果库存项目将成为多变量要约的一部分，则标题中的文本相反，库存物品组实体的字段实际上将成为已发布商品的商品标题，尽管仍可以为库存商品提供商品名称，它实际上将成为变体的标题。对于作为已发布要约的一部分的库存项，将始终返回此字段，因为已发布的要约将始终具有列表标题，但仅当为不属于已公布要约的库存项目定义时，才会返回此字段。最大长度：80;发生：有条件的</td>
</tr>
<tr>
<td>inventoryItems.product.isbn</td>
<td>array of string</td>
<td>产品的国际标准书号（ISBN）值。虽然在尝试在易趣目录中查找产品匹配时首选ePID值，但此字段也可用于尝试在易趣目录中查找产品匹配。如果在易趣目录中找到产品匹配，则库存项目会自动填充可用的产品详细信息，例如标题，产品描述，产品方面（包括指定的ISBN值）以及指向任何库存图像的链接。目录产品。如果为库存物料定义，则返回此字段。如果ISBN通过createOrReplaceInventoryItem调用中的aspects数组作为项特定名称 - 值对传入，则isbn也会获取此值 领域。出现：可选</td>
</tr>
<tr>
<td>inventoryItems.product.upc</td>
<td>array of string</td>
<td>产品的通用产品代码（UPC）值。虽然在尝试在易趣目录中查找产品匹配时首选ePID值，但此字段也可用于尝试在易趣目录中查找产品匹配。如果在易趣目录中找到产品匹配，则库存项目会自动填充可用的产品详细信息，例如标题，产品描述，产品方面（包括指定的UPC值）以及指向任何库存图像的链接。目录产品。如果为库存物料定义，则返回此字段。如果通过createOrReplaceInventoryItem调用中的aspects数组将UPC作为项特定的名称 - 值对传入，则upc字段也会拾取此值。出现：可选</td>
</tr>
<tr>
<td>inventoryItems.product.ean</td>
<td>array of string</td>
<td>产品的欧洲产品编号/国际产品编号（EAN）。虽然在尝试在易趣目录中查找产品匹配时首选ePID值，但此字段也可用于尝试在易趣目录中查找产品匹配。如果在易趣目录中找到产品匹配，则库存项目会自动填充可用的产品详细信息，例如标题，产品描述，产品方面（包括指定的EAN值）以及指向任何库存图像的链接。目录产品。如果为库存物料定义，则返回此字段。如果通过createOrReplaceInventoryItem调用中的aspects数组将EAN作为项特定的名称 - 值对传入，则该值也会被ean拾取 领域。出现：可选</td>
</tr>
<tr>
<td>inventoryItems.product.epid</td>
<td>string</td>
<td>产品的易趣产品标识符（ePID）。此字段可用于直接识别易趣目录产品。根据其指定的ePID值，易趣将在易趣目录中搜索产品，如果找到匹配项，库存项目将自动填充可用的产品详细信息，例如产品标题，产品描述，产品方面和链接目录产品存在的任何库存图像。如果为库存物料定义，则返回此字段。注意：对于美国，英国，CA（英语）和AU网站，eBay开始要求某些eBay类别中的某些产品与eBay目录产品相关联。有关此要求的详细信息，请参阅中的基于产品的购物体验手册主题销售集成指南。为了找到eBay目录产品匹配，ePID值始终优先于其他产品标识符，因为一个GTIN值可能与多个eBay目录产品相关联，如果找到多个产品，产品详细信息将不被Inventory Item对象选中。出现：可选</td>
</tr>
<tr>
<td>inventoryItems.sku</td>
<td>string</td>
<td>卖方定义的库存物料的库存单位（SKU）。卖方应为其销售的每种产品提供唯一的SKU值。发生：有条件的</td>
</tr>
<tr>
<td>inventoryItems.locale</td>
<td>LocaleEnum</td>
<td>该字段仅供将来使用。发生：有条件的</td>
</tr>
<tr>
<td>inventoryItems.groupIds</td>
<td>array of string</td>
<td>这将返回此库存项目与MSKU列表相关联的groupid-id发生：有条件的</td>
</tr>
<tr>
<td>inventoryItems.inventoryItemGroupKeys</td>
<td>array of string</td>
<td>这将返回此库存项目与MSKU列表相关联的inventoryItemGroupKeys发生：有条件的</td>
</tr>
<tr>
<td>next</td>
<td>string</td>
<td>这是库存物品下一页的URL。只有在需要查看其他库存物料时才会返回此字段。发生：有条件的</td>
</tr>
<tr>
<td>limit</td>
<td>integer</td>
<td>此整数值是将在每个结果页面上显示的库存项目数。发生：总是</td>
</tr>
<tr>
<td>prev</td>
<td>string</td>
<td>这是库存物料上一页的URL。只有在以前要查看的库存项目时才会返回此字段。发生：有条件的</td>
</tr>
<tr>
<td>size</td>
<td>integer</td>
<td>此整数值表示可用结果的总页数。此数字取决于可供查看的库存项目总数以及限制值。发生：总是</td>
</tr>
<tr>
<td>total</td>
<td>integer</td>
<td>此整数值是卖方帐户中存在的库存项目总数。根据此数字和限额值，卖方可能必须切换多个页面才能查看所有库存项目。发生：总是</td>
</tr>
</tbody>
</table>
<p><strong>HTTP状态代码</strong>
此调用可以返回以下HTTP状态代码之一。状态代码的概述，请参阅<a href="https://developer.ebay.com/api-docs/static/rest-response-components.html#HTTP" title="HTTP状态代码">HTTP状态代码</a>在使用eBay RESTful API中。</p>
<table>
<thead>
<tr>
<th>状态码</th>
<th>含义</th>
</tr>
</thead>
<tbody>
<tr>
<td>200</td>
<td>成功</td>
</tr>
<tr>
<td>400</td>
<td>错误的请求</td>
</tr>
<tr>
<td>404</td>
<td>未找到</td>
</tr>
<tr>
<td>500</td>
<td>内部服务器错误</td>
</tr>
</tbody>
</table>
<p><strong>错误代码</strong>
有关错误的更多信息以及其他常见错误的代码，请参阅<a href="https://developer.ebay.com/api-docs/static/handling-error-messages.html" title="处理错误">处理错误</a>。</p>
<table>
<thead>
<tr>
<th>Code</th>
<th>Domain</th>
<th>Category</th>
<th>Meaning</th>
</tr>
</thead>
<tbody>
<tr>
<td>25001</td>
<td>API_INVENTORY</td>
<td>APPLICATION</td>
<td>发生了系统错误。{附加信息}</td>
</tr>
<tr>
<td>25706</td>
<td>API_INVENTORY</td>
<td>REQUEST</td>
<td>您提供了无效的分页值。{附加信息}。</td>
</tr>
<tr>
<td>25709</td>
<td>API_INVENTORY</td>
<td>REQUEST</td>
<td>{fieldName}的值无效。</td>
</tr>
</tbody>
</table>
<p><strong>示例</strong>
新的API调用？请参阅拨打电话。</p>
<p>注意：这些样本中的标识符（例如订单ID或用户ID）和个人数据可能是匿名的，或者在eBay上可能不再有效。如有必要，请在您的请求中替换当前相关的eBay数据。</p>
<p>示例1：检索多个库存物料
此调用将检索与卖方的帐户关联的所有库存项目。
<strong>input</strong>
通过将limit查询参数设置为2和偏移查询参数to 0，卖方希望将每页返回的库存项目数限制为两个，并且希望查看记录的第一页。
<strong>GET</strong>
<a href="https://api.ebay.com/sell/inventory/v1/inventory_item?limit=2&offset=0">https://api.ebay.com/sell/inventory/v1/inventory_item?limit=2&offset=0</a>
<strong>output</strong>
与卖方帐户关联的前两个库存项目记录将在响应中返回。这些库存商品的SKU值为GP-Cam-01和GP-Cam-02。这两个库存物品都处于新的状态，并且两者都只能通过标准的船到户履行来实现。 </p>
<p>在下一页字段表示偏移和限制值，将需要在未来使用getAllInventoryItems调用接收下一组的库存项目记录。 </p>
<p>将总价值表示有一个总的卖家的账户相关联的100点存货项目的记录，以及大小值表示由于当前entriesPerPage值为2 ，因此总共有50页库存项目记录。</p>
<pre><code>{
"href": "/?offset=0&limit=2",
"limit": "2",
"inventoryItems": [
{
"sku": "GP-Cam-01",
"availability": {
"shipToLocationAvailability": {
"quantity": 50
}
},
"condition": "NEW",
"product": {
"title": "GoPro Hero4 Helmet Cam",
"description": "New GoPro Hero4 Helmet Cam. Unopened box.",
"aspects": {
"Brand": [
"GoPro"
],
"Type": [
"Helmet/Action"
],
"Storage Type": [
"Removable"
],
"Recording Definition": [
"High Definition"
],
"Media Format": [
"Flash Drive (SSD)"
],
"Optical Zoom": [
"10x"
]
},
"imageUrls": [
"http://i.ebayimg.com/images/i/182196556219-0-1/s-l1000.jpg",
"http://i.ebayimg.com/images/i/182196556219-0-1/s-l1001.jpg",
"http://i.ebayimg.com/images/i/182196556219-0-1/s-l1002.jpg"
]
}
},
{
"sku": "GP-Cam-02",
"availability": {
"shipToLocationAvailability": {
"quantity": 50
}
},
"condition": "NEW",
"product": {
"title": "GoPro Hero3 Helmet Cam",
"description": "New GoPro Hero3 Helmet Cam. Unopened box.",
"aspects": {
"Brand": [
"GoPro"
],
"Type": [
"Helmet/Action"
],
"Storage Type": [
"Removable"
],
"Recording Definition": [
"High Definition"
],
"Media Format": [
"Flash Drive (SSD)"
],
"Optical Zoom": [
"5x"
]
},
"imageUrls": [
"http://i.ebayimg.com/images/i/182196556222-0-1/s-l1000.jpg",
"http://i.ebayimg.com/images/i/182196556222-0-1/s-l1001.jpg",
"http://i.ebayimg.com/images/i/182196556222-0-1/s-l1002.jpg"
]
}
}
],
"next": "/?offset=2&limit=2",
"size": 50,
"total": 100
}</code></pre>