bulkPublishOffer
<p><strong>POST</strong> / bulk_publish_offer</p>
<p>此调用用于将未发布的商品（最多25个）转换为已发布的商品或实时易趣商品列表。publlish的每个商品的唯一标识符（offerId）被传递到请求有效载荷中。有些未发布的优惠可能会成功创建到eBay列表中，但其他优惠可能会失败。响应有效负载将显示传递到请求有效负载的每个offerId值的结果。对于发布了一个或多个问题的商品，将返回错误和警告容器。</p>
<p>对于那些喜欢每次调用发布一个商品的人，可以使用publishOffer方法。在多变量列表的情况下，应该使用publishOfferByInventoryItemGroup调用，因为此调用会将与库存项目组关联的所有未发布的商品转换为多变体商品列表。</p>
<h5>Input</h5>
<h6>Resource URI (production)</h6>
<p><strong>POST</strong> <a href="https://api.ebay.com/sell/inventory/v1/bulk_publish_offer">https://api.ebay.com/sell/inventory/v1/bulk_publish_offer</a></p>
<h6>URI parameters</h6>
<p>This method has no URI parameters.</p>
<h6>HTTP request headers</h6>
<p>对eBay REST操作发出的所有请求都要求您提供授权 HTTP标头以进行身份验证授权。
此外，此方法要求您包含Content-Type标头，其值应设置为“ application / json ”。请参阅<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">{
"requests": [
{
"offerId": "string"
}
]
}</code></pre>
<h6>Request fields</h6>
<table>
<thead>
<tr>
<th>Input container/field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>requests</td>
<td>array of OfferKeyWithId</td>
<td>此容器用于传递要发布的商品数组。使用一个bulkPublishOffer方法最多可以发布25个商品。发生：必需</td>
</tr>
<tr>
<td>requests.offerId</td>
<td>string</td>
<td>未检索报价的唯一标识符，将检索预期的列表费用。一到250个OFFERID值可以到传递报价容器一个getListingFees调用。如果传递了表示已发布商品的offerId值，则会发生错误。发生：必需</td>
</tr>
</tbody>
</table>
<h5>Output</h5>
<h6>HTTP response headers</h6>
<p>This call has no response headers.</p>
<h6>Response payload</h6>
<pre><code class="language-json">{
"responses": [
{
"statusCode": "integer",
"errors": [
{
"errorId": "integer",
"domain": "string",
"subdomain": "string",
"category": "string",
"message": "string",
"parameters": [
{
"value": "string",
"name": "string"
}
],
"longMessage": "string",
"inputRefIds": [
"string"
],
"outputRefIds": [
"string"
]
}
],
"warnings": [
{
"errorId": "integer",
"domain": "string",
"subdomain": "string",
"category": "string",
"message": "string",
"parameters": [
{
"value": "string",
"name": "string"
}
],
"longMessage": "string",
"inputRefIds": [
"string"
],
"outputRefIds": [
"string"
]
}
],
"offerId": "string",
"listingId": "string"
}
]
}</code></pre>
<h6>Response fields</h6>
<table>
<thead>
<tr>
<th>Output container/field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>responses</td>
<td>array of PriceQuantityResponse</td>
<td>此容器将返回正在更新的每个商品/库存商品的HTTP状态代码，商品ID和SKU值，以及在尝试更新这些商品/库存商品时触发任何错误或警告时的错误和/或警告容器。发生：总是</td>
</tr>
<tr>
<td>responses.statusCode</td>
<td>integer</td>
<td>此容器中返回的值将指示尝试更新商品的价格和/或数量（在相应的offerId字段中指定）或尝试更新库存的总“发货到库”数量的状态item（在相应的sku字段中指定）。要成功更新商品或库存商品记录，200将在此字段中显示值。对于不成功的尝试，400将在此字段中显示值。发生：总是</td>
</tr>
<tr>
<td>responses.errors</td>
<td>array of ErrorDetailV3</td>
<td>如果有一个或多个与商品或库存商品记录更新相关的错误，则将返回此容器。发生：有条件的</td>
</tr>
<tr>
<td>responses.errors.errorId</td>
<td>integer</td>
<td>唯一代码，用于标识发生的特定错误或警告。您的应用程序可以在自定义错误处理算法中使用错误代码作为标识符。发生：有条件的</td>
</tr>
<tr>
<td>responses.errors.domain</td>
<td>string</td>
<td>发生错误或警告的域的名称。发生：有条件的</td>
</tr>
<tr>
<td>responses.errors.subdomain</td>
<td>string</td>
<td>发生错误或警告的子域的名称。发生：有条件的</td>
</tr>
<tr>
<td>responses.errors.category</td>
<td>string</td>
<td>此字符串值表示错误类别。有三类错误：请求错误，应用程序错误和系统错误。发生：有条件的</td>
</tr>
<tr>
<td>responses.errors.message</td>
<td>string</td>
<td>导致错误或警告的条件的描述。发生：有条件的</td>
</tr>
<tr>
<td>responses.errors.parameters</td>
<td>array of ErrorParameterV3</td>
<td>各种警告和错误消息返回一个或多个变量，这些变量包含有关错误或警告的上下文信息。这通常是触发错误或警告的字段或值。发生：有条件的</td>
</tr>
<tr>
<td>responses.errors.parameters.value</td>
<td>string</td>
<td>这是为name字段中指定的元素传递的实际值。发生：有条件的</td>
</tr>
<tr>
<td>responses.errors.parameters.name</td>
<td>string</td>
<td>这是导致调用请求出现问题的输入字段的名称。发生：有条件的</td>
</tr>
<tr>
<td>responses.errors.longMessage</td>
<td>string</td>
<td>导致错误或警告的条件的详细说明，以及有关如何解决问题的信息。发生：有条件的</td>
</tr>
<tr>
<td>responses.errors.inputRefIds</td>
<td>array of string</td>
<td>一个或多个引用ID的数组，用于标识与错误或警告关联最密切的特定请求元素（如果有）。发生：有条件的</td>
</tr>
<tr>
<td>responses.errors.outputRefIds</td>
<td>array of string</td>
<td>一个或多个引用ID的数组，用于标识与错误或警告关系最密切的特定响应元素（如果有）。发生：有条件的</td>
</tr>
<tr>
<td>responses.warnings</td>
<td>array of ErrorDetailV3</td>
<td>如果有一个或多个警告与商品或库存商品记录的更新相关联，则将返回此容器。发生：有条件的</td>
</tr>
<tr>
<td>responses.warnings.errorId</td>
<td>integer</td>
<td>唯一代码，用于标识发生的特定错误或警告。您的应用程序可以在自定义错误处理算法中使用错误代码作为标识符。发生：有条件的</td>
</tr>
<tr>
<td>responses.warnings.domain</td>
<td>string</td>
<td>发生错误或警告的域的名称。发生：有条件的</td>
</tr>
<tr>
<td>responses.warnings.subdomain</td>
<td>string</td>
<td>发生错误或警告的子域的名称。发生：有条件的</td>
</tr>
<tr>
<td>responses.warnings.category</td>
<td>string</td>
<td>此字符串值表示错误类别。有三类错误：请求错误，应用程序错误和系统错误。发生：有条件的</td>
</tr>
<tr>
<td>responses.warnings.message</td>
<td>string</td>
<td>导致错误或警告的条件的描述。发生：有条件的</td>
</tr>
<tr>
<td>responses.warnings.parameters</td>
<td>array of ErrorParameterV3</td>
<td>各种警告和错误消息返回一个或多个变量，这些变量包含有关错误或警告的上下文信息。这通常是触发错误或警告的字段或值。发生：有条件的</td>
</tr>
<tr>
<td>responses.warnings.parameters.value</td>
<td>string</td>
<td>这是为name字段中指定的元素传递的实际值。发生：有条件的</td>
</tr>
<tr>
<td>responses.warnings.parameters.name</td>
<td>string</td>
<td>这是导致调用请求出现问题的输入字段的名称。发生：有条件的</td>
</tr>
<tr>
<td>responses.warnings.longMessage</td>
<td>string</td>
<td>导致错误或警告的条件的详细说明，以及有关如何解决问题的信息。发生：有条件的</td>
</tr>
<tr>
<td>responses.warnings.inputRefIds</td>
<td>array of string</td>
<td>一个或多个引用ID的数组，用于标识与错误或警告关联最密切的特定请求元素（如果有）。发生：有条件的</td>
</tr>
<tr>
<td>responses.warnings.outputRefIds</td>
<td>array of string</td>
<td>一个或多个引用ID的数组，用于标识与错误或警告关系最密切的特定响应元素（如果有）。发生：有条件的</td>
</tr>
<tr>
<td>responses.offerId</td>
<td>string</td>
<td>卖方发布（或试图发布）的要约的唯一标识符。发生：总是</td>
</tr>
<tr>
<td>responses.listingId</td>
<td>string</td>
<td>新创建的eBay列表的唯一标识符。仅当卖家成功发布要约并创建新的易趣列表时，才会返回此字段。发生：有条件的</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>207</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>25002</td>
<td>API_INVENTORY</td>
<td>请求</td>
<td>发生了用户错误。{附加信息}</td>
</tr>
<tr>
<td>25003</td>
<td>API_INVENTORY</td>
<td>请求</td>
<td>与库存商品相关联的易趣物品列表或未发布的商品具有无效价格。{附加信息}</td>
</tr>
<tr>
<td>25004</td>
<td>API_INVENTORY</td>
<td>请求</td>
<td>与库存项目关联的易趣物品列表或未发布的要约具有无效数量。{附加信息}</td>
</tr>
<tr>
<td>25005</td>
<td>API_INVENTORY</td>
<td>请求</td>
<td>与库存项目关联的易趣物品列表或未发布的商品具有无效的类别ID。{附加信息}</td>
</tr>
<tr>
<td>25006</td>
<td>API_INVENTORY</td>
<td>请求</td>
<td>与库存项目关联的易趣物品列表或未发布的商品具有无效的列表选项。{附加信息}</td>
</tr>
<tr>
<td>25007</td>
<td>API_INVENTORY</td>
<td>请求</td>
<td>与库存项目关联的易趣物品清单或未发布的物品在相关的配送政策中包含无效数据。{附加信息}</td>
</tr>
<tr>
<td>25008</td>
<td>API_INVENTORY</td>
<td>请求</td>
<td>与库存项目关联的易趣物品列表或未发布的要约在相关的付款政策中包含无效数据。{附加信息}</td>
</tr>
<tr>
<td>25009</td>
<td>API_INVENTORY</td>
<td>请求</td>
<td>与库存项目关联的易趣物品列表或未发布的物品在相关的退货政策中包含无效数据。{附加信息}</td>
</tr>
<tr>
<td>25011</td>
<td>API_INVENTORY</td>
<td>请求</td>
<td>与库存项目关联的易趣物品列表或未发布的要约具有无效的税务信息。{附加信息}</td>
</tr>
<tr>
<td>25012</td>
<td>API_INVENTORY</td>
<td>请求</td>
<td>库存位置无效。{附加信息}</td>
</tr>
<tr>
<td>25013</td>
<td>API_INVENTORY</td>
<td>请求</td>
<td>库存物料组中的数据无效。{附加信息}</td>
</tr>
<tr>
<td>25014</td>
<td>API_INVENTORY</td>
<td>请求</td>
<td>与库存项目关联的易趣物品列表或未发布的商品具有无效图片。{附加信息}</td>
</tr>
<tr>
<td>25015</td>
<td>API_INVENTORY</td>
<td>请求</td>
<td>与库存项目相关联的易趣物品列表或未发布的商品具有无效的图片URL。{附加信息}</td>
</tr>
<tr>
<td>25016</td>
<td>API_INVENTORY</td>
<td>请求</td>
<td>{fieldName}值无效。{附加信息}</td>
</tr>
<tr>
<td>25017</td>
<td>API_INVENTORY</td>
<td>请求</td>
<td>{fieldName}丢失了。{附加信息}</td>
</tr>
<tr>
<td>25018</td>
<td>API_INVENTORY</td>
<td>请求</td>
<td>帐户信息不完整。{附加信息}</td>
</tr>
<tr>
<td>25019</td>
<td>API_INVENTORY</td>
<td>请求</td>
<td>无法修改上市。{附加信息}</td>
</tr>
<tr>
<td>25020</td>
<td>API_INVENTORY</td>
<td>请求</td>
<td>与库存商品相关联的易趣物品列表或未发布的商品具有无效的运送包裹详细信息。{附加信息}</td>
</tr>
<tr>
<td>25021</td>
<td>API_INVENTORY</td>
<td>请求</td>
<td>与库存项目相关联的易趣物品列表或未发布的物品具有无效物品条件信息。{附加信息}</td>
</tr>
<tr>
<td>25022</td>
<td>API_INVENTORY</td>
<td>请求</td>
<td>无效的属性。{}字段名</td>
</tr>
<tr>
<td>25023</td>
<td>API_INVENTORY</td>
<td>请求</td>
<td>无效的兼容性信息。{附加信息}</td>
</tr>
<tr>
<td>25025</td>
<td>API_INVENTORY</td>
<td>应用</td>
<td>不允许同时访问同一库存或库存物料组对象。请稍后再试。</td>
</tr>
<tr>
<td>25026</td>
<td>API_INVENTORY</td>
<td>请求</td>
<td>超出销售限额。{附加信息}</td>
</tr>
<tr>
<td>25601</td>
<td>API_INVENTORY</td>
<td>请求</td>
<td>{fieldName}是无效的属性。</td>
</tr>
<tr>
<td>25604</td>
<td>API_INVENTORY</td>
<td>请求</td>
<td>输入错误。{附加信息}</td>
</tr>
<tr>
<td>25709</td>
<td>API_INVENTORY</td>
<td>请求</td>
<td>{fieldName}的值无效</td>
</tr>
<tr>
<td>25713</td>
<td>API_INVENTORY</td>
<td>请求</td>
<td>此优惠不可用：{additionalInfo}。</td>
</tr>
<tr>
<td>25730</td>
<td>API_INVENTORY</td>
<td>请求</td>
<td>请求中的商品数量不能超过{additionalInfo}。</td>
</tr>
<tr>
<td>25731</td>
<td>API_INVENTORY</td>
<td>请求</td>
<td>OfferId在请求中应该是唯一的。</td>
</tr>
<tr>
<td>25732</td>
<td>API_INVENTORY</td>
<td>请求</td>
<td>无法使用此端点发布与属于变体组的SKU关联的商品。</td>
</tr>
</tbody>
</table>
<p><strong>示例</strong>
新的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：批量发布offer</h6>
<p>此示例将两个未发布的eBay优惠转换为实时eBay列表。</p>
<h6>Input</h6>
<p>将要转换为实时eBay列表的两个未发布的商品的唯一标识符（offerId）传递到请求有效负载中。
<strong>POST</strong>
<a href="https://api.ebay.com/sell/inventory/v1/bulk_publish_offer">https://api.ebay.com/sell/inventory/v1/bulk_publish_offer</a></p>
<pre><code class="language-json">{
"requests": [
{
"offerId": "5500579006"
},
{
"offerId": "5500580006"
}
]
}</code></pre>
<h6>Output</h6>
<p>如果通话成功，将创建两个新的eBay列表。如果为要约成功创建了列表，则为offerId返回statusCode值，以及eBay生成的listingId值，该值是列表的标识符（例如，项目ID）。 200</p>
<pre><code class="language-json">{
"responses": [
{
"statusCode": 200,
"offerId": "5500579006",
"listingId": "232864600421"
},
{
"statusCode": 200,
"offerId": "5500580006",
"listingId": "232864600427"
}
]
}</code></pre>