withdrawOfferByInventoryItemGroup
<p><strong>POST</strong> /offer/withdraw_by_inventory_item_group</p>
<p>此调用用于结束与指定库存项目组关联的多变量易趣物品列表。此调用仅结束与库存项目组关联的多变量eBay列表，但不会删除库存项目组对象。同样，此调用也不会删除与库存项目组关联的任何商品，而是所有这些商品都会进入未发布状态。如果卖方想要重新使用多变量eBay列表，他们可以使用publishOfferByInventoryItemGroup方法。</p>
<h5>Input</h5>
<h6>Resource URI (production)</h6>
<p>POST <a href="https://api.ebay.com/sell/inventory/v1/offer/withdraw_by_inventory_item_group">https://api.ebay.com/sell/inventory/v1/offer/withdraw_by_inventory_item_group</a></p>
<h6>URI parameters</h6>
<p>This method has no URI parameters.</p>
<h6>HTTP request headers</h6>
<p>对eBay REST操作发出的所有请求都要求您提供授权 HTTP标头以进行身份验证授权。
此方法具有下面列出的其他请求标头要求。请参阅<a href="http://developer.ebay.com/devzone/rest/ebay-rest/content/rest-request-components.html#HTTP" title="HTTP请求标头">HTTP请求标头</a>- 打开其余请求组件页面以获取详细信息</p>
<h6>OAuth范围</h6>
<p>此请求需要使用<a href="https://developer.ebay.com/api-docs/static/oauth-authorization-code-grant.html" title="授权代码授权">授权代码授权</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>有关详细信息，请参阅<a href="https://developer.ebay.com/api-docs/static/oauth-tokens.html" title="OAuth访问令牌">OAuth访问令牌</a>。</p>
<h6>Request payload</h6>
<pre><code class="language-json">{
"inventoryItemGroupKey": "string",
"marketplaceId": "MarketplaceEnum : [EBAY_US,EBAY_MOTORS,EBAY_CA,EBAY_GB,EBAY_AU,EBAY_AT,EBAY_BE_FR,EBAY_FR,EBAY_DE,EBAY_IT,EBAY_BE_NL,EBAY_NL,EBAY_ES,EBAY_CH,EBAY_TW,EBAY_CZ,EBAY_DK,EBAY_FI,EBAY_GR,EBAY_HK,EBAY_HU,EBAY_IN,EBAY_ID,EBAY_IE,EBAY_IL,EBAY_MY,EBAY_NZ,EBAY_NO,EBAY_PH,EBAY_PL,EBAY_PT,EBAY_PR,EBAY_RU,EBAY_SG,EBAY_ZA,EBAY_SE,EBAY_TH,EBAY_VN,EBAY_CN,EBAY_PE,EBAY_CA_FR,EBAY_JP]"
}</code></pre>
<table>
<thead>
<tr>
<th>Input container/field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>inventoryItemGroupKey</td>
<td>string</td>
<td>这是库存项目组的唯一标识符。如果publishByInventoryItemGroup调用成功，则与此库存项目组关联的所有未发布的商品将作为多变体列表发布。所述inventoryItemGroupKey一旦创建库存项目组标识符被自动被eBay生成。要检索inventoryItemGroupKey值，可以使用getInventoryItem调用来检索已知要在要发布的库存项目组中的库存项目，然后在该调用的响应中查找groupIds容器下的库存项目组标识符。发生：可选</td>
</tr>
<tr>
<td>marketplaceId</td>
<td>MarketplaceEnum</td>
<td>这是将发布多变体列表的eBay网站的唯一标识符。该marketPlaceId枚举值被发现在MarketplaceIdEnum。发生：可选</td>
</tr>
</tbody>
</table>
<h5>Output</h5>
<h6>HTTP response headers</h6>
<p>This call has no response headers.</p>
<h6>Response payload</h6>
<p>This call has no payload.</p>
<h6>Response fields</h6>
<p>This call has no field definitions.</p>
<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>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>状态码</th>
<th>域</th>
<th>类别</th>
<th>含义</th>
</tr>
</thead>
<tbody>
<tr>
<td>25001</td>
<td>API_INVENTORY</td>
<td>应用</td>
<td>发生了系统错误。{附加信息}</td>
</tr>
<tr>
<td>25725</td>
<td>API_INVENTORY</td>
<td>应用</td>
<td>没有找到该优惠</td>
</tr>
</tbody>
</table>
<h6>示例</h6>
<p>新的API调用？请参阅<a href="https://developer.ebay.com/api-docs/static/make-a-call.html" title="拨打电话">拨打电话</a>。</p>
<p>注意：这些样本中的标识符（例如订单ID或用户ID）和个人数据可能是匿名的，或者在eBay上可能不再有效。如有必要，请在您的请求中替换当前相关的eBay数据。</p>
<h6>示例1：按库存项目组撤回优惠</h6>
<p>此调用将结束与库存项目组关联的多变量eBay列表。但是，Inventory Item Group和Offer对象（与组关联）仍将保留。Offer对象将从已发布状态转换为未发布状态。如果卖家想要重新列出多变量eBay列表，他们可以使用publishOfferByInventoryItemGroup调用。</p>
<h6>Input</h6>
<p>与要撤消的库存项目组（多变量eBay列表所基于的）相关联 的inventoryItemGroupKey值被传递到请求有效负载中。还需要eBay市场的标识符。</p>
<p><strong>POST</strong>
<a href="https://api.ebay.com/sell/inventory/v1/offer/withdraw_by_inventory_item_group">https://api.ebay.com/sell/inventory/v1/offer/withdraw_by_inventory_item_group</a></p>
<pre><code class="language-json">{
"inventoryItemGroupKey": "09062017251_GRP",
"marketplaceId": "EBAY_US"
}</code></pre>
<h6>Output</h6>
<p>此调用没有响应有效负载，但是204对于结束多变量列表的成功调用，将返回HTTP状态代码值。</p>