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