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

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

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

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 機構相關聯的專案。
  • 最多只能有 100 位測試使用者，且必須列在 OAuth 同意畫面中。
  • 測試使用者必須是與專案相關聯的 Google Cloud 機構內部使用者。
  • 授權會在同意後七天失效。
外部 測試
  • 適用於所有專案。
  • 最多只能有 100 位測試使用者，且必須列在 OAuth 同意畫面中。
  • 測試使用者可以是任何擁有 Google 帳戶的使用者。
  • 授權會在同意後七天失效。
內部 實際運作中
  • 僅適用於與 Google Cloud 機構相關聯的專案。
  • 允許授權專案相關聯的 Google Cloud 機構內任何使用者。
外部 實際運作中
  • 適用於所有專案。
  • 允許任何擁有 Google 帳戶的使用者授權。

無論專案的使用者類型或發布狀態為何，如果未完成 Google OAuth 驗證，就會發生下列情況：

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

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

  3. 填寫同意畫面表單。日後可視需要編輯。完成後，按一下「儲存並繼續」。

  4. 在下一個頁面中，按一下「新增或移除範圍」。

    • 向下捲動，然後在「Manually add scopes」(手動新增範圍) 下方的欄位中輸入下列內容：

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

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

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

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

  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」和「您的用戶端密鑰」複製到剪貼簿，因為設定用戶端程式庫時需要這些資訊。您也可以稍後返回憑證頁面，擷取這些詳細資料。

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