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. 在「Authorized redirect URIs」下方新增一行，並加入以下內容： https://developers.google.com/oauthplayground

  6. 按一下「建立」。

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

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

產生憑證

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

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

  3. 請確認下列項目：

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

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

    playground settings

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

    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. 如果一切順利，系統應會為您填入更新權杖和存取權杖 (您可能需要重新展開步驟 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. 從「已授權的重新導向 URI」中移除 https://developers.google.com/oauthplayground。請注意，您必須保留至少 一個 重新導向 URI。

  5. 按一下 [儲存]。