向请求授权

您的应用向 Fitness API 发送的每个请求都必须包含授权令牌。Google 也可通过此令牌识别您的应用。

授权协议

您的应用必须使用 OAuth 2.0 向请求授权。其他任何授权协议均不受支持。如果您的应用使用 Google 登录,则系统会代您执行授权方面的某些操作。

应用想要访问的数据类型对应于范围。您需要先确定数据类型的相应范围是敏感还是受限,并在申请验证时按照相关步骤操作,然后才能访问数据类型。请参阅下文中向请求授权的第 3 步。

使用 OAuth 2.0 向请求授权

向 Fitness API 发出的所有请求均须由已通过身份验证的用户授权。

OAuth 2.0 授权流程(或称“流程”)的详细信息取决于您编写的应用的类型。以下常规流程适用于所有应用类型:

  1. 创建应用时,请使用 Google API 控制台注册应用。然后,Google 会提供您稍后需要用到的信息,例如客户端 ID 和客户端密钥。
  2. 在 Google API 控制台中激活 Fitness API。(如果 API 控制台中未列出该 API,请跳过此步骤。)
  3. 申请验证并提交相关的支持信息,说明您的应用为何需要特定范围。应用需要访问的数据类型对应于应用需要请求的范围
  4. 如果您的应用已经过验证,Google 会向用户显示同意屏幕,要求用户授权您的应用访问其数据。
  5. 如果用户批准,Google 会为您的应用提供一个短期访问令牌。
  6. 您的应用会请求获取用户数据,并在请求中附上该访问令牌。
  7. 如果 Google 确定您的请求和令牌有效,就会返回请求的数据。

点击此处了解 Fitness API 的 OAuth 范围。查询每种数据类型所需的范围