本指南將逐步引導您設定 OAuth 2.0,以便透過自己的憑證和電腦流程或網頁流程存取 API。除非您撤銷、刪除或需要變更 OAuth 2.0 憑證的允許範圍,否則只需執行一次這些步驟。
建立 OAuth 2.0 憑證
請按照這篇文章的步驟,為 Google Ads API 設定 Google API 控制台專案。
記下「用戶端 ID」和「用戶端密碼」,然後返回本頁。
設定用戶端程式庫
-
在終端機中執行
GenerateUserCredentials
範例。系統提示時,請輸入 OAuth 2.0 用戶端 ID 和用戶端密碼。dotnet run GenerateUserCredentials.csproj
這個程式碼範例會在瀏覽器中自動開啟網址。如果您尚未登入瀏覽器工作階段,網頁會提示您登入 Google 帳戶。如果您已登入,系統會略過登入提示,並將您重新導向至網址,您必須授權應用程式代表您存取 Google Ads 帳戶。
請使用您用來存取 Google Ads 的 Google 帳戶登入。通常,這會是 Google Ads 管理員帳戶的登入電子郵件地址,其中包含您需要管理的所有帳戶,以及帳戶階層。在 OAuth 2.0 同意畫面中按一下「繼續」。
系統會將您導向至顯示授權成功的訊息的頁面。
Your refresh token has been fetched. Check the console output for further instructions.
返回執行程式碼範例的控制台。您會看到程式碼範例已完成,並顯示重新整理權杖和一些操作說明,接著是您需要遵循的操作說明,才能設定用戶端程式庫:
Copy the following content into your
App.config
file. <add key = 'OAuth2Mode' value = 'APPLICATION' /> <add key = 'OAuth2ClientId' value = '******' /> <add key = 'OAuth2ClientSecret' value = '******' /> <add key = 'OAuth2RefreshToken' value = '******' />請務必在
App.config
檔案中設定LOGIN_CUSTOMER_ID
標頭。詳情請參閱 設定指南。<add key = 'LoginCustomerId' value = 'INSERT_LOGIN_CUSTOMER_ID_HERE' />
如要瞭解其他設定選項,請參閱設定指南。
為互動式應用程式產生 OAuth2 憑證
如果您不知道要事先呼叫 API 的 Google Ads 帳戶,可以使用工作階段已登入使用者的憑證,在執行階段發現該帳戶。請參閱 AuthenticateInAspNetCoreApplication
中的範例,瞭解如何驗證目前登入的使用者,並在執行階段取得 OAuth2 憑證。