雲端管理的存取層級

這項功能可讓 Google Cloud 組織管理您的 API 存取層級，帶來下列好處：

  • 不再需要保護開發人員權杖：API 存取權會透過 Google Cloud 機構管理，因此您不必再擔心要保護開發人員權杖或避免權杖外洩。您可以略過在 API 呼叫中傳送開發人員權杖，但仍需傳送存取權杖。

  • 為不同的應用程式維護個別的 Google API 控制台專案：Google Cloud 機構下連結的任何專案都會繼承該機構的 API 存取層級。這樣一來，您就能在這個組織下建立多個 Google API 控制台專案，用於細部專案管理、為不同應用程式建立個別專案，以及為團隊成員建立多個 Google API 控制台專案。

  • 更精細的配額監控和管理功能：您可以監控個別專案的 API 用量，或限制 API 用量。

必要條件

  • 已核准的開發人員權杖

    您應該已取得核准的開發人員權杖，才能使用這個選項。您可以在 Google Ads 管理員帳戶的 API 中心中找到現有的開發人員權杖。登入，然後依序前往「管理」>「API 中心」。在 API 中心中，依序前往「API 存取權」>「開發人員權杖」。

  • Google Cloud 機構

    Google Ads API 會將您的開發人員權杖與 Google Cloud 機構建立關聯，並使用該權杖判斷您的 API 存取層級。您可以透過多種方式建立 Google Cloud 機構。

    情境 步驟
    您是現有的 Google Workspace 或 Google Cloud Identity 客戶 您很可能已經擁有機構資源。您可以檢查並建立所需的資料夾。
    您未使用 Google Workspace 或 Google Cloud Identity 申請 Google Cloud Identity 免費版。然後 建立機構資源。
    上述選項均不適用於您的情況 說明您申請前測計畫時的情況，並要求 Google 為您建立機構資源。Google 將免費擁有及管理這項機構資源。

  • 為前測計畫準備 Google API 控制台專案

    您需要為前測計畫準備 Google API 控制台專案，以便搭配 Google Ads API 使用，步驟如下：

    情境 步驟
    您已擁有 Google Cloud 機構，或在上一個步驟中建立了機構 請確認您已在這個機構下啟用 Google Ads API 的所有 Google API 控制台專案。如果不是，請將其遷移至機構下。

    如果您是現有的 Google Workspace 或 Google Cloud Identity 客戶，Google API 控制台專案很可能已在貴機構下方，因此您可以略過這個步驟。
    您沒有 Google Cloud 機構，也無法在先前的步驟中建立機構 請確認您同時是 Google Ads API 管理員帳戶和 Google API 控制台專案的管理員使用者。您需要這項權限，才能在前測申請獲得核准後執行額外步驟。

  • 最新的 API 聯絡電子郵件

    確認 Google Ads API 聯絡電子郵件地址為最新狀態。您的 API 聯絡人詳細資料會列在 Google Ads API 管理員帳戶的 API Center 頁面中。登入，然後依序前往「工具與設定」>「設定」>「API 中心」。

申請加入測試計畫

註冊前測計畫。Google 法規遵循團隊會審查您的申請，並透過電子郵件將核准狀態和其他詳細資料寄到您的 API 聯絡電子郵件地址。

如果您要求 Google 為您建立 Google Cloud 機構，則需要執行幾個額外步驟：

  1. Google 會為您建立 Google 自有的 Cloud 機構資源。所有 Google Ads API 管理員帳戶管理員都會在新建立的機構中獲得 roles/resourcemanager.projectCreator 角色。

  2. Google 會透過電子郵件將新建立的機構資源詳細資料傳送至您的 API 聯絡人電子郵件地址。

  3. 您必須登入 Google API 控制台帳戶，然後按照操作說明將 Google API 控制台專案移至新機構。

  4. 回覆這封電子郵件，讓 Google 知道您的專案已移至新機構。

  5. Google 法規遵循團隊會審查您的申請，並透過電子郵件將核准狀態和其他詳細資料寄到您的 API 聯絡電子郵件地址。

修改 API 要求

您可以修改應用程式，停止在發出 API 呼叫時傳送 developer-token 標頭。這個步驟可選，但建議您一併完成。如果您參與前測計畫，Google Ads API 伺服器會忽略 API 要求中傳送的 developer-token。

Java

即將推出！

.NET

下載並安裝 Google Ads API .NET 程式庫 17.1.0 以上版本。

接著，請修改程式碼，如下所示：

// Create a client.
GoogleAdsClient client = new GoogleAdsClient();

// Opt into the pilot.
client.Config.UseCloudOrgForApiAccess = true;

// Make the API calls.
...

PHP

即將推出！

Python

即將推出！

小茹

即將推出！

Perl

即將推出！

HTTP 用戶端 (REST)

請在 HTTP 要求中省略 developer-token 標頭：

curl -i -X POST https://googleads.googleapis.com/v18/customers/CUSTOMER_ID/googleAds:searchStream \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "login-customer-id: LOGIN_CUSTOMER_ID" \
  --data-binary "@query.json"

常見問題

這項異動是否表示我必須是 Google Workspace 或 Google Cloud 客戶，才能使用 Google Ads API？

否。您需要擁有 Google Cloud 機構，可透過多種方式取得。這項規定與目前使用 Google Ads API 時需要 Google API 控制台專案的情況類似。

我需要變更 API 存取層級。我該如何做？

您目前應繼續使用 API 中心，要求變更任何 API 存取層級。

選擇加入這項前測計畫時，是否會造成任何服務中斷？

沒有。一旦獲得核准，Google Ads API 就會自動開始使用組織層級 API 存取權級別。

參與這項前測計畫需要投入多少心力？

程式碼變更最小化。大多數開發人員應能在 30 分鐘內完成應用程式變更。

選擇加入這項前測計畫後，是否需要付費？

一般來說，如果您選擇加入這項前測計畫，就不會產生費用。Google Ads API 提供免費服務，Google 不會對 Google Ads API 定價模式做出任何變更。

取得 Google Cloud 機構的可能情境如下：

  1. 您是 Google Workspace 或 Google Cloud Identity 的現有客戶：

    您只要照常使用這些產品，就會產生費用。為了參與這項前測計畫，您建立 Google Cloud 機構不會產生任何費用。

  2. 您已建立 Google Cloud Identity 免費版帳戶：

    為了參與這項前測計畫，您註冊 Google Cloud Identity 免費版帳戶或建立 Google Cloud 機構時，不會產生任何費用。

  3. Google 為您建立了 Cloud 機構資源：

    這是由 Google 管理的內部 Cloud 機構資源，因此您不會因此產生費用。

我有多個開發人員權杖，用於不同的工具。這項前測計畫對我有什麼影響？

我們不支援這個用途，因此您無法參與這項前測計畫。

這會影響我使用 Google Ads API 管理的帳戶現有 API 授權嗎？

不會。這項異動不會影響您使用 Google Ads API 管理的 Google Ads 帳戶的任何現有 API 授權。

我選擇加入這項前測計畫，但有問題或意見回饋。如何與支援小組聯絡？

請透過 API 技術支援頁面與 Google Ads API 團隊聯絡，並說明問題的性質。盡可能提供機構 ID 和要求與回應記錄等詳細資料。