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)

السجلّات التي سيتم إدراجها و/أو تعديلها يُسمح بحد أقصى 1000 سجلّ في طلب بيانات واحد من واجهة برمجة التطبيقات.

نص الاستجابة

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

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

يجب توفير نطاق 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 "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
حقل الربط record_type تجميع أنواع مختلفة من الخلاصات (ndjson وproto-based وما إلى ذلك) يمكن أن يكون record_type واحدًا فقط مما يلي:
dataRecord

string (bytes format)

للخلاصات غير المستندة إلى proto

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

object

للخلاصات المستندة إلى النماذج

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