为何Google Retail Search API未返回标题、价格等产品信息？

可能原因及对应解决步骤 #

1. API请求未指定返回完整产品字段 #

Google Retail Search API默认返回基础视图（BASIC），仅包含产品ID、名称、变体等核心标识信息，不会主动返回标题、价格、图片等详情。

解决方法：
在请求体中添加view参数并设置为FULL，即可获取完整产品数据：

{
  "query": "你的搜索关键词",
  "view": "FULL",
  // 其他原有参数...
}

如果只需要特定字段，也可以用productFields精准指定（逗号分隔字段名）：

{
  "query": "你的搜索关键词",
  "productFields": "title,priceInfo,images,description",
  // 其他原有参数...
}

2. 产品数据未完整上传至Retail Catalog #

如果后台的产品条目本身没有录入标题、价格、图片等字段，API自然无法返回这些信息。

解决方法：

• 登录Google Cloud控制台，进入Retail服务的Catalog管理页面
• 找到对应的产品ID（比如示例中的005013199），检查title、priceInfo、images等字段是否存在有效内容
• 补全缺失字段后，重新同步产品数据到Retail系统

3. 账号权限限制（概率较低） #

若测试账号缺少读取产品完整信息的权限，也会导致返回内容受限。

解决方法：
检查账号的IAM权限，确保拥有Retail Product Viewer或更高权限（如Retail Editor），保证能读取产品的全部字段。

内容的提问来源于stack exchange，提问作者HU Jian