com.squareup.square.legacy.api.DefaultTeamApi Maven / Gradle / Ivy
package com.squareup.square.legacy.api;
import com.fasterxml.jackson.core.JsonProcessingException;
import com.squareup.square.legacy.ApiHelper;
import com.squareup.square.legacy.Server;
import com.squareup.square.legacy.exceptions.ApiException;
import com.squareup.square.legacy.http.client.HttpContext;
import com.squareup.square.legacy.http.request.HttpMethod;
import com.squareup.square.legacy.models.BulkCreateTeamMembersRequest;
import com.squareup.square.legacy.models.BulkCreateTeamMembersResponse;
import com.squareup.square.legacy.models.BulkUpdateTeamMembersRequest;
import com.squareup.square.legacy.models.BulkUpdateTeamMembersResponse;
import com.squareup.square.legacy.models.CreateJobRequest;
import com.squareup.square.legacy.models.CreateJobResponse;
import com.squareup.square.legacy.models.CreateTeamMemberRequest;
import com.squareup.square.legacy.models.CreateTeamMemberResponse;
import com.squareup.square.legacy.models.ListJobsResponse;
import com.squareup.square.legacy.models.RetrieveJobResponse;
import com.squareup.square.legacy.models.RetrieveTeamMemberResponse;
import com.squareup.square.legacy.models.RetrieveWageSettingResponse;
import com.squareup.square.legacy.models.SearchTeamMembersRequest;
import com.squareup.square.legacy.models.SearchTeamMembersResponse;
import com.squareup.square.legacy.models.UpdateJobRequest;
import com.squareup.square.legacy.models.UpdateJobResponse;
import com.squareup.square.legacy.models.UpdateTeamMemberRequest;
import com.squareup.square.legacy.models.UpdateTeamMemberResponse;
import com.squareup.square.legacy.models.UpdateWageSettingRequest;
import com.squareup.square.legacy.models.UpdateWageSettingResponse;
import io.apimatic.core.ApiCall;
import io.apimatic.core.GlobalConfiguration;
import java.io.IOException;
import java.util.concurrent.CompletableFuture;
import java.util.concurrent.CompletionException;
/**
* This class lists all the endpoints of the groups.
*/
public final class DefaultTeamApi extends BaseApi implements TeamApi {
/**
* Initializes the controller.
* @param globalConfig Configurations added in client.
*/
public DefaultTeamApi(GlobalConfiguration globalConfig) {
super(globalConfig);
}
/**
* 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).
* @param body Required parameter: An object containing the fields to POST for the request.
* See the corresponding object definition for field details.
* @return Returns the CreateTeamMemberResponse response from the API call
* @throws ApiException Represents error response from the server.
* @throws IOException Signals that an I/O exception of some sort has occurred.
*/
public CreateTeamMemberResponse createTeamMember(final CreateTeamMemberRequest body)
throws ApiException, IOException {
return prepareCreateTeamMemberRequest(body).execute();
}
/**
* 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).
* @param body Required parameter: An object containing the fields to POST for the request.
* See the corresponding object definition for field details.
* @return Returns the CreateTeamMemberResponse response from the API call
*/
public CompletableFuture createTeamMemberAsync(final CreateTeamMemberRequest body) {
try {
return prepareCreateTeamMemberRequest(body).executeAsync();
} catch (Exception e) {
throw new CompletionException(e);
}
}
/**
* Builds the ApiCall object for createTeamMember.
*/
private ApiCall prepareCreateTeamMemberRequest(
final CreateTeamMemberRequest body) throws JsonProcessingException, IOException {
return new ApiCall.Builder()
.globalConfig(getGlobalConfiguration())
.requestBuilder(requestBuilder -> requestBuilder
.server(Server.ENUM_DEFAULT.value())
.path("/v2/team-members")
.bodyParam(param -> param.value(body))
.bodySerializer(() -> ApiHelper.serialize(body))
.headerParam(param -> param.key("Content-Type")
.value("application/json")
.isRequired(false))
.headerParam(param -> param.key("accept").value("application/json"))
.withAuth(auth -> auth.add("global"))
.httpMethod(HttpMethod.POST))
.responseHandler(responseHandler -> responseHandler
.deserializer(response -> ApiHelper.deserialize(response, CreateTeamMemberResponse.class))
.nullify404(false)
.contextInitializer((context, result) -> result.toBuilder()
.httpContext((HttpContext) context)
.build())
.globalErrorCase(GLOBAL_ERROR_CASES))
.build();
}
/**
* 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).
* @param body Required parameter: An object containing the fields to POST for the request.
* See the corresponding object definition for field details.
* @return Returns the BulkCreateTeamMembersResponse response from the API call
* @throws ApiException Represents error response from the server.
* @throws IOException Signals that an I/O exception of some sort has occurred.
*/
public BulkCreateTeamMembersResponse bulkCreateTeamMembers(final BulkCreateTeamMembersRequest body)
throws ApiException, IOException {
return prepareBulkCreateTeamMembersRequest(body).execute();
}
/**
* 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).
* @param body Required parameter: An object containing the fields to POST for the request.
* See the corresponding object definition for field details.
* @return Returns the BulkCreateTeamMembersResponse response from the API call
*/
public CompletableFuture bulkCreateTeamMembersAsync(
final BulkCreateTeamMembersRequest body) {
try {
return prepareBulkCreateTeamMembersRequest(body).executeAsync();
} catch (Exception e) {
throw new CompletionException(e);
}
}
/**
* Builds the ApiCall object for bulkCreateTeamMembers.
*/
private ApiCall prepareBulkCreateTeamMembersRequest(
final BulkCreateTeamMembersRequest body) throws JsonProcessingException, IOException {
return new ApiCall.Builder()
.globalConfig(getGlobalConfiguration())
.requestBuilder(requestBuilder -> requestBuilder
.server(Server.ENUM_DEFAULT.value())
.path("/v2/team-members/bulk-create")
.bodyParam(param -> param.value(body))
.bodySerializer(() -> ApiHelper.serialize(body))
.headerParam(param -> param.key("Content-Type")
.value("application/json")
.isRequired(false))
.headerParam(param -> param.key("accept").value("application/json"))
.withAuth(auth -> auth.add("global"))
.httpMethod(HttpMethod.POST))
.responseHandler(responseHandler -> responseHandler
.deserializer(response -> ApiHelper.deserialize(response, BulkCreateTeamMembersResponse.class))
.nullify404(false)
.contextInitializer((context, result) -> result.toBuilder()
.httpContext((HttpContext) context)
.build())
.globalErrorCase(GLOBAL_ERROR_CASES))
.build();
}
/**
* 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).
* @param body Required parameter: An object containing the fields to POST for the request.
* See the corresponding object definition for field details.
* @return Returns the BulkUpdateTeamMembersResponse response from the API call
* @throws ApiException Represents error response from the server.
* @throws IOException Signals that an I/O exception of some sort has occurred.
*/
public BulkUpdateTeamMembersResponse bulkUpdateTeamMembers(final BulkUpdateTeamMembersRequest body)
throws ApiException, IOException {
return prepareBulkUpdateTeamMembersRequest(body).execute();
}
/**
* 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).
* @param body Required parameter: An object containing the fields to POST for the request.
* See the corresponding object definition for field details.
* @return Returns the BulkUpdateTeamMembersResponse response from the API call
*/
public CompletableFuture bulkUpdateTeamMembersAsync(
final BulkUpdateTeamMembersRequest body) {
try {
return prepareBulkUpdateTeamMembersRequest(body).executeAsync();
} catch (Exception e) {
throw new CompletionException(e);
}
}
/**
* Builds the ApiCall object for bulkUpdateTeamMembers.
*/
private ApiCall prepareBulkUpdateTeamMembersRequest(
final BulkUpdateTeamMembersRequest body) throws JsonProcessingException, IOException {
return new ApiCall.Builder()
.globalConfig(getGlobalConfiguration())
.requestBuilder(requestBuilder -> requestBuilder
.server(Server.ENUM_DEFAULT.value())
.path("/v2/team-members/bulk-update")
.bodyParam(param -> param.value(body))
.bodySerializer(() -> ApiHelper.serialize(body))
.headerParam(param -> param.key("Content-Type")
.value("application/json")
.isRequired(false))
.headerParam(param -> param.key("accept").value("application/json"))
.withAuth(auth -> auth.add("global"))
.httpMethod(HttpMethod.POST))
.responseHandler(responseHandler -> responseHandler
.deserializer(response -> ApiHelper.deserialize(response, BulkUpdateTeamMembersResponse.class))
.nullify404(false)
.contextInitializer((context, result) -> result.toBuilder()
.httpContext((HttpContext) context)
.build())
.globalErrorCase(GLOBAL_ERROR_CASES))
.build();
}
/**
* Lists jobs in a seller account. Results are sorted by title in ascending order.
* @param cursor Optional parameter: The pagination cursor returned by 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).
* @return Returns the ListJobsResponse response from the API call
* @throws ApiException Represents error response from the server.
* @throws IOException Signals that an I/O exception of some sort has occurred.
*/
public ListJobsResponse listJobs(final String cursor) throws ApiException, IOException {
return prepareListJobsRequest(cursor).execute();
}
/**
* Lists jobs in a seller account. Results are sorted by title in ascending order.
* @param cursor Optional parameter: The pagination cursor returned by 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).
* @return Returns the ListJobsResponse response from the API call
*/
public CompletableFuture listJobsAsync(final String cursor) {
try {
return prepareListJobsRequest(cursor).executeAsync();
} catch (Exception e) {
throw new CompletionException(e);
}
}
/**
* Builds the ApiCall object for listJobs.
*/
private ApiCall prepareListJobsRequest(final String cursor) throws IOException {
return new ApiCall.Builder()
.globalConfig(getGlobalConfiguration())
.requestBuilder(requestBuilder -> requestBuilder
.server(Server.ENUM_DEFAULT.value())
.path("/v2/team-members/jobs")
.queryParam(param -> param.key("cursor").value(cursor).isRequired(false))
.headerParam(param -> param.key("accept").value("application/json"))
.withAuth(auth -> auth.add("global"))
.httpMethod(HttpMethod.GET))
.responseHandler(responseHandler -> responseHandler
.deserializer(response -> ApiHelper.deserialize(response, ListJobsResponse.class))
.nullify404(false)
.contextInitializer((context, result) -> result.toBuilder()
.httpContext((HttpContext) context)
.build())
.globalErrorCase(GLOBAL_ERROR_CASES))
.build();
}
/**
* Creates a job in a seller account. A job defines a title and tip eligibility. Note that
* compensation is defined in a [job assignment]($m/JobAssignment) in a team member's wage
* setting.
* @param body Required parameter: An object containing the fields to POST for the request.
* See the corresponding object definition for field details.
* @return Returns the CreateJobResponse response from the API call
* @throws ApiException Represents error response from the server.
* @throws IOException Signals that an I/O exception of some sort has occurred.
*/
public CreateJobResponse createJob(final CreateJobRequest body) throws ApiException, IOException {
return prepareCreateJobRequest(body).execute();
}
/**
* Creates a job in a seller account. A job defines a title and tip eligibility. Note that
* compensation is defined in a [job assignment]($m/JobAssignment) in a team member's wage
* setting.
* @param body Required parameter: An object containing the fields to POST for the request.
* See the corresponding object definition for field details.
* @return Returns the CreateJobResponse response from the API call
*/
public CompletableFuture createJobAsync(final CreateJobRequest body) {
try {
return prepareCreateJobRequest(body).executeAsync();
} catch (Exception e) {
throw new CompletionException(e);
}
}
/**
* Builds the ApiCall object for createJob.
*/
private ApiCall prepareCreateJobRequest(final CreateJobRequest body)
throws JsonProcessingException, IOException {
return new ApiCall.Builder()
.globalConfig(getGlobalConfiguration())
.requestBuilder(requestBuilder -> requestBuilder
.server(Server.ENUM_DEFAULT.value())
.path("/v2/team-members/jobs")
.bodyParam(param -> param.value(body))
.bodySerializer(() -> ApiHelper.serialize(body))
.headerParam(param -> param.key("Content-Type")
.value("application/json")
.isRequired(false))
.headerParam(param -> param.key("accept").value("application/json"))
.withAuth(auth -> auth.add("global"))
.httpMethod(HttpMethod.POST))
.responseHandler(responseHandler -> responseHandler
.deserializer(response -> ApiHelper.deserialize(response, CreateJobResponse.class))
.nullify404(false)
.contextInitializer((context, result) -> result.toBuilder()
.httpContext((HttpContext) context)
.build())
.globalErrorCase(GLOBAL_ERROR_CASES))
.build();
}
/**
* Retrieves a specified job.
* @param jobId Required parameter: The ID of the job to retrieve.
* @return Returns the RetrieveJobResponse response from the API call
* @throws ApiException Represents error response from the server.
* @throws IOException Signals that an I/O exception of some sort has occurred.
*/
public RetrieveJobResponse retrieveJob(final String jobId) throws ApiException, IOException {
return prepareRetrieveJobRequest(jobId).execute();
}
/**
* Retrieves a specified job.
* @param jobId Required parameter: The ID of the job to retrieve.
* @return Returns the RetrieveJobResponse response from the API call
*/
public CompletableFuture retrieveJobAsync(final String jobId) {
try {
return prepareRetrieveJobRequest(jobId).executeAsync();
} catch (Exception e) {
throw new CompletionException(e);
}
}
/**
* Builds the ApiCall object for retrieveJob.
*/
private ApiCall prepareRetrieveJobRequest(final String jobId)
throws IOException {
return new ApiCall.Builder()
.globalConfig(getGlobalConfiguration())
.requestBuilder(requestBuilder -> requestBuilder
.server(Server.ENUM_DEFAULT.value())
.path("/v2/team-members/jobs/{job_id}")
.templateParam(param -> param.key("job_id").value(jobId).shouldEncode(true))
.headerParam(param -> param.key("accept").value("application/json"))
.withAuth(auth -> auth.add("global"))
.httpMethod(HttpMethod.GET))
.responseHandler(responseHandler -> responseHandler
.deserializer(response -> ApiHelper.deserialize(response, RetrieveJobResponse.class))
.nullify404(false)
.contextInitializer((context, result) -> result.toBuilder()
.httpContext((HttpContext) context)
.build())
.globalErrorCase(GLOBAL_ERROR_CASES))
.build();
}
/**
* Updates the title or tip eligibility of a job. Changes to the title propagate to all
* `JobAssignment`, `Shift`, and `TeamMemberWage` objects that reference the job ID. Changes to
* tip eligibility propagate to all `TeamMemberWage` objects that reference the job ID.
* @param jobId Required parameter: The ID of the job to update.
* @param body Required parameter: An object containing the fields to POST for the request.
* See the corresponding object definition for field details.
* @return Returns the UpdateJobResponse response from the API call
* @throws ApiException Represents error response from the server.
* @throws IOException Signals that an I/O exception of some sort has occurred.
*/
public UpdateJobResponse updateJob(final String jobId, final UpdateJobRequest body)
throws ApiException, IOException {
return prepareUpdateJobRequest(jobId, body).execute();
}
/**
* Updates the title or tip eligibility of a job. Changes to the title propagate to all
* `JobAssignment`, `Shift`, and `TeamMemberWage` objects that reference the job ID. Changes to
* tip eligibility propagate to all `TeamMemberWage` objects that reference the job ID.
* @param jobId Required parameter: The ID of the job to update.
* @param body Required parameter: An object containing the fields to POST for the request.
* See the corresponding object definition for field details.
* @return Returns the UpdateJobResponse response from the API call
*/
public CompletableFuture updateJobAsync(final String jobId, final UpdateJobRequest body) {
try {
return prepareUpdateJobRequest(jobId, body).executeAsync();
} catch (Exception e) {
throw new CompletionException(e);
}
}
/**
* Builds the ApiCall object for updateJob.
*/
private ApiCall prepareUpdateJobRequest(
final String jobId, final UpdateJobRequest body) throws JsonProcessingException, IOException {
return new ApiCall.Builder()
.globalConfig(getGlobalConfiguration())
.requestBuilder(requestBuilder -> requestBuilder
.server(Server.ENUM_DEFAULT.value())
.path("/v2/team-members/jobs/{job_id}")
.bodyParam(param -> param.value(body))
.bodySerializer(() -> ApiHelper.serialize(body))
.templateParam(param -> param.key("job_id").value(jobId).shouldEncode(true))
.headerParam(param -> param.key("Content-Type")
.value("application/json")
.isRequired(false))
.headerParam(param -> param.key("accept").value("application/json"))
.withAuth(auth -> auth.add("global"))
.httpMethod(HttpMethod.PUT))
.responseHandler(responseHandler -> responseHandler
.deserializer(response -> ApiHelper.deserialize(response, UpdateJobResponse.class))
.nullify404(false)
.contextInitializer((context, result) -> result.toBuilder()
.httpContext((HttpContext) context)
.build())
.globalErrorCase(GLOBAL_ERROR_CASES))
.build();
}
/**
* Returns a paginated list of `TeamMember` objects for a business. The list can be filtered by
* location IDs, `ACTIVE` or `INACTIVE` status, or whether the team member is the Square account
* owner.
* @param body Required parameter: An object containing the fields to POST for the request.
* See the corresponding object definition for field details.
* @return Returns the SearchTeamMembersResponse response from the API call
* @throws ApiException Represents error response from the server.
* @throws IOException Signals that an I/O exception of some sort has occurred.
*/
public SearchTeamMembersResponse searchTeamMembers(final SearchTeamMembersRequest body)
throws ApiException, IOException {
return prepareSearchTeamMembersRequest(body).execute();
}
/**
* Returns a paginated list of `TeamMember` objects for a business. The list can be filtered by
* location IDs, `ACTIVE` or `INACTIVE` status, or whether the team member is the Square account
* owner.
* @param body Required parameter: An object containing the fields to POST for the request.
* See the corresponding object definition for field details.
* @return Returns the SearchTeamMembersResponse response from the API call
*/
public CompletableFuture searchTeamMembersAsync(final SearchTeamMembersRequest body) {
try {
return prepareSearchTeamMembersRequest(body).executeAsync();
} catch (Exception e) {
throw new CompletionException(e);
}
}
/**
* Builds the ApiCall object for searchTeamMembers.
*/
private ApiCall prepareSearchTeamMembersRequest(
final SearchTeamMembersRequest body) throws JsonProcessingException, IOException {
return new ApiCall.Builder()
.globalConfig(getGlobalConfiguration())
.requestBuilder(requestBuilder -> requestBuilder
.server(Server.ENUM_DEFAULT.value())
.path("/v2/team-members/search")
.bodyParam(param -> param.value(body))
.bodySerializer(() -> ApiHelper.serialize(body))
.headerParam(param -> param.key("Content-Type")
.value("application/json")
.isRequired(false))
.headerParam(param -> param.key("accept").value("application/json"))
.withAuth(auth -> auth.add("global"))
.httpMethod(HttpMethod.POST))
.responseHandler(responseHandler -> responseHandler
.deserializer(response -> ApiHelper.deserialize(response, SearchTeamMembersResponse.class))
.nullify404(false)
.contextInitializer((context, result) -> result.toBuilder()
.httpContext((HttpContext) context)
.build())
.globalErrorCase(GLOBAL_ERROR_CASES))
.build();
}
/**
* 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).
* @param teamMemberId Required parameter: The ID of the team member to retrieve.
* @return Returns the RetrieveTeamMemberResponse response from the API call
* @throws ApiException Represents error response from the server.
* @throws IOException Signals that an I/O exception of some sort has occurred.
*/
public RetrieveTeamMemberResponse retrieveTeamMember(final String teamMemberId) throws ApiException, IOException {
return prepareRetrieveTeamMemberRequest(teamMemberId).execute();
}
/**
* 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).
* @param teamMemberId Required parameter: The ID of the team member to retrieve.
* @return Returns the RetrieveTeamMemberResponse response from the API call
*/
public CompletableFuture retrieveTeamMemberAsync(final String teamMemberId) {
try {
return prepareRetrieveTeamMemberRequest(teamMemberId).executeAsync();
} catch (Exception e) {
throw new CompletionException(e);
}
}
/**
* Builds the ApiCall object for retrieveTeamMember.
*/
private ApiCall prepareRetrieveTeamMemberRequest(
final String teamMemberId) throws IOException {
return new ApiCall.Builder()
.globalConfig(getGlobalConfiguration())
.requestBuilder(requestBuilder -> requestBuilder
.server(Server.ENUM_DEFAULT.value())
.path("/v2/team-members/{team_member_id}")
.templateParam(param ->
param.key("team_member_id").value(teamMemberId).shouldEncode(true))
.headerParam(param -> param.key("accept").value("application/json"))
.withAuth(auth -> auth.add("global"))
.httpMethod(HttpMethod.GET))
.responseHandler(responseHandler -> responseHandler
.deserializer(response -> ApiHelper.deserialize(response, RetrieveTeamMemberResponse.class))
.nullify404(false)
.contextInitializer((context, result) -> result.toBuilder()
.httpContext((HttpContext) context)
.build())
.globalErrorCase(GLOBAL_ERROR_CASES))
.build();
}
/**
* 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).
* @param teamMemberId Required parameter: The ID of the team member to update.
* @param body Required parameter: An object containing the fields to POST for the request.
* See the corresponding object definition for field details.
* @return Returns the UpdateTeamMemberResponse response from the API call
* @throws ApiException Represents error response from the server.
* @throws IOException Signals that an I/O exception of some sort has occurred.
*/
public UpdateTeamMemberResponse updateTeamMember(final String teamMemberId, final UpdateTeamMemberRequest body)
throws ApiException, IOException {
return prepareUpdateTeamMemberRequest(teamMemberId, body).execute();
}
/**
* 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).
* @param teamMemberId Required parameter: The ID of the team member to update.
* @param body Required parameter: An object containing the fields to POST for the request.
* See the corresponding object definition for field details.
* @return Returns the UpdateTeamMemberResponse response from the API call
*/
public CompletableFuture updateTeamMemberAsync(
final String teamMemberId, final UpdateTeamMemberRequest body) {
try {
return prepareUpdateTeamMemberRequest(teamMemberId, body).executeAsync();
} catch (Exception e) {
throw new CompletionException(e);
}
}
/**
* Builds the ApiCall object for updateTeamMember.
*/
private ApiCall prepareUpdateTeamMemberRequest(
final String teamMemberId, final UpdateTeamMemberRequest body) throws JsonProcessingException, IOException {
return new ApiCall.Builder()
.globalConfig(getGlobalConfiguration())
.requestBuilder(requestBuilder -> requestBuilder
.server(Server.ENUM_DEFAULT.value())
.path("/v2/team-members/{team_member_id}")
.bodyParam(param -> param.value(body))
.bodySerializer(() -> ApiHelper.serialize(body))
.templateParam(param ->
param.key("team_member_id").value(teamMemberId).shouldEncode(true))
.headerParam(param -> param.key("Content-Type")
.value("application/json")
.isRequired(false))
.headerParam(param -> param.key("accept").value("application/json"))
.withAuth(auth -> auth.add("global"))
.httpMethod(HttpMethod.PUT))
.responseHandler(responseHandler -> responseHandler
.deserializer(response -> ApiHelper.deserialize(response, UpdateTeamMemberResponse.class))
.nullify404(false)
.contextInitializer((context, result) -> result.toBuilder()
.httpContext((HttpContext) context)
.build())
.globalErrorCase(GLOBAL_ERROR_CASES))
.build();
}
/**
* Retrieves a `WageSetting` object for a team member specified by `TeamMember.id`. For more
* information, see [Troubleshooting the Team
* API](https://developer.squareup.com/docs/team/troubleshooting#retrievewagesetting). Square
* recommends using [RetrieveTeamMember]($e/Team/RetrieveTeamMember) or
* [SearchTeamMembers]($e/Team/SearchTeamMembers) to get this information directly from the
* `TeamMember.wage_setting` field.
* @param teamMemberId Required parameter: The ID of the team member for which to retrieve the
* wage setting.
* @return Returns the RetrieveWageSettingResponse response from the API call
* @throws ApiException Represents error response from the server.
* @throws IOException Signals that an I/O exception of some sort has occurred.
*/
public RetrieveWageSettingResponse retrieveWageSetting(final String teamMemberId) throws ApiException, IOException {
return prepareRetrieveWageSettingRequest(teamMemberId).execute();
}
/**
* Retrieves a `WageSetting` object for a team member specified by `TeamMember.id`. For more
* information, see [Troubleshooting the Team
* API](https://developer.squareup.com/docs/team/troubleshooting#retrievewagesetting). Square
* recommends using [RetrieveTeamMember]($e/Team/RetrieveTeamMember) or
* [SearchTeamMembers]($e/Team/SearchTeamMembers) to get this information directly from the
* `TeamMember.wage_setting` field.
* @param teamMemberId Required parameter: The ID of the team member for which to retrieve the
* wage setting.
* @return Returns the RetrieveWageSettingResponse response from the API call
*/
public CompletableFuture retrieveWageSettingAsync(final String teamMemberId) {
try {
return prepareRetrieveWageSettingRequest(teamMemberId).executeAsync();
} catch (Exception e) {
throw new CompletionException(e);
}
}
/**
* Builds the ApiCall object for retrieveWageSetting.
*/
private ApiCall prepareRetrieveWageSettingRequest(
final String teamMemberId) throws IOException {
return new ApiCall.Builder()
.globalConfig(getGlobalConfiguration())
.requestBuilder(requestBuilder -> requestBuilder
.server(Server.ENUM_DEFAULT.value())
.path("/v2/team-members/{team_member_id}/wage-setting")
.templateParam(param ->
param.key("team_member_id").value(teamMemberId).shouldEncode(true))
.headerParam(param -> param.key("accept").value("application/json"))
.withAuth(auth -> auth.add("global"))
.httpMethod(HttpMethod.GET))
.responseHandler(responseHandler -> responseHandler
.deserializer(response -> ApiHelper.deserialize(response, RetrieveWageSettingResponse.class))
.nullify404(false)
.contextInitializer((context, result) -> result.toBuilder()
.httpContext((HttpContext) context)
.build())
.globalErrorCase(GLOBAL_ERROR_CASES))
.build();
}
/**
* Creates or updates a `WageSetting` object. The object is created if a `WageSetting` with the
* specified `team_member_id` doesn't exist. Otherwise, it fully replaces the `WageSetting`
* object for the team member. The `WageSetting` is returned on a successful update. For more
* information, see [Troubleshooting the Team
* API](https://developer.squareup.com/docs/team/troubleshooting#create-or-update-a-wage-setting).
* Square recommends using [CreateTeamMember]($e/Team/CreateTeamMember) or
* [UpdateTeamMember]($e/Team/UpdateTeamMember) to manage the `TeamMember.wage_setting` field
* directly.
* @param teamMemberId Required parameter: The ID of the team member for which to update the
* `WageSetting` object.
* @param body Required parameter: An object containing the fields to POST for the request.
* See the corresponding object definition for field details.
* @return Returns the UpdateWageSettingResponse response from the API call
* @throws ApiException Represents error response from the server.
* @throws IOException Signals that an I/O exception of some sort has occurred.
*/
public UpdateWageSettingResponse updateWageSetting(final String teamMemberId, final UpdateWageSettingRequest body)
throws ApiException, IOException {
return prepareUpdateWageSettingRequest(teamMemberId, body).execute();
}
/**
* Creates or updates a `WageSetting` object. The object is created if a `WageSetting` with the
* specified `team_member_id` doesn't exist. Otherwise, it fully replaces the `WageSetting`
* object for the team member. The `WageSetting` is returned on a successful update. For more
* information, see [Troubleshooting the Team
* API](https://developer.squareup.com/docs/team/troubleshooting#create-or-update-a-wage-setting).
* Square recommends using [CreateTeamMember]($e/Team/CreateTeamMember) or
* [UpdateTeamMember]($e/Team/UpdateTeamMember) to manage the `TeamMember.wage_setting` field
* directly.
* @param teamMemberId Required parameter: The ID of the team member for which to update the
* `WageSetting` object.
* @param body Required parameter: An object containing the fields to POST for the request.
* See the corresponding object definition for field details.
* @return Returns the UpdateWageSettingResponse response from the API call
*/
public CompletableFuture updateWageSettingAsync(
final String teamMemberId, final UpdateWageSettingRequest body) {
try {
return prepareUpdateWageSettingRequest(teamMemberId, body).executeAsync();
} catch (Exception e) {
throw new CompletionException(e);
}
}
/**
* Builds the ApiCall object for updateWageSetting.
*/
private ApiCall prepareUpdateWageSettingRequest(
final String teamMemberId, final UpdateWageSettingRequest body)
throws JsonProcessingException, IOException {
return new ApiCall.Builder()
.globalConfig(getGlobalConfiguration())
.requestBuilder(requestBuilder -> requestBuilder
.server(Server.ENUM_DEFAULT.value())
.path("/v2/team-members/{team_member_id}/wage-setting")
.bodyParam(param -> param.value(body))
.bodySerializer(() -> ApiHelper.serialize(body))
.templateParam(param ->
param.key("team_member_id").value(teamMemberId).shouldEncode(true))
.headerParam(param -> param.key("Content-Type")
.value("application/json")
.isRequired(false))
.headerParam(param -> param.key("accept").value("application/json"))
.withAuth(auth -> auth.add("global"))
.httpMethod(HttpMethod.PUT))
.responseHandler(responseHandler -> responseHandler
.deserializer(response -> ApiHelper.deserialize(response, UpdateWageSettingResponse.class))
.nullify404(false)
.contextInitializer((context, result) -> result.toBuilder()
.httpContext((HttpContext) context)
.build())
.globalErrorCase(GLOBAL_ERROR_CASES))
.build();
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy