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

string (bytes format)

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

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

object

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

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