商品状态

您可以使用 productstatuses 资源查看购物商品的详细状态。

如需详细了解常见问题,请参阅产品问题

商家有责任遵守购物广告非付费商品详情政策。如果 Google 购物发现违反这些政策的内容或行为,将保留强制执行这些政策并做出适当回应的权利。

要求

您必须执行以下操作才能查看商品状态:

  • 在目标位置注册您的帐号。
  • 采用以下任一方式提供有效的国家/地区代码:
    • feedLabel 字段。
    • shipping 字段。
    • 在 Feed 级别。
    • 您帐号的运费设置。

获取商品的状态

使用 productstatuses.get 查看商品的状态。

您可以在 getlist 请求中使用 destinations 参数查看特定目标的问题。如果您未指定目标位置,则会返回所有符合条件的目标位置中的问题。

以下是一个带有可选查询参数的示例 get 请求:

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantID}/productstatuses/{productId}?destinations=Shopping&fields=productId%2Ctitle

来自 productstatuses.get 的所有响应都包含以下字段:

  • kind:值始终为 content#productStatus
  • creationDate:商品的创建日期。
  • lastUpdateDate:上次更新商品的时间。
  • googleExpirationDate:商品过期的日期。
  • productId:商品的 REST ID。
  • title:商品的名称。
  • link:商品的网址链接。
  • destinationStatuses:商品在每个目的地和国家/地区的状态。

只有在收到您的请求时,商品存在商品级问题,您才会在响应中看到 itemLevelIssues 字段。

以下是 JSON 响应示例:

{
"kind": "content#productStatus",
"productId": "online:en:US:63",
"title": "Third Product",
"link": "http://examplemenc.com/",
"destinationStatuses": [
 {
   "destination": "Shopping",
   "status": "disapproved",
   "disapprovedCountries": [
            "US", "UK"
   ]
 },
 {
   "destination": "ShoppingActions",
   "status": "disapproved",
   "disapprovedCountries": [
            "US"
   ]
 },
 {
   "destination": "SurfacesAcrossGoogle",
   "status": "disapproved",
   "disapprovedCountries": [
            "US"
   ]
 }
],
"itemLevelIssues": [
 {
  "code": "strong_id_inaccurate",
  "servability": "disapproved",
  "resolution": "merchant_action",
  "attributeName": "mpn",
  "destination": "Shopping",
  "description": "Incorrect product identifier [mpn]",
  "detail": "Use the manufacturer's product identifiers (GTIN, brand, MPN)",
  "documentation": "https://support.google.com/merchants/answer/160161",
  "applicableCountries": [
            "US", "UK"
  ]
 },
 {
  "code": "image_link_internal_error",
  "servability": "disapproved",
  "resolution": "merchant_action",
  "attributeName": "image link",
  "destination": "Shopping",
  "description": "Processing failed [image link]",
  "detail": "Wait for the product image to be crawled again (up to 3 days)",
  "documentation": "https://support.google.com/merchants/answer/6240184",
  "applicableCountries": [
            "US, UK"
  ]
 },
 {
  "code": "landing_page_error",
  "servability": "disapproved",
  "resolution": "merchant_action",
  "attributeName": "link",
  "destination": "Shopping",
  "description": "Unavailable desktop landing page",
  "detail": "Update your website or landing page URL to enable access from desktop devices",
  "documentation": "https://support.google.com/merchants/answer/6098155",
  "applicableCountries": [
            "US", "UK"
  ]
 },
 {
  "code": "missing_condition_microdata",
  "servability": "unaffected",
  "resolution": "merchant_action",
  "destination": "Shopping",
  "description": "Missing or invalid data [condition]",
  "detail": "Add valid structured data markup to your landing page",
  "documentation": "https://support.google.com/merchants/answer/6183460",
  "applicableCountries": [
            "US", "UK"
  ]
 },
 {
  "code": "mobile_landing_page_error",
  "servability": "disapproved",
  "resolution": "merchant_action",
  "attributeName": "link",
  "destination": "Shopping",
  "description": "Unavailable mobile landing page",
  "detail": "Update your website or landing page URL to enable access from mobile devices",
  "documentation": "https://support.google.com/merchants/answer/6098296",
  "applicableCountries": [
            "US", "UK"
  ]
 }
],
"creationDate": "2019-02-15T20:30:15Z",
"lastUpdateDate": "2019-02-26T16:40:11Z",
"googleExpirationDate": "2019-03-28T16:40:11Z"
}

列出所有商品状态

使用 productstatuses.list 可查看所有商品及其状态。

您可以使用以下参数优化查询:

  • destinations:要查看其状态的目标。
  • pageToken:用于获取后续结果页面。每个页面都有一个 nextPageToken,可用于获取序列中的下一页。
  • maxResults:每页的结果数上限。

