如果你正在搭建营销自动化工具或数据看板,从Google Ads拉取数据是绕不开的一步。好消息是,这个过程没有想象中复杂。本文将带你走完从权限配置到成功调用的完整流程。
开始前,你需要准备两样东西:一个Google Ads经理账户(Manager Account),以及账户里至少有一些投放数据。没有这两样,后续步骤无法进行。
![]()
第一步,创建Google Cloud项目。这个项目充当用户与Google Ads账户之间的"中间人"。技术上,我们需要通过OAuth完成认证与授权。具体操作是:在Cloud Console中新建项目,生成客户端ID(Client ID)和密钥(Client Secret)。这组凭证将用于后续的认证环节。
第二步,获取授权码。由于授权码有效期极短,拿到后需立即使用。将以下URL中的占位符替换为你的Client ID和重定向URI,然后在浏览器中访问:
https://accounts.google.com/o/oauth2/v2/auth?client_id=YOUR_CLIENT_ID&redirect_uri=YOUR_REDIRECT_URI&response_type=code&scope=https://www.googleapis.com/auth/adwords&access_type=offline&prompt=consent
页面会跳转至你预设的重定向地址,从URL参数中复制code字段的值。
第三步,换取访问令牌。立即将授权码粘贴到以下curl命令中,替换所有占位符后在Postman或命令行执行:
curl -X POST https://oauth2.googleapis.com/token \
-d "code=AUTHORIZATION_CODE" \
-d "client_id=YOUR_CLIENT_ID" \
-d "client_secret=YOUR_CLIENT_SECRET" \
-d "redirect_uri=YOUR_REDIRECT_URI" \
-d "grant_type=authorization_code"
返回结果包含三个关键字段:access_token(有效期1小时)、refresh_token(长期有效,用于续期)、expires_in(3599秒)。务必保存好refresh_token,这是后续无需重复授权的关键。
第四步,获取开发者令牌(Developer Token)。这是Google Ads API特有的凭证,需在Google Ads经理账户的API中心申请,通常需要1-2个工作日审核。
第五步,组装最终请求。现在你有两个令牌:OAuth访问令牌(每小时续期)和开发者令牌(固定不变)。使用以下结构调用搜索接口:
curl -X POST "https://googleads.googleapis.com/v16/customers/CUSTOMER_ID/googleAds:search" \
-H "Authorization: Bearer ACCESS_TOKEN" \
-H "developer-token: DEVELOPER_TOKEN" \
-H "login-customer-id: MANAGER_ID" \
-H "Content-Type: application/json" \
-d '{
"query": "
SELECT
campaign.id,
campaign.name,
metrics.impressions,
metrics.clicks
FROM ad_group
WHERE segments.date DURING LAST_7_DAYS
"
}'
注意三个ID的对应关系:CUSTOMER_ID是你要查询的具体广告账户ID;MANAGER_ID是你的经理账户ID(即登录时使用的账户);访问令牌和开发者令牌按前述步骤获取。
第六步,解析返回数据。成功调用后,响应结构如下:
{
"results": [
{
"campaign": {
"id": "123456789",
"name": "Search Campaign"
},
"metrics": {
"impressions": "15000",
"clicks": "450"
}
}
]
}
整个流程的核心痛点在于令牌的层级关系:OAuth管"你是谁",开发者令牌管"你能调哪个API",login-customer-id管"你代表谁操作"。三层校验全部通过,数据才会返回。建议将refresh_token存入环境变量或密钥管理服务,避免硬编码。
特别声明:以上内容(如有图片或视频亦包括在内)为自媒体平台“网易号”用户上传并发布,本平台仅提供信息存储服务。
Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.