إدراج و/أو تعديل سجلّات نوع خلاصة محدّد لا يتم تنفيذ سوى عملية التحقق الأساسية (مثل الطلب المكتوب بشكل غير صحيح) والتي يتم بعدها عرض الرد المناسب إلى الشريك على الفور. تُجري Google عمليات تحقُّق من منطق النشاط التجاري على الطلب بشكلٍ غير متزامن. لا يضمن هذا الطلب المجمّع الاتزان.
طلب HTTP
POST https://mapsbooking.googleapis.com/v1alpha/inventory/{parent=partners/*/feeds/*}/record:batchPush
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
parent |
اسم المورد، بتنسيق - |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"records": [
{
object ( |
الحقول | |
---|---|
records[] |
السجلّات التي سيتم إدراجها و/أو تعديلها. يُسمح بـ 1,000 سجلّ كحد أقصى في استدعاء واجهة برمجة التطبيقات واحد. |
نص الاستجابة
إذا كانت الاستجابة ناجحة، يكون نص الاستجابة فارغًا.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/mapsbooking
GenericRecord
سجلّ نوع الخلاصة المذكور في طلب عنوان URL.
تمثيل JSON |
---|
{ "generationTimestamp": string, // Union field |
الحقول | |
---|---|
generationTimestamp |
مطلوب. يُستخدم هذا الطابع الزمني لضمان الترتيب الصحيح لتعديلات المستودع. طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
حقل الاتحاد record_type . تغليف أنواع مختلفة من الخلاصات (ndjson، المستندة إلى Proto، وما إلى ذلك) يمكن أن يكون record_type واحدًا فقط مما يلي: |
|
dataRecord |
للخلاصات غير المستندة إلى أولي. سلسلة بترميز base64. |
protoRecord |
بالنسبة إلى الخلاصات القائمة على النماذج الأوّلية. كائن يحتوي على حقول من نوع عشوائي يحتوي الحقل الإضافي |