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