我們的用戶端程式庫會自動處理下文涵蓋的細節,因此,如果您對幕後作業沒有興趣,或未使用任何用戶端程式庫,請勿繼續閱讀。
本節適用於熟悉 OAuth 2.0 規格,並瞭解如何搭配使用 OAuth2 與 Google API 的進階使用者。
想要進一步瞭解 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 /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
值),到期後就會失效。您可以使用更新權杖來更新過期的存取權杖。根據預設,用戶端程式庫會自動更新到期的存取憑證。