Method: inventory.partners.feeds.record.batchDelete

刪除指定動態饋給類型的記錄。只會執行基本驗證 (例如格式錯誤的要求),然後立即將適當的回應傳回給合作夥伴。Google 會對要求執行非同步商業邏輯驗證。這項批次呼叫不保證不可分割性。

HTTP 要求

POST https://mapsbooking.googleapis.com/v1alpha/inventory/{parent=partners/*/feeds/*}/record:batchDelete

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
parent

string

資源名稱,格式為「partners/{partner_id}/feeds/{feed_name}」。

要求主體

要求主體會包含結構如下的資料:

JSON 表示法
{
  "records": [
    {
      object (GenericDeleteRecord)
    }
  ]
}
欄位
records[]

object (GenericDeleteRecord)

要刪除的記錄。單一 API 呼叫最多可有 1000 筆記錄。

回應主體

如果成功,回應主體會是空白的 JSON 物件。

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/mapsbooking

GenericDeleteRecord

要刪除的記錄,屬於網址要求中提及的動態饋給類型。

JSON 表示法
{
  "deleteTime": string,

  // Union field record_type can be only one of the following:
  "dataRecord": string,
  "protoRecord": {
    "@type": string,
    field1: ...,
    ...
  }
  // End of list of possible types for union field record_type.
}
欄位
deleteTime

string (Timestamp format)

必填。系統會根據這個時間戳記,決定對廣告空間套用刪除作業的順序。

使用 RFC 3339,產生的輸出內容一律會經過 Z 正規化,並使用 0、3、6 或 9 個小數位數,也接受「Z」以外的偏移量。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z""2014-10-02T15:01:23+05:30"

聯集欄位 record_type。封裝不同類型的動態消息 (ndjson、以 Proto 為基礎等) 合作夥伴可以提供完整記錄,類似於在動態饋給或 BatchPush API 中提供記錄的方式。合作夥伴也可以選擇只納入記錄中用於識別的必要欄位。record_type 只能是下列其中一項:
dataRecord

string (bytes format)

適用於非 Proto 型動態饋給。

Base64 編碼字串。

protoRecord

object

適用於以 Proto 為基礎的動態消息。

包含任意類型欄位的物件。額外的 "@type" 欄位則包含能辨識類型的 URI。範例:{ "id": 1234, "@type": "types.example.com/standard/id" }