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 憑證

如果您不知道自己的 Google Ads 帳戶可事先發出 API 呼叫，可以使用工作階段的已登入使用者憑證，在執行階段探索該帳戶。請參閱 AuthenticateInAspNetCoreApplication 範例，瞭解如何驗證目前登入的使用者，並在執行階段取得 OAuth2 憑證。