يقدّم هذا القسم المزيد من التفاصيل حول الأجزاء الرئيسية الثلاثة لعملية الدمج مع "مركز الإجراءات". ستستخدم كلّاً من هذه العناصر في الخطوات الموضّحة في دليل شامل.
الخلاصات
الخلاصات هي ملفات بتنسيق JSON أو pb3 تُستخدَم لنقل بيانات المستودع إلى "مركز الإجراءات". يتيح لك ذلك إرسال جميع بياناتك دفعة واحدة لتعديل التجار والخدمات وفترات التوفّر باستخدام عملية تحميل عبر بروتوكول SFTP.
Maps Booking API
تتيح لك واجهة Maps Booking API تعديل العناصر في نظام "مركز الإجراءات" بين عمليات إرسال الخلاصات للحفاظ على تحديث المعلومات. تتيح لك واجهة برمجة التطبيقات أيضًا إلغاء الحجوزات التي تم إجراؤها من خلال عملية الدمج الشاملة في "الحجز عبر Google".
يتم تنفيذ ميزة "الإشعارات في الوقت الفعلي" باستخدام طلبات REST.
خادم الحجز
لكي يتيح لك عملية الدمج الشاملة في "مركز الإجراءات" إنشاء حجوزات نيابةً عنك، عليك إعداد خادم الحجز.
REST API
الإصدار 3 هو أحدث إصدار من واجهة برمجة التطبيقات، ويتوافق مع واجهة مستندة إلى REST. يجب أن تستخدم جميع عمليات الدمج الجديدة الإصدار 3 من واجهة برمجة التطبيقات.
يحدّد هذا القسم ملفات الخلاصة المستخدَمة لنقل بيانات المخزون إلى "مركز الإجراءات". تحدّد محتويات خلاصاتك الخدمات التي تقدّمها والخدمات المتاحة وأوقات توفّرها.
اطّلِع على قائمة أكورديون المراجع والنماذج لمعرفة كيفية مشاركة هذه الخلاصات معنا.
يتم تحديد بنية خلاصات مستودع المنتجات من خلال واجهة برمجة التطبيقات Google Maps Booking.
يجب توفّر الخلاصة التالية في أي عملية دمج:
- خلاصة التجّار: تحتوي على بيانات تصف التجّار.
بالإضافة إلى ذلك، يجب توفير الخلاصةَين التاليتَين لإتمام عملية الدمج الشامل.
- خلاصة الخدمات: تصف الخدمات التي يقدّمها التجّار.
- خلاصة بيانات التوفّر: تعرض هذه الخلاصة خانات التوفّر للخدمات التي يقدّمها التجّار.
بعض الحقول في هذه الخلاصات مطلوبة والبعض الآخر اختياري. يمكن حذف أي حقل تم تصنيفه على أنّه اختياري من الخلاصة عندما يكون فارغًا.
يتم وصف تنسيق الخلاصات باستخدام بنية Protocol Buffers 3. يمكنك تحميل ملف الخلاصات كتسلسل ثنائي لبيانات بروتوكول المخزن المؤقت بتنسيق pb3 أو بتنسيق JSON مشتق. ننصحك بتحميل الخلاصات بتنسيق JSON.
ننصحك باستخدام gzip لضغط الخلاصات قبل تحميلها.
هذا الدليل خاص بمخازن بروتوكولات "مركز الإجراءات". للحصول على معلومات عامة حول كيفية استخدام مخازن البروتوكول لإنشاء ملف pb3، إليك مثال بلغة Java.