這項功能可讓 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 控制台專案
您必須為 Beta 版計畫準備與 Google Ads API 搭配使用的 Google 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 機構,則需要完成幾個額外步驟:
Google 會為您建立 Google 擁有的 Cloud 機構資源。系統會在新建立的機構中,為 Google Ads API 管理員帳戶的所有管理員授予
roles/resourcemanager.projectCreator
角色。Google 會將新建立的機構資源詳細資料,傳送至您的 API 聯絡電子郵件地址。
您必須登入 Google API 控制台帳戶,然後按照操作說明將 Google API 控制台專案移至新機構。
回覆該電子郵件,讓 Google 知道您的專案已移至新機構。
Google 法規遵循團隊會審查您的申請,並透過 API 聯絡電子郵件地址,通知您核准狀態和其他詳細資訊。
修改 API 要求
您可以修改應用程式,在發出 API 呼叫時停止傳送 developer-token
標頭。雖然這是選擇性設定,但我們仍建議您採取這個步驟。如果您參與試用計畫,Google Ads API 伺服器會忽略 developer-token
(如果該要求是透過 API 傳送)。
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/v20/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"
常見問題
以下是 Cloud 管理存取層級的常見問題。
這項異動是否表示我必須是 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 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、要求和回應記錄。