您可以使用 productstatuses
资源
查看购物商品的详细状态。
请参阅商品问题 了解常见问题的详细信息。
商家有责任遵守购物广告 广告和免费 商品详情政策。Google Google 购物保留强制执行这些政策并做出适当回应的权利 如果我们发现了违反这些政策的内容或行为,
要求
您必须执行以下操作才能查看商品状态:
- 在目标平台中注册您的账号。
- 提供以下任一格式的有效国家/地区代码:
<ph type="x-smartling-placeholder">
- </ph>
feedLabel
字段。shipping
字段。- 在 Feed 级别。
- 您账号的运费设置。
获取产品的状态
使用 productstatuses.get
查看
商品的状态。
您可以在 get
和 list
请求中使用 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
调用可在生产环境中放心测试
因为它不会对数据进行任何更改
目的地
以下是可用于 Google 购物商品的目标平台:
shopping ads
:购物广告产品。ShoppingActions
:Google 易购商品。surfaces across google
:非付费商品详情商品。shopping
:本地产品目录广告商品。
商品级问题
每个商品级问题都包含以下字段:
code
:用于确定问题的错误代码。servability
:指明商品是否显示为: <ph type="x-smartling-placeholder">- </ph>
disapproved
:该问题会导致商品无法 。unaffected
:商品仍然展示。
resolution
:通知商家是否可以解决问题。attributeName
:受影响的属性名称。destination
:受影响的目标平台。description
:商品的说明。detail
:提供有关问题的更多信息。documentation
:指示在哪里可以找到关于问题的文档。applicableCountries
:指明在哪些国家/地区该问题影响到 产品。