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

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

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

　　第二步，獲取授權(quán)碼。由于授權(quán)碼有效期極短，拿到后需立即使用。將以下URL中的占位符替換為你的Client ID和重定向URI，然后在瀏覽器中訪問(wèn)：

　　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

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

　　第三步，換取訪問(wèn)令牌。立即將授權(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é)果包含三個(gè)關(guān)鍵字段：access_token（有效期1小時(shí)）、refresh_token（長(zhǎng)期有效，用于續(xù)期）、expires_in（3599秒）。務(wù)必保存好refresh_token，這是后續(xù)無(wú)需重復(fù)授權(quán)的關(guān)鍵。

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

　　第五步，組裝最終請(qǐng)求?，F(xiàn)在你有兩個(gè)令牌：OAuth訪問(wèn)令牌（每小時(shí)續(xù)期）和開(kāi)發(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
"
}'

　　注意三個(gè)ID的對(duì)應(yīng)關(guān)系：CUSTOMER_ID是你要查詢的具體廣告賬戶ID；MANAGER_ID是你的經(jīng)理賬戶ID（即登錄時(shí)使用的賬戶）；訪問(wèn)令牌和開(kāi)發(fā)者令牌按前述步驟獲取。

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

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

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