Class PersonalizationClient

java.lang.Object
com.algolia.ApiClient
com.algolia.api.PersonalizationClient
All Implemented Interfaces:
Closeable, AutoCloseable

public class PersonalizationClient extends ApiClient
  • Constructor Details

  • Method Details

    • del

      public Object del(@Nonnull String path, Map<String,Object> parameters, RequestOptions requestOptions) throws AlgoliaRuntimeException
      This method allow you to send requests to the Algolia REST API.
      Parameters:
      path - Path of the endpoint, anything after \"/1\" must be specified. (required)
      parameters - Query parameters to apply to the current query. (optional)
      requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • del

      public Object del(@Nonnull String path, Map<String,Object> parameters) throws AlgoliaRuntimeException
      This method allow you to send requests to the Algolia REST API.
      Parameters:
      path - Path of the endpoint, anything after \"/1\" must be specified. (required)
      parameters - Query parameters to apply to the current query. (optional)
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • del

      public Object del(@Nonnull String path, RequestOptions requestOptions) throws AlgoliaRuntimeException
      This method allow you to send requests to the Algolia REST API.
      Parameters:
      path - Path of the endpoint, anything after \"/1\" must be specified. (required)
      requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • del

      public Object del(@Nonnull String path) throws AlgoliaRuntimeException
      This method allow you to send requests to the Algolia REST API.
      Parameters:
      path - Path of the endpoint, anything after \"/1\" must be specified. (required)
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • delAsync

      public CompletableFuture<Object> delAsync(@Nonnull String path, Map<String,Object> parameters, RequestOptions requestOptions) throws AlgoliaRuntimeException
      (asynchronously) This method allow you to send requests to the Algolia REST API.
      Parameters:
      path - Path of the endpoint, anything after \"/1\" must be specified. (required)
      parameters - Query parameters to apply to the current query. (optional)
      requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • delAsync

      public CompletableFuture<Object> delAsync(@Nonnull String path, Map<String,Object> parameters) throws AlgoliaRuntimeException
      (asynchronously) This method allow you to send requests to the Algolia REST API.
      Parameters:
      path - Path of the endpoint, anything after \"/1\" must be specified. (required)
      parameters - Query parameters to apply to the current query. (optional)
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • delAsync

      public CompletableFuture<Object> delAsync(@Nonnull String path, RequestOptions requestOptions) throws AlgoliaRuntimeException
      (asynchronously) This method allow you to send requests to the Algolia REST API.
      Parameters:
      path - Path of the endpoint, anything after \"/1\" must be specified. (required)
      requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • delAsync

      public CompletableFuture<Object> delAsync(@Nonnull String path) throws AlgoliaRuntimeException
      (asynchronously) This method allow you to send requests to the Algolia REST API.
      Parameters:
      path - Path of the endpoint, anything after \"/1\" must be specified. (required)
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • deleteUserProfile

      public DeleteUserProfileResponse deleteUserProfile(@Nonnull String userToken, RequestOptions requestOptions) throws AlgoliaRuntimeException
      Delete the user profile and all its associated data. Returns, as part of the response, a date until which the data can safely be considered as deleted for the given user. This means if you send events for the given user before this date, they will be ignored. Any data received after the deletedUntil date will start building a new user profile. It might take a couple hours for the deletion request to be fully processed.
      Parameters:
      userToken - userToken representing the user for which to fetch the Personalization profile. (required)
      requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • deleteUserProfile

      public DeleteUserProfileResponse deleteUserProfile(@Nonnull String userToken) throws AlgoliaRuntimeException
      Delete the user profile and all its associated data. Returns, as part of the response, a date until which the data can safely be considered as deleted for the given user. This means if you send events for the given user before this date, they will be ignored. Any data received after the deletedUntil date will start building a new user profile. It might take a couple hours for the deletion request to be fully processed.
      Parameters:
      userToken - userToken representing the user for which to fetch the Personalization profile. (required)
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • deleteUserProfileAsync

      public CompletableFuture<DeleteUserProfileResponse> deleteUserProfileAsync(@Nonnull String userToken, RequestOptions requestOptions) throws AlgoliaRuntimeException
      (asynchronously) Delete the user profile and all its associated data. Returns, as part of the response, a date until which the data can safely be considered as deleted for the given user. This means if you send events for the given user before this date, they will be ignored. Any data received after the deletedUntil date will start building a new user profile. It might take a couple hours for the deletion request to be fully processed.
      Parameters:
      userToken - userToken representing the user for which to fetch the Personalization profile. (required)
      requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • deleteUserProfileAsync

      public CompletableFuture<DeleteUserProfileResponse> deleteUserProfileAsync(@Nonnull String userToken) throws AlgoliaRuntimeException
      (asynchronously) Delete the user profile and all its associated data. Returns, as part of the response, a date until which the data can safely be considered as deleted for the given user. This means if you send events for the given user before this date, they will be ignored. Any data received after the deletedUntil date will start building a new user profile. It might take a couple hours for the deletion request to be fully processed.
      Parameters:
      userToken - userToken representing the user for which to fetch the Personalization profile. (required)
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • get

      public Object get(@Nonnull String path, Map<String,Object> parameters, RequestOptions requestOptions) throws AlgoliaRuntimeException
      This method allow you to send requests to the Algolia REST API.
      Parameters:
      path - Path of the endpoint, anything after \"/1\" must be specified. (required)
      parameters - Query parameters to apply to the current query. (optional)
      requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • get

      public Object get(@Nonnull String path, Map<String,Object> parameters) throws AlgoliaRuntimeException
      This method allow you to send requests to the Algolia REST API.
      Parameters:
      path - Path of the endpoint, anything after \"/1\" must be specified. (required)
      parameters - Query parameters to apply to the current query. (optional)
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • get

      public Object get(@Nonnull String path, RequestOptions requestOptions) throws AlgoliaRuntimeException
      This method allow you to send requests to the Algolia REST API.
      Parameters:
      path - Path of the endpoint, anything after \"/1\" must be specified. (required)
      requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • get

      public Object get(@Nonnull String path) throws AlgoliaRuntimeException
      This method allow you to send requests to the Algolia REST API.
      Parameters:
      path - Path of the endpoint, anything after \"/1\" must be specified. (required)
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • getAsync

      public CompletableFuture<Object> getAsync(@Nonnull String path, Map<String,Object> parameters, RequestOptions requestOptions) throws AlgoliaRuntimeException
      (asynchronously) This method allow you to send requests to the Algolia REST API.
      Parameters:
      path - Path of the endpoint, anything after \"/1\" must be specified. (required)
      parameters - Query parameters to apply to the current query. (optional)
      requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • getAsync

      public CompletableFuture<Object> getAsync(@Nonnull String path, Map<String,Object> parameters) throws AlgoliaRuntimeException
      (asynchronously) This method allow you to send requests to the Algolia REST API.
      Parameters:
      path - Path of the endpoint, anything after \"/1\" must be specified. (required)
      parameters - Query parameters to apply to the current query. (optional)
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • getAsync

      public CompletableFuture<Object> getAsync(@Nonnull String path, RequestOptions requestOptions) throws AlgoliaRuntimeException
      (asynchronously) This method allow you to send requests to the Algolia REST API.
      Parameters:
      path - Path of the endpoint, anything after \"/1\" must be specified. (required)
      requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • getAsync

      public CompletableFuture<Object> getAsync(@Nonnull String path) throws AlgoliaRuntimeException
      (asynchronously) This method allow you to send requests to the Algolia REST API.
      Parameters:
      path - Path of the endpoint, anything after \"/1\" must be specified. (required)
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • getPersonalizationStrategy

      public PersonalizationStrategyParams getPersonalizationStrategy(RequestOptions requestOptions) throws AlgoliaRuntimeException
      The strategy contains information on the events and facets that impact user profiles and personalized search results.
      Parameters:
      requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • getPersonalizationStrategy

      public PersonalizationStrategyParams getPersonalizationStrategy() throws AlgoliaRuntimeException
      The strategy contains information on the events and facets that impact user profiles and personalized search results.
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • getPersonalizationStrategyAsync

      public CompletableFuture<PersonalizationStrategyParams> getPersonalizationStrategyAsync(RequestOptions requestOptions) throws AlgoliaRuntimeException
      (asynchronously) The strategy contains information on the events and facets that impact user profiles and personalized search results.
      Parameters:
      requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • getPersonalizationStrategyAsync

      public CompletableFuture<PersonalizationStrategyParams> getPersonalizationStrategyAsync() throws AlgoliaRuntimeException
      (asynchronously) The strategy contains information on the events and facets that impact user profiles and personalized search results.
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • getUserTokenProfile

      public GetUserTokenResponse getUserTokenProfile(@Nonnull String userToken, RequestOptions requestOptions) throws AlgoliaRuntimeException
      Get the user profile built from Personalization strategy. The profile is structured by facet name used in the strategy. Each facet value is mapped to its score. Each score represents the user affinity for a specific facet value given the userToken past events and the Personalization strategy defined. Scores are bounded to 20. The last processed event timestamp is provided using the ISO 8601 format for debugging purposes.
      Parameters:
      userToken - userToken representing the user for which to fetch the Personalization profile. (required)
      requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • getUserTokenProfile

      public GetUserTokenResponse getUserTokenProfile(@Nonnull String userToken) throws AlgoliaRuntimeException
      Get the user profile built from Personalization strategy. The profile is structured by facet name used in the strategy. Each facet value is mapped to its score. Each score represents the user affinity for a specific facet value given the userToken past events and the Personalization strategy defined. Scores are bounded to 20. The last processed event timestamp is provided using the ISO 8601 format for debugging purposes.
      Parameters:
      userToken - userToken representing the user for which to fetch the Personalization profile. (required)
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • getUserTokenProfileAsync

      public CompletableFuture<GetUserTokenResponse> getUserTokenProfileAsync(@Nonnull String userToken, RequestOptions requestOptions) throws AlgoliaRuntimeException
      (asynchronously) Get the user profile built from Personalization strategy. The profile is structured by facet name used in the strategy. Each facet value is mapped to its score. Each score represents the user affinity for a specific facet value given the userToken past events and the Personalization strategy defined. Scores are bounded to 20. The last processed event timestamp is provided using the ISO 8601 format for debugging purposes.
      Parameters:
      userToken - userToken representing the user for which to fetch the Personalization profile. (required)
      requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • getUserTokenProfileAsync

      public CompletableFuture<GetUserTokenResponse> getUserTokenProfileAsync(@Nonnull String userToken) throws AlgoliaRuntimeException
      (asynchronously) Get the user profile built from Personalization strategy. The profile is structured by facet name used in the strategy. Each facet value is mapped to its score. Each score represents the user affinity for a specific facet value given the userToken past events and the Personalization strategy defined. Scores are bounded to 20. The last processed event timestamp is provided using the ISO 8601 format for debugging purposes.
      Parameters:
      userToken - userToken representing the user for which to fetch the Personalization profile. (required)
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • post

      public Object post(@Nonnull String path, Map<String,Object> parameters, Object body, RequestOptions requestOptions) throws AlgoliaRuntimeException
      This method allow you to send requests to the Algolia REST API.
      Parameters:
      path - Path of the endpoint, anything after \"/1\" must be specified. (required)
      parameters - Query parameters to apply to the current query. (optional)
      body - Parameters to send with the custom request. (optional)
      requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • post

      public Object post(@Nonnull String path, Map<String,Object> parameters, Object body) throws AlgoliaRuntimeException
      This method allow you to send requests to the Algolia REST API.
      Parameters:
      path - Path of the endpoint, anything after \"/1\" must be specified. (required)
      parameters - Query parameters to apply to the current query. (optional)
      body - Parameters to send with the custom request. (optional)
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • post

      public Object post(@Nonnull String path, RequestOptions requestOptions) throws AlgoliaRuntimeException
      This method allow you to send requests to the Algolia REST API.
      Parameters:
      path - Path of the endpoint, anything after \"/1\" must be specified. (required)
      requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • post

      public Object post(@Nonnull String path) throws AlgoliaRuntimeException
      This method allow you to send requests to the Algolia REST API.
      Parameters:
      path - Path of the endpoint, anything after \"/1\" must be specified. (required)
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • postAsync

      public CompletableFuture<Object> postAsync(@Nonnull String path, Map<String,Object> parameters, Object body, RequestOptions requestOptions) throws AlgoliaRuntimeException
      (asynchronously) This method allow you to send requests to the Algolia REST API.
      Parameters:
      path - Path of the endpoint, anything after \"/1\" must be specified. (required)
      parameters - Query parameters to apply to the current query. (optional)
      body - Parameters to send with the custom request. (optional)
      requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • postAsync

      public CompletableFuture<Object> postAsync(@Nonnull String path, Map<String,Object> parameters, Object body) throws AlgoliaRuntimeException
      (asynchronously) This method allow you to send requests to the Algolia REST API.
      Parameters:
      path - Path of the endpoint, anything after \"/1\" must be specified. (required)
      parameters - Query parameters to apply to the current query. (optional)
      body - Parameters to send with the custom request. (optional)
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • postAsync

      public CompletableFuture<Object> postAsync(@Nonnull String path, RequestOptions requestOptions) throws AlgoliaRuntimeException
      (asynchronously) This method allow you to send requests to the Algolia REST API.
      Parameters:
      path - Path of the endpoint, anything after \"/1\" must be specified. (required)
      requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • postAsync

      public CompletableFuture<Object> postAsync(@Nonnull String path) throws AlgoliaRuntimeException
      (asynchronously) This method allow you to send requests to the Algolia REST API.
      Parameters:
      path - Path of the endpoint, anything after \"/1\" must be specified. (required)
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • put

      public Object put(@Nonnull String path, Map<String,Object> parameters, Object body, RequestOptions requestOptions) throws AlgoliaRuntimeException
      This method allow you to send requests to the Algolia REST API.
      Parameters:
      path - Path of the endpoint, anything after \"/1\" must be specified. (required)
      parameters - Query parameters to apply to the current query. (optional)
      body - Parameters to send with the custom request. (optional)
      requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • put

      public Object put(@Nonnull String path, Map<String,Object> parameters, Object body) throws AlgoliaRuntimeException
      This method allow you to send requests to the Algolia REST API.
      Parameters:
      path - Path of the endpoint, anything after \"/1\" must be specified. (required)
      parameters - Query parameters to apply to the current query. (optional)
      body - Parameters to send with the custom request. (optional)
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • put

      public Object put(@Nonnull String path, RequestOptions requestOptions) throws AlgoliaRuntimeException
      This method allow you to send requests to the Algolia REST API.
      Parameters:
      path - Path of the endpoint, anything after \"/1\" must be specified. (required)
      requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • put

      public Object put(@Nonnull String path) throws AlgoliaRuntimeException
      This method allow you to send requests to the Algolia REST API.
      Parameters:
      path - Path of the endpoint, anything after \"/1\" must be specified. (required)
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • putAsync

      public CompletableFuture<Object> putAsync(@Nonnull String path, Map<String,Object> parameters, Object body, RequestOptions requestOptions) throws AlgoliaRuntimeException
      (asynchronously) This method allow you to send requests to the Algolia REST API.
      Parameters:
      path - Path of the endpoint, anything after \"/1\" must be specified. (required)
      parameters - Query parameters to apply to the current query. (optional)
      body - Parameters to send with the custom request. (optional)
      requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • putAsync

      public CompletableFuture<Object> putAsync(@Nonnull String path, Map<String,Object> parameters, Object body) throws AlgoliaRuntimeException
      (asynchronously) This method allow you to send requests to the Algolia REST API.
      Parameters:
      path - Path of the endpoint, anything after \"/1\" must be specified. (required)
      parameters - Query parameters to apply to the current query. (optional)
      body - Parameters to send with the custom request. (optional)
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • putAsync

      public CompletableFuture<Object> putAsync(@Nonnull String path, RequestOptions requestOptions) throws AlgoliaRuntimeException
      (asynchronously) This method allow you to send requests to the Algolia REST API.
      Parameters:
      path - Path of the endpoint, anything after \"/1\" must be specified. (required)
      requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • putAsync

      public CompletableFuture<Object> putAsync(@Nonnull String path) throws AlgoliaRuntimeException
      (asynchronously) This method allow you to send requests to the Algolia REST API.
      Parameters:
      path - Path of the endpoint, anything after \"/1\" must be specified. (required)
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • setPersonalizationStrategy

      public SetPersonalizationStrategyResponse setPersonalizationStrategy(@Nonnull PersonalizationStrategyParams personalizationStrategyParams, RequestOptions requestOptions) throws AlgoliaRuntimeException
      A strategy defines the events and facets that impact user profiles and personalized search results.
      Parameters:
      personalizationStrategyParams - (required)
      requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • setPersonalizationStrategy

      public SetPersonalizationStrategyResponse setPersonalizationStrategy(@Nonnull PersonalizationStrategyParams personalizationStrategyParams) throws AlgoliaRuntimeException
      A strategy defines the events and facets that impact user profiles and personalized search results.
      Parameters:
      personalizationStrategyParams - (required)
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • setPersonalizationStrategyAsync

      public CompletableFuture<SetPersonalizationStrategyResponse> setPersonalizationStrategyAsync(@Nonnull PersonalizationStrategyParams personalizationStrategyParams, RequestOptions requestOptions) throws AlgoliaRuntimeException
      (asynchronously) A strategy defines the events and facets that impact user profiles and personalized search results.
      Parameters:
      personalizationStrategyParams - (required)
      requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call
    • setPersonalizationStrategyAsync

      public CompletableFuture<SetPersonalizationStrategyResponse> setPersonalizationStrategyAsync(@Nonnull PersonalizationStrategyParams personalizationStrategyParams) throws AlgoliaRuntimeException
      (asynchronously) A strategy defines the events and facets that impact user profiles and personalized search results.
      Parameters:
      personalizationStrategyParams - (required)
      Throws:
      AlgoliaRuntimeException - If it fails to process the API call