雲端代管的存取層級

這項功能可讓您由 Google Cloud 機構管理您的 API 存取層級，享有以下好處：

  • 不必再保護開發人員權杖：API 存取權是透過 Google Cloud 機構管理，您不必再擔心開發人員權杖安全無虞或外洩。您可以略過在 API 呼叫中傳送開發人員權杖的步驟，但仍然需要傳送存取權杖。

  • 為不同應用程式保留個別的 Google API 控制台專案：在 Google Cloud 機構下連結的任何專案，都會沿用機構的 API 存取層級。這樣就能在此機構下建立多個 Google API 控制台專案，以用於管理精細的專案管理、為不同應用程式使用不同的專案，以及為團隊成員建立多個 Google API 控制台專案。

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

必要條件

  • 已核准的開發人員權杖

    您應該已有已核准的開發人員權杖，才能使用這個選項。您可以在 Google Ads 管理員帳戶的「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 聯絡電子郵件地址是最新的。您可以在 Google Ads API 管理員帳戶的「API 中心」頁面上找到 API 聯絡人詳細資料。登入，然後前往「工具與設定」>「設定」>「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 要求中一併傳送，則 Google Ads API 伺服器會忽略 developer-token。

Java

即將推出！

.NET

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

接著，按照下列方式修改程式碼：

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

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

// Make the API calls.
...

PHP

即將推出！

Python

即將推出！

Ruby

即將推出！

Perl

即將推出！

HTTP 用戶端 (REST)

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

curl -i -X POST https://googleads.googleapis.com/v16/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 API 控制台專案使用 Google Ads 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 和要求和回應記錄。