為 Google Ads API 設定 Google API 控制台專案

必須要有用於存取 Google 的 OAuth2 伺服器的憑證，才能 驗證和授權 Google Ads 使用者這些憑證可用來識別 應用程式傳送至 Google，以便產生用來管理 Google Ads 的 OAuth 權杖 使用者。Google OAuth2 憑證的存取權是透過 Google API 控制台。

觀看這部影片，瞭解一些 Cloud 專案最佳做法

Google OAuth 驗證

凡是用來取得 Google Ads API 範圍憑證的 Google Cloud 應用程式，都必須 採用 Google OAuth 驗證 未經驗證的 UI 畫面 使用者。在這個情況下，應用程式會定義為不重複的 OAuth 2.0 用戶端 ID 或是 Google Cloud 中的任何項目

此驗證獨立於 開發人員權杖核准程序的一部分 由於 Google Ads API 範圍屬於機密資料，因此必須使用。 範圍

Google 驗證不收費 (通常需要 3 到 5 個工作天。這項政策適用於所有應用程式。

我們建議所有應用程式盡快完成 Google OAuth 驗證程序 以免業務中斷

建立專案

前往 Google API 控制台。按一下「建立專案」。 輸入名稱，然後按一下「建立」。

在專案中啟用 Google Ads API

如要為專案啟用 Google Ads API，請按照下列步驟操作：

  1. 在 Google API 控制台中開啟 API 程式庫。畫面出現提示時，請選取 或建立新專案API 程式庫會列出所有可用的 API，按照產品系列和熱門程度分組。

  2. 如果 Google Ads API 在清單中找不到，請使用搜尋來找出該 API。

  3. 選取 Google Ads API，然後按一下「啟用」按鈕。

選擇使用者類型和發布狀態

啟用 API 後，您必須指定專案的使用者類型，以及 發布狀態：下表重點說明部分重要屬性和 每項設定組合的限制詳情請參閱 Google Cloud Platform 說明文件。

使用者類型 發布狀態 限制
內部 測試
  • 僅適用於與 Google Cloud 相關聯的專案 彙整：
  • 僅限 OAuth 同意聲明中列出的測試使用者 (最多 100 位) 。
  • 測試使用者必須是 Google Cloud 內部使用者 與專案相關聯的機構。
  • 授權會在同意當日起算的七天後失效。
外部 測試
  • 適用於所有專案。
  • 僅限 OAuth 同意聲明中列出的測試使用者 (最多 100 位) 。
  • 測試使用者可以是任何擁有 Google 帳戶的使用者。
  • 授權會在同意當日起算的七天後失效。
內部 實際運作中
  • 僅適用於與 Google Cloud 相關聯的專案 彙整：
  • 可授權 Google Cloud 機構中的任何使用者 與專案相關聯
外部 實際運作中
  • 適用於所有專案。
  • 可授權任何擁有 Google 帳戶的使用者。

未完成 Google OAuth 驗證 會產生下列結果：使用者類型或 專案狀態：

  1. 開啟 同意畫面， ，然後在頁面頂端的下拉式選單中選取專案。

  2. 選取「使用者類型」，然後按一下「建立」。

  3. 填寫同意畫面表單。日後如有需要，仍可修改這項資訊。按一下 完成後，儲存並繼續。

  4. 在下一頁中，按一下「新增或移除留言」。

    • 向下捲動，然後在 [手動新增] 下方的欄位中輸入下列內容： 範圍：

      https://www.googleapis.com/auth/adwords

    • 按一下「新增至表格」。

    • 新增專案會要求的其他任何範圍，然後點選「更新」。

    • 按一下 [儲存並繼續]。

  5. 如果不想立即發布專案，請新增電子郵件地址 每個要用於測試的使用者帳戶，然後依序點選 [儲存和] 繼續。

  6. 查看摘要頁面，然後按一下「返回資訊主頁」。

測試應用程式和授權程序後， 返回資訊主頁，然後按一下發布應用程式即可變更發布中 狀態從測試到實際運作中。

選取應用程式類型

Google Ads API 提供兩種應用程式選項：電腦版和網站。詳情請參閱 請參閱下表，判斷哪種類型最適合您的應用程式 建構：

選擇應用程式類型 適用條件
電腦版應用程式
  • 您用一個頂層管理所有 Google Ads 帳戶 管理員帳戶
  • 您是第一次使用，或者想要快速上手 設定。
  • 您的應用程式只會透過一部電腦驗證 Google 使用者。
網頁應用程式
  • 您想以可授予應用程式權限的使用者身分進行驗證 存取 Google Ads 帳戶資料
  • 您想要輕鬆產生多個授權憑證 以及第三方帳戶
  • 您的應用程式需要回呼網址。回呼網址不支援 電腦版應用程式流程

詳情請參閱 Google Identity Platform OAuth 說明文件： 電腦版應用程式或 網頁應用程式。

建立用戶端 ID 和用戶端密鑰

決定好應用程式類型後，請按照下列指示產生 OAuth2 用戶端 ID 和用戶端密鑰：

  1. 開啟「Credentials」(憑證) 頁面。 選取先前建立的專案，或建立新專案。

  2. 在「憑證」畫面上按一下「建立憑證」建立憑證，然後選取「OAuth」OAuth 用戶端 ID。

    1. 如果尚未為這項專案設定 OAuth 同意畫面 系統會引導你進行這項操作。按一下 設定同意畫面。

      1. 選取使用者類型，然後按一下「建立」。

      2. 填寫初始表單。日後如有需要，仍可修改這項資訊。按一下 完成後，按一下「儲存」。

    2. 返回「憑證」>建立憑證 >OAuth 用戶端 ID 以繼續。

  3. 選取「電腦版應用程式」或「網頁應用程式」做為應用程式類型。 根據用途選擇對應項目

  4. 設定名稱，然後按一下「建立」。

  5. 如果您的用戶端類型為網頁應用程式，請新增至少一個授權 重新導向 URI

    若是與 Google Cloud 預設設定相容的本機測試 用戶端程式庫範例，請使用 http://127.0.0.1。

    如果是電腦版應用程式用戶端，您仍可以使用 repback IP 重新導向， 但 URI 並未在 Cloud 控制台中明確設定

  6. 在確認頁面上，複製「您的用戶端 ID」和「您的用戶端密鑰」。 到剪貼簿，因為在設定用戶端時將會需要 資源庫。您也可以稍後再返回憑證頁面擷取這些憑證 詳細資料。

上一頁
總覽
下一頁
用戶端程式庫