CreateBooking Ready

Để hoàn thành nhiệm vụ CreateBooking Ready (Sẵn sàng) trong cột mốc, bạn cần xây dựng và phân phối thành công phương thức CreateBooking. Phương thức này được gọi khi người dùng cố gắng tạo một lượt đặt phòng. Nếu bạn tạo thành công một lượt đặt chỗ, thì phản hồi sẽ bao gồm một booking_id duy nhất để tham chiếu đến lượt đặt chỗ cho các yêu cầu hoặc nội dung cập nhật trong tương lai.

Yêu cầu đối với việc cần làm CreateBooking

  • 10 phản hồi CreateBooking thành công với tỷ lệ lỗi dưới 10%.

Kiến thức cơ bản về CreateBooking

Khi người dùng bắt đầu đặt chỗ, yêu cầu CreateBooking sẽ được gửi đến Máy chủ đặt chỗ của đối tác. Phản hồi cho yêu cầu cho biết việc đặt phòng thành công hoặc không thành công. Nếu có lỗi đặt phòng, thì phản hồi cần phải bao gồm lỗi logic nghiệp vụ đối với lỗi. Ví dụ: khung giờ đã hết hoặc đã được người dùng đặt trước.

Khi người dùng tạo một lượt đặt phòng, Google sẽ gửi cho bạn tên, họ, số điện thoại và email của người dùng. Để biết thêm thông tin, hãy xem Chính sách về việc tạo và so khớp tài khoản.

Tính chất luỹ đẳng

Giao tiếp qua mạng không phải lúc nào cũng đáng tin cậy và Google có thể thử lại các yêu cầu HTTP nếu không nhận được phản hồi. Vì lý do này, tất cả các phương thức làm thay đổi trạng thái đều phải có tính chất luỹ đẳng:

  • CreateBooking
  • UpdateBooking

Đối với mọi thông báo yêu cầu, ngoại trừ UpdateBooking, mã thông báo về tính chất luỹ đẳng được đưa vào để xác định duy nhất yêu cầu. Điều này cho phép bạn phân biệt giữa một lệnh gọi REST được thử lại, với mục đích tạo một yêu cầu duy nhất và hai yêu cầu riêng biệt. Mã đặt phòng tương ứng của UpdateBooking giúp xác định riêng từng mã, vì vậy, không có mã thông báo về tính chất luỹ đẳng được đưa vào yêu cầu của các mã này.

Sau đây là một số ví dụ về cách Máy chủ đặt phòng xử lý tính chất bất biến:

  • Phản hồi HTTP CreateBooking thành công sẽ bao gồm thông tin về lượt đặt phòng đã tạo. Trong một số trường hợp, khoản thanh toán được xử lý trong quy trình đặt vé. Nếu cùng một CreateBookingRequest được nhận lần thứ hai với cùng một idempotency_token, thì bạn phải trả về cùng một CreateBookingResponse. Không tạo yêu cầu đặt phòng thứ hai và người dùng chỉ bị tính phí một lần (nếu có).

Yêu cầu về tính chất bất biến áp dụng cho tất cả các phương thức làm thay đổi trạng thái.