Stay organized with collections
Save and categorize content based on your preferences.
Request
CreateBookingRequest
Return value
CreateBookingResponse
Side effects
CreateBooking consumes a Lease, rendering it invalid for any further bookings.
Canonical gRPC error codes
INVALID_ARGUMENT if the provided ClientInformation is invalid, e.g. due to
missing fields
NOT_FOUND if the provided lease ID is not valid.
RESOURCE_EXHAUSTED (if the slot has become unavailable since creating the
lease, e.g. due to a conflicting booking)
ALREADY_EXISTS (if the client already has a booking for the slot)
// Request to create a [ext.maps.booking.partner.v0.Booking] for an inventory// slot. Consumes the lease.messageCreateBookingRequest{// The lease that is being confirmed to make this bookingLeaseReferencelease_ref=1;// Personal information of the client making the appointmentClientInformationclient_information=2;// Information about payments. If the booking request does not succeed,// payment authorizations are automatically canceled.PaymentInformationpayment_information=3;// 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).PaymentProcessingParameterspayment_processing_parameters=4;}// Response with the created [ext.maps.booking.partner.v0.Booking] for an// inventory slotmessageCreateBookingResponse{// The created bookingBookingbooking=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.UserPaymentOptionuser_payment_option=2;}
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-10-31 UTC."],[[["The `CreateBooking` API creates a booking for an inventory slot using a provided lease, client, payment, and payment processing information."],["If successful, it returns the created booking and potentially updated user payment information, consuming the initial lease."],["Potential errors include invalid client data, invalid lease ID, slot unavailability due to conflict or if the client already has a booking for the given slot."],["`CreateBookingRequest` contains lease, client, payment, and processing details, while `CreateBookingResponse` returns the booking and user payment information."]]],["The `CreateBookingRequest` message initiates a booking, consuming a lease and requiring `LeaseReference`, `ClientInformation`, and `PaymentInformation`. A successful request returns a `CreateBookingResponse` containing the `Booking` details and potentially an updated `UserPaymentOption`. Side effects include lease invalidation. Errors include `INVALID_ARGUMENT` (invalid client info), `NOT_FOUND` (invalid lease), `RESOURCE_EXHAUSTED` (slot unavailable), and `ALREADY_EXISTS` (existing booking). The request also includes optional `PaymentProcessingParameters` for partner-processed payments.\n"]]