تحديثات في الوقت الفعلي جاهزة

تتغير المستودعات في نظامك بسبب الحجوزات الجديدة وعمليات الإلغاء والتغييرات في الجدول الزمني التي يجريها التجّار. واجهة برمجة التطبيقات Real-Time Update (RTU) هي آلية لإبلاغ Google بهذه التغييرات والتغييرات التي تم إجراؤها على الحجوزات الحالية.

يجب الحصول على موافقة المستخدمين في الحالات التالية:

  • عندما يلغي المستخدم حجزًا في نظامك ويصبح الموعد متاحًا
  • عندما يحجز المستخدم موعدًا من خلال "مركز الإجراءات"، ولم يعُد الموعد متاحًا
  • عند إلغاء حجز تم إجراؤه من خلال "مركز الإجراءات" من جهتك يتضمّن مثال على ذلك إلغاء التاجر مباشرةً. عليك تعديل الحجز ومدى التوفّر لأنّ الفترة الزمنية الأصلية أصبحت متاحة الآن.

أكمِل مهمة المعلم الرئيسي التالية في "وقت التشغيل الفعلي" قبل الانتقال إلى مراجعة "البيئة التجريبية":

يتم وضع علامة "مكتملة" على كل مهمة ويتحوّل لونها إلى الأخضر عندما لا تتضمّن آخر 20 طلبًا أي أخطاء لمدة 14 يومًا. واصِل إرسال طلبات ناجحة لضمان بقاء الإنجاز باللون الأخضر.

بنود خدمة واجهة برمجة التطبيقات والخلاصات

تُعلم واجهات برمجة التطبيقات الخاصة بوحدات RTU شركة Google بالتغييرات المتزايدة في مدى توفّر المستودع الإعلاني والحجوزات في الوقت الفعلي. بالإضافة إلى أسعار الوحدات السكنية المتاحة للاستئجار، أرسِل خلاصات التوفّر الكاملة يوميًا. يضمن ذلك حصول Google على معلومات دقيقة وحديثة حول مدى التوفّر كما تظهر في نظامك. تعمل خلاصات الإكمال كلقطة للحالة الأخيرة لمدى توفّر المستودع في نظامك.

لمزيد من المعلومات، يُرجى الاطّلاع على المراجع التالية:

الوصول إلى واجهة برمجة التطبيقات

يُعدّ مشروعك على Google Cloud الطريقة التي يمكنك من خلالها الوصول إلى واجهة برمجة التطبيقات Maps Booking API في "مركز الإجراءات"، وهي الطريقة التي يمكنك من خلالها إرسال وحدات RTU. يجب استخدام حساب Google ضمن Google Developers Console وتقديم رقم مشروعك على السحابة الإلكترونية في مرحلة الإعداد من خطة الإعداد. لمزيد من المعلومات حول كيفية تفعيل واجهات Cloud API، يُرجى الاطّلاع على تفعيل واجهات Cloud API.

استخدام طلبات RESTful أو تنزيل مكتبة البرامج

ننصحك بإجراء طلبات RESTful مباشرةً إلى Maps Booking API باستخدام حمولات JSON. لمزيد من المعلومات، يُرجى الاطّلاع على مستندات REST API.

يمكنك أيضًا استخدام مكتبات برامج العميل للاتصال بواجهة برمجة التطبيقات.

.
اللغة رابط التنزيل
Java مكتبة برامج Java لمزيد من المعلومات، يُرجى الاطّلاع على تعليمات عميل Java.

تتوفّر مكتبات دعم إضافية يمكن تنزيلها وتتولّى عملية منح الإذن والجوانب الأخرى من الطلبات إلى Google APIs. لمزيد من المعلومات، يُرجى الاطّلاع على نماذج الرموز.

استرجاع مستند Discovery

بالنسبة إلى بعض مكتبات البرامج، مثل Ruby، من الضروري استرداد مستند Discovery الخاص بواجهة برمجة التطبيقات الذي يصف طرقها ومَعلماتها.

لاسترداد مستند Discovery، استخدِم الأمر التالي:

curl -s -o mapsbooking_rest

https://mapsbooking.googleapis.com/$discovery/rest?version=v1alpha

لمزيد من المعلومات حول كيفية الوصول إلى واجهة برمجة التطبيقات من Ruby، يُرجى الاطّلاع على Ruby API Client وRuby Auth Library.

إجراء طلبات معتمَدة إلى واجهة برمجة التطبيقات

عند إجراء طلبات إلى واجهة برمجة التطبيقات، يُرجى الرجوع إلى الاستعداد لإجراء طلب مفوّض إلى واجهة برمجة التطبيقات لتفويض حساب الخدمة باستخدام مفتاحك الخاص ونطاق OAuth التالي:

https://www.googleapis.com/auth/mapsbooking

نقاط نهاية وضع الحماية والإنتاج

يمكنك إجراء مكالمات إلى كلّ من بيئة وضع الحماية وبيئة الإنتاج من خلال واجهة برمجة التطبيقات. تأكَّد من تفعيل كلتا واجهتَي برمجة التطبيقات في مشروعك على Google Cloud. تستخدم كلتا واجهتَي برمجة التطبيقات النطاق نفسه، ولكن لديهما نقاط نهاية مختلفة.

نقطة نهاية الإنتاج: https://mapsbooking.googleapis.com/

نقطة نهاية وضع الحماية: https://partnerdev-mapsbooking.googleapis.com/

في ما يلي مثال بلغة Java على كيفية التبديل بين نقاط النهاية:

 // This block of code is for OAuth and is the same for prod and sandbox.
    GoogleCredential
      .fromStream(new FileInputStream(...))
      .createScoped(Collections.singleton("https://www.googleapis.com/auth/mapsbooking"))

    // This block of code sets the endpoint. This is what you'd change to connect to the sandbox.
    new GoogleMapsBookingAPI.Builder(...)
      .setApplicationName(...)
      .setRootUrl("https://partnerdev-mapsbooking.googleapis.com/") // you add this to change the endpoint to use partnerdev.
      .build()