com.squareup.square.api

Class DefaultCustomerCustomAttributesApi

java.lang.Object

com.squareup.square.api.BaseApi

com.squareup.square.api.DefaultCustomerCustomAttributesApi

All Implemented Interfaces:

CustomerCustomAttributesApi

public final class DefaultCustomerCustomAttributesApi
extends BaseApi
implements CustomerCustomAttributesApi

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
DefaultCustomerCustomAttributesApi(Configuration config, HttpClient httpClient, Map<String,AuthManager> authManagers) Initializes the controller.
DefaultCustomerCustomAttributesApi(Configuration config, HttpClient httpClient, Map<String,AuthManager> authManagers, HttpCallback httpCallback) Initializes the controller with HTTPCallback.

Method Summary

Modifier and Type	Method and Description
BulkUpsertCustomerCustomAttributesResponse	bulkUpsertCustomerCustomAttributes(BulkUpsertCustomerCustomAttributesRequest body) Creates or updates custom attributes for customer profiles as a bulk operation.
CompletableFuture<BulkUpsertCustomerCustomAttributesResponse>	bulkUpsertCustomerCustomAttributesAsync(BulkUpsertCustomerCustomAttributesRequest body) Creates or updates custom attributes for customer profiles as a bulk operation.
CreateCustomerCustomAttributeDefinitionResponse	createCustomerCustomAttributeDefinition(CreateCustomerCustomAttributeDefinitionRequest body) Creates a customer-related custom attribute definition for a Square seller account.
CompletableFuture<CreateCustomerCustomAttributeDefinitionResponse>	createCustomerCustomAttributeDefinitionAsync(CreateCustomerCustomAttributeDefinitionRequest body) Creates a customer-related custom attribute definition for a Square seller account.
DeleteCustomerCustomAttributeResponse	deleteCustomerCustomAttribute(String customerId, String key) Deletes a custom attribute associated with a customer profile.
CompletableFuture<DeleteCustomerCustomAttributeResponse>	deleteCustomerCustomAttributeAsync(String customerId, String key) Deletes a custom attribute associated with a customer profile.
DeleteCustomerCustomAttributeDefinitionResponse	deleteCustomerCustomAttributeDefinition(String key) Deletes a customer-related custom attribute definition from a Square seller account.
CompletableFuture<DeleteCustomerCustomAttributeDefinitionResponse>	deleteCustomerCustomAttributeDefinitionAsync(String key) Deletes a customer-related custom attribute definition from a Square seller account.
ListCustomerCustomAttributeDefinitionsResponse	listCustomerCustomAttributeDefinitions(Integer limit, String cursor) Lists the customer-related custom attribute definitions that belong to a Square seller account.
CompletableFuture<ListCustomerCustomAttributeDefinitionsResponse>	listCustomerCustomAttributeDefinitionsAsync(Integer limit, String cursor) Lists the customer-related custom attribute definitions that belong to a Square seller account.
ListCustomerCustomAttributesResponse	listCustomerCustomAttributes(String customerId, Integer limit, String cursor, Boolean withDefinitions) Lists the custom attributes associated with a customer profile.
CompletableFuture<ListCustomerCustomAttributesResponse>	listCustomerCustomAttributesAsync(String customerId, Integer limit, String cursor, Boolean withDefinitions) Lists the custom attributes associated with a customer profile.
RetrieveCustomerCustomAttributeResponse	retrieveCustomerCustomAttribute(String customerId, String key, Boolean withDefinition, Integer version) Retrieves a custom attribute associated with a customer profile.
CompletableFuture<RetrieveCustomerCustomAttributeResponse>	retrieveCustomerCustomAttributeAsync(String customerId, String key, Boolean withDefinition, Integer version) Retrieves a custom attribute associated with a customer profile.
RetrieveCustomerCustomAttributeDefinitionResponse	retrieveCustomerCustomAttributeDefinition(String key, Integer version) Retrieves a customer-related custom attribute definition from a Square seller account.
CompletableFuture<RetrieveCustomerCustomAttributeDefinitionResponse>	retrieveCustomerCustomAttributeDefinitionAsync(String key, Integer version) Retrieves a customer-related custom attribute definition from a Square seller account.
UpdateCustomerCustomAttributeDefinitionResponse	updateCustomerCustomAttributeDefinition(String key, UpdateCustomerCustomAttributeDefinitionRequest body) Updates a customer-related custom attribute definition for a Square seller account.
CompletableFuture<UpdateCustomerCustomAttributeDefinitionResponse>	updateCustomerCustomAttributeDefinitionAsync(String key, UpdateCustomerCustomAttributeDefinitionRequest body) Updates a customer-related custom attribute definition for a Square seller account.
UpsertCustomerCustomAttributeResponse	upsertCustomerCustomAttribute(String customerId, String key, UpsertCustomerCustomAttributeRequest body) Creates or updates a custom attribute for a customer profile.
CompletableFuture<UpsertCustomerCustomAttributeResponse>	upsertCustomerCustomAttributeAsync(String customerId, String key, UpsertCustomerCustomAttributeRequest body) Creates or updates a custom attribute for a customer profile.

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

