عند إجراء طلب استبدال معلومات التوفّر باستخدام معرّف تاجر أو
معرّف خدمة غير صالحَين، لن تظهر رسالة خطأ. ويعود السبب في ذلك إلى أنّه
يمكن تنفيذ التغييرات على خانات مدى التوفّر من خلال طلبات البحث عن معلومات المنتجات بدون ترتيب معيّن، وبالتالي
لا تكون مرتبطة بمعرّف التاجر أو معرّف الخدمة. ومع ذلك، لن يتم عرض الفتحات
في الطلب في قناة الإصدار العلني بسبب عدم صلاحية
merchantId أو serviceId. لعرض الشرائح، يُرجى إضافة
التاجر أو الخدمة غير المتوفّرة من خلال طلبات البحث عن المنتجات أو الخلاصات.
في جميع دوال التعديل، يجب أن تكون المَعلمة updateMask بتنسيق
FieldMask لتحديد الحقول التي سيتم تعديلها. يجب أن تغيِّر واجهة برمجة التطبيقات
قيم الحقول فقط على النحو المحدّد في القناع
وتترك القيم الأخرى بدون تغيير. في حال تم إدخال سلسلة updateMask غير صحيحة،
لن يتم تطبيق التعديل. إذا لم يكن هناك قناع حقل عند إجراء عملية تعديل،
يتم تطبيق العملية على جميع الحقول (كما لو تم تحديد قناع حقل لكل الحقول). إذا كنت تريد تعديل كل الحقول، ما عليك سوى ضبط
updateMask على القيمة فارغة.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eDownload the Java real-time update API client and sample code to get started with implementing real-time updates for your booking services.\u003c/p\u003e\n"],["\u003cp\u003eYou will need a service account with a downloaded private key to use the client.\u003c/p\u003e\n"],["\u003cp\u003eThe client library allows you to manage inventory and booking notifications, and more details on the REST API are available in the documentation.\u003c/p\u003e\n"],["\u003cp\u003eTroubleshooting information is provided for common issues such as entity conflicts, invalid IDs, and update mask usage.\u003c/p\u003e\n"],["\u003cp\u003eRemember that zero-valued fields are not displayed in responses from the API.\u003c/p\u003e\n"]]],["Download the Java real-time update API client and library. Create a Java project, import the sample code files, `InventoryUpdate.java` and `BookingNotification.java`, and copy your private key to the `src` directory. Add the Java Client Library to your project dependencies. Follow the TODOs in the Java files to complete implementation. Be aware of 409 errors with existing IDs. Replace availability calls won't throw errors with invalid IDs. Ensure the 'updateMask' parameter is in FieldMask format in update functions.\n"],null,[]]
