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

本指南將逐步說明如何使用自己的憑證，透過桌面流程或網頁流程設定 OAuth 2.0，以存取 API。除非您撤銷或刪除 OAuth 2.0 憑證，或需要變更允許的範圍，否則這些步驟只需執行一次。

建立 OAuth 2.0 憑證

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

  2. 記下用戶端 ID 和用戶端密碼，然後返回這個頁面。

設定用戶端程式庫

  1. 在終端機中執行 generate_user_credentials.pl 範例。您可以先修改範例中的 INSERT_XXX_HERE 值，再執行範例，也可以使用指令列引數 -client_id (用戶端 ID) 和 -client_secret (用戶端密鑰)。

    perl generate_user_credentials.pl -client_id {client_id} -client_secret {client_secret}

  2. 這個程式碼範例會提示您前往網址，授權應用程式代表您存取 Google Ads 帳戶。

    Paste this url in your browser:
https://accounts.google.com/o/oauth2/v2/auth?response_type=code&access_type=offline&client_id=...

    在私密瀏覽工作階段或無痕視窗中前往該網址。使用您存取 Google Ads 的 Google 帳戶登入。通常這是指 Google Ads 管理員帳戶的登入電子郵件，該帳戶的帳戶階層中包含您需要管理的所有帳戶。在 OAuth 2.0 同意畫面上，按一下「繼續」。

    OAuth 2.0 同意畫面

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

    Authorization code was successfully retrieved.

  3. 返回執行程式碼範例的控制台。您會看到程式碼範例已完成，並顯示重新整理權杖和一些操作說明，接著是設定用戶端程式庫的操作說明：

    Replace the following keys and values in your googleads.properties configuration file:

clientId==***********************apps.googleusercontent.com
clientSecret=****
refreshToken=****

  4. 按下 Ctrl + C 鍵即可終止程序。然後將產生的重新整理權杖連同用戶端 ID 和用戶端密碼複製到 googleads.properties 檔案中，或儲存到其他位置，以便在執行階段例項化程式庫時使用。