调用Google Ads API：比想象中更简单的六步实操

　　如果你正在搭建营销自动化工具或数据看板，从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存入环境变量或密钥管理服务，避免硬编码。