chore: regenerate retail client (googleapis#22497)

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/v2alpha/2.0.0/README.md

@@ -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>v2alpha-rev20240702-2.0.0</version>
+      <version>v2alpha-rev20240711-2.0.0</version>
     </dependency>
   </dependencies>
 </project>
@@ -35,7 +35,7 @@ repositories {
   mavenCentral()
 }
 dependencies {
-  implementation 'com.google.apis:google-api-services-retail:v2alpha-rev20240702-2.0.0'
+  implementation 'com.google.apis:google-api-services-retail:v2alpha-rev20240711-2.0.0'
 }
 ```
 

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

@@ -11766,6 +11766,147 @@ public Collect set(String parameterName, Object value) {
               return (Collect) super.set(parameterName, value);
             }
           }
+          /**
+           * Exports user events. `Operation.response` is of type `ExportResponse`. `Operation.metadata` is of
+           * type `ExportMetadata`.
+           *
+           * Create a request for the method "userEvents.export".
+           *
+           * This request holds the parameters needed by the retail server.  After setting any optional
+           * parameters, call the {@link Export#execute()} method to invoke the remote operation.
+           *
+           * @param parent Required. Resource name of a Catalog. For example
+           *        `projects/1234/locations/global/catalogs/default_catalog`
+           * @param content the {@link com.google.api.services.retail.v2alpha.model.GoogleCloudRetailV2alphaExportUserEventsRequest}
+           * @return the request
+           */
+          public Export export(java.lang.String parent, com.google.api.services.retail.v2alpha.model.GoogleCloudRetailV2alphaExportUserEventsRequest content) throws java.io.IOException {
+            Export result = new Export(parent, content);
+            initialize(result);
+            return result;
+          }
+
+          public class Export extends CloudRetailRequest<com.google.api.services.retail.v2alpha.model.GoogleLongrunningOperation> {
+
+            private static final String REST_PATH = "v2alpha/{+parent}/userEvents:export";
+
+            private final java.util.regex.Pattern PARENT_PATTERN =
+                java.util.regex.Pattern.compile("^projects/[^/]+/locations/[^/]+/catalogs/[^/]+$");
+
+            /**
+             * Exports user events. `Operation.response` is of type `ExportResponse`. `Operation.metadata` is
+             * of type `ExportMetadata`.
+             *
+             * Create a request for the method "userEvents.export".
+             *
+             * This request holds the parameters needed by the the retail server.  After setting any optional
+             * parameters, call the {@link Export#execute()} method to invoke the remote operation. <p> {@link
+             * Export#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
+             * be called to initialize this instance immediately after invoking the constructor. </p>
+             *
+             * @param parent Required. Resource name of a Catalog. For example
+           *        `projects/1234/locations/global/catalogs/default_catalog`
+             * @param content the {@link com.google.api.services.retail.v2alpha.model.GoogleCloudRetailV2alphaExportUserEventsRequest}
+             * @since 1.13
+             */
+            protected Export(java.lang.String parent, com.google.api.services.retail.v2alpha.model.GoogleCloudRetailV2alphaExportUserEventsRequest content) {
+              super(CloudRetail.this, "POST", REST_PATH, content, com.google.api.services.retail.v2alpha.model.GoogleLongrunningOperation.class);
+              this.parent = com.google.api.client.util.Preconditions.checkNotNull(parent, "Required parameter parent must be specified.");
+              if (!getSuppressPatternChecks()) {
+                com.google.api.client.util.Preconditions.checkArgument(PARENT_PATTERN.matcher(parent).matches(),
+                    "Parameter parent must conform to the pattern " +
+                    "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+$");
+              }
+            }
+
+            @Override
+            public Export set$Xgafv(java.lang.String $Xgafv) {
+              return (Export) super.set$Xgafv($Xgafv);
+            }
+
+            @Override
+            public Export setAccessToken(java.lang.String accessToken) {
+              return (Export) super.setAccessToken(accessToken);
+            }
+
+            @Override
+            public Export setAlt(java.lang.String alt) {
+              return (Export) super.setAlt(alt);
+            }
+
+            @Override
+            public Export setCallback(java.lang.String callback) {
+              return (Export) super.setCallback(callback);
+            }
+
+            @Override
+            public Export setFields(java.lang.String fields) {
+              return (Export) super.setFields(fields);
+            }
+
+            @Override
+            public Export setKey(java.lang.String key) {
+              return (Export) super.setKey(key);
+            }
+
+            @Override
+            public Export setOauthToken(java.lang.String oauthToken) {
+              return (Export) super.setOauthToken(oauthToken);
+            }
+
+            @Override
+            public Export setPrettyPrint(java.lang.Boolean prettyPrint) {
+              return (Export) super.setPrettyPrint(prettyPrint);
+            }
+
+            @Override
+            public Export setQuotaUser(java.lang.String quotaUser) {
+              return (Export) super.setQuotaUser(quotaUser);
+            }
+
+            @Override
+            public Export setUploadType(java.lang.String uploadType) {
+              return (Export) super.setUploadType(uploadType);
+            }
+
+            @Override
+            public Export setUploadProtocol(java.lang.String uploadProtocol) {
+              return (Export) super.setUploadProtocol(uploadProtocol);
+            }
+
+            /**
+             * Required. Resource name of a Catalog. For example
+             * `projects/1234/locations/global/catalogs/default_catalog`
+             */
+            @com.google.api.client.util.Key
+            private java.lang.String parent;
+
+            /** Required. Resource name of a Catalog. For example
+           `projects/1234/locations/global/catalogs/default_catalog`
+             */
+            public java.lang.String getParent() {
+              return parent;
+            }
+
+            /**
+             * Required. Resource name of a Catalog. For example
+             * `projects/1234/locations/global/catalogs/default_catalog`
+             */
+            public Export setParent(java.lang.String parent) {
+              if (!getSuppressPatternChecks()) {
+                com.google.api.client.util.Preconditions.checkArgument(PARENT_PATTERN.matcher(parent).matches(),
+                    "Parameter parent must conform to the pattern " +
+                    "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+$");
+              }
+              this.parent = parent;
+              return this;
+            }
+
+            @Override
+            public Export set(String parameterName, Object value) {
+              return (Export) super.set(parameterName, value);
+            }
+          }
           /**
            * Bulk import of User events. Request processing might be synchronous. Events that already exist
            * are skipped. Use this method for backfilling historical user events. `Operation.response` is of

clients/google-api-services-retail/v2alpha/2.0.0/com/google/api/services/retail/v2alpha/model/GoogleCloudRetailV2alphaExportUserEventsRequest.java

@@ -0,0 +1,139 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+/*
+ * This code was generated by https://github.com/googleapis/google-api-java-client-services/
+ * Modify at your own risk.
+ */
+
+package com.google.api.services.retail.v2alpha.model;
+
+/**
+ * Request message for the `ExportUserEvents` method.
+ *
+ * <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
+ * 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>
+ *
+ * @author Google, Inc.
+ */
+@SuppressWarnings("javadoc")
+public final class GoogleCloudRetailV2alphaExportUserEventsRequest extends com.google.api.client.json.GenericJson {
+
+  /**
+   * A filtering expression to specify restrictions on returned events. The expression is a sequence
+   * of terms. Each term applies a restriction to the returned user events. Use this expression to
+   * restrict results to a specific time range or to filter events by eventType. For example,
+   * `eventTime > "2012-04-23T18:25:43.511Z" eventsMissingCatalogItems
+   * eventTime<"2012-04-23T18:25:43.511Z" eventType=search` We expect only three types of fields: *
+   * `eventTime`: This can be specified twice, once with a less than operator and once with a
+   * greater than operator. The `eventTime` restriction should result in one, contiguous, valid,
+   * `eventTime` range. * `eventType`: Boolean operators `OR` and `NOT` are supported if the
+   * expression is enclosed in parentheses and the operators are separated from the tag values by a
+   * space. * `eventsMissingCatalogItems`: This restricts results to events for which catalog items
+   * were not found in the catalog. The default behavior is to return only those events for which
+   * catalog items were found. Some examples of valid filters expressions: * Example 1: `eventTime >
+   * "2012-04-23T18:25:43.511Z" eventTime < "2012-04-23T18:30:43.511Z"` * Example 2: `eventTime >
+   * "2012-04-23T18:25:43.511Z" eventType = detail-page-view` * Example 3:
+   * `eventsMissingCatalogItems eventType = (NOT search) eventTime < "2018-04-23T18:30:43.511Z"` *
+   * Example 4: `eventTime > "2012-04-23T18:25:43.511Z"` * Example 5: `eventType = (detail-page-view
+   * OR search)` * Example 6: `eventsMissingCatalogItems`
+   * The value may be {@code null}.
+   */
+  @com.google.api.client.util.Key
+  private java.lang.String filter;
+
+  /**
+   * Required. The output location of the data.
+   * The value may be {@code null}.
+   */
+  @com.google.api.client.util.Key
+  private GoogleCloudRetailV2alphaOutputConfig outputConfig;
+
+  /**
+   * A filtering expression to specify restrictions on returned events. The expression is a sequence
+   * of terms. Each term applies a restriction to the returned user events. Use this expression to
+   * restrict results to a specific time range or to filter events by eventType. For example,
+   * `eventTime > "2012-04-23T18:25:43.511Z" eventsMissingCatalogItems
+   * eventTime<"2012-04-23T18:25:43.511Z" eventType=search` We expect only three types of fields: *
+   * `eventTime`: This can be specified twice, once with a less than operator and once with a
+   * greater than operator. The `eventTime` restriction should result in one, contiguous, valid,
+   * `eventTime` range. * `eventType`: Boolean operators `OR` and `NOT` are supported if the
+   * expression is enclosed in parentheses and the operators are separated from the tag values by a
+   * space. * `eventsMissingCatalogItems`: This restricts results to events for which catalog items
+   * were not found in the catalog. The default behavior is to return only those events for which
+   * catalog items were found. Some examples of valid filters expressions: * Example 1: `eventTime >
+   * "2012-04-23T18:25:43.511Z" eventTime < "2012-04-23T18:30:43.511Z"` * Example 2: `eventTime >
+   * "2012-04-23T18:25:43.511Z" eventType = detail-page-view` * Example 3:
+   * `eventsMissingCatalogItems eventType = (NOT search) eventTime < "2018-04-23T18:30:43.511Z"` *
+   * Example 4: `eventTime > "2012-04-23T18:25:43.511Z"` * Example 5: `eventType = (detail-page-view
+   * OR search)` * Example 6: `eventsMissingCatalogItems`
+   * @return value or {@code null} for none
+   */
+  public java.lang.String getFilter() {
+    return filter;
+  }
+
+  /**
+   * A filtering expression to specify restrictions on returned events. The expression is a sequence
+   * of terms. Each term applies a restriction to the returned user events. Use this expression to
+   * restrict results to a specific time range or to filter events by eventType. For example,
+   * `eventTime > "2012-04-23T18:25:43.511Z" eventsMissingCatalogItems
+   * eventTime<"2012-04-23T18:25:43.511Z" eventType=search` We expect only three types of fields: *
+   * `eventTime`: This can be specified twice, once with a less than operator and once with a
+   * greater than operator. The `eventTime` restriction should result in one, contiguous, valid,
+   * `eventTime` range. * `eventType`: Boolean operators `OR` and `NOT` are supported if the
+   * expression is enclosed in parentheses and the operators are separated from the tag values by a
+   * space. * `eventsMissingCatalogItems`: This restricts results to events for which catalog items
+   * were not found in the catalog. The default behavior is to return only those events for which
+   * catalog items were found. Some examples of valid filters expressions: * Example 1: `eventTime >
+   * "2012-04-23T18:25:43.511Z" eventTime < "2012-04-23T18:30:43.511Z"` * Example 2: `eventTime >
+   * "2012-04-23T18:25:43.511Z" eventType = detail-page-view` * Example 3:
+   * `eventsMissingCatalogItems eventType = (NOT search) eventTime < "2018-04-23T18:30:43.511Z"` *
+   * Example 4: `eventTime > "2012-04-23T18:25:43.511Z"` * Example 5: `eventType = (detail-page-view
+   * OR search)` * Example 6: `eventsMissingCatalogItems`
+   * @param filter filter or {@code null} for none
+   */
+  public GoogleCloudRetailV2alphaExportUserEventsRequest setFilter(java.lang.String filter) {
+    this.filter = filter;
+    return this;
+  }
+
+  /**
+   * Required. The output location of the data.
+   * @return value or {@code null} for none
+   */
+  public GoogleCloudRetailV2alphaOutputConfig getOutputConfig() {
+    return outputConfig;
+  }
+
+  /**
+   * Required. The output location of the data.
+   * @param outputConfig outputConfig or {@code null} for none
+   */
+  public GoogleCloudRetailV2alphaExportUserEventsRequest setOutputConfig(GoogleCloudRetailV2alphaOutputConfig outputConfig) {
+    this.outputConfig = outputConfig;
+    return this;
+  }
+
+  @Override
+  public GoogleCloudRetailV2alphaExportUserEventsRequest set(String fieldName, Object value) {
+    return (GoogleCloudRetailV2alphaExportUserEventsRequest) super.set(fieldName, value);
+  }
+
+  @Override
+  public GoogleCloudRetailV2alphaExportUserEventsRequest clone() {
+    return (GoogleCloudRetailV2alphaExportUserEventsRequest) super.clone();
+  }
+
+}

clients/google-api-services-retail/v2alpha/2.0.0/pom.xml

@@ -8,8 +8,8 @@
 
   <groupId>com.google.apis</groupId>
   <artifactId>google-api-services-retail</artifactId>
-  <version>v2alpha-rev20240702-2.0.0</version>
-  <name>Vertex AI Search for Retail API v2alpha-rev20240702-2.0.0</name>
+  <version>v2alpha-rev20240711-2.0.0</version>
+  <name>Vertex AI Search for Retail API v2alpha-rev20240711-2.0.0</name>
   <packaging>jar</packaging>
 
   <inceptionYear>2011</inceptionYear>

clients/google-api-services-retail/v2alpha/README.md

@@ -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>v2alpha-rev20240702-2.0.0</version>
+      <version>v2alpha-rev20240711-2.0.0</version>
     </dependency>
   </dependencies>
 </project>
@@ -35,7 +35,7 @@ repositories {
   mavenCentral()
 }
 dependencies {
-  implementation 'com.google.apis:google-api-services-retail:v2alpha-rev20240702-2.0.0'
+  implementation 'com.google.apis:google-api-services-retail:v2alpha-rev20240711-2.0.0'
 }
 ```
 

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

@@ -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>v2beta-rev20240702-2.0.0</version>
+      <version>v2beta-rev20240711-2.0.0</version>
     </dependency>
   </dependencies>
 </project>
@@ -35,7 +35,7 @@ repositories {
   mavenCentral()
 }
 dependencies {
-  implementation 'com.google.apis:google-api-services-retail:v2beta-rev20240702-2.0.0'
+  implementation 'com.google.apis:google-api-services-retail:v2beta-rev20240711-2.0.0'
 }
 ```