DefaultCustomerCustomAttributesApi

public DefaultCustomerCustomAttributesApi(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.

DefaultCustomerCustomAttributesApi

public DefaultCustomerCustomAttributesApi(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

listCustomerCustomAttributeDefinitions

public ListCustomerCustomAttributeDefinitionsResponse listCustomerCustomAttributeDefinitions(Integer limit,
                                                                                             String cursor)
                                                                                      throws ApiException,
                                                                                             IOException

Lists the customer-related custom attribute definitions 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:

listCustomerCustomAttributeDefinitions in interface CustomerCustomAttributesApi

Parameters:

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

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

Returns:

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

listCustomerCustomAttributeDefinitionsAsync

public CompletableFuture<ListCustomerCustomAttributeDefinitionsResponse> listCustomerCustomAttributeDefinitionsAsync(Integer limit,
                                                                                                                     String cursor)

Lists the customer-related custom attribute definitions 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:

listCustomerCustomAttributeDefinitionsAsync in interface CustomerCustomAttributesApi

Parameters:

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

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

Returns:

Returns the ListCustomerCustomAttributeDefinitionsResponse response from the API call

createCustomerCustomAttributeDefinition

public CreateCustomerCustomAttributeDefinitionResponse createCustomerCustomAttributeDefinition(CreateCustomerCustomAttributeDefinitionRequest body)
                                                                                        throws ApiException,
                                                                                               IOException

Creates a customer-related custom attribute definition for a Square seller account. Use this endpoint to define a custom attribute that can be associated with customer profiles. A custom attribute definition specifies the `key`, `visibility`, `schema`, and other properties for a custom attribute. After the definition is created, you can call [UpsertCustomerCustomAttribute]($e/CustomerCustomAttributes/UpsertCustomerCustomAttribute) or [BulkUpsertCustomerCustomAttributes]($e/CustomerCustomAttributes/BulkUpsertCustomerCustomAttributes) to set the custom attribute for customer profiles in the seller's Customer Directory. Sellers can view all custom attributes in exported customer data, including those set to `VISIBILITY_HIDDEN`.

Specified by:

createCustomerCustomAttributeDefinition in interface CustomerCustomAttributesApi

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

createCustomerCustomAttributeDefinitionAsync

public CompletableFuture<CreateCustomerCustomAttributeDefinitionResponse> createCustomerCustomAttributeDefinitionAsync(CreateCustomerCustomAttributeDefinitionRequest body)

Creates a customer-related custom attribute definition for a Square seller account. Use this endpoint to define a custom attribute that can be associated with customer profiles. A custom attribute definition specifies the `key`, `visibility`, `schema`, and other properties for a custom attribute. After the definition is created, you can call [UpsertCustomerCustomAttribute]($e/CustomerCustomAttributes/UpsertCustomerCustomAttribute) or [BulkUpsertCustomerCustomAttributes]($e/CustomerCustomAttributes/BulkUpsertCustomerCustomAttributes) to set the custom attribute for customer profiles in the seller's Customer Directory. Sellers can view all custom attributes in exported customer data, including those set to `VISIBILITY_HIDDEN`.

Specified by:

createCustomerCustomAttributeDefinitionAsync in interface CustomerCustomAttributesApi

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

deleteCustomerCustomAttributeDefinition

public DeleteCustomerCustomAttributeDefinitionResponse deleteCustomerCustomAttributeDefinition(String key)
                                                                                        throws ApiException,
                                                                                               IOException

Deletes a customer-related custom attribute definition from a Square seller account. Deleting a custom attribute definition also deletes the corresponding custom attribute from all customer profiles in the seller's Customer Directory. Only the definition owner can delete a custom attribute definition.

Specified by:

deleteCustomerCustomAttributeDefinition in interface CustomerCustomAttributesApi

Parameters:

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

Returns:

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

deleteCustomerCustomAttributeDefinitionAsync

public CompletableFuture<DeleteCustomerCustomAttributeDefinitionResponse> deleteCustomerCustomAttributeDefinitionAsync(String key)

Deletes a customer-related custom attribute definition from a Square seller account. Deleting a custom attribute definition also deletes the corresponding custom attribute from all customer profiles in the seller's Customer Directory. Only the definition owner can delete a custom attribute definition.

Specified by:

deleteCustomerCustomAttributeDefinitionAsync in interface CustomerCustomAttributesApi

Parameters:

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

Returns:

Returns the DeleteCustomerCustomAttributeDefinitionResponse response from the API call

retrieveCustomerCustomAttributeDefinition

public RetrieveCustomerCustomAttributeDefinitionResponse retrieveCustomerCustomAttributeDefinition(String key,
                                                                                                   Integer version)
                                                                                            throws ApiException,
                                                                                                   IOException

Retrieves a customer-related custom attribute definition 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:

retrieveCustomerCustomAttributeDefinition in interface CustomerCustomAttributesApi

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

retrieveCustomerCustomAttributeDefinitionAsync

public CompletableFuture<RetrieveCustomerCustomAttributeDefinitionResponse> retrieveCustomerCustomAttributeDefinitionAsync(String key,
                                                                                                                           Integer version)

Retrieves a customer-related custom attribute definition 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:

retrieveCustomerCustomAttributeDefinitionAsync in interface CustomerCustomAttributesApi

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

updateCustomerCustomAttributeDefinition

public UpdateCustomerCustomAttributeDefinitionResponse updateCustomerCustomAttributeDefinition(String key,
                                                                                               UpdateCustomerCustomAttributeDefinitionRequest body)
                                                                                        throws ApiException,
                                                                                               IOException

Updates a customer-related custom attribute definition 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. Note that sellers can view all custom attributes in exported customer data, including those set to `VISIBILITY_HIDDEN`.

Specified by:

updateCustomerCustomAttributeDefinition in interface CustomerCustomAttributesApi

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

updateCustomerCustomAttributeDefinitionAsync

public CompletableFuture<UpdateCustomerCustomAttributeDefinitionResponse> updateCustomerCustomAttributeDefinitionAsync(String key,
                                                                                                                       UpdateCustomerCustomAttributeDefinitionRequest body)

Updates a customer-related custom attribute definition 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. Note that sellers can view all custom attributes in exported customer data, including those set to `VISIBILITY_HIDDEN`.

Specified by:

updateCustomerCustomAttributeDefinitionAsync in interface CustomerCustomAttributesApi

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

bulkUpsertCustomerCustomAttributes

public BulkUpsertCustomerCustomAttributesResponse bulkUpsertCustomerCustomAttributes(BulkUpsertCustomerCustomAttributesRequest body)
                                                                              throws ApiException,
                                                                                     IOException

Creates or updates custom attributes for customer profiles as a bulk operation. Use this endpoint to set the value of one or more custom attributes for one or more customer profiles. A custom attribute is based on a custom attribute definition in a Square seller account, which is created using the [CreateCustomerCustomAttributeDefinition]($e/CustomerCustomAttributes/CreateCustomerCustomAttributeDefinition) endpoint. This `BulkUpsertCustomerCustomAttributes` 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 customer 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:

bulkUpsertCustomerCustomAttributes in interface CustomerCustomAttributesApi

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

bulkUpsertCustomerCustomAttributesAsync

public CompletableFuture<BulkUpsertCustomerCustomAttributesResponse> bulkUpsertCustomerCustomAttributesAsync(BulkUpsertCustomerCustomAttributesRequest body)

Creates or updates custom attributes for customer profiles as a bulk operation. Use this endpoint to set the value of one or more custom attributes for one or more customer profiles. A custom attribute is based on a custom attribute definition in a Square seller account, which is created using the [CreateCustomerCustomAttributeDefinition]($e/CustomerCustomAttributes/CreateCustomerCustomAttributeDefinition) endpoint. This `BulkUpsertCustomerCustomAttributes` 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 customer 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:

bulkUpsertCustomerCustomAttributesAsync in interface CustomerCustomAttributesApi

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

listCustomerCustomAttributes

public ListCustomerCustomAttributesResponse listCustomerCustomAttributes(String customerId,
                                                                         Integer limit,
                                                                         String cursor,
                                                                         Boolean withDefinitions)
                                                                  throws ApiException,
                                                                         IOException

Lists the custom attributes associated with a customer profile. 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:

listCustomerCustomAttributes in interface CustomerCustomAttributesApi

Parameters:

customerId - Required parameter: The ID of the target [customer profile]($m/Customer).

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]($m/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 ListCustomerCustomAttributesResponse 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.

listCustomerCustomAttributesAsync

public CompletableFuture<ListCustomerCustomAttributesResponse> listCustomerCustomAttributesAsync(String customerId,
                                                                                                 Integer limit,
                                                                                                 String cursor,
                                                                                                 Boolean withDefinitions)

Lists the custom attributes associated with a customer profile. 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:

listCustomerCustomAttributesAsync in interface CustomerCustomAttributesApi

Parameters:

customerId - Required parameter: The ID of the target [customer profile]($m/Customer).

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]($m/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 ListCustomerCustomAttributesResponse response from the API call

deleteCustomerCustomAttribute

public DeleteCustomerCustomAttributeResponse deleteCustomerCustomAttribute(String customerId,
                                                                           String key)
                                                                    throws ApiException,
                                                                           IOException

Deletes a custom attribute associated with a customer profile. To delete a custom attribute owned by another application, the `visibility` setting must be `VISIBILITY_READ_WRITE_VALUES`.

Specified by:

deleteCustomerCustomAttribute in interface CustomerCustomAttributesApi

Parameters:

customerId - Required parameter: The ID of the target [customer profile]($m/Customer).

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

deleteCustomerCustomAttributeAsync

public CompletableFuture<DeleteCustomerCustomAttributeResponse> deleteCustomerCustomAttributeAsync(String customerId,
                                                                                                   String key)

Deletes a custom attribute associated with a customer profile. To delete a custom attribute owned by another application, the `visibility` setting must be `VISIBILITY_READ_WRITE_VALUES`.

Specified by:

deleteCustomerCustomAttributeAsync in interface CustomerCustomAttributesApi

Parameters:

customerId - Required parameter: The ID of the target [customer profile]($m/Customer).

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

retrieveCustomerCustomAttribute

public RetrieveCustomerCustomAttributeResponse retrieveCustomerCustomAttribute(String customerId,
                                                                               String key,
                                                                               Boolean withDefinition,
                                                                               Integer version)
                                                                        throws ApiException,
                                                                               IOException

Retrieves a custom attribute associated with a customer profile. 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:

retrieveCustomerCustomAttribute in interface CustomerCustomAttributesApi

Parameters:

customerId - Required parameter: The ID of the target [customer profile]($m/Customer).

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]($m/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 RetrieveCustomerCustomAttributeResponse 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.

retrieveCustomerCustomAttributeAsync

public CompletableFuture<RetrieveCustomerCustomAttributeResponse> retrieveCustomerCustomAttributeAsync(String customerId,
                                                                                                       String key,
                                                                                                       Boolean withDefinition,
                                                                                                       Integer version)

Retrieves a custom attribute associated with a customer profile. 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:

retrieveCustomerCustomAttributeAsync in interface CustomerCustomAttributesApi

Parameters:

customerId - Required parameter: The ID of the target [customer profile]($m/Customer).

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]($m/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 RetrieveCustomerCustomAttributeResponse response from the API call

upsertCustomerCustomAttribute

public UpsertCustomerCustomAttributeResponse upsertCustomerCustomAttribute(String customerId,
                                                                           String key,
                                                                           UpsertCustomerCustomAttributeRequest body)
                                                                    throws ApiException,
                                                                           IOException

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

Specified by:

upsertCustomerCustomAttribute in interface CustomerCustomAttributesApi

Parameters:

customerId - Required parameter: The ID of the target [customer profile]($m/Customer).

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

upsertCustomerCustomAttributeAsync

public CompletableFuture<UpsertCustomerCustomAttributeResponse> upsertCustomerCustomAttributeAsync(String customerId,
                                                                                                   String key,
                                                                                                   UpsertCustomerCustomAttributeRequest body)

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

Specified by:

upsertCustomerCustomAttributeAsync in interface CustomerCustomAttributesApi

Parameters:

customerId - Required parameter: The ID of the target [customer profile]($m/Customer).

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