לקוח Java Booking API

ניתן להוריד לקוח API לעדכון בזמן אמת של Java כדי לעזור לך להתחיל בהטמעה עדכונים בזמן אמת.

דרישה מוקדמת:

יוצרים חשבון שירות, מורידים את המפתח הפרטי.

איך מתחילים:

  1. מורידים את ספריית לקוח של Java מחלצת את הקובץ כדי לקבל את הקובץ 'mapsbooking' חבילה.
  2. יוצרים פרויקט של Java בסביבת הפיתוח המשולבת (IDE), מורידים את הקודים לדוגמה InventoryUpdate.java ו BookingNotification.java מהמאגר הזה:

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

    ומייבאים אותם לפרויקט JavaScript בספריית src.

  3. יוצרים עותק של המפתח הפרטי (קובץ JSON) לספריית src.
  4. הוספה של ספריית הלקוח של Java ליחסי התלות של הפרויקט (כולל קובצי מאגר תגים ב-Mapsbooking ובספרייה libs-sources).
  5. בשני קובצי Java, פועלים לפי המשימות לביצוע כדי להשלים את ההטמעות

פרטים נוספים על API ל-REST זמינים כאן.

פתרון בעיות:

  1. כשמנסים ליצור מוכר או שירות חדש עם מספר חשבון Merchant קיים, או 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, השיחה לא תקפיץ הודעת שגיאה. הסיבה לכך היא שינויים במשבצות זמינות דרך RTU תומכים בביצוע שלא כחלק מההזמנה ולכן הוא אינו משויך ל-MerchantId או למזהה ServiceId. עם זאת, מיקומי המשבצות בבקשה לא תוגש בסביבת הייצור בגלל merchantId או serviceId. כדי שהמשבצות יהיו ניתנות להצגה, צריך להוסיף את חסר מוכר או שירות דרך RTU או פידים.
  3. בכל פונקציות העדכון, הפרמטר 'updateMask' חייב להיות פורמט FieldMask כדי לציין את השדות שרוצים לעדכן. ה-API הוא נדרש כדי לשנות רק את ערכי השדות כפי שצוינו במסכה ולהשאיר את כל השאר ללא שינוי. אם מעבירים מחרוזת updateMask שגויה, העדכון לא ייכנס לתוקף. אם לא מופיעה מסכת שדות בעדכון: הפעולה חלה על כל השדות (כאילו מסיכת שדות של כל השדות כוללת ). אם רוצים לעדכן את כל השדות, פשוט הגדירו מסכת העדכון ריקה.
  4. כל שדה שמכיל ערך אפס לא מוצג בתשובה.