下表列出應用程式應管理的憑證。如要瞭解各種應用程式類型,請參閱 OAuth 說明文件。
驗證工作流程 | 憑證 | 憑證類型 | 目的 |
---|---|---|---|
所有應用程式類型 | 開發人員權杖 | 應用程式憑證 | 讓您使用具有核准存取層級的 Google Ads API。 |
JavaScript 網頁應用程式 Android 應用程式 |
OAuth 用戶端 ID | 應用程式憑證 | 在執行 OAuth 流程時,用來專門識別應用程式。 |
存取權杖和更新權杖 | 使用者憑證 | 代表使用者授權應用程式,允許應用程式代表使用者存取 Google Ads 帳戶。 | |
伺服器端網頁應用程式 電腦和 iOS 應用程式 電視和裝置應用程式 |
OAuth 用戶端 ID 和用戶端密鑰 | 應用程式憑證 | 在執行 OAuth 流程時,用來專門識別應用程式。 |
存取權杖和更新權杖 | 使用者憑證 | 代表使用者授權應用程式,允許應用程式代為存取使用者的 Google Ads 帳戶。 | |
服務帳戶 | OAuth 服務帳戶金鑰 | 應用程式憑證 | 用於簽署 OAuth 要求。 |
服務帳戶的存取權杖 | 使用者憑證 | 代表服務帳戶的授權。使用者已與服務帳戶共用 Google Ads 帳戶。 |
管理 Google Ads API 應用程式的憑證時,請注意以下幾點。
安全地處理應用程式憑證
應用程式憑證是指應用程式專用的設定,不會因使用者而異。請務必謹慎處理 OAuth 應用程式憑證,因為只要有人取得這些憑證,就能使用您應用程式的身分存取使用者資訊。請將 OAuth 應用程式憑證儲存在安全的地方,並妥善保護,就像保護密碼一樣。盡可能使用密鑰管理工具 (例如 Google Cloud Secret Manager) 儲存應用程式憑證。您絕不能將用戶端憑證提交到公開的程式碼存放區。強烈建議您避免將這些檔案提交至任何程式碼存放區。
安全處理使用者憑證
使用者憑證是指代表使用者授權的 OAuth 權杖。使用者授權您代表他們執行動作及存取資料時,會將這些權杖委託給您。使用者可直接驗證您的應用程式,或間接透過服務帳戶共用 Google Ads 帳戶,將權杖委託給您。請勿以純文字傳輸權杖,並務必以加密形式儲存權杖,以防資料外洩。不再需要存取使用者帳戶時,請撤銷權杖或服務帳戶權限。撤銷權杖後,請從應用程式或系統中永久刪除權杖。
處理更新權杖的撤銷和到期情形
如果您使用使用者驗證流程,請注意重新整理權杖隨時可能失效。舉例來說,如果您使用多使用者驗證流程,使用者可以選擇撤銷應用程式的存取權。雖然使用單一使用者驗證流程的應用程式較不容易受到這類影響,但為保護使用者而設計的手動或自動程序,仍可能清除或使重新整理權杖過期。如果應用程式需要接收權杖撤銷通知,才能為使用者提供良好體驗,請務必整合 Cross-Account Protection 服務。
在 API 要求中重複使用使用者憑證
OAuth 存取權杖的效期很短,一小時後就會失效。如果您使用我們的用戶端程式庫,系統會以執行緒安全的方式,為您處理存取權杖到期和重新整理的問題。您只需要使用適當的 OAuth 憑證建構 Google Ads API 工作階段物件,並在整個生命週期內重複使用即可。
如果您自行建立存取權杖更新和管理策略,請追蹤存取權杖的到期時間,並盡可能重複使用。如果您不知道上次重新整理存取權杖的時間,可以嘗試重新整理權杖 (假設權杖已過期)。如果存取權杖即將過期,伺服器會傳回相同的存取權杖,以及權杖到期前剩餘的毫秒數。如果存取權杖即將在 5 分鐘內過期,建議強制重新整理。