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,例如 listgetcreateupdatedelete。Google Ads API 中的自訂方法範例 包括 searchsearchStreammutate

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