feat(reseller): update the api

#### reseller:v1

The following keys were added:
- resources.subscriptions.methods.insert.parameters.action (Total Keys: 2)
- resources.subscriptions.methods.insert.parameters.sourceSkuId (Total Keys: 2)

Author: yoshi-automation

docs/dyn/reseller_v1.subscriptions.html

@@ -96,7 +96,7 @@ <h2>Instance Methods</h2>
   <code><a href="#get">get(customerId, subscriptionId, x__xgafv=None)</a></code></p>
 <p class="firstline">Gets a specific subscription. The `subscriptionId` can be found using the [Retrieve all reseller subscriptions](/admin-sdk/reseller/v1/how-tos/manage_subscriptions#get_all_subscriptions) method. For more information about retrieving a specific subscription, see the information descrived in [manage subscriptions](/admin-sdk/reseller/v1/how-tos/manage_subscriptions#get_subscription).</p>
 <p class="toc_element">
-  <code><a href="#insert">insert(customerId, body=None, customerAuthToken=None, x__xgafv=None)</a></code></p>
+  <code><a href="#insert">insert(customerId, action=None, body=None, customerAuthToken=None, sourceSkuId=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Creates or transfer a subscription. Create a subscription for a customer's account that you ordered using the [Order a new customer account](/admin-sdk/reseller/v1/reference/customers/insert.html) method. For more information about creating a subscription for different payment plans, see [manage subscriptions](/admin-sdk/reseller/v1/how-tos/manage_subscriptions#create_subscription).\ If you did not order the customer's account using the customer insert method, use the customer's `customerAuthToken` when creating a subscription for that customer. If transferring a G Suite subscription with an associated Google Drive or Google Vault subscription, use the [batch operation](/admin-sdk/reseller/v1/how-tos/batch.html) to transfer all of these subscriptions. For more information, see how to [transfer subscriptions](/admin-sdk/reseller/v1/how-tos/manage_subscriptions#transfer_a_subscription).</p>
 <p class="toc_element">
   <code><a href="#list">list(customerAuthToken=None, customerId=None, customerNamePrefix=None, maxResults=None, pageToken=None, x__xgafv=None)</a></code></p>
@@ -475,7 +475,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="insert">insert(customerId, body=None, customerAuthToken=None, x__xgafv=None)</code>
+    <code class="details" id="insert">insert(customerId, action=None, body=None, customerAuthToken=None, sourceSkuId=None, x__xgafv=None)</code>
   <pre>Creates or transfer a subscription. Create a subscription for a customer&#x27;s account that you ordered using the [Order a new customer account](/admin-sdk/reseller/v1/reference/customers/insert.html) method. For more information about creating a subscription for different payment plans, see [manage subscriptions](/admin-sdk/reseller/v1/how-tos/manage_subscriptions#create_subscription).\ If you did not order the customer&#x27;s account using the customer insert method, use the customer&#x27;s `customerAuthToken` when creating a subscription for that customer. If transferring a G Suite subscription with an associated Google Drive or Google Vault subscription, use the [batch operation](/admin-sdk/reseller/v1/how-tos/batch.html) to transfer all of these subscriptions. For more information, see how to [transfer subscriptions](/admin-sdk/reseller/v1/how-tos/manage_subscriptions#transfer_a_subscription).
 
 Args:
@@ -528,7 +528,13 @@ <h3>Method Details</h3>
   },
 }
 
+  action: string, The intented insert action. The usage of this field is governed by certain policies which are being developed &amp; tested currently. Hence, these might not work as intended. Once this is fully tested &amp; available to consume, we will share more information about its usage, limitations and policy documentation.
+    Allowed values
+      actionUnspecified - Auto determines whether to create new subscription, upgrade or downagrade existing subscription or transfer the existing subscription
+      buy - Create new subscription
+      switch - Switch existing subscription to another sku (upgrade/downgrade)
   customerAuthToken: string, The `customerAuthToken` query string is required when creating a resold account that transfers a direct customer&#x27;s subscription or transfers another reseller customer&#x27;s subscription to your reseller management. This is a hexadecimal authentication token needed to complete the subscription transfer. For more information, see the administrator help center.
+  sourceSkuId: string, The sku_id of the existing subscription to be upgraded or downgraded. This is required when action is SWITCH. The usage of this field is governed by certain policies which are being developed &amp; tested currently. Hence, these might not work as intended. Once this is fully tested &amp; available to consume, we will share more information about its usage, limitations and policy documentation.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format

googleapiclient/discovery_cache/documents/reseller.v1.json

@@ -498,6 +498,21 @@
             "customerId"
           ],
           "parameters": {
+            "action": {
+              "description": "The intented insert action. The usage of this field is governed by certain policies which are being developed & tested currently. Hence, these might not work as intended. Once this is fully tested & available to consume, we will share more information about its usage, limitations and policy documentation.",
+              "enum": [
+                "actionUnspecified",
+                "buy",
+                "switch"
+              ],
+              "enumDescriptions": [
+                "Auto determines whether to create new subscription, upgrade or downagrade existing subscription or transfer the existing subscription",
+                "Create new subscription",
+                "Switch existing subscription to another sku (upgrade/downgrade)"
+              ],
+              "location": "query",
+              "type": "string"
+            },
             "customerAuthToken": {
               "description": "The `customerAuthToken` query string is required when creating a resold account that transfers a direct customer's subscription or transfers another reseller customer's subscription to your reseller management. This is a hexadecimal authentication token needed to complete the subscription transfer. For more information, see the administrator help center.",
               "location": "query",
@@ -508,6 +523,11 @@
               "location": "path",
               "required": true,
               "type": "string"
+            },
+            "sourceSkuId": {
+              "description": "The sku_id of the existing subscription to be upgraded or downgraded. This is required when action is SWITCH. The usage of this field is governed by certain policies which are being developed & tested currently. Hence, these might not work as intended. Once this is fully tested & available to consume, we will share more information about its usage, limitations and policy documentation.",
+              "location": "query",
+              "type": "string"
             }
           },
           "path": "apps/reseller/v1/customers/{customerId}/subscriptions",
@@ -631,7 +651,7 @@
       }
     }
   },
-  "revision": "20230604",
+  "revision": "20230618",
   "rootUrl": "https://reseller.googleapis.com/",
   "schemas": {
     "Address": {