服務方法

Google Ads API 的設計與傳統 REST 架構不同，因為它主要使用自訂方法，例如 search 和 mutate,，而非較傳統的 list、get、create、update 和 delete 方法。這些動作會以 REST 網址表示，方法是使用 HTTP 對應慣例，以 : 將自訂動詞與網址的其餘部分分開。

舉例來說，廣告活動變動 API 呼叫會使用下列網址：

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

API 使用自訂方法的原因之一，是為了將多項作業分批處理為單一 API 要求。嚴格的 REST 語意一次只能更新一個廣告活動。舉例來說，如果使用傳統 REST update 對廣告活動執行作業，您必須為每個廣告活動資源傳送一個 HTTP PATCH 要求。

為了允許在單一要求主體中將多項作業捆綁在一起，Google Ads API 會為大多數資源定義自訂 mutate 方法。同樣地，如要從 API 啟用批次讀取 (一次擷取多個物件)，API 會使用自訂 search 方法和類似 SQL 的 Google Ads 查詢語言。

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