com.squareup.square.api

Class DefaultMerchantCustomAttributesApi

java.lang.Object

com.squareup.square.api.BaseApi

com.squareup.square.api.DefaultMerchantCustomAttributesApi

All Implemented Interfaces:

MerchantCustomAttributesApi

public final class DefaultMerchantCustomAttributesApi
extends BaseApi
implements MerchantCustomAttributesApi

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
DefaultMerchantCustomAttributesApi(io.apimatic.core.GlobalConfiguration globalConfig) Initializes the controller.

Method Summary

Modifier and Type	Method and Description
BulkDeleteMerchantCustomAttributesResponse	bulkDeleteMerchantCustomAttributes(BulkDeleteMerchantCustomAttributesRequest body) Deletes [custom attributes]($m/CustomAttribute) for a merchant as a bulk operation.
CompletableFuture<BulkDeleteMerchantCustomAttributesResponse>	bulkDeleteMerchantCustomAttributesAsync(BulkDeleteMerchantCustomAttributesRequest body) Deletes [custom attributes]($m/CustomAttribute) for a merchant as a bulk operation.
BulkUpsertMerchantCustomAttributesResponse	bulkUpsertMerchantCustomAttributes(BulkUpsertMerchantCustomAttributesRequest body) Creates or updates [custom attributes]($m/CustomAttribute) for a merchant as a bulk operation.
CompletableFuture<BulkUpsertMerchantCustomAttributesResponse>	bulkUpsertMerchantCustomAttributesAsync(BulkUpsertMerchantCustomAttributesRequest body) Creates or updates [custom attributes]($m/CustomAttribute) for a merchant as a bulk operation.
CreateMerchantCustomAttributeDefinitionResponse	createMerchantCustomAttributeDefinition(CreateMerchantCustomAttributeDefinitionRequest body) Creates a merchant-related [custom attribute definition]($m/CustomAttributeDefinition) for a Square seller account.
CompletableFuture<CreateMerchantCustomAttributeDefinitionResponse>	createMerchantCustomAttributeDefinitionAsync(CreateMerchantCustomAttributeDefinitionRequest body) Creates a merchant-related [custom attribute definition]($m/CustomAttributeDefinition) for a Square seller account.
DeleteMerchantCustomAttributeResponse	deleteMerchantCustomAttribute(String merchantId, String key) Deletes a [custom attribute]($m/CustomAttribute) associated with a merchant.
CompletableFuture<DeleteMerchantCustomAttributeResponse>	deleteMerchantCustomAttributeAsync(String merchantId, String key) Deletes a [custom attribute]($m/CustomAttribute) associated with a merchant.
DeleteMerchantCustomAttributeDefinitionResponse	deleteMerchantCustomAttributeDefinition(String key) Deletes a merchant-related [custom attribute definition]($m/CustomAttributeDefinition) from a Square seller account.
CompletableFuture<DeleteMerchantCustomAttributeDefinitionResponse>	deleteMerchantCustomAttributeDefinitionAsync(String key) Deletes a merchant-related [custom attribute definition]($m/CustomAttributeDefinition) from a Square seller account.
ListMerchantCustomAttributeDefinitionsResponse	listMerchantCustomAttributeDefinitions(String visibilityFilter, Integer limit, String cursor) Lists the merchant-related [custom attribute definitions]($m/CustomAttributeDefinition) that belong to a Square seller account.
CompletableFuture<ListMerchantCustomAttributeDefinitionsResponse>	listMerchantCustomAttributeDefinitionsAsync(String visibilityFilter, Integer limit, String cursor) Lists the merchant-related [custom attribute definitions]($m/CustomAttributeDefinition) that belong to a Square seller account.
ListMerchantCustomAttributesResponse	listMerchantCustomAttributes(String merchantId, String visibilityFilter, Integer limit, String cursor, Boolean withDefinitions) Lists the [custom attributes]($m/CustomAttribute) associated with a merchant.
CompletableFuture<ListMerchantCustomAttributesResponse>	listMerchantCustomAttributesAsync(String merchantId, String visibilityFilter, Integer limit, String cursor, Boolean withDefinitions) Lists the [custom attributes]($m/CustomAttribute) associated with a merchant.
RetrieveMerchantCustomAttributeResponse	retrieveMerchantCustomAttribute(String merchantId, String key, Boolean withDefinition, Integer version) Retrieves a [custom attribute]($m/CustomAttribute) associated with a merchant.
CompletableFuture<RetrieveMerchantCustomAttributeResponse>	retrieveMerchantCustomAttributeAsync(String merchantId, String key, Boolean withDefinition, Integer version) Retrieves a [custom attribute]($m/CustomAttribute) associated with a merchant.
RetrieveMerchantCustomAttributeDefinitionResponse	retrieveMerchantCustomAttributeDefinition(String key, Integer version) Retrieves a merchant-related [custom attribute definition]($m/CustomAttributeDefinition) from a Square seller account.
CompletableFuture<RetrieveMerchantCustomAttributeDefinitionResponse>	retrieveMerchantCustomAttributeDefinitionAsync(String key, Integer version) Retrieves a merchant-related [custom attribute definition]($m/CustomAttributeDefinition) from a Square seller account.
UpdateMerchantCustomAttributeDefinitionResponse	updateMerchantCustomAttributeDefinition(String key, UpdateMerchantCustomAttributeDefinitionRequest body) Updates a merchant-related [custom attribute definition]($m/CustomAttributeDefinition) for a Square seller account.
CompletableFuture<UpdateMerchantCustomAttributeDefinitionResponse>	updateMerchantCustomAttributeDefinitionAsync(String key, UpdateMerchantCustomAttributeDefinitionRequest body) Updates a merchant-related [custom attribute definition]($m/CustomAttributeDefinition) for a Square seller account.
UpsertMerchantCustomAttributeResponse	upsertMerchantCustomAttribute(String merchantId, String key, UpsertMerchantCustomAttributeRequest body) Creates or updates a [custom attribute]($m/CustomAttribute) for a merchant.
CompletableFuture<UpsertMerchantCustomAttributeResponse>	upsertMerchantCustomAttributeAsync(String merchantId, String key, UpsertMerchantCustomAttributeRequest body) Creates or updates a [custom attribute]($m/CustomAttribute) for a merchant.

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

