chore: regenerate retail client (googleapis#26495)

Generated in GitHub action: https://togithub.com/googleapis/googleapis/google-api-java-client-services/actions/workflows/codegen.yaml

Author: yoshi-code-bot

clients/google-api-services-retail/v2/2.0.0/README.md

@@ -1,14 +1,14 @@
-# Vertex AI Search for Retail API Client Library for Java
+# Vertex AI Search for commerce API Client Library for Java
 
-Vertex AI Search for Retail API is made up of Retail Search, Browse and Recommendations. These discovery AI solutions help you implement personalized search, browse and recommendations, based on machine learning models, across your websites and mobile applications.
+Vertex AI Search for commerce API is made up of Retail Search, Browse and Recommendations. These discovery AI solutions help you implement personalized search, browse and recommendations, based on machine learning models, across your websites and mobile applications.
 
-This page contains information about getting started with the Vertex AI Search for Retail API
+This page contains information about getting started with the Vertex AI Search for commerce API
 using the Google API Client Library for Java. In addition, you may be interested
 in the following documentation:
 
-* Browse the [Javadoc reference for the Vertex AI Search for Retail API][javadoc]
+* Browse the [Javadoc reference for the Vertex AI Search for commerce API][javadoc]
 * Read the [Developer's Guide for the Google API Client Library for Java][google-api-client].
-* Interact with this API in your browser using the [APIs Explorer for the Vertex AI Search for Retail API][api-explorer]
+* Interact with this API in your browser using the [APIs Explorer for the Vertex AI Search for commerce API][api-explorer]
 
 ## Installation
 
@@ -22,7 +22,7 @@ Add the following lines to your `pom.xml` file:
     <dependency>
       <groupId>com.google.apis</groupId>
       <artifactId>google-api-services-retail</artifactId>
-      <version>v2-rev20250107-2.0.0</version>
+      <version>v2-rev20250320-2.0.0</version>
     </dependency>
   </dependencies>
 </project>
@@ -35,7 +35,7 @@ repositories {
   mavenCentral()
 }
 dependencies {
-  implementation 'com.google.apis:google-api-services-retail:v2-rev20250107-2.0.0'
+  implementation 'com.google.apis:google-api-services-retail:v2-rev20250320-2.0.0'
 }
 ```
 

clients/google-api-services-retail/v2/2.0.0/com/google/api/services/retail/v2/CloudRetail.java

@@ -20,7 +20,7 @@
  * Service definition for CloudRetail (v2).
  *
  * <p>
- * Vertex AI Search for Retail API is made up of Retail Search, Browse and Recommendations. These discovery AI solutions help you implement personalized search, browse and recommendations, based on machine learning models, across your websites and mobile applications.
+ * Vertex AI Search for commerce API is made up of Retail Search, Browse and Recommendations. These discovery AI solutions help you implement personalized search, browse and recommendations, based on machine learning models, across your websites and mobile applications.
  * </p>
  *
  * <p>
@@ -49,7 +49,7 @@ public class CloudRetail extends com.google.api.client.googleapis.services.json.
         com.google.api.client.googleapis.GoogleUtils.MAJOR_VERSION >= 2,
         "You are currently running with version %s of google-api-client. " +
         "You need at least version 1.31.1 of google-api-client to run version " +
-        "2.0.0 of the Vertex AI Search for Retail API library.", com.google.api.client.googleapis.GoogleUtils.VERSION);
+        "2.0.0 of the Vertex AI Search for commerce API library.", com.google.api.client.googleapis.GoogleUtils.VERSION);
   }
 
   /**
@@ -341,34 +341,34 @@ public CompleteQuery setCatalog(java.lang.String catalog) {
 
           /**
            * Determines which dataset to use for fetching completion. "user-data" will use the
-           * imported dataset through CompletionService.ImportCompletionData. "cloud-retail" will
-           * use the dataset generated by cloud retail based on user events. If leave empty, it will
-           * use the "user-data". Current supported values: * user-data * cloud-retail: This option
-           * requires enabling auto-learning function first. See
-           * [guidelines](https://cloud.google.com/retail/docs/completion-overview#generated-
+           * dataset imported through CompletionService.ImportCompletionData. `cloud-retail` will
+           * use the dataset generated by Cloud Retail based on user events. If left empty,
+           * completions will be fetched from the `user-data` dataset. Current supported values: *
+           * user-data * cloud-retail: This option requires enabling auto-learning function first.
+           * See [guidelines](https://cloud.google.com/retail/docs/completion-overview#generated-
            * completion-dataset).
            */
           @com.google.api.client.util.Key
           private java.lang.String dataset;
 
-          /** Determines which dataset to use for fetching completion. "user-data" will use the imported dataset
-         through CompletionService.ImportCompletionData. "cloud-retail" will use the dataset generated by
-         cloud retail based on user events. If leave empty, it will use the "user-data". Current supported
-         values: * user-data * cloud-retail: This option requires enabling auto-learning function first. See
-         [guidelines](https://cloud.google.com/retail/docs/completion-overview#generated-completion-
-         dataset).
+          /** Determines which dataset to use for fetching completion. "user-data" will use the dataset imported
+         through CompletionService.ImportCompletionData. `cloud-retail` will use the dataset generated by
+         Cloud Retail based on user events. If left empty, completions will be fetched from the `user-data`
+         dataset. Current supported values: * user-data * cloud-retail: This option requires enabling auto-
+         learning function first. See [guidelines](https://cloud.google.com/retail/docs/completion-
+         overview#generated-completion-dataset).
            */
           public java.lang.String getDataset() {
             return dataset;
           }
 
           /**
            * Determines which dataset to use for fetching completion. "user-data" will use the
-           * imported dataset through CompletionService.ImportCompletionData. "cloud-retail" will
-           * use the dataset generated by cloud retail based on user events. If leave empty, it will
-           * use the "user-data". Current supported values: * user-data * cloud-retail: This option
-           * requires enabling auto-learning function first. See
-           * [guidelines](https://cloud.google.com/retail/docs/completion-overview#generated-
+           * dataset imported through CompletionService.ImportCompletionData. `cloud-retail` will
+           * use the dataset generated by Cloud Retail based on user events. If left empty,
+           * completions will be fetched from the `user-data` dataset. Current supported values: *
+           * user-data * cloud-retail: This option requires enabling auto-learning function first.
+           * See [guidelines](https://cloud.google.com/retail/docs/completion-overview#generated-
            * completion-dataset).
            */
           public CompleteQuery setDataset(java.lang.String dataset) {
@@ -409,21 +409,21 @@ public CompleteQuery setDeviceType(java.lang.String deviceType) {
 
           /**
            * If true, attribute suggestions are enabled and provided in the response. This field is
-           * only available for the "cloud-retail" dataset.
+           * only available for the `cloud-retail` dataset.
            */
           @com.google.api.client.util.Key
           private java.lang.Boolean enableAttributeSuggestions;
 
           /** If true, attribute suggestions are enabled and provided in the response. This field is only
-         available for the "cloud-retail" dataset.
+         available for the `cloud-retail` dataset.
            */
           public java.lang.Boolean getEnableAttributeSuggestions() {
             return enableAttributeSuggestions;
           }
 
           /**
            * If true, attribute suggestions are enabled and provided in the response. This field is
-           * only available for the "cloud-retail" dataset.
+           * only available for the `cloud-retail` dataset.
            */
           public CompleteQuery setEnableAttributeSuggestions(java.lang.Boolean enableAttributeSuggestions) {
             this.enableAttributeSuggestions = enableAttributeSuggestions;
@@ -434,14 +434,22 @@ public CompleteQuery setEnableAttributeSuggestions(java.lang.Boolean enableAttri
            * The entity for customers who run multiple entities, domains, sites, or regions, for
            * example, `Google US`, `Google Ads`, `Waymo`, `google.com`, `youtube.com`, etc. If this
            * is set, it must be an exact match with UserEvent.entity to get per-entity autocomplete
-           * results.
+           * results. This field will be applied to `completion_results` only. It has no effect on
+           * the `attribute_results`. Also, this entity should be limited to 256 characters, if too
+           * long, it will be truncated to 256 characters in both generation and serving time, and
+           * may lead to mis-match. To ensure it works, please set the entity with string within 256
+           * characters.
            */
           @com.google.api.client.util.Key
           private java.lang.String entity;
 
           /** The entity for customers who run multiple entities, domains, sites, or regions, for example,
          `Google US`, `Google Ads`, `Waymo`, `google.com`, `youtube.com`, etc. If this is set, it must be an
-         exact match with UserEvent.entity to get per-entity autocomplete results.
+         exact match with UserEvent.entity to get per-entity autocomplete results. This field will be
+         applied to `completion_results` only. It has no effect on the `attribute_results`. Also, this
+         entity should be limited to 256 characters, if too long, it will be truncated to 256 characters in
+         both generation and serving time, and may lead to mis-match. To ensure it works, please set the
+         entity with string within 256 characters.
            */
           public java.lang.String getEntity() {
             return entity;
@@ -451,7 +459,11 @@ public java.lang.String getEntity() {
            * The entity for customers who run multiple entities, domains, sites, or regions, for
            * example, `Google US`, `Google Ads`, `Waymo`, `google.com`, `youtube.com`, etc. If this
            * is set, it must be an exact match with UserEvent.entity to get per-entity autocomplete
-           * results.
+           * results. This field will be applied to `completion_results` only. It has no effect on
+           * the `attribute_results`. Also, this entity should be limited to 256 characters, if too
+           * long, it will be truncated to 256 characters in both generation and serving time, and
+           * may lead to mis-match. To ensure it works, please set the entity with string within 256
+           * characters.
            */
           public CompleteQuery setEntity(java.lang.String entity) {
             this.entity = entity;
@@ -544,30 +556,30 @@ public CompleteQuery setQuery(java.lang.String query) {
           }
 
           /**
-           * Required field. A unique identifier for tracking visitors. For example, this could be
-           * implemented with an HTTP cookie, which should be able to uniquely identify a visitor on
-           * a single device. This unique identifier should not change if the visitor logs in or out
-           * of the website. The field must be a UTF-8 encoded string with a length limit of 128
+           * Recommended field. A unique identifier for tracking visitors. For example, this could
+           * be implemented with an HTTP cookie, which should be able to uniquely identify a visitor
+           * on a single device. This unique identifier should not change if the visitor logs in or
+           * out of the website. The field must be a UTF-8 encoded string with a length limit of 128
            * characters. Otherwise, an INVALID_ARGUMENT error is returned.
            */
           @com.google.api.client.util.Key
           private java.lang.String visitorId;
 
-          /** Required field. A unique identifier for tracking visitors. For example, this could be implemented
-         with an HTTP cookie, which should be able to uniquely identify a visitor on a single device. This
-         unique identifier should not change if the visitor logs in or out of the website. The field must be
-         a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error
-         is returned.
+          /** Recommended field. A unique identifier for tracking visitors. For example, this could be
+         implemented with an HTTP cookie, which should be able to uniquely identify a visitor on a single
+         device. This unique identifier should not change if the visitor logs in or out of the website. The
+         field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an
+         INVALID_ARGUMENT error is returned.
            */
           public java.lang.String getVisitorId() {
             return visitorId;
           }
 
           /**
-           * Required field. A unique identifier for tracking visitors. For example, this could be
-           * implemented with an HTTP cookie, which should be able to uniquely identify a visitor on
-           * a single device. This unique identifier should not change if the visitor logs in or out
-           * of the website. The field must be a UTF-8 encoded string with a length limit of 128
+           * Recommended field. A unique identifier for tracking visitors. For example, this could
+           * be implemented with an HTTP cookie, which should be able to uniquely identify a visitor
+           * on a single device. This unique identifier should not change if the visitor logs in or
+           * out of the website. The field must be a UTF-8 encoded string with a length limit of 128
            * characters. Otherwise, an INVALID_ARGUMENT error is returned.
            */
           public CompleteQuery setVisitorId(java.lang.String visitorId) {

clients/google-api-services-retail/v2/2.0.0/com/google/api/services/retail/v2/CloudRetailScopes.java

@@ -17,7 +17,7 @@
 package com.google.api.services.retail.v2;
 
 /**
- * Available OAuth 2.0 scopes for use with the Vertex AI Search for Retail API.
+ * Available OAuth 2.0 scopes for use with the Vertex AI Search for commerce API.
  *
  * @since 1.4
  */

clients/google-api-services-retail/v2/2.0.0/com/google/api/services/retail/v2/model/GoogleApiHttpBody.java

@@ -32,7 +32,7 @@
  * handled, all other features will continue to work unchanged.
  *
  * <p> This is the Java data model class that specifies how to parse/serialize into the JSON that is
- * transmitted over HTTP when working with the Vertex AI Search for Retail API. For a detailed
+ * transmitted over HTTP when working with the Vertex AI Search for commerce API. For a detailed
  * explanation see:
  * <a href="https://developers.google.com/api-client-library/java/google-http-java-client/json">https://developers.google.com/api-client-library/java/google-http-java-client/json</a>
  * </p>

clients/google-api-services-retail/v2/2.0.0/com/google/api/services/retail/v2/model/GoogleCloudRetailLoggingErrorContext.java

@@ -20,7 +20,7 @@
  * A description of the context in which an error occurred.
  *
  * <p> This is the Java data model class that specifies how to parse/serialize into the JSON that is
- * transmitted over HTTP when working with the Vertex AI Search for Retail API. For a detailed
+ * transmitted over HTTP when working with the Vertex AI Search for commerce API. For a detailed
  * explanation see:
  * <a href="https://developers.google.com/api-client-library/java/google-http-java-client/json">https://developers.google.com/api-client-library/java/google-http-java-client/json</a>
  * </p>

clients/google-api-services-retail/v2/2.0.0/com/google/api/services/retail/v2/model/GoogleCloudRetailLoggingErrorLog.java

@@ -21,7 +21,7 @@
  * google.devtools.clouderrorreporting.v1beta1.ReportedErrorEvent.
  *
  * <p> This is the Java data model class that specifies how to parse/serialize into the JSON that is
- * transmitted over HTTP when working with the Vertex AI Search for Retail API. For a detailed
+ * transmitted over HTTP when working with the Vertex AI Search for commerce API. For a detailed
  * explanation see:
  * <a href="https://developers.google.com/api-client-library/java/google-http-java-client/json">https://developers.google.com/api-client-library/java/google-http-java-client/json</a>
  * </p>

clients/google-api-services-retail/v2/2.0.0/com/google/api/services/retail/v2/model/GoogleCloudRetailLoggingHttpRequestContext.java

@@ -20,7 +20,7 @@
  * HTTP request data that is related to a reported error.
  *
  * <p> This is the Java data model class that specifies how to parse/serialize into the JSON that is
- * transmitted over HTTP when working with the Vertex AI Search for Retail API. For a detailed
+ * transmitted over HTTP when working with the Vertex AI Search for commerce API. For a detailed
  * explanation see:
  * <a href="https://developers.google.com/api-client-library/java/google-http-java-client/json">https://developers.google.com/api-client-library/java/google-http-java-client/json</a>
  * </p>

clients/google-api-services-retail/v2/2.0.0/com/google/api/services/retail/v2/model/GoogleCloudRetailLoggingImportErrorContext.java

@@ -22,7 +22,7 @@
  * "google.cloud.retail.v2.EventService.ImportUserEvents".
  *
  * <p> This is the Java data model class that specifies how to parse/serialize into the JSON that is
- * transmitted over HTTP when working with the Vertex AI Search for Retail API. For a detailed
+ * transmitted over HTTP when working with the Vertex AI Search for commerce API. For a detailed
  * explanation see:
  * <a href="https://developers.google.com/api-client-library/java/google-http-java-client/json">https://developers.google.com/api-client-library/java/google-http-java-client/json</a>
  * </p>

clients/google-api-services-retail/v2/2.0.0/com/google/api/services/retail/v2/model/GoogleCloudRetailLoggingServiceContext.java

@@ -20,7 +20,7 @@
  * Describes a running service that sends errors.
  *
  * <p> This is the Java data model class that specifies how to parse/serialize into the JSON that is
- * transmitted over HTTP when working with the Vertex AI Search for Retail API. For a detailed
+ * transmitted over HTTP when working with the Vertex AI Search for commerce API. For a detailed
  * explanation see:
  * <a href="https://developers.google.com/api-client-library/java/google-http-java-client/json">https://developers.google.com/api-client-library/java/google-http-java-client/json</a>
  * </p>

clients/google-api-services-retail/v2/2.0.0/com/google/api/services/retail/v2/model/GoogleCloudRetailLoggingSourceLocation.java

@@ -20,7 +20,7 @@
  * Indicates a location in the source code of the service for which errors are reported.
  *
  * <p> This is the Java data model class that specifies how to parse/serialize into the JSON that is
- * transmitted over HTTP when working with the Vertex AI Search for Retail API. For a detailed
+ * transmitted over HTTP when working with the Vertex AI Search for commerce API. For a detailed
  * explanation see:
  * <a href="https://developers.google.com/api-client-library/java/google-http-java-client/json">https://developers.google.com/api-client-library/java/google-http-java-client/json</a>
  * </p>