com.squareup.square.api

Class DefaultBookingCustomAttributesApi

java.lang.Object

com.squareup.square.api.BaseApi

com.squareup.square.api.DefaultBookingCustomAttributesApi

All Implemented Interfaces:

BookingCustomAttributesApi

public final class DefaultBookingCustomAttributesApi
extends BaseApi
implements BookingCustomAttributesApi

This class lists all the endpoints of the groups.

Field Summary

Fields inherited from class com.squareup.square.api.BaseApi

AUTHENTICATION_KEY, GLOBAL_ERROR_CASES

Constructor Summary

Constructors

Constructor and Description
DefaultBookingCustomAttributesApi(io.apimatic.core.GlobalConfiguration globalConfig) Initializes the controller.

Method Summary

Modifier and Type	Method and Description
BulkDeleteBookingCustomAttributesResponse	bulkDeleteBookingCustomAttributes(BulkDeleteBookingCustomAttributesRequest body) Bulk deletes bookings custom attributes.
CompletableFuture<BulkDeleteBookingCustomAttributesResponse>	bulkDeleteBookingCustomAttributesAsync(BulkDeleteBookingCustomAttributesRequest body) Bulk deletes bookings custom attributes.
BulkUpsertBookingCustomAttributesResponse	bulkUpsertBookingCustomAttributes(BulkUpsertBookingCustomAttributesRequest body) Bulk upserts bookings custom attributes.
CompletableFuture<BulkUpsertBookingCustomAttributesResponse>	bulkUpsertBookingCustomAttributesAsync(BulkUpsertBookingCustomAttributesRequest body) Bulk upserts bookings custom attributes.
CreateBookingCustomAttributeDefinitionResponse	createBookingCustomAttributeDefinition(CreateBookingCustomAttributeDefinitionRequest body) Creates a bookings custom attribute definition.
CompletableFuture<CreateBookingCustomAttributeDefinitionResponse>	createBookingCustomAttributeDefinitionAsync(CreateBookingCustomAttributeDefinitionRequest body) Creates a bookings custom attribute definition.
DeleteBookingCustomAttributeResponse	deleteBookingCustomAttribute(String bookingId, String key) Deletes a bookings custom attribute.
CompletableFuture<DeleteBookingCustomAttributeResponse>	deleteBookingCustomAttributeAsync(String bookingId, String key) Deletes a bookings custom attribute.
DeleteBookingCustomAttributeDefinitionResponse	deleteBookingCustomAttributeDefinition(String key) Deletes a bookings custom attribute definition.
CompletableFuture<DeleteBookingCustomAttributeDefinitionResponse>	deleteBookingCustomAttributeDefinitionAsync(String key) Deletes a bookings custom attribute definition.
ListBookingCustomAttributeDefinitionsResponse	listBookingCustomAttributeDefinitions(Integer limit, String cursor) Get all bookings custom attribute definitions.
CompletableFuture<ListBookingCustomAttributeDefinitionsResponse>	listBookingCustomAttributeDefinitionsAsync(Integer limit, String cursor) Get all bookings custom attribute definitions.
ListBookingCustomAttributesResponse	listBookingCustomAttributes(String bookingId, Integer limit, String cursor, Boolean withDefinitions) Lists a booking's custom attributes.
CompletableFuture<ListBookingCustomAttributesResponse>	listBookingCustomAttributesAsync(String bookingId, Integer limit, String cursor, Boolean withDefinitions) Lists a booking's custom attributes.
RetrieveBookingCustomAttributeResponse	retrieveBookingCustomAttribute(String bookingId, String key, Boolean withDefinition, Integer version) Retrieves a bookings custom attribute.
CompletableFuture<RetrieveBookingCustomAttributeResponse>	retrieveBookingCustomAttributeAsync(String bookingId, String key, Boolean withDefinition, Integer version) Retrieves a bookings custom attribute.
RetrieveBookingCustomAttributeDefinitionResponse	retrieveBookingCustomAttributeDefinition(String key, Integer version) Retrieves a bookings custom attribute definition.
CompletableFuture<RetrieveBookingCustomAttributeDefinitionResponse>	retrieveBookingCustomAttributeDefinitionAsync(String key, Integer version) Retrieves a bookings custom attribute definition.
UpdateBookingCustomAttributeDefinitionResponse	updateBookingCustomAttributeDefinition(String key, UpdateBookingCustomAttributeDefinitionRequest body) Updates a bookings custom attribute definition.
CompletableFuture<UpdateBookingCustomAttributeDefinitionResponse>	updateBookingCustomAttributeDefinitionAsync(String key, UpdateBookingCustomAttributeDefinitionRequest body) Updates a bookings custom attribute definition.
UpsertBookingCustomAttributeResponse	upsertBookingCustomAttribute(String bookingId, String key, UpsertBookingCustomAttributeRequest body) Upserts a bookings custom attribute.
CompletableFuture<UpsertBookingCustomAttributeResponse>	upsertBookingCustomAttributeAsync(String bookingId, String key, UpsertBookingCustomAttributeRequest body) Upserts a bookings custom attribute.

