feat: add a ClientContext field to Spanner requests (#2493)

* feat: add a ClientContext field to Spanner requests
feat: add Secure Parameters to the ClientContext

PiperOrigin-RevId: 853323071

Source-Link: googleapis/googleapis@211d22f

Source-Link: googleapis/googleapis-gen@bf515c7
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiYmY1MTVjNzYxYWJiODc1ZDMyNWM1ZDI0MzQ0NGFiMDhiZTBhZWNkNSJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: gcf-owl-bot[bot]

.jsdoc.js

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -40,7 +40,7 @@ module.exports = {
     includePattern: '\\.js$'
   },
   templates: {
-    copyright: 'Copyright 2025 Google LLC',
+    copyright: 'Copyright 2026 Google LLC',
     includeDate: false,
     sourceFiles: false,
     systemName: '@google-cloud/spanner',

protos/google/spanner/v1/spanner.proto

@@ -517,6 +517,15 @@ message RequestOptions {
     PRIORITY_HIGH = 3;
   }
 
+  // Container for various pieces of client-owned context attached to a request.
+  message ClientContext {
+    // Optional. Map of parameter name to value for this request. These values
+    // will be returned by any SECURE_CONTEXT() calls invoked by this request
+    // (e.g., by queries against Parameterized Secure Views).
+    map<string, google.protobuf.Value> secure_context = 1
+        [(google.api.field_behavior) = OPTIONAL];
+  }
+
   // Priority for the request.
   Priority priority = 1;
 
@@ -544,6 +553,9 @@ message RequestOptions {
   // characters. Values that exceed this limit are truncated.
   // Any leading underscore (_) characters are removed from the string.
   string transaction_tag = 3;
+
+  // Optional. Optional context that may be needed for some requests.
+  ClientContext client_context = 4 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // The `DirectedReadOptions` can be used to indicate which replicas or regions