chore: regenerate retail client (googleapis#24631)

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

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

@@ -83,6 +83,13 @@ public final class GoogleCloudRetailV2Rule extends com.google.api.client.json.Ge
   @com.google.api.client.util.Key
   private GoogleCloudRetailV2RuleOnewaySynonymsAction onewaySynonymsAction;
 
+  /**
+   * Pins one or more specified products to a specific position in the results.
+   * The value may be {@code null}.
+   */
+  @com.google.api.client.util.Key
+  private GoogleCloudRetailV2RulePinAction pinAction;
+
   /**
    * Redirects a shopper to a specific page.
    * The value may be {@code null}.
@@ -234,6 +241,23 @@ public GoogleCloudRetailV2Rule setOnewaySynonymsAction(GoogleCloudRetailV2RuleOn
     return this;
   }
 
+  /**
+   * Pins one or more specified products to a specific position in the results.
+   * @return value or {@code null} for none
+   */
+  public GoogleCloudRetailV2RulePinAction getPinAction() {
+    return pinAction;
+  }
+
+  /**
+   * Pins one or more specified products to a specific position in the results.
+   * @param pinAction pinAction or {@code null} for none
+   */
+  public GoogleCloudRetailV2Rule setPinAction(GoogleCloudRetailV2RulePinAction pinAction) {
+    this.pinAction = pinAction;
+    return this;
+  }
+
   /**
    * Redirects a shopper to a specific page.
    * @return value or {@code null} for none

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

@@ -0,0 +1,93 @@
+/*
+ * 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;
+
+/**
+ * Pins one or more specified products to a specific position in the results. * Rule Condition: Must
+ * specify non-empty Condition.query_terms (for search only) or Condition.page_categories (for
+ * browse only), but can't specify both. * Action Input: mapping of `[pin_position, product_id]`
+ * pairs (pin position uses 1-based indexing). * Action Result: Will pin products with matching ids
+ * to the position specified in the final result order. Example: Suppose the query is `shoes`, the
+ * Condition.query_terms is `shoes` and the pin_map has `{1, "pid1"}`, then product with `pid1` will
+ * be pinned to the top position in the final results. If multiple PinActions are matched to a
+ * single request the actions will be processed from most to least recently updated. Pins to
+ * positions larger than the max allowed page size of 120 are not allowed.
+ *
+ * <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 GoogleCloudRetailV2RulePinAction extends com.google.api.client.json.GenericJson {
+
+  /**
+   * Required. A map of positions to product_ids. Partial matches per action are allowed, if a
+   * certain position in the map is already filled that `[position, product_id]` pair will be
+   * ignored but the rest may still be applied. This case will only occur if multiple pin actions
+   * are matched to a single request, as the map guarantees that pin positions are unique within the
+   * same action. Duplicate product_ids are not permitted within a single pin map. The max size of
+   * this map is 120, equivalent to the max [request page size](https://cloud.google.com/retail/docs
+   * /reference/rest/v2/projects.locations.catalogs.placements/search#request-body).
+   * The value may be {@code null}.
+   */
+  @com.google.api.client.util.Key
+  private java.util.Map<String, java.lang.String> pinMap;
+
+  /**
+   * Required. A map of positions to product_ids. Partial matches per action are allowed, if a
+   * certain position in the map is already filled that `[position, product_id]` pair will be
+   * ignored but the rest may still be applied. This case will only occur if multiple pin actions
+   * are matched to a single request, as the map guarantees that pin positions are unique within the
+   * same action. Duplicate product_ids are not permitted within a single pin map. The max size of
+   * this map is 120, equivalent to the max [request page size](https://cloud.google.com/retail/docs
+   * /reference/rest/v2/projects.locations.catalogs.placements/search#request-body).
+   * @return value or {@code null} for none
+   */
+  public java.util.Map<String, java.lang.String> getPinMap() {
+    return pinMap;
+  }
+
+  /**
+   * Required. A map of positions to product_ids. Partial matches per action are allowed, if a
+   * certain position in the map is already filled that `[position, product_id]` pair will be
+   * ignored but the rest may still be applied. This case will only occur if multiple pin actions
+   * are matched to a single request, as the map guarantees that pin positions are unique within the
+   * same action. Duplicate product_ids are not permitted within a single pin map. The max size of
+   * this map is 120, equivalent to the max [request page size](https://cloud.google.com/retail/docs
+   * /reference/rest/v2/projects.locations.catalogs.placements/search#request-body).
+   * @param pinMap pinMap or {@code null} for none
+   */
+  public GoogleCloudRetailV2RulePinAction setPinMap(java.util.Map<String, java.lang.String> pinMap) {
+    this.pinMap = pinMap;
+    return this;
+  }
+
+  @Override
+  public GoogleCloudRetailV2RulePinAction set(String fieldName, Object value) {
+    return (GoogleCloudRetailV2RulePinAction) super.set(fieldName, value);
+  }
+
+  @Override
+  public GoogleCloudRetailV2RulePinAction clone() {
+    return (GoogleCloudRetailV2RulePinAction) super.clone();
+  }
+
+}

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

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

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

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

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

@@ -83,6 +83,13 @@ public final class GoogleCloudRetailV2alphaRule extends com.google.api.client.js
   @com.google.api.client.util.Key
   private GoogleCloudRetailV2alphaRuleOnewaySynonymsAction onewaySynonymsAction;
 
