呼叫 Google Ads API 時，您需要 OAuth 2.0 憑證。如果您使用 Google Ads 管理員帳戶發出 API 呼叫，也需要在每個要求中指定 login-customer-id 標頭。本頁說明如何設定這些值，並記錄使用 REST 介面時傳送及接收的幾個額外 API 專屬 HTTP 標頭。
OAuth 2.0 憑證
Google Ads API 會使用 OAuth 2.0 授權 API 要求。OAuth 2.0 使用者驗證流程和服務帳戶流程都支援。詳情請參閱「Google Ads API 中的 OAuth 2.0」。
如果您是 Google API 的新手，可以先使用 gcloud CLI 或 OAuth 2.0 Playground 試用 OAuth 2.0 憑證和 Google Ads API，再為應用程式編寫程式碼。
建議您使用 https://oauth.net/code/ 提供的其中一個 OAuth 2.0 程式庫，實作 OAuth 2.0 授權工作流程。不過，我們已列出 curl 指令，方便您自行實作。
服務帳戶
按照步驟為 Google Ads API 設定 Google Cloud 專案。記錄服務帳戶電子郵件地址和服務帳戶金鑰。接著，請按照「服務帳戶」指南中的一般操作說明，設定服務帳戶來存取 Google Ads 帳戶。
使用者驗證
請按照步驟為 Google Ads API 設定 Google Cloud 控制台專案。記下「client ID」(用戶端 ID) 和「client secret」(用戶端密鑰)。接著，請按照電腦版應用程式流程說明或網頁應用程式流程說明，產生更新權杖和存取權杖。使用 Google Ads API 存取權的 scope是 https://www.googleapis.com/auth/adwords。
產生新的存取權杖
服務帳戶
取得服務帳戶電子郵件地址和服務帳戶金鑰後，請按照「針對伺服器對伺服器應用程式使用 OAuth 2.0」指南產生 JWT 憑證附加資訊，然後交換取得 OAuth 2.0 存取權杖。請務必在按照指南操作時選取「HTTP/REST」分頁標籤。用於存取 Google Ads API 的 OAuth 2.0 scope為
https://www.googleapis.com/auth/adwords。此外，建構 JWT 聲明集時，您可以略過 sub 參數，因為設定步驟會授予服務帳戶直接存取 Google Ads 帳戶的權限，因此不需要模擬 Google Ads 使用者。
接著，在每次呼叫 Google Ads API 時，您都會在 Authorization HTTP 標頭中使用存取權杖：
GET /v25/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
使用者驗證
取得 OAuth 2.0 用戶端 ID、用戶端密鑰和更新權杖後，即可使用 curl 指令列工具，產生新的存取權杖以用於 API 呼叫：
curl \
--data "grant_type=refresh_token" \
--data "client_id=CLIENT_ID" \
--data "client_secret=CLIENT_SECRET" \
--data "refresh_token=REFRESH_TOKEN" \
https://www.googleapis.com/oauth2/v3/token接著，您會在每個 Google Ads API 呼叫的 Authorization HTTP 標頭中，使用 curl 要求傳回的存取權杖：
GET /v25/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
要求標頭
以下各節說明向 Google Ads API 提出要求時，需要或使用的 HTTP 標頭。
登入客戶 ID
如果管理員要對客戶帳戶發出 Google Ads API 呼叫 (也就是以管理員身分登入，對其中一個客戶帳戶發出 API 呼叫)，您也需要提供 login-customer-id HTTP 標頭。這個值代表進行 API 呼叫的管理員的 Google Ads 客戶 ID。
加入這個標頭，就等同於在登入 Google Ads 使用者介面後選擇帳戶，或點按頁面右上角的預設個人圖片。指定客戶 ID 時，請務必移除所有連字號 (—)。例如：1234567890，而非 123-456-7890。如要進一步瞭解登入客戶 ID，請參閱 Google Ads 存取模式指南。
GET /v25/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID
已連結的客戶 ID
合作夥伴 (例如第三方應用程式數據分析供應商或資料合作夥伴) 對已連結的 Google Ads 帳戶採取行動時，會使用「已連結的客戶 ID」標頭。詳情請參閱 API 呼叫結構指南。
Authorization: Bearer ACCESS_TOKEN
login-customer-id: PARTNER_CUSTOMER_ID
linked-customer-id: ADVERTISER_CUSTOMER_ID
回應標頭
API 的 HTTP 回應會傳回下列標頭。
要求 ID
request-id 是用於識別 API 要求的專屬字串。偵錯或排解特定 API 呼叫問題時，request-id 是重要的 ID，聯絡 Google 開發人員支援團隊時，請務必提供這個 ID。
request-id: 2a5Cj89VV7CNhya1DZjjrC