feat(spanner): update the API

#### spanner:v1

The following keys were added:
- schemas.MultiplexedSessionPrecommitToken.description
- schemas.MultiplexedSessionPrecommitToken.id
- schemas.MultiplexedSessionPrecommitToken.properties.precommitToken.description
- schemas.MultiplexedSessionPrecommitToken.properties.precommitToken.format
- schemas.MultiplexedSessionPrecommitToken.properties.precommitToken.type
- schemas.MultiplexedSessionPrecommitToken.properties.seqNum.description
- schemas.MultiplexedSessionPrecommitToken.properties.seqNum.format
- schemas.MultiplexedSessionPrecommitToken.properties.seqNum.type
- schemas.MultiplexedSessionPrecommitToken.type
- schemas.Transaction.properties.precommitToken.$ref
- schemas.Transaction.properties.precommitToken.description

The following keys were changed:
- endpoints
- schemas.ExecuteSqlRequest.properties.queryMode.enumDescriptions

Author: yoshi-automation

discovery/spanner-v1.json

@@ -27,15 +27,35 @@
       "endpointUrl": "https://spanner.me-central2.rep.googleapis.com/",
       "location": "me-central2"
     },
+    {
+      "description": "Regional Endpoint",
+      "endpointUrl": "https://spanner.us-central1.rep.googleapis.com/",
+      "location": "us-central1"
+    },
     {
       "description": "Regional Endpoint",
       "endpointUrl": "https://spanner.us-east1.rep.googleapis.com/",
       "location": "us-east1"
     },
+    {
+      "description": "Regional Endpoint",
+      "endpointUrl": "https://spanner.us-east4.rep.googleapis.com/",
+      "location": "us-east4"
+    },
+    {
+      "description": "Regional Endpoint",
+      "endpointUrl": "https://spanner.us-east5.rep.googleapis.com/",
+      "location": "us-east5"
+    },
     {
       "description": "Regional Endpoint",
       "endpointUrl": "https://spanner.us-west1.rep.googleapis.com/",
       "location": "us-west1"
+    },
+    {
+      "description": "Regional Endpoint",
+      "endpointUrl": "https://spanner.us-west4.rep.googleapis.com/",
+      "location": "us-west4"
     }
   ],
   "fullyEncodeReservedExpansion": true,
@@ -3264,7 +3284,7 @@
       }
     }
   },
-  "revision": "20240831",
+  "revision": "20240918",
   "rootUrl": "https://spanner.googleapis.com/",
   "schemas": {
     "AutoscalingConfig": {
@@ -4547,7 +4567,7 @@
           "enumDescriptions": [
             "The default mode. Only the statement results are returned.",
             "This mode returns only the query plan, without any results or execution statistics information.",
-            "This mode returns both the query plan and the execution statistics along with the results. This has a performance overhead compared to the NORMAL mode. It is not recommended to use this mode for production traffic."
+            "This mode returns the query plan, overall execution statistics, operator level execution statistics along with the results. This has a performance overhead compared to the other modes. It is not recommended to use this mode for production traffic."
           ],
           "type": "string"
         },
@@ -5647,6 +5667,23 @@
       },
       "type": "object"
     },
+    "MultiplexedSessionPrecommitToken": {
+      "description": "When a read-write transaction is executed on a multiplexed session, this precommit token is sent back to the client as a part of the [Transaction] message in the BeginTransaction response and also as a part of the [ResultSet] and [PartialResultSet] responses.",
+      "id": "MultiplexedSessionPrecommitToken",
+      "properties": {
+        "precommitToken": {
+          "description": "Opaque precommit token.",
+          "format": "byte",
+          "type": "string"
+        },
+        "seqNum": {
+          "description": "An incrementing seq number is generated on every precommit token that is returned. Clients should remember the precommit token with the highest sequence number from the current transaction attempt.",
+          "format": "int32",
+          "type": "integer"
+        }
+      },
+      "type": "object"
+    },
     "Mutation": {
       "description": "A modification to one or more Cloud Spanner rows. Mutations can be applied to a Cloud Spanner database by sending them in a Commit call.",
       "id": "Mutation",
@@ -6790,6 +6827,10 @@
           "format": "byte",
           "type": "string"
         },
+        "precommitToken": {
+          "$ref": "MultiplexedSessionPrecommitToken",
+          "description": "A precommit token will be included in the response of a BeginTransaction request if the read-write transaction is on a multiplexed session and a mutation_key was specified in the BeginTransaction. The precommit token with the highest sequence number from this transaction attempt should be passed to the Commit request for this transaction."
+        },
         "readTimestamp": {
           "description": "For snapshot read-only transactions, the read timestamp chosen for the transaction. Not returned by default: see TransactionOptions.ReadOnly.return_read_timestamp. A timestamp in RFC3339 UTC \\\"Zulu\\\" format, accurate to nanoseconds. Example: `\"2014-10-02T15:01:23.045123456Z\"`.",
           "format": "google-datetime",

src/apis/spanner/v1.ts

@@ -1771,6 +1771,19 @@ export namespace spanner_v1 {
      */
     targetConfig?: string | null;
   }
+  /**
+   * When a read-write transaction is executed on a multiplexed session, this precommit token is sent back to the client as a part of the [Transaction] message in the BeginTransaction response and also as a part of the [ResultSet] and [PartialResultSet] responses.
+   */
+  export interface Schema$MultiplexedSessionPrecommitToken {
+    /**
+     * Opaque precommit token.
+     */
+    precommitToken?: string | null;
+    /**
+     * An incrementing seq number is generated on every precommit token that is returned. Clients should remember the precommit token with the highest sequence number from the current transaction attempt.
+     */
+    seqNum?: number | null;
+  }
   /**
    * A modification to one or more Cloud Spanner rows. Mutations can be applied to a Cloud Spanner database by sending them in a Commit call.
    */
@@ -2572,6 +2585,10 @@ export namespace spanner_v1 {
      * `id` may be used to identify the transaction in subsequent Read, ExecuteSql, Commit, or Rollback calls. Single-use read-only transactions do not have IDs, because single-use transactions do not support multiple requests.
      */
     id?: string | null;
+    /**
+     * A precommit token will be included in the response of a BeginTransaction request if the read-write transaction is on a multiplexed session and a mutation_key was specified in the BeginTransaction. The precommit token with the highest sequence number from this transaction attempt should be passed to the Commit request for this transaction.
+     */
+    precommitToken?: Schema$MultiplexedSessionPrecommitToken;
     /**
      * For snapshot read-only transactions, the read timestamp chosen for the transaction. Not returned by default: see TransactionOptions.ReadOnly.return_read_timestamp. A timestamp in RFC3339 UTC \"Zulu\" format, accurate to nanoseconds. Example: `"2014-10-02T15:01:23.045123456Z"`.
      */