如果你正在搭建營銷自動化工具或數(shù)據(jù)看板，從Google Ads拉取數(shù)據(jù)是繞不開的一步。好消息是，這個過程沒有想象中復(fù)雜。本文將帶你走完從權(quán)限配置到成功調(diào)用的完整流程。

　　開始前，你需要準(zhǔn)備兩樣?xùn)|西：一個Google Ads經(jīng)理賬戶（Manager Account），以及賬戶里至少有一些投放數(shù)據(jù)。沒有這兩樣，后續(xù)步驟無法進行。

　　第一步，創(chuàng)建Google Cloud項目。這個項目充當(dāng)用戶與Google Ads賬戶之間的"中間人"。技術(shù)上，我們需要通過OAuth完成認證與授權(quán)。具體操作是：在Cloud Console中新建項目，生成客戶端ID（Client ID）和密鑰（Client Secret）。這組憑證將用于后續(xù)的認證環(huán)節(jié)。

　　第二步，獲取授權(quán)碼。由于授權(quán)碼有效期極短，拿到后需立即使用。將以下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

　　頁面會跳轉(zhuǎn)至你預(yù)設(shè)的重定向地址，從URL參數(shù)中復(fù)制code字段的值。

　　第三步，換取訪問令牌。立即將授權(quán)碼粘貼到以下curl命令中，替換所有占位符后在Postman或命令行執(zhí)行：

　　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"

　　返回結(jié)果包含三個關(guān)鍵字段：access_token（有效期1小時）、refresh_token（長期有效，用于續(xù)期）、expires_in（3599秒）。務(wù)必保存好refresh_token，這是后續(xù)無需重復(fù)授權(quán)的關(guān)鍵。

　　第四步，獲取開發(fā)者令牌（Developer Token）。這是Google Ads API特有的憑證，需在Google Ads經(jīng)理賬戶的API中心申請，通常需要1-2個工作日審核。

　　第五步，組裝最終請求。現(xiàn)在你有兩個令牌：OAuth訪問令牌（每小時續(xù)期）和開發(fā)者令牌（固定不變）。使用以下結(jié)構(gòu)調(diào)用搜索接口：

　　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的對應(yīng)關(guān)系：CUSTOMER_ID是你要查詢的具體廣告賬戶ID；MANAGER_ID是你的經(jīng)理賬戶ID（即登錄時使用的賬戶）；訪問令牌和開發(fā)者令牌按前述步驟獲取。

　　第六步，解析返回數(shù)據(jù)。成功調(diào)用后，響應(yīng)結(jié)構(gòu)如下：

　　{
"results": [
{
"campaign": {
"id": "123456789",
"name": "Search Campaign"
},
"metrics": {
"impressions": "15000",
"clicks": "450"
}
}
]
}

　　整個流程的核心痛點在于令牌的層級關(guān)系：OAuth管"你是誰"，開發(fā)者令牌管"你能調(diào)哪個API"，login-customer-id管"你代表誰操作"。三層校驗全部通過，數(shù)據(jù)才會返回。建議將refresh_token存入環(huán)境變量或密鑰管理服務(wù)，避免硬編碼。