Method: notification.partners.bookings.patch

Cập nhật một Booking hiện có.

Yêu cầu HTTP

PATCH https://mapsbooking.googleapis.com/v1alpha/notification/{booking.name=partners/*/bookings/*}

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Các tham số
booking.name

string

Tên tài nguyên của lượt đặt trước: partners/{partner ID}/bookings/{booking ID}

Tham số truy vấn

Các tham số
updateMask

string (FieldMask format)

Mặt nạ cho trường (field mask) của tất cả các trường đặt lịch hẹn sẽ được cập nhật

Đây là danh sách các tên trường đủ điều kiện được phân tách bằng dấu phẩy. Ví dụ: "user.displayName,photo"
bookingFailure

object (BookingFailure)

Nếu yêu cầu đặt vé đã được xác nhận không đồng bộ và trạng thái của lượt đặt phòng đó đang được cập nhật thành KHÔNG THÀNH CÔNG, trường này sẽ phản ánh lỗi logic kinh doanh (ví dụ: người dùng hiện có một yêu cầu đặt chỗ quá gần với thời điểm này). Bạn chỉ nên đặt trường này khi cập nhật trạng thái đặt phòng thành FAILED và sẽ bị bỏ qua nếu không cập nhật.

Nội dung yêu cầu

Nội dung yêu cầu chứa một bản sao của Booking.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của Booking.

Phạm vi cấp phép

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/mapsbooking

BookingFailure

Dữ liệu trạng thái cho biết lý do không thể xử lý yêu cầu đặt phòng theo cách không đồng bộ. Mục đích của tính năng Đặt chỗ không thành công là chủ yếu ghi lại các lỗi về logic kinh doanh.

Biểu diễn dưới dạng JSON 
{
  "cause": enum (Cause),
  "rejectedCardType": enum (CreditCardType),
  "description": string,
  "paymentFailure": {
    object (PaymentFailureInformation)
  }
}
Các trường
cause

enum (Cause)

Lý do không đặt được chỗ. (bắt buộc)
rejectedCardType

enum (CreditCardType)

(chỉ bắt buộc nếu nguyên nhân là PAYMENT_ERROR_CARD_TYPE_ đấu giả)
description

string

Trường không bắt buộc này dùng để đối tác cung cấp thông tin bổ sung chỉ nhằm mục đích gỡ lỗi. (không bắt buộc)
paymentFailure

object (PaymentFailureInformation)

Thông tin về các lỗi thanh toán.

Nguyên nhân

Bảng liệt kê các nguyên nhân gây lỗi.

Enum
CAUSE_UNSPECIFIED Giá trị mặc định: Không sử dụng; dẫn đến "lỗi không xác định"
SLOT_UNAVAILABLE Vị trí tình trạng rảnh/bận được đề cập không còn nữa.
SLOT_ALREADY_BOOKED_BY_USER Người dùng đã đặt lịch hẹn cho khung giờ nhận đặt lịch hẹn được đề cập.
LEASE_EXPIRED Hợp đồng thuê (nếu được cung cấp) đã hết hạn và không thể được dùng nữa để hoàn tất yêu cầu đặt phòng.
OUTSIDE_CANCELLATION_WINDOW Hiện tại, không thể thực hiện yêu cầu huỷ do quy định hạn chế về thời gian trong chính sách huỷ của người bán.
PAYMENT_ERROR_CARD_TYPE_REJECTED Đã xảy ra lỗi trong khi xử lý khoản thanh toán vì người bán không chấp nhận loại thẻ tín dụng đã cung cấp. Bạn phải cung cấp loại thẻ tín dụng trong trường CardType bị từ chối.
PAYMENT_ERROR_CARD_DECLINED Đã xảy ra lỗi trong khi xử lý khoản thanh toán vì thẻ tín dụng được cung cấp đã bị từ chối.
PAYMENT_OPTION_NOT_VALID Đã xảy ra lỗi với gói/gói thành viên dùng để thanh toán cho yêu cầu đặt trước. Có thể không còn lượt sử dụng hợp lệ nào, ứng dụng có thể đã hết hạn, v.v.
PAYMENT_ERROR Đã xảy ra lỗi khi xử lý khoản thanh toán cho yêu cầu đặt chỗ này. Sử dụng giá trị này để biểu thị lỗi liên quan đến thanh toán chung, chỉ khi lỗi không khớp với lỗi thanh toán cụ thể ở trên.
USER_CANNOT_USE_PAYMENT_OPTION Người dùng không thể sử dụng phương thức thanh toán đã cho (ví dụ: người dùng cố gắng sử dụng giá lần đầu tiên).
BOOKING_ALREADY_CANCELLED Lượt đặt chỗ mà người dùng cố gắng huỷ đã bị huỷ.
BOOKING_NOT_CANCELLABLE Không thể huỷ lượt đặt phòng mà người dùng đã cố gắng huỷ.
OVERLAPPING_RESERVATION Người dùng hiện có một yêu cầu đặt chỗ quá gần thời điểm này.
USER_OVER_BOOKING_LIMIT Không đặt được vé do người dùng đã vượt quá giới hạn lượt đặt trước trên mỗi người dùng của đơn vị tập hợp.
PAYMENT_REQUIRES_3DS1

Đặt thời điểm khoản thanh toán bị từ chối vì bạn đang yêu cầu thử lại giao dịch, nhưng đây là lần này sau khi bạn trải qua quy trình thử thách/phản hồi 3DS1. Xin lưu ý rằng trạng thái không thành công của giao dịch hiện tại sẽ vẫn không thành công. Hoạt động thử lại sẽ hoàn toàn riêng biệt.

Khi là lý do không thành công, bạn PHẢI đặt thông số paymentFailure.3DS1_parameters. Nếu không, thì nguyên nhân hiện tại sẽ được xử lý như thể là PAYMENT_ERROR.

PaymentFailureInformation

Thông tin về các lỗi thanh toán.

Biểu diễn dưới dạng JSON 
{
  "threeds1Parameters": {
    object (ThreeDS1Parameters)
  }
}
Các trường
threeds1Parameters

object (ThreeDS1Parameters)

Các tham số được trình tổng hợp RwG sử dụng để bắt đầu giao thức xác thực 3DS1 với người dùng. Sẽ được bỏ qua trừ khi ĐặtFailure.Destroy được đặt thành PAYMENT_REQUIRES_3DS1.

ThreeDS1Parameters

Các tham số yêu cầu RwG thực hiện thử thách 3DS1.

Tham số được thiết lập theo mô tả của EMVCo về giao thức 3DS1.

Biểu diễn dưới dạng JSON 
{
  "acsUrl": string,
  "paReq": string,
  "transactionId": string,
  "mdMerchantData": string
}
Các trường
acsUrl

string

URL để tải biểu mẫu và hiển thị cho người dùng để xác thực.
paReq

string

Yêu cầu Xác thực Thanh toán. Để được đăng lên biểu mẫu ACSUrl nếu được cung cấp.
transactionId

string

Giá trị nhận dạng do nhà cung cấp ACS sử dụng. Để được đăng lên biểu mẫu ACSUrl nếu được cung cấp.
mdMerchantData

string

Dữ liệu người bán. Để được đăng lên biểu mẫu ACSUrl nếu được cung cấp.