DefaultMerchantCustomAttributesApi

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

Initializes the controller.

Parameters:

globalConfig - Configurations added in client.

Method Detail

listMerchantCustomAttributeDefinitions

public ListMerchantCustomAttributeDefinitionsResponse listMerchantCustomAttributeDefinitions(String visibilityFilter,
                                                                                             Integer limit,
                                                                                             String cursor)
                                                                                      throws ApiException,
                                                                                             IOException

Lists the merchant-related [custom attribute definitions]($m/CustomAttributeDefinition) that belong to a Square seller account. When all response pages are retrieved, the results include all custom attribute definitions that are visible to the requesting application, including those that are created by other applications and set to `VISIBILITY_READ_ONLY` or `VISIBILITY_READ_WRITE_VALUES`.

Specified by:

listMerchantCustomAttributeDefinitions in interface MerchantCustomAttributesApi

Parameters:

visibilityFilter - Optional parameter: Filters the `CustomAttributeDefinition` results by their `visibility` values.

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

listMerchantCustomAttributeDefinitionsAsync

public CompletableFuture<ListMerchantCustomAttributeDefinitionsResponse> listMerchantCustomAttributeDefinitionsAsync(String visibilityFilter,
                                                                                                                     Integer limit,
                                                                                                                     String cursor)

Lists the merchant-related [custom attribute definitions]($m/CustomAttributeDefinition) that belong to a Square seller account. When all response pages are retrieved, the results include all custom attribute definitions that are visible to the requesting application, including those that are created by other applications and set to `VISIBILITY_READ_ONLY` or `VISIBILITY_READ_WRITE_VALUES`.

Specified by:

listMerchantCustomAttributeDefinitionsAsync in interface MerchantCustomAttributesApi

Parameters:

