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 用戶端 IDOAuth2 用戶端密鑰

    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. 按一下 [儲存]