fix(merchantapi): update the API

#### merchantapi:accounts_v1beta

The following keys were changed:
- resources.accounts.methods.listSubaccounts.parameters.provider.description
- schemas.OnlineReturnPolicy.properties.acceptDefectiveOnly.description
- schemas.OnlineReturnPolicy.properties.acceptExchange.description
- schemas.OnlineReturnPolicy.properties.processRefundDays.description
- schemas.OnlineReturnPolicy.properties.returnLabelSource.description

#### merchantapi:datasources_v1beta

The following keys were changed:
- resources.accounts.resources.dataSources.methods.patch.parameters.name.description
- schemas.DataSource.properties.name.description

#### merchantapi:lfp_v1beta

The following keys were changed:
- schemas.LfpMerchantState.properties.inventoryStats.description
- schemas.LfpMerchantState.properties.storeStates.description

#### merchantapi:reports_v1beta

The following keys were changed:
- schemas.SearchRequest.properties.query.description

Author: yoshi-automation

discovery/merchantapi-accounts_v1beta.json

@@ -233,7 +233,7 @@
               "type": "string"
             },
             "provider": {
-              "description": "Required. The aggregation service provider. Format: `accounts/{providerId}`",
+              "description": "Required. The aggregation service provider. Format: `accounts/{accountId}`",
               "location": "path",
               "pattern": "^accounts/[^/]+$",
               "required": true,
@@ -1728,7 +1728,7 @@
       }
     }
   },
-  "revision": "20250427",
+  "revision": "20250430",
   "rootUrl": "https://merchantapi.googleapis.com/",
   "schemas": {
     "AcceptTermsOfServiceResponse": {
@@ -3051,11 +3051,11 @@
       "id": "OnlineReturnPolicy",
       "properties": {
         "acceptDefectiveOnly": {
-          "description": "This field specifies if merchant only accepts defective products for returns, and this field is required.",
+          "description": "Optional. This field specifies if merchant only accepts defective products for returns.",
           "type": "boolean"
         },
         "acceptExchange": {
-          "description": "This field specifies if merchant allows customers to exchange products, this field is required.",
+          "description": "Optional. This field specifies if merchant allows customers to exchange products.",
           "type": "boolean"
         },
         "countries": {
@@ -3095,7 +3095,7 @@
           "description": "Optional. The return policy."
         },
         "processRefundDays": {
-          "description": "The field specifies the number of days it takes for merchants to process refunds, field is optional.",
+          "description": "Optional. The field specifies the number of days it takes for merchants to process refunds.",
           "format": "int32",
           "type": "integer"
         },
@@ -3104,7 +3104,7 @@
           "description": "Optional. The restocking fee that applies to all return reason categories. This would be treated as a free restocking fee if the value is not set."
         },
         "returnLabelSource": {
-          "description": "The field specifies the return label source. This field is required when return method is BY_MAIL.",
+          "description": "Optional. The field specifies the return label source.",
           "enum": [
             "RETURN_LABEL_SOURCE_UNSPECIFIED",
             "DOWNLOAD_AND_PRINT",

discovery/merchantapi-datasources_v1beta.json

@@ -261,7 +261,7 @@
               ],
               "parameters": {
                 "name": {
-                  "description": "Identifier. The name of the data source. Format: `accounts/{account}/dataSources/{datasource}`",
+                  "description": "Required. Identifier. The name of the data source. Format: `accounts/{account}/dataSources/{datasource}`",
                   "location": "path",
                   "pattern": "^accounts/[^/]+/dataSources/[^/]+$",
                   "required": true,
@@ -321,7 +321,7 @@
       }
     }
   },
-  "revision": "20250427",
+  "revision": "20250430",
   "rootUrl": "https://merchantapi.googleapis.com/",
   "schemas": {
     "DataSource": {
@@ -370,7 +370,7 @@
           "description": "The [merchant review](https://support.google.com/merchants/answer/7045996) data source."
         },
         "name": {
-          "description": "Identifier. The name of the data source. Format: `accounts/{account}/dataSources/{datasource}`",
+          "description": "Required. Identifier. The name of the data source. Format: `accounts/{account}/dataSources/{datasource}`",
           "type": "string"
         },
         "primaryProductDataSource": {

discovery/merchantapi-lfp_v1beta.json

@@ -327,7 +327,7 @@
       }
     }
   },
-  "revision": "20250401",
+  "revision": "20250430",
   "rootUrl": "https://merchantapi.googleapis.com/",
   "schemas": {
     "CountrySettings": {
@@ -530,7 +530,7 @@
         },
         "inventoryStats": {
           "$ref": "InventoryStats",
-          "description": "The inventory statistics for the merchant."
+          "description": "The inventory statistics for the merchant. The field will be absent if the merchant has no inventory submitted through LFP."
         },
         "linkedGbps": {
           "description": "Number of [GBPs](https://www.google.com/business/) this merchant has access to.",
@@ -542,7 +542,7 @@
           "type": "string"
         },
         "storeStates": {
-          "description": "Output only. The state per store from the specified merchant.",
+          "description": "Output only. The state per store from the specified merchant. The field will be absent if the merchant has no stores submitted through LFP.",
           "items": {
             "$ref": "LfpStoreState"
           },

discovery/merchantapi-reports_v1beta.json

@@ -142,7 +142,7 @@
       }
     }
   },
