为应用配置 OAuth

如需为您的应用配置 OAuth,请设置 OAuth 工作流,并启用 Data Portability API OAuth 范围。

设置 OAuth 工作流

如需为您的应用设置 OAuth 流程,请按照 Google Identity 文档中的基本步骤操作。

大多数开发者使用服务器端 Web 应用流程来征求 OAuth 的意见,但您也可以使用 JavaScript Web 应用流程“移动和桌面应用”流程

Data Portability API OAuth 范围

为 OAuth 配置 Data Portability API 应用时,请启用与您的应用相关的 Data Portability API OAuth 范围。如需查看 Data Portability API 支持的所有 OAuth 范围的列表,请参阅适用于 Google API 的 OAuth 2.0 范围。如需查看特定服务支持的所有资源组和 OAuth 范围的列表,请参阅该服务的架构参考页面

将 Data Portability API 范围添加到 OAuth 流程后,可能会出现用户同意部分(而非全部)范围的情况。您的应用必须能够通过以下方式处理这些情况:

  • 允许导出部分数据
  • 通知用户未选择所有必要的范围(并正常失败)
  • 征求用户其余意见

您应注意,只要获得用户的同意,即可针对该特定意见征求数据导出一次数据。如需再次下载数据,您需要征得用户同意。

您还应注意,在 OAuth 流程中,您的应用并不知道哪个 Google 帐号用于提供同意。您的应用收到的 OAuth 令牌是不透明的。

如需了解用户如何共享数据,请参阅与第三方分享您的数据副本