Google Ads API 的設計與傳統的 REST 架構不同,因為前者的主要使用方式是自訂方法,例如 search
和 mutate,
,而非傳統的 list
、get
、create
、update
和 delete
方法。
這些動作會以 REST 網址表示,透過 :
的 HTTP 對應慣例將自訂動詞與網址的其他部分分開。
舉例來說,廣告活動 Modify API 呼叫會使用下列網址:
https://googleads.googleapis.com/v17/customers/1234567890/campaigns:mutate
這個 API 使用自訂方法的其中一個好處,就是可以將多個作業批次處理成單一 API 要求。嚴格的 REST 語意一次只能更新一個廣告活動。舉例來說,傳統的廣告活動 update
需要為每個廣告活動資源傳送一個 HTTP PATCH 要求。
Google Ads API 會盡可能為大多數資源定義自訂 mutate
方法,方便您將多個作業打包在單一要求內文中。同樣地,為了從 API 啟用批次讀取 (一次擷取多個物件),這個 API 會使用自訂的 search
方法,並提供類似 SQL 的 Google Ads 查詢語言。