طريقة CreateBooking

يرسل العميل طلبًا لإنشاء حجز بعد التحقّق من توفّر الموعد المطلوب وتلقّي إشارة إلى أنّه متاح. يُجري نظام الخلفية الخاص بالشريك حجزًا للوقت المطلوب، ويعرض الوقت عند نجاح العملية، أو يعرض خطأ في منطق النشاط التجاري (مثلاً، إذا أصبح الوقت غير متاح، أو إذا كانت طريقة الدفع غير صالحة، وما إلى ذلك) عند فشل العملية.

يتم تقديم معلومات حول المستخدم والدفع في هذه الخطوة.

إذا تعذّر إنشاء حجز بسبب أي خطأ في منطق العمل التجاري، يجب تضمين الخطأ في الرد. راجِع مقالة تعذُّر الحجز للحصول على معلومات مفصّلة.

الطلب

CreateBookingRequest

القيمة المعروضة

CreateBookingResponse

رموز الخطأ الأساسية في gRPC

INVALID_ARGUMENT (في حال كانت UserInformation المقدَّمة غير صالحة، مثلاً بسبب الحقول غير المتوفّرة)

// Request to create a [ext.maps.booking.partner.v2.Booking] for an inventory
// slot. Consumes the lease if provided.
message CreateBookingRequest {
  option features.(pb.java).nest_in_file_class = YES;

  // The inventory slot that is being requested to make this booking.
  // If lease_ref is provided, slot must match the lease; slot is provided for
  // the partner to verify the lease information.
  // If lease_ref is absent, then create the booking for the slot. (required)
  Slot slot = 1;

  // The lease that is being confirmed to make this booking.
  // If lease_ref is provided, then create the booking using the lease.
  // (optional)
  LeaseReference lease_ref = 2;

  // Personal information of the user making the appointment (required)
  UserInformation user_information = 3;

  // Information about payments. When payment authorizations are handled by
  // Google, if the booking request does not succeed, payment authorizations are
  // automatically canceled. (optional)
  PaymentInformation payment_information = 4;

  // The parameters to be used if the payment is processed by the partner
  // (i.e. payment_information.payment_processed_by is equal to
  // PROCESSED_BY_PARTNER). (optional)
  PaymentProcessingParameters payment_processing_parameters = 5;

  // Idempotency token for [ext.maps.booking.partner.v2.CreateBooking] requests.
  // (required)
  string idempotency_token = 6;

  // A string from the user which contains any special requests or additional
  // information that they would like to notify the merchant about. (optional)
  string additional_request = 7;
}

// Response with the created [ext.maps.booking.partner.v2.Booking] for an
// inventory slot
message CreateBookingResponse {
  option features.(pb.java).nest_in_file_class = YES;

  // The created booking (required)
  Booking booking = 1;

  // The updated user payment option used in this booking.
  // If a new payment option was purchased to pay for the booking, this should
  // be a newly created user payment option.
  // If an already purchased user payment option was used for this booking,
  // this should reflect an updated version of that user payment option.
  // (optional)
  UserPaymentOption user_payment_option = 2;

  // If creating a booking fails, this field should reflect the business logic
  // error (e.g., slot has become unavailable) and all other fields in the
  // CreateBookingResponse message are expected to be unset. (required if
  // failure occurs)
  BookingFailure booking_failure = 3;
}

طريقة CreateBooking تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

طريقة CreateBooking