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

本指南將逐步引導您設定 OAuth 2.0,以便透過自己的憑證和電腦流程網頁流程存取 API。除非您撤銷、刪除或需要變更 OAuth 2.0 憑證的允許範圍,否則只需執行一次這些步驟。

建立 OAuth 2.0 憑證

  1. 請按照這篇文章的步驟,為 Google Ads API 設定 Google API 控制台專案。

  2. 記下「用戶端 ID」和「用戶端密碼」,然後返回本頁。

設定用戶端程式庫

  1. 在終端機中執行 GenerateUserCredentials 範例。系統提示時,請輸入 OAuth 2.0 用戶端 ID 和用戶端密碼。

    dotnet run GenerateUserCredentials.csproj
    
  2. 這個程式碼範例會在瀏覽器中自動開啟網址。如果您尚未登入瀏覽器工作階段,網頁會提示您登入 Google 帳戶。如果您已登入,系統會略過登入提示,並將您重新導向至網址,您必須授權應用程式代表您存取 Google Ads 帳戶。

    請使用您用來存取 Google Ads 的 Google 帳戶登入。通常,這會是 Google Ads 管理員帳戶的登入電子郵件地址,其中包含您需要管理的所有帳戶,以及帳戶階層。在 OAuth 2.0 同意畫面中按一下「繼續」

    OAuth 2.0 同意畫面

    系統會將您導向至顯示授權成功的訊息的頁面。

    Your refresh token has been fetched. Check the
    console output for further instructions.
  3. 返回執行程式碼範例的控制台。您會看到程式碼範例已完成,並顯示重新整理權杖和一些操作說明,接著是您需要遵循的操作說明,才能設定用戶端程式庫:

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