com.squareup.square.api

Interface BookingsApi

All Known Implementing Classes:

DefaultBookingsApi

public interface BookingsApi

This interface lists all the endpoints of the group. This can be overridden for the mock calls.

Method Summary

Modifier and Type	Method and Description
CancelBookingResponse	cancelBooking(String bookingId, CancelBookingRequest body) Cancels an existing booking.
CompletableFuture<CancelBookingResponse>	cancelBookingAsync(String bookingId, CancelBookingRequest body) Cancels an existing booking.
CreateBookingResponse	createBooking(CreateBookingRequest body) Creates a booking.
CompletableFuture<CreateBookingResponse>	createBookingAsync(CreateBookingRequest body) Creates a booking.
ListBookingsResponse	listBookings(Integer limit, String cursor, String teamMemberId, String locationId, String startAtMin, String startAtMax) Retrieve a collection of bookings.
CompletableFuture<ListBookingsResponse>	listBookingsAsync(Integer limit, String cursor, String teamMemberId, String locationId, String startAtMin, String startAtMax) Retrieve a collection of bookings.
ListTeamMemberBookingProfilesResponse	listTeamMemberBookingProfiles(Boolean bookableOnly, Integer limit, String cursor, String locationId) Lists booking profiles for team members.
CompletableFuture<ListTeamMemberBookingProfilesResponse>	listTeamMemberBookingProfilesAsync(Boolean bookableOnly, Integer limit, String cursor, String locationId) Lists booking profiles for team members.
RetrieveBookingResponse	retrieveBooking(String bookingId) Retrieves a booking.
CompletableFuture<RetrieveBookingResponse>	retrieveBookingAsync(String bookingId) Retrieves a booking.
RetrieveBusinessBookingProfileResponse	retrieveBusinessBookingProfile() Retrieves a seller's booking profile.
CompletableFuture<RetrieveBusinessBookingProfileResponse>	retrieveBusinessBookingProfileAsync() Retrieves a seller's booking profile.
RetrieveTeamMemberBookingProfileResponse	retrieveTeamMemberBookingProfile(String teamMemberId) Retrieves a team member's booking profile.
CompletableFuture<RetrieveTeamMemberBookingProfileResponse>	retrieveTeamMemberBookingProfileAsync(String teamMemberId) Retrieves a team member's booking profile.
SearchAvailabilityResponse	searchAvailability(SearchAvailabilityRequest body) Searches for availabilities for booking.
CompletableFuture<SearchAvailabilityResponse>	searchAvailabilityAsync(SearchAvailabilityRequest body) Searches for availabilities for booking.
UpdateBookingResponse	updateBooking(String bookingId, UpdateBookingRequest body) Updates a booking.
CompletableFuture<UpdateBookingResponse>	updateBookingAsync(String bookingId, UpdateBookingRequest body) Updates a booking.

Method Detail

listBookings

ListBookingsResponse listBookings(Integer limit,
                                  String cursor,
                                  String teamMemberId,
                                  String locationId,
                                  String startAtMin,
                                  String startAtMax)
                           throws ApiException,
                                  IOException

Retrieve a collection of bookings. To call this endpoint with buyer-level permissions, set `APPOINTMENTS_READ` for the OAuth scope. To call this endpoint with seller-level permissions, set `APPOINTMENTS_ALL_READ` and `APPOINTMENTS_READ` for the OAuth scope.

Parameters:

limit - Optional parameter: The maximum number of results per page to return in a paged response.

cursor - Optional parameter: The pagination cursor from the preceding response to return the next page of the results. Do not set this when retrieving the first page of the results.

teamMemberId - Optional parameter: The team member for whom to retrieve bookings. If this is not set, bookings of all members are retrieved.

locationId - Optional parameter: The location for which to retrieve bookings. If this is not set, all locations' bookings are retrieved.

startAtMin - Optional parameter: The RFC 3339 timestamp specifying the earliest of the start time. If this is not set, the current time is used.

startAtMax - Optional parameter: The RFC 3339 timestamp specifying the latest of the start time. If this is not set, the time of 31 days after `start_at_min` is used.

