授權與 HTTP 標頭

同時需具備 OAuth 2.0 應用程式憑證和開發人員權杖。假設您要進行 API 呼叫使用 Google Ads 管理員帳戶，您還必須指定login-customer-id 標頭。本頁說明如何設定這些值，並記錄了先前傳送的多個 API 專屬 HTTP 標頭，以及即確實接收。

OAuth 2.0 憑證

Google Ads API 會使用應用程式憑證識別及授權 API 要求。OAuth 2.0 用戶端和服務帳戶。瞭解詳情若要瞭解如何設定用戶端授權，請參閱這篇 Google Ads API。

如果您是第一次使用 Google API，可以使用 oauth2l 或 OAuth 2.0 進行實驗的遊樂場應用程式憑證和 Google Ads API 應用程式。

使用電腦版或網頁應用程式流程

按照步驟設定 Google API 控制台專案， Google Ads API。記錄用戶端 ID 和 用戶端密鑰，再回到這個頁面。

建立 OAuth 用戶端後，請按照電腦版應用程式流程操作操作說明，或網頁應用程式流程操作說明產生更新權杖和存取權杖。

使用服務帳戶

遵照「服務」帳戶指南。

設定用來存取 Google Ads 帳戶的服務帳戶後，請按照針對伺服器對伺服器使用 OAuth 2.0 應用程式請務必選取「HTTP/REST」分頁標籤。用於 Google Ads API 的 scope 存取權為https://www.googleapis.com/auth/adwords。

產生新的存取權杖

取得用戶端 ID、用戶端密鑰和更新權杖後，以便產生新的存取權杖，用來在透過 curl 指令列工具：

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

接著，請使用要求中 curl 要求傳回的存取權杖， Authorization 每個對 Google Ads API 發出的 API 呼叫都會產生下列 HTTP 標頭：

GET /v17/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN

要求標頭

開發人員權杖：

Google Ads API 也必須要有開發人員權杖，才能呼叫並嚴謹測試及提升 API 的公平性後我們才能放心地推出 API您可以直接在下列網址中為管理員帳戶申請權杖： Google Ads UI。如要進一步瞭解如何使用開發人員權杖進行設定，請參閱取得開發人員權杖。

您需要將開發人員權杖值加入 developer-token HTTP 每個 API 呼叫 Google Ads API 的標題：

GET /v17/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN

登入客戶 ID

如果是管理員對客戶帳戶發出的 Google Ads API 呼叫 (也就是以管理員身分登入並對其其中一個客戶帳戶進行 API 呼叫時)，您您也需要提供 login-customer-id HTTP 標頭。這個值代表進行 API 呼叫的管理員的 Google Ads 客戶 ID。

加入這個標題就等同在 Google Ads 使用者介面中選擇帳戶登入或按一下首頁右上角的個人資料圖片該網頁。指定客戶 ID 時，請務必移除所有連字號 (—)，例如：1234567890，而非 123-456-7890。

GET /v17/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID

已連結的客戶 ID

只有在第三方應用程式分析供應商服務的情況下，才能使用這個標題將轉換資料上傳至已連結的 Google Ads 帳戶。詳情請參閱 API 呼叫架構指南，掌握更多詳細資訊。

...
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID
linked-customer-id: LINKED_CUSTOMER_ID

回應標頭

下列標頭會從 API 傳回 HTTP 回應。

要求 ID

request-id 是用來識別 API 要求的專屬字串。時間對特定 API 呼叫的問題進行偵錯或疑難排解，request-id 是與 Google 開發人員聯絡時聯絡。

request-id: 2a5Cj89VV7CNhya1DZjjrC

簡介

總覽