Google Play · 已上线两个 Google 数据源，一个评论列表
Google 在不同的地方提供近期评论和历史评论。Review Expert 用一个服务账号同时读取两者。
| Google Play Developer API | Play Console 评论报告 | |
|---|---|---|
| 覆盖范围 | 大约最近 7 天内创建或修改的评论 | 你应用评论的月度 CSV 文件 |
| 没有文字的评论 | 不返回 | 不作为评论导入 |
| 存放位置 | Android Publisher API（reviews 接口） | 你的 Play Console Google Cloud Storage 存储桶 |
| Review Expert 的用途 | 约每 5 分钟持续同步，以及发布回复 | 补全历史（目前最多 36 个月） |
| 包含开发者回复 | ✓ | ✓ |
Google Play 评论能得到什么
超过 7 天的历史
从 Play Console 的月度评论报告中导入较早的评论，仪表板显示的是趋势，而不只是上周。
约每 5 分钟获取新评论
首次同步后，Review Expert 约每 5 分钟通过 API 检查一次新评论。
在 Google 的 350 字符内回复
在 Review Expert 中撰写或更新回复，通过官方 API 发布。所有团队角色都可以回复。
分发到你的工具
Starter 含 Slack 和 Linear，Pro 含 Microsoft Teams 和 Zendesk，Enterprise 含 Webhook，均可按评分和关键词筛选。
仪表板
平均评分、评分分布、评论随时间和平台的变化、回复率和平均回复时间。
无需手动处理 CSV
不必再从 Play Console 下载月度文件并合并表格，才能看到用户上个季度说了什么。
用服务账号连接 Google Play
这是 Google 提供的标准方式，无需共享密码即可让工具通过 API 访问你的 Play Console。
- 1
选择一个 Google Cloud 项目
打开 Google Cloud Console，选择现有项目或新建一个项目。请使用可以管理该项目服务账号的账户登录。 - 2
启用 Google Play Android Developer API
在 APIs & Services → Library 中启用 Google Play Android Developer API。我们的应用内指南还提供了 Cloud Storage API 的链接，用于读取你的评论报告文件。 - 3
创建服务账号和 JSON 密钥
在 IAM & Admin → Service Accounts 下创建一个服务账号（例如“review-expert”），然后打开 Manage keys → Add key → Create new key → JSON。JSON 文件会下载到你的电脑。 - 4
在 Play Console 中邀请服务账号
在 Play Console 中打开 Users and permissions → Invite new users，粘贴服务账号的邮箱，并授予 View app information and download bulk reports (read-only) 和 Reply to reviews 权限。发送邀请。 - 5
在 Review Expert 中上传密钥
在 Review Expert 控制台中打开 Apps & Businesses，添加你的 Android 应用并上传 JSON 密钥。Review Expert 会测试连接，然后开始 API 同步和历史补全。
在 Google Cloud 中遇到权限错误？
如果 Google Cloud 提示你没有权限为项目设置策略，很可能是你登录的账户无法管理该项目的 IAM。请联系项目所有者，或使用你自己拥有的项目。Google 的入门指南介绍了用于 Play Developer API 的服务账号。
历史补全如何运作
Play Console 会把你开发者账号的报告保存在一个 Google Cloud Storage 存储桶中（名称类似 pubsite_prod_<开发者 ID>，可以在 Play Console 的 Download reports → Reviews 页面复制存储桶 ID）。其中的评论报告按应用和月份拆分为单独的 CSV 文件。
连接应用后，Review Expert 会：
- 使用你的服务账号找到开发者账号的报告存储桶。
- 读取该应用的月度评论文件（目前最多回溯 36 个月），导入每条评论的评分、正文、日期以及开发者回复。
- 将它们与 API 返回的近期评论合并，避免同一条评论出现两次。
- 之后继续约每 5 分钟轮询一次 API 获取新评论。
这就是服务账号需要 View app information and download bulk reports 权限的原因：没有它，Review Expert 只能看到 API 返回的大约一周的评论。Google 在下载和导出月度报告中介绍了这些报告文件。更详细的步骤请阅读如何获取 7 天前的 Google Play 评论。
新授予的权限可能需要一些时间生效
Google 可能需要一段时间才会让新邀请的服务账号权限生效，新应用也可能还没有报告文件。如果历史补全一开始什么都没找到，请发邮件至 contact@review.expert，报告可用后我们会帮你重新运行。无论如何，API 的新评论都会继续同步。
常见问题
Google Play Developer API 的评论接口只返回大约最近一周内创建或修改、且带有文字的评论。更早的评论必须来自 Play Console 的评论报告，Google 会把它们以月度 CSV 文件写入你开发者账号的 Google Cloud Storage 存储桶。
Review Expert 使用你为 API 连接的同一个服务账号，找到你的 Play Console 报告存储桶，读取应用的月度评论 CSV 文件（目前最多最近 36 个月），并连同开发者回复一起导入。之后近期评论继续来自 API。
Review Expert 的定位是监控、回复和分发评论，而不是生成 CSV 导出。如果你只需要一次性的表格，可以在 Play Console 的 Download reports → Reviews 页面直接下载月度 CSV 文件。如果你希望这些评论可搜索、可筛选，并发送到 Slack、Linear、Teams、Zendesk 或 Webhook，就把应用连接到 Review Expert。
在 Play Console 的 Users and permissions 中邀请服务账号的邮箱，并授予“View app information and download bulk reports (read-only)”（读取评论报告所需）和“Reply to reviews”（发布回复所需）。可以授予所有应用，也可以只授予你连接的应用。
Google 将开发者回复限制在 350 个字符。回复要简短具体：承认问题，给出修复方案或下一步，必要时引导到客服。
可以。对已有回复的评论再次发布回复，会在 Play Console 和 API 中同时更新它。在 Review Expert 中，编辑回复后再次发送即可。
Google 的 API 只返回带文字的评论，而月度报告文件是 Google 提供的历史数据。没有任何文字的评分不是可以回复的单独评论，因此不会在你的收件箱中显示为一行。
首次同步后，Review Expert 约每 5 分钟检查一次 Google Play Developer API。评论何时可以通过 API 获取由 Google 决定，因此与你在 Play Console 中看到的相比可能会有短暂延迟。