Returns:

Returns the ListBookingsResponse response from the API call

Throws:

ApiException - Represents error response from the server.

IOException - Signals that an I/O exception of some sort has occurred.

listBookingsAsync

CompletableFuture<ListBookingsResponse> listBookingsAsync(Integer limit,
                                                          String cursor,
                                                          String teamMemberId,
                                                          String locationId,
                                                          String startAtMin,
                                                          String startAtMax)

Retrieve a collection of bookings. To call this endpoint with buyer-level permissions, set `APPOINTMENTS_READ` for the OAuth scope. To call this endpoint with seller-level permissions, set `APPOINTMENTS_ALL_READ` and `APPOINTMENTS_READ` for the OAuth scope.

Parameters:

limit - Optional parameter: The maximum number of results per page to return in a paged response.

cursor - Optional parameter: The pagination cursor from the preceding response to return the next page of the results. Do not set this when retrieving the first page of the results.

teamMemberId - Optional parameter: The team member for whom to retrieve bookings. If this is not set, bookings of all members are retrieved.

locationId - Optional parameter: The location for which to retrieve bookings. If this is not set, all locations' bookings are retrieved.

startAtMin - Optional parameter: The RFC 3339 timestamp specifying the earliest of the start time. If this is not set, the current time is used.

startAtMax - Optional parameter: The RFC 3339 timestamp specifying the latest of the start time. If this is not set, the time of 31 days after `start_at_min` is used.

Returns:

Returns the ListBookingsResponse response from the API call

createBooking

CreateBookingResponse createBooking(CreateBookingRequest body)
                             throws ApiException,
                                    IOException

Creates a booking. To call this endpoint with buyer-level permissions, set `APPOINTMENTS_WRITE` for the OAuth scope. To call this endpoint with seller-level permissions, set `APPOINTMENTS_ALL_WRITE` and `APPOINTMENTS_WRITE` for the OAuth scope. For calls to this endpoint with seller-level permissions to succeed, the seller must have subscribed to *Appointments Plus* or *Appointments Premium*.

Parameters:

body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.

Returns:

Returns the CreateBookingResponse response from the API call

Throws:

ApiException - Represents error response from the server.

IOException - Signals that an I/O exception of some sort has occurred.

createBookingAsync

CompletableFuture<CreateBookingResponse> createBookingAsync(CreateBookingRequest body)

Creates a booking. To call this endpoint with buyer-level permissions, set `APPOINTMENTS_WRITE` for the OAuth scope. To call this endpoint with seller-level permissions, set `APPOINTMENTS_ALL_WRITE` and `APPOINTMENTS_WRITE` for the OAuth scope. For calls to this endpoint with seller-level permissions to succeed, the seller must have subscribed to *Appointments Plus* or *Appointments Premium*.

Parameters:

body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.

Returns:

Returns the CreateBookingResponse response from the API call

searchAvailability

SearchAvailabilityResponse searchAvailability(SearchAvailabilityRequest body)
                                       throws ApiException,
                                              IOException

Searches for availabilities for booking. To call this endpoint with buyer-level permissions, set `APPOINTMENTS_READ` for the OAuth scope. To call this endpoint with seller-level permissions, set `APPOINTMENTS_ALL_READ` and `APPOINTMENTS_READ` for the OAuth scope.

Parameters:

body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.

Returns:

Returns the SearchAvailabilityResponse response from the API call

Throws:

ApiException - Represents error response from the server.

IOException - Signals that an I/O exception of some sort has occurred.

searchAvailabilityAsync

CompletableFuture<SearchAvailabilityResponse> searchAvailabilityAsync(SearchAvailabilityRequest body)

Searches for availabilities for booking. To call this endpoint with buyer-level permissions, set `APPOINTMENTS_READ` for the OAuth scope. To call this endpoint with seller-level permissions, set `APPOINTMENTS_ALL_READ` and `APPOINTMENTS_READ` for the OAuth scope.

Parameters:

body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.