visibilityFilter - Optional parameter: Filters the `CustomAttributeDefinition` results by their `visibility` values.

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

createMerchantCustomAttributeDefinition

public CreateMerchantCustomAttributeDefinitionResponse createMerchantCustomAttributeDefinition(CreateMerchantCustomAttributeDefinitionRequest body)
                                                                                        throws ApiException,
                                                                                               IOException

Creates a merchant-related [custom attribute definition]($m/CustomAttributeDefinition) for a Square seller account. Use this endpoint to define a custom attribute that can be associated with a merchant connecting to your application. A custom attribute definition specifies the `key`, `visibility`, `schema`, and other properties for a custom attribute. After the definition is created, you can call [UpsertMerchantCustomAttribute]($e/MerchantCustomAttributes/UpsertMerchantCustomAttribute) or [BulkUpsertMerchantCustomAttributes]($e/MerchantCustomAttributes/BulkUpsertMerchantCustomAttributes) to set the custom attribute for a merchant.

Specified by:

createMerchantCustomAttributeDefinition in interface MerchantCustomAttributesApi

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

createMerchantCustomAttributeDefinitionAsync

public CompletableFuture<CreateMerchantCustomAttributeDefinitionResponse> createMerchantCustomAttributeDefinitionAsync(CreateMerchantCustomAttributeDefinitionRequest body)

Creates a merchant-related [custom attribute definition]($m/CustomAttributeDefinition) for a Square seller account. Use this endpoint to define a custom attribute that can be associated with a merchant connecting to your application. A custom attribute definition specifies the `key`, `visibility`, `schema`, and other properties for a custom attribute. After the definition is created, you can call [UpsertMerchantCustomAttribute]($e/MerchantCustomAttributes/UpsertMerchantCustomAttribute) or [BulkUpsertMerchantCustomAttributes]($e/MerchantCustomAttributes/BulkUpsertMerchantCustomAttributes) to set the custom attribute for a merchant.

Specified by:

createMerchantCustomAttributeDefinitionAsync in interface MerchantCustomAttributesApi

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

deleteMerchantCustomAttributeDefinition

public DeleteMerchantCustomAttributeDefinitionResponse deleteMerchantCustomAttributeDefinition(String key)
                                                                                        throws ApiException,
                                                                                               IOException

Deletes a merchant-related [custom attribute definition]($m/CustomAttributeDefinition) from a Square seller account. Deleting a custom attribute definition also deletes the corresponding custom attribute from the merchant. Only the definition owner can delete a custom attribute definition.

Specified by:

deleteMerchantCustomAttributeDefinition in interface MerchantCustomAttributesApi

Parameters:

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

Returns:

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

deleteMerchantCustomAttributeDefinitionAsync

public CompletableFuture<DeleteMerchantCustomAttributeDefinitionResponse> deleteMerchantCustomAttributeDefinitionAsync(String key)

Deletes a merchant-related [custom attribute definition]($m/CustomAttributeDefinition) from a Square seller account. Deleting a custom attribute definition also deletes the corresponding custom attribute from the merchant. Only the definition owner can delete a custom attribute definition.

Specified by:

deleteMerchantCustomAttributeDefinitionAsync in interface MerchantCustomAttributesApi

Parameters:

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

Returns:

Returns the DeleteMerchantCustomAttributeDefinitionResponse response from the API call

retrieveMerchantCustomAttributeDefinition

public RetrieveMerchantCustomAttributeDefinitionResponse retrieveMerchantCustomAttributeDefinition(String key,
                                                                                                   Integer version)
                                                                                            throws ApiException,
                                                                                                   IOException

Retrieves a merchant-related [custom attribute definition]($m/CustomAttributeDefinition) from a Square seller account. To retrieve a custom attribute definition created by another application, the `visibility` setting must be `VISIBILITY_READ_ONLY` or `VISIBILITY_READ_WRITE_VALUES`.

Specified by:

retrieveMerchantCustomAttributeDefinition in interface MerchantCustomAttributesApi

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

retrieveMerchantCustomAttributeDefinitionAsync

