Метод CreateBooking

Клиент просит создать бронирование. Серверная часть партнера резервирует запрошенный слот и возвращает его в случае успеха или ошибки бизнес-логики (например, если слот стал недоступен, или платеж недействителен и т. д.) в случае сбоя.

Обратите внимание, что ошибки бизнес-логики следует возвращать в поле CreateBookingResponse.booking_failure , а не через код ответа HTTP, отличный от 200.

Запрос

Создать запрос на бронирование

Возвращаемое значение

CreateBookingResponse

// Request to create a Booking for an inventory slot. Consumes the lease if
// provided.
message CreateBookingRequest {
  // 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;


  // 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 CreateBooking requests. (required)
  //
  // This uniquely identifies a booking request. Specifically:
  // - If a booking was already created for a CreateBooking request with this
  // idempotency token, that booking should be returned.
  // - If no booking has been created for a CreateBooking request with this
  // idempotency token, this should be considered to be a request for a new
  // booking, and **no previously-created booking may be returned**.
  //
  // If a partner considers the requested booking to be a duplicate of a
  // previously-created booking, this request should fail with reason
  // BookingFailure.OVERLAPPING_RESERVATION. The partner is responsible for
  // determining whether this duplicates a previous booking, but for example the
  // partner may consider a booking request to be a duplicate if an existing
  // booking has the same party size, time, and email address.
  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;

  // Partner provided offer id associated with this slot. (optional)
  //
  // If the offer is no longer available, the booking should not be made, and in
  // response.booking_failure should be set to OFFER_UNAVAILABLE.
  string offer_id = 9;

}

// Response with the created Booking for an inventory slot.
message CreateBookingResponse {
  // 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 for Beauty

Запрос

{
   "idempotency_token" : "11195193155056732768",
   "payment_information" : {
      "prepayment_status" : "PREPAYMENT_NOT_PROVIDED"
   },
   "slot" : {
      "confirmation_mode" : "CONFIRMATION_MODE_SYNCHRONOUS",
      "duration_sec" : "1800",
      "merchant_id" : "1234",
      "resources" : {
         "staff_id" : "82725"
      },
      "service_id" : "5678",
      "start_sec" : "1606509000"
   },
   "user_information" : {
      "email" : "john.smith@gmail.com",
      "family_name" : "Smith",
      "given_name" : "John",
      "telephone" : "+12091111111",
      "user_id" : "1111111111111111111"
   }
}

Ответ

{
   "booking" : {
      "booking_id" : "890",
      "payment_information" : {
         "prepayment_status" : "PREPAYMENT_NOT_PROVIDED"
      },
      "slot" : {
         "duration_sec" : "1800",
         "merchant_id" : "1234",
         "resources" : {
            "staff_id" : "82725"
         },
         "service_id" : "5678",
         "start_sec" : 1606509000
      },
      "status" : "CONFIRMED",
      "user_information" : {
         "user_id" : "1111111111111111111"
      }
   }
}

Образцы CreateBooking for Fitness

Запрос

{
   "idempotency_token" : "13490670332760737439",
   "payment_information" : {
      "prepayment_status" : "PREPAYMENT_NOT_PROVIDED"
   },
   "slot" : {
      "availability_tag" : "5042328",
      "confirmation_mode" : "CONFIRMATION_MODE_SYNCHRONOUS",
      "duration_sec" : "4500",
      "merchant_id" : "1234",
      "resources" : {
         "staff_id" : "276191"
      },
      "service_id" : "5678",
      "start_sec" : "1606359600"
   },
   "user_information" : {
      "email" : "john.smith@gmail.com",
      "family_name" : "Smith",
      "given_name" : "John",
      "telephone" : "+12091111111",
      "user_id" : "1111111111111111111"
   }
}

Ответ

{
   "booking" : {
      "booking_id" : "890",
      "payment_information" : {
         "prepayment_status" : "PREPAYMENT_NOT_PROVIDED"
      },
      "slot" : {
         "availability_tag" : "5042328",
         "confirmation_mode" : "CONFIRMATION_MODE_SYNCHRONOUS",
         "duration_sec" : "4500",
         "merchant_id" : "1234",
         "resources" : {
            "staff_id" : "276191"
         },
         "service_id" : "5678",
         "start_sec" : "1606359600"
      },
      "status" : "CONFIRMED",
      "user_information" : {
         "email" : "john.smith@gmail.com",
         "family_name" : "Smith",
         "given_name" : "John",
         "telephone" : "+12091111111",
         "user_id" : "1111111111111111111"
      }
   }
}

Образцы CreateBooking for Financial Services

TODO