呼叫 Search Ads 360 Reporting API 時，您需要 OAuth 2.0 應用程式憑證。如果您是以 Search Ads 360 管理員帳戶身分發出 API 呼叫，則也必須在每個要求中指定 login-customer-id 標頭。本頁說明如何設定這些值，並記錄使用 REST 介面時傳送和接收的其他 API 專屬 HTTP 標頭。
OAuth 2.0 憑證
Search Ads 360 Reporting API 會使用應用程式憑證來識別及授權 API 要求。您可以設定 OAuth 2.0 用戶端。所有 Search Ads 360 Reporting API 呼叫都必須透過 OAuth2 授權。OAuth2 可讓您的 Search Ads 360 Reporting API 用戶端應用程式存取使用者的 Search Ads 360 帳戶，而無須處理或儲存使用者的登入資訊。
如果您是 Google API 新手，可以使用 oauth2l 或 OAuth 2.0 Playground 來試驗應用程式憑證和 Search Ads 360 Reporting API，然後再編寫應用程式程式碼。您也可以執行提供的使用者憑證產生指令碼，產生 OAuth 重新整理權杖。
產生新的存取權杖
取得 client ID、client secret 和重新整理權杖後，您可以使用 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
接著，您可以使用 curl 要求在每個 API 呼叫的 Authorization HTTP 標頭中傳回的 存取權杖，呼叫 Search Ads 360 Reporting API：
GET /v0/customers:listAccessibleCustomers HTTP/1.1
Host: searchads360.googleapis.com
Authorization: Bearer ACCESS_TOKEN
要求標頭
登入客戶 ID
管理員向客戶帳戶發出的 Search Ads 360 報表 API 呼叫 (也就是以管理員身分登入，向其中一個客戶帳戶發出 API 呼叫) 需要提供 login-customer-id HTTP 標頭。這個值代表發出 API 呼叫的管理員的 Search Ads 360 客戶 ID。
加入這個標頭，就等同於在登入後選擇 Search Ads 360 UI 中的帳戶，或點按頁面右上角的個人資料相片。指定客戶 ID 時，請務必移除所有連字號 (—)，例如：1234567890，而非 123-456-7890。
GET /v0/customers:listAccessibleCustomers HTTP/1.1
Host: searchads360.googleapis.com
Authorization: Bearer ACCESS_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID
回應標頭
下列標頭會在 API 的 HTTP 回應中傳回。
要求 ID
request-id 是用於識別 API 要求的專屬字串。在偵錯或排解特定 API 呼叫的問題時，request-id 是與 Google 開發人員支援團隊聯絡時的重要 ID。
request-id: 2a5Cj89VV7CNhya1DZjjrC