feat: Added a new field ComposeObjectRequest.delete_source_objects field

Google APIs · copybara-github · commit 51ff87f43e89 · 2026-01-29T23:35:50.000-08:00
docs: Updated documentation for `BidiReadObject`, `ReadObjectRequest`, and `ObjectContexts`

PiperOrigin-RevId: 863087065
diff --git a/google/storage/v2/storage.proto b/google/storage/v2/storage.proto
@@ -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.
@@ -410,13 +410,12 @@ service Storage {
 
   // Reads an object's data.
   //
-  // This bi-directional API reads data from an object, allowing you to
-  // request multiple data ranges within a single stream, even across
-  // several messages. If an error occurs with any request, the stream
-  // closes with a relevant error code. Since you can have multiple
-  // outstanding requests, the error response includes a
-  // `BidiReadObjectRangesError` field detailing the specific error for
-  // each pending `read_id`.
+  // This bi-directional API reads data from an object, allowing you to request
+  // multiple data ranges within a single stream, even across several messages.
+  // If an error occurs with any request, the stream closes with a relevant
+  // error code. Since you can have multiple outstanding requests, the error
+  // response includes a `BidiReadObjectError` proto in its `details` field,
+  // reporting the specific error, if any, for each pending `read_id`.
   //
   // **IAM Permissions**:
   //
@@ -883,6 +882,9 @@ message ComposeObjectRequest {
   // the combined checksums of the component objects.
   ObjectChecksums object_checksums = 10
       [(google.api.field_behavior) = OPTIONAL];
+
+  // Whether the source objects should be deleted in the compose request.
+  optional bool delete_source_objects = 11;
 }
 
 // Request message for deleting an object.
@@ -1296,16 +1298,16 @@ message ReadRange {
   // length is 15 bytes, a `ReadObjectRequest` with `read_offset` = -5 and
   // `read_length` = 3 would return bytes 10 through 12 of the object.
   // Requesting a negative offset with magnitude larger than the size of the
-  // object returns the entire object. A `read_offset` larger than the size
-  // of the object results in an `OutOfRange` error.
+  // object is equivalent to `read_offset` = 0. A `read_offset` larger than the
+  // size of the object results in an `OutOfRange` error.
   int64 read_offset = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Optional. The maximum number of data bytes the server is allowed to return
   // across all response messages with the same `read_id`. A `read_length` of
   // zero indicates to read until the resource end, and a negative `read_length`
-  // causes an error. If the stream returns fewer bytes than allowed by the
-  // `read_length` and no error occurred, the stream includes all data from the
-  // `read_offset` to the resource end.
+  // causes an `OutOfRange` error. If the stream returns fewer bytes than
+  // allowed by the `read_length` and no error occurred, the stream includes all
+  // data from the `read_offset` to the resource end.
   int64 read_length = 2 [(google.api.field_behavior) = OPTIONAL];
 
   // Required. Read identifier provided by the client. When the client issues
@@ -2825,6 +2827,9 @@ message ObjectCustomContextPayload {
 // All contexts of an object grouped by type.
 message ObjectContexts {
   // Optional. User-defined object contexts.
+  // The maximum key or value size is `256` characters.
+  // The maximum number of entries is `50`.
+  // The maximum total serialized size of all entries is `25KiB`.
   map<string, ObjectCustomContextPayload> custom = 1
       [(google.api.field_behavior) = OPTIONAL];
 }
