Google Ads API 適用的 OAuth2 內部

我們的用戶端程式庫會自動處理以下涵蓋的詳細資料，因此，除非您有意瞭解幕後的脈絡，或者您未使用我們的用戶端程式庫，否則請勿繼續閱讀。

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

想要進一步瞭解 API 中的驗證功能嗎？

video_library 影片庫：驗證和授權

範圍

一組存取憑證可授予不同程度的多個 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 /v11/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 的值為準)，在此之後，該符記就會失效。您可以使用更新憑證來更新過期的存取憑證。根據預設，用戶端程式庫會自動更新到期的存取憑證。