Google Ads 接入指南

2026-10-15 14:24| 发布者: 万红刚| 查看: 2| 评论: 0

摘要: GoogleAds接入指南GoogleAds接入指南1.适用范围本文说明如何准备GoogleCloudOAuth2.0客户端，并在观远连接器创建“GoogleADS”数据账户。授权时使用具有目标GoogleAds账户访问权限的Google用户账号。2.准备Google资 ...

Google Ads 接入指南

1. 适用范围

本文说明如何准备 Google Cloud OAuth 2.0 客户端，并在观远连接器创建“Google ADS”数据账户。授权时使用具有目标 Google Ads 账户访问权限的 Google 用户账号。

2. 准备 Google 资质

2.1 创建 OAuth 2.0 客户端

在用于 Google Ads API 的 Google Cloud 项目中，打开Google Auth Platform · Clients，完成应用注册或同意屏幕配置后创建客户端，应用类型选“Web application”。在“Authorized redirect URIs”中添加：

https://apiconnector.guandata.com/auth-callback/GOOGLE_ADS

创建后保存 Client ID 和 Client Secret。Google 说明客户端密钥可能仅在创建时完整显示；请当场安全保存。操作细节参阅Google 官方 OAuth 客户端管理说明。

Google 官方创建 OAuth 客户端的步骤 — Google 官方说明中的 OAuth 客户端创建步骤。图中没有用户凭据；实际按钮和字段以 Google Cloud 当前界面为准。

Google Cloud 控制台创建 Web application OAuth 客户端后显示 Client ID 和 Client secret 的页面 — 公开资料中的 Google Cloud 控制台示例：选择 Web application，在 Authorized redirect URIs 配置回调地址；创建完成后，弹窗中会显示 Client ID 和 Client secret。示例中的凭据值已留空，实际页面以 Google Cloud 当前界面为准。

2.2 开通 Google Ads API 访问权限

在同一 Google Cloud 项目中打开 Google Ads API 概览页，按页面指引启用 API，并检查项目的访问权限级别。正式广告账户需要可访问生产环境的级别。Google 要求 OAuth 客户端与 Google Ads API 权限处于同一项目；参阅Google Ads OAuth 官方说明及访问权限级别说明。

Google 官方已将新注册和访问权限管理从 Google Ads 经理账号的 API Center 迁至 Google Cloud 项目。若您已有历史 Developer Token，可在原 Google Ads 经理账号的 API Center 查看；令牌当前不再决定 API 权限，也不接受新申请。详情见Google 官方令牌迁移说明。

Google 官方说明新接入应在 Google Cloud 项目中申请 API 权限 — Google 官方说明：新接入直接在 Google Cloud 控制台注册 Google Ads API 访问权限，旧 API Center 不处理新的令牌申请。

2.3 需要保存的字段

字段	获取位置	用途
Client ID	Google Auth Platform · Clients 中创建的 Web application	标识 OAuth 客户端
Client Secret	创建同一 OAuth 客户端时保存；参阅Google 官方密钥说明	授权码交换凭据，需安全保管
Developer Token	仅适用于已有历史令牌的用户；可按Google 官方迁移说明查看旧 API Center	当前观远连接器仍设为必填；Google 已停用新申请

3. 创建观远数据账户

3.1 选择 Google ADS

进入观远连接器“数据账户管理”，点击“新增数据账户”，所属平台选择“Google ADS”。

观远连接器新增 Google ADS 数据账户的完整表单 — 观远表单包含账户名称、Client ID、Client Secret、Developer Token 和“立即授权”。

3.2 字段映射关系

Google 字段	连接器字段	必填	说明
无	账户名称	是	自行填写便于识别的名称。
OAuth Client ID	Client ID（clientId）	是	从Google Auth Platform 客户端页面取得。
OAuth Client Secret	Client Secret（clientSecret）	是	与 Client ID 为同一 Web application；参阅官方创建说明。
历史 Developer Token	Developer Token（developerToken）	当前表单为必填	Google 已停用新申请。仅已有令牌可按官方迁移说明核对；无令牌时联系观远。

3.3 授权并保存

已有历史 Developer Token 的用户，填写账户名称、同一 OAuth 客户端的 Client ID 和 Client Secret，以及历史令牌。
点击“立即授权”，使用有权访问目标 Google Ads 账户的 Google 账号完成授权。
返回连接器，确认状态显示“已完成”，再点击“确定”保存。

4. 常见问题

现象	处理建议
没有 Developer Token	Google 已停用新申请，而观远当前表单仍要求填写。请联系观远确认连接器适配进度，不要尝试旧版 API Center 新申请流程。
授权后无法查询正式账户	在Google Ads API 概览页检查项目是否已获得生产账号访问权限，并确认授权的 Google 用户有目标广告账户访问权。
回调地址不匹配	核对 Web application 的 Authorized redirect URIs 中已保存 `https://apiconnector.guandata.com/auth-callback/GOOGLE_ADS`；参阅Google 官方回调地址要求。