Method: inventory.partners.feeds.record.batchPush

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

درخواست HTTP

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

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

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

پارامترها
parent

string

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

درخواست بدنه

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

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

object ( GenericRecord )

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

بدنه پاسخ

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

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

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

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

رکورد عمومی

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

نمایش JSON 
{
  "generationTimestamp": 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.
}
فیلدها
generationTimestamp

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" .

فیلد یونیون record_type . انواع مختلف feed (ndjson، proto-based و غیره) را کپسوله می‌کند. record_type فقط می‌تواند یکی از موارد زیر باشد:
dataRecord

string ( bytes format)

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

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

protoRecord

object

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

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