Returns:

Returns the SearchAvailabilityResponse response from the API call

retrieveBusinessBookingProfile

RetrieveBusinessBookingProfileResponse retrieveBusinessBookingProfile()
                                                               throws ApiException,
                                                                      IOException

Retrieves a seller's booking profile.

Returns:

Returns the RetrieveBusinessBookingProfileResponse response from the API call

Throws:

ApiException - Represents error response from the server.

IOException - Signals that an I/O exception of some sort has occurred.

retrieveBusinessBookingProfileAsync

CompletableFuture<RetrieveBusinessBookingProfileResponse> retrieveBusinessBookingProfileAsync()

Retrieves a seller's booking profile.

Returns:

Returns the RetrieveBusinessBookingProfileResponse response from the API call

listTeamMemberBookingProfiles

ListTeamMemberBookingProfilesResponse listTeamMemberBookingProfiles(Boolean bookableOnly,
                                                                    Integer limit,
                                                                    String cursor,
                                                                    String locationId)
                                                             throws ApiException,
                                                                    IOException

Lists booking profiles for team members.

Parameters:

bookableOnly - Optional parameter: Indicates whether to include only bookable team members in the returned result (`true`) or not (`false`).

limit - Optional parameter: The maximum number of results to return in a paged response.

cursor - Optional parameter: The pagination cursor from the preceding response to return the next page of the results. Do not set this when retrieving the first page of the results.

locationId - Optional parameter: Indicates whether to include only team members enabled at the given location in the returned result.

Returns:

Returns the ListTeamMemberBookingProfilesResponse response from the API call

Throws:

ApiException - Represents error response from the server.

IOException - Signals that an I/O exception of some sort has occurred.

listTeamMemberBookingProfilesAsync

CompletableFuture<ListTeamMemberBookingProfilesResponse> listTeamMemberBookingProfilesAsync(Boolean bookableOnly,
                                                                                            Integer limit,
                                                                                            String cursor,
                                                                                            String locationId)

Lists booking profiles for team members.

Parameters:

bookableOnly - Optional parameter: Indicates whether to include only bookable team members in the returned result (`true`) or not (`false`).

limit - Optional parameter: The maximum number of results to return in a paged response.

cursor - Optional parameter: The pagination cursor from the preceding response to return the next page of the results. Do not set this when retrieving the first page of the results.

locationId - Optional parameter: Indicates whether to include only team members enabled at the given location in the returned result.

Returns:

Returns the ListTeamMemberBookingProfilesResponse response from the API call

retrieveTeamMemberBookingProfile

RetrieveTeamMemberBookingProfileResponse retrieveTeamMemberBookingProfile(String teamMemberId)
                                                                   throws ApiException,
                                                                          IOException

Retrieves a team member's booking profile.

Parameters:

teamMemberId - Required parameter: The ID of the team member to retrieve.

Returns:

Returns the RetrieveTeamMemberBookingProfileResponse response from the API call

Throws:

ApiException - Represents error response from the server.

IOException - Signals that an I/O exception of some sort has occurred.

retrieveTeamMemberBookingProfileAsync

CompletableFuture<RetrieveTeamMemberBookingProfileResponse> retrieveTeamMemberBookingProfileAsync(String teamMemberId)

Retrieves a team member's booking profile.

Parameters:

teamMemberId - Required parameter: The ID of the team member to retrieve.

Returns:

Returns the RetrieveTeamMemberBookingProfileResponse response from the API call

retrieveBooking

RetrieveBookingResponse retrieveBooking(String bookingId)
                                 throws ApiException,
                                        IOException

Retrieves a booking. To call this endpoint with buyer-level permissions, set `APPOINTMENTS_READ` for the OAuth scope. To call this endpoint with seller-level permissions, set `APPOINTMENTS_ALL_READ` and `APPOINTMENTS_READ` for the OAuth scope.

Parameters:

bookingId - Required parameter: The ID of the [Booking]($m/Booking) object representing the to-be-retrieved booking.

Returns:

Returns the RetrieveBookingResponse response from the API call

