本頁內容假設您熟悉資源導向設計和資源名稱開發人員指南，並補充了 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 介面端點。