Google Ads API 的 OAuth2 內部資料

我們的用戶端程式庫會自動處理下文涵蓋的細節,因此只有在想瞭解幕後花絮或未使用其中一個用戶端程式庫時,才繼續閱讀。

本節適用於熟悉 OAuth 2.0 規格,並且瞭解如何搭配 Google API 使用 OAuth2 的進階使用者。

想要進一步瞭解 API 中的驗證機制嗎?

影片庫:驗證與授權

範圍

單一存取權杖可為多個 API 授予不同程度的存取權。名為 scope 的變數參數可控管存取權杖允許的資源和作業組合。在存取權杖要求期間,您的應用程式會透過 scope 參數傳送一或多個值。

Google Ads API 的範圍如下:

https://www.googleapis.com/auth/adwords

離線存取

Google Ads API 用戶端應用程式請求離線存取的情況很常見。舉例來說,當使用者未實際瀏覽您的網站時,您的應用程式便可執行批次工作。

如果想請求網頁應用程式類型的離線存取功能,請務必將 access_type 參數設為 offline。您可以在 Google 的 OAuth2 指南中找到更多資訊。

電腦版應用程式類型預設會啟用離線存取功能,因此您不需要明確要求。

要求標頭

gRPC 標頭

使用 gRPC API 時,請在每個要求中加入存取權杖。您可以將 Credential 繫結至 Channel,用於該管道的所有要求。您也可以為每個呼叫傳送自訂憑證。gRPC 授權指南包含處理授權的詳細資料。

REST 標頭

使用 REST API 時,請透過 HTTP 標頭 Authorization 傳遞存取權杖。以下是 HTTP 要求範例:

GET /v16/customers/123456789 HTTP/2
Host: googleads.googleapis.com
User-Agent: INSERT_USER_AGENT
Accept: */*
Authorization: Bearer INSERT_ACCESS_TOKEN
developer-token: INSERT_DEVELOPER_TOKEN

存取及更新憑證

在大多數情況下,您必須安全地儲存更新權杖,以供日後使用。如要進一步瞭解如何要求存取及更新權杖,請參閱您應用程式類型適用的對應指南:

更新權杖到期日

如要進一步瞭解更新憑證到期時間,請參閱 Google Identity Platform OAuth 說明文件

存取憑證過期

存取權杖設有到期時間 (以 expires_in 值為依據),期限過後就會失效。您可以使用更新權杖來更新過期的存取權杖。根據預設,用戶端程式庫會自動更新到期的存取憑證。