在向外部用户发布请求 Data Manager API 用户凭据的应用之前,您的 Google Cloud 项目必须经过 Google OAuth 应用验证。
本指南介绍了开发期间建议的受众群体配置转换,以及完成 Google OAuth 应用验证的步骤。
应用受众群体阶段
根据您的开发阶段,在 Google Cloud 控制台的“受众群体”页面中配置不同的用户类型和发布状态设置。请按照以下阶段操作,顺利完成从初始测试到正式发布的过渡。
第 1 阶段:初始开发(测试)
在开始开发和测试基本 API 请求时:
发布状态:设置为测试。
用户类型:
如果您的 Google Cloud 云项目属于某个 Google Workspace 组织,并且只有您组织中的用户使用该应用,请选择内部。
否则,请选择外部。
测试用户:如果您将用户类型设置为外部,请点击添加用户,以手动添加用于生成凭据的 Google 账号。只有列出的 Google 账号可以授权应用,并且测试限制和令牌到期规则适用。
测试期间无需进行验证。如果您使用外部,测试用户会看到一个警告屏幕,确认他们拥有对未经验证的应用的测试访问权限,然后才能进入权限请求页面。
第 2 阶段:临近发布(提交验证)
当您完成集成、构建好界面并计划在下个月内发布时:
更新“观众”页面设置:
发布状态:转换为正式版。
用户类型:如果您的应用服务于组织外部的客户(例如广告客户),请设置为外部。
提交应用以进行验证。Google OAuth 应用验证流程可能需要几周时间,因此请在界面准备就绪后尽早提交。
应用验证要求
如需在验证中心提交应用以进行验证,请配置 Google Auth Platform 设置并准备所需的验证材料。
品牌信息和隐私权政策
在 Google Cloud 控制台的品牌页面上,在提交之前验证以下详细信息:
应用首页:您的首页必须可公开访问,并包含指向应用隐私权政策的可见链接。
隐私权政策链接:在“品牌信息”页面上配置的隐私权政策网址必须与应用首页上链接的隐私权政策网址一致。
验证范围
在数据访问页面上,仅请求应用所需的范围。Data Manager API 使用敏感范围:
https://www.googleapis.com/auth/datamanager(主要范围)https://www.googleapis.com/auth/datamanager.partnerlink(适用于合作伙伴链接)
在提交验证请求时,请详细说明您的应用为何需要访问所请求的范围。
联系信息
Google OAuth 验证团队会将所有通信发送到您的 Google Cloud 项目中配置的项目所有者和项目编辑者。请在 Google Cloud 控制台中及时更新这些详细联系信息,以免错过信息请求。
如果验证团队发送了后续问题或要求更新(例如更改演示视频或权限请求页面设置),审核会暂停,直到您做出回应。如果您的提交内容已处于待处理状态超过几周,且没有任何更新,请检查所有 Project Owner 和项目编辑者的电子邮件收件箱(包括“垃圾邮件”文件夹)。
演示视频
提供一个公开演示视频的链接(例如不公开列出的 YouTube 视频或公开的 Google 云端硬盘链接),展示您的应用如何使用所请求的范围。
确保视频符合应用功能演示视频的所有要求,包括以下 Data Manager API 检查:
端到端用户体验历程和 OAuth 授权:展示应用中的完整用户体验历程,从用户发起登录或授权开始,直到完成 OAuth 授权流程。
匹配的应用身份:确保视频中显示的应用名称、徽标和品牌信息与 Google Cloud 控制台中的“品牌信息”页面配置一致。
完整的英文版 OAuth 权限请求页面:显示整个 OAuth 权限请求页面,并将左下角的语言选择器设置为英语,确保该页面显示应用请求的确切 Data Manager API 范围。
在应用界面中使用范围:演示使用所请求范围的应用功能(例如,在应用界面中创建合作伙伴链接、创建受众群体名单或配置数据注入)。
第 3 阶段:准备发布(已验证)
当 Google OAuth 验证团队通知您他们已批准您的应用验证请求后,您无需执行任何操作。您的应用现已通过验证,外部用户可以对其进行授权,而不会遇到未经验证的应用警告屏幕。