如何获取产品/服务的状态？

项目
11/13/2024

在目录或商店中添加或更新产品/服务时，产品/服务将在进行编辑评审之前进行初始验证。此过程最多可能需要 36 小时。若要查看产品/服务是否通过了评审过程，请使用 “状态” 资源。

注意

若要获取其状态设置为“已批准”或“警告”的产品列表，请参阅获取产品/服务的状态。

下面是用于获取 Status 资源的基 URI。

https://content.api.bingads.microsoft.com/shopping/v9.1/bmc/

若要获取产品/服务的状态，请将以下模板追加到基本 URI。

{bmcMerchantId}/catalogs/{catalogId}/status

设置为 {bmcMerchantId} BMC 商店 ID，并设置为 {catalogId} 包含要获取其状态的产品/服务目录的 ID。

每个 HTTP 请求都必须包含用户的 OAuth 访问令牌和开发人员令牌。若要指定用户的访问令牌，请设置 AuthenticationToken 标头。若要指定开发人员令牌，请设置 DeveloperToken 标头。

如果代表其他客户管理目录，则必须设置：

要管理其商店的客户的客户 ID 的 CustomerId 标头。
你管理的任何客户帐户的帐户 ID 的 CustomerAccountId 标头 (与哪个托管帐户) 无关紧要。

无需指定访问令牌或开发人员令牌即可下载报表;只需指定它们即可获取状态。

默认情况下，内容 API 使用 JSON 对象来表示状态。若要使用 XML，请将 alt 查询参数设置为 XML。

将 HTTP GET 请求发送到生成的 URL。响应包含一个 Status 对象，该对象包含过去 30 天内通过或未通过评审过程的套餐数。如果产品/服务未通过评审，则 Status 资源包含一个 URL，可用于下载描述产品/服务失败原因的报告。

下面显示了一个示例 Status 对象。

{
  "catalogId": 12345,
  "publishedCount": 80,
  "rejectedCount": 6,
  "rejectionReportUrl": "https://merchantcenter.bingads.microsoft.com/api/Public/DownloadFeedReport?token=..."
}

报告标识失败但未提供时间戳或版本控制信息的产品/服务，可用于标识报表引用的更新。例如，如果你在 2 天前上传了产品/服务，然后在昨天更新了产品/服务，则你将无法知道该问题是与 2 天前上传的版本还是昨天上传的版本有关。但是，你可能能够在报表的“产品/服务片段”列中使用项的属性来推断所报告的项版本。

由于报表文件是 ZIP 压缩的，因此必须解压缩该文件才能读取报表。系统可以存储的报表数量没有限制：但是，未定义存储报表的时间长度。有关报表内容的信息，请参阅报表格式。

根据与目录关联的活动，报表可能很大。不应再频繁地请求报告。建议的间隔不超过每小时一次。

有关演示如何获取目录状态和下载报表的代码示例，请参阅下载目录状态报告。

下面显示了一个示例报表。

"Catalog Name","Catalog Id","Store Id","Upload Time"
"Default Catalog","1234","5678","04/21/2016 01:59:06"

"Item Id","Message","Type","Values","Offer Snippet"
"SKU1234","The product URL should be a sub-path of the store's domain. ","Error","",";eBay Motors>Parts & Accessories>Car & Truck Parts>Brakes>Brake Hoses>;http://contentapis.cloudapp.net/sku123;http://i.ebayimg.com/00/s/NzY4WDI5Mg==/z/irkAAOxyB9RS14Rj/$_1.JPG?set_id=880000500F;24.25;-1;;"
"SKU5678","The product URL should be a sub-path of the store's domain. ","Error","",";;http://www.contoso.com/;https://tse3.mm.bing.net/th?id=Ma8674a23cc755995efecf822b3836f07o0&pid=Api;1205;-1;;"
"SKU0987","The product URL should be a sub-path of the store's domain. ","Error","",";Apparel & Accessories > Clothing > Outerwear;http://v-vagancclaimedapi.cloudapp.net/;http://google.com/;1;-1;;"
"SKU6543","The price field is required.","Error","","Mens T-shirt;N/A;http://www.contoso.com/;https://tse3.mm.bing.net/th?id=OIP.Ma8674a23cc755995efecf822b3836f07o0&pid=Api;N/A"
"SKU2435","The offer expiration date is in the past.","Error","","full product title;Apparel & Accessories > Clothing > Outerwear;http://v-vagancclaimedapi.cloudapp.net/;http://google.com/;1.00"
"SKU8675","The price field is required.","Error","","Mens T-shirt;N/A;http://www.contoso.com/;https://tse3.mm.bing.net/th?id=OIP.Ma8674a23cc755995efecf822b3836f07o0&pid=Api;N/A"

通过

如何获取产品/服务的状态？

反馈

其他资源