服務方法

Google Ads API 的設計與傳統的 REST 架構不同,因為前者的主要使用方式是自訂方法,例如 searchmutate,,而非傳統的 listgetcreateupdatedelete 方法。 這些動作會以 REST 網址表示,透過 :HTTP 對應慣例將自訂動詞與網址的其他部分分開。

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

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

這個 API 使用自訂方法的其中一個好處,就是可以將多個作業批次處理成單一 API 要求。嚴格的 REST 語意一次只能更新一個廣告活動。舉例來說,傳統的廣告活動 update 需要為每個廣告活動資源傳送一個 HTTP PATCH 要求。

Google Ads API 會盡可能為大多數資源定義自訂 mutate 方法,方便您將多個作業打包在單一要求內文中。同樣地,為了從 API 啟用批次讀取 (一次擷取多個物件),這個 API 會使用自訂的 search 方法,並提供類似 SQL 的 Google Ads 查詢語言

「常用方法」頁面會詳細介紹 Google Ads API 中最常用的方法。