מפרט שכירות

חכירה מקנה באופן זמני את הבעלות על יחידת קיבולת (Slot) מבוקשת.

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

ממשק ה-API של ההזמנות שלנו מספק תמיכה אופציונלית בליסינג. כשמדובר בתמיכה בליסינג, השלב הראשון ביצירת ההזמנה הוא יצירת החכירה של יחידת הקיבולת הרצויה.

// 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 צפוי להשתמש באזכור חכירה. כשמבצעים הזמנה עם הפנייה לשכירות שסופקה, השותף צורך את השכירות והופך אותה ללא תקפה בכל ההזמנות הנוספות. השותף גם אחראי לאמת את ההזמנה שנוצרה באמצעות יחידת הקיבולת (Slot) בהודעת הבקשה.
• כקוד שגיאה נוסף ב-gRPC, נעשה שימוש ב-NOT_FOUND אם סופק ההפניה לשכירות ומזהה השכירות לא ידוע לשותף.

איור: יצירת הזמנה לחכירה