OAuth Playground

如要產生 OAuth2 憑證，也可以使用 OAuth2 Playground。OAuth2 Playground 搭配 Google API 控制台，可讓您手動建立 OAuth2 權杖。

OAuth2 Playground 適用於只需要存取單一管理員帳戶或 Google Ads 使用者帳戶的使用者。如果需要提示多位使用者提供憑證，建議您為 Google Ads API 中的 OAuth 設定用戶端程式庫。

取得用戶端 ID 和密鑰

如果您目前沒有雲端專案：

  1. 開啟 Google API 控制台的「憑證」頁面。

  2. 在專案下拉式選單中選取現有專案，或新建一個。

  3. 在「憑證」頁面選取「建立憑證」，然後選取「OAuth 用戶端 ID」。

  4. 在「應用程式類型」下方，選擇 [網路應用程式]。

  5. 在「Authorized redirect URIs」下方新增一行，內容如下： https://developers.google.com/oauthplayground

  6. 點選「建立」。

  7. 在「用戶端 ID」頁面中，記下「用戶端 ID」和「用戶端密碼」。 在下一步中將會用到。

如果您有現有的雲端專案，可以按照步驟 5 的說明設定「已授權的重新導向 URI」，重複使用該專案。

產生憑證

  1. 前往 OAuth2 Playground，(使用這個連結應該會為您預先填入一些重要值)。

  2. 按一下右上角的齒輪圖示 ，然後選取標示為「使用您自己的 OAuth 憑證」的方塊 (如果尚未選取)。

  3. 請確認下列項目：

    • 「OAuth flow」 設為 [Server-side]。
    • 存取權類型設為「離線」 (這樣可確保您取得的是重新整理權杖和存取權杖，而非只有存取權杖)。

  4. 輸入您在之前取得的 OAuth2 用戶端 ID 和 OAuth2 用戶端密鑰。

    playground settings

  5. 在標示為「Step 1 - Select & authorize APIs」(步驟 1 - 選取及授權 API) 的部分，從清單中點選「Google Ads API」，然後選取其範圍 https://www.googleapis.com/auth/adwords。然後按一下「Authorize APIs」(授權 API)：

    authorize apis

  6. 如果系統提示，請登入要授予存取權和授權的帳戶。否則，請確認右上角的 Google 使用者是您要取得憑證的 Google Ads 或管理員帳戶。

  7. 系統會顯示提示，指出應用程式想管理您的 Google Ads 廣告活動。然後按一下「接受」繼續。

  8. 在標示為「Step 2 - Exchange authorization code for tokens」(步驟 2 - 將授權碼換成權杖) 的分頁中，應該會顯示「Authorization code」(授權碼)。按一下「Exchange authorization code for tokens」。

    playground authcode token

  9. 如果一切順利，系統應該會為您填入「更新權杖」和「存取權杖」 (您可能需要重新展開「Step 2 - Exchange authorization code for tokens」)：

    playground refresh token

  10. 將「更新權杖」連同「用戶端 ID」和「用戶端密鑰」，複製到所選用戶端程式庫的設定檔中。

  11. 在 Google Ads API 中設定 OAuth 適用的用戶端程式庫。

從用戶端 ID 移除 OAuth2 Playground

取得更新權杖後，您就不再需要將 OAuth2 Playground 設為已授權的重新導向 URI。如要從授權重新導向 URI 清單中移除，請按照下列步驟操作：

  1. 前往 Google API 控制台的「憑證」頁面。

  2. 從專案下拉式選單中選取所需專案。

  3. 按一下「憑證」網頁上的 [用戶端 ID 名稱] 來修改。

  4. 從「已授權的重新導向 URI」中移除 https://developers.google.com/oauthplayground。請注意，您必須保留至少一個重新導向 URI。

  5. 按一下 [儲存]。