عميل Java Booking API

يمكنك تنزيل عميل واجهة برمجة التطبيقات للتحديث في الوقت الفعلي في Java للمساعدة في بدء التنفيذ التحديثات في الوقت الفعلي.

متطلب أساسي:

أنشئ حساب الخدمة، ونزِّل مفتاحك الخاص.

البدء:

1. تنزيل فكّ مكتبة برامج Java لفك ضغط الملف للحصول على "mapsbooking" طرد.

2. قم بإنشاء مشروع جافا في IDE الخاص بك، وقم بتنزيل نماذج الأكواد InventoryUpdate.java و BookingNotification.java من هذا المستودع:

   git clone https://maps-booking.googlesource.com/java-maps-booking-api-example
   

   واستيرادها إلى مشروع جافا ضمن دليل src.

3. أنشِئ نسخة من المفتاح الخاص (ملف JSON) في دليل src.
4. إضافة مكتبة عميل Java إلى اعتماديات مشروعك (قم بتضمين ملفات jar ضمن دليل mapsbooking وlibs-sources).
5. في كلا ملفي جافا، اتّبِع قائمة المهام لإكمال عمليات التنفيذ.

يمكن الاطلاع على مزيد من التفاصيل حول REST API تم العثور عليها هنا.

تحرّي الخلل وإصلاحه:

1. عند محاولة إنشاء تاجر/خدمة جديدة باستخدام معرّف MerchantId أو ServiceId، ستظهر لك رسالة الخطأ التالية:

   409 Conflict
   {
     “code” : 409,
     “errors” :
       [{
           “domain” : “global”,
           “message” : “Requested entity already exists”,
           “reason” : “alreadyExists”,
           “debugInfo” : “detail: "[ORIGINAL ERROR] generic::already_exists: ...”\n"
       }],
     “message” : “Requested entity already exists”,
     “status” : “ALREADY_EXISTS”
   }
   

2. عند إجراء طلب بديل عن مستند معلومات التوفّر باستخدام معرّف MerchantId غير صالح أو ServiceId، لن يعرض الاتصال رسالة خطأ. هذا بسبب تتيح التغييرات التي تطرأ على خانات التوفّر من خلال تعديلات التعديلات في الوقت الفعلي التنفيذ خارج الطلب وبالتالي لا تكون مرتبطة بمعرّف التاجر أو serviceId ومع ذلك، فإن الخانات في الطلب لن يتم عرضها في عملية الإنتاج بسبب معرّف التاجر أو معرّف الخدمة لإتاحة عرض الخانات، يُرجى إضافة عدم توفّر التاجر أو الخدمة من خلال تعديلات الإحالات الناجحة (RTU) أو الخلاصات
3. في جميع وظائف التحديث، يجب أن تكون المَعلمة "updateMask" تنسيق FieldMask لتحديد الحقول المطلوب تعديلها. واجهة برمجة التطبيقات هي مطلوب لتغيير قيم الحقول فقط كما هو محدد في القناع وترك الآخرين كما هو. إذا مررت سلسلة updateMask الخاطئة، لن يتم تطبيق التحديث. إذا لم يكن قناع الحقل موجودًا عند التحديث، تنطبق العملية على جميع الحقول (كما لو كان قناع الحقل لجميع الحقول يحتوي على محددة). لذا، إذا كنت تريد تحديث جميع الحقول، فما عليك سوى تعيين قناع التحديث فارغ.
4. لا يظهر في الرد أي حقل يحتوي على قيمة صفرية.