Throws:

ApiException - Represents error response from the server.

IOException - Signals that an I/O exception of some sort has occurred.

retrieveBookingAsync

CompletableFuture<RetrieveBookingResponse> retrieveBookingAsync(String bookingId)

Retrieves a booking. To call this endpoint with buyer-level permissions, set `APPOINTMENTS_READ` for the OAuth scope. To call this endpoint with seller-level permissions, set `APPOINTMENTS_ALL_READ` and `APPOINTMENTS_READ` for the OAuth scope.

Parameters:

bookingId - Required parameter: The ID of the [Booking]($m/Booking) object representing the to-be-retrieved booking.

Returns:

Returns the RetrieveBookingResponse response from the API call

updateBooking

UpdateBookingResponse updateBooking(String bookingId,
                                    UpdateBookingRequest body)
                             throws ApiException,
                                    IOException

Updates a booking. To call this endpoint with buyer-level permissions, set `APPOINTMENTS_WRITE` for the OAuth scope. To call this endpoint with seller-level permissions, set `APPOINTMENTS_ALL_WRITE` and `APPOINTMENTS_WRITE` for the OAuth scope. For calls to this endpoint with seller-level permissions to succeed, the seller must have subscribed to *Appointments Plus* or *Appointments Premium*.

Parameters:

bookingId - Required parameter: The ID of the [Booking]($m/Booking) object representing the to-be-updated booking.

body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.

Returns:

Returns the UpdateBookingResponse response from the API call

Throws:

ApiException - Represents error response from the server.

IOException - Signals that an I/O exception of some sort has occurred.

updateBookingAsync

CompletableFuture<UpdateBookingResponse> updateBookingAsync(String bookingId,
                                                            UpdateBookingRequest body)

Updates a booking. To call this endpoint with buyer-level permissions, set `APPOINTMENTS_WRITE` for the OAuth scope. To call this endpoint with seller-level permissions, set `APPOINTMENTS_ALL_WRITE` and `APPOINTMENTS_WRITE` for the OAuth scope. For calls to this endpoint with seller-level permissions to succeed, the seller must have subscribed to *Appointments Plus* or *Appointments Premium*.

Parameters:

bookingId - Required parameter: The ID of the [Booking]($m/Booking) object representing the to-be-updated booking.

body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.

Returns:

Returns the UpdateBookingResponse response from the API call

cancelBooking

CancelBookingResponse cancelBooking(String bookingId,
                                    CancelBookingRequest body)
                             throws ApiException,
                                    IOException

Cancels an existing booking. To call this endpoint with buyer-level permissions, set `APPOINTMENTS_WRITE` for the OAuth scope. To call this endpoint with seller-level permissions, set `APPOINTMENTS_ALL_WRITE` and `APPOINTMENTS_WRITE` for the OAuth scope. For calls to this endpoint with seller-level permissions to succeed, the seller must have subscribed to *Appointments Plus* or *Appointments Premium*.

Parameters:

bookingId - Required parameter: The ID of the [Booking]($m/Booking) object representing the to-be-cancelled booking.

body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.

Returns:

Returns the CancelBookingResponse response from the API call

Throws:

ApiException - Represents error response from the server.

IOException - Signals that an I/O exception of some sort has occurred.

cancelBookingAsync

CompletableFuture<CancelBookingResponse> cancelBookingAsync(String bookingId,
                                                            CancelBookingRequest body)

Cancels an existing booking. To call this endpoint with buyer-level permissions, set `APPOINTMENTS_WRITE` for the OAuth scope. To call this endpoint with seller-level permissions, set `APPOINTMENTS_ALL_WRITE` and `APPOINTMENTS_WRITE` for the OAuth scope. For calls to this endpoint with seller-level permissions to succeed, the seller must have subscribed to *Appointments Plus* or *Appointments Premium*.

Parameters:

bookingId - Required parameter: The ID of the [Booking]($m/Booking) object representing the to-be-cancelled booking.

body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.

Returns:

Returns the CancelBookingResponse response from the API call