-  "revision": "20250311",
+  "revision": "20250430",
   "rootUrl": "https://merchantapi.googleapis.com/",
   "schemas": {
     "BestSellersBrandView": {
@@ -1518,7 +1518,7 @@
           "type": "string"
         },
         "query": {
-          "description": "Required. Query that defines a report to be retrieved. For details on how to construct your query, see the Query Language guide. For the full list of available tables and fields, see the Available fields.",
+          "description": "Required. Query that defines a report to be retrieved. For details on how to construct your query, see the [Query Language guide](/merchant/api/guides/reports/query-language). For the full list of available tables and fields, see the [Available fields](/merchant/api/reference/rest/reports_v1beta/accounts.reports).",
           "type": "string"
         }
       },

src/apis/merchantapi/accounts_v1beta.ts

@@ -1030,11 +1030,11 @@ export namespace merchantapi_accounts_v1beta {
    */
   export interface Schema$OnlineReturnPolicy {
     /**
-     * This field specifies if merchant only accepts defective products for returns, and this field is required.
+     * Optional. This field specifies if merchant only accepts defective products for returns.
      */
     acceptDefectiveOnly?: boolean | null;
     /**
-     * This field specifies if merchant allows customers to exchange products, this field is required.
+     * Optional. This field specifies if merchant allows customers to exchange products.
      */
     acceptExchange?: boolean | null;
     /**
@@ -1058,15 +1058,15 @@ export namespace merchantapi_accounts_v1beta {
      */
     policy?: Schema$Policy;
     /**
-     * The field specifies the number of days it takes for merchants to process refunds, field is optional.
+     * Optional. The field specifies the number of days it takes for merchants to process refunds.
      */
     processRefundDays?: number | null;
     /**
      * Optional. The restocking fee that applies to all return reason categories. This would be treated as a free restocking fee if the value is not set.
      */
     restockingFee?: Schema$RestockingFee;
     /**
-     * The field specifies the return label source. This field is required when return method is BY_MAIL.
+     * Optional. The field specifies the return label source.
      */
     returnLabelSource?: string | null;
     /**
@@ -2448,7 +2448,7 @@ export namespace merchantapi_accounts_v1beta {
      */
     pageToken?: string;
     /**
-     * Required. The aggregation service provider. Format: `accounts/{providerId\}`
+     * Required. The aggregation service provider. Format: `accounts/{accountId\}`
      */
     provider?: string;
   }

src/apis/merchantapi/datasources_v1beta.ts

@@ -153,7 +153,7 @@ export namespace merchantapi_datasources_v1beta {
      */
     merchantReviewDataSource?: Schema$MerchantReviewDataSource;
     /**
-     * Identifier. The name of the data source. Format: `accounts/{account\}/dataSources/{datasource\}`
+     * Required. Identifier. The name of the data source. Format: `accounts/{account\}/dataSources/{datasource\}`
      */
     name?: string | null;
     /**
@@ -1145,7 +1145,7 @@ export namespace merchantapi_datasources_v1beta {
   export interface Params$Resource$Accounts$Datasources$Patch
     extends StandardParameters {
     /**
-     * Identifier. The name of the data source. Format: `accounts/{account\}/dataSources/{datasource\}`
+     * Required. Identifier. The name of the data source. Format: `accounts/{account\}/dataSources/{datasource\}`
      */
     name?: string;
     /**

src/apis/merchantapi/lfp_v1beta.ts

@@ -252,7 +252,7 @@ export namespace merchantapi_lfp_v1beta {
      */
     countrySettings?: Schema$CountrySettings[];
     /**
-     * The inventory statistics for the merchant.
+     * The inventory statistics for the merchant. The field will be absent if the merchant has no inventory submitted through LFP.
      */
     inventoryStats?: Schema$InventoryStats;
     /**
@@ -264,7 +264,7 @@ export namespace merchantapi_lfp_v1beta {
      */
     name?: string | null;
     /**
-     * Output only. The state per store from the specified merchant.
+     * Output only. The state per store from the specified merchant. The field will be absent if the merchant has no stores submitted through LFP.
      */
     storeStates?: Schema$LfpStoreState[];
   }

src/apis/merchantapi/reports_v1beta.ts

@@ -1008,7 +1008,7 @@ export namespace merchantapi_reports_v1beta {
      */
     pageToken?: string | null;
     /**
-     * Required. Query that defines a report to be retrieved. For details on how to construct your query, see the Query Language guide. For the full list of available tables and fields, see the Available fields.
+     * Required. Query that defines a report to be retrieved. For details on how to construct your query, see the [Query Language guide](/merchant/api/guides/reports/query-language). For the full list of available tables and fields, see the [Available fields](/merchant/api/reference/rest/reports_v1beta/accounts.reports).
      */
     query?: string | null;
   }