Google Ads API 的 OAuth2 內部資料

我們的用戶端程式庫會自動處理下方的細節,因此 但只要想瞭解幕後花絮,才能繼續閱讀。 或是您不使用任何用戶端程式庫

本節適用於熟悉的進階使用者 符合 OAuth 2.0 規格和 瞭解如何搭配使用 OAuth2 與 Google API

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

影片庫:驗證與授權

範圍

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

Google Ads API 的範圍如下:

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

離線存取

Google Ads API 用戶端應用程式請求離線存取的情況很常見。例如: 在使用者並非實際上線的情況下,應用程式可能會想執行批次工作 或是瀏覽您網站的內容

如要要求離線存取網頁應用程式類型的離線存取權,請確認您已完成 offlineaccess_type 參數。如需更多相關資訊,請參閱 Google 的 OAuth2 指南

在電腦版應用程式中,離線存取功能預設為啟用。 就不必明確提出要求

要求標頭

gRPC 標頭

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

REST 標頭

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

GET /v17/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 值),之後) ,憑證就會失效您可以使用更新權杖重新整理 過期的存取權杖根據預設,用戶端程式庫會自動更新到期的存取憑證。