OAuth Playground

產生 OAuth2 憑證的方法之一，是使用 OAuth2 Playground。OAuth2 Playground 搭配 Google Ads API 控制台，可讓您手動建立 OAuth2 權杖。

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

取得用戶端 ID 和用戶端密鑰

如果沒有現有的雲端專案：

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

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

  3. 在「憑證」頁面上，依序選取「建立憑證」和「OAuth 用戶端 ID」。

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

  5. 在「已授權的重新導向 URI」下方，新增一行： https://developers.google.com/oauthplayground

  6. 點選「建立」。

  7. 在「用戶端 ID」頁面，記下用戶端 ID 和用戶端密鑰。您會在下一個步驟用到這些資訊。

如果您已有雲端專案，可以按照上述方式設定授權的重新導向 URI，重複使用該專案。

產生憑證

  1. 前往 OAuth2 Playground (使用這個連結應會預先填入部分索引鍵值)。

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

  3. 請確認下列項目：

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

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

    playground settings

  5. 在「步驟 1 - 選取並授權 API」部分，按一下清單中的「Search Ads 360 Reporting API」，然後選取範圍 https://www.googleapis.com/auth/doubleclicksearch。然後點選「Authorize APIs」：

    authorize apis

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

  7. 系統會顯示提示，指出應用程式想要管理 Search Ads 360 廣告活動。點選「接受」繼續。

  8. 在標示為「Step 2 - Exchange authorization code for tokens」的分頁中，應該會顯示「Authorization code」。按一下「Exchange authorization code for tokens」。

    playground authcode token

  9. 如果一切順利，「Refresh token」(更新權杖) 和「Access token」(存取權杖) 應該會自動填入 (您可能需要重新展開「Step 2 - Exchange authorization code for tokens」(步驟 2 - 將授權碼換成權杖))：

    playground refresh token

  10. 將更新權杖、用戶端 ID 和用戶端密鑰複製到所選用戶端程式庫的設定檔。

  11. 在 Search Ads 360 Reporting API 中，為 OAuth 設定用戶端程式庫。

從用戶端 ID 移除 OAuth2 Playground

取得更新權杖後，您就不再需要將 OAuth2 Playground 設為授權重新導向 URI。如要從授權重新導向 URI 清單中移除：

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

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

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

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

  5. 按一下 [儲存]。