מפרט החכירה

זיכיון מאפשר להחזיק באופן זמני בבעלות על משבצת מבוקש.

הקצה העורפי של השותף מאמת שהמועד המבוקש לפגישה תקף ועדיין זמין. באופן פנימי, השותף יוצר החזקה זמנית על המשבצת המבוקשת, שתוקפה יפוג באופן אוטומטי בשעה lease_expiration_time. לקצה העורפי מותר לשנות את lease_expiration_time, למשל אם משך החכירה המבוקש ארוך מדי. הלקוח מקבל בחזרה את החכירה שנוצרה.

ב-Booking.com API יש תמיכה אופציונלית ב-Lease. כשיש תמיכה בזיכיון, השלב הראשון ביצירת הזמנה הוא יצירת זיכיון למק"ט המבוקש.

// Temporary lease for an inventory slot
message Lease {
  // ID of the lease.
  // Not populated in CreateLeaseRequest. The value is chosen by the partner and
  // has to be returned in the response of CreateLease. (required)
  string lease_id = 1;

  // The appointment slot that the lease is created for. (required)
  Slot slot = 2;

  // Unique identifier for this lease, chosen by Reserve with Google. Serves as
  // an idempotency token for [ext.maps.booking.partner.v2.CreateLease]
  // requests. (required)
  string user_reference = 3;

  // Expiration time of the lease in UTC Timestamp (required)
  google.protobuf.Timestamp lease_expiration_time = 4;
}

// Reference to a [ext.maps.booking.partner.v2.Lease] that has been created via
// [ext.maps.booking.partner.v2.CreateLease]
message LeaseReference {
  // Lease ID (required)
  string lease_id = 1;
}

מידע נוסף על זיכיונות

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

כדי לתמוך בזיכיון, צריך להטמיע את הקבוצה המומלצת של API v2. בנוסף,

• צריך להטמיע את CreateLease.
• צריך להטמיע את CreateBooking, וצפוי שייעשה שימוש בהפניה לחוזה השכירות. הקצה העורפי של השותף מבצע הזמנה באמצעות מספר ההסכם שסופק.

הדרישות של API v2 חלות גם על תמיכה בזיכיון. בנוסף,

• CreateBooking אמור להשתמש בהפניה לחוזה השכירות. כשמבצעים הזמנה באמצעות מספר ההסכם שסופק, השותף צורך את ההסכם והוא לא תקף להזמנות נוספות. השותף אחראי גם לאימות ההזמנה שנוצרה באמצעות השקע בהודעת הבקשה.
• כקוד שגיאה נוסף של gRPC, השגיאה NOT_FOUND משמשת אם מצוין lease ref ומזהה החכירה לא ידוע לשותף.

איור: יצירת הזמנה לדייר בענן