服務方法

Google Ads API 的設計與傳統的 REST 架構不同 因為容器主要使用 searchmutate, 等自訂方法 較傳統的 listgetcreateupdatedelete 方法。 這些動作會以 REST 網址表示,方法是利用 HTTP 對應 : 的慣例,藉此區隔自訂動詞與網址的其他部分。

舉例來說,廣告活動的 變更 API 呼叫會使用下列網址:

https://googleads.googleapis.com/v17/customers/1234567890/campaigns:mutate

這個 API 使用自訂方法的其中一個原因是 將作業整合到單一 API 要求中嚴格 REST 語意只會 一次更新一個廣告活動。傳統 REST 將 update 轉換為 比如說,每個廣告活動可能都需要傳送一個 HTTP PATCH 請求 資源。

為了允許在單一要求主體中組合多項作業, Google Ads API 會改為為多數資源定義自訂的 mutate 方法。 同樣地,如要透過 API 啟用批次讀取 (一次擷取多個物件), API 使用自訂 search 方法,搭配類似 SQL 的 Google Ads 查詢 語言

常見方法」頁面會詳細說明 Google Ads API 中最常用的方法。