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

您必須提供存取 Google OAuth2 伺服器的憑證，才能驗證及授權 Google Ads 使用者。這些憑證可向 Google 識別您的應用程式，讓您產生 OAuth 權杖來管理 Google Ads 使用者。您可以透過 Google API 控制台管理 Google OAuth2 憑證的存取權。

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

Google OAuth 驗證

任何用於取得 Google Ads API 範圍憑證的 Google Cloud 應用程式，都必須進行 Google OAuth 驗證，以免使用者看到未經驗證的 UI 畫面。在本主題中，應用程式是指 Google Cloud 中的專屬 OAuth 2.0 用戶端 ID。

這項驗證作業是獨立進行，且不屬於開發人員權杖核准程序的一部分，但由於 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，請使用搜尋功能。

  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

    • 按一下「加入資料表」。

    • 新增專案將要求的任何其他範圍，然後按一下「UPDATE」。

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

  5. 如果您不打算立即發布專案，請新增要用於測試的每個使用者帳戶的電子郵件地址，然後按一下「儲存並繼續」。

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

測試應用程式和授權程序後，您可以返回資訊主頁，然後點選「發布應用程式」，將發布狀態從「測試中」變更為「正式發布」。

選取應用程式類型

Google Ads API 有兩種應用程式類型可供選擇：電腦或網頁。請參閱下表，判斷哪種類型最適合您要建構的應用程式：

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

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

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

確定應用程式類型後，請按照下列操作說明產生 OAuth2 用戶端 ID 和用戶端密鑰：

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

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

    1. 如果您先前未為這項專案設定 OAuth 同意畫面，系統會提示您立即進行設定。按一下「設定同意畫面」。

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

      2. 填寫初始表單。如有需要，您可以稍後再編輯這項設定。完成後，請按一下「儲存」。

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

  3. 根據您的使用情境，選取「電腦版應用程式」或「網頁應用程式」做為應用程式類型。

  4. 為其命名，然後按一下「建立」。

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

    如要進行與用戶端程式庫範例中預設設定相容的本機測試，請使用 http://127.0.0.1。

    對於桌面應用程式用戶端，您仍會使用迴圈 IP 重新導向，但 URI 並未在 Cloud 控制台中明確設定。

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

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