问题排查

本指南介绍了如何排查使用 Google Health API 时遇到的常见问题。

4xx 客户端错误

当客户端应用代码中存在问题时，系统会返回 4xx 状态代码。如需详细了解问题，请查看响应正文元素。

400 无效请求

消息	说明	建议
请求中包含无效的参数。	不支持数据类型 ID {value}。	验证端点引用的数据类型是否受支持。
收到的 JSON 载荷无效。八进制/十六进制数字不是有效的 JSON 值。		dailyRollUp 端点不支持分别以 MM 或 DD 表示的月份和日期值 。个位数不应以 0（零）开头。

401 未经授权

消息	说明	建议
请求所带的身份验证凭据无效。应提供 OAuth 2 访问令牌、登录 Cookie 或其他有效的身份验证凭据。	INVALID_AUTHENTICATOR：令牌已过期	您的访问令牌已过期。请使用刷新令牌 获取新的访问令牌和刷新令牌，或者让用户 重新向应用授予许可。

403 禁止访问

消息	说明	建议
调用方无权限。	无法通过 GaiaMint 生成 UberMint。	用户能够完成授权流程，但 端点调用失败。如果旧版 Fitbit 账号向应用授予许可，而不是 Google 账号，则可能会发生这种情况。如需解决 此错误： 通过 Fitbit 设置退出 Fitbit 移动应用。 按“使用 Google 账号继续” 或“使用 Google 账号登录”按钮，登录 Fitbit 移动应用。如果您收到一条 消息，指出“无法将 Fitbit 与此 Google 账号搭配使用”， 则表示您的电子邮件地址仍注册为旧版 Fitbit 账号。 请按照这篇 帮助文章 中的步骤迁移您的账号。 如果您使用新的 Google 账号成功登录 Fitbit 移动应用，请尝试使用同一电子邮件地址再次授予许可。

404 未找到

消息	说明	建议
在此服务器上找不到请求的网址 /v4/users/me/dataTypes/{dataType}/dataPoints 。		可能的原因： 验证是否使用了正确的动词 检查端点语法中是否存在错别字

检索 Fitbit 用户 ID

为了帮助排查用户问题，您可能需要验证用户登录 Fitbit 移动应用时使用的 Google 账号。

如需查找 Fitbit 用户 ID，请执行以下操作：

1. 打开 Fitbit 移动应用。
2. 按右下角的我 图标。
3. 按包含用户姓名和加入日期的顶部图块中的修改个人资料 链接。
4. 转到页面底部。在您的账号 部分中，分配给 ID 的值就是 Fitbit 用户 ID。（例如：CV5TKH）

撤消向应用授予的许可

在帮助用户排查其与应用的 OAuth2 连接问题时，您可能需要用户解除其账号与应用的关联，然后再次完成您的授权流程。

如需让用户解除其 Google 账号与应用的关联，请执行以下操作：

1. 打开 Fitbit 移动应用。
2. 按右上角的 Fitbit 用户个人资料图标。
3. 按管理您的 Google 账号 。
4. 选择数据和隐私设置 图块。
5. 向下滚动到**您使用的应用和服务中的数据** 部分。 在应用和服务 下，选择第三方应用和服务。
6. 在已关联的应用列表中查找您的应用名称，并让用户选择该应用。
7. 按撤消您与<应用名称>之间的所有关联 。
8. 让用户按“确认”以撤消向您的应用授予的许可。

撤消流程完成后，用户将返回到第三方应用和服务 页面列表。用户可能需要刷新该页面，才能看到应用名称从列表中移除。