com.squareup.square.api

Class DefaultTeamApi

java.lang.Object

com.squareup.square.api.BaseApi

com.squareup.square.api.DefaultTeamApi

All Implemented Interfaces:

TeamApi

public final class DefaultTeamApi
extends BaseApi
implements TeamApi

This class lists all the endpoints of the groups.

Nested Class Summary

Nested classes/interfaces inherited from class com.squareup.square.api.BaseApi

BaseApi.RequestExecutor, BaseApi.RequestSupplier, BaseApi.ResponseHandler<T>

Field Summary

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

authManagers, config, httpCallback, internalUserAgent

Constructor Summary

Constructors

Constructor and Description
DefaultTeamApi(Configuration config, HttpClient httpClient, Map<String,AuthManager> authManagers) Initializes the controller.
DefaultTeamApi(Configuration config, HttpClient httpClient, Map<String,AuthManager> authManagers, HttpCallback httpCallback) Initializes the controller with HTTPCallback.

Method Summary

Modifier and Type	Method and Description
BulkCreateTeamMembersResponse	bulkCreateTeamMembers(BulkCreateTeamMembersRequest body) Creates multiple `TeamMember` objects.
CompletableFuture<BulkCreateTeamMembersResponse>	bulkCreateTeamMembersAsync(BulkCreateTeamMembersRequest body) Creates multiple `TeamMember` objects.
BulkUpdateTeamMembersResponse	bulkUpdateTeamMembers(BulkUpdateTeamMembersRequest body) Updates multiple `TeamMember` objects.
CompletableFuture<BulkUpdateTeamMembersResponse>	bulkUpdateTeamMembersAsync(BulkUpdateTeamMembersRequest body) Updates multiple `TeamMember` objects.
CreateTeamMemberResponse	createTeamMember(CreateTeamMemberRequest body) Creates a single `TeamMember` object.
CompletableFuture<CreateTeamMemberResponse>	createTeamMemberAsync(CreateTeamMemberRequest body) Creates a single `TeamMember` object.
RetrieveTeamMemberResponse	retrieveTeamMember(String teamMemberId) Retrieves a `TeamMember` object for the given `TeamMember.id`.
CompletableFuture<RetrieveTeamMemberResponse>	retrieveTeamMemberAsync(String teamMemberId) Retrieves a `TeamMember` object for the given `TeamMember.id`.
RetrieveWageSettingResponse	retrieveWageSetting(String teamMemberId) Retrieves a `WageSetting` object for a team member specified by `TeamMember.id`.
CompletableFuture<RetrieveWageSettingResponse>	retrieveWageSettingAsync(String teamMemberId) Retrieves a `WageSetting` object for a team member specified by `TeamMember.id`.
SearchTeamMembersResponse	searchTeamMembers(SearchTeamMembersRequest body) Returns a paginated list of `TeamMember` objects for a business.
CompletableFuture<SearchTeamMembersResponse>	searchTeamMembersAsync(SearchTeamMembersRequest body) Returns a paginated list of `TeamMember` objects for a business.
UpdateTeamMemberResponse	updateTeamMember(String teamMemberId, UpdateTeamMemberRequest body) Updates a single `TeamMember` object.
CompletableFuture<UpdateTeamMemberResponse>	updateTeamMemberAsync(String teamMemberId, UpdateTeamMemberRequest body) Updates a single `TeamMember` object.
UpdateWageSettingResponse	updateWageSetting(String teamMemberId, UpdateWageSettingRequest body) Creates or updates a `WageSetting` object.
CompletableFuture<UpdateWageSettingResponse>	updateWageSettingAsync(String teamMemberId, UpdateWageSettingRequest body) Creates or updates a `WageSetting` object.

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

getClientInstance, getHttpCallback, makeHttpCallAsync, validateResponse

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultTeamApi

public DefaultTeamApi(Configuration config,
                      HttpClient httpClient,
                      Map<String,AuthManager> authManagers)

Initializes the controller.

Parameters:

config - Configurations added in client.

httpClient - Send HTTP requests and read the responses.

authManagers - Apply authorization to requests.

DefaultTeamApi

public DefaultTeamApi(Configuration config,
                      HttpClient httpClient,
                      Map<String,AuthManager> authManagers,
                      HttpCallback httpCallback)

Initializes the controller with HTTPCallback.

Parameters:

config - Configurations added in client.

httpClient - Send HTTP requests and read the responses.

authManagers - Apply authorization to requests.

httpCallback - Callback to be called before and after the HTTP call.

Method Detail

createTeamMember