public CompletableFuture<RetrieveMerchantCustomAttributeDefinitionResponse> retrieveMerchantCustomAttributeDefinitionAsync(String key,
                                                                                                                           Integer version)

Retrieves a merchant-related [custom attribute definition]($m/CustomAttributeDefinition) from a Square seller account. To retrieve a custom attribute definition created by another application, the `visibility` setting must be `VISIBILITY_READ_ONLY` or `VISIBILITY_READ_WRITE_VALUES`.

Specified by:

retrieveMerchantCustomAttributeDefinitionAsync in interface MerchantCustomAttributesApi

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

updateMerchantCustomAttributeDefinition

public UpdateMerchantCustomAttributeDefinitionResponse updateMerchantCustomAttributeDefinition(String key,
                                                                                               UpdateMerchantCustomAttributeDefinitionRequest body)
                                                                                        throws ApiException,
                                                                                               IOException

Updates a merchant-related [custom attribute definition]($m/CustomAttributeDefinition) for a Square seller account. Use this endpoint to update the following fields: `name`, `description`, `visibility`, or the `schema` for a `Selection` data type. Only the definition owner can update a custom attribute definition.

Specified by:

updateMerchantCustomAttributeDefinition in interface MerchantCustomAttributesApi

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

updateMerchantCustomAttributeDefinitionAsync

public CompletableFuture<UpdateMerchantCustomAttributeDefinitionResponse> updateMerchantCustomAttributeDefinitionAsync(String key,
                                                                                                                       UpdateMerchantCustomAttributeDefinitionRequest body)

Updates a merchant-related [custom attribute definition]($m/CustomAttributeDefinition) for a Square seller account. Use this endpoint to update the following fields: `name`, `description`, `visibility`, or the `schema` for a `Selection` data type. Only the definition owner can update a custom attribute definition.

Specified by:

updateMerchantCustomAttributeDefinitionAsync in interface MerchantCustomAttributesApi

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

bulkDeleteMerchantCustomAttributes

public BulkDeleteMerchantCustomAttributesResponse bulkDeleteMerchantCustomAttributes(BulkDeleteMerchantCustomAttributesRequest body)
                                                                              throws ApiException,
                                                                                     IOException

Deletes [custom attributes]($m/CustomAttribute) for a merchant as a bulk operation. To delete a custom attribute owned by another application, the `visibility` setting must be `VISIBILITY_READ_WRITE_VALUES`.

Specified by:

bulkDeleteMerchantCustomAttributes in interface MerchantCustomAttributesApi

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

bulkDeleteMerchantCustomAttributesAsync

public CompletableFuture<BulkDeleteMerchantCustomAttributesResponse> bulkDeleteMerchantCustomAttributesAsync(BulkDeleteMerchantCustomAttributesRequest body)

Deletes [custom attributes]($m/CustomAttribute) for a merchant as a bulk operation. To delete a custom attribute owned by another application, the `visibility` setting must be `VISIBILITY_READ_WRITE_VALUES`.

Specified by:

bulkDeleteMerchantCustomAttributesAsync in interface MerchantCustomAttributesApi

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

bulkUpsertMerchantCustomAttributes

public BulkUpsertMerchantCustomAttributesResponse bulkUpsertMerchantCustomAttributes(BulkUpsertMerchantCustomAttributesRequest body)
                                                                              throws ApiException,
                                                                                     IOException

Creates or updates [custom attributes]($m/CustomAttribute) for a merchant as a bulk operation. Use this endpoint to set the value of one or more custom attributes for a merchant. A custom attribute is based on a custom attribute definition in a Square seller account, which is created using the [CreateMerchantCustomAttributeDefinition]($e/MerchantCustomAttributes/CreateMerchantCustomAttributeDefinition) endpoint. This `BulkUpsertMerchantCustomAttributes` endpoint accepts a map of 1 to 25 individual upsert requests and returns a map of individual upsert responses. Each upsert request has a unique ID and provides a merchant ID and custom attribute. Each upsert response is returned with the ID of the corresponding request. To create or update a custom attribute owned by another application, the `visibility` setting must be `VISIBILITY_READ_WRITE_VALUES`.

