OAuth 電腦和網頁應用程式流程

本指南將逐步引導您使用您自己的憑證和桌面流程或網頁流程，設定 OAuth2 以存取 API。

為單一帳戶產生 OAuth2 憑證

要呼叫 Google Ads API 帳戶，最簡單的方法是：

  1. 將您要發出 API 呼叫的所有帳戶連結到單一 Google Ads 管理員帳戶。

  2. 使用 GenerateUserCredentials 範例，為具備管理員帳戶存取權的使用者產生 OAuth2 憑證。

  3. 使用 OAuth2 憑證，對您使用 Google Ads API 管理的所有帳戶發出呼叫。

這些步驟只需執行一次，除非您撤銷、刪除，或需要變更 OAuth2 憑證的允許範圍。

步驟 1：建立 OAuth2 憑證

  1. 按照步驟設定 Google Ads API 的 Google API 控制台專案。

  2. 記下用戶端 ID 和密鑰，再回到這個頁面。

步驟 2：設定用戶端程式庫

  1. 在終端機中執行 GenerateUserCredentials 範例，系統會提示您輸入 OAuth2 用戶端 ID 和密鑰。

    此為互動式範例，會要求您提供輸入內容。

    dotnet run GenerateUserCredentials.csproj

  2. 範例會提示您提供 OAuth2 用戶端 ID 和密鑰。提供步驟 1 的詳細資料。

  3. 這個範例會自動在瀏覽器中開啟網址。如果您尚未登入瀏覽器工作階段，網頁會提示您登入 Google 帳戶。如果您已登入，就會略過登入提示，並重新導向至提示網址，要求您授權應用程式代您存取 Google Ads 帳戶。

    同意畫面

  4. 接著，系統會將您導向一個頁面，顯示授權成功的訊息。

    已擷取更新權杖。請查看控制台輸出內容，取得進一步操作說明。

  5. 返回先前執行範例的控制台。這個範例應已完成，並顯示更新憑證和一些操作說明，後面接著設定用戶端程式庫所需的屬性：

    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 憑證的範例。