Methods inherited from class com.squareup.square.api.BaseApi

getClientInstance, getGlobalConfiguration, getHttpCallback

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DefaultBookingCustomAttributesApi

public DefaultBookingCustomAttributesApi(io.apimatic.core.GlobalConfiguration globalConfig)

Initializes the controller.

Parameters:

globalConfig - Configurations added in client.

Method Detail

listBookingCustomAttributeDefinitions

public ListBookingCustomAttributeDefinitionsResponse listBookingCustomAttributeDefinitions(Integer limit,
                                                                                           String cursor)
                                                                                    throws ApiException,
                                                                                           IOException

Get all bookings custom attribute definitions. 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.

Specified by:

listBookingCustomAttributeDefinitions in interface BookingCustomAttributesApi

Parameters:

limit - Optional parameter: The maximum number of results to return in a single paged response. This limit is advisory. The response might contain more or fewer results. The minimum value is 1 and the maximum value is 100. The default value is 20. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).

cursor - Optional parameter: The cursor returned in the paged response from the previous call to this endpoint. Provide this cursor to retrieve the next page of results for your original request. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).

Returns:

Returns the ListBookingCustomAttributeDefinitionsResponse 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.

listBookingCustomAttributeDefinitionsAsync

public CompletableFuture<ListBookingCustomAttributeDefinitionsResponse> listBookingCustomAttributeDefinitionsAsync(Integer limit,
                                                                                                                   String cursor)

Get all bookings custom attribute definitions. 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.

Specified by:

listBookingCustomAttributeDefinitionsAsync in interface BookingCustomAttributesApi

Parameters:

limit - Optional parameter: The maximum number of results to return in a single paged response. This limit is advisory. The response might contain more or fewer results. The minimum value is 1 and the maximum value is 100. The default value is 20. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).

cursor - Optional parameter: The cursor returned in the paged response from the previous call to this endpoint. Provide this cursor to retrieve the next page of results for your original request. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).

Returns:

Returns the ListBookingCustomAttributeDefinitionsResponse response from the API call

createBookingCustomAttributeDefinition

public CreateBookingCustomAttributeDefinitionResponse createBookingCustomAttributeDefinition(CreateBookingCustomAttributeDefinitionRequest body)
                                                                                      throws ApiException,
                                                                                             IOException

Creates a bookings custom attribute definition. 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*.

Specified by:

createBookingCustomAttributeDefinition in interface BookingCustomAttributesApi

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 CreateBookingCustomAttributeDefinitionResponse 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.

createBookingCustomAttributeDefinitionAsync

public CompletableFuture<CreateBookingCustomAttributeDefinitionResponse> createBookingCustomAttributeDefinitionAsync(CreateBookingCustomAttributeDefinitionRequest body)

Creates a bookings custom attribute definition. 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*.

Specified by:

createBookingCustomAttributeDefinitionAsync in interface BookingCustomAttributesApi

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 CreateBookingCustomAttributeDefinitionResponse response from the API call

deleteBookingCustomAttributeDefinition

public DeleteBookingCustomAttributeDefinitionResponse deleteBookingCustomAttributeDefinition(String key)
                                                                                      throws ApiException,
                                                                                             IOException

Deletes a bookings custom attribute definition. 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*.

Specified by:

deleteBookingCustomAttributeDefinition in interface BookingCustomAttributesApi

Parameters:

key - Required parameter: The key of the custom attribute definition to delete.

Returns:

Returns the DeleteBookingCustomAttributeDefinitionResponse 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.

