COMMERCE_SERP 并设置 site google_shopping,按商城的顺序获取搜索结果中的商品;向 COMMERCE_PRODUCT 传入商品的 url,读取该商品。每次完成的搜索或商品页面消耗 2 积分。
搜索
GET /v1/async/task/{id} 或通过 webhook 接收。参见异步任务。
参数
site:必填。值为google_shopping。query:必填。搜索词,1-500 个字符。limit:可选整数,范围 1-40,默认 20。country:可选。默认是商城所在国家US。其他国家会以422 REGION_UNSUPPORTED拒绝。
include:即使是 include: {},也会在冻结积分前返回针对 payload.include 的 422 VALIDATION_ERROR。
响应示例
结果字段
site、query和country回显请求。returnedCount是products中的商品数。- 每个商品包含
rank、productId、title和url。productId是 Google 商品 ID;Google 未归并为商品的出售条目则是报价(offer)ID。rank遵循商城的默认排序,商城标为广告的商品会被跳过。 - 搜索结果页显示时返回
price、rating、reviewCount、imageUrl和seller。price是以商品的currency(ISO 4217)计的数字;不同规格分别定价时,取最低价。 rating为五分制。像 999+ 这样的缩写评价数不会返回。只有 Google 显示确切数量(1,000 以下)时才返回reviewCount。- 每次搜索从商城搜索结果的第一页获取商品。
- Google 的页面不链接商品或商家页面,因此
url是商品所在的 Google Shopping 结果页,末尾带有#product={productId}&title={title}。把这个url传给COMMERCE_PRODUCT,即可读取商品的卖家、规格和描述。seller是 Google 列出的第一家卖家。
商品页面
参数
url:必填。Google Shopping 搜索返回的商品url,最多 2,048 个字符,格式为google.com/search?q={query}&udm=28&gl={market}#product={productId}&title={title}。Google 搜索、Google AI 概览 和 Google AI 模式 结果中商品的productDetailUrl也可直接使用。country:可选。默认为url中的gl,取值为US、GB、AU、CA、KR、JP、TW、HK、DE、FR、ES、IT、PL、PT、BR、IN、ID、TH和VN之一。其他国家会以422 REGION_UNSUPPORTED拒绝。
include:即使是 include: {},也会在冻结积分前返回针对 payload.include 的 422 VALIDATION_ERROR。
响应示例
结果字段
site、country、url和productId标识页面。url是读取的页面,productId与搜索返回的 ID 一致。title始终返回。页面显示时返回brand、price、listPrice、currency、inStock、seller、rating、reviewCount、images、description、specs和offers。price是页面最初显示、未计优惠券和运费的购买价格,以currency(ISO 4217)计。listPrice是页面划线显示的原价,高于price时才返回。inStock是商品的库存状态。seller是销售该商品的商家。rating为五分制,保留两位小数。reviewCount是评价数。只有 Google 显示确切数量(1,000 以下)时才返回reviewCount。images按页面顺序列出商品图库中最多 30 张图片。description是每段一行的纯文本,最多 10,000 个字符;只出现在图片中的文字不包含在内。specs列出商品详情中最多 100 组{ name, value }。- 读取时会在该市场的 Google Shopping 上重新搜索
url中的搜索词;如果 Google 不再为这个搜索词列出该商品,则改用商品名称搜索,然后打开商品面板,因此比商城页面耗时更长。两次搜索都找不到该商品时,任务以PAGE_UNAVAILABLE结束。 offers列出 Google 为该商品显示的商家,从 Google 标为最低价的商家开始,每家包含seller、title(商家的商品名称)、url(Google 提供链接时为商家的商品页面)、price、listPrice、currency和inStock。商品的price、listPrice、seller和inStock取自第一家商家。价格使用该市场 Shopping 标签页的货币(ISO 4217),与标签语言无关。- 来自 Google AI 概览或 AI 模式商品的
productDetailUrl会用商品名称搜索,结果中返回该商品的productDocid。
错误与计费
- 没有返回任何商品的搜索以失败任务结束。
- 只对完成的任务计费:每次搜索或每个商品页面 2 积分。