评价
Shopify 评价——接受的参数与返回的内容。
GET|POST /v1/shopify/reviewsPrice $0.001 per call, plus $0.001 for each extra call it makes — at most 6 more, so $0.007 in total. 首页通常比基础费用多计 1 个单位。cursor 翻页只计基础费用。 List price; the rate steps down above 1,000 calls a day.
| Parameter | Type | Required | Notes |
|---|---|---|---|
id | string | yes | The composite Shopify shop/handle — the same id product takes, not a global identifier. This is the one Shopify operation whose cost varies: a first page can cost more than 1, while a page fetched with cursor costs 1. |
cursor | string | Opaque cursor from the previous response; the only paging knob that works on every shop, and it wins if page is sent too. A page fetched with a cursor costs 1. | |
page | integer | 1-based starting page. Not every shop supports jumping to a page number; cursor works on every shop, so prefer it for paging. |
一次评价调用可能不止 1 个单位,区间见上方。各店铺提供评价的方式不同,这体现在几个方面:
- 请使用
cursor。 并非每个店铺都支持page;cursor始终可用。 - 没有评价也是一个答案,而且它会明说是零。 没有评价的商品返回
200,带reviews: []与page.total: 0。这在 Shopify 上很常见——大多数商品都没有评价——而这个零只在确实如此时才会发出。 - 只有星级、没有文字的评分按零条计。 有些店铺把纯星级评分与文字评价分开存放。一个有三个星级评分、
没有任何文字的商品会返回
total: 0——没有可返回的评价——尽管它的页面上可能显示着星星。 - 501 表示评价存在但无法提供。
REVIEW_APP_UNSUPPORTED——这家店铺的评价无法提供。REVIEWS_UNREACHABLE——报出了评价数或平均分,或页面上能看到评价,却一条也没取回。两者都有意既不是零 也不是 404:评价确实存在。
评价经常是被合并的:商家可能用整个系列的评价来回答某一种颜色的页面。在计算单个商品的评分之前,请先
检查响应中的 grouped。