开发者核对清单

此核对清单概述了建议用于发布集成 Google Health API 的应用的步骤。

1. 准备工作

查看开发者文档：了解数据类型、范围和 API 端点，以确定您的集成需要哪些。

查看 Google Health API 政策：确保您的使用情形符合《Google Health API 开发者条款及条件》和《Google Health API 开发者和用户数据政策》。

规划用户体验：如果您要从 Fitbit Web API 迁移用户，请查看迁移指南中的最佳实践，了解如何处理用户重新身份验证。

2. 设置集成

设置 Google Cloud：按照设置 Google Cloud 和 OAuth 中的说明创建 Google Cloud 项目、启用 Google Health API 并配置 OAuth 2.0 凭据。为预演和生产使用单独的项目，这样测试就不会影响您的正式版应用。

配置 OAuth 权限请求页面：在 Google Cloud 控制台中，使用应用信息、品牌推广信息以及指向应用隐私权政策和服务条款的链接来配置 OAuth 权限请求页面。

添加范围：在 Google Cloud 控制台中，添加应用需要访问的数据类型所需的范围。查看范围实现，例如仅请求所需的范围、仅在发送数据时配置写入权限，以及妥善处理部分同意情况。

3. 开发和测试

进行首次 API 调用：如果您是 Google Health API 的新手，请按照 Codelab 中的说明在几分钟内进行首次 API 调用。

从 Fitbit Web API 迁移：如果您要从 Fitbit Web API 迁移，请查看迁移指南并使用对等工具比较 API。

实现 OAuth 2.0：实现 OAuth 2.0 授权以获取用户同意和 API 令牌。使用客户端库可简化实现。

添加测试用户：在 Google Cloud 中，当您的应用处于“测试”模式时，添加测试用户，以测试您与许可名单中的账号的集成。

提取数据：使用适当的数据类型端点来提取用户数据。遵循最佳实践，将检索历史数据与初始配置分开，因为所有数据周期的速率限制都是固定的。

处理错误：查看问题排查指南，了解常见错误以及如何处理这些错误。

使用订阅的 Webhook：使用订阅 API 接收实时通知，而不是轮询。将传入的通知放入队列并单独处理。请参阅 Webhook 最佳实践。

4. 为发布做好准备

OAuth 验证：如果您的应用需要支持 100 位以上的用户，或者您已准备好公开发布应用，请提交应用以进行 OAuth 验证。此流程可能需要几天时间，包括第三方安全审核以及对应用隐私权政策和服务条款的验证。

Fitbit Web API 迁移：如果需要迁移，请确保为迁移用户重新进行身份验证的流程顺畅无阻，并遵循迁移指南中的建议。

5. 发布和维护

发布应用：OAuth 验证完成后，在 Google Cloud 控制台中将应用发布到“正式版”，以移除 100 位用户的限制。

监控：在 Google Cloud 控制台中监控 API 使用情况和错误率。

及时了解最新动态：密切关注 Release Notes，了解 API 更新和弃用情况。