Specified by:

bulkUpsertMerchantCustomAttributes in interface MerchantCustomAttributesApi

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

bulkUpsertMerchantCustomAttributesAsync

public CompletableFuture<BulkUpsertMerchantCustomAttributesResponse> bulkUpsertMerchantCustomAttributesAsync(BulkUpsertMerchantCustomAttributesRequest body)

Creates or updates [custom attributes]($m/CustomAttribute) for a merchant as a bulk operation. Use this endpoint to set the value of one or more custom attributes for a merchant. A custom attribute is based on a custom attribute definition in a Square seller account, which is created using the [CreateMerchantCustomAttributeDefinition]($e/MerchantCustomAttributes/CreateMerchantCustomAttributeDefinition) endpoint. This `BulkUpsertMerchantCustomAttributes` endpoint accepts a map of 1 to 25 individual upsert requests and returns a map of individual upsert responses. Each upsert request has a unique ID and provides a merchant ID and custom attribute. Each upsert response is returned with the ID of the corresponding request. To create or update a custom attribute owned by another application, the `visibility` setting must be `VISIBILITY_READ_WRITE_VALUES`.

Specified by:

bulkUpsertMerchantCustomAttributesAsync in interface MerchantCustomAttributesApi

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

listMerchantCustomAttributes

public ListMerchantCustomAttributesResponse listMerchantCustomAttributes(String merchantId,
                                                                         String visibilityFilter,
                                                                         Integer limit,
                                                                         String cursor,
                                                                         Boolean withDefinitions)
                                                                  throws ApiException,
                                                                         IOException

Lists the [custom attributes]($m/CustomAttribute) associated with a merchant. You can use the `with_definitions` query parameter to also retrieve custom attribute definitions in the same call. When all response pages are retrieved, the results include all custom attributes that are visible to the requesting application, including those that are owned by other applications and set to `VISIBILITY_READ_ONLY` or `VISIBILITY_READ_WRITE_VALUES`.

Specified by:

listMerchantCustomAttributes in interface MerchantCustomAttributesApi

Parameters:

merchantId - Required parameter: The ID of the target [merchant](entity:Merchant).

visibilityFilter - Optional parameter: Filters the `CustomAttributeDefinition` results by their `visibility` values.

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

listMerchantCustomAttributesAsync

public CompletableFuture<ListMerchantCustomAttributesResponse> listMerchantCustomAttributesAsync(String merchantId,
                                                                                                 String visibilityFilter,
                                                                                                 Integer limit,
                                                                                                 String cursor,
                                                                                                 Boolean withDefinitions)

Lists the [custom attributes]($m/CustomAttribute) associated with a merchant. You can use the `with_definitions` query parameter to also retrieve custom attribute definitions in the same call. When all response pages are retrieved, the results include all custom attributes that are visible to the requesting application, including those that are owned by other applications and set to `VISIBILITY_READ_ONLY` or `VISIBILITY_READ_WRITE_VALUES`.

Specified by:

listMerchantCustomAttributesAsync in interface MerchantCustomAttributesApi

Parameters:

merchantId - Required parameter: The ID of the target [merchant](entity:Merchant).

visibilityFilter - Optional parameter: Filters the `CustomAttributeDefinition` results by their `visibility` values.

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

deleteMerchantCustomAttribute

public DeleteMerchantCustomAttributeResponse deleteMerchantCustomAttribute(String merchantId,
                                                                           String key)
                                                                    throws ApiException,
                                                                           IOException

Deletes a [custom attribute]($m/CustomAttribute) associated with a merchant. To delete a custom attribute owned by another application, the `visibility` setting must be `VISIBILITY_READ_WRITE_VALUES`.

Specified by:

deleteMerchantCustomAttribute in interface MerchantCustomAttributesApi

Parameters:

merchantId - Required parameter: The ID of the target [merchant](entity:Merchant).

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

deleteMerchantCustomAttributeAsync

public CompletableFuture<DeleteMerchantCustomAttributeResponse> deleteMerchantCustomAttributeAsync(String merchantId,
                                                                                                   String key)

