chore: regenerate retail client (googleapis#24314)

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

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

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

@@ -10095,9 +10095,10 @@ public UserEvents userEvents() {
         public class UserEvents {
 
           /**
-           * Writes a single user event from the browser. This uses a GET request to due to browser
-           * restriction of POST-ing to a 3rd party domain. This method is used only by the Retail API
-           * JavaScript pixel and Google Tag Manager. Users should not call this method directly.
+           * Writes a single user event from the browser. For larger user event payload over 16 KB, the POST
+           * method should be used instead, otherwise a 400 Bad Request error is returned. This method is used
+           * only by the Retail API JavaScript pixel and Google Tag Manager. Users should not call this method
+           * directly.
            *
            * Create a request for the method "userEvents.collect".
            *
@@ -10106,10 +10107,11 @@ public class UserEvents {
            *
            * @param parent Required. The parent catalog name, such as
            *        `projects/1234/locations/global/catalogs/default_catalog`.
+           * @param content the {@link com.google.api.services.retail.v2.model.GoogleCloudRetailV2CollectUserEventRequest}
            * @return the request
            */
-          public Collect collect(java.lang.String parent) throws java.io.IOException {
-            Collect result = new Collect(parent);
+          public Collect collect(java.lang.String parent, com.google.api.services.retail.v2.model.GoogleCloudRetailV2CollectUserEventRequest content) throws java.io.IOException {
+            Collect result = new Collect(parent, content);
             initialize(result);
             return result;
           }
@@ -10122,9 +10124,10 @@ public class Collect extends CloudRetailRequest<com.google.api.services.retail.v
                 java.util.regex.Pattern.compile("^projects/[^/]+/locations/[^/]+/catalogs/[^/]+$");
 
             /**
-             * Writes a single user event from the browser. This uses a GET request to due to browser
-             * restriction of POST-ing to a 3rd party domain. This method is used only by the Retail API
-             * JavaScript pixel and Google Tag Manager. Users should not call this method directly.
+             * Writes a single user event from the browser. For larger user event payload over 16 KB, the POST
+             * method should be used instead, otherwise a 400 Bad Request error is returned. This method is
+             * used only by the Retail API JavaScript pixel and Google Tag Manager. Users should not call this
+             * method directly.
              *
              * Create a request for the method "userEvents.collect".
              *
@@ -10136,10 +10139,11 @@ public class Collect extends CloudRetailRequest<com.google.api.services.retail.v
              *
              * @param parent Required. The parent catalog name, such as
            *        `projects/1234/locations/global/catalogs/default_catalog`.
+             * @param content the {@link com.google.api.services.retail.v2.model.GoogleCloudRetailV2CollectUserEventRequest}
              * @since 1.13
              */
-            protected Collect(java.lang.String parent) {
-              super(CloudRetail.this, "GET", REST_PATH, null, com.google.api.services.retail.v2.model.GoogleApiHttpBody.class);
+            protected Collect(java.lang.String parent, com.google.api.services.retail.v2.model.GoogleCloudRetailV2CollectUserEventRequest content) {
+              super(CloudRetail.this, "POST", REST_PATH, content, com.google.api.services.retail.v2.model.GoogleApiHttpBody.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(),
@@ -10148,16 +10152,6 @@ protected Collect(java.lang.String parent) {
               }
             }
 
-            @Override
-            public com.google.api.client.http.HttpResponse executeUsingHead() throws java.io.IOException {
-              return super.executeUsingHead();
-            }
-
-            @Override
-            public com.google.api.client.http.HttpRequest buildHttpRequestUsingHead() throws java.io.IOException {
-              return super.buildHttpRequestUsingHead();
-            }
-
             @Override
             public Collect set$Xgafv(java.lang.String $Xgafv) {
               return (Collect) super.set$Xgafv($Xgafv);
@@ -10241,124 +10235,6 @@ public Collect setParent(java.lang.String parent) {
               return this;
             }
 
-            /**
-             * The event timestamp in milliseconds. This prevents browser caching of otherwise
-             * identical get requests. The name is abbreviated to reduce the payload bytes.
-             */
-            @com.google.api.client.util.Key
-            private java.lang.Long ets;
-
-            /** The event timestamp in milliseconds. This prevents browser caching of otherwise identical get
-           requests. The name is abbreviated to reduce the payload bytes.
-             */
-            public java.lang.Long getEts() {
-              return ets;
-            }
-
-            /**
-             * The event timestamp in milliseconds. This prevents browser caching of otherwise
-             * identical get requests. The name is abbreviated to reduce the payload bytes.
-             */
-            public Collect setEts(java.lang.Long ets) {
-              this.ets = ets;
-              return this;
-            }
-
-            /**
-             * The prebuilt rule name that can convert a specific type of raw_json. For example:
-             * "ga4_bq" rule for the GA4 user event schema.
-             */
-            @com.google.api.client.util.Key
-            private java.lang.String prebuiltRule;
-
-            /** The prebuilt rule name that can convert a specific type of raw_json. For example: "ga4_bq" rule for
-           the GA4 user event schema.
-             */
-            public java.lang.String getPrebuiltRule() {
-              return prebuiltRule;
-            }
-
-            /**
-             * The prebuilt rule name that can convert a specific type of raw_json. For example:
-             * "ga4_bq" rule for the GA4 user event schema.
-             */
-            public Collect setPrebuiltRule(java.lang.String prebuiltRule) {
-              this.prebuiltRule = prebuiltRule;
-              return this;
-            }
-
-            /**
-             * An arbitrary serialized JSON string that contains necessary information that can
-             * comprise a user event. When this field is specified, the user_event field will be
-             * ignored. Note: line-delimited JSON is not supported, a single JSON only.
-             */
-            @com.google.api.client.util.Key
-            private java.lang.String rawJson;
-
-            /** An arbitrary serialized JSON string that contains necessary information that can comprise a user
-           event. When this field is specified, the user_event field will be ignored. Note: line-delimited
-           JSON is not supported, a single JSON only.
-             */
-            public java.lang.String getRawJson() {
-              return rawJson;
-            }
-
-            /**
-             * An arbitrary serialized JSON string that contains necessary information that can
-             * comprise a user event. When this field is specified, the user_event field will be
-             * ignored. Note: line-delimited JSON is not supported, a single JSON only.
-             */
-            public Collect setRawJson(java.lang.String rawJson) {
-              this.rawJson = rawJson;
-              return this;
-            }
-
-            /**
-             * The URL including cgi-parameters but excluding the hash fragment with a length limit
-             * of 5,000 characters. This is often more useful than the referer URL, because many
-             * browsers only send the domain for 3rd party requests.
-             */
-            @com.google.api.client.util.Key
-            private java.lang.String uri;
-
-            /** The URL including cgi-parameters but excluding the hash fragment with a length limit of 5,000
-           characters. This is often more useful than the referer URL, because many browsers only send the
-           domain for 3rd party requests.
-             */
-            public java.lang.String getUri() {
-              return uri;
-            }
-
-            /**
-             * The URL including cgi-parameters but excluding the hash fragment with a length limit
-             * of 5,000 characters. This is often more useful than the referer URL, because many
-             * browsers only send the domain for 3rd party requests.
-             */
-            public Collect setUri(java.lang.String uri) {
-              this.uri = uri;
-              return this;
-            }
-
-            /**
-             * Required. URL encoded UserEvent proto with a length limit of 2,000,000 characters.
-             */
-            @com.google.api.client.util.Key
-            private java.lang.String userEvent;
-
-            /** Required. URL encoded UserEvent proto with a length limit of 2,000,000 characters.
-             */
-            public java.lang.String getUserEvent() {
-              return userEvent;
-            }
-
-            /**
-             * Required. URL encoded UserEvent proto with a length limit of 2,000,000 characters.
-             */
-            public Collect setUserEvent(java.lang.String userEvent) {
-              this.userEvent = userEvent;
-              return this;
-            }
-
             @Override
             public Collect set(String parameterName, Object value) {
               return (Collect) super.set(parameterName, value);

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

@@ -0,0 +1,181 @@
+/*
+ * 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.v2.model;
+
+/**
+ * Request message for CollectUserEvent 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 GoogleCloudRetailV2CollectUserEventRequest extends com.google.api.client.json.GenericJson {
+
+  /**
+   * The event timestamp in milliseconds. This prevents browser caching of otherwise identical get
+   * requests. The name is abbreviated to reduce the payload bytes.
+   * The value may be {@code null}.
+   */
+  @com.google.api.client.util.Key @com.google.api.client.json.JsonString
+  private java.lang.Long ets;
+
+  /**
+   * The prebuilt rule name that can convert a specific type of raw_json. For example: "ga4_bq" rule
+   * for the GA4 user event schema.
+   * The value may be {@code null}.
+   */
+  @com.google.api.client.util.Key
+  private java.lang.String prebuiltRule;
+
+  /**
+   * An arbitrary serialized JSON string that contains necessary information that can comprise a
+   * user event. When this field is specified, the user_event field will be ignored. Note: line-
+   * delimited JSON is not supported, a single JSON only.
+   * The value may be {@code null}.
+   */
+  @com.google.api.client.util.Key
+  private java.lang.String rawJson;
+
+  /**
+   * The URL including cgi-parameters but excluding the hash fragment with a length limit of 5,000
+   * characters. This is often more useful than the referer URL, because many browsers only send the
+   * domain for 3rd party requests.
+   * The value may be {@code null}.
+   */
+  @com.google.api.client.util.Key
+  private java.lang.String uri;
+
+  /**
+   * Required. URL encoded UserEvent proto with a length limit of 2,000,000 characters.
+   * The value may be {@code null}.
+   */
+  @com.google.api.client.util.Key
+  private java.lang.String userEvent;
+
+  /**
+   * The event timestamp in milliseconds. This prevents browser caching of otherwise identical get
+   * requests. The name is abbreviated to reduce the payload bytes.
+   * @return value or {@code null} for none
+   */
+  public java.lang.Long getEts() {
+    return ets;
+  }
+
+  /**
+   * The event timestamp in milliseconds. This prevents browser caching of otherwise identical get
+   * requests. The name is abbreviated to reduce the payload bytes.
+   * @param ets ets or {@code null} for none
+   */
+  public GoogleCloudRetailV2CollectUserEventRequest setEts(java.lang.Long ets) {
+    this.ets = ets;
+    return this;
+  }
+
+  /**
+   * The prebuilt rule name that can convert a specific type of raw_json. For example: "ga4_bq" rule
+   * for the GA4 user event schema.
+   * @return value or {@code null} for none
+   */
+  public java.lang.String getPrebuiltRule() {
+    return prebuiltRule;
+  }
+
+  /**
+   * The prebuilt rule name that can convert a specific type of raw_json. For example: "ga4_bq" rule
+   * for the GA4 user event schema.
+   * @param prebuiltRule prebuiltRule or {@code null} for none
+   */
+  public GoogleCloudRetailV2CollectUserEventRequest setPrebuiltRule(java.lang.String prebuiltRule) {
+    this.prebuiltRule = prebuiltRule;
+    return this;
+  }
+
+  /**
+   * An arbitrary serialized JSON string that contains necessary information that can comprise a
+   * user event. When this field is specified, the user_event field will be ignored. Note: line-
+   * delimited JSON is not supported, a single JSON only.
+   * @return value or {@code null} for none
+   */
+  public java.lang.String getRawJson() {
+    return rawJson;
+  }
+
+  /**
+   * An arbitrary serialized JSON string that contains necessary information that can comprise a
+   * user event. When this field is specified, the user_event field will be ignored. Note: line-
+   * delimited JSON is not supported, a single JSON only.
+   * @param rawJson rawJson or {@code null} for none
+   */
+  public GoogleCloudRetailV2CollectUserEventRequest setRawJson(java.lang.String rawJson) {
+    this.rawJson = rawJson;
+    return this;
+  }
+
+  /**
+   * The URL including cgi-parameters but excluding the hash fragment with a length limit of 5,000
+   * characters. This is often more useful than the referer URL, because many browsers only send the
+   * domain for 3rd party requests.
+   * @return value or {@code null} for none
+   */
+  public java.lang.String getUri() {
+    return uri;
+  }
+
+  /**
+   * The URL including cgi-parameters but excluding the hash fragment with a length limit of 5,000
+   * characters. This is often more useful than the referer URL, because many browsers only send the
+   * domain for 3rd party requests.
+   * @param uri uri or {@code null} for none
+   */
+  public GoogleCloudRetailV2CollectUserEventRequest setUri(java.lang.String uri) {
+    this.uri = uri;
+    return this;
+  }
+
+  /**
+   * Required. URL encoded UserEvent proto with a length limit of 2,000,000 characters.
+   * @return value or {@code null} for none
+   */
+  public java.lang.String getUserEvent() {
+    return userEvent;
+  }
+
+  /**
+   * Required. URL encoded UserEvent proto with a length limit of 2,000,000 characters.
+   * @param userEvent userEvent or {@code null} for none
+   */
+  public GoogleCloudRetailV2CollectUserEventRequest setUserEvent(java.lang.String userEvent) {
+    this.userEvent = userEvent;
+    return this;
+  }
+
+  @Override
+  public GoogleCloudRetailV2CollectUserEventRequest set(String fieldName, Object value) {
+    return (GoogleCloudRetailV2CollectUserEventRequest) super.set(fieldName, value);
+  }
+
+  @Override
+  public GoogleCloudRetailV2CollectUserEventRequest clone() {
+    return (GoogleCloudRetailV2CollectUserEventRequest) super.clone();
+  }
+
+}