下面是一个包含可选查询参数的示例 list 请求:

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantID}/productstatuses?destinations=Shopping&maxResults=3&pageToken=5108b52782905aa9

以下是 JSON 响应示例:

{
"kind": "content#productstatusesListResponse",
"nextPageToken": "632fd090c95712c6",
"resources": [
 {
   "kind": "content#productStatus",
   "productId": "online:en:US:online-en-US-GGL614",
   "title": "Green Headphones",
   "link": "https://example.com/green-headphones/",
   "destinationStatuses": [
     {
       "destination": "Shopping",
       "status": "disapproved",
       "disapprovedCountries": [
            "US", "UK"
       ]
     },
     {
       "destination": "ShoppingActions",
       "status": "disapproved",
       "disapprovedCountries": [
            "US"
       ]
     },
     {
       "destination": "SurfacesAcrossGoogle",
       "status": "disapproved",
       "disapprovedCountries": [
            "US"
       ]
     }
   ],
   "itemLevelIssues": [
     {
       "code": "mobile_landing_page_crawling_not_allowed",
       "servability": "disapproved",
       "resolution": "merchant_action",
       "attributeName": "link",
       "destination": "Shopping",
       "description": "Mobile page not crawlable due to robots.txt",
       "detail": "Update your robots.txt file to allow user-agents \"Googlebot\" and \"Googlebot-Image\" to crawl your site",
       "documentation": "https://support.google.com/merchants/answer/6098296",
       "applicableCountries": [
            "US"
       ]
     },
     {
       "code": "pending_initial_policy_review",
       "servability": "disapproved",
       "resolution": "pending_processing",
       "destination": "Shopping",
       "description": "Pending initial review",
       "documentation": "https://support.google.com/merchants/answer/2948694",
       "applicableCountries": [
            "US, UK"
       ]
     },
     {
       "code": "ambiguous_gtin",
       "servability": "unaffected",
       "resolution": "merchant_action",
       "attributeName": "gtin",
       "destination": "Shopping",
       "description": "Ambiguous value [gtin]",
       "detail": "Use the full GTIN. Include leading zeroes, and use the full UPC, EAN, JAN, ISBN-13, or ITF-14.",
       "documentation": "https://support.google.com/merchants/answer/7000891",
       "applicableCountries": [
            "US", "UK"
       ]
     }
   ],
   "creationDate": "2020-01-09T15:36:39Z",
   "lastUpdateDate": "2020-01-14T19:17:02Z",
   "googleExpirationDate": "2020-02-13T19:17:02Z"
 },
 {
  "kind": "content#productStatus",
  "productId": "online:en:US:43",
  "title": "Green shirt",
  "link": "https://example.com/shirt-green/",
  "destinationStatuses": [
   {
    "destination": "ShoppingActions",
    "status": "approved",
    "approvedCountries": [
            "US"
    ]
   },
   {
    "destination": "SurfacesAcrossGoogle",
    "status": "approved",
    "approvedCountries": [
            "US"
    ]
   }
  ],
  "creationDate": "2019-01-29T21:14:36Z",
  "lastUpdateDate": "2019-02-21T18:47:44Z",
  "googleExpirationDate": "2019-03-23T18:47:44Z"
 },
 {
  "kind": "content#productStatus",
  "productId": "online:en:US:40",
  "title": "Black hat",
  "link": "https://example.com/hat-black/",
  "destinationStatuses": [
   {
    "destination": "SurfacesAcrossGoogle",
    "status": "approved",
    "approvedCountries": [
            "US"
    ]
   }
  ],
  "creationDate": "2019-01-29T21:14:36Z",
  "lastUpdateDate": "2019-02-21T18:47:44Z",
  "googleExpirationDate": "2019-03-23T18:47:44Z"
 }
]
}

productstatuses.list 调用可以在生产环境中安全地进行测试,因为它不会对您的数据进行任何更改。

目标产品

以下是您可以在购物商品中使用的平台:

  • shopping ads:购物广告产品。
  • ShoppingActions:Google 易购商品。
  • surfaces across google:非付费商品详情商品。
  • shopping:本地产品目录广告产品。

商品级问题

每个商品级问题都包含以下字段:

  • code:用于确定问题的错误代码。
  • servability:指明商品是否显示为:
    • disapproved:该问题导致商品无法显示。
    • unaffected:商品仍展示。
  • resolution:通知商家是否可以解决问题。
  • attributeName:受影响的属性名称。
  • destination:受影响的目标平台。
  • description:商品的说明。
  • detail:提供有关问题的更多信息。
  • documentation:指示在哪里可以找到有关该问题的文档。
  • applicableCountries:指示商品在哪些国家/地区受问题影响。