chore: regenerate merchantapi client (#23807)

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-merchantapi/accounts_v1beta/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-merchantapi</artifactId>
-      <version>accounts_v1beta-rev20241023-2.0.0</version>
+      <version>accounts_v1beta-rev20241029-2.0.0</version>
     </dependency>
   </dependencies>
 </project>
@@ -35,7 +35,7 @@ repositories {
   mavenCentral()
 }
 dependencies {
-  implementation 'com.google.apis:google-api-services-merchantapi:accounts_v1beta-rev20241023-2.0.0'
+  implementation 'com.google.apis:google-api-services-merchantapi:accounts_v1beta-rev20241029-2.0.0'
 }
 ```
 

clients/google-api-services-merchantapi/accounts_v1beta/2.0.0/com/google/api/services/merchantapi/accounts_v1beta/model/Account.java

@@ -17,7 +17,13 @@
 package com.google.api.services.merchantapi.accounts_v1beta.model;
 
 /**
- * An account.
+ * The `Account` message represents a merchant's account within Shopping Ads. It's the primary
+ * entity for managing product data, settings, and interactions with Google's services and external
+ * providers. Accounts can operate as standalone entities or be part of a multi-client account (MCA)
+ * structure. In an MCA setup the parent account manages multiple sub-accounts. Establishing an
+ * account involves configuring attributes like the account name, time zone, and language
+ * preferences. The `Account` message is the parent entity for many other resources, for example,
+ * `AccountRelationship`, `Homepage`, `BusinessInfo` and so on.
  *
  * <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 Merchant API. For a detailed explanation see:

clients/google-api-services-merchantapi/accounts_v1beta/2.0.0/com/google/api/services/merchantapi/accounts_v1beta/model/BusinessInfo.java

@@ -17,7 +17,9 @@
 package com.google.api.services.merchantapi.accounts_v1beta.model;
 
 /**
- * Collection of information related to a business.
+ * The `BusinessInfo` message contains essential information about a merchant's business. This
+ * message captures key business details such as physical address, customer service contacts, and
+ * region-specific identifiers.
  *
  * <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 Merchant API. For a detailed explanation see:
@@ -30,7 +32,8 @@
 public final class BusinessInfo extends com.google.api.client.json.GenericJson {
 
   /**
-   * Optional. The address of the business.
+   * Optional. The address of the business. Only `region_code`, `address_lines`, `postal_code`,
+   * `administrative_area` and `locality` fields are supported. All other fields are ignored.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
@@ -74,15 +77,17 @@ public final class BusinessInfo extends com.google.api.client.json.GenericJson {
   private java.lang.String phoneVerificationState;
 
   /**
-   * Optional. The address of the business.
+   * Optional. The address of the business. Only `region_code`, `address_lines`, `postal_code`,
+   * `administrative_area` and `locality` fields are supported. All other fields are ignored.
    * @return value or {@code null} for none
    */
   public PostalAddress getAddress() {
     return address;
   }
 
   /**
-   * Optional. The address of the business.
+   * Optional. The address of the business. Only `region_code`, `address_lines`, `postal_code`,
+   * `administrative_area` and `locality` fields are supported. All other fields are ignored.
    * @param address address or {@code null} for none
    */
   public BusinessInfo setAddress(PostalAddress address) {

clients/google-api-services-merchantapi/accounts_v1beta/2.0.0/com/google/api/services/merchantapi/accounts_v1beta/model/CarrierRate.java

@@ -17,7 +17,10 @@
 package com.google.api.services.merchantapi.accounts_v1beta.model;
 
 /**
- * A list of carrier rates that can be referred to by `main_table` or `single_value`.
+ * A list of carrier rates that can be referred to by `main_table` or `single_value`. Supported
+ * carrier services are defined in https://support.google.com/merchants/answer/12577710?hl=en&ref_to
+ * pic=12570808&sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-
+ * uk-and-us-only.
  *
  * <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 Merchant API. For a detailed explanation see:

clients/google-api-services-merchantapi/accounts_v1beta/2.0.0/com/google/api/services/merchantapi/accounts_v1beta/model/Homepage.java

@@ -17,7 +17,11 @@
 package com.google.api.services.merchantapi.accounts_v1beta.model;
 
 /**
- * A store's homepage.
+ * The `Homepage` message represents a merchant's store homepage within the system. A merchant's
+ * homepage is the primary domain where customers interact with their store. The homepage can be
+ * claimed and verified as a proof of ownership and allows the merchant to unlock features that
+ * require a verified website. For more information, see [Understanding online store URL
+ * verification](//support.google.com/merchants/answer/176793).
  *
  * <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 Merchant API. For a detailed explanation see:

clients/google-api-services-merchantapi/accounts_v1beta/2.0.0/com/google/api/services/merchantapi/accounts_v1beta/model/TermsOfService.java

@@ -17,7 +17,12 @@
 package com.google.api.services.merchantapi.accounts_v1beta.model;
 
 /**
- * A `TermsOfService`.
+ * The `TermsOfService` message represents a specific version of the terms of service that merchants
+ * must accept to access certain features or services (see
+ * https://support.google.com/merchants/answer/160173). This message is important for the onboarding
+ * process, ensuring that merchants agree to the necessary legal agreements for using the service.
+ * Merchants can retrieve the latest terms of service for a given `kind` and `region` through
+ * `RetrieveLatestTermsOfService`, and accept them as required through `AcceptTermsOfService`.
  *
  * <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 Merchant API. For a detailed explanation see:

clients/google-api-services-merchantapi/accounts_v1beta/2.0.0/com/google/api/services/merchantapi/accounts_v1beta/model/User.java

@@ -17,7 +17,10 @@
 package com.google.api.services.merchantapi.accounts_v1beta.model;
 
 /**
- * A [user](https://support.google.com/merchants/answer/12160472).
+ * The `User` message represents a user associated with a Merchant Center account. It is used to
+ * manage user permissions and access rights within the account. For more information, see
+ * [Frequently asked questions about people and access
+ * levels](//support.google.com/merchants/answer/12160472).
  *
  * <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 Merchant API. For a detailed explanation see:

clients/google-api-services-merchantapi/accounts_v1beta/2.0.0/com/google/api/services/merchantapi/accounts_v1beta/model/WarehouseBasedDeliveryTime.java

@@ -32,7 +32,9 @@
 public final class WarehouseBasedDeliveryTime extends com.google.api.client.json.GenericJson {
 
   /**
-   * Required. Carrier, such as `"UPS"` or `"Fedex"`.
+   * Required. Carrier, such as `"UPS"` or `"Fedex"`. [supported
+   * carriers](https://support.google.com/merchants/answer/7050921#zippy=%2Ccarrier-rates-au-de-uk-
+   * and-us-only)
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
@@ -54,15 +56,19 @@ public final class WarehouseBasedDeliveryTime extends com.google.api.client.json
   private java.lang.String warehouse;
 
   /**
-   * Required. Carrier, such as `"UPS"` or `"Fedex"`.
+   * Required. Carrier, such as `"UPS"` or `"Fedex"`. [supported
+   * carriers](https://support.google.com/merchants/answer/7050921#zippy=%2Ccarrier-rates-au-de-uk-
+   * and-us-only)
    * @return value or {@code null} for none
    */
   public java.lang.String getCarrier() {
     return carrier;
   }
 
   /**
-   * Required. Carrier, such as `"UPS"` or `"Fedex"`.
+   * Required. Carrier, such as `"UPS"` or `"Fedex"`. [supported
+   * carriers](https://support.google.com/merchants/answer/7050921#zippy=%2Ccarrier-rates-au-de-uk-
+   * and-us-only)
    * @param carrier carrier or {@code null} for none
    */
   public WarehouseBasedDeliveryTime setCarrier(java.lang.String carrier) {

clients/google-api-services-merchantapi/accounts_v1beta/2.0.0/pom.xml

@@ -8,8 +8,8 @@
 
   <groupId>com.google.apis</groupId>
   <artifactId>google-api-services-merchantapi</artifactId>
-  <version>accounts_v1beta-rev20241023-2.0.0</version>
-  <name>Merchant API accounts_v1beta-rev20241023-2.0.0</name>
+  <version>accounts_v1beta-rev20241029-2.0.0</version>
+  <name>Merchant API accounts_v1beta-rev20241029-2.0.0</name>
   <packaging>jar</packaging>
 
   <inceptionYear>2011</inceptionYear>

clients/google-api-services-merchantapi/accounts_v1beta/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-merchantapi</artifactId>
-      <version>accounts_v1beta-rev20241023-2.0.0</version>
+      <version>accounts_v1beta-rev20241029-2.0.0</version>
     </dependency>
   </dependencies>
 </project>
@@ -35,7 +35,7 @@ repositories {
   mavenCentral()
 }
 dependencies {
-  implementation 'com.google.apis:google-api-services-merchantapi:accounts_v1beta-rev20241023-2.0.0'
+  implementation 'com.google.apis:google-api-services-merchantapi:accounts_v1beta-rev20241029-2.0.0'
 }
 ```