Deletes a [custom attribute]($m/CustomAttribute) associated with a merchant. To delete a custom attribute owned by another application, the `visibility` setting must be `VISIBILITY_READ_WRITE_VALUES`.

Specified by:

deleteMerchantCustomAttributeAsync in interface MerchantCustomAttributesApi

Parameters:

merchantId - Required parameter: The ID of the target [merchant](entity:Merchant).

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

retrieveMerchantCustomAttribute

public RetrieveMerchantCustomAttributeResponse retrieveMerchantCustomAttribute(String merchantId,
                                                                               String key,
                                                                               Boolean withDefinition,
                                                                               Integer version)
                                                                        throws ApiException,
                                                                               IOException

Retrieves a [custom attribute]($m/CustomAttribute) associated with a merchant. You can use the `with_definition` query parameter to also retrieve the custom attribute definition in the same call. To retrieve a custom attribute owned by another application, the `visibility` setting must be `VISIBILITY_READ_ONLY` or `VISIBILITY_READ_WRITE_VALUES`.

Specified by:

retrieveMerchantCustomAttribute in interface MerchantCustomAttributesApi

Parameters:

merchantId - Required parameter: The ID of the target [merchant](entity:Merchant).

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

retrieveMerchantCustomAttributeAsync

public CompletableFuture<RetrieveMerchantCustomAttributeResponse> retrieveMerchantCustomAttributeAsync(String merchantId,
                                                                                                       String key,
                                                                                                       Boolean withDefinition,
                                                                                                       Integer version)

Retrieves a [custom attribute]($m/CustomAttribute) associated with a merchant. You can use the `with_definition` query parameter to also retrieve the custom attribute definition in the same call. To retrieve a custom attribute owned by another application, the `visibility` setting must be `VISIBILITY_READ_ONLY` or `VISIBILITY_READ_WRITE_VALUES`.

Specified by:

retrieveMerchantCustomAttributeAsync in interface MerchantCustomAttributesApi

Parameters:

merchantId - Required parameter: The ID of the target [merchant](entity:Merchant).

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

upsertMerchantCustomAttribute

public UpsertMerchantCustomAttributeResponse upsertMerchantCustomAttribute(String merchantId,
                                                                           String key,
                                                                           UpsertMerchantCustomAttributeRequest body)
                                                                    throws ApiException,
                                                                           IOException

Creates or updates a [custom attribute]($m/CustomAttribute) for a merchant. Use this endpoint to set the value of a custom attribute for a specified merchant. A custom attribute is based on a custom attribute definition in a Square seller account, which is created using the [CreateMerchantCustomAttributeDefinition]($e/MerchantCustomAttributes/CreateMerchantCustomAttributeDefinition) endpoint. To create or update a custom attribute owned by another application, the `visibility` setting must be `VISIBILITY_READ_WRITE_VALUES`.

Specified by:

upsertMerchantCustomAttribute in interface MerchantCustomAttributesApi

Parameters:

merchantId - Required parameter: The ID of the target [merchant](entity:Merchant).

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

upsertMerchantCustomAttributeAsync

public CompletableFuture<UpsertMerchantCustomAttributeResponse> upsertMerchantCustomAttributeAsync(String merchantId,
                                                                                                   String key,
                                                                                                   UpsertMerchantCustomAttributeRequest body)

Creates or updates a [custom attribute]($m/CustomAttribute) for a merchant. Use this endpoint to set the value of a custom attribute for a specified merchant. A custom attribute is based on a custom attribute definition in a Square seller account, which is created using the [CreateMerchantCustomAttributeDefinition]($e/MerchantCustomAttributes/CreateMerchantCustomAttributeDefinition) endpoint. To create or update a custom attribute owned by another application, the `visibility` setting must be `VISIBILITY_READ_WRITE_VALUES`.

Specified by:

upsertMerchantCustomAttributeAsync in interface MerchantCustomAttributesApi

Parameters:

merchantId - Required parameter: The ID of the target [merchant](entity:Merchant).

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