deleteBookingCustomAttributeDefinitionAsync

public CompletableFuture<DeleteBookingCustomAttributeDefinitionResponse> deleteBookingCustomAttributeDefinitionAsync(String key)

Deletes a bookings custom attribute definition. 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*.

Specified by:

deleteBookingCustomAttributeDefinitionAsync in interface BookingCustomAttributesApi

Parameters:

key - Required parameter: The key of the custom attribute definition to delete.

Returns:

Returns the DeleteBookingCustomAttributeDefinitionResponse response from the API call

retrieveBookingCustomAttributeDefinition

public RetrieveBookingCustomAttributeDefinitionResponse retrieveBookingCustomAttributeDefinition(String key,
                                                                                                 Integer version)
                                                                                          throws ApiException,
                                                                                                 IOException

Retrieves a bookings custom attribute definition. 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.

Specified by:

retrieveBookingCustomAttributeDefinition in interface BookingCustomAttributesApi

Parameters:

key - Required parameter: The key of the custom attribute definition to retrieve. If the requesting application is not the definition owner, you must use the qualified key.

version - Optional parameter: The current version of the custom attribute definition, which is used for strongly consistent reads to guarantee that you receive the most up-to-date data. When included in the request, Square returns the specified version or a higher version if one exists. If the specified version is higher than the current version, Square returns a `BAD_REQUEST` error.

Returns:

Returns the RetrieveBookingCustomAttributeDefinitionResponse 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.

retrieveBookingCustomAttributeDefinitionAsync

public CompletableFuture<RetrieveBookingCustomAttributeDefinitionResponse> retrieveBookingCustomAttributeDefinitionAsync(String key,
                                                                                                                         Integer version)

Retrieves a bookings custom attribute definition. 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.

Specified by:

retrieveBookingCustomAttributeDefinitionAsync in interface BookingCustomAttributesApi

Parameters:

key - Required parameter: The key of the custom attribute definition to retrieve. If the requesting application is not the definition owner, you must use the qualified key.

version - Optional parameter: The current version of the custom attribute definition, which is used for strongly consistent reads to guarantee that you receive the most up-to-date data. When included in the request, Square returns the specified version or a higher version if one exists. If the specified version is higher than the current version, Square returns a `BAD_REQUEST` error.

Returns:

Returns the RetrieveBookingCustomAttributeDefinitionResponse response from the API call

updateBookingCustomAttributeDefinition

public UpdateBookingCustomAttributeDefinitionResponse updateBookingCustomAttributeDefinition(String key,
                                                                                             UpdateBookingCustomAttributeDefinitionRequest body)
                                                                                      throws ApiException,
                                                                                             IOException

Updates a bookings custom attribute definition. 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*.

Specified by:

updateBookingCustomAttributeDefinition in interface BookingCustomAttributesApi

Parameters:

key - Required parameter: The key of the custom attribute definition to update.

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

Returns:

Returns the UpdateBookingCustomAttributeDefinitionResponse 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.

updateBookingCustomAttributeDefinitionAsync

public CompletableFuture<UpdateBookingCustomAttributeDefinitionResponse> updateBookingCustomAttributeDefinitionAsync(String key,
                                                                                                                     UpdateBookingCustomAttributeDefinitionRequest body)

Updates a bookings custom attribute definition. 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*.

Specified by:

updateBookingCustomAttributeDefinitionAsync in interface BookingCustomAttributesApi

Parameters:

key - Required parameter: The key of the custom attribute definition to update.

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

Returns:

Returns the UpdateBookingCustomAttributeDefinitionResponse response from the API call

bulkDeleteBookingCustomAttributes

public BulkDeleteBookingCustomAttributesResponse bulkDeleteBookingCustomAttributes(BulkDeleteBookingCustomAttributesRequest body)
                                                                            throws ApiException,
                                                                                   IOException

Bulk deletes bookings custom attributes. 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*.

Specified by:

bulkDeleteBookingCustomAttributes in interface BookingCustomAttributesApi

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 BulkDeleteBookingCustomAttributesResponse 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.

bulkDeleteBookingCustomAttributesAsync

public CompletableFuture<BulkDeleteBookingCustomAttributesResponse> bulkDeleteBookingCustomAttributesAsync(BulkDeleteBookingCustomAttributesRequest body)

