REST 介面設計

本頁面假設您對「資源導向」 設計和資源 開發人員指南和名稱 並可提供 Google Ads API 具體導入詳情。

資源導向設計

一般而言，Google Ads API 會採用資源導向的設計， 可個別呼叫的資源 (API 的「名詞」)。 資源是以資源名稱做為參照，並使用少量 方法組合 (也稱為「動詞」或「作業」)。

這些資源名稱和方法 加上特定的 API 版本前置字串，即可包含 REST 介面的網址。 舉例來說，您可以把下列網址細分成這些個別元件 如下表所示：

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

API 版本前置字串	資源名稱 (相對名稱)	方法
https://googleads.googleapis.com/v17	customers/1234567890	mutate

特定 API 版本的所有 REST 網址 (例如v17) 都會使用相同的 API 版本前置字串資源名稱和方法結合 識別所呼叫的 API 服務

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

以下頁面進一步說明 Google Ads API 資源 名稱、服務方法和 JSON 命名慣例來說明使用方式 藉此定義 REST 介面端點