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 سجلّ كحد أقصى في طلب واحد من واجهة برمجة التطبيقات.

نص الاستجابة

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

نطاقات الأذونات

يجب توفير نطاق 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)

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

يستخدم المعيار 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-based، وما إلى ذلك) يمكن أن يكون التعليق record_type إحدى القيم التالية فقط:
dataRecord

string (bytes format)

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

سلسلة مرمّزة باستخدام Base64
protoRecord

object

بالنسبة إلى الخلاصات المستندة إلى بروتوكول تبادل البيانات

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