public CreateTeamMemberResponse createTeamMember(CreateTeamMemberRequest body)
                                          throws ApiException,
                                                 IOException

Creates a single `TeamMember` object. The `TeamMember` object is returned on successful creates. You must provide the following values in your request to this endpoint: - `given_name` - `family_name` Learn about [Troubleshooting the Team API](https://developer.squareup.com/docs/team/troubleshooting#createteammember).

Specified by:

createTeamMember in interface TeamApi

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

createTeamMemberAsync

public CompletableFuture<CreateTeamMemberResponse> createTeamMemberAsync(CreateTeamMemberRequest body)

Creates a single `TeamMember` object. The `TeamMember` object is returned on successful creates. You must provide the following values in your request to this endpoint: - `given_name` - `family_name` Learn about [Troubleshooting the Team API](https://developer.squareup.com/docs/team/troubleshooting#createteammember).

Specified by:

createTeamMemberAsync in interface TeamApi

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

bulkCreateTeamMembers

public BulkCreateTeamMembersResponse bulkCreateTeamMembers(BulkCreateTeamMembersRequest body)
                                                    throws ApiException,
                                                           IOException

Creates multiple `TeamMember` objects. The created `TeamMember` objects are returned on successful creates. This process is non-transactional and processes as much of the request as possible. If one of the creates in the request cannot be successfully processed, the request is not marked as failed, but the body of the response contains explicit error information for the failed create. Learn about [Troubleshooting the Team API](https://developer.squareup.com/docs/team/troubleshooting#bulk-create-team-members).

Specified by:

bulkCreateTeamMembers in interface TeamApi

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

bulkCreateTeamMembersAsync

public CompletableFuture<BulkCreateTeamMembersResponse> bulkCreateTeamMembersAsync(BulkCreateTeamMembersRequest body)

Creates multiple `TeamMember` objects. The created `TeamMember` objects are returned on successful creates. This process is non-transactional and processes as much of the request as possible. If one of the creates in the request cannot be successfully processed, the request is not marked as failed, but the body of the response contains explicit error information for the failed create. Learn about [Troubleshooting the Team API](https://developer.squareup.com/docs/team/troubleshooting#bulk-create-team-members).

Specified by:

bulkCreateTeamMembersAsync in interface TeamApi

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

bulkUpdateTeamMembers

public BulkUpdateTeamMembersResponse bulkUpdateTeamMembers(BulkUpdateTeamMembersRequest body)
                                                    throws ApiException,
                                                           IOException

Updates multiple `TeamMember` objects. The updated `TeamMember` objects are returned on successful updates. This process is non-transactional and processes as much of the request as possible. If one of the updates in the request cannot be successfully processed, the request is not marked as failed, but the body of the response contains explicit error information for the failed update. Learn about [Troubleshooting the Team API](https://developer.squareup.com/docs/team/troubleshooting#bulk-update-team-members).

Specified by:

bulkUpdateTeamMembers in interface TeamApi

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

bulkUpdateTeamMembersAsync

public CompletableFuture<BulkUpdateTeamMembersResponse> bulkUpdateTeamMembersAsync(BulkUpdateTeamMembersRequest body)

Updates multiple `TeamMember` objects. The updated `TeamMember` objects are returned on successful updates. This process is non-transactional and processes as much of the request as possible. If one of the updates in the request cannot be successfully processed, the request is not marked as failed, but the body of the response contains explicit error information for the failed update. Learn about [Troubleshooting the Team API](https://developer.squareup.com/docs/team/troubleshooting#bulk-update-team-members).

Specified by:

bulkUpdateTeamMembersAsync in interface TeamApi

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

searchTeamMembers

public SearchTeamMembersResponse searchTeamMembers(SearchTeamMembersRequest body)
                                            throws ApiException,
                                                   IOException

Returns a paginated list of `TeamMember` objects for a business. The list can be filtered by the following: - location IDs - `status`.

Specified by:

searchTeamMembers in interface TeamApi

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

searchTeamMembersAsync

public CompletableFuture<SearchTeamMembersResponse> searchTeamMembersAsync(SearchTeamMembersRequest body)

Returns a paginated list of `TeamMember` objects for a business. The list can be filtered by the following: - location IDs - `status`.

Specified by:

searchTeamMembersAsync in interface TeamApi

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

retrieveTeamMember

public RetrieveTeamMemberResponse retrieveTeamMember(String teamMemberId)
                                              throws ApiException,
                                                     IOException

Retrieves a `TeamMember` object for the given `TeamMember.id`. Learn about [Troubleshooting the Team API](https://developer.squareup.com/docs/team/troubleshooting#retrieve-a-team-member).

Specified by:

retrieveTeamMember in interface TeamApi

Parameters:

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

Returns:

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

retrieveTeamMemberAsync

public CompletableFuture<RetrieveTeamMemberResponse> retrieveTeamMemberAsync(String teamMemberId)

Retrieves a `TeamMember` object for the given `TeamMember.id`. Learn about [Troubleshooting the Team API](https://developer.squareup.com/docs/team/troubleshooting#retrieve-a-team-member).

Specified by:

retrieveTeamMemberAsync in interface TeamApi

Parameters:

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

Returns:

Returns the RetrieveTeamMemberResponse response from the API call

updateTeamMember

public UpdateTeamMemberResponse updateTeamMember(String teamMemberId,
                                                 UpdateTeamMemberRequest body)
                                          throws ApiException,
                                                 IOException

Updates a single `TeamMember` object. The `TeamMember` object is returned on successful updates. Learn about [Troubleshooting the Team API](https://developer.squareup.com/docs/team/troubleshooting#update-a-team-member).

Specified by:

updateTeamMember in interface TeamApi

Parameters:

teamMemberId - Required parameter: The ID of the team member 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 UpdateTeamMemberResponse 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.

updateTeamMemberAsync

public CompletableFuture<UpdateTeamMemberResponse> updateTeamMemberAsync(String teamMemberId,
                                                                         UpdateTeamMemberRequest body)

Updates a single `TeamMember` object. The `TeamMember` object is returned on successful updates. Learn about [Troubleshooting the Team API](https://developer.squareup.com/docs/team/troubleshooting#update-a-team-member).

Specified by:

updateTeamMemberAsync in interface TeamApi

Parameters:

teamMemberId - Required parameter: The ID of the team member 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 UpdateTeamMemberResponse response from the API call

retrieveWageSetting

public RetrieveWageSettingResponse retrieveWageSetting(String teamMemberId)
                                                throws ApiException,
                                                       IOException

Retrieves a `WageSetting` object for a team member specified by `TeamMember.id`. Learn about [Troubleshooting the Team API](https://developer.squareup.com/docs/team/troubleshooting#retrievewagesetting).

Specified by:

retrieveWageSetting in interface TeamApi

Parameters:

teamMemberId - Required parameter: The ID of the team member for which to retrieve the wage setting.

Returns:

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

retrieveWageSettingAsync

public CompletableFuture<RetrieveWageSettingResponse> retrieveWageSettingAsync(String teamMemberId)

Retrieves a `WageSetting` object for a team member specified by `TeamMember.id`. Learn about [Troubleshooting the Team API](https://developer.squareup.com/docs/team/troubleshooting#retrievewagesetting).

Specified by:

retrieveWageSettingAsync in interface TeamApi

Parameters:

teamMemberId - Required parameter: The ID of the team member for which to retrieve the wage setting.

Returns:

Returns the RetrieveWageSettingResponse response from the API call

updateWageSetting

public UpdateWageSettingResponse updateWageSetting(String teamMemberId,
                                                   UpdateWageSettingRequest body)
                                            throws ApiException,
                                                   IOException

Creates or updates a `WageSetting` object. The object is created if a `WageSetting` with the specified `team_member_id` does not exist. Otherwise, it fully replaces the `WageSetting` object for the team member. The `WageSetting` is returned on a successful update. Learn about [Troubleshooting the Team API](https://developer.squareup.com/docs/team/troubleshooting#create-or-update-a-wage-setting).

Specified by:

updateWageSetting in interface TeamApi

Parameters:

teamMemberId - Required parameter: The ID of the team member for which to update the `WageSetting` object.

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

Returns:

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

updateWageSettingAsync

public CompletableFuture<UpdateWageSettingResponse> updateWageSettingAsync(String teamMemberId,
                                                                           UpdateWageSettingRequest body)

Creates or updates a `WageSetting` object. The object is created if a `WageSetting` with the specified `team_member_id` does not exist. Otherwise, it fully replaces the `WageSetting` object for the team member. The `WageSetting` is returned on a successful update. Learn about [Troubleshooting the Team API](https://developer.squareup.com/docs/team/troubleshooting#create-or-update-a-wage-setting).

Specified by:

updateWageSettingAsync in interface TeamApi

Parameters:

teamMemberId - Required parameter: The ID of the team member for which to update the `WageSetting` object.

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

Returns:

Returns the UpdateWageSettingResponse response from the API call