Bulk deletes bookings custom attributes. 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*.

Specified by:

bulkDeleteBookingCustomAttributesAsync in interface BookingCustomAttributesApi

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 BulkDeleteBookingCustomAttributesResponse response from the API call

bulkUpsertBookingCustomAttributes

public BulkUpsertBookingCustomAttributesResponse bulkUpsertBookingCustomAttributes(BulkUpsertBookingCustomAttributesRequest body)
                                                                            throws ApiException,
                                                                                   IOException

Bulk upserts bookings custom attributes. 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*.

Specified by:

bulkUpsertBookingCustomAttributes in interface BookingCustomAttributesApi

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 BulkUpsertBookingCustomAttributesResponse 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.

bulkUpsertBookingCustomAttributesAsync

public CompletableFuture<BulkUpsertBookingCustomAttributesResponse> bulkUpsertBookingCustomAttributesAsync(BulkUpsertBookingCustomAttributesRequest body)

Bulk upserts bookings custom attributes. 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*.

Specified by:

bulkUpsertBookingCustomAttributesAsync in interface BookingCustomAttributesApi

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 BulkUpsertBookingCustomAttributesResponse response from the API call

listBookingCustomAttributes

public ListBookingCustomAttributesResponse listBookingCustomAttributes(String bookingId,
                                                                       Integer limit,
                                                                       String cursor,
                                                                       Boolean withDefinitions)
                                                                throws ApiException,
                                                                       IOException

Lists a booking's custom attributes. 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.

Specified by:

listBookingCustomAttributes in interface BookingCustomAttributesApi

Parameters:

bookingId - Required parameter: The ID of the target [booking](entity:Booking).

limit - Optional parameter: The maximum number of results to return in a single paged response. This limit is advisory. The response might contain more or fewer results. The minimum value is 1 and the maximum value is 100. The default value is 20. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).

cursor - Optional parameter: The cursor returned in the paged response from the previous call to this endpoint. Provide this cursor to retrieve the next page of results for your original request. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).

withDefinitions - Optional parameter: Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of each custom attribute. Set this parameter to `true` to get the name and description of each custom attribute, information about the data type, or other definition details. The default value is `false`.

Returns:

Returns the ListBookingCustomAttributesResponse 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.

listBookingCustomAttributesAsync

public CompletableFuture<ListBookingCustomAttributesResponse> listBookingCustomAttributesAsync(String bookingId,
                                                                                               Integer limit,
                                                                                               String cursor,
                                                                                               Boolean withDefinitions)

Lists a booking's custom attributes. 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.

Specified by:

listBookingCustomAttributesAsync in interface BookingCustomAttributesApi

Parameters:

bookingId - Required parameter: The ID of the target [booking](entity:Booking).

limit - Optional parameter: The maximum number of results to return in a single paged response. This limit is advisory. The response might contain more or fewer results. The minimum value is 1 and the maximum value is 100. The default value is 20. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).

cursor - Optional parameter: The cursor returned in the paged response from the previous call to this endpoint. Provide this cursor to retrieve the next page of results for your original request. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).

withDefinitions - Optional parameter: Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of each custom attribute. Set this parameter to `true` to get the name and description of each custom attribute, information about the data type, or other definition details. The default value is `false`.

Returns:

Returns the ListBookingCustomAttributesResponse response from the API call

deleteBookingCustomAttribute

public DeleteBookingCustomAttributeResponse deleteBookingCustomAttribute(String bookingId,
                                                                         String key)
                                                                  throws ApiException,
                                                                         IOException

Deletes a bookings custom attribute. 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*.

Specified by:

deleteBookingCustomAttribute in interface BookingCustomAttributesApi

Parameters:

bookingId - Required parameter: The ID of the target [booking](entity:Booking).

key - Required parameter: The key of the custom attribute to delete. This key must match the `key` of a custom attribute definition in the Square seller account. If the requesting application is not the definition owner, you must use the qualified key.

Returns:

Returns the DeleteBookingCustomAttributeResponse 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.

deleteBookingCustomAttributeAsync

public CompletableFuture<DeleteBookingCustomAttributeResponse> deleteBookingCustomAttributeAsync(String bookingId,
                                                                                                 String key)

Deletes a bookings custom attribute. 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*.

Specified by:

deleteBookingCustomAttributeAsync in interface BookingCustomAttributesApi