+  /**
+   * Pins one or more specified products to a specific position in the results.
+   * The value may be {@code null}.
+   */
+  @com.google.api.client.util.Key
+  private GoogleCloudRetailV2alphaRulePinAction pinAction;
+
   /**
    * Redirects a shopper to a specific page.
    * The value may be {@code null}.
@@ -234,6 +241,23 @@ public GoogleCloudRetailV2alphaRule setOnewaySynonymsAction(GoogleCloudRetailV2a
     return this;
   }
 
+  /**
+   * Pins one or more specified products to a specific position in the results.
+   * @return value or {@code null} for none
+   */
+  public GoogleCloudRetailV2alphaRulePinAction getPinAction() {
+    return pinAction;
+  }
+
+  /**
+   * Pins one or more specified products to a specific position in the results.
+   * @param pinAction pinAction or {@code null} for none
+   */
+  public GoogleCloudRetailV2alphaRule setPinAction(GoogleCloudRetailV2alphaRulePinAction pinAction) {
+    this.pinAction = pinAction;
+    return this;
+  }
+
   /**
    * Redirects a shopper to a specific page.
    * @return value or {@code null} for none

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

@@ -0,0 +1,93 @@
+/*
+ * 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;
+
+/**
+ * Pins one or more specified products to a specific position in the results. * Rule Condition: Must
+ * specify non-empty Condition.query_terms (for search only) or Condition.page_categories (for
+ * browse only), but can't specify both. * Action Input: mapping of `[pin_position, product_id]`
+ * pairs (pin position uses 1-based indexing). * Action Result: Will pin products with matching ids
+ * to the position specified in the final result order. Example: Suppose the query is `shoes`, the
+ * Condition.query_terms is `shoes` and the pin_map has `{1, "pid1"}`, then product with `pid1` will
+ * be pinned to the top position in the final results. If multiple PinActions are matched to a
+ * single request the actions will be processed from most to least recently updated. Pins to
+ * positions larger than the max allowed page size of 120 are not allowed.
+ *
+ * <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 GoogleCloudRetailV2alphaRulePinAction extends com.google.api.client.json.GenericJson {
+
+  /**
+   * Required. A map of positions to product_ids. Partial matches per action are allowed, if a
+   * certain position in the map is already filled that `[position, product_id]` pair will be
+   * ignored but the rest may still be applied. This case will only occur if multiple pin actions
+   * are matched to a single request, as the map guarantees that pin positions are unique within the
+   * same action. Duplicate product_ids are not permitted within a single pin map. The max size of
+   * this map is 120, equivalent to the max [request page size](https://cloud.google.com/retail/docs
+   * /reference/rest/v2/projects.locations.catalogs.placements/search#request-body).
+   * The value may be {@code null}.
+   */
+  @com.google.api.client.util.Key
+  private java.util.Map<String, java.lang.String> pinMap;
+
+  /**
+   * Required. A map of positions to product_ids. Partial matches per action are allowed, if a
+   * certain position in the map is already filled that `[position, product_id]` pair will be
+   * ignored but the rest may still be applied. This case will only occur if multiple pin actions
+   * are matched to a single request, as the map guarantees that pin positions are unique within the
+   * same action. Duplicate product_ids are not permitted within a single pin map. The max size of
+   * this map is 120, equivalent to the max [request page size](https://cloud.google.com/retail/docs
+   * /reference/rest/v2/projects.locations.catalogs.placements/search#request-body).
+   * @return value or {@code null} for none
+   */
+  public java.util.Map<String, java.lang.String> getPinMap() {
+    return pinMap;
+  }
+
+  /**
+   * Required. A map of positions to product_ids. Partial matches per action are allowed, if a
+   * certain position in the map is already filled that `[position, product_id]` pair will be
+   * ignored but the rest may still be applied. This case will only occur if multiple pin actions
+   * are matched to a single request, as the map guarantees that pin positions are unique within the
+   * same action. Duplicate product_ids are not permitted within a single pin map. The max size of
+   * this map is 120, equivalent to the max [request page size](https://cloud.google.com/retail/docs
+   * /reference/rest/v2/projects.locations.catalogs.placements/search#request-body).
+   * @param pinMap pinMap or {@code null} for none
+   */
+  public GoogleCloudRetailV2alphaRulePinAction setPinMap(java.util.Map<String, java.lang.String> pinMap) {
+    this.pinMap = pinMap;
+    return this;
+  }
+
+  @Override
+  public GoogleCloudRetailV2alphaRulePinAction set(String fieldName, Object value) {
+    return (GoogleCloudRetailV2alphaRulePinAction) super.set(fieldName, value);
+  }
+
+  @Override
+  public GoogleCloudRetailV2alphaRulePinAction clone() {
+    return (GoogleCloudRetailV2alphaRulePinAction) 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-rev20241231-2.0.0</version>
-  <name>Vertex AI Search for Retail API v2alpha-rev20241231-2.0.0</name>
+  <version>v2alpha-rev20250107-2.0.0</version>
+  <name>Vertex AI Search for Retail API v2alpha-rev20250107-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-rev20241231-2.0.0</version>
+      <version>v2alpha-rev20250107-2.0.0</version>
     </dependency>
   </dependencies>
 </project>
@@ -35,7 +35,7 @@ repositories {
   mavenCentral()
 }
 dependencies {
-  implementation 'com.google.apis:google-api-services-retail:v2alpha-rev20241231-2.0.0'
+  implementation 'com.google.apis:google-api-services-retail:v2alpha-rev20250107-2.0.0'
 }
 ```