本指南將逐步引導您使用您自己的憑證和桌面流程或網頁流程,設定 OAuth2 以存取 API。
為單一帳戶產生 OAuth2 憑證
要呼叫 Google Ads API 帳戶,最簡單的方法是:
將您要發出 API 呼叫的所有帳戶連結到單一 Google Ads 管理員帳戶。
使用
GenerateUserCredentials
範例,為具備管理員帳戶存取權的使用者產生 OAuth2 憑證。使用 OAuth2 憑證,對您使用 Google Ads API 管理的所有帳戶發出呼叫。
這些步驟只需執行一次,除非您撤銷、刪除,或需要變更 OAuth2 憑證的允許範圍。
步驟 1:建立 OAuth2 憑證
記下用戶端 ID 和密鑰,再回到這個頁面。
步驟 2:設定用戶端程式庫
在終端機中執行
GenerateUserCredentials
範例,系統會提示您輸入 OAuth2 用戶端 ID 和密鑰。此為互動式範例,會要求您提供輸入內容。
dotnet run GenerateUserCredentials.csproj
範例會提示您提供 OAuth2 用戶端 ID 和密鑰。提供步驟 1 的詳細資料。
這個範例會自動在瀏覽器中開啟網址。如果您尚未登入瀏覽器工作階段,網頁會提示您登入 Google 帳戶。如果您已登入,就會略過登入提示,並重新導向至提示網址,要求您授權應用程式代您存取 Google Ads 帳戶。
接著,系統會將您導向一個頁面,顯示授權成功的訊息。
已擷取更新權杖。請查看控制台輸出內容,取得進一步操作說明。
返回先前執行範例的控制台。這個範例應已完成,並顯示更新憑證和一些操作說明,後面接著設定用戶端程式庫所需的屬性:
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 = '******' /> Make sure you also set the LOGIN_CUSTOMER_ID header. See https://developers.google.com/google-ads/api/docs/client-libs/dotnet/configuration#google_ads_api_settings to learn more. <add key = 'LoginCustomerId' value = 'INSERT_LOGIN_CUSTOMER_ID_HERE' /> See https://developers.google.com/google-ads/api/docs/client-libs/dotnet/configuration for alternate configuration options.
為互動式應用程式產生 OAuth2 憑證
如果您不知道要用來發出 API 呼叫的 Google Ads 帳戶,可以在執行階段使用工作階段的已登入使用者憑證來發現帳戶。請參閱 AuthenticateInAspNetCoreApplication
,瞭解目前登入的使用者已通過驗證,並在執行階段取得 OAuth2 憑證的範例。