Method: inventory.partners.feeds.record.batchPush

إدراج و/أو تعديل سجلّات نوع خلاصة محدّد لا يتم تنفيذ سوى عملية التحقق الأساسية (مثل الطلب المكتوب بشكل غير صحيح) والتي يتم بعدها عرض الرد المناسب إلى الشريك على الفور. تُجري Google عمليات تحقُّق من منطق النشاط التجاري على الطلب بشكلٍ غير متزامن. لا يضمن هذا الطلب المجمّع الاتزان.

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
parent

string

اسم المورد، بتنسيق - partners/{partner_id}/feeds/{feed_name}

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "records": [
    {
      object (GenericRecord)
    }
  ]
}
الحقول
records[]

object (GenericRecord)

السجلّات التي سيتم إدراجها و/أو تعديلها. يُسمح بـ 1,000 سجلّ كحد أقصى في استدعاء واجهة برمجة التطبيقات واحد.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يكون نص الاستجابة فارغًا.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

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

GenericRecord

سجلّ نوع الخلاصة المذكور في طلب عنوان URL.

تمثيل 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)

مطلوب. يُستخدم هذا الطابع الزمني لضمان الترتيب الصحيح لتعديلات المستودع.

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
حقل الاتحاد record_type. تغليف أنواع مختلفة من الخلاصات (ndjson، المستندة إلى Proto، وما إلى ذلك) يمكن أن يكون record_type واحدًا فقط مما يلي:
dataRecord

string (bytes format)

للخلاصات غير المستندة إلى أولي.

سلسلة بترميز base64.
protoRecord

object

بالنسبة إلى الخلاصات القائمة على النماذج الأوّلية.

كائن يحتوي على حقول من نوع عشوائي يحتوي الحقل الإضافي "@type" على معرف موارد منتظم (URI) يحدّد النوع. مثال: { "id": 1234, "@type": "types.example.com/standard/id" }