API Reference

本 API 參考資料是依照資源類型編排。各個資源類型都具有一或多種資料表示法，以及一或多種方法。

資源類型

  1. 轉換
  2. 報表
  3. SavedColumn

轉換

如要進一步瞭解轉換資源詳細資料，請參閱資源表示法網頁。

方法 HTTP 要求 說明
相對於 https://www.googleapis.com/doubleclicksearch/v2 的 URI (除非另有註明)
get GET  /agency/agencyId/advertiser/advertiserId/engine/engineAccountId/conversion 從 DoubleClick Search 引擎帳戶擷取轉換清單。

必要的查詢參數： endDate、rowCount、startDate、startRow
getByCustomerId GET  /customer/customerId/conversion 使用新的 Search Ads 360 客戶 ID，從 DoubleClick Search 引擎帳戶擷取轉換清單。

必要的查詢參數： endDate、rowCount、startDate、startRow
插入 POST  /conversion 將一批新轉換插入 DoubleClick Search。
更新 PUT  /conversion 在 DoubleClick Search 中更新整批轉換。
updateAvailability POST  /conversion/updateAvailability 更新 DoubleClick Search 中一批 Floodlight 活動的可用性。

報表

如要進一步瞭解「報表資源」，請參閱資源表示法網頁。

方法 HTTP 要求 說明
相對於 https://www.googleapis.com/doubleclicksearch/v2 的 URI (除非另有註明)
generate POST  /reports/generate 立即產生並傳回報表。
get GET  /reports/reportId 報告要求狀態的輪詢。
getFile GET  /reports/reportId/files/reportFragment 下載以 UTF-8 編碼的報表檔案。
getIdMappingFile GET  /agency/agencyId/advertiser/advertiserId/idmapping 下載以 UTF-8 編碼的 CSV 檔案，當中包含舊版 Search Ads 360 與新版 Search Ads 360 之間的 ID 對應。針對請求的廣告客戶，檔案會納入舊版和新版 Search Ads 360 中的所有子實體 (例如引擎帳戶、廣告活動、廣告群組等)。
request POST  /reports 將報表要求插入報表系統。

SavedColumns

如要進一步瞭解 SavedColumn 資源，請參閱資源表示法網頁。

方法 HTTP 要求 說明
相對於 https://www.googleapis.com/doubleclicksearch/v2 的 URI (除非另有註明)
list GET  /agency/agencyId/advertiser/advertiserId/savedcolumns 擷取特定廣告主的已儲存資料欄清單。