Parameters:

bookingId - Required parameter: The ID of the target [booking](entity:Booking).

key - Required parameter: The key of the custom attribute to delete. This key must match the `key` of a custom attribute definition in the Square seller account. If the requesting application is not the definition owner, you must use the qualified key.

Returns:

Returns the DeleteBookingCustomAttributeResponse response from the API call

retrieveBookingCustomAttribute

public RetrieveBookingCustomAttributeResponse retrieveBookingCustomAttribute(String bookingId,
                                                                             String key,
                                                                             Boolean withDefinition,
                                                                             Integer version)
                                                                      throws ApiException,
                                                                             IOException

Retrieves a bookings custom attribute. 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.

Specified by:

retrieveBookingCustomAttribute in interface BookingCustomAttributesApi

Parameters:

bookingId - Required parameter: The ID of the target [booking](entity:Booking).

key - Required parameter: The key of the custom attribute to retrieve. This key must match the `key` of a custom attribute definition in the Square seller account. If the requesting application is not the definition owner, you must use the qualified key.

withDefinition - Optional parameter: Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of the custom attribute. Set this parameter to `true` to get the name and description of the custom attribute, information about the data type, or other definition details. The default value is `false`.

version - Optional parameter: The current version of the custom attribute, which is used for strongly consistent reads to guarantee that you receive the most up-to-date data. When included in the request, Square returns the specified version or a higher version if one exists. If the specified version is higher than the current version, Square returns a `BAD_REQUEST` error.

Returns:

Returns the RetrieveBookingCustomAttributeResponse 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.

retrieveBookingCustomAttributeAsync

public CompletableFuture<RetrieveBookingCustomAttributeResponse> retrieveBookingCustomAttributeAsync(String bookingId,
                                                                                                     String key,
                                                                                                     Boolean withDefinition,
                                                                                                     Integer version)

Retrieves a bookings custom attribute. 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.

Specified by:

retrieveBookingCustomAttributeAsync in interface BookingCustomAttributesApi

Parameters:

bookingId - Required parameter: The ID of the target [booking](entity:Booking).

key - Required parameter: The key of the custom attribute to retrieve. This key must match the `key` of a custom attribute definition in the Square seller account. If the requesting application is not the definition owner, you must use the qualified key.

withDefinition - Optional parameter: Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of the custom attribute. Set this parameter to `true` to get the name and description of the custom attribute, information about the data type, or other definition details. The default value is `false`.

version - Optional parameter: The current version of the custom attribute, which is used for strongly consistent reads to guarantee that you receive the most up-to-date data. When included in the request, Square returns the specified version or a higher version if one exists. If the specified version is higher than the current version, Square returns a `BAD_REQUEST` error.

Returns:

Returns the RetrieveBookingCustomAttributeResponse response from the API call

upsertBookingCustomAttribute

public UpsertBookingCustomAttributeResponse upsertBookingCustomAttribute(String bookingId,
                                                                         String key,
                                                                         UpsertBookingCustomAttributeRequest body)
                                                                  throws ApiException,
                                                                         IOException

Upserts a bookings custom attribute. 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*.

Specified by:

upsertBookingCustomAttribute in interface BookingCustomAttributesApi

Parameters:

bookingId - Required parameter: The ID of the target [booking](entity:Booking).

key - Required parameter: The key of the custom attribute to create or update. This key must match the `key` of a custom attribute definition in the Square seller account. If the requesting application is not the definition owner, you must use the qualified key.

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

Returns:

Returns the UpsertBookingCustomAttributeResponse 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.

upsertBookingCustomAttributeAsync

public CompletableFuture<UpsertBookingCustomAttributeResponse> upsertBookingCustomAttributeAsync(String bookingId,
                                                                                                 String key,
                                                                                                 UpsertBookingCustomAttributeRequest body)

Upserts a bookings custom attribute. 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*.

Specified by:

upsertBookingCustomAttributeAsync in interface BookingCustomAttributesApi

Parameters:

bookingId - Required parameter: The ID of the target [booking](entity:Booking).

key - Required parameter: The key of the custom attribute to create or update. This key must match the `key` of a custom attribute definition in the Square seller account. If the requesting application is not the definition owner, you must use the qualified key.

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

Returns:

Returns the UpsertBookingCustomAttributeResponse response from the API call