开发者核对清单

此核对清单简要介绍了发布与 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 中处于“测试”模式时，请添加测试用户，以便使用许可清单中的账号测试集成。

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

处理错误：查看问题排查指南，了解常见错误及其处理方法。

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

4. 为发布做好准备

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

Fitbit Web API 迁移：如果进行迁移，请按照迁移指南中的建议，确保迁移用户的重新身份验证流程顺畅。

OAuth 令牌授予速率限制： Google Cloud 对 OAuth 令牌授予实施速率限制，以控制应用可以多快地让用户登录或重新进行身份验证。如果您预计在 24 小时滑动窗口内会超过 10,000 个用户注册或重新身份验证，请提前申请更高的配额。如需了解详情，请参阅 OAuth 应用速率限制。

5. 发布和维护

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

监控：在 Google Cloud 控制台中监控 API 使用情况、错误率和 OAuth 令牌授予使用情况。

及时了解最新动态：关注版本说明，了解 API 更新和弃用情况。