Method: inventory.partners.feeds.record.batchDelete

رکوردهای نوع فید مشخص شده را حذف می‌کند. فقط اعتبارسنجی اولیه (مانند درخواست ناقص) را انجام می‌دهد و پس از آن پاسخ مناسب بلافاصله به شریک بازگردانده می‌شود. گوگل اعتبارسنجی منطق تجاری را روی درخواست به صورت ناهمزمان انجام می‌دهد. این فراخوانی دسته‌ای، اتمی بودن را تضمین نمی‌کند.

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای مسیر

پارامترها
parent

string

نام منبع، که قالب آن به صورت - partners/{partner_id}/feeds/{feed_name} است.

درخواست بدنه

بدنه درخواست شامل داده‌هایی با ساختار زیر است:

نمایش JSON
{
  "records": [
    {
      object (GenericDeleteRecord)
    }
  ]
}
فیلدها
records[]

object ( GenericDeleteRecord )

رکوردهایی که باید حذف شوند. حداکثر ۱۰۰۰ رکورد در یک فراخوانی API مجاز است.

بدنه پاسخ

در صورت موفقیت، بدنه پاسخ یک شیء JSON خالی خواهد بود.

دامنه‌های مجوز

به محدوده OAuth زیر نیاز دارد:

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

رکورد حذف عمومی

رکوردی که قرار است حذف شود، از نوع فید ذکر شده در درخواست آدرس اینترنتی است.

نمایش 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-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

فیلد Union record_type . انواع مختلف فید (ndjson، proto-based و غیره) را کپسوله می‌کند. همکار می‌تواند یک رکورد کامل مشابه نحوه ارائه یک رکورد در یک فید یا BatchPush API ارائه دهد. همکاران همچنین می‌توانند فقط فیلدهای ضروری یک رکورد را که برای شناسایی منحصر به فرد آن لازم است، درج کنند. record_type فقط می‌تواند یکی از موارد زیر باشد:
dataRecord

string ( bytes format)

برای فیدهای غیر مبتنی بر پروتو.

یک رشته کدگذاری شده با base64.

protoRecord

object

برای فیدهای مبتنی بر پروتو.

یک شیء حاوی فیلدهایی از نوع دلخواه. یک فیلد اضافی "@type" حاوی یک URI است که نوع را مشخص می‌کند. مثال: { "id": 1234, "@type": "types.example.com/standard/id" } .