REST 介面設計

本頁內容假設您熟悉資源導向設計和資源名稱開發人員指南，並補充了 Search Ads 360 Reporting API 的特定導入詳細資料。

資源導向設計

一般來說，Search Ads 360 Reporting API 會採用資源導向的設計，模擬為可個別呼叫的資源 (API 的「名詞」) 的「集合」。資源會被參照資源名稱，並且使用少數一組「方法」 (也稱為「動詞」或「作業」) 來操控。

這些資源名稱和方法，搭配特定的 API 版本前置字串，組成了 REST 介面的網址。舉例來說，下列網址可依下表細分為這些個別元件：

https://searchads360.googleapis.com/v0/customers/1234567890/searchAds360:search
API 版本前置字串 資源名稱 (相對) 方法
https://searchads360.googleapis.com/v0 customers/1234567890 search

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

Search Ads 360 Reporting API 大量使用自訂方法，而非大多數傳統 REST API 所使用的標準 REST 方法，例如 list 和 get。Search Ads 360 Reporting API 包含兩種自訂方法：search 和 searchStream。

以下頁面將進一步說明 Search Ads 360 Reporting API 的資源名稱、服務方法和 JSON 命名慣例，協助您瞭解如何搭配使用這些名稱來定義 REST 介面端點。