REST 介面設計

本頁面假設您已熟悉資源導向設計和資源名稱開發人員指南，並補充說明 Google Ads API 的具體實作細節。

資源導向設計

一般來說，Google Ads API 採用資源導向設計，以可個別呼叫的「資源」 (API 的「名詞」)「集合」做為模型。不同的資源有各自的參照名稱，並且是透過一套「方法」 (又稱為「動詞」或「作業」) 來操控。

這些資源名稱和方法會與特定 API 版本前置字串合併，組成 REST 介面的網址。舉例來說，根據下表，以下網址可細分為這些個別元件：

https://googleads.googleapis.com/v20/customers/1234567890:mutate

特定 API 版本的所有 REST 網址 (例如 v20) 共用常見的 API 版本前置字串。資源名稱和方法會共同識別要呼叫的 API 服務。

Google Ads API 大量使用自訂方法，而非大多數傳統 REST API 所用的標準 REST 方法，例如 list、get、create、update 和 delete。Google Ads API 中的自訂方法範例包括 search、searchStream 和 mutate。

以下頁面將詳細說明 Google Ads API 的資源名稱、服務方法和 JSON 命名慣例，並說明如何一併使用這些項目來定義 REST 介面端點。