本頁面由 Cloud Translation API 翻譯而成。

雲端代管的存取層級

這項功能可讓 Google Cloud 管理 API 存取層級組織，具有下列優點：

不必再保護開發人員權杖：API 存取權是透過因此您不必再費心維護或洩漏開發人員權杖您可以選擇略過傳送開發人員權杖將存取權杖儲存在 API 呼叫中，但您仍需傳送存取權杖。
為不同的應用程式分別維護不同的 Google API 控制台專案： Google Cloud 機構下連結的所有專案都會繼承 API 存取層級您可以藉此建立多個這個機構下的 Google API 控制台專案，例如：精細的專案管理、不同應用程式的不同專案以及建立多項 Google API 控制台專案
進一步監控及管理配額：您可以監控 API 個別專案的用量或限制 API 用量。

必要條件

已核准的開發人員權杖

您應該已有已核准的開發人員權杖，才能使用這個選項。個人中心可在應用程式的「API 中心」頁面，找到現有的開發人員權杖 Google Ads 管理員帳戶。登入然後瀏覽至工具與設定 >設定 >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 Cloud 會為您管理安全性Google 將擁有並管理這項機構資源，費用。

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

您必須準備要搭配 Google Ads API 使用的 Google API 控制台專案加入前測計畫，方法如下：

情境	步驟
您已有 Google Cloud 機構，或是已在上一步	請確定您已啟用 Google Ads API 位於這個機構之下。如果沒有，請建立機構如果您是Google Workspace 或 Google Cloud 身分客戶，Google API 控制台專案可能為已經啟用，因此可略過這個步驟。
您沒有 Google Cloud 機構，無法在其中建立機構上一步	確認您是 Google Ads API 管理員的管理員使用者帳戶和 Google API 控制台專案。必須具備這項權限才能前測申請通過核准後，執行額外的步驟。

最新的 API 聯絡電子郵件

確認您的 Google Ads API 聯絡電子郵件地址是最新的。您的 API 聯絡人您可以在 Google Ads API 管理員帳戶的「API 中心」頁面上，查看詳細資料。登入並前往 [工具] 和設定 >設定 >API 中心。

申請加入前測計畫。Google 法規遵循團隊將然後審查您的申請，並傳送電子郵件至 API 聯絡電子郵件地址核准狀態等等

如果您要求 Google 為您建立 Google Cloud 機構，還須完成另外幾個步驟：

Google 會為您建立 Google 自有的 Cloud 機構資源。所有語言 Google Ads API 管理員帳戶的系統管理員將授予新建立的「roles/resourcemanager.projectCreator」角色並根據貴機構的使命價值觀和目標進行調整
Google 會寄送電子郵件給您的 API 聯絡電子郵件地址，並附上新建立的機構資源
請登入 Google API 控制台帳戶，然後按照操作說明：遷移 Google API 控制台專案。新機構
請回覆這封電子郵件，讓 Google 知道您的專案已移至新機構。
Google 法規遵循團隊會審查您的申請，並透過電子郵件將 API 傳送給 API 列出核准狀態和其他詳細資料的聯絡電子郵件地址。

修改 API 要求

您可以修改應用程式，在出現以下情況時停止傳送 developer-token 標頭：發出 API 呼叫這不是必要步驟，但建議執行。如果您在前測計畫，如果傳送的是 developer-token，Google Ads API 伺服器會忽略 developer-token 與 API 要求的關係

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

即將推出！

小茹

即將推出！

Perl

即將推出！

HTTP 用戶端 (REST)

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

curl -i -X POST https://googleads.googleapis.com/v17/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 不會對 Google Ads API 進行任何變更定價模式。

取得 Google Cloud 機構的可能原因如下：如下：

如果您目前是 Google Workspace 或 Google Cloud Identity 客戶：

我們會照常向您收取這些產品的一般使用費用。個人中心建立 Google Cloud 機構不會產生費用參與這項前測計畫
您已建立 Google Cloud Identity 免費版帳戶：

申請 Google Cloud Identity 免費版時，不會產生費用或建立 Google Cloud 機構參與這項前測計畫
Google 已為您建立 Cloud 機構資源：

這是 Google 代管的內部 Cloud 機構資源，就不會因此收費

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

目前不支援這個用途，因此你無法參與此計畫前測。

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

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

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

使用 API 技術支援服務與 Google Ads API 團隊聯絡網頁，並說明問題的性質。包含例如，貴機構 ID 以及要求和回應記錄