מפרט החכירה

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

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

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

// Temporary lease for an inventory slot
message Lease {
  option features.(pb.java).nest_in_file_class = YES;

  // 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 {
  option features.(pb.java).nest_in_file_class = YES;

  // Lease ID (required)
  string lease_id = 1;
}

מידע נוסף על ליסינג

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

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

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

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

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

איור: יצירת הזמנה לליסינג