本頁面假設您對「資源導向」 設計和資源 開發人員指南和名稱 並可提供 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 介面端點