feat(merchantapi): update the api

#### merchantapi:accounts_v1beta

The following keys were added:
- schemas.OnlineReturnPolicy.properties.seasonalOverrides (Total Keys: 2)
- schemas.SeasonalOverride (Total Keys: 6)

Author: yoshi-automation

docs/dyn/merchantapi_accounts_v1beta.accounts.html

@@ -198,7 +198,7 @@ <h3>Method Details</h3>
   &quot;users&quot;: [ # Optional. Users to be added to the account.
     { # Request message for the `CreateUser` method.
       &quot;parent&quot;: &quot;A String&quot;, # Required. The resource name of the account for which a user will be created. Format: `accounts/{account}`
-      &quot;user&quot;: { # 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). # Required. The user to create.
+      &quot;user&quot;: { # 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). # Optional. The user to create.
         &quot;accessRights&quot;: [ # Optional. The [access rights](https://support.google.com/merchants/answer/12160472?sjid=6789834943175119429-EU#accesstypes) the user has.
           &quot;A String&quot;,
         ],

docs/dyn/merchantapi_accounts_v1beta.accounts.onlineReturnPolicies.html

@@ -141,6 +141,25 @@ <h3>Method Details</h3>
     },
     &quot;type&quot;: &quot;A String&quot;, # Required. Type of return shipping fee.
   },
+  &quot;seasonalOverrides&quot;: [ # Optional. Overrides to the general policy for orders placed during a specific set of time intervals.
+    { # Next: 5
+      &quot;begin&quot;: { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Defines the date range when this seasonal override applies. Both begin and end are inclusive and should be in date decimal format, example 20250115. The dates of the seasonal overrides should not overlap.
+        &quot;day&quot;: 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn&#x27;t significant.
+        &quot;month&quot;: 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
+        &quot;year&quot;: 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
+      },
+      &quot;end&quot;: { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. seasonal override end date (inclusive).
+        &quot;day&quot;: 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn&#x27;t significant.
+        &quot;month&quot;: 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
+        &quot;year&quot;: 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
+      },
+      &quot;label&quot;: &quot;A String&quot;, # Required. Display name of this seasonal override in Merchant Center.
+      &quot;policy&quot;: { # The available policies. # Required. The return policy for the given date range.
+        &quot;days&quot;: &quot;A String&quot;, # The number of days items can be returned after delivery, where one day is defined as 24 hours after the delivery timestamp. Required for `NUMBER_OF_DAYS_AFTER_DELIVERY` returns.
+        &quot;type&quot;: &quot;A String&quot;, # Policy type.
+      },
+    },
+  ],
 }</pre>
 </div>
 
@@ -198,6 +217,25 @@ <h3>Method Details</h3>
         },
         &quot;type&quot;: &quot;A String&quot;, # Required. Type of return shipping fee.
       },
+      &quot;seasonalOverrides&quot;: [ # Optional. Overrides to the general policy for orders placed during a specific set of time intervals.
+        { # Next: 5
+          &quot;begin&quot;: { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. Defines the date range when this seasonal override applies. Both begin and end are inclusive and should be in date decimal format, example 20250115. The dates of the seasonal overrides should not overlap.
+            &quot;day&quot;: 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn&#x27;t significant.
+            &quot;month&quot;: 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
+            &quot;year&quot;: 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
+          },
+          &quot;end&quot;: { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Required. seasonal override end date (inclusive).
+            &quot;day&quot;: 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn&#x27;t significant.
+            &quot;month&quot;: 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
+            &quot;year&quot;: 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
+          },
+          &quot;label&quot;: &quot;A String&quot;, # Required. Display name of this seasonal override in Merchant Center.
+          &quot;policy&quot;: { # The available policies. # Required. The return policy for the given date range.
+            &quot;days&quot;: &quot;A String&quot;, # The number of days items can be returned after delivery, where one day is defined as 24 hours after the delivery timestamp. Required for `NUMBER_OF_DAYS_AFTER_DELIVERY` returns.
+            &quot;type&quot;: &quot;A String&quot;, # Policy type.
+          },
+        },
+      ],
     },
   ],
 }</pre>

googleapiclient/discovery_cache/documents/merchantapi.accounts_v1beta.json

@@ -1417,7 +1417,7 @@
 }
 }
 },
-"revision": "20241210",
+"revision": "20250115",
 "rootUrl": "https://merchantapi.googleapis.com/",
 "schemas": {
 "Accepted": {
@@ -1790,7 +1790,7 @@
 },
 "user": {
 "$ref": "User",
-"description": "Required. The user to create."
+"description": "Optional. The user to create."
 },
 "userId": {
 "description": "Required. The email address of the user (for example, `[email protected]`).",
@@ -2493,6 +2493,13 @@ false
 "returnShippingFee": {
 "$ref": "ReturnShippingFee",
 "description": "The return shipping fee. Should be set only when customer need to download and print the return label."
+},
+"seasonalOverrides": {
+"description": "Optional. Overrides to the general policy for orders placed during a specific set of time intervals.",
+"items": {
+"$ref": "SeasonalOverride"
+},
+"type": "array"
 }
 },
 "type": "object"
@@ -3010,6 +3017,29 @@ false
 },
 "type": "object"
 },
+"SeasonalOverride": {
+"description": "Next: 5",
+"id": "SeasonalOverride",
+"properties": {
+"begin": {
+"$ref": "Date",
+"description": "Required. Defines the date range when this seasonal override applies. Both begin and end are inclusive and should be in date decimal format, example 20250115. The dates of the seasonal overrides should not overlap."
+},
+"end": {
+"$ref": "Date",
+"description": "Required. seasonal override end date (inclusive)."
+},
+"label": {
+"description": "Required. Display name of this seasonal override in Merchant Center.",
+"type": "string"
+},
+"policy": {
+"$ref": "Policy",
+"description": "Required. The return policy for the given date range."
+}
+},
+"type": "object"
+},
 "Service": {
 "description": "Shipping service.",
 "id": "Service",