feat: Add new field contexts for Object Contexts in message Object

Google APIs · copybara-github · commit f2a87ff9836e · 2025-07-11T07:17:22.000-07:00
feat: Add new field `filter` for Object Contexts in message `ListObjectsRequest`

PiperOrigin-RevId: 781971065
diff --git a/google/storage/v2/storage.proto b/google/storage/v2/storage.proto
@@ -1504,6 +1504,11 @@ message ListObjectsRequest {
   // Glob](https://cloud.google.com/storage/docs/json_api/v1/objects/list#list-objects-and-prefixes-using-glob)
   // for the full syntax.
   string match_glob = 14 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Filter the returned objects. Currently only supported for the
+  // `contexts` field. If `delimiter` is set, the returned `prefixes` are exempt
+  // from this filter.
+  string filter = 15 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request object for `QueryWriteStatus`.
@@ -2635,6 +2640,27 @@ message ObjectChecksums {
   bytes md5_hash = 2 [(google.api.field_behavior) = OPTIONAL];
 }
 
+// The payload of a single user-defined object context.
+message ObjectCustomContextPayload {
+  // Required. The value of the object context.
+  string value = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Output only. The time at which the object context was created.
+  google.protobuf.Timestamp create_time = 2
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The time at which the object context was last updated.
+  google.protobuf.Timestamp update_time = 3
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+// All contexts of an object grouped by type.
+message ObjectContexts {
+  // Optional. User-defined object contexts.
+  map<string, ObjectCustomContextPayload> custom = 1
+      [(google.api.field_behavior) = OPTIONAL];
+}
+
 // Describes the Customer-Supplied Encryption Key mechanism used to store an
 // Object's data at rest.
 message CustomerEncryption {
@@ -2817,6 +2843,11 @@ message Object {
   // Optional. User-provided metadata, in key/value pairs.
   map<string, string> metadata = 22 [(google.api.field_behavior) = OPTIONAL];
 
+  // Optional. User-defined or system-defined object contexts. Each object
+  // context is a key-payload pair, where the key provides the identification
+  // and the payload holds the associated value and additional metadata.
+  ObjectContexts contexts = 38 [(google.api.field_behavior) = OPTIONAL];
+
   // Whether an object is under event-based hold.
   // An event-based hold is a way to force the retention of an object until
   // after some event occurs. Once the hold is released by explicitly setting
