feat: add a ClientContext field to Spanner requests

Google APIs · copybara-github · commit 211d22fa6dfa · 2026-01-07T10:38:21.000-08:00
feat: add Secure Parameters to the ClientContext

PiperOrigin-RevId: 853323071
diff --git a/google/spanner/v1/spanner.proto b/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
