From 21fb8fe8c47dd57d2780a3659251444bcb53ed36 Mon Sep 17 00:00:00 2001 From: Shreyas Sinha Date: Tue, 4 Nov 2025 06:48:20 +0000 Subject: [PATCH 01/26] chore: added crc to upload part --- .../cloud/storage/ChecksumResponseParser.java | 30 ++++++++------ .../model/UploadPartResponse.java | 39 +++++++++++++++++-- 2 files changed, 54 insertions(+), 15 deletions(-) diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/ChecksumResponseParser.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/ChecksumResponseParser.java index 4d32cb42e8..dd430a2f50 100644 --- a/google-cloud-storage/src/main/java/com/google/cloud/storage/ChecksumResponseParser.java +++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/ChecksumResponseParser.java @@ -22,19 +22,21 @@ import java.io.IOException; import java.util.Arrays; import java.util.Collections; +import java.util.List; import java.util.Map; -import java.util.Optional; import java.util.stream.Collectors; -/** A utility class to parse {@link HttpResponse} and create a {@link UploadPartResponse}. */ +/** A utility class to parse checksums from an {@link HttpResponse}. */ final class ChecksumResponseParser { + private static final String X_GOOG_HASH = "x-goog-hash"; + private ChecksumResponseParser() {} static UploadPartResponse parseUploadResponse(HttpResponse response) { String eTag = response.getHeaders().getETag(); Map hashes = extractHashesFromHeader(response); - return UploadPartResponse.builder().eTag(eTag).md5(hashes.get("md5")).build(); + return UploadPartResponse.builder().eTag(eTag).md5(hashes.get("md5")).crc32c(hashes.get("crc32c")).build(); } static CompleteMultipartUploadResponse parseCompleteResponse(HttpResponse response) @@ -52,14 +54,18 @@ static CompleteMultipartUploadResponse parseCompleteResponse(HttpResponse respon } static Map extractHashesFromHeader(HttpResponse response) { - return Optional.ofNullable(response.getHeaders().getFirstHeaderStringValue("x-goog-hash")) - .map( - h -> - Arrays.stream(h.split(",")) - .map(s -> s.trim().split("=", 2)) - .filter(a -> a.length == 2) - .filter(a -> "crc32c".equalsIgnoreCase(a[0]) || "md5".equalsIgnoreCase(a[0])) - .collect(Collectors.toMap(a -> a[0].toLowerCase(), a -> a[1], (v1, v2) -> v1))) - .orElse(Collections.emptyMap()); + List hashHeaders = response.getHeaders().getHeaderStringValues(X_GOOG_HASH); + if (hashHeaders == null || hashHeaders.isEmpty()) { + return Collections.emptyMap(); + } + + return hashHeaders.stream() + .flatMap(h -> Arrays.stream(h.split(","))) + .map(String::trim) + .filter(s -> !s.isEmpty()) + .map(s -> s.split("=", 2)) + .filter(a -> a.length == 2) + .filter(a -> "crc32c".equalsIgnoreCase(a[0]) || "md5".equalsIgnoreCase(a[0])) + .collect(Collectors.toMap(a -> a[0].toLowerCase(), a -> a[1], (v1, v2) -> v1)); } } diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/UploadPartResponse.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/UploadPartResponse.java index 30dc72b0f7..3ea9c0d855 100644 --- a/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/UploadPartResponse.java +++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/UploadPartResponse.java @@ -31,10 +31,12 @@ public final class UploadPartResponse { private final String eTag; private final String md5; + private final String crc32c; private UploadPartResponse(Builder builder) { this.eTag = builder.etag; this.md5 = builder.md5; + this.crc32c = builder.crc32c; } /** @@ -59,6 +61,17 @@ public String md5() { return md5; } + /** + * Returns the CRC32C checksum of the uploaded part. + * + * @return The CRC32C checksum. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public String crc32c() { + return crc32c; + } + @Override public boolean equals(Object o) { if (this == o) { @@ -68,17 +81,23 @@ public boolean equals(Object o) { return false; } UploadPartResponse that = (UploadPartResponse) o; - return Objects.equals(eTag, that.eTag) && Objects.equals(md5, that.md5); + return Objects.equals(eTag, that.eTag) + && Objects.equals(md5, that.md5) + && Objects.equals(crc32c, that.crc32c); } @Override public int hashCode() { - return Objects.hash(eTag, md5); + return Objects.hash(eTag, md5, crc32c); } @Override public String toString() { - return MoreObjects.toStringHelper(this).add("etag", eTag).add("md5", md5).toString(); + return MoreObjects.toStringHelper(this) + .add("etag", eTag) + .add("md5", md5) + .add("crc32c", crc32c) + .toString(); } /** @@ -101,6 +120,7 @@ public static Builder builder() { public static class Builder { private String etag; private String md5; + private String crc32c; private Builder() {} @@ -130,6 +150,19 @@ public Builder md5(String md5) { return this; } + /** + * Sets the CRC32C checksum for the uploaded part. + * + * @param crc32c The CRC32C checksum. + * @return This builder. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public Builder crc32c(String crc32c) { + this.crc32c = crc32c; + return this; + } + /** * Builds the {@code UploadPartResponse} object. * From fa539c0d7aa98615e63b09ad13ee46a07a76b194 Mon Sep 17 00:00:00 2001 From: Shreyas Sinha Date: Wed, 5 Nov 2025 12:50:59 +0000 Subject: [PATCH 02/26] feat: Added API for list all buckets. --- .../cloud/storage/MultipartUploadClient.java | 15 +- .../storage/MultipartUploadClientImpl.java | 10 + .../MultipartUploadHttpRequestManager.java | 41 +- .../model/ListMultipartUploadsRequest.java | 304 +++++++++++ .../model/ListMultipartUploadsResponse.java | 477 ++++++++++++++++++ .../model/MultipartUpload.java | 207 ++++++++ 6 files changed, 1052 insertions(+), 2 deletions(-) create mode 100644 google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsRequest.java create mode 100644 google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsResponse.java create mode 100644 google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/MultipartUpload.java diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadClient.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadClient.java index 09a3af01c5..3044c67651 100644 --- a/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadClient.java +++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadClient.java @@ -24,6 +24,8 @@ import com.google.cloud.storage.multipartupload.model.CompleteMultipartUploadResponse; import com.google.cloud.storage.multipartupload.model.CreateMultipartUploadRequest; import com.google.cloud.storage.multipartupload.model.CreateMultipartUploadResponse; +import com.google.cloud.storage.multipartupload.model.ListMultipartUploadsRequest; +import com.google.cloud.storage.multipartupload.model.ListMultipartUploadsResponse; import com.google.cloud.storage.multipartupload.model.ListPartsRequest; import com.google.cloud.storage.multipartupload.model.ListPartsResponse; import com.google.cloud.storage.multipartupload.model.UploadPartRequest; @@ -100,6 +102,17 @@ public abstract CompleteMultipartUploadResponse completeMultipartUpload( @BetaApi public abstract UploadPartResponse uploadPart(UploadPartRequest request, RequestBody requestBody); + /** + * Lists all multipart uploads in a bucket. + * + * @param request The request object containing the details for listing the multipart uploads. + * @return A {@link ListMultipartUploadsResponse} object containing the list of multipart uploads. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public abstract ListMultipartUploadsResponse listMultipartUploads( + ListMultipartUploadsRequest request); + /** * Creates a new instance of {@link MultipartUploadClient}. * @@ -116,4 +129,4 @@ public static MultipartUploadClient create(MultipartUploadSettings config) { MultipartUploadHttpRequestManager.createFrom(options), options.getRetryAlgorithmManager()); } -} +} \ No newline at end of file diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadClientImpl.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadClientImpl.java index 00b43c6ba9..5c19f8832c 100644 --- a/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadClientImpl.java +++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadClientImpl.java @@ -23,6 +23,8 @@ import com.google.cloud.storage.multipartupload.model.CompleteMultipartUploadResponse; import com.google.cloud.storage.multipartupload.model.CreateMultipartUploadRequest; import com.google.cloud.storage.multipartupload.model.CreateMultipartUploadResponse; +import com.google.cloud.storage.multipartupload.model.ListMultipartUploadsRequest; +import com.google.cloud.storage.multipartupload.model.ListMultipartUploadsResponse; import com.google.cloud.storage.multipartupload.model.ListPartsRequest; import com.google.cloud.storage.multipartupload.model.ListPartsResponse; import com.google.cloud.storage.multipartupload.model.UploadPartRequest; @@ -100,4 +102,12 @@ public UploadPartResponse uploadPart(UploadPartRequest request, RequestBody requ }, Decoder.identity()); } + + @Override + public ListMultipartUploadsResponse listMultipartUploads(ListMultipartUploadsRequest request) { + return retrier.run( + retryAlgorithmManager.idempotent(), + () -> httpRequestManager.sendListMultipartUploadsRequest(uri, request), + Decoder.identity()); + } } diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java index be3a06730a..b5f61e1f7e 100644 --- a/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java +++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java @@ -36,6 +36,8 @@ import com.google.cloud.storage.multipartupload.model.CompleteMultipartUploadResponse; import com.google.cloud.storage.multipartupload.model.CreateMultipartUploadRequest; import com.google.cloud.storage.multipartupload.model.CreateMultipartUploadResponse; +import com.google.cloud.storage.multipartupload.model.ListMultipartUploadsRequest; +import com.google.cloud.storage.multipartupload.model.ListMultipartUploadsResponse; import com.google.cloud.storage.multipartupload.model.ListPartsRequest; import com.google.cloud.storage.multipartupload.model.ListPartsResponse; import com.google.cloud.storage.multipartupload.model.UploadPartRequest; @@ -111,6 +113,43 @@ ListPartsResponse sendListPartsRequest(URI uri, ListPartsRequest request) throws return httpRequest.execute().parseAs(ListPartsResponse.class); } + ListMultipartUploadsResponse sendListMultipartUploadsRequest( + URI uri, ListMultipartUploadsRequest request) throws IOException { + + ImmutableMap.Builder params = + ImmutableMap.builder() + .put("bucket", request.bucket()); + if(request.delimiter() != null){ + params.put("delimiter", request.delimiter()); + } + if(request.encodingType() != null){ + params.put("encoding-type", request.encodingType()); + } + if(request.keyMarker() != null){ + params.put("key-marker", request.keyMarker()); + } + if(request.maxUploads() != null){ + params.put("max-uploads", request.maxUploads()); + } + if(request.prefix() != null){ + params.put("prefix", request.prefix()); + } + if(request.uploadIdMarker() != null){ + params.put("upload-id-marker", request.uploadIdMarker()); + } + String listUri = + UriTemplate.expand( + uri.toString() + "{bucket}?uploads{delimiter,encoding-type,key-marker,max-uploads,prefix,upload-id-marker}", + params, + false); + System.out.println(listUri); + HttpRequest httpRequest = requestFactory.buildGetRequest(new GenericUrl(listUri)); + httpRequest.getHeaders().putAll(headerProvider.getHeaders()); + httpRequest.setParser(objectParser); + httpRequest.setThrowExceptionOnExecuteError(true); + return httpRequest.execute().parseAs(ListMultipartUploadsResponse.class); + } + AbortMultipartUploadResponse sendAbortMultipartUploadRequest( URI uri, AbortMultipartUploadRequest request) throws IOException { @@ -248,7 +287,7 @@ private static String urlEncode(String value) { */ private static String formatName(String name) { // Only lowercase letters, digits, and "-" are allowed - return name.toLowerCase().replaceAll("[^\\w\\d\\-]", "-"); + return name.toLowerCase().replaceAll("[^\\w-]", "-"); } private static String formatSemver(String version) { diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsRequest.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsRequest.java new file mode 100644 index 0000000000..51c814507b --- /dev/null +++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsRequest.java @@ -0,0 +1,304 @@ +/* + * Copyright 2025 Google LLC + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.google.cloud.storage.multipartupload.model; + +import com.google.api.core.BetaApi; +import java.util.Objects; + +/** + * A request to list all multipart uploads in a bucket. + * + * @see Listing + * multipart uploads + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ +@BetaApi +public final class ListMultipartUploadsRequest { + + private final String bucket; + private final String delimiter; + private final String encodingType; + private final String keyMarker; + private final Integer maxUploads; + private final String prefix; + private final String uploadIdMarker; + + private ListMultipartUploadsRequest( + String bucket, + String delimiter, + String encodingType, + String keyMarker, + Integer maxUploads, + String prefix, + String uploadIdMarker) { + this.bucket = bucket; + this.delimiter = delimiter; + this.encodingType = encodingType; + this.keyMarker = keyMarker; + this.maxUploads = maxUploads; + this.prefix = prefix; + this.uploadIdMarker = uploadIdMarker; + } + + /** + * The bucket to list multipart uploads from. + * + * @return The bucket name. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public String bucket() { + return bucket; + } + + /** + * Character used to group keys. + * + * @return The delimiter. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public String delimiter() { + return delimiter; + } + + /** + * The encoding type used by Cloud Storage to encode object names in the response. + * + * @return The encoding type. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public String encodingType() { + return encodingType; + } + + /** + * Together with {@code upload-id-marker}, specifies the multipart upload after which listing + * should begin. + * + * @return The key marker. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public String keyMarker() { + return keyMarker; + } + + /** + * The maximum number of multipart uploads to return. + * + * @return The maximum number of uploads. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public Integer maxUploads() { + return maxUploads; + } + + /** + * Filters results to multipart uploads whose keys begin with this prefix. + * + * @return The prefix. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public String prefix() { + return prefix; + } + + /** + * Together with {@code key-marker}, specifies the multipart upload after which listing should + * begin. + * + * @return The upload ID marker. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public String uploadIdMarker() { + return uploadIdMarker; + } + + @Override + public boolean equals(Object o) { + if (this == o) { + return true; + } + if (o == null || getClass() != o.getClass()) { + return false; + } + ListMultipartUploadsRequest that = (ListMultipartUploadsRequest) o; + return Objects.equals(bucket, that.bucket) + && Objects.equals(delimiter, that.delimiter) + && Objects.equals(encodingType, that.encodingType) + && Objects.equals(keyMarker, that.keyMarker) + && Objects.equals(maxUploads, that.maxUploads) + && Objects.equals(prefix, that.prefix) + && Objects.equals(uploadIdMarker, that.uploadIdMarker); + } + + @Override + public int hashCode() { + return Objects.hash(bucket, delimiter, encodingType, keyMarker, maxUploads, prefix, uploadIdMarker); + } + + @Override + public String toString() { + StringBuilder sb = new StringBuilder("ListMultipartUploadsRequest{"); + sb.append("bucket='").append(bucket).append("'"); + sb.append(", delimiter='").append(delimiter).append("'"); + sb.append(", encodingType='").append(encodingType).append(","); + sb.append(", keyMarker='").append(keyMarker).append(","); + sb.append(", maxUploads=").append(maxUploads); + sb.append(", prefix='").append(prefix).append(","); + sb.append(", uploadIdMarker='").append(uploadIdMarker).append(","); + sb.append('}'); + return sb.toString(); + } + + /** + * Returns a new builder for this request. + * + * @return A new builder. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public static Builder builder() { + return new Builder(); + } + + /** + * A builder for {@link ListMultipartUploadsRequest}. + * + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public static final class Builder { + private String bucket; + private String delimiter; + private String encodingType; + private String keyMarker; + private Integer maxUploads; + private String prefix; + private String uploadIdMarker; + + private Builder() {} + + /** + * Sets the bucket to list multipart uploads from. + * + * @param bucket The bucket name. + * @return This builder. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public Builder bucket(String bucket) { + this.bucket = bucket; + return this; + } + + /** + * Sets the delimiter used to group keys. + * + * @param delimiter The delimiter. + * @return This builder. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public Builder delimiter(String delimiter) { + this.delimiter = delimiter; + return this; + } + + /** + * Sets the encoding type used by Cloud Storage to encode object names in the response. + * + * @param encodingType The encoding type. + * @return This builder. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public Builder encodingType(String encodingType) { + this.encodingType = encodingType; + return this; + } + + /** + * Sets the key marker. + * + * @param keyMarker The key marker. + * @return This builder. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public Builder keyMarker(String keyMarker) { + this.keyMarker = keyMarker; + return this; + } + + /** + * Sets the maximum number of multipart uploads to return. + * + * @param maxUploads The maximum number of uploads. + * @return This builder. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public Builder maxUploads(Integer maxUploads) { + this.maxUploads = maxUploads; + return this; + } + + /** + * Sets the prefix to filter results. + * + * @param prefix The prefix. + * @return This builder. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public Builder prefix(String prefix) { + this.prefix = prefix; + return this; + } + + /** + * Sets the upload ID marker. + * + * @param uploadIdMarker The upload ID marker. + * @return This builder. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public Builder uploadIdMarker(String uploadIdMarker) { + this.uploadIdMarker = uploadIdMarker; + return this; + } + + /** + * Builds the request. + * + * @return The built request. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public ListMultipartUploadsRequest build() { + return new ListMultipartUploadsRequest( + bucket, delimiter, encodingType, keyMarker, maxUploads, prefix, uploadIdMarker); + } + } +} diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsResponse.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsResponse.java new file mode 100644 index 0000000000..9e151c5df3 --- /dev/null +++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsResponse.java @@ -0,0 +1,477 @@ +/* + * Copyright 2025 Google LLC + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.google.cloud.storage.multipartupload.model; + +import com.google.api.core.BetaApi; +import com.google.common.collect.ImmutableList; +import java.util.Objects; + +/** + * A response from listing all multipart uploads in a bucket. + * + * @see Listing + * multipart uploads + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ +@BetaApi +public final class ListMultipartUploadsResponse { + + private ImmutableList uploads; + private String bucket; + private String delimiter; + private String encodingType; + private String keyMarker; + private String uploadIdMarker; + private String nextKeyMarker; + private String nextUploadIdMarker; + private int maxUploads; + private String prefix; + private boolean isTruncated; + private ImmutableList commonPrefixes; + + private ListMultipartUploadsResponse( + ImmutableList uploads, + String bucket, + String delimiter, + String encodingType, + String keyMarker, + String uploadIdMarker, + String nextKeyMarker, + String nextUploadIdMarker, + int maxUploads, + String prefix, + boolean isTruncated, + ImmutableList commonPrefixes) { + this.uploads = uploads; + this.bucket = bucket; + this.delimiter = delimiter; + this.encodingType = encodingType; + this.keyMarker = keyMarker; + this.uploadIdMarker = uploadIdMarker; + this.nextKeyMarker = nextKeyMarker; + this.nextUploadIdMarker = nextUploadIdMarker; + this.maxUploads = maxUploads; + this.prefix = prefix; + this.isTruncated = isTruncated; + this.commonPrefixes = commonPrefixes; + } + + private ListMultipartUploadsResponse() {} + + /** + * The list of multipart uploads. + * + * @return The list of multipart uploads. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public ImmutableList getUploads() { + return uploads; + } + + /** + * The bucket that contains the multipart uploads. + * + * @return The bucket name. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public String getBucket() { + return bucket; + } + + /** + * The delimiter applied to the request. + * + * @return The delimiter applied to the request. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public String getDelimiter() { + return delimiter; + } + + /** + * The encoding type used by Cloud Storage to encode object names in the response. + * + * @return The encoding type. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public String getEncodingType() { + return encodingType; + } + + /** + * The key at or after which the listing began. + * + * @return The key marker. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public String getKeyMarker() { + return keyMarker; + } + + /** + * The upload ID at or after which the listing began. + * + * @return The upload ID marker. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public String getUploadIdMarker() { + return uploadIdMarker; + } + + /** + * The key after which listing should begin. + * + * @return The key after which listing should begin. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public String getNextKeyMarker() { + return nextKeyMarker; + } + + /** + * The upload ID after which listing should begin. + * + * @return The upload ID after which listing should begin. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public String getNextUploadIdMarker() { + return nextUploadIdMarker; + } + + /** + * The maximum number of uploads to return. + * + * @return The maximum number of uploads. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public int getMaxUploads() { + return maxUploads; + } + + /** + * The prefix applied to the request. + * + * @return The prefix applied to the request. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public String getPrefix() { + return prefix; + } + + /** + * A flag indicating whether or not the returned results are truncated. + * + * @return A flag indicating whether or not the returned results are truncated. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public boolean isTruncated() { + return isTruncated; + } + + /** + * If you specify a delimiter in the request, this element is returned. + * + * @return The common prefixes. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public ImmutableList getCommonPrefixes() { + return commonPrefixes; + } + + @Override + public boolean equals(Object o) { + if (this == o) { + return true; + } + if (o == null || getClass() != o.getClass()) { + return false; + } + ListMultipartUploadsResponse that = (ListMultipartUploadsResponse) o; + return isTruncated == that.isTruncated + && maxUploads == that.maxUploads + && Objects.equals(uploads, that.uploads) + && Objects.equals(bucket, that.bucket) + && Objects.equals(delimiter, that.delimiter) + && Objects.equals(encodingType, that.encodingType) + && Objects.equals(keyMarker, that.keyMarker) + && Objects.equals(uploadIdMarker, that.uploadIdMarker) + && Objects.equals(nextKeyMarker, that.nextKeyMarker) + && Objects.equals(nextUploadIdMarker, that.nextUploadIdMarker) + && Objects.equals(prefix, that.prefix) + && Objects.equals(commonPrefixes, that.commonPrefixes); + } + + @Override + public int hashCode() { + return Objects.hash( + uploads, + bucket, + delimiter, + encodingType, + keyMarker, + uploadIdMarker, + nextKeyMarker, + nextUploadIdMarker, + maxUploads, + prefix, + isTruncated, + commonPrefixes); + } + + @Override + public String toString() { + return "ListMultipartUploadsResponse{" + + "uploads=" + uploads + + ", bucket='" + bucket + "'" + + ", delimiter='" + delimiter + "'" + + ", encodingType='" + encodingType + "'" + + ", keyMarker='" + keyMarker + "'" + + ", uploadIdMarker='" + uploadIdMarker + "'" + + ", nextKeyMarker='" + nextKeyMarker + "'" + + ", nextUploadIdMarker='" + nextUploadIdMarker + "'" + + ", maxUploads=" + maxUploads + + ", prefix='" + prefix + "'" + + ", isTruncated=" + isTruncated + + ", commonPrefixes=" + commonPrefixes + + '}'; + } + + /** + * Returns a new builder for this response. + * + * @return A new builder. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public static Builder builder() { + return new Builder(); + } + + /** + * A builder for {@link ListMultipartUploadsResponse}. + * + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public static final class Builder { + private ImmutableList uploads; + private String bucket; + private String delimiter; + private String encodingType; + private String keyMarker; + private String uploadIdMarker; + private String nextKeyMarker; + private String nextUploadIdMarker; + private int maxUploads; + private String prefix; + private boolean isTruncated; + private ImmutableList commonPrefixes; + + private Builder() {} + + /** + * Sets the list of multipart uploads. + * + * @param uploads The list of multipart uploads. + * @return This builder. + * @since 2.60.0 This new api is in preview. + */ + @BetaApi + public Builder setUploads(ImmutableList uploads) { + this.uploads = uploads; + return this; + } + + /** + * Sets the bucket that contains the multipart uploads. + * + * @param bucket The bucket name. + * @return This builder. + * @since 2.60.0 This new api is in preview. + */ + @BetaApi + public Builder setBucket(String bucket) { + this.bucket = bucket; + return this; + } + + /** + * Sets the delimiter applied to the request. + * + * @param delimiter The delimiter applied to the request. + * @return This builder. + * @since 2.60.0 This new api is in preview. + */ + @BetaApi + public Builder setDelimiter(String delimiter) { + this.delimiter = delimiter; + return this; + } + + /** + * Sets the encoding type used by Cloud Storage to encode object names in the response. + * + * @param encodingType The encoding type. + * @return This builder. + * @since 2.60.0 This new api is in preview. + */ + @BetaApi + public Builder setEncodingType(String encodingType) { + this.encodingType = encodingType; + return this; + } + + /** + * Sets the key at or after which the listing began. + * + * @param keyMarker The key marker. + * @return This builder. + * @since 2.60.0 This new api is in preview. + */ + @BetaApi + public Builder setKeyMarker(String keyMarker) { + this.keyMarker = keyMarker; + return this; + } + + /** + * Sets the upload ID at or after which the listing began. + * + * @param uploadIdMarker The upload ID marker. + * @return This builder. + * @since 2.60.0 This new api is in preview. + */ + @BetaApi + public Builder setUploadIdMarker(String uploadIdMarker) { + this.uploadIdMarker = uploadIdMarker; + return this; + } + + /** + * Sets the key after which listing should begin. + * + * @param nextKeyMarker The key after which listing should begin. + * @return This builder. + * @since 2.60.0 This new api is in preview. + */ + @BetaApi + public Builder setNextKeyMarker(String nextKeyMarker) { + this.nextKeyMarker = nextKeyMarker; + return this; + } + + /** + * Sets the upload ID after which listing should begin. + * + * @param nextUploadIdMarker The upload ID after which listing should begin. + * @return This builder. + * @since 2.60.0 This new api is in preview. + */ + @BetaApi + public Builder setNextUploadIdMarker(String nextUploadIdMarker) { + this.nextUploadIdMarker = nextUploadIdMarker; + return this; + } + + /** + * Sets the maximum number of uploads to return. + * + * @param maxUploads The maximum number of uploads. + * @return This builder. + * @since 2.60.0 This new api is in preview. + */ + @BetaApi + public Builder setMaxUploads(int maxUploads) { + this.maxUploads = maxUploads; + return this; + } + + /** + * Sets the prefix applied to the request. + * + * @param prefix The prefix applied to the request. + * @return This builder. + * @since 2.60.0 This new api is in preview. + */ + @BetaApi + public Builder setPrefix(String prefix) { + this.prefix = prefix; + return this; + } + + /** + * Sets the flag indicating whether or not the returned results are truncated. + * + * @param isTruncated The flag indicating whether or not the returned results are truncated. + * @return This builder. + * @since 2.60.0 This new api is in preview. + */ + @BetaApi + public Builder setTruncated(boolean isTruncated) { + this.isTruncated = isTruncated; + return this; + } + + /** + * If you specify a delimiter in the request, this element is returned. + * + * @param commonPrefixes The common prefixes. + * @return This builder. + * @since 2.60.0 This new api is in preview. + */ + @BetaApi + public Builder setCommonPrefixes(ImmutableList commonPrefixes) { + this.commonPrefixes = commonPrefixes; + return this; + } + + /** + * Builds the response. + * + * @return The built response. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public ListMultipartUploadsResponse build() { + return new ListMultipartUploadsResponse( + uploads, + bucket, + delimiter, + encodingType, + keyMarker, + uploadIdMarker, + nextKeyMarker, + nextUploadIdMarker, + maxUploads, + prefix, + isTruncated, + commonPrefixes); + } + } +} diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/MultipartUpload.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/MultipartUpload.java new file mode 100644 index 0000000000..a32619f9a4 --- /dev/null +++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/MultipartUpload.java @@ -0,0 +1,207 @@ +/* + * Copyright 2025 Google LLC + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.google.cloud.storage.multipartupload.model; + +import com.google.api.core.BetaApi; +import com.google.cloud.storage.StorageClass; +import java.time.OffsetDateTime; +import java.util.Objects; + +/** + * Represents a multipart upload that is in progress. + * + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ +@BetaApi +public final class MultipartUpload { + + private final String key; + private final String uploadId; + private final StorageClass storageClass; + private final OffsetDateTime initiated; + + private MultipartUpload( + String key, String uploadId, StorageClass storageClass, OffsetDateTime initiated) { + this.key = key; + this.uploadId = uploadId; + this.storageClass = storageClass; + this.initiated = initiated; + } + + /** + * The object name for which the multipart upload was initiated. + * + * @return The object name. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public String getKey() { + return key; + } + + /** + * The ID of the multipart upload. + * + * @return The upload ID. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public String getUploadId() { + return uploadId; + } + + /** + * The storage class of the object. + * + * @return The storage class. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public StorageClass getStorageClass() { + return storageClass; + } + + /** + * The date and time at which the multipart upload was initiated. + * + * @return The initiation date and time. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public OffsetDateTime getInitiated() { + return initiated; + } + + @Override + public boolean equals(Object o) { + if (this == o) { + return true; + } + if (o == null || getClass() != o.getClass()) { + return false; + } + MultipartUpload that = (MultipartUpload) o; + return Objects.equals(key, that.key) + && Objects.equals(uploadId, that.uploadId) + && Objects.equals(storageClass, that.storageClass) + && Objects.equals(initiated, that.initiated); + } + + @Override + public int hashCode() { + return Objects.hash(key, uploadId, storageClass, initiated); + } + + @Override + public String toString() { + return "MultipartUpload{" + + "key='" + key + '\'' + + ", uploadId='" + uploadId + '\'' + + ", storageClass=" + storageClass + + ", initiated=" + initiated + + "}"; + } + + /** + * Returns a new builder for this multipart upload. + * + * @return A new builder. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public static Builder newBuilder() { + return new Builder(); + } + + /** + * A builder for {@link MultipartUpload}. + * + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public static final class Builder { + private String key; + private String uploadId; + private StorageClass storageClass; + private OffsetDateTime initiated; + + private Builder() {} + + /** + * Sets the object name for which the multipart upload was initiated. + * + * @param key The object name. + * @return This builder. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public Builder setKey(String key) { + this.key = key; + return this; + } + + /** + * Sets the ID of the multipart upload. + * + * @param uploadId The upload ID. + * @return This builder. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public Builder setUploadId(String uploadId) { + this.uploadId = uploadId; + return this; + } + + /** + * Sets the storage class of the object. + * + * @param storageClass The storage class. + * @return This builder. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public Builder setStorageClass(StorageClass storageClass) { + this.storageClass = storageClass; + return this; + } + + /** + * Sets the date and time at which the multipart upload was initiated. + * + * @param initiated The initiation date and time. + * @return This builder. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public Builder setInitiated(OffsetDateTime initiated) { + this.initiated = initiated; + return this; + } + + /** + * Builds the multipart upload. + * + * @return The built multipart upload. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ + @BetaApi + public MultipartUpload build() { + return new MultipartUpload(key, uploadId, storageClass, initiated); + } + } +} From f6b31d3753a39baa0a1be85e602a77d612018c47 Mon Sep 17 00:00:00 2001 From: Dhriti Chopra Date: Wed, 12 Nov 2025 11:46:20 +0530 Subject: [PATCH 03/26] chore: Adding fixes and tests for ListMultipartUpload --- .../MultipartUploadHttpRequestManager.java | 2 +- .../model/ListMultipartUploadsResponse.java | 102 ++++++++++++------ .../model/MultipartUpload.java | 20 +++- ...MultipartUploadHttpRequestManagerTest.java | 85 +++++++++++++++ 4 files changed, 168 insertions(+), 41 deletions(-) diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java index b5f61e1f7e..21f00deda8 100644 --- a/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java +++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java @@ -140,7 +140,7 @@ ListMultipartUploadsResponse sendListMultipartUploadsRequest( String listUri = UriTemplate.expand( uri.toString() + "{bucket}?uploads{delimiter,encoding-type,key-marker,max-uploads,prefix,upload-id-marker}", - params, + params.build(), false); System.out.println(listUri); HttpRequest httpRequest = requestFactory.buildGetRequest(new GenericUrl(listUri)); diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsResponse.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsResponse.java index 9e151c5df3..e6eec82849 100644 --- a/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsResponse.java +++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsResponse.java @@ -5,7 +5,7 @@ * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * - * http://www.apache.org/licenses/LICENSE-2.0 + * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, @@ -16,35 +16,69 @@ package com.google.cloud.storage.multipartupload.model; +import com.fasterxml.jackson.annotation.JsonAlias; +import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlElementWrapper; +import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlProperty; import com.google.api.core.BetaApi; import com.google.common.collect.ImmutableList; +import java.util.ArrayList; +import java.util.List; import java.util.Objects; /** * A response from listing all multipart uploads in a bucket. * * @see Listing - * multipart uploads - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * multipart uploads + * @since 2.60.1 This new api is in preview and is subject to breaking changes. */ @BetaApi public final class ListMultipartUploadsResponse { - private ImmutableList uploads; + @JacksonXmlElementWrapper(useWrapping = false) + @JacksonXmlProperty(localName = "Upload") + private List uploads; + + @JacksonXmlProperty(localName = "Bucket") private String bucket; + + @JacksonXmlProperty(localName = "Delimiter") private String delimiter; + + @JacksonXmlProperty(localName = "EncodingType") private String encodingType; + + @JacksonXmlProperty(localName = "KeyMarker") private String keyMarker; + + @JacksonXmlProperty(localName = "UploadIdMarker") private String uploadIdMarker; + + @JacksonXmlProperty(localName = "NextKeyMarker") private String nextKeyMarker; + + @JacksonXmlProperty(localName = "NextUploadIdMarker") private String nextUploadIdMarker; + + @JacksonXmlProperty(localName = "MaxUploads") private int maxUploads; + + @JacksonXmlProperty(localName = "Prefix") private String prefix; + + @JsonAlias("truncated") + @JacksonXmlProperty(localName = "IsTruncated") private boolean isTruncated; - private ImmutableList commonPrefixes; + + @JacksonXmlElementWrapper(useWrapping = false) + @JacksonXmlProperty(localName = "CommonPrefixes") + private List commonPrefixes; + + // Jackson requires a no-arg constructor + private ListMultipartUploadsResponse() {} private ListMultipartUploadsResponse( - ImmutableList uploads, + List uploads, String bucket, String delimiter, String encodingType, @@ -55,7 +89,7 @@ private ListMultipartUploadsResponse( int maxUploads, String prefix, boolean isTruncated, - ImmutableList commonPrefixes) { + List commonPrefixes) { this.uploads = uploads; this.bucket = bucket; this.delimiter = delimiter; @@ -67,28 +101,21 @@ private ListMultipartUploadsResponse( this.maxUploads = maxUploads; this.prefix = prefix; this.isTruncated = isTruncated; - this.commonPrefixes = commonPrefixes; + if (commonPrefixes != null) { + this.commonPrefixes = new ArrayList<>(); + for (String p : commonPrefixes) { + CommonPrefixHelper h = new CommonPrefixHelper(); + h.prefix = p; + this.commonPrefixes.add(h); + } + } } - private ListMultipartUploadsResponse() {} - - /** - * The list of multipart uploads. - * - * @return The list of multipart uploads. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. - */ @BetaApi public ImmutableList getUploads() { - return uploads; + return uploads == null ? ImmutableList.of() : ImmutableList.copyOf(uploads); } - /** - * The bucket that contains the multipart uploads. - * - * @return The bucket name. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. - */ @BetaApi public String getBucket() { return bucket; @@ -201,7 +228,12 @@ public boolean isTruncated() { */ @BetaApi public ImmutableList getCommonPrefixes() { - return commonPrefixes; + if (commonPrefixes == null) { + return ImmutableList.of(); + } + return commonPrefixes.stream() + .map(h -> h.prefix) + .collect(ImmutableList.toImmutableList()); } @Override @@ -215,7 +247,7 @@ public boolean equals(Object o) { ListMultipartUploadsResponse that = (ListMultipartUploadsResponse) o; return isTruncated == that.isTruncated && maxUploads == that.maxUploads - && Objects.equals(uploads, that.uploads) + && Objects.equals(getUploads(), that.getUploads()) && Objects.equals(bucket, that.bucket) && Objects.equals(delimiter, that.delimiter) && Objects.equals(encodingType, that.encodingType) @@ -224,13 +256,13 @@ public boolean equals(Object o) { && Objects.equals(nextKeyMarker, that.nextKeyMarker) && Objects.equals(nextUploadIdMarker, that.nextUploadIdMarker) && Objects.equals(prefix, that.prefix) - && Objects.equals(commonPrefixes, that.commonPrefixes); + && Objects.equals(getCommonPrefixes(), that.getCommonPrefixes()); } @Override public int hashCode() { return Objects.hash( - uploads, + getUploads(), bucket, delimiter, encodingType, @@ -241,13 +273,13 @@ public int hashCode() { maxUploads, prefix, isTruncated, - commonPrefixes); + getCommonPrefixes()); } @Override public String toString() { return "ListMultipartUploadsResponse{" + - "uploads=" + uploads + + "uploads=" + getUploads() + ", bucket='" + bucket + "'" + ", delimiter='" + delimiter + "'" + ", encodingType='" + encodingType + "'" + @@ -258,7 +290,7 @@ public String toString() { ", maxUploads=" + maxUploads + ", prefix='" + prefix + "'" + ", isTruncated=" + isTruncated + - ", commonPrefixes=" + commonPrefixes + + ", commonPrefixes=" + getCommonPrefixes() + '}'; } @@ -273,11 +305,11 @@ public static Builder builder() { return new Builder(); } - /** - * A builder for {@link ListMultipartUploadsResponse}. - * - * @since 2.60.0 This new api is in preview and is subject to breaking changes. - */ + public static class CommonPrefixHelper { + @JacksonXmlProperty(localName = "Prefix") + public String prefix; + } + @BetaApi public static final class Builder { private ImmutableList uploads; diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/MultipartUpload.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/MultipartUpload.java index a32619f9a4..7fee6a9528 100644 --- a/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/MultipartUpload.java +++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/MultipartUpload.java @@ -5,7 +5,7 @@ * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * - * http://www.apache.org/licenses/LICENSE-2.0 + * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, @@ -16,6 +16,7 @@ package com.google.cloud.storage.multipartupload.model; +import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlProperty; import com.google.api.core.BetaApi; import com.google.cloud.storage.StorageClass; import java.time.OffsetDateTime; @@ -29,10 +30,19 @@ @BetaApi public final class MultipartUpload { - private final String key; - private final String uploadId; - private final StorageClass storageClass; - private final OffsetDateTime initiated; + @JacksonXmlProperty(localName = "Key") + private String key; + + @JacksonXmlProperty(localName = "UploadId") + private String uploadId; + + @JacksonXmlProperty(localName = "StorageClass") + private StorageClass storageClass; + + @JacksonXmlProperty(localName = "Initiated") + private OffsetDateTime initiated; + + private MultipartUpload() {} private MultipartUpload( String key, String uploadId, StorageClass storageClass, OffsetDateTime initiated) { diff --git a/google-cloud-storage/src/test/java/com/google/cloud/storage/ITMultipartUploadHttpRequestManagerTest.java b/google-cloud-storage/src/test/java/com/google/cloud/storage/ITMultipartUploadHttpRequestManagerTest.java index 0b7acdbd47..e17c517e95 100644 --- a/google-cloud-storage/src/test/java/com/google/cloud/storage/ITMultipartUploadHttpRequestManagerTest.java +++ b/google-cloud-storage/src/test/java/com/google/cloud/storage/ITMultipartUploadHttpRequestManagerTest.java @@ -38,8 +38,11 @@ import com.google.cloud.storage.multipartupload.model.CompletedPart; import com.google.cloud.storage.multipartupload.model.CreateMultipartUploadRequest; import com.google.cloud.storage.multipartupload.model.CreateMultipartUploadResponse; +import com.google.cloud.storage.multipartupload.model.ListMultipartUploadsRequest; +import com.google.cloud.storage.multipartupload.model.ListMultipartUploadsResponse; import com.google.cloud.storage.multipartupload.model.ListPartsRequest; import com.google.cloud.storage.multipartupload.model.ListPartsResponse; +import com.google.cloud.storage.multipartupload.model.MultipartUpload; import com.google.cloud.storage.multipartupload.model.ObjectLockMode; import com.google.cloud.storage.multipartupload.model.Part; import com.google.cloud.storage.multipartupload.model.UploadPartRequest; @@ -840,4 +843,86 @@ public void sendUploadPartRequest_error() throws Exception { endpoint, request, RewindableContent.empty())); } } + +@Test +public void sendListMultipartUploadsRequest_success() throws Exception { + String mockXmlResponse = + "" + + " test-bucket" + + " key-marker" + + " upload-id-marker" + + " next-key-marker" + + " next-upload-id-marker" + + " 1" + + " false" + + " " + + " test-key" + + " test-upload-id" + + " STANDARD" + + " 2025-11-11T00:00:00Z" + + " " + + ""; + + HttpRequestHandler handler = + req -> { + ByteBuf buf = Unpooled.wrappedBuffer(mockXmlResponse.getBytes(StandardCharsets.UTF_8)); + + DefaultFullHttpResponse resp = + new DefaultFullHttpResponse(req.protocolVersion(), OK, buf); + + resp.headers().set("Content-Type", "application/xml; charset=utf-8"); + resp.headers().set("Content-Length", resp.content().readableBytes()); + return resp; + }; + + try (FakeHttpServer fakeHttpServer = FakeHttpServer.of(handler)) { + URI endpoint = URI.create(fakeHttpServer.getEndpoint() + "/"); + + ListMultipartUploadsRequest request = + ListMultipartUploadsRequest.builder() + .bucket("test-bucket") + .maxUploads(1) + .keyMarker("key-marker") + .uploadIdMarker("upload-id-marker") + .build(); + + ListMultipartUploadsResponse response = + multipartUploadHttpRequestManager.sendListMultipartUploadsRequest(endpoint, request); + + assertThat(response).isNotNull(); + assertThat(response.getBucket()).isEqualTo("test-bucket"); + assertThat(response.getUploads()).hasSize(1); + + MultipartUpload upload = response.getUploads().get(0); + assertThat(upload.getKey()).isEqualTo("test-key"); + assertThat(upload.getStorageClass()).isEqualTo(StorageClass.STANDARD); + assertThat(upload.getInitiated()) + .isEqualTo(OffsetDateTime.of(2025, 11, 11, 0, 0, 0, 0, ZoneOffset.UTC)); + } +} + + @Test + public void sendListMultipartUploadsRequest_error() throws Exception { + HttpRequestHandler handler = + req -> { + FullHttpResponse resp = + new DefaultFullHttpResponse(req.protocolVersion(), HttpResponseStatus.BAD_REQUEST); + resp.headers().set(CONTENT_TYPE, "text/plain; charset=utf-8"); + return resp; + }; + + try (FakeHttpServer fakeHttpServer = FakeHttpServer.of(handler)) { + URI endpoint = URI.create(fakeHttpServer.getEndpoint() + "/"); + ListMultipartUploadsRequest request = + ListMultipartUploadsRequest.builder() + .bucket("test-bucket") + .build(); + + assertThrows( + HttpResponseException.class, + () -> + multipartUploadHttpRequestManager.sendListMultipartUploadsRequest( + endpoint, request)); + } + } } From b90098331c6a0b862e46baf60891bd07f4fb5cef Mon Sep 17 00:00:00 2001 From: Dhriti Chopra Date: Wed, 12 Nov 2025 12:00:37 +0530 Subject: [PATCH 04/26] fix: Reverting deleted comments --- .../model/ListMultipartUploadsResponse.java | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsResponse.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsResponse.java index e6eec82849..9338cc6b31 100644 --- a/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsResponse.java +++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsResponse.java @@ -111,11 +111,23 @@ private ListMultipartUploadsResponse( } } + /** + * The list of multipart uploads. + * + * @return The list of multipart uploads. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ @BetaApi public ImmutableList getUploads() { return uploads == null ? ImmutableList.of() : ImmutableList.copyOf(uploads); } + /** + * The bucket that contains the multipart uploads. + * + * @return The bucket name. + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ @BetaApi public String getBucket() { return bucket; @@ -310,6 +322,12 @@ public static class CommonPrefixHelper { public String prefix; } + + /** + * A builder for {@link ListMultipartUploadsResponse}. + * + * @since 2.60.0 This new api is in preview and is subject to breaking changes. + */ @BetaApi public static final class Builder { private ImmutableList uploads; From 37bf4ecc259e24d7f6af040402791383f458b617 Mon Sep 17 00:00:00 2001 From: Dhriti Chopra Date: Wed, 12 Nov 2025 12:08:51 +0530 Subject: [PATCH 05/26] fix: Updating version and formatting code --- .../cloud/storage/ChecksumResponseParser.java | 6 +- .../cloud/storage/MultipartUploadClient.java | 2 +- .../MultipartUploadHttpRequestManager.java | 18 +-- .../model/ListMultipartUploadsRequest.java | 39 ++--- .../model/ListMultipartUploadsResponse.java | 111 +++++++------ .../model/MultipartUpload.java | 42 ++--- ...MultipartUploadHttpRequestManagerTest.java | 151 +++++++++--------- 7 files changed, 197 insertions(+), 172 deletions(-) diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/ChecksumResponseParser.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/ChecksumResponseParser.java index dd430a2f50..2c44565682 100644 --- a/google-cloud-storage/src/main/java/com/google/cloud/storage/ChecksumResponseParser.java +++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/ChecksumResponseParser.java @@ -36,7 +36,11 @@ private ChecksumResponseParser() {} static UploadPartResponse parseUploadResponse(HttpResponse response) { String eTag = response.getHeaders().getETag(); Map hashes = extractHashesFromHeader(response); - return UploadPartResponse.builder().eTag(eTag).md5(hashes.get("md5")).crc32c(hashes.get("crc32c")).build(); + return UploadPartResponse.builder() + .eTag(eTag) + .md5(hashes.get("md5")) + .crc32c(hashes.get("crc32c")) + .build(); } static CompleteMultipartUploadResponse parseCompleteResponse(HttpResponse response) diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadClient.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadClient.java index 3044c67651..bf3301a778 100644 --- a/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadClient.java +++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadClient.java @@ -129,4 +129,4 @@ public static MultipartUploadClient create(MultipartUploadSettings config) { MultipartUploadHttpRequestManager.createFrom(options), options.getRetryAlgorithmManager()); } -} \ No newline at end of file +} diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java index 21f00deda8..588b8fe74f 100644 --- a/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java +++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java @@ -117,29 +117,29 @@ ListMultipartUploadsResponse sendListMultipartUploadsRequest( URI uri, ListMultipartUploadsRequest request) throws IOException { ImmutableMap.Builder params = - ImmutableMap.builder() - .put("bucket", request.bucket()); - if(request.delimiter() != null){ + ImmutableMap.builder().put("bucket", request.bucket()); + if (request.delimiter() != null) { params.put("delimiter", request.delimiter()); } - if(request.encodingType() != null){ + if (request.encodingType() != null) { params.put("encoding-type", request.encodingType()); } - if(request.keyMarker() != null){ + if (request.keyMarker() != null) { params.put("key-marker", request.keyMarker()); } - if(request.maxUploads() != null){ + if (request.maxUploads() != null) { params.put("max-uploads", request.maxUploads()); } - if(request.prefix() != null){ + if (request.prefix() != null) { params.put("prefix", request.prefix()); } - if(request.uploadIdMarker() != null){ + if (request.uploadIdMarker() != null) { params.put("upload-id-marker", request.uploadIdMarker()); } String listUri = UriTemplate.expand( - uri.toString() + "{bucket}?uploads{delimiter,encoding-type,key-marker,max-uploads,prefix,upload-id-marker}", + uri.toString() + + "{bucket}?uploads{delimiter,encoding-type,key-marker,max-uploads,prefix,upload-id-marker}", params.build(), false); System.out.println(listUri); diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsRequest.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsRequest.java index 51c814507b..9c0504cbdd 100644 --- a/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsRequest.java +++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsRequest.java @@ -24,7 +24,7 @@ * * @see Listing * multipart uploads - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public final class ListMultipartUploadsRequest { @@ -58,7 +58,7 @@ private ListMultipartUploadsRequest( * The bucket to list multipart uploads from. * * @return The bucket name. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public String bucket() { @@ -69,7 +69,7 @@ public String bucket() { * Character used to group keys. * * @return The delimiter. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public String delimiter() { @@ -80,7 +80,7 @@ public String delimiter() { * The encoding type used by Cloud Storage to encode object names in the response. * * @return The encoding type. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public String encodingType() { @@ -92,7 +92,7 @@ public String encodingType() { * should begin. * * @return The key marker. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public String keyMarker() { @@ -103,7 +103,7 @@ public String keyMarker() { * The maximum number of multipart uploads to return. * * @return The maximum number of uploads. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public Integer maxUploads() { @@ -114,7 +114,7 @@ public Integer maxUploads() { * Filters results to multipart uploads whose keys begin with this prefix. * * @return The prefix. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public String prefix() { @@ -126,7 +126,7 @@ public String prefix() { * begin. * * @return The upload ID marker. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public String uploadIdMarker() { @@ -153,7 +153,8 @@ public boolean equals(Object o) { @Override public int hashCode() { - return Objects.hash(bucket, delimiter, encodingType, keyMarker, maxUploads, prefix, uploadIdMarker); + return Objects.hash( + bucket, delimiter, encodingType, keyMarker, maxUploads, prefix, uploadIdMarker); } @Override @@ -174,7 +175,7 @@ public String toString() { * Returns a new builder for this request. * * @return A new builder. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public static Builder builder() { @@ -184,7 +185,7 @@ public static Builder builder() { /** * A builder for {@link ListMultipartUploadsRequest}. * - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public static final class Builder { @@ -203,7 +204,7 @@ private Builder() {} * * @param bucket The bucket name. * @return This builder. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public Builder bucket(String bucket) { @@ -216,7 +217,7 @@ public Builder bucket(String bucket) { * * @param delimiter The delimiter. * @return This builder. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public Builder delimiter(String delimiter) { @@ -229,7 +230,7 @@ public Builder delimiter(String delimiter) { * * @param encodingType The encoding type. * @return This builder. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public Builder encodingType(String encodingType) { @@ -242,7 +243,7 @@ public Builder encodingType(String encodingType) { * * @param keyMarker The key marker. * @return This builder. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public Builder keyMarker(String keyMarker) { @@ -255,7 +256,7 @@ public Builder keyMarker(String keyMarker) { * * @param maxUploads The maximum number of uploads. * @return This builder. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public Builder maxUploads(Integer maxUploads) { @@ -268,7 +269,7 @@ public Builder maxUploads(Integer maxUploads) { * * @param prefix The prefix. * @return This builder. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public Builder prefix(String prefix) { @@ -281,7 +282,7 @@ public Builder prefix(String prefix) { * * @param uploadIdMarker The upload ID marker. * @return This builder. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public Builder uploadIdMarker(String uploadIdMarker) { @@ -293,7 +294,7 @@ public Builder uploadIdMarker(String uploadIdMarker) { * Builds the request. * * @return The built request. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public ListMultipartUploadsRequest build() { diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsResponse.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsResponse.java index 9338cc6b31..3192262b8c 100644 --- a/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsResponse.java +++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsResponse.java @@ -29,7 +29,7 @@ * A response from listing all multipart uploads in a bucket. * * @see Listing - * multipart uploads + * multipart uploads * @since 2.60.1 This new api is in preview and is subject to breaking changes. */ @BetaApi @@ -111,11 +111,11 @@ private ListMultipartUploadsResponse( } } - /** + /** * The list of multipart uploads. * * @return The list of multipart uploads. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public ImmutableList getUploads() { @@ -126,7 +126,7 @@ public ImmutableList getUploads() { * The bucket that contains the multipart uploads. * * @return The bucket name. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public String getBucket() { @@ -137,7 +137,7 @@ public String getBucket() { * The delimiter applied to the request. * * @return The delimiter applied to the request. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public String getDelimiter() { @@ -148,7 +148,7 @@ public String getDelimiter() { * The encoding type used by Cloud Storage to encode object names in the response. * * @return The encoding type. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public String getEncodingType() { @@ -159,7 +159,7 @@ public String getEncodingType() { * The key at or after which the listing began. * * @return The key marker. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public String getKeyMarker() { @@ -170,7 +170,7 @@ public String getKeyMarker() { * The upload ID at or after which the listing began. * * @return The upload ID marker. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public String getUploadIdMarker() { @@ -181,7 +181,7 @@ public String getUploadIdMarker() { * The key after which listing should begin. * * @return The key after which listing should begin. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public String getNextKeyMarker() { @@ -192,7 +192,7 @@ public String getNextKeyMarker() { * The upload ID after which listing should begin. * * @return The upload ID after which listing should begin. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public String getNextUploadIdMarker() { @@ -203,7 +203,7 @@ public String getNextUploadIdMarker() { * The maximum number of uploads to return. * * @return The maximum number of uploads. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public int getMaxUploads() { @@ -214,7 +214,7 @@ public int getMaxUploads() { * The prefix applied to the request. * * @return The prefix applied to the request. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public String getPrefix() { @@ -225,7 +225,7 @@ public String getPrefix() { * A flag indicating whether or not the returned results are truncated. * * @return A flag indicating whether or not the returned results are truncated. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public boolean isTruncated() { @@ -236,16 +236,14 @@ public boolean isTruncated() { * If you specify a delimiter in the request, this element is returned. * * @return The common prefixes. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public ImmutableList getCommonPrefixes() { if (commonPrefixes == null) { return ImmutableList.of(); } - return commonPrefixes.stream() - .map(h -> h.prefix) - .collect(ImmutableList.toImmutableList()); + return commonPrefixes.stream().map(h -> h.prefix).collect(ImmutableList.toImmutableList()); } @Override @@ -290,27 +288,47 @@ public int hashCode() { @Override public String toString() { - return "ListMultipartUploadsResponse{" + - "uploads=" + getUploads() + - ", bucket='" + bucket + "'" + - ", delimiter='" + delimiter + "'" + - ", encodingType='" + encodingType + "'" + - ", keyMarker='" + keyMarker + "'" + - ", uploadIdMarker='" + uploadIdMarker + "'" + - ", nextKeyMarker='" + nextKeyMarker + "'" + - ", nextUploadIdMarker='" + nextUploadIdMarker + "'" + - ", maxUploads=" + maxUploads + - ", prefix='" + prefix + "'" + - ", isTruncated=" + isTruncated + - ", commonPrefixes=" + getCommonPrefixes() + - '}'; + return "ListMultipartUploadsResponse{" + + "uploads=" + + getUploads() + + ", bucket='" + + bucket + + "'" + + ", delimiter='" + + delimiter + + "'" + + ", encodingType='" + + encodingType + + "'" + + ", keyMarker='" + + keyMarker + + "'" + + ", uploadIdMarker='" + + uploadIdMarker + + "'" + + ", nextKeyMarker='" + + nextKeyMarker + + "'" + + ", nextUploadIdMarker='" + + nextUploadIdMarker + + "'" + + ", maxUploads=" + + maxUploads + + ", prefix='" + + prefix + + "'" + + ", isTruncated=" + + isTruncated + + ", commonPrefixes=" + + getCommonPrefixes() + + '}'; } /** * Returns a new builder for this response. * * @return A new builder. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public static Builder builder() { @@ -322,11 +340,10 @@ public static class CommonPrefixHelper { public String prefix; } - /** * A builder for {@link ListMultipartUploadsResponse}. * - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public static final class Builder { @@ -350,7 +367,7 @@ private Builder() {} * * @param uploads The list of multipart uploads. * @return This builder. - * @since 2.60.0 This new api is in preview. + * @since 2.61.0 This new api is in preview. */ @BetaApi public Builder setUploads(ImmutableList uploads) { @@ -363,7 +380,7 @@ public Builder setUploads(ImmutableList uploads) { * * @param bucket The bucket name. * @return This builder. - * @since 2.60.0 This new api is in preview. + * @since 2.61.0 This new api is in preview. */ @BetaApi public Builder setBucket(String bucket) { @@ -376,7 +393,7 @@ public Builder setBucket(String bucket) { * * @param delimiter The delimiter applied to the request. * @return This builder. - * @since 2.60.0 This new api is in preview. + * @since 2.61.0 This new api is in preview. */ @BetaApi public Builder setDelimiter(String delimiter) { @@ -389,7 +406,7 @@ public Builder setDelimiter(String delimiter) { * * @param encodingType The encoding type. * @return This builder. - * @since 2.60.0 This new api is in preview. + * @since 2.61.0 This new api is in preview. */ @BetaApi public Builder setEncodingType(String encodingType) { @@ -402,7 +419,7 @@ public Builder setEncodingType(String encodingType) { * * @param keyMarker The key marker. * @return This builder. - * @since 2.60.0 This new api is in preview. + * @since 2.61.0 This new api is in preview. */ @BetaApi public Builder setKeyMarker(String keyMarker) { @@ -415,7 +432,7 @@ public Builder setKeyMarker(String keyMarker) { * * @param uploadIdMarker The upload ID marker. * @return This builder. - * @since 2.60.0 This new api is in preview. + * @since 2.61.0 This new api is in preview. */ @BetaApi public Builder setUploadIdMarker(String uploadIdMarker) { @@ -428,7 +445,7 @@ public Builder setUploadIdMarker(String uploadIdMarker) { * * @param nextKeyMarker The key after which listing should begin. * @return This builder. - * @since 2.60.0 This new api is in preview. + * @since 2.61.0 This new api is in preview. */ @BetaApi public Builder setNextKeyMarker(String nextKeyMarker) { @@ -441,7 +458,7 @@ public Builder setNextKeyMarker(String nextKeyMarker) { * * @param nextUploadIdMarker The upload ID after which listing should begin. * @return This builder. - * @since 2.60.0 This new api is in preview. + * @since 2.61.0 This new api is in preview. */ @BetaApi public Builder setNextUploadIdMarker(String nextUploadIdMarker) { @@ -454,7 +471,7 @@ public Builder setNextUploadIdMarker(String nextUploadIdMarker) { * * @param maxUploads The maximum number of uploads. * @return This builder. - * @since 2.60.0 This new api is in preview. + * @since 2.61.0 This new api is in preview. */ @BetaApi public Builder setMaxUploads(int maxUploads) { @@ -467,7 +484,7 @@ public Builder setMaxUploads(int maxUploads) { * * @param prefix The prefix applied to the request. * @return This builder. - * @since 2.60.0 This new api is in preview. + * @since 2.61.0 This new api is in preview. */ @BetaApi public Builder setPrefix(String prefix) { @@ -480,7 +497,7 @@ public Builder setPrefix(String prefix) { * * @param isTruncated The flag indicating whether or not the returned results are truncated. * @return This builder. - * @since 2.60.0 This new api is in preview. + * @since 2.61.0 This new api is in preview. */ @BetaApi public Builder setTruncated(boolean isTruncated) { @@ -493,7 +510,7 @@ public Builder setTruncated(boolean isTruncated) { * * @param commonPrefixes The common prefixes. * @return This builder. - * @since 2.60.0 This new api is in preview. + * @since 2.61.0 This new api is in preview. */ @BetaApi public Builder setCommonPrefixes(ImmutableList commonPrefixes) { @@ -505,7 +522,7 @@ public Builder setCommonPrefixes(ImmutableList commonPrefixes) { * Builds the response. * * @return The built response. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public ListMultipartUploadsResponse build() { diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/MultipartUpload.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/MultipartUpload.java index 7fee6a9528..992f5f99c8 100644 --- a/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/MultipartUpload.java +++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/MultipartUpload.java @@ -25,7 +25,7 @@ /** * Represents a multipart upload that is in progress. * - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public final class MultipartUpload { @@ -56,7 +56,7 @@ private MultipartUpload( * The object name for which the multipart upload was initiated. * * @return The object name. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public String getKey() { @@ -67,7 +67,7 @@ public String getKey() { * The ID of the multipart upload. * * @return The upload ID. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public String getUploadId() { @@ -78,7 +78,7 @@ public String getUploadId() { * The storage class of the object. * * @return The storage class. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public StorageClass getStorageClass() { @@ -89,7 +89,7 @@ public StorageClass getStorageClass() { * The date and time at which the multipart upload was initiated. * * @return The initiation date and time. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public OffsetDateTime getInitiated() { @@ -118,19 +118,25 @@ public int hashCode() { @Override public String toString() { - return "MultipartUpload{" + - "key='" + key + '\'' + - ", uploadId='" + uploadId + '\'' + - ", storageClass=" + storageClass + - ", initiated=" + initiated + - "}"; + return "MultipartUpload{" + + "key='" + + key + + '\'' + + ", uploadId='" + + uploadId + + '\'' + + ", storageClass=" + + storageClass + + ", initiated=" + + initiated + + "}"; } /** * Returns a new builder for this multipart upload. * * @return A new builder. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public static Builder newBuilder() { @@ -140,7 +146,7 @@ public static Builder newBuilder() { /** * A builder for {@link MultipartUpload}. * - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public static final class Builder { @@ -156,7 +162,7 @@ private Builder() {} * * @param key The object name. * @return This builder. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public Builder setKey(String key) { @@ -169,7 +175,7 @@ public Builder setKey(String key) { * * @param uploadId The upload ID. * @return This builder. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public Builder setUploadId(String uploadId) { @@ -182,7 +188,7 @@ public Builder setUploadId(String uploadId) { * * @param storageClass The storage class. * @return This builder. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public Builder setStorageClass(StorageClass storageClass) { @@ -195,7 +201,7 @@ public Builder setStorageClass(StorageClass storageClass) { * * @param initiated The initiation date and time. * @return This builder. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public Builder setInitiated(OffsetDateTime initiated) { @@ -207,7 +213,7 @@ public Builder setInitiated(OffsetDateTime initiated) { * Builds the multipart upload. * * @return The built multipart upload. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public MultipartUpload build() { diff --git a/google-cloud-storage/src/test/java/com/google/cloud/storage/ITMultipartUploadHttpRequestManagerTest.java b/google-cloud-storage/src/test/java/com/google/cloud/storage/ITMultipartUploadHttpRequestManagerTest.java index e17c517e95..6133a25444 100644 --- a/google-cloud-storage/src/test/java/com/google/cloud/storage/ITMultipartUploadHttpRequestManagerTest.java +++ b/google-cloud-storage/src/test/java/com/google/cloud/storage/ITMultipartUploadHttpRequestManagerTest.java @@ -844,85 +844,82 @@ public void sendUploadPartRequest_error() throws Exception { } } -@Test -public void sendListMultipartUploadsRequest_success() throws Exception { - String mockXmlResponse = - "" + - " test-bucket" + - " key-marker" + - " upload-id-marker" + - " next-key-marker" + - " next-upload-id-marker" + - " 1" + - " false" + - " " + - " test-key" + - " test-upload-id" + - " STANDARD" + - " 2025-11-11T00:00:00Z" + - " " + - ""; - - HttpRequestHandler handler = - req -> { - ByteBuf buf = Unpooled.wrappedBuffer(mockXmlResponse.getBytes(StandardCharsets.UTF_8)); - - DefaultFullHttpResponse resp = - new DefaultFullHttpResponse(req.protocolVersion(), OK, buf); - - resp.headers().set("Content-Type", "application/xml; charset=utf-8"); - resp.headers().set("Content-Length", resp.content().readableBytes()); - return resp; - }; - - try (FakeHttpServer fakeHttpServer = FakeHttpServer.of(handler)) { - URI endpoint = URI.create(fakeHttpServer.getEndpoint() + "/"); - - ListMultipartUploadsRequest request = - ListMultipartUploadsRequest.builder() - .bucket("test-bucket") - .maxUploads(1) - .keyMarker("key-marker") - .uploadIdMarker("upload-id-marker") - .build(); + @Test + public void sendListMultipartUploadsRequest_success() throws Exception { + String mockXmlResponse = + "" + + " test-bucket" + + " key-marker" + + " upload-id-marker" + + " next-key-marker" + + " next-upload-id-marker" + + " 1" + + " false" + + " " + + " test-key" + + " test-upload-id" + + " STANDARD" + + " 2025-11-11T00:00:00Z" + + " " + + ""; + + HttpRequestHandler handler = + req -> { + ByteBuf buf = Unpooled.wrappedBuffer(mockXmlResponse.getBytes(StandardCharsets.UTF_8)); + + DefaultFullHttpResponse resp = + new DefaultFullHttpResponse(req.protocolVersion(), OK, buf); + + resp.headers().set("Content-Type", "application/xml; charset=utf-8"); + resp.headers().set("Content-Length", resp.content().readableBytes()); + return resp; + }; + + try (FakeHttpServer fakeHttpServer = FakeHttpServer.of(handler)) { + URI endpoint = URI.create(fakeHttpServer.getEndpoint() + "/"); + + ListMultipartUploadsRequest request = + ListMultipartUploadsRequest.builder() + .bucket("test-bucket") + .maxUploads(1) + .keyMarker("key-marker") + .uploadIdMarker("upload-id-marker") + .build(); + + ListMultipartUploadsResponse response = + multipartUploadHttpRequestManager.sendListMultipartUploadsRequest(endpoint, request); + + assertThat(response).isNotNull(); + assertThat(response.getBucket()).isEqualTo("test-bucket"); + assertThat(response.getUploads()).hasSize(1); - ListMultipartUploadsResponse response = - multipartUploadHttpRequestManager.sendListMultipartUploadsRequest(endpoint, request); - - assertThat(response).isNotNull(); - assertThat(response.getBucket()).isEqualTo("test-bucket"); - assertThat(response.getUploads()).hasSize(1); - - MultipartUpload upload = response.getUploads().get(0); - assertThat(upload.getKey()).isEqualTo("test-key"); - assertThat(upload.getStorageClass()).isEqualTo(StorageClass.STANDARD); - assertThat(upload.getInitiated()) - .isEqualTo(OffsetDateTime.of(2025, 11, 11, 0, 0, 0, 0, ZoneOffset.UTC)); + MultipartUpload upload = response.getUploads().get(0); + assertThat(upload.getKey()).isEqualTo("test-key"); + assertThat(upload.getStorageClass()).isEqualTo(StorageClass.STANDARD); + assertThat(upload.getInitiated()) + .isEqualTo(OffsetDateTime.of(2025, 11, 11, 0, 0, 0, 0, ZoneOffset.UTC)); + } } -} - @Test - public void sendListMultipartUploadsRequest_error() throws Exception { - HttpRequestHandler handler = - req -> { - FullHttpResponse resp = - new DefaultFullHttpResponse(req.protocolVersion(), HttpResponseStatus.BAD_REQUEST); - resp.headers().set(CONTENT_TYPE, "text/plain; charset=utf-8"); - return resp; - }; - - try (FakeHttpServer fakeHttpServer = FakeHttpServer.of(handler)) { - URI endpoint = URI.create(fakeHttpServer.getEndpoint() + "/"); - ListMultipartUploadsRequest request = - ListMultipartUploadsRequest.builder() - .bucket("test-bucket") - .build(); + @Test + public void sendListMultipartUploadsRequest_error() throws Exception { + HttpRequestHandler handler = + req -> { + FullHttpResponse resp = + new DefaultFullHttpResponse(req.protocolVersion(), HttpResponseStatus.BAD_REQUEST); + resp.headers().set(CONTENT_TYPE, "text/plain; charset=utf-8"); + return resp; + }; + + try (FakeHttpServer fakeHttpServer = FakeHttpServer.of(handler)) { + URI endpoint = URI.create(fakeHttpServer.getEndpoint() + "/"); + ListMultipartUploadsRequest request = + ListMultipartUploadsRequest.builder().bucket("test-bucket").build(); - assertThrows( - HttpResponseException.class, - () -> - multipartUploadHttpRequestManager.sendListMultipartUploadsRequest( - endpoint, request)); - } - } + assertThrows( + HttpResponseException.class, + () -> + multipartUploadHttpRequestManager.sendListMultipartUploadsRequest(endpoint, request)); + } + } } From 194284bb1bebd0c763691e8eae44b57ac3779cac Mon Sep 17 00:00:00 2001 From: Dhriti Chopra Date: Wed, 12 Nov 2025 12:22:55 +0530 Subject: [PATCH 06/26] fix: update version for ListMulipartUploadsResponse --- .../java/com/google/cloud/storage/MultipartUploadClient.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadClient.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadClient.java index bf3301a778..e6a8a99258 100644 --- a/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadClient.java +++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadClient.java @@ -107,7 +107,7 @@ public abstract CompleteMultipartUploadResponse completeMultipartUpload( * * @param request The request object containing the details for listing the multipart uploads. * @return A {@link ListMultipartUploadsResponse} object containing the list of multipart uploads. - * @since 2.60.0 This new api is in preview and is subject to breaking changes. + * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi public abstract ListMultipartUploadsResponse listMultipartUploads( From de8dc789e0e6095a22b11458de137f01d10218c7 Mon Sep 17 00:00:00 2001 From: Dhriti Chopra Date: Wed, 12 Nov 2025 14:41:59 +0530 Subject: [PATCH 07/26] fix: adding default for backward compaitbility --- .../java/com/google/cloud/storage/MultipartUploadClient.java | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadClient.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadClient.java index e6a8a99258..d9af108c05 100644 --- a/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadClient.java +++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadClient.java @@ -110,8 +110,9 @@ public abstract CompleteMultipartUploadResponse completeMultipartUpload( * @since 2.61.0 This new api is in preview and is subject to breaking changes. */ @BetaApi - public abstract ListMultipartUploadsResponse listMultipartUploads( - ListMultipartUploadsRequest request); + public ListMultipartUploadsResponse listMultipartUploads(ListMultipartUploadsRequest request) { + throw new UnsupportedOperationException("This operation is not yet implemented."); + } /** * Creates a new instance of {@link MultipartUploadClient}. From 6af874bfa7f85f081341da9be87dd923a739c85d Mon Sep 17 00:00:00 2001 From: BenWhitehead Date: Tue, 4 Nov 2025 15:45:55 -0500 Subject: [PATCH 08/26] fix: call response.disconnect() after resolving resumable upload url (#3385) --- .../com/google/cloud/storage/spi/v1/HttpStorageRpc.java | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/spi/v1/HttpStorageRpc.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/spi/v1/HttpStorageRpc.java index ca11f96673..20650a11d0 100644 --- a/google-cloud-storage/src/main/java/com/google/cloud/storage/spi/v1/HttpStorageRpc.java +++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/spi/v1/HttpStorageRpc.java @@ -1156,7 +1156,9 @@ public String open(StorageObject object, Map options) { if (response.getStatusCode() != 200) { throw buildStorageException(response.getStatusCode(), response.getStatusMessage()); } - return response.getHeaders().getLocation(); + String location = response.getHeaders().getLocation(); + response.disconnect(); + return location; } catch (IOException ex) { span.setStatus(Status.UNKNOWN.withDescription(ex.getMessage())); throw translate(ex); @@ -1190,7 +1192,9 @@ public String open(String signedURL) { if (response.getStatusCode() != 201) { throw buildStorageException(response.getStatusCode(), response.getStatusMessage()); } - return response.getHeaders().getLocation(); + String location = response.getHeaders().getLocation(); + response.disconnect(); + return location; } catch (IOException ex) { span.setStatus(Status.UNKNOWN.withDescription(ex.getMessage())); throw translate(ex); From ac9387d7d74dbbaa4f97cecc49a09a81abfeffcf Mon Sep 17 00:00:00 2001 From: Mend Renovate Date: Fri, 7 Nov 2025 22:00:18 +0000 Subject: [PATCH 09/26] deps: update dependency com.google.cloud:sdk-platform-java-config to v3.54.1 (#3381) Co-authored-by: BenWhitehead --- .../workflows/unmanaged_dependency_check.yaml | 2 +- google-cloud-storage-bom/pom.xml | 2 +- .../GenerateGrpcProtobufReflectConfig.java | 3 +- .../google/cloud/storage/reflect-config.json | 55 ++++++++++++++++++- pom.xml | 2 +- 5 files changed, 56 insertions(+), 8 deletions(-) diff --git a/.github/workflows/unmanaged_dependency_check.yaml b/.github/workflows/unmanaged_dependency_check.yaml index 756c7dfc75..d8267b1548 100644 --- a/.github/workflows/unmanaged_dependency_check.yaml +++ b/.github/workflows/unmanaged_dependency_check.yaml @@ -17,6 +17,6 @@ jobs: # repository .kokoro/build.sh - name: Unmanaged dependency check - uses: googleapis/sdk-platform-java/java-shared-dependencies/unmanaged-dependency-check@google-cloud-shared-dependencies/v3.53.0 + uses: googleapis/sdk-platform-java/java-shared-dependencies/unmanaged-dependency-check@google-cloud-shared-dependencies/v3.54.1 with: bom-path: google-cloud-storage-bom/pom.xml diff --git a/google-cloud-storage-bom/pom.xml b/google-cloud-storage-bom/pom.xml index f11503a51c..73ed033a1e 100644 --- a/google-cloud-storage-bom/pom.xml +++ b/google-cloud-storage-bom/pom.xml @@ -24,7 +24,7 @@ com.google.cloud sdk-platform-java-config - 3.53.0 + 3.54.1 diff --git a/google-cloud-storage/src/test/java/com/google/cloud/storage/GenerateGrpcProtobufReflectConfig.java b/google-cloud-storage/src/test/java/com/google/cloud/storage/GenerateGrpcProtobufReflectConfig.java index 0d2b3b41a8..35d5bd888b 100644 --- a/google-cloud-storage/src/test/java/com/google/cloud/storage/GenerateGrpcProtobufReflectConfig.java +++ b/google-cloud-storage/src/test/java/com/google/cloud/storage/GenerateGrpcProtobufReflectConfig.java @@ -17,7 +17,6 @@ package com.google.cloud.storage; import com.google.protobuf.AbstractMessage; -import com.google.protobuf.Message; import com.google.protobuf.ProtocolMessageEnum; import io.github.classgraph.ClassGraph; import io.github.classgraph.ClassInfo; @@ -57,7 +56,7 @@ public static void main(String[] args) throws IOException { + " \"methods\":[{\"name\":\"\",\"parameterTypes\":[] }]\n" + " }"), Stream.of( - scanResult.getSubclasses(Message.class).stream(), + scanResult.getSubclasses(AbstractMessage.class).stream(), scanResult.getSubclasses(AbstractMessage.Builder.class).stream(), scanResult .getAllEnums() diff --git a/google-cloud-storage/src/test/resources/META-INF/native-image/com/google/cloud/storage/reflect-config.json b/google-cloud-storage/src/test/resources/META-INF/native-image/com/google/cloud/storage/reflect-config.json index 138caa1456..500a610c11 100644 --- a/google-cloud-storage/src/test/resources/META-INF/native-image/com/google/cloud/storage/reflect-config.json +++ b/google-cloud-storage/src/test/resources/META-INF/native-image/com/google/cloud/storage/reflect-config.json @@ -15,7 +15,8 @@ "allDeclaredMethods":true, "methods":[{"name":"","parameterTypes":[] }] }, - { "name": "com.google.protobuf.Message$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "com.google.protobuf.GeneratedMessageV3", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "com.google.protobuf.GeneratedMessageV3$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.alts.internal.AltsContext", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.alts.internal.AltsContext$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.alts.internal.Endpoint", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, @@ -222,6 +223,8 @@ { "name": "io.grpc.xds.shaded.com.github.udpa.udpa.type.v1.TypedStruct$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.com.github.xds.core.v3.Authority", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.com.github.xds.core.v3.Authority$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.com.github.xds.core.v3.CidrRange", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.com.github.xds.core.v3.CidrRange$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.com.github.xds.core.v3.CollectionEntry", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.com.github.xds.core.v3.CollectionEntry$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.com.github.xds.core.v3.CollectionEntry$InlineEntry", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, @@ -698,6 +701,8 @@ { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.KeyValueAppend$KeyValueAppendAction", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.KeyValueMutation", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.KeyValueMutation$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.KeyValuePair", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.KeyValuePair$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.Locality", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.Locality$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.Metadata", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, @@ -706,6 +711,8 @@ { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.Node$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.PathConfigSource", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.PathConfigSource$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.PerHostConfig", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.PerHostConfig$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.Pipe", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.Pipe$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.ProxyProtocolConfig", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, @@ -749,9 +756,17 @@ { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.SocketAddress", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.SocketAddress$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.SocketAddress$Protocol", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.SocketCmsgHeaders", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.SocketCmsgHeaders$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.SocketOption", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.SocketOption$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.SocketOption$SocketState", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.SocketOption$SocketType", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.SocketOption$SocketType$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.SocketOption$SocketType$Datagram", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.SocketOption$SocketType$Datagram$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.SocketOption$SocketType$Stream", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.SocketOption$SocketType$Stream$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.SocketOptionsOverride", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.SocketOptionsOverride$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.SubstitutionFormatString", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, @@ -760,6 +775,8 @@ { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.TcpKeepalive$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.TcpProtocolOptions", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.TcpProtocolOptions$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.TlvEntry", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.TlvEntry$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.TrafficDirection", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.TransportSocket", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.core.v3.TransportSocket$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, @@ -791,12 +808,16 @@ { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.endpoint.v3.EndpointLoadMetricStats$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.endpoint.v3.LbEndpoint", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.endpoint.v3.LbEndpoint$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.endpoint.v3.LbEndpointCollection", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.endpoint.v3.LbEndpointCollection$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.endpoint.v3.LedsClusterLocalityConfig", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.endpoint.v3.LedsClusterLocalityConfig$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.endpoint.v3.LocalityLbEndpoints", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.endpoint.v3.LocalityLbEndpoints$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.endpoint.v3.LocalityLbEndpoints$LbEndpointList", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.endpoint.v3.LocalityLbEndpoints$LbEndpointList$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.endpoint.v3.UnnamedEndpointLoadMetricStats", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.endpoint.v3.UnnamedEndpointLoadMetricStats$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.endpoint.v3.UpstreamEndpointStats", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.endpoint.v3.UpstreamEndpointStats$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.endpoint.v3.UpstreamLocalityStats", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, @@ -813,8 +834,6 @@ { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.listener.v3.Filter$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.listener.v3.FilterChain", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.listener.v3.FilterChain$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, - { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.listener.v3.FilterChain$OnDemandConfiguration", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, - { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.listener.v3.FilterChain$OnDemandConfiguration$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.listener.v3.FilterChainMatch", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.listener.v3.FilterChainMatch$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.listener.v3.FilterChainMatch$ConnectionSourceType", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, @@ -827,6 +846,8 @@ { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.listener.v3.Listener$DeprecatedV1", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.listener.v3.Listener$DeprecatedV1$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.listener.v3.Listener$DrainType", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.listener.v3.Listener$FcdsConfig", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.listener.v3.Listener$FcdsConfig$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.listener.v3.Listener$InternalListenerConfig", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.listener.v3.Listener$InternalListenerConfig$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.listener.v3.ListenerCollection", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, @@ -884,6 +905,7 @@ { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.overload.v3.Trigger$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.rbac.v3.Action", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.rbac.v3.Action$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.rbac.v3.MetadataSource", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.rbac.v3.Permission", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.rbac.v3.Permission$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.rbac.v3.Permission$Set", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, @@ -904,6 +926,8 @@ { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.rbac.v3.RBAC$AuditLoggingOptions$AuditLoggerConfig$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.rbac.v3.RBAC$AuditLoggingOptions$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.rbac.v3.RBAC$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.rbac.v3.SourcedMetadata", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.rbac.v3.SourcedMetadata$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.route.v3.ClusterSpecifierPlugin", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.route.v3.ClusterSpecifierPlugin$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.route.v3.CorsPolicy", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, @@ -944,6 +968,8 @@ { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.route.v3.RateLimit$Action$MetaData$Source", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.route.v3.RateLimit$Action$QueryParameterValueMatch", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.route.v3.RateLimit$Action$QueryParameterValueMatch$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.route.v3.RateLimit$Action$QueryParameters", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.route.v3.RateLimit$Action$QueryParameters$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.route.v3.RateLimit$Action$RemoteAddress", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.route.v3.RateLimit$Action$RemoteAddress$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.route.v3.RateLimit$Action$RequestHeaders", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, @@ -951,6 +977,8 @@ { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.route.v3.RateLimit$Action$SourceCluster", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.route.v3.RateLimit$Action$SourceCluster$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.route.v3.RateLimit$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.route.v3.RateLimit$HitsAddend", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.route.v3.RateLimit$HitsAddend$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.route.v3.RateLimit$Override", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.route.v3.RateLimit$Override$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.route.v3.RateLimit$Override$DynamicMetadata", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, @@ -1032,6 +1060,8 @@ { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.route.v3.WeightedCluster$ClusterWeight$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.trace.v3.DatadogConfig", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.trace.v3.DatadogConfig$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.trace.v3.DatadogRemoteConfig", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.trace.v3.DatadogRemoteConfig$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.trace.v3.DynamicOtConfig", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.trace.v3.DynamicOtConfig$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.config.trace.v3.LightstepConfig", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, @@ -1074,6 +1104,8 @@ { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.data.accesslog.v3.TLSProperties$CertificateProperties$SubjectAltName", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.data.accesslog.v3.TLSProperties$CertificateProperties$SubjectAltName$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.data.accesslog.v3.TLSProperties$TLSVersion", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.clusters.aggregate.v3.AggregateClusterResource", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.clusters.aggregate.v3.AggregateClusterResource$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.clusters.aggregate.v3.ClusterConfig", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.clusters.aggregate.v3.ClusterConfig$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.filters.common.fault.v3.FaultDelay", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, @@ -1093,6 +1125,14 @@ { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.filters.http.fault.v3.FaultAbort$HeaderAbort$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.filters.http.fault.v3.HTTPFault", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.filters.http.fault.v3.HTTPFault$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.filters.http.gcp_authn.v3.Audience", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.filters.http.gcp_authn.v3.Audience$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.filters.http.gcp_authn.v3.GcpAuthnFilterConfig", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.filters.http.gcp_authn.v3.GcpAuthnFilterConfig$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.filters.http.gcp_authn.v3.TokenCacheConfig", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.filters.http.gcp_authn.v3.TokenCacheConfig$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.filters.http.gcp_authn.v3.TokenHeader", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.filters.http.gcp_authn.v3.TokenHeader$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.filters.http.rate_limit_quota.v3.RateLimitQuotaBucketSettings", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.filters.http.rate_limit_quota.v3.RateLimitQuotaBucketSettings$BucketIdBuilder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.filters.http.rate_limit_quota.v3.RateLimitQuotaBucketSettings$BucketIdBuilder$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, @@ -1176,6 +1216,8 @@ { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.load_balancing_policies.common.v3.LocalityLbConfig$LocalityWeightedLbConfig$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.load_balancing_policies.common.v3.LocalityLbConfig$ZoneAwareLbConfig", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.load_balancing_policies.common.v3.LocalityLbConfig$ZoneAwareLbConfig$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.load_balancing_policies.common.v3.LocalityLbConfig$ZoneAwareLbConfig$ForceLocalZone", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.load_balancing_policies.common.v3.LocalityLbConfig$ZoneAwareLbConfig$ForceLocalZone$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.load_balancing_policies.common.v3.SlowStartConfig", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.load_balancing_policies.common.v3.SlowStartConfig$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.load_balancing_policies.least_request.v3.LeastRequest", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, @@ -1190,6 +1232,8 @@ { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.load_balancing_policies.round_robin.v3.RoundRobin$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.load_balancing_policies.wrr_locality.v3.WrrLocality", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.load_balancing_policies.wrr_locality.v3.WrrLocality$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.transport_sockets.http_11_proxy.v3.Http11ProxyUpstreamTransport", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.transport_sockets.http_11_proxy.v3.Http11ProxyUpstreamTransport$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.transport_sockets.tls.v3.CertificateProviderPluginInstance", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.transport_sockets.tls.v3.CertificateProviderPluginInstance$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.transport_sockets.tls.v3.CertificateValidationContext", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, @@ -1225,6 +1269,7 @@ { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.transport_sockets.tls.v3.TlsKeyLog$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.transport_sockets.tls.v3.TlsParameters", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.transport_sockets.tls.v3.TlsParameters$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.transport_sockets.tls.v3.TlsParameters$CompliancePolicy", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.transport_sockets.tls.v3.TlsParameters$TlsProtocol", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.transport_sockets.tls.v3.TlsSessionTicketKeys", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.extensions.transport_sockets.tls.v3.TlsSessionTicketKeys$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, @@ -1252,6 +1297,8 @@ { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.service.discovery.v3.Resource$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.service.discovery.v3.Resource$CacheControl", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.service.discovery.v3.Resource$CacheControl$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.service.discovery.v3.ResourceError", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.service.discovery.v3.ResourceError$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.service.discovery.v3.ResourceLocator", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.service.discovery.v3.ResourceLocator$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.service.discovery.v3.ResourceName", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, @@ -1294,6 +1341,8 @@ { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.type.http.v3.PathTransformation$Operation$MergeSlashes$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.type.http.v3.PathTransformation$Operation$NormalizePathRFC3986", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.type.http.v3.PathTransformation$Operation$NormalizePathRFC3986$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.type.matcher.v3.AddressMatcher", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, + { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.type.matcher.v3.AddressMatcher$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.type.matcher.v3.DoubleMatcher", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.type.matcher.v3.DoubleMatcher$Builder", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, { "name": "io.grpc.xds.shaded.io.envoyproxy.envoy.type.matcher.v3.FilterStateMatcher", "queryAllDeclaredConstructors": true, "queryAllPublicConstructors": true, "queryAllDeclaredMethods": true, "allPublicMethods": true, "allDeclaredClasses": true, "allPublicClasses": true }, diff --git a/pom.xml b/pom.xml index 593f316fd7..95e2aad296 100644 --- a/pom.xml +++ b/pom.xml @@ -14,7 +14,7 @@ com.google.cloud sdk-platform-java-config - 3.53.0 + 3.54.1 From 9273da093ac87cf3b651886f76f25054a4f8cbb9 Mon Sep 17 00:00:00 2001 From: "release-please[bot]" <55107282+release-please[bot]@users.noreply.github.com> Date: Fri, 7 Nov 2025 17:35:45 -0500 Subject: [PATCH 10/26] chore(main): release 2.60.0 (#3360) Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com> Co-authored-by: cloud-java-bot --- CHANGELOG.md | 24 +++++++++++++++++++ README.md | 6 ++--- gapic-google-cloud-storage-v2/pom.xml | 4 ++-- google-cloud-storage-bom/pom.xml | 16 ++++++------- google-cloud-storage-control/pom.xml | 4 ++-- google-cloud-storage/pom.xml | 4 ++-- grpc-google-cloud-storage-control-v2/pom.xml | 4 ++-- grpc-google-cloud-storage-v2/pom.xml | 4 ++-- pom.xml | 16 ++++++------- proto-google-cloud-storage-control-v2/pom.xml | 4 ++-- proto-google-cloud-storage-v2/pom.xml | 4 ++-- samples/snapshot/pom.xml | 6 ++--- storage-shared-benchmarking/pom.xml | 4 ++-- versions.txt | 14 +++++------ 14 files changed, 69 insertions(+), 45 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 2766dc4e38..51558248ec 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,29 @@ # Changelog +## [2.60.0](https://github.com/googleapis/java-storage/compare/v2.59.0...v2.60.0) (2025-11-07) + + +### Features + +* Add preview MultipartUploadClient#abortMultipartUpload https://github.com/googleapis/java-storage/pull/3361 ([160fa9a](https://github.com/googleapis/java-storage/commit/160fa9af7aa492373a9d9b40f65a6c56d7cab5ef)) +* Add preview MultipartUploadClient#completeMultipartUpload https://github.com/googleapis/java-storage/pull/3372 ([160fa9a](https://github.com/googleapis/java-storage/commit/160fa9af7aa492373a9d9b40f65a6c56d7cab5ef)) +* Add preview MultipartUploadClient#createMultipartUpload https://github.com/googleapis/java-storage/pull/3356 ([160fa9a](https://github.com/googleapis/java-storage/commit/160fa9af7aa492373a9d9b40f65a6c56d7cab5ef)) +* Add preview MultipartUploadClient#listParts https://github.com/googleapis/java-storage/pull/3359 ([160fa9a](https://github.com/googleapis/java-storage/commit/160fa9af7aa492373a9d9b40f65a6c56d7cab5ef)) +* Add preview MultipartUploadClient#uploadPart https://github.com/googleapis/java-storage/pull/3375 ([160fa9a](https://github.com/googleapis/java-storage/commit/160fa9af7aa492373a9d9b40f65a6c56d7cab5ef)) +* Add preview MultipartUploadSettings ([160fa9a](https://github.com/googleapis/java-storage/commit/160fa9af7aa492373a9d9b40f65a6c56d7cab5ef)) + + +### Bug Fixes + +* Add new system property (com.google.cloud.storage.grpc.bound_token) to allow disabling bound token use with grpc ([#3365](https://github.com/googleapis/java-storage/issues/3365)) ([ebf5e6d](https://github.com/googleapis/java-storage/commit/ebf5e6d30d8dc197ab388a70cc0d465c0f740496)) +* Call response.disconnect() after resolving resumable upload url ([#3385](https://github.com/googleapis/java-storage/issues/3385)) ([ac3be4b](https://github.com/googleapis/java-storage/commit/ac3be4b7e82d9340ede7d527a26ffe3e2ba58909)) +* **deps:** Update the Java code generator (gapic-generator-java) to 2.63.0 ([c1a8968](https://github.com/googleapis/java-storage/commit/c1a8968799c1cf5a970fe9f303adccdad0a117c8)) + + +### Dependencies + +* Update dependency com.google.cloud:sdk-platform-java-config to v3.54.1 ([#3381](https://github.com/googleapis/java-storage/issues/3381)) ([e3d3700](https://github.com/googleapis/java-storage/commit/e3d3700e06de2b0113e1cb01e99ef4aeed3c62c9)) + ## [2.59.0](https://github.com/googleapis/java-storage/compare/v2.58.1...v2.59.0) (2025-10-21) diff --git a/README.md b/README.md index 4fa6de6833..c6e229a2f1 100644 --- a/README.md +++ b/README.md @@ -66,13 +66,13 @@ implementation 'com.google.cloud:google-cloud-storage' If you are using Gradle without BOM, add this to your dependencies: ```Groovy -implementation 'com.google.cloud:google-cloud-storage:2.59.0' +implementation 'com.google.cloud:google-cloud-storage:2.60.0' ``` If you are using SBT, add this to your dependencies: ```Scala -libraryDependencies += "com.google.cloud" % "google-cloud-storage" % "2.59.0" +libraryDependencies += "com.google.cloud" % "google-cloud-storage" % "2.60.0" ``` ## Authentication @@ -484,7 +484,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-storage/java11.html [stability-image]: https://img.shields.io/badge/stability-stable-green [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-storage.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-storage/2.59.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-storage/2.60.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/gapic-google-cloud-storage-v2/pom.xml b/gapic-google-cloud-storage-v2/pom.xml index eb10795fd7..831491d148 100644 --- a/gapic-google-cloud-storage-v2/pom.xml +++ b/gapic-google-cloud-storage-v2/pom.xml @@ -4,13 +4,13 @@ 4.0.0 com.google.api.grpc gapic-google-cloud-storage-v2 - 2.59.1-SNAPSHOT + 2.60.0 gapic-google-cloud-storage-v2 GRPC library for gapic-google-cloud-storage-v2 com.google.cloud google-cloud-storage-parent - 2.59.1-SNAPSHOT + 2.60.0 diff --git a/google-cloud-storage-bom/pom.xml b/google-cloud-storage-bom/pom.xml index 73ed033a1e..49f96d0569 100644 --- a/google-cloud-storage-bom/pom.xml +++ b/google-cloud-storage-bom/pom.xml @@ -19,7 +19,7 @@ 4.0.0 com.google.cloud google-cloud-storage-bom - 2.59.1-SNAPSHOT + 2.60.0 pom com.google.cloud @@ -69,37 +69,37 @@ com.google.cloud google-cloud-storage - 2.59.1-SNAPSHOT + 2.60.0 com.google.api.grpc gapic-google-cloud-storage-v2 - 2.59.1-SNAPSHOT + 2.60.0 com.google.api.grpc grpc-google-cloud-storage-v2 - 2.59.1-SNAPSHOT + 2.60.0 com.google.api.grpc proto-google-cloud-storage-v2 - 2.59.1-SNAPSHOT + 2.60.0 com.google.cloud google-cloud-storage-control - 2.59.1-SNAPSHOT + 2.60.0 com.google.api.grpc grpc-google-cloud-storage-control-v2 - 2.59.1-SNAPSHOT + 2.60.0 com.google.api.grpc proto-google-cloud-storage-control-v2 - 2.59.1-SNAPSHOT + 2.60.0 diff --git a/google-cloud-storage-control/pom.xml b/google-cloud-storage-control/pom.xml index d85264ab04..3124bce20c 100644 --- a/google-cloud-storage-control/pom.xml +++ b/google-cloud-storage-control/pom.xml @@ -5,13 +5,13 @@ 4.0.0 com.google.cloud google-cloud-storage-control - 2.59.1-SNAPSHOT + 2.60.0 google-cloud-storage-control GRPC library for google-cloud-storage-control com.google.cloud google-cloud-storage-parent - 2.59.1-SNAPSHOT + 2.60.0 diff --git a/google-cloud-storage/pom.xml b/google-cloud-storage/pom.xml index 54492aff0b..69543226f4 100644 --- a/google-cloud-storage/pom.xml +++ b/google-cloud-storage/pom.xml @@ -2,7 +2,7 @@ 4.0.0 google-cloud-storage - 2.59.1-SNAPSHOT + 2.60.0 jar Google Cloud Storage https://github.com/googleapis/java-storage @@ -12,7 +12,7 @@ com.google.cloud google-cloud-storage-parent - 2.59.1-SNAPSHOT + 2.60.0 google-cloud-storage diff --git a/grpc-google-cloud-storage-control-v2/pom.xml b/grpc-google-cloud-storage-control-v2/pom.xml index 3e6ac29825..ad8de05040 100644 --- a/grpc-google-cloud-storage-control-v2/pom.xml +++ b/grpc-google-cloud-storage-control-v2/pom.xml @@ -4,13 +4,13 @@ 4.0.0 com.google.api.grpc grpc-google-cloud-storage-control-v2 - 2.59.1-SNAPSHOT + 2.60.0 grpc-google-cloud-storage-control-v2 GRPC library for google-cloud-storage com.google.cloud google-cloud-storage-parent - 2.59.1-SNAPSHOT + 2.60.0 diff --git a/grpc-google-cloud-storage-v2/pom.xml b/grpc-google-cloud-storage-v2/pom.xml index 8dd4c9e1e2..52ec9fb17c 100644 --- a/grpc-google-cloud-storage-v2/pom.xml +++ b/grpc-google-cloud-storage-v2/pom.xml @@ -4,13 +4,13 @@ 4.0.0 com.google.api.grpc grpc-google-cloud-storage-v2 - 2.59.1-SNAPSHOT + 2.60.0 grpc-google-cloud-storage-v2 GRPC library for grpc-google-cloud-storage-v2 com.google.cloud google-cloud-storage-parent - 2.59.1-SNAPSHOT + 2.60.0 diff --git a/pom.xml b/pom.xml index 95e2aad296..1cda67bd46 100644 --- a/pom.xml +++ b/pom.xml @@ -4,7 +4,7 @@ com.google.cloud google-cloud-storage-parent pom - 2.59.1-SNAPSHOT + 2.60.0 Storage Parent https://github.com/googleapis/java-storage @@ -82,7 +82,7 @@ com.google.cloud google-cloud-storage - 2.59.1-SNAPSHOT + 2.60.0 com.google.apis @@ -104,32 +104,32 @@ com.google.api.grpc proto-google-cloud-storage-v2 - 2.59.1-SNAPSHOT + 2.60.0 com.google.api.grpc grpc-google-cloud-storage-v2 - 2.59.1-SNAPSHOT + 2.60.0 com.google.api.grpc gapic-google-cloud-storage-v2 - 2.59.1-SNAPSHOT + 2.60.0 com.google.api.grpc grpc-google-cloud-storage-control-v2 - 2.59.1-SNAPSHOT + 2.60.0 com.google.api.grpc proto-google-cloud-storage-control-v2 - 2.59.1-SNAPSHOT + 2.60.0 com.google.cloud google-cloud-storage-control - 2.59.1-SNAPSHOT + 2.60.0 com.google.cloud diff --git a/proto-google-cloud-storage-control-v2/pom.xml b/proto-google-cloud-storage-control-v2/pom.xml index edf1e6e394..859ca38843 100644 --- a/proto-google-cloud-storage-control-v2/pom.xml +++ b/proto-google-cloud-storage-control-v2/pom.xml @@ -4,13 +4,13 @@ 4.0.0 com.google.api.grpc proto-google-cloud-storage-control-v2 - 2.59.1-SNAPSHOT + 2.60.0 proto-google-cloud-storage-control-v2 Proto library for proto-google-cloud-storage-control-v2 com.google.cloud google-cloud-storage-parent - 2.59.1-SNAPSHOT + 2.60.0 diff --git a/proto-google-cloud-storage-v2/pom.xml b/proto-google-cloud-storage-v2/pom.xml index 44c2c2eb35..10182eded6 100644 --- a/proto-google-cloud-storage-v2/pom.xml +++ b/proto-google-cloud-storage-v2/pom.xml @@ -4,13 +4,13 @@ 4.0.0 com.google.api.grpc proto-google-cloud-storage-v2 - 2.59.1-SNAPSHOT + 2.60.0 proto-google-cloud-storage-v2 PROTO library for proto-google-cloud-storage-v2 com.google.cloud google-cloud-storage-parent - 2.59.1-SNAPSHOT + 2.60.0 diff --git a/samples/snapshot/pom.xml b/samples/snapshot/pom.xml index 1b8a94203f..5a4fe45e1e 100644 --- a/samples/snapshot/pom.xml +++ b/samples/snapshot/pom.xml @@ -28,12 +28,12 @@ com.google.cloud google-cloud-storage - 2.59.1-SNAPSHOT + 2.60.0 com.google.cloud google-cloud-storage-control - 2.59.1-SNAPSHOT + 2.60.0 compile @@ -70,7 +70,7 @@ com.google.cloud google-cloud-storage - 2.59.1-SNAPSHOT + 2.60.0 tests test diff --git a/storage-shared-benchmarking/pom.xml b/storage-shared-benchmarking/pom.xml index ffd421ac14..e3b5df2053 100644 --- a/storage-shared-benchmarking/pom.xml +++ b/storage-shared-benchmarking/pom.xml @@ -10,7 +10,7 @@ com.google.cloud google-cloud-storage-parent - 2.59.1-SNAPSHOT + 2.60.0 @@ -31,7 +31,7 @@ com.google.cloud google-cloud-storage - 2.59.1-SNAPSHOT + 2.60.0 tests diff --git a/versions.txt b/versions.txt index 47e29cbca1..bc872205ab 100644 --- a/versions.txt +++ b/versions.txt @@ -1,10 +1,10 @@ # Format: # module:released-version:current-version -google-cloud-storage:2.59.0:2.59.1-SNAPSHOT -gapic-google-cloud-storage-v2:2.59.0:2.59.1-SNAPSHOT -grpc-google-cloud-storage-v2:2.59.0:2.59.1-SNAPSHOT -proto-google-cloud-storage-v2:2.59.0:2.59.1-SNAPSHOT -google-cloud-storage-control:2.59.0:2.59.1-SNAPSHOT -proto-google-cloud-storage-control-v2:2.59.0:2.59.1-SNAPSHOT -grpc-google-cloud-storage-control-v2:2.59.0:2.59.1-SNAPSHOT +google-cloud-storage:2.60.0:2.60.0 +gapic-google-cloud-storage-v2:2.60.0:2.60.0 +grpc-google-cloud-storage-v2:2.60.0:2.60.0 +proto-google-cloud-storage-v2:2.60.0:2.60.0 +google-cloud-storage-control:2.60.0:2.60.0 +proto-google-cloud-storage-control-v2:2.60.0:2.60.0 +grpc-google-cloud-storage-control-v2:2.60.0:2.60.0 From 9f7506420843612773ae68de89596d41ccb9181c Mon Sep 17 00:00:00 2001 From: "release-please[bot]" <55107282+release-please[bot]@users.noreply.github.com> Date: Mon, 10 Nov 2025 11:42:38 -0500 Subject: [PATCH 11/26] chore(main): release 2.60.1-SNAPSHOT (#3390) Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com> --- gapic-google-cloud-storage-v2/pom.xml | 4 ++-- google-cloud-storage-bom/pom.xml | 16 ++++++++-------- google-cloud-storage-control/pom.xml | 4 ++-- google-cloud-storage/pom.xml | 4 ++-- grpc-google-cloud-storage-control-v2/pom.xml | 4 ++-- grpc-google-cloud-storage-v2/pom.xml | 4 ++-- pom.xml | 16 ++++++++-------- proto-google-cloud-storage-control-v2/pom.xml | 4 ++-- proto-google-cloud-storage-v2/pom.xml | 4 ++-- samples/snapshot/pom.xml | 6 +++--- storage-shared-benchmarking/pom.xml | 4 ++-- versions.txt | 14 +++++++------- 12 files changed, 42 insertions(+), 42 deletions(-) diff --git a/gapic-google-cloud-storage-v2/pom.xml b/gapic-google-cloud-storage-v2/pom.xml index 831491d148..4d78249222 100644 --- a/gapic-google-cloud-storage-v2/pom.xml +++ b/gapic-google-cloud-storage-v2/pom.xml @@ -4,13 +4,13 @@ 4.0.0 com.google.api.grpc gapic-google-cloud-storage-v2 - 2.60.0 + 2.60.1-SNAPSHOT gapic-google-cloud-storage-v2 GRPC library for gapic-google-cloud-storage-v2 com.google.cloud google-cloud-storage-parent - 2.60.0 + 2.60.1-SNAPSHOT diff --git a/google-cloud-storage-bom/pom.xml b/google-cloud-storage-bom/pom.xml index 49f96d0569..1eaee5f54e 100644 --- a/google-cloud-storage-bom/pom.xml +++ b/google-cloud-storage-bom/pom.xml @@ -19,7 +19,7 @@ 4.0.0 com.google.cloud google-cloud-storage-bom - 2.60.0 + 2.60.1-SNAPSHOT pom com.google.cloud @@ -69,37 +69,37 @@ com.google.cloud google-cloud-storage - 2.60.0 + 2.60.1-SNAPSHOT com.google.api.grpc gapic-google-cloud-storage-v2 - 2.60.0 + 2.60.1-SNAPSHOT com.google.api.grpc grpc-google-cloud-storage-v2 - 2.60.0 + 2.60.1-SNAPSHOT com.google.api.grpc proto-google-cloud-storage-v2 - 2.60.0 + 2.60.1-SNAPSHOT com.google.cloud google-cloud-storage-control - 2.60.0 + 2.60.1-SNAPSHOT com.google.api.grpc grpc-google-cloud-storage-control-v2 - 2.60.0 + 2.60.1-SNAPSHOT com.google.api.grpc proto-google-cloud-storage-control-v2 - 2.60.0 + 2.60.1-SNAPSHOT diff --git a/google-cloud-storage-control/pom.xml b/google-cloud-storage-control/pom.xml index 3124bce20c..5d243dc419 100644 --- a/google-cloud-storage-control/pom.xml +++ b/google-cloud-storage-control/pom.xml @@ -5,13 +5,13 @@ 4.0.0 com.google.cloud google-cloud-storage-control - 2.60.0 + 2.60.1-SNAPSHOT google-cloud-storage-control GRPC library for google-cloud-storage-control com.google.cloud google-cloud-storage-parent - 2.60.0 + 2.60.1-SNAPSHOT diff --git a/google-cloud-storage/pom.xml b/google-cloud-storage/pom.xml index 69543226f4..56552e51e7 100644 --- a/google-cloud-storage/pom.xml +++ b/google-cloud-storage/pom.xml @@ -2,7 +2,7 @@ 4.0.0 google-cloud-storage - 2.60.0 + 2.60.1-SNAPSHOT jar Google Cloud Storage https://github.com/googleapis/java-storage @@ -12,7 +12,7 @@ com.google.cloud google-cloud-storage-parent - 2.60.0 + 2.60.1-SNAPSHOT google-cloud-storage diff --git a/grpc-google-cloud-storage-control-v2/pom.xml b/grpc-google-cloud-storage-control-v2/pom.xml index ad8de05040..4c9ad3d268 100644 --- a/grpc-google-cloud-storage-control-v2/pom.xml +++ b/grpc-google-cloud-storage-control-v2/pom.xml @@ -4,13 +4,13 @@ 4.0.0 com.google.api.grpc grpc-google-cloud-storage-control-v2 - 2.60.0 + 2.60.1-SNAPSHOT grpc-google-cloud-storage-control-v2 GRPC library for google-cloud-storage com.google.cloud google-cloud-storage-parent - 2.60.0 + 2.60.1-SNAPSHOT diff --git a/grpc-google-cloud-storage-v2/pom.xml b/grpc-google-cloud-storage-v2/pom.xml index 52ec9fb17c..0a99cea3bc 100644 --- a/grpc-google-cloud-storage-v2/pom.xml +++ b/grpc-google-cloud-storage-v2/pom.xml @@ -4,13 +4,13 @@ 4.0.0 com.google.api.grpc grpc-google-cloud-storage-v2 - 2.60.0 + 2.60.1-SNAPSHOT grpc-google-cloud-storage-v2 GRPC library for grpc-google-cloud-storage-v2 com.google.cloud google-cloud-storage-parent - 2.60.0 + 2.60.1-SNAPSHOT diff --git a/pom.xml b/pom.xml index 1cda67bd46..11e328f18d 100644 --- a/pom.xml +++ b/pom.xml @@ -4,7 +4,7 @@ com.google.cloud google-cloud-storage-parent pom - 2.60.0 + 2.60.1-SNAPSHOT Storage Parent https://github.com/googleapis/java-storage @@ -82,7 +82,7 @@ com.google.cloud google-cloud-storage - 2.60.0 + 2.60.1-SNAPSHOT com.google.apis @@ -104,32 +104,32 @@ com.google.api.grpc proto-google-cloud-storage-v2 - 2.60.0 + 2.60.1-SNAPSHOT com.google.api.grpc grpc-google-cloud-storage-v2 - 2.60.0 + 2.60.1-SNAPSHOT com.google.api.grpc gapic-google-cloud-storage-v2 - 2.60.0 + 2.60.1-SNAPSHOT com.google.api.grpc grpc-google-cloud-storage-control-v2 - 2.60.0 + 2.60.1-SNAPSHOT com.google.api.grpc proto-google-cloud-storage-control-v2 - 2.60.0 + 2.60.1-SNAPSHOT com.google.cloud google-cloud-storage-control - 2.60.0 + 2.60.1-SNAPSHOT com.google.cloud diff --git a/proto-google-cloud-storage-control-v2/pom.xml b/proto-google-cloud-storage-control-v2/pom.xml index 859ca38843..8727018370 100644 --- a/proto-google-cloud-storage-control-v2/pom.xml +++ b/proto-google-cloud-storage-control-v2/pom.xml @@ -4,13 +4,13 @@ 4.0.0 com.google.api.grpc proto-google-cloud-storage-control-v2 - 2.60.0 + 2.60.1-SNAPSHOT proto-google-cloud-storage-control-v2 Proto library for proto-google-cloud-storage-control-v2 com.google.cloud google-cloud-storage-parent - 2.60.0 + 2.60.1-SNAPSHOT diff --git a/proto-google-cloud-storage-v2/pom.xml b/proto-google-cloud-storage-v2/pom.xml index 10182eded6..f05f4253b9 100644 --- a/proto-google-cloud-storage-v2/pom.xml +++ b/proto-google-cloud-storage-v2/pom.xml @@ -4,13 +4,13 @@ 4.0.0 com.google.api.grpc proto-google-cloud-storage-v2 - 2.60.0 + 2.60.1-SNAPSHOT proto-google-cloud-storage-v2 PROTO library for proto-google-cloud-storage-v2 com.google.cloud google-cloud-storage-parent - 2.60.0 + 2.60.1-SNAPSHOT diff --git a/samples/snapshot/pom.xml b/samples/snapshot/pom.xml index 5a4fe45e1e..bc204e262e 100644 --- a/samples/snapshot/pom.xml +++ b/samples/snapshot/pom.xml @@ -28,12 +28,12 @@ com.google.cloud google-cloud-storage - 2.60.0 + 2.60.1-SNAPSHOT com.google.cloud google-cloud-storage-control - 2.60.0 + 2.60.1-SNAPSHOT compile @@ -70,7 +70,7 @@ com.google.cloud google-cloud-storage - 2.60.0 + 2.60.1-SNAPSHOT tests test diff --git a/storage-shared-benchmarking/pom.xml b/storage-shared-benchmarking/pom.xml index e3b5df2053..96f3a165bc 100644 --- a/storage-shared-benchmarking/pom.xml +++ b/storage-shared-benchmarking/pom.xml @@ -10,7 +10,7 @@ com.google.cloud google-cloud-storage-parent - 2.60.0 + 2.60.1-SNAPSHOT @@ -31,7 +31,7 @@ com.google.cloud google-cloud-storage - 2.60.0 + 2.60.1-SNAPSHOT tests diff --git a/versions.txt b/versions.txt index bc872205ab..f1084624ee 100644 --- a/versions.txt +++ b/versions.txt @@ -1,10 +1,10 @@ # Format: # module:released-version:current-version -google-cloud-storage:2.60.0:2.60.0 -gapic-google-cloud-storage-v2:2.60.0:2.60.0 -grpc-google-cloud-storage-v2:2.60.0:2.60.0 -proto-google-cloud-storage-v2:2.60.0:2.60.0 -google-cloud-storage-control:2.60.0:2.60.0 -proto-google-cloud-storage-control-v2:2.60.0:2.60.0 -grpc-google-cloud-storage-control-v2:2.60.0:2.60.0 +google-cloud-storage:2.60.0:2.60.1-SNAPSHOT +gapic-google-cloud-storage-v2:2.60.0:2.60.1-SNAPSHOT +grpc-google-cloud-storage-v2:2.60.0:2.60.1-SNAPSHOT +proto-google-cloud-storage-v2:2.60.0:2.60.1-SNAPSHOT +google-cloud-storage-control:2.60.0:2.60.1-SNAPSHOT +proto-google-cloud-storage-control-v2:2.60.0:2.60.1-SNAPSHOT +grpc-google-cloud-storage-control-v2:2.60.0:2.60.1-SNAPSHOT From 6b9562c265dbcffe0df940dfa33742fc575fb05a Mon Sep 17 00:00:00 2001 From: cloud-java-bot <122572305+cloud-java-bot@users.noreply.github.com> Date: Mon, 10 Nov 2025 11:48:10 -0500 Subject: [PATCH 12/26] chore: Update generation configuration at Sat Nov 8 02:26:58 UTC 2025 (#3371) --- .../hermetic_library_generation.yaml | 2 +- .kokoro/presubmit/graalvm-native-a.cfg | 2 +- .kokoro/presubmit/graalvm-native-b.cfg | 2 +- .kokoro/presubmit/graalvm-native-c.cfg | 2 +- .../com/google/storage/v2/StorageClient.java | 981 ++++++--- .../com/google/storage/v2/package-info.java | 27 +- generation_config.yaml | 4 +- .../control/v2/StorageControlGrpc.java | 127 +- .../com/google/storage/v2/StorageGrpc.java | 1291 ++++++++---- .../google/storage/v2/AppendObjectSpec.java | 18 +- .../storage/v2/AppendObjectSpecOrBuilder.java | 6 +- .../com/google/storage/v2/BidiReadHandle.java | 8 +- .../v2/BidiReadObjectRedirectedError.java | 52 +- ...idiReadObjectRedirectedErrorOrBuilder.java | 12 +- .../storage/v2/BidiReadObjectRequest.java | 238 +-- .../v2/BidiReadObjectRequestOrBuilder.java | 52 +- .../storage/v2/BidiReadObjectResponse.java | 260 +-- .../v2/BidiReadObjectResponseOrBuilder.java | 56 +- .../google/storage/v2/BidiReadObjectSpec.java | 140 +- .../v2/BidiReadObjectSpecOrBuilder.java | 37 +- .../google/storage/v2/BidiWriteHandle.java | 12 +- .../v2/BidiWriteObjectRedirectedError.java | 64 +- ...diWriteObjectRedirectedErrorOrBuilder.java | 18 +- .../storage/v2/BidiWriteObjectRequest.java | 190 +- .../v2/BidiWriteObjectRequestOrBuilder.java | 46 +- .../storage/v2/BidiWriteObjectResponse.java | 24 +- .../v2/BidiWriteObjectResponseOrBuilder.java | 6 +- .../java/com/google/storage/v2/Bucket.java | 1823 ++++++++--------- .../storage/v2/BucketAccessControl.java | 70 +- .../v2/BucketAccessControlOrBuilder.java | 20 +- .../google/storage/v2/BucketOrBuilder.java | 221 +- .../v2/CancelResumableWriteRequest.java | 8 +- .../v2/CancelResumableWriteResponse.java | 4 +- .../storage/v2/CommonObjectRequestParams.java | 16 +- .../CommonObjectRequestParamsOrBuilder.java | 4 +- .../storage/v2/ComposeObjectRequest.java | 202 +- .../v2/ComposeObjectRequestOrBuilder.java | 44 +- .../storage/v2/CreateBucketRequest.java | 168 +- .../v2/CreateBucketRequestOrBuilder.java | 46 +- .../google/storage/v2/CustomerEncryption.java | 8 +- .../storage/v2/DeleteBucketRequest.java | 4 +- .../storage/v2/DeleteObjectRequest.java | 6 +- .../google/storage/v2/GetBucketRequest.java | 88 +- .../storage/v2/GetBucketRequestOrBuilder.java | 24 +- .../google/storage/v2/GetObjectRequest.java | 118 +- .../storage/v2/GetObjectRequestOrBuilder.java | 30 +- .../google/storage/v2/ListBucketsRequest.java | 201 +- .../v2/ListBucketsRequestOrBuilder.java | 38 +- .../storage/v2/ListBucketsResponse.java | 411 +++- .../v2/ListBucketsResponseOrBuilder.java | 90 + .../google/storage/v2/ListObjectsRequest.java | 352 ++-- .../v2/ListObjectsRequestOrBuilder.java | 95 +- .../v2/LockBucketRetentionPolicyRequest.java | 6 +- .../google/storage/v2/MoveObjectRequest.java | 4 +- .../java/com/google/storage/v2/Object.java | 482 ++--- .../storage/v2/ObjectAccessControl.java | 56 +- .../v2/ObjectAccessControlOrBuilder.java | 16 +- .../google/storage/v2/ObjectChecksums.java | 64 +- .../storage/v2/ObjectChecksumsOrBuilder.java | 17 +- .../google/storage/v2/ObjectOrBuilder.java | 124 +- .../google/storage/v2/ObjectRangeData.java | 120 +- .../storage/v2/ObjectRangeDataOrBuilder.java | 30 +- .../storage/v2/QueryWriteStatusRequest.java | 6 +- .../storage/v2/QueryWriteStatusResponse.java | 6 +- .../google/storage/v2/ReadObjectRequest.java | 148 +- .../v2/ReadObjectRequestOrBuilder.java | 36 +- .../google/storage/v2/ReadObjectResponse.java | 100 +- .../v2/ReadObjectResponseOrBuilder.java | 24 +- .../java/com/google/storage/v2/ReadRange.java | 108 +- .../google/storage/v2/ReadRangeOrBuilder.java | 26 +- .../storage/v2/RestoreObjectRequest.java | 18 +- .../v2/RestoreObjectRequestOrBuilder.java | 4 +- .../storage/v2/RewriteObjectRequest.java | 176 +- .../v2/RewriteObjectRequestOrBuilder.java | 38 +- .../google/storage/v2/ServiceConstants.java | 8 +- .../v2/StartResumableWriteRequest.java | 6 +- .../v2/StartResumableWriteResponse.java | 6 +- .../com/google/storage/v2/StorageProto.java | 323 +-- .../storage/v2/UpdateBucketRequest.java | 144 +- .../v2/UpdateBucketRequestOrBuilder.java | 40 +- .../storage/v2/UpdateObjectRequest.java | 28 +- .../v2/UpdateObjectRequestOrBuilder.java | 6 +- .../google/storage/v2/WriteObjectRequest.java | 172 +- .../v2/WriteObjectRequestOrBuilder.java | 42 +- .../storage/v2/WriteObjectResponse.java | 6 +- .../google/storage/v2/WriteObjectSpec.java | 88 +- .../storage/v2/WriteObjectSpecOrBuilder.java | 28 +- .../proto/google/storage/v2/storage.proto | 1040 ++++++---- 88 files changed, 6549 insertions(+), 4765 deletions(-) diff --git a/.github/workflows/hermetic_library_generation.yaml b/.github/workflows/hermetic_library_generation.yaml index 76c6ec9ee6..005c97c7de 100644 --- a/.github/workflows/hermetic_library_generation.yaml +++ b/.github/workflows/hermetic_library_generation.yaml @@ -43,7 +43,7 @@ jobs: with: fetch-depth: 0 token: ${{ secrets.CLOUD_JAVA_BOT_TOKEN }} - - uses: googleapis/sdk-platform-java/.github/scripts@v2.64.0 + - uses: googleapis/sdk-platform-java/.github/scripts@v2.64.1 if: env.SHOULD_RUN == 'true' with: base_ref: ${{ github.base_ref }} diff --git a/.kokoro/presubmit/graalvm-native-a.cfg b/.kokoro/presubmit/graalvm-native-a.cfg index 55c5543e26..b772eac66c 100644 --- a/.kokoro/presubmit/graalvm-native-a.cfg +++ b/.kokoro/presubmit/graalvm-native-a.cfg @@ -3,7 +3,7 @@ # Configure the docker image for kokoro-trampoline. env_vars: { key: "TRAMPOLINE_IMAGE" - value: "gcr.io/cloud-devrel-public-resources/graalvm_sdk_platform_a:3.53.0" # {x-version-update:google-cloud-shared-dependencies:current} + value: "gcr.io/cloud-devrel-public-resources/graalvm_sdk_platform_a:3.54.1" # {x-version-update:google-cloud-shared-dependencies:current} } env_vars: { diff --git a/.kokoro/presubmit/graalvm-native-b.cfg b/.kokoro/presubmit/graalvm-native-b.cfg index 5c981b9848..baf136cf82 100644 --- a/.kokoro/presubmit/graalvm-native-b.cfg +++ b/.kokoro/presubmit/graalvm-native-b.cfg @@ -3,7 +3,7 @@ # Configure the docker image for kokoro-trampoline. env_vars: { key: "TRAMPOLINE_IMAGE" - value: "gcr.io/cloud-devrel-public-resources/graalvm_sdk_platform_b:3.53.0" # {x-version-update:google-cloud-shared-dependencies:current} + value: "gcr.io/cloud-devrel-public-resources/graalvm_sdk_platform_b:3.54.1" # {x-version-update:google-cloud-shared-dependencies:current} } env_vars: { diff --git a/.kokoro/presubmit/graalvm-native-c.cfg b/.kokoro/presubmit/graalvm-native-c.cfg index f2032499df..2fb2fc87c4 100644 --- a/.kokoro/presubmit/graalvm-native-c.cfg +++ b/.kokoro/presubmit/graalvm-native-c.cfg @@ -3,7 +3,7 @@ # Configure the docker image for kokoro-trampoline. env_vars: { key: "TRAMPOLINE_IMAGE" - value: "gcr.io/cloud-devrel-public-resources/graalvm_sdk_platform_c:3.53.0" # {x-version-update:google-cloud-shared-dependencies:current} + value: "gcr.io/cloud-devrel-public-resources/graalvm_sdk_platform_c:3.54.1" # {x-version-update:google-cloud-shared-dependencies:current} } env_vars: { diff --git a/gapic-google-cloud-storage-v2/src/main/java/com/google/storage/v2/StorageClient.java b/gapic-google-cloud-storage-v2/src/main/java/com/google/storage/v2/StorageClient.java index f2a8178d21..1c0887d4ed 100644 --- a/gapic-google-cloud-storage-v2/src/main/java/com/google/storage/v2/StorageClient.java +++ b/gapic-google-cloud-storage-v2/src/main/java/com/google/storage/v2/StorageClient.java @@ -48,18 +48,21 @@ * Service Description: ## API Overview and Naming Syntax * *

The Cloud Storage gRPC API allows applications to read and write data through the abstractions - * of buckets and objects. For a description of these abstractions please see - * https://cloud.google.com/storage/docs. + * of buckets and objects. For a description of these abstractions please see [Cloud Storage + * documentation](https://cloud.google.com/storage/docs). * - *

Resources are named as follows: - Projects are referred to as they are defined by the Resource - * Manager API, using strings like `projects/123456` or `projects/my-string-id`. - Buckets are named - * using string names of the form: `projects/{project}/buckets/{bucket}` For globally unique - * buckets, `_` may be substituted for the project. - Objects are uniquely identified by their name - * along with the name of the bucket they belong to, as separate strings in this API. For example: + *

Resources are named as follows: * - *

ReadObjectRequest { bucket: 'projects/_/buckets/my-bucket' object: 'my-object' } Note that - * object names can contain `/` characters, which are treated as any other character (no special - * directory semantics). + *

- Projects are referred to as they are defined by the Resource Manager API, using strings like + * `projects/123456` or `projects/my-string-id`. - Buckets are named using string names of the form: + * `projects/{project}/buckets/{bucket}`. For globally unique buckets, `_` might be substituted for + * the project. - Objects are uniquely identified by their name along with the name of the bucket + * they belong to, as separate strings in this API. For example: + * + *

``` ReadObjectRequest { bucket: 'projects/_/buckets/my-bucket' object: 'my-object' } ``` + * + *

Note that object names can contain `/` characters, which are treated as any other character + * (no special directory semantics). * *

This class provides the ability to make remote calls to the backing service through method * calls that map to API methods. Sample code to get started: @@ -88,7 +91,11 @@ * * *

DeleteBucket - *

Permanently deletes an empty bucket. + *

Permanently deletes an empty bucket. The request fails if there are any live or noncurrent objects in the bucket, but the request succeeds if the bucket only contains soft-deleted objects or incomplete uploads, such as ongoing XML API multipart uploads. Does not permanently delete soft-deleted objects. + *

When this API is used to delete a bucket containing an object that has a soft delete policy enabled, the object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime` properties are set on the object. + *

Objects and multipart uploads that were in the bucket at the time of deletion are also retained for the specified retention duration. When a soft-deleted bucket reaches the end of its retention duration, it is permanently deleted. The `hardDeleteTime` of the bucket always equals or exceeds the expiration time of the last soft-deleted object in the bucket. + *

**IAM Permissions**: + *

Requires `storage.buckets.delete` IAM permission on the bucket. * *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    @@ -107,7 +114,10 @@ * * *

    GetBucket - *

    Returns metadata for the specified bucket. + *

    Returns metadata for the specified bucket. + *

    **IAM Permissions**: + *

    Requires `storage.buckets.get` IAM permission on the bucket. Additionally, to return specific bucket metadata, the authenticated user must have the following permissions: + *

    - To return the IAM policies: `storage.buckets.getIamPolicy` - To return the bucket IP filtering rules: `storage.buckets.getIpFilter` * *

    Request object method variants only take one parameter, a request object, which must be constructed before the call.

    *
      @@ -126,7 +136,10 @@ * * *

      CreateBucket - *

      Creates a new bucket. + *

      Creates a new bucket. + *

      **IAM Permissions**: + *

      Requires `storage.buckets.create` IAM permission on the bucket. Additionally, to enable specific bucket features, the authenticated user must have the following permissions: + *

      - To enable object retention using the `enableObjectRetention` query parameter: `storage.buckets.enableObjectRetention` - To set the bucket IP filtering rules: `storage.buckets.setIpFilter` * *

      Request object method variants only take one parameter, a request object, which must be constructed before the call.

      *
        @@ -145,7 +158,10 @@ * * *

        ListBuckets - *

        Retrieves a list of buckets for a given project. + *

        Retrieves a list of buckets for a given project, ordered lexicographically by name. + *

        **IAM Permissions**: + *

        Requires `storage.buckets.list` IAM permission on the bucket. Additionally, to enable specific bucket features, the authenticated user must have the following permissions: + *

        - To list the IAM policies: `storage.buckets.getIamPolicy` - To list the bucket IP filtering rules: `storage.buckets.getIpFilter` * *

        Request object method variants only take one parameter, a request object, which must be constructed before the call.

        *
          @@ -165,7 +181,12 @@ * * *

          LockBucketRetentionPolicy - *

          Locks retention policy on a bucket. + *

          Permanently locks the retention policy that is currently applied to the specified bucket. + *

          Caution: Locking a bucket is an irreversible action. Once you lock a bucket: + *

          - You cannot remove the retention policy from the bucket. - You cannot decrease the retention period for the policy. + *

          Once locked, you must delete the entire bucket in order to remove the bucket's retention policy. However, before you can delete the bucket, you must delete all the objects in the bucket, which is only possible if all the objects have reached the retention period set by the retention policy. + *

          **IAM Permissions**: + *

          Requires `storage.buckets.update` IAM permission on the bucket. * *

          Request object method variants only take one parameter, a request object, which must be constructed before the call.

          *
            @@ -184,7 +205,9 @@ * * *

            GetIamPolicy - *

            Gets the IAM policy for a specified bucket. The `resource` field in the request should be `projects/_/buckets/{bucket}` for a bucket, or `projects/_/buckets/{bucket}/managedFolders/{managedFolder}` for a managed folder. + *

            Gets the IAM policy for a specified bucket or managed folder. The `resource` field in the request should be `projects/_/buckets/{bucket}` for a bucket, or `projects/_/buckets/{bucket}/managedFolders/{managedFolder}` for a managed folder. + *

            **IAM Permissions**: + *

            Requires `storage.buckets.getIamPolicy` on the bucket or `storage.managedFolders.getIamPolicy` IAM permission on the managed folder. * *

            Request object method variants only take one parameter, a request object, which must be constructed before the call.

            *
              @@ -203,7 +226,7 @@ * * *

              SetIamPolicy - *

              Updates an IAM policy for the specified bucket. The `resource` field in the request should be `projects/_/buckets/{bucket}` for a bucket, or `projects/_/buckets/{bucket}/managedFolders/{managedFolder}` for a managed folder. + *

              Updates an IAM policy for the specified bucket or managed folder. The `resource` field in the request should be `projects/_/buckets/{bucket}` for a bucket, or `projects/_/buckets/{bucket}/managedFolders/{managedFolder}` for a managed folder. * *

              Request object method variants only take one parameter, a request object, which must be constructed before the call.

              *
                @@ -241,7 +264,10 @@ * * *

                UpdateBucket - *

                Updates a bucket. Equivalent to JSON API's storage.buckets.patch method. + *

                Updates a bucket. Changes to the bucket are readable immediately after writing, but configuration changes might take time to propagate. This method supports `patch` semantics. + *

                **IAM Permissions**: + *

                Requires `storage.buckets.update` IAM permission on the bucket. Additionally, to enable specific bucket features, the authenticated user must have the following permissions: + *

                - To set bucket IP filtering rules: `storage.buckets.setIpFilter` - To update public access prevention policies or access control lists (ACLs): `storage.buckets.setIamPolicy` * *

                Request object method variants only take one parameter, a request object, which must be constructed before the call.

                *
                  @@ -259,7 +285,9 @@ * * *

                  ComposeObject - *

                  Concatenates a list of existing objects into a new object in the same bucket. + *

                  Concatenates a list of existing objects into a new object in the same bucket. The existing source objects are unaffected by this operation. + *

                  **IAM Permissions**: + *

                  Requires the `storage.objects.create` and `storage.objects.get` IAM permissions to use this method. If the new composite object overwrites an existing object, the authenticated user must also have the `storage.objects.delete` permission. If the request body includes the retention property, the authenticated user must also have the `storage.objects.setRetention` IAM permission. * *

                  Request object method variants only take one parameter, a request object, which must be constructed before the call.

                  *
                    @@ -273,10 +301,10 @@ * * *

                    DeleteObject - *

                    Deletes an object and its metadata. Deletions are permanent if versioning is not enabled for the bucket, or if the generation parameter is used, or if [soft delete](https://cloud.google.com/storage/docs/soft-delete) is not enabled for the bucket. When this API is used to delete an object from a bucket that has soft delete policy enabled, the object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime` properties are set on the object. This API cannot be used to permanently delete soft-deleted objects. Soft-deleted objects are permanently deleted according to their `hardDeleteTime`. + *

                    Deletes an object and its metadata. Deletions are permanent if versioning is not enabled for the bucket, or if the generation parameter is used, or if soft delete is not enabled for the bucket. When this API is used to delete an object from a bucket that has soft delete policy enabled, the object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime` properties are set on the object. This API cannot be used to permanently delete soft-deleted objects. Soft-deleted objects are permanently deleted according to their `hardDeleteTime`. *

                    You can use the [`RestoreObject`][google.storage.v2.Storage.RestoreObject] API to restore soft-deleted objects until the soft delete retention period has passed. *

                    **IAM Permissions**: - *

                    Requires `storage.objects.delete` [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket. + *

                    Requires `storage.objects.delete` IAM permission on the bucket. * *

                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                    *
                      @@ -297,7 +325,12 @@ * * *

                      RestoreObject - *

                      Restores a soft-deleted object. + *

                      Restores a soft-deleted object. When a soft-deleted object is restored, a new copy of that object is created in the same bucket and inherits the same metadata as the soft-deleted object. The inherited metadata is the metadata that existed when the original object became soft deleted, with the following exceptions: + *

                      - The `createTime` of the new object is set to the time at which the soft-deleted object was restored. - The `softDeleteTime` and `hardDeleteTime` values are cleared. - A new generation is assigned and the metageneration is reset to 1. - If the soft-deleted object was in a bucket that had Autoclass enabled, the new object is restored to Standard storage. - The restored object inherits the bucket's default object ACL, unless `copySourceAcl` is `true`. + *

                      If a live object using the same name already exists in the bucket and becomes overwritten, the live object becomes a noncurrent object if Object Versioning is enabled on the bucket. If Object Versioning is not enabled, the live object becomes soft deleted. + *

                      **IAM Permissions**: + *

                      Requires the following IAM permissions to use this method: + *

                      - `storage.objects.restore` - `storage.objects.create` - `storage.objects.delete` (only required if overwriting an existing object) - `storage.objects.getIamPolicy` (only required if `projection` is `full` and the relevant bucket has uniform bucket-level access disabled) - `storage.objects.setIamPolicy` (only required if `copySourceAcl` is `true` and the relevant bucket has uniform bucket-level access disabled) * *

                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                      *
                        @@ -317,8 +350,8 @@ * *

                        CancelResumableWrite *

                        Cancels an in-progress resumable upload. - *

                        Any attempts to write to the resumable upload after cancelling the upload will fail. - *

                        The behavior for currently in progress write operations is not guaranteed - they could either complete before the cancellation or fail if the cancellation completes first. + *

                        Any attempts to write to the resumable upload after cancelling the upload fail. + *

                        The behavior for any in-progress write operations is not guaranteed; they could either complete before the cancellation or fail if the cancellation completes first. * *

                        Request object method variants only take one parameter, a request object, which must be constructed before the call.

                        *
                          @@ -338,7 +371,7 @@ *

                          GetObject *

                          Retrieves object metadata. *

                          **IAM Permissions**: - *

                          Requires `storage.objects.get` [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket. To return object ACLs, the authenticated user must also have the `storage.objects.getIamPolicy` permission. + *

                          Requires `storage.objects.get` IAM permission on the bucket. To return object ACLs, the authenticated user must also have the `storage.objects.getIamPolicy` permission. * *

                          Request object method variants only take one parameter, a request object, which must be constructed before the call.

                          *
                            @@ -361,7 +394,7 @@ *

                            ReadObject *

                            Retrieves object data. *

                            **IAM Permissions**: - *

                            Requires `storage.objects.get` [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket. + *

                            Requires `storage.objects.get` IAM permission on the bucket. * *

                            Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                            *
                              @@ -372,11 +405,9 @@ * *

                              BidiReadObject *

                              Reads an object's data. - *

                              This is a bi-directional API with the added support for reading multiple ranges within one stream both within and across multiple messages. If the server encountered an error for any of the inputs, the stream will be closed with the relevant error code. Because the API allows for multiple outstanding requests, when the stream is closed the error response will contain a BidiReadObjectRangesError proto in the error extension describing the error for each outstanding 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 `BidiReadObjectRangesError` field detailing the specific error for each pending `read_id`. *

                              **IAM Permissions**: - *

                              Requires `storage.objects.get` - *

                              [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket. - *

                              This API is currently in preview and is not yet available for general use. + *

                              Requires `storage.objects.get` IAM permission on the bucket. * *

                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                              *
                                @@ -386,7 +417,9 @@ * * *

                                UpdateObject - *

                                Updates an object's metadata. Equivalent to JSON API's storage.objects.patch. + *

                                Updates an object's metadata. Equivalent to JSON API's `storage.objects.patch` method. + *

                                **IAM Permissions**: + *

                                Requires `storage.objects.update` IAM permission on the bucket. * *

                                Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                *
                                  @@ -406,12 +439,13 @@ *

                                  WriteObject *

                                  Stores a new object and metadata. *

                                  An object can be written either in a single message stream or in a resumable sequence of message streams. To write using a single stream, the client should include in the first message of the stream an `WriteObjectSpec` describing the destination bucket, object, and any preconditions. Additionally, the final message must set 'finish_write' to true, or else it is an error. - *

                                  For a resumable write, the client should instead call `StartResumableWrite()`, populating a `WriteObjectSpec` into that request. They should then attach the returned `upload_id` to the first message of each following call to `WriteObject`. If the stream is closed before finishing the upload (either explicitly by the client or due to a network error or an error response from the server), the client should do as follows: - Check the result Status of the stream, to determine if writing can be resumed on this stream or must be restarted from scratch (by calling `StartResumableWrite()`). The resumable errors are DEADLINE_EXCEEDED, INTERNAL, and UNAVAILABLE. For each case, the client should use binary exponential backoff before retrying. Additionally, writes can be resumed after RESOURCE_EXHAUSTED errors, but only after taking appropriate measures, which may include reducing aggregate send rate across clients and/or requesting a quota increase for your project. - If the call to `WriteObject` returns `ABORTED`, that indicates concurrent attempts to update the resumable write, caused either by multiple racing clients or by a single client where the previous request was timed out on the client side but nonetheless reached the server. In this case the client should take steps to prevent further concurrent writes (e.g., increase the timeouts, stop using more than one process to perform the upload, etc.), and then should follow the steps below for resuming the upload. - For resumable errors, the client should call `QueryWriteStatus()` and then continue writing from the returned `persisted_size`. This may be less than the amount of data the client previously sent. Note also that it is acceptable to send data starting at an offset earlier than the returned `persisted_size`; in this case, the service will skip data at offsets that were already persisted (without checking that it matches the previously written data), and write only the data starting from the persisted offset. Even though the data isn't written, it may still incur a performance cost over resuming at the correct write offset. This behavior can make client-side handling simpler in some cases. - Clients must only send data that is a multiple of 256 KiB per message, unless the object is being finished with `finish_write` set to `true`. - *

                                  The service will not view the object as complete until the client has sent a `WriteObjectRequest` with `finish_write` set to `true`. Sending any requests on a stream after sending a request with `finish_write` set to `true` will cause an error. The client **should** check the response it receives to determine how much data the service was able to commit and whether the service views the object as complete. - *

                                  Attempting to resume an already finalized object will result in an OK status, with a `WriteObjectResponse` containing the finalized object's metadata. - *

                                  Alternatively, the BidiWriteObject operation may be used to write an object with controls over flushing and the ability to fetch the ability to determine the current persisted size. + *

                                  For a resumable write, the client should instead call `StartResumableWrite()`, populating a `WriteObjectSpec` into that request. They should then attach the returned `upload_id` to the first message of each following call to `WriteObject`. If the stream is closed before finishing the upload (either explicitly by the client or due to a network error or an error response from the server), the client should do as follows: + *

                                  - Check the result Status of the stream, to determine if writing can be resumed on this stream or must be restarted from scratch (by calling `StartResumableWrite()`). The resumable errors are `DEADLINE_EXCEEDED`, `INTERNAL`, and `UNAVAILABLE`. For each case, the client should use binary exponential backoff before retrying. Additionally, writes can be resumed after `RESOURCE_EXHAUSTED` errors, but only after taking appropriate measures, which might include reducing aggregate send rate across clients and/or requesting a quota increase for your project. - If the call to `WriteObject` returns `ABORTED`, that indicates concurrent attempts to update the resumable write, caused either by multiple racing clients or by a single client where the previous request was timed out on the client side but nonetheless reached the server. In this case the client should take steps to prevent further concurrent writes. For example, increase the timeouts and stop using more than one process to perform the upload. Follow the steps below for resuming the upload. - For resumable errors, the client should call `QueryWriteStatus()` and then continue writing from the returned `persisted_size`. This might be less than the amount of data the client previously sent. Note also that it is acceptable to send data starting at an offset earlier than the returned `persisted_size`; in this case, the service skips data at offsets that were already persisted (without checking that it matches the previously written data), and write only the data starting from the persisted offset. Even though the data isn't written, it might still incur a performance cost over resuming at the correct write offset. This behavior can make client-side handling simpler in some cases. - Clients must only send data that is a multiple of 256 KiB per message, unless the object is being finished with `finish_write` set to `true`. + *

                                  The service does not view the object as complete until the client has sent a `WriteObjectRequest` with `finish_write` set to `true`. Sending any requests on a stream after sending a request with `finish_write` set to `true` causes an error. The client must check the response it receives to determine how much data the service is able to commit and whether the service views the object as complete. + *

                                  Attempting to resume an already finalized object results in an `OK` status, with a `WriteObjectResponse` containing the finalized object's metadata. + *

                                  Alternatively, you can use the `BidiWriteObject` operation to write an object with controls over flushing and the ability to fetch the ability to determine the current persisted size. *

                                  **IAM Permissions**: - *

                                  Requires `storage.objects.create` [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket. + *

                                  Requires `storage.objects.create` IAM permission on the bucket. * *

                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                  *
                                    @@ -422,8 +456,8 @@ * *

                                    BidiWriteObject *

                                    Stores a new object and metadata. - *

                                    This is similar to the WriteObject call with the added support for manual flushing of persisted state, and the ability to determine current persisted size without closing the stream. - *

                                    The client may specify one or both of the `state_lookup` and `flush` fields in each BidiWriteObjectRequest. If `flush` is specified, the data written so far will be persisted to storage. If `state_lookup` is specified, the service will respond with a BidiWriteObjectResponse that contains the persisted size. If both `flush` and `state_lookup` are specified, the flush will always occur before a `state_lookup`, so that both may be set in the same request and the returned state will be the state of the object post-flush. When the stream is closed, a BidiWriteObjectResponse will always be sent to the client, regardless of the value of `state_lookup`. + *

                                    This is similar to the `WriteObject` call with the added support for manual flushing of persisted state, and the ability to determine current persisted size without closing the stream. + *

                                    The client might specify one or both of the `state_lookup` and `flush` fields in each `BidiWriteObjectRequest`. If `flush` is specified, the data written so far is persisted to storage. If `state_lookup` is specified, the service responds with a `BidiWriteObjectResponse` that contains the persisted size. If both `flush` and `state_lookup` are specified, the flush always occurs before a `state_lookup`, so that both might be set in the same request and the returned state is the state of the object post-flush. When the stream is closed, a `BidiWriteObjectResponse` is always sent to the client, regardless of the value of `state_lookup`. * *

                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                    *
                                      @@ -435,7 +469,7 @@ *

                                      ListObjects *

                                      Retrieves a list of objects matching the criteria. *

                                      **IAM Permissions**: - *

                                      The authenticated user requires `storage.objects.list` [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) to use this method. To return object ACLs, the authenticated user must also have the `storage.objects.getIamPolicy` permission. + *

                                      The authenticated user requires `storage.objects.list` IAM permission to use this method. To return object ACLs, the authenticated user must also have the `storage.objects.getIamPolicy` permission. * *

                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                      *
                                        @@ -469,9 +503,9 @@ * * *

                                        StartResumableWrite - *

                                        Starts a resumable write operation. This method is part of the [Resumable upload](https://cloud.google.com/storage/docs/resumable-uploads) feature. This allows you to upload large objects in multiple chunks, which is more resilient to network interruptions than a single upload. The validity duration of the write operation, and the consequences of it becoming invalid, are service-dependent. + *

                                        Starts a resumable write operation. This method is part of the Resumable upload feature. This allows you to upload large objects in multiple chunks, which is more resilient to network interruptions than a single upload. The validity duration of the write operation, and the consequences of it becoming invalid, are service-dependent. *

                                        **IAM Permissions**: - *

                                        Requires `storage.objects.create` [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket. + *

                                        Requires `storage.objects.create` IAM permission on the bucket. * *

                                        Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                        *
                                          @@ -485,7 +519,7 @@ * * *

                                          QueryWriteStatus - *

                                          Determines the `persisted_size` of an object that is being written. This method is part of the [resumable upload](https://cloud.google.com/storage/docs/resumable-uploads) feature. The returned value is the size of the object that has been persisted so far. The value can be used as the `write_offset` for the next `Write()` call. + *

                                          Determines the `persisted_size` of an object that is being written. This method is part of the resumable upload feature. The returned value is the size of the object that has been persisted so far. The value can be used as the `write_offset` for the next `Write()` call. *

                                          If the object does not exist, meaning if it was deleted, or the first `Write()` has not yet reached the service, this method returns the error `NOT_FOUND`. *

                                          This method is useful for clients that buffer data and need to know which data can be safely evicted. The client can call `QueryWriteStatus()` at any time to determine how much data has been logged for this object. For any sequence of `QueryWriteStatus()` calls for a given object name, the sequence of returned `persisted_size` values are non-decreasing. * @@ -505,7 +539,10 @@ * * *

                                          MoveObject - *

                                          Moves the source object to the destination object in the same bucket. + *

                                          Moves the source object to the destination object in the same bucket. This operation moves a source object to a destination object in the same bucket by renaming the object. The move itself is an atomic transaction, ensuring all steps either complete successfully or no changes are made. + *

                                          **IAM Permissions**: + *

                                          Requires the following IAM permissions to use this method: + *

                                          - `storage.objects.move` - `storage.objects.create` - `storage.objects.delete` (only required if overwriting an existing object) * *

                                          Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                          *
                                            @@ -612,7 +649,23 @@ public StorageStub getStub() { // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Permanently deletes an empty bucket. + * Permanently deletes an empty bucket. The request fails if there are any live or noncurrent + * objects in the bucket, but the request succeeds if the bucket only contains soft-deleted + * objects or incomplete uploads, such as ongoing XML API multipart uploads. Does not permanently + * delete soft-deleted objects. + * + *

                                            When this API is used to delete a bucket containing an object that has a soft delete policy + * enabled, the object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime` + * properties are set on the object. + * + *

                                            Objects and multipart uploads that were in the bucket at the time of deletion are also + * retained for the specified retention duration. When a soft-deleted bucket reaches the end of + * its retention duration, it is permanently deleted. The `hardDeleteTime` of the bucket always + * equals or exceeds the expiration time of the last soft-deleted object in the bucket. + * + *

                                            **IAM Permissions**: + * + *

                                            Requires `storage.buckets.delete` IAM permission on the bucket. * *

                                            Sample code: * @@ -639,7 +692,23 @@ public final void deleteBucket(BucketName name) { // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Permanently deletes an empty bucket. + * Permanently deletes an empty bucket. The request fails if there are any live or noncurrent + * objects in the bucket, but the request succeeds if the bucket only contains soft-deleted + * objects or incomplete uploads, such as ongoing XML API multipart uploads. Does not permanently + * delete soft-deleted objects. + * + *

                                            When this API is used to delete a bucket containing an object that has a soft delete policy + * enabled, the object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime` + * properties are set on the object. + * + *

                                            Objects and multipart uploads that were in the bucket at the time of deletion are also + * retained for the specified retention duration. When a soft-deleted bucket reaches the end of + * its retention duration, it is permanently deleted. The `hardDeleteTime` of the bucket always + * equals or exceeds the expiration time of the last soft-deleted object in the bucket. + * + *

                                            **IAM Permissions**: + * + *

                                            Requires `storage.buckets.delete` IAM permission on the bucket. * *

                                            Sample code: * @@ -665,7 +734,23 @@ public final void deleteBucket(String name) { // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Permanently deletes an empty bucket. + * Permanently deletes an empty bucket. The request fails if there are any live or noncurrent + * objects in the bucket, but the request succeeds if the bucket only contains soft-deleted + * objects or incomplete uploads, such as ongoing XML API multipart uploads. Does not permanently + * delete soft-deleted objects. + * + *

                                            When this API is used to delete a bucket containing an object that has a soft delete policy + * enabled, the object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime` + * properties are set on the object. + * + *

                                            Objects and multipart uploads that were in the bucket at the time of deletion are also + * retained for the specified retention duration. When a soft-deleted bucket reaches the end of + * its retention duration, it is permanently deleted. The `hardDeleteTime` of the bucket always + * equals or exceeds the expiration time of the last soft-deleted object in the bucket. + * + *

                                            **IAM Permissions**: + * + *

                                            Requires `storage.buckets.delete` IAM permission on the bucket. * *

                                            Sample code: * @@ -695,7 +780,23 @@ public final void deleteBucket(DeleteBucketRequest request) { // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Permanently deletes an empty bucket. + * Permanently deletes an empty bucket. The request fails if there are any live or noncurrent + * objects in the bucket, but the request succeeds if the bucket only contains soft-deleted + * objects or incomplete uploads, such as ongoing XML API multipart uploads. Does not permanently + * delete soft-deleted objects. + * + *

                                            When this API is used to delete a bucket containing an object that has a soft delete policy + * enabled, the object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime` + * properties are set on the object. + * + *

                                            Objects and multipart uploads that were in the bucket at the time of deletion are also + * retained for the specified retention duration. When a soft-deleted bucket reaches the end of + * its retention duration, it is permanently deleted. The `hardDeleteTime` of the bucket always + * equals or exceeds the expiration time of the last soft-deleted object in the bucket. + * + *

                                            **IAM Permissions**: + * + *

                                            Requires `storage.buckets.delete` IAM permission on the bucket. * *

                                            Sample code: * @@ -726,6 +827,14 @@ public final UnaryCallable deleteBucketCallable() { /** * Returns metadata for the specified bucket. * + *

                                            **IAM Permissions**: + * + *

                                            Requires `storage.buckets.get` IAM permission on the bucket. Additionally, to return + * specific bucket metadata, the authenticated user must have the following permissions: + * + *

                                            - To return the IAM policies: `storage.buckets.getIamPolicy` - To return the bucket IP + * filtering rules: `storage.buckets.getIpFilter` + * *

                                            Sample code: * * 

                                            {@code
@@ -753,6 +862,14 @@ public final Bucket getBucket(BucketName name) {
   /**
    * Returns metadata for the specified bucket.
    *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires `storage.buckets.get` IAM permission on the bucket. Additionally, to return
+   * specific bucket metadata, the authenticated user must have the following permissions:
+   *
+   * 
                                            - To return the IAM policies: `storage.buckets.getIamPolicy` - To return the bucket IP
+   * filtering rules: `storage.buckets.getIpFilter`
+   *
    * 
                                            Sample code:
    *
    * 
                                            {@code
@@ -779,6 +896,14 @@ public final Bucket getBucket(String name) {
   /**
    * Returns metadata for the specified bucket.
    *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires `storage.buckets.get` IAM permission on the bucket. Additionally, to return
+   * specific bucket metadata, the authenticated user must have the following permissions:
+   *
+   * 
                                            - To return the IAM policies: `storage.buckets.getIamPolicy` - To return the bucket IP
+   * filtering rules: `storage.buckets.getIpFilter`
+   *
    * 
                                            Sample code:
    *
    * 
                                            {@code
@@ -810,6 +935,14 @@ public final Bucket getBucket(GetBucketRequest request) {
   /**
    * Returns metadata for the specified bucket.
    *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires `storage.buckets.get` IAM permission on the bucket. Additionally, to return
+   * specific bucket metadata, the authenticated user must have the following permissions:
+   *
+   * 
                                            - To return the IAM policies: `storage.buckets.getIamPolicy` - To return the bucket IP
+   * filtering rules: `storage.buckets.getIpFilter`
+   *
    * 
                                            Sample code:
    *
    * 
                                            {@code
@@ -840,6 +973,15 @@ public final UnaryCallable getBucketCallable() {
   /**
    * Creates a new bucket.
    *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires `storage.buckets.create` IAM permission on the bucket. Additionally, to enable
+   * specific bucket features, the authenticated user must have the following permissions:
+   *
+   * 
                                            - To enable object retention using the `enableObjectRetention` query parameter:
+   * `storage.buckets.enableObjectRetention` - To set the bucket IP filtering rules:
+   * `storage.buckets.setIpFilter`
+   *
    * 
                                            Sample code:
    *
    * 
                                            {@code
@@ -856,17 +998,17 @@ public final UnaryCallable getBucketCallable() {
    * }
    * }
                                            
    *
-   * @param parent Required. The project to which this bucket will belong. This field must either be
+   * @param parent Required. The project to which this bucket belongs. This field must either be
    *     empty or `projects/_`. The project ID that owns this bucket should be specified in the
    *     `bucket.project` field.
    * @param bucket Optional. Properties of the new bucket being inserted. The name of the bucket is
-   *     specified in the `bucket_id` field. Populating `bucket.name` field will result in an error.
-   *     The project of the bucket must be specified in the `bucket.project` field. This field must
-   *     be in `projects/{projectIdentifier}` format, {projectIdentifier} can be the project ID or
+   *     specified in the `bucket_id` field. Populating `bucket.name` field results in an error. The
+   *     project of the bucket must be specified in the `bucket.project` field. This field must be
+   *     in `projects/{projectIdentifier}` format, {projectIdentifier} can be the project ID or
    *     project number. The `parent` field must be either empty or `projects/_`.
-   * @param bucketId Required. The ID to use for this bucket, which will become the final component
-   *     of the bucket's resource name. For example, the value `foo` might result in a bucket with
-   *     the name `projects/123456/buckets/foo`.
+   * @param bucketId Required. The ID to use for this bucket, which becomes the final component of
+   *     the bucket's resource name. For example, the value `foo` might result in a bucket with the
+   *     name `projects/123456/buckets/foo`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final Bucket createBucket(ProjectName parent, Bucket bucket, String bucketId) {
@@ -883,6 +1025,15 @@ public final Bucket createBucket(ProjectName parent, Bucket bucket, String bucke
   /**
    * Creates a new bucket.
    *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires `storage.buckets.create` IAM permission on the bucket. Additionally, to enable
+   * specific bucket features, the authenticated user must have the following permissions:
+   *
+   * 
                                            - To enable object retention using the `enableObjectRetention` query parameter:
+   * `storage.buckets.enableObjectRetention` - To set the bucket IP filtering rules:
+   * `storage.buckets.setIpFilter`
+   *
    * 
                                            Sample code:
    *
    * 
                                            {@code
@@ -899,17 +1050,17 @@ public final Bucket createBucket(ProjectName parent, Bucket bucket, String bucke
    * }
    * }
                                            
    *
-   * @param parent Required. The project to which this bucket will belong. This field must either be
+   * @param parent Required. The project to which this bucket belongs. This field must either be
    *     empty or `projects/_`. The project ID that owns this bucket should be specified in the
    *     `bucket.project` field.
    * @param bucket Optional. Properties of the new bucket being inserted. The name of the bucket is
-   *     specified in the `bucket_id` field. Populating `bucket.name` field will result in an error.
-   *     The project of the bucket must be specified in the `bucket.project` field. This field must
-   *     be in `projects/{projectIdentifier}` format, {projectIdentifier} can be the project ID or
+   *     specified in the `bucket_id` field. Populating `bucket.name` field results in an error. The
+   *     project of the bucket must be specified in the `bucket.project` field. This field must be
+   *     in `projects/{projectIdentifier}` format, {projectIdentifier} can be the project ID or
    *     project number. The `parent` field must be either empty or `projects/_`.
-   * @param bucketId Required. The ID to use for this bucket, which will become the final component
-   *     of the bucket's resource name. For example, the value `foo` might result in a bucket with
-   *     the name `projects/123456/buckets/foo`.
+   * @param bucketId Required. The ID to use for this bucket, which becomes the final component of
+   *     the bucket's resource name. For example, the value `foo` might result in a bucket with the
+   *     name `projects/123456/buckets/foo`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final Bucket createBucket(String parent, Bucket bucket, String bucketId) {
@@ -926,6 +1077,15 @@ public final Bucket createBucket(String parent, Bucket bucket, String bucketId)
   /**
    * Creates a new bucket.
    *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires `storage.buckets.create` IAM permission on the bucket. Additionally, to enable
+   * specific bucket features, the authenticated user must have the following permissions:
+   *
+   * 
                                            - To enable object retention using the `enableObjectRetention` query parameter:
+   * `storage.buckets.enableObjectRetention` - To set the bucket IP filtering rules:
+   * `storage.buckets.setIpFilter`
+   *
    * 
                                            Sample code:
    *
    * 
                                            {@code
@@ -959,6 +1119,15 @@ public final Bucket createBucket(CreateBucketRequest request) {
   /**
    * Creates a new bucket.
    *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires `storage.buckets.create` IAM permission on the bucket. Additionally, to enable
+   * specific bucket features, the authenticated user must have the following permissions:
+   *
+   * 
                                            - To enable object retention using the `enableObjectRetention` query parameter:
+   * `storage.buckets.enableObjectRetention` - To set the bucket IP filtering rules:
+   * `storage.buckets.setIpFilter`
+   *
    * 
                                            Sample code:
    *
    * 
                                            {@code
@@ -989,7 +1158,15 @@ public final UnaryCallable createBucketCallable() {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Retrieves a list of buckets for a given project.
+   * Retrieves a list of buckets for a given project, ordered lexicographically by name.
+   *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires `storage.buckets.list` IAM permission on the bucket. Additionally, to enable
+   * specific bucket features, the authenticated user must have the following permissions:
+   *
+   * 
                                            - To list the IAM policies: `storage.buckets.getIamPolicy` - To list the bucket IP filtering
+   * rules: `storage.buckets.getIpFilter`
    *
    * 
                                            Sample code:
    *
@@ -1020,7 +1197,15 @@ public final ListBucketsPagedResponse listBuckets(ProjectName parent) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Retrieves a list of buckets for a given project.
+   * Retrieves a list of buckets for a given project, ordered lexicographically by name.
+   *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires `storage.buckets.list` IAM permission on the bucket. Additionally, to enable
+   * specific bucket features, the authenticated user must have the following permissions:
+   *
+   * 
                                            - To list the IAM policies: `storage.buckets.getIamPolicy` - To list the bucket IP filtering
+   * rules: `storage.buckets.getIpFilter`
    *
    * 
                                            Sample code:
    *
@@ -1048,7 +1233,15 @@ public final ListBucketsPagedResponse listBuckets(String parent) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Retrieves a list of buckets for a given project.
+   * Retrieves a list of buckets for a given project, ordered lexicographically by name.
+   *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires `storage.buckets.list` IAM permission on the bucket. Additionally, to enable
+   * specific bucket features, the authenticated user must have the following permissions:
+   *
+   * 
                                            - To list the IAM policies: `storage.buckets.getIamPolicy` - To list the bucket IP filtering
+   * rules: `storage.buckets.getIpFilter`
    *
    * 
                                            Sample code:
    *
@@ -1066,6 +1259,7 @@ public final ListBucketsPagedResponse listBuckets(String parent) {
    *           .setPageToken("pageToken873572522")
    *           .setPrefix("prefix-980110702")
    *           .setReadMask(FieldMask.newBuilder().build())
+   *           .setReturnPartialSuccess(true)
    *           .build();
    *   for (Bucket element : storageClient.listBuckets(request).iterateAll()) {
    *     // doThingsWith(element);
@@ -1082,7 +1276,15 @@ public final ListBucketsPagedResponse listBuckets(ListBucketsRequest request) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Retrieves a list of buckets for a given project.
+   * Retrieves a list of buckets for a given project, ordered lexicographically by name.
+   *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires `storage.buckets.list` IAM permission on the bucket. Additionally, to enable
+   * specific bucket features, the authenticated user must have the following permissions:
+   *
+   * 
                                            - To list the IAM policies: `storage.buckets.getIamPolicy` - To list the bucket IP filtering
+   * rules: `storage.buckets.getIpFilter`
    *
    * 
                                            Sample code:
    *
@@ -1100,6 +1302,7 @@ public final ListBucketsPagedResponse listBuckets(ListBucketsRequest request) {
    *           .setPageToken("pageToken873572522")
    *           .setPrefix("prefix-980110702")
    *           .setReadMask(FieldMask.newBuilder().build())
+   *           .setReturnPartialSuccess(true)
    *           .build();
    *   ApiFuture future = storageClient.listBucketsPagedCallable().futureCall(request);
    *   // Do something.
@@ -1116,7 +1319,15 @@ public final ListBucketsPagedResponse listBuckets(ListBucketsRequest request) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Retrieves a list of buckets for a given project.
+   * Retrieves a list of buckets for a given project, ordered lexicographically by name.
+   *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires `storage.buckets.list` IAM permission on the bucket. Additionally, to enable
+   * specific bucket features, the authenticated user must have the following permissions:
+   *
+   * 
                                            - To list the IAM policies: `storage.buckets.getIamPolicy` - To list the bucket IP filtering
+   * rules: `storage.buckets.getIpFilter`
    *
    * 
                                            Sample code:
    *
@@ -1134,6 +1345,7 @@ public final ListBucketsPagedResponse listBuckets(ListBucketsRequest request) {
    *           .setPageToken("pageToken873572522")
    *           .setPrefix("prefix-980110702")
    *           .setReadMask(FieldMask.newBuilder().build())
+   *           .setReturnPartialSuccess(true)
    *           .build();
    *   while (true) {
    *     ListBucketsResponse response = storageClient.listBucketsCallable().call(request);
@@ -1156,7 +1368,21 @@ public final UnaryCallable listBucketsC
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Locks retention policy on a bucket.
+   * Permanently locks the retention policy that is currently applied to the specified bucket.
+   *
+   * 
                                            Caution: Locking a bucket is an irreversible action. Once you lock a bucket:
+   *
+   * 
                                            - You cannot remove the retention policy from the bucket. - You cannot decrease the
+   * retention period for the policy.
+   *
+   * 
                                            Once locked, you must delete the entire bucket in order to remove the bucket's retention
+   * policy. However, before you can delete the bucket, you must delete all the objects in the
+   * bucket, which is only possible if all the objects have reached the retention period set by the
+   * retention policy.
+   *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires `storage.buckets.update` IAM permission on the bucket.
    *
    * 
                                            Sample code:
    *
@@ -1185,7 +1411,21 @@ public final Bucket lockBucketRetentionPolicy(BucketName bucket) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Locks retention policy on a bucket.
+   * Permanently locks the retention policy that is currently applied to the specified bucket.
+   *
+   * 
                                            Caution: Locking a bucket is an irreversible action. Once you lock a bucket:
+   *
+   * 
                                            - You cannot remove the retention policy from the bucket. - You cannot decrease the
+   * retention period for the policy.
+   *
+   * 
                                            Once locked, you must delete the entire bucket in order to remove the bucket's retention
+   * policy. However, before you can delete the bucket, you must delete all the objects in the
+   * bucket, which is only possible if all the objects have reached the retention period set by the
+   * retention policy.
+   *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires `storage.buckets.update` IAM permission on the bucket.
    *
    * 
                                            Sample code:
    *
@@ -1212,7 +1452,21 @@ public final Bucket lockBucketRetentionPolicy(String bucket) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Locks retention policy on a bucket.
+   * Permanently locks the retention policy that is currently applied to the specified bucket.
+   *
+   * 
                                            Caution: Locking a bucket is an irreversible action. Once you lock a bucket:
+   *
+   * 
                                            - You cannot remove the retention policy from the bucket. - You cannot decrease the
+   * retention period for the policy.
+   *
+   * 
                                            Once locked, you must delete the entire bucket in order to remove the bucket's retention
+   * policy. However, before you can delete the bucket, you must delete all the objects in the
+   * bucket, which is only possible if all the objects have reached the retention period set by the
+   * retention policy.
+   *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires `storage.buckets.update` IAM permission on the bucket.
    *
    * 
                                            Sample code:
    *
@@ -1241,7 +1495,21 @@ public final Bucket lockBucketRetentionPolicy(LockBucketRetentionPolicyRequest r
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Locks retention policy on a bucket.
+   * Permanently locks the retention policy that is currently applied to the specified bucket.
+   *
+   * 
                                            Caution: Locking a bucket is an irreversible action. Once you lock a bucket:
+   *
+   * 
                                            - You cannot remove the retention policy from the bucket. - You cannot decrease the
+   * retention period for the policy.
+   *
+   * 
                                            Once locked, you must delete the entire bucket in order to remove the bucket's retention
+   * policy. However, before you can delete the bucket, you must delete all the objects in the
+   * bucket, which is only possible if all the objects have reached the retention period set by the
+   * retention policy.
+   *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires `storage.buckets.update` IAM permission on the bucket.
    *
    * 
                                            Sample code:
    *
@@ -1271,10 +1539,15 @@ public final Bucket lockBucketRetentionPolicy(LockBucketRetentionPolicyRequest r
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Gets the IAM policy for a specified bucket. The `resource` field in the request should be
-   * `projects/_/buckets/{bucket}` for a bucket, or
+   * Gets the IAM policy for a specified bucket or managed folder. The `resource` field in the
+   * request should be `projects/_/buckets/{bucket}` for a bucket, or
    * `projects/_/buckets/{bucket}/managedFolders/{managedFolder}` for a managed folder.
    *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires `storage.buckets.getIamPolicy` on the bucket or
+   * `storage.managedFolders.getIamPolicy` IAM permission on the managed folder.
+   *
    * 
                                            Sample code:
    *
    * 
                                            {@code
@@ -1304,10 +1577,15 @@ public final Policy getIamPolicy(ResourceName resource) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Gets the IAM policy for a specified bucket. The `resource` field in the request should be
-   * `projects/_/buckets/{bucket}` for a bucket, or
+   * Gets the IAM policy for a specified bucket or managed folder. The `resource` field in the
+   * request should be `projects/_/buckets/{bucket}` for a bucket, or
    * `projects/_/buckets/{bucket}/managedFolders/{managedFolder}` for a managed folder.
    *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires `storage.buckets.getIamPolicy` on the bucket or
+   * `storage.managedFolders.getIamPolicy` IAM permission on the managed folder.
+   *
    * 
                                            Sample code:
    *
    * 
                                            {@code
@@ -1334,10 +1612,15 @@ public final Policy getIamPolicy(String resource) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Gets the IAM policy for a specified bucket. The `resource` field in the request should be
-   * `projects/_/buckets/{bucket}` for a bucket, or
+   * Gets the IAM policy for a specified bucket or managed folder. The `resource` field in the
+   * request should be `projects/_/buckets/{bucket}` for a bucket, or
    * `projects/_/buckets/{bucket}/managedFolders/{managedFolder}` for a managed folder.
    *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires `storage.buckets.getIamPolicy` on the bucket or
+   * `storage.managedFolders.getIamPolicy` IAM permission on the managed folder.
+   *
    * 
                                            Sample code:
    *
    * 
                                            {@code
@@ -1367,10 +1650,15 @@ public final Policy getIamPolicy(GetIamPolicyRequest request) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Gets the IAM policy for a specified bucket. The `resource` field in the request should be
-   * `projects/_/buckets/{bucket}` for a bucket, or
+   * Gets the IAM policy for a specified bucket or managed folder. The `resource` field in the
+   * request should be `projects/_/buckets/{bucket}` for a bucket, or
    * `projects/_/buckets/{bucket}/managedFolders/{managedFolder}` for a managed folder.
    *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires `storage.buckets.getIamPolicy` on the bucket or
+   * `storage.managedFolders.getIamPolicy` IAM permission on the managed folder.
+   *
    * 
                                            Sample code:
    *
    * 
                                            {@code
@@ -1399,8 +1687,8 @@ public final UnaryCallable getIamPolicyCallable() {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Updates an IAM policy for the specified bucket. The `resource` field in the request should be
-   * `projects/_/buckets/{bucket}` for a bucket, or
+   * Updates an IAM policy for the specified bucket or managed folder. The `resource` field in the
+   * request should be `projects/_/buckets/{bucket}` for a bucket, or
    * `projects/_/buckets/{bucket}/managedFolders/{managedFolder}` for a managed folder.
    *
    * 
                                            Sample code:
@@ -1437,8 +1725,8 @@ public final Policy setIamPolicy(ResourceName resource, Policy policy) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Updates an IAM policy for the specified bucket. The `resource` field in the request should be
-   * `projects/_/buckets/{bucket}` for a bucket, or
+   * Updates an IAM policy for the specified bucket or managed folder. The `resource` field in the
+   * request should be `projects/_/buckets/{bucket}` for a bucket, or
    * `projects/_/buckets/{bucket}/managedFolders/{managedFolder}` for a managed folder.
    *
    * 
                                            Sample code:
@@ -1472,8 +1760,8 @@ public final Policy setIamPolicy(String resource, Policy policy) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Updates an IAM policy for the specified bucket. The `resource` field in the request should be
-   * `projects/_/buckets/{bucket}` for a bucket, or
+   * Updates an IAM policy for the specified bucket or managed folder. The `resource` field in the
+   * request should be `projects/_/buckets/{bucket}` for a bucket, or
    * `projects/_/buckets/{bucket}/managedFolders/{managedFolder}` for a managed folder.
    *
    * 
                                            Sample code:
@@ -1506,8 +1794,8 @@ public final Policy setIamPolicy(SetIamPolicyRequest request) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Updates an IAM policy for the specified bucket. The `resource` field in the request should be
-   * `projects/_/buckets/{bucket}` for a bucket, or
+   * Updates an IAM policy for the specified bucket or managed folder. The `resource` field in the
+   * request should be `projects/_/buckets/{bucket}` for a bucket, or
    * `projects/_/buckets/{bucket}/managedFolders/{managedFolder}` for a managed folder.
    *
    * 
                                            Sample code:
@@ -1692,7 +1980,16 @@ public final TestIamPermissionsResponse testIamPermissions(TestIamPermissionsReq
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Updates a bucket. Equivalent to JSON API's storage.buckets.patch method.
+   * Updates a bucket. Changes to the bucket are readable immediately after writing, but
+   * configuration changes might take time to propagate. This method supports `patch` semantics.
+   *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires `storage.buckets.update` IAM permission on the bucket. Additionally, to enable
+   * specific bucket features, the authenticated user must have the following permissions:
+   *
+   * 
                                            - To set bucket IP filtering rules: `storage.buckets.setIpFilter` - To update public access
+   * prevention policies or access control lists (ACLs): `storage.buckets.setIamPolicy`
    *
    * 
                                            Sample code:
    *
@@ -1709,12 +2006,12 @@ public final TestIamPermissionsResponse testIamPermissions(TestIamPermissionsReq
    * }
    * }
                                            
    *
-   * @param bucket Required. The bucket to update. The bucket's `name` field will be used to
-   *     identify the bucket.
+   * @param bucket Required. The bucket to update. The bucket's `name` field is used to identify the
+   *     bucket.
    * @param updateMask Required. List of fields to be updated.
    *     
                                            To specify ALL fields, equivalent to the JSON API's "update" function, specify a single
    *     field with the value `*`. Note: not recommended. If a new field is introduced at a
-   *     later time, an older client updating with the `*` may accidentally reset the new
+   *     later time, an older client updating with the `*` might accidentally reset the new
    *     field's value.
    *     
                                            Not specifying any fields is an error.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
@@ -1727,7 +2024,16 @@ public final Bucket updateBucket(Bucket bucket, FieldMask updateMask) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Updates a bucket. Equivalent to JSON API's storage.buckets.patch method.
+   * Updates a bucket. Changes to the bucket are readable immediately after writing, but
+   * configuration changes might take time to propagate. This method supports `patch` semantics.
+   *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires `storage.buckets.update` IAM permission on the bucket. Additionally, to enable
+   * specific bucket features, the authenticated user must have the following permissions:
+   *
+   * 
                                            - To set bucket IP filtering rules: `storage.buckets.setIpFilter` - To update public access
+   * prevention policies or access control lists (ACLs): `storage.buckets.setIamPolicy`
    *
    * 
                                            Sample code:
    *
@@ -1760,7 +2066,16 @@ public final Bucket updateBucket(UpdateBucketRequest request) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Updates a bucket. Equivalent to JSON API's storage.buckets.patch method.
+   * Updates a bucket. Changes to the bucket are readable immediately after writing, but
+   * configuration changes might take time to propagate. This method supports `patch` semantics.
+   *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires `storage.buckets.update` IAM permission on the bucket. Additionally, to enable
+   * specific bucket features, the authenticated user must have the following permissions:
+   *
+   * 
                                            - To set bucket IP filtering rules: `storage.buckets.setIpFilter` - To update public access
+   * prevention policies or access control lists (ACLs): `storage.buckets.setIamPolicy`
    *
    * 
                                            Sample code:
    *
@@ -1792,7 +2107,16 @@ public final UnaryCallable updateBucketCallable() {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Concatenates a list of existing objects into a new object in the same bucket.
+   * Concatenates a list of existing objects into a new object in the same bucket. The existing
+   * source objects are unaffected by this operation.
+   *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires the `storage.objects.create` and `storage.objects.get` IAM permissions to use this
+   * method. If the new composite object overwrites an existing object, the authenticated user must
+   * also have the `storage.objects.delete` permission. If the request body includes the retention
+   * property, the authenticated user must also have the `storage.objects.setRetention` IAM
+   * permission.
    *
    * 
                                            Sample code:
    *
@@ -1829,7 +2153,16 @@ public final Object composeObject(ComposeObjectRequest request) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Concatenates a list of existing objects into a new object in the same bucket.
+   * Concatenates a list of existing objects into a new object in the same bucket. The existing
+   * source objects are unaffected by this operation.
+   *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires the `storage.objects.create` and `storage.objects.get` IAM permissions to use this
+   * method. If the new composite object overwrites an existing object, the authenticated user must
+   * also have the `storage.objects.delete` permission. If the request body includes the retention
+   * property, the authenticated user must also have the `storage.objects.setRetention` IAM
+   * permission.
    *
    * 
                                            Sample code:
    *
@@ -1866,20 +2199,18 @@ public final UnaryCallable composeObjectCallable()
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
    * Deletes an object and its metadata. Deletions are permanent if versioning is not enabled for
-   * the bucket, or if the generation parameter is used, or if [soft
-   * delete](https://cloud.google.com/storage/docs/soft-delete) is not enabled for the bucket. When
-   * this API is used to delete an object from a bucket that has soft delete policy enabled, the
-   * object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime` properties are set
-   * on the object. This API cannot be used to permanently delete soft-deleted objects. Soft-deleted
-   * objects are permanently deleted according to their `hardDeleteTime`.
+   * the bucket, or if the generation parameter is used, or if soft delete is not enabled for the
+   * bucket. When this API is used to delete an object from a bucket that has soft delete policy
+   * enabled, the object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime`
+   * properties are set on the object. This API cannot be used to permanently delete soft-deleted
+   * objects. Soft-deleted objects are permanently deleted according to their `hardDeleteTime`.
    *
    * 
                                            You can use the [`RestoreObject`][google.storage.v2.Storage.RestoreObject] API to restore
    * soft-deleted objects until the soft delete retention period has passed.
    *
    * 
                                            **IAM Permissions**:
    *
-   * 
                                            Requires `storage.objects.delete` [IAM
-   * permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket.
+   * 
                                            Requires `storage.objects.delete` IAM permission on the bucket.
    *
    * 
                                            Sample code:
    *
@@ -1913,20 +2244,18 @@ public final void deleteObject(BucketName bucket, String object) {
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
    * Deletes an object and its metadata. Deletions are permanent if versioning is not enabled for
-   * the bucket, or if the generation parameter is used, or if [soft
-   * delete](https://cloud.google.com/storage/docs/soft-delete) is not enabled for the bucket. When
-   * this API is used to delete an object from a bucket that has soft delete policy enabled, the
-   * object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime` properties are set
-   * on the object. This API cannot be used to permanently delete soft-deleted objects. Soft-deleted
-   * objects are permanently deleted according to their `hardDeleteTime`.
+   * the bucket, or if the generation parameter is used, or if soft delete is not enabled for the
+   * bucket. When this API is used to delete an object from a bucket that has soft delete policy
+   * enabled, the object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime`
+   * properties are set on the object. This API cannot be used to permanently delete soft-deleted
+   * objects. Soft-deleted objects are permanently deleted according to their `hardDeleteTime`.
    *
    * 
                                            You can use the [`RestoreObject`][google.storage.v2.Storage.RestoreObject] API to restore
    * soft-deleted objects until the soft delete retention period has passed.
    *
    * 
                                            **IAM Permissions**:
    *
-   * 
                                            Requires `storage.objects.delete` [IAM
-   * permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket.
+   * 
                                            Requires `storage.objects.delete` IAM permission on the bucket.
    *
    * 
                                            Sample code:
    *
@@ -1957,20 +2286,18 @@ public final void deleteObject(String bucket, String object) {
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
    * Deletes an object and its metadata. Deletions are permanent if versioning is not enabled for
-   * the bucket, or if the generation parameter is used, or if [soft
-   * delete](https://cloud.google.com/storage/docs/soft-delete) is not enabled for the bucket. When
-   * this API is used to delete an object from a bucket that has soft delete policy enabled, the
-   * object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime` properties are set
-   * on the object. This API cannot be used to permanently delete soft-deleted objects. Soft-deleted
-   * objects are permanently deleted according to their `hardDeleteTime`.
+   * the bucket, or if the generation parameter is used, or if soft delete is not enabled for the
+   * bucket. When this API is used to delete an object from a bucket that has soft delete policy
+   * enabled, the object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime`
+   * properties are set on the object. This API cannot be used to permanently delete soft-deleted
+   * objects. Soft-deleted objects are permanently deleted according to their `hardDeleteTime`.
    *
    * 
                                            You can use the [`RestoreObject`][google.storage.v2.Storage.RestoreObject] API to restore
    * soft-deleted objects until the soft delete retention period has passed.
    *
    * 
                                            **IAM Permissions**:
    *
-   * 
                                            Requires `storage.objects.delete` [IAM
-   * permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket.
+   * 
                                            Requires `storage.objects.delete` IAM permission on the bucket.
    *
    * 
                                            Sample code:
    *
@@ -2008,20 +2335,18 @@ public final void deleteObject(BucketName bucket, String object, long generation
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
    * Deletes an object and its metadata. Deletions are permanent if versioning is not enabled for
-   * the bucket, or if the generation parameter is used, or if [soft
-   * delete](https://cloud.google.com/storage/docs/soft-delete) is not enabled for the bucket. When
-   * this API is used to delete an object from a bucket that has soft delete policy enabled, the
-   * object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime` properties are set
-   * on the object. This API cannot be used to permanently delete soft-deleted objects. Soft-deleted
-   * objects are permanently deleted according to their `hardDeleteTime`.
+   * the bucket, or if the generation parameter is used, or if soft delete is not enabled for the
+   * bucket. When this API is used to delete an object from a bucket that has soft delete policy
+   * enabled, the object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime`
+   * properties are set on the object. This API cannot be used to permanently delete soft-deleted
+   * objects. Soft-deleted objects are permanently deleted according to their `hardDeleteTime`.
    *
    * 
                                            You can use the [`RestoreObject`][google.storage.v2.Storage.RestoreObject] API to restore
    * soft-deleted objects until the soft delete retention period has passed.
    *
    * 
                                            **IAM Permissions**:
    *
-   * 
                                            Requires `storage.objects.delete` [IAM
-   * permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket.
+   * 
                                            Requires `storage.objects.delete` IAM permission on the bucket.
    *
    * 
                                            Sample code:
    *
@@ -2059,20 +2384,18 @@ public final void deleteObject(String bucket, String object, long generation) {
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
    * Deletes an object and its metadata. Deletions are permanent if versioning is not enabled for
-   * the bucket, or if the generation parameter is used, or if [soft
-   * delete](https://cloud.google.com/storage/docs/soft-delete) is not enabled for the bucket. When
-   * this API is used to delete an object from a bucket that has soft delete policy enabled, the
-   * object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime` properties are set
-   * on the object. This API cannot be used to permanently delete soft-deleted objects. Soft-deleted
-   * objects are permanently deleted according to their `hardDeleteTime`.
+   * the bucket, or if the generation parameter is used, or if soft delete is not enabled for the
+   * bucket. When this API is used to delete an object from a bucket that has soft delete policy
+   * enabled, the object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime`
+   * properties are set on the object. This API cannot be used to permanently delete soft-deleted
+   * objects. Soft-deleted objects are permanently deleted according to their `hardDeleteTime`.
    *
    * 
                                            You can use the [`RestoreObject`][google.storage.v2.Storage.RestoreObject] API to restore
    * soft-deleted objects until the soft delete retention period has passed.
    *
    * 
                                            **IAM Permissions**:
    *
-   * 
                                            Requires `storage.objects.delete` [IAM
-   * permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket.
+   * 
                                            Requires `storage.objects.delete` IAM permission on the bucket.
    *
    * 
                                            Sample code:
    *
@@ -2108,20 +2431,18 @@ public final void deleteObject(DeleteObjectRequest request) {
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
    * Deletes an object and its metadata. Deletions are permanent if versioning is not enabled for
-   * the bucket, or if the generation parameter is used, or if [soft
-   * delete](https://cloud.google.com/storage/docs/soft-delete) is not enabled for the bucket. When
-   * this API is used to delete an object from a bucket that has soft delete policy enabled, the
-   * object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime` properties are set
-   * on the object. This API cannot be used to permanently delete soft-deleted objects. Soft-deleted
-   * objects are permanently deleted according to their `hardDeleteTime`.
+   * the bucket, or if the generation parameter is used, or if soft delete is not enabled for the
+   * bucket. When this API is used to delete an object from a bucket that has soft delete policy
+   * enabled, the object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime`
+   * properties are set on the object. This API cannot be used to permanently delete soft-deleted
+   * objects. Soft-deleted objects are permanently deleted according to their `hardDeleteTime`.
    *
    * 
                                            You can use the [`RestoreObject`][google.storage.v2.Storage.RestoreObject] API to restore
    * soft-deleted objects until the soft delete retention period has passed.
    *
    * 
                                            **IAM Permissions**:
    *
-   * 
                                            Requires `storage.objects.delete` [IAM
-   * permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket.
+   * 
                                            Requires `storage.objects.delete` IAM permission on the bucket.
    *
    * 
                                            Sample code:
    *
@@ -2155,7 +2476,30 @@ public final UnaryCallable deleteObjectCallable() {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Restores a soft-deleted object.
+   * Restores a soft-deleted object. When a soft-deleted object is restored, a new copy of that
+   * object is created in the same bucket and inherits the same metadata as the soft-deleted object.
+   * The inherited metadata is the metadata that existed when the original object became soft
+   * deleted, with the following exceptions:
+   *
+   * 
                                            - The `createTime` of the new object is set to the time at which the soft-deleted object was
+   * restored. - The `softDeleteTime` and `hardDeleteTime` values are cleared. - A new generation is
+   * assigned and the metageneration is reset to 1. - If the soft-deleted object was in a bucket
+   * that had Autoclass enabled, the new object is restored to Standard storage. - The restored
+   * object inherits the bucket's default object ACL, unless `copySourceAcl` is `true`.
+   *
+   * 
                                            If a live object using the same name already exists in the bucket and becomes overwritten,
+   * the live object becomes a noncurrent object if Object Versioning is enabled on the bucket. If
+   * Object Versioning is not enabled, the live object becomes soft deleted.
+   *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires the following IAM permissions to use this method:
+   *
+   * 
                                            - `storage.objects.restore` - `storage.objects.create` - `storage.objects.delete` (only
+   * required if overwriting an existing object) - `storage.objects.getIamPolicy` (only required if
+   * `projection` is `full` and the relevant bucket has uniform bucket-level access disabled) -
+   * `storage.objects.setIamPolicy` (only required if `copySourceAcl` is `true` and the relevant
+   * bucket has uniform bucket-level access disabled)
    *
    * 
                                            Sample code:
    *
@@ -2190,7 +2534,30 @@ public final Object restoreObject(BucketName bucket, String object, long generat
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Restores a soft-deleted object.
+   * Restores a soft-deleted object. When a soft-deleted object is restored, a new copy of that
+   * object is created in the same bucket and inherits the same metadata as the soft-deleted object.
+   * The inherited metadata is the metadata that existed when the original object became soft
+   * deleted, with the following exceptions:
+   *
+   * 
                                            - The `createTime` of the new object is set to the time at which the soft-deleted object was
+   * restored. - The `softDeleteTime` and `hardDeleteTime` values are cleared. - A new generation is
+   * assigned and the metageneration is reset to 1. - If the soft-deleted object was in a bucket
+   * that had Autoclass enabled, the new object is restored to Standard storage. - The restored
+   * object inherits the bucket's default object ACL, unless `copySourceAcl` is `true`.
+   *
+   * 
                                            If a live object using the same name already exists in the bucket and becomes overwritten,
+   * the live object becomes a noncurrent object if Object Versioning is enabled on the bucket. If
+   * Object Versioning is not enabled, the live object becomes soft deleted.
+   *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires the following IAM permissions to use this method:
+   *
+   * 
                                            - `storage.objects.restore` - `storage.objects.create` - `storage.objects.delete` (only
+   * required if overwriting an existing object) - `storage.objects.getIamPolicy` (only required if
+   * `projection` is `full` and the relevant bucket has uniform bucket-level access disabled) -
+   * `storage.objects.setIamPolicy` (only required if `copySourceAcl` is `true` and the relevant
+   * bucket has uniform bucket-level access disabled)
    *
    * 
                                            Sample code:
    *
@@ -2225,7 +2592,30 @@ public final Object restoreObject(String bucket, String object, long generation)
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Restores a soft-deleted object.
+   * Restores a soft-deleted object. When a soft-deleted object is restored, a new copy of that
+   * object is created in the same bucket and inherits the same metadata as the soft-deleted object.
+   * The inherited metadata is the metadata that existed when the original object became soft
+   * deleted, with the following exceptions:
+   *
+   * 
                                            - The `createTime` of the new object is set to the time at which the soft-deleted object was
+   * restored. - The `softDeleteTime` and `hardDeleteTime` values are cleared. - A new generation is
+   * assigned and the metageneration is reset to 1. - If the soft-deleted object was in a bucket
+   * that had Autoclass enabled, the new object is restored to Standard storage. - The restored
+   * object inherits the bucket's default object ACL, unless `copySourceAcl` is `true`.
+   *
+   * 
                                            If a live object using the same name already exists in the bucket and becomes overwritten,
+   * the live object becomes a noncurrent object if Object Versioning is enabled on the bucket. If
+   * Object Versioning is not enabled, the live object becomes soft deleted.
+   *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires the following IAM permissions to use this method:
+   *
+   * 
                                            - `storage.objects.restore` - `storage.objects.create` - `storage.objects.delete` (only
+   * required if overwriting an existing object) - `storage.objects.getIamPolicy` (only required if
+   * `projection` is `full` and the relevant bucket has uniform bucket-level access disabled) -
+   * `storage.objects.setIamPolicy` (only required if `copySourceAcl` is `true` and the relevant
+   * bucket has uniform bucket-level access disabled)
    *
    * 
                                            Sample code:
    *
@@ -2262,7 +2652,30 @@ public final Object restoreObject(RestoreObjectRequest request) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Restores a soft-deleted object.
+   * Restores a soft-deleted object. When a soft-deleted object is restored, a new copy of that
+   * object is created in the same bucket and inherits the same metadata as the soft-deleted object.
+   * The inherited metadata is the metadata that existed when the original object became soft
+   * deleted, with the following exceptions:
+   *
+   * 
                                            - The `createTime` of the new object is set to the time at which the soft-deleted object was
+   * restored. - The `softDeleteTime` and `hardDeleteTime` values are cleared. - A new generation is
+   * assigned and the metageneration is reset to 1. - If the soft-deleted object was in a bucket
+   * that had Autoclass enabled, the new object is restored to Standard storage. - The restored
+   * object inherits the bucket's default object ACL, unless `copySourceAcl` is `true`.
+   *
+   * 
                                            If a live object using the same name already exists in the bucket and becomes overwritten,
+   * the live object becomes a noncurrent object if Object Versioning is enabled on the bucket. If
+   * Object Versioning is not enabled, the live object becomes soft deleted.
+   *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires the following IAM permissions to use this method:
+   *
+   * 
                                            - `storage.objects.restore` - `storage.objects.create` - `storage.objects.delete` (only
+   * required if overwriting an existing object) - `storage.objects.getIamPolicy` (only required if
+   * `projection` is `full` and the relevant bucket has uniform bucket-level access disabled) -
+   * `storage.objects.setIamPolicy` (only required if `copySourceAcl` is `true` and the relevant
+   * bucket has uniform bucket-level access disabled)
    *
    * 
                                            Sample code:
    *
@@ -2300,10 +2713,10 @@ public final UnaryCallable restoreObjectCallable()
   /**
    * Cancels an in-progress resumable upload.
    *
-   * 
                                            Any attempts to write to the resumable upload after cancelling the upload will fail.
+   * 
                                            Any attempts to write to the resumable upload after cancelling the upload fail.
    *
-   * 
                                            The behavior for currently in progress write operations is not guaranteed - they could
-   * either complete before the cancellation or fail if the cancellation completes first.
+   * 
                                            The behavior for any in-progress write operations is not guaranteed; they could either
+   * complete before the cancellation or fail if the cancellation completes first.
    *
    * 
                                            Sample code:
    *
@@ -2333,10 +2746,10 @@ public final CancelResumableWriteResponse cancelResumableWrite(String uploadId)
   /**
    * Cancels an in-progress resumable upload.
    *
-   * 
                                            Any attempts to write to the resumable upload after cancelling the upload will fail.
+   * 
                                            Any attempts to write to the resumable upload after cancelling the upload fail.
    *
-   * 
                                            The behavior for currently in progress write operations is not guaranteed - they could
-   * either complete before the cancellation or fail if the cancellation completes first.
+   * 
                                            The behavior for any in-progress write operations is not guaranteed; they could either
+   * complete before the cancellation or fail if the cancellation completes first.
    *
    * 
                                            Sample code:
    *
@@ -2365,10 +2778,10 @@ public final CancelResumableWriteResponse cancelResumableWrite(
   /**
    * Cancels an in-progress resumable upload.
    *
-   * 
                                            Any attempts to write to the resumable upload after cancelling the upload will fail.
+   * 
                                            Any attempts to write to the resumable upload after cancelling the upload fail.
    *
-   * 
                                            The behavior for currently in progress write operations is not guaranteed - they could
-   * either complete before the cancellation or fail if the cancellation completes first.
+   * 
                                            The behavior for any in-progress write operations is not guaranteed; they could either
+   * complete before the cancellation or fail if the cancellation completes first.
    *
    * 
                                            Sample code:
    *
@@ -2399,10 +2812,8 @@ public final CancelResumableWriteResponse cancelResumableWrite(
    *
    * 
                                            **IAM Permissions**:
    *
-   * 
                                            Requires `storage.objects.get` [IAM
-   * permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket. To return
-   * object ACLs, the authenticated user must also have the `storage.objects.getIamPolicy`
-   * permission.
+   * 
                                            Requires `storage.objects.get` IAM permission on the bucket. To return object ACLs, the
+   * authenticated user must also have the `storage.objects.getIamPolicy` permission.
    *
    * 
                                            Sample code:
    *
@@ -2438,10 +2849,8 @@ public final Object getObject(BucketName bucket, String object) {
    *
    * 
                                            **IAM Permissions**:
    *
-   * 
                                            Requires `storage.objects.get` [IAM
-   * permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket. To return
-   * object ACLs, the authenticated user must also have the `storage.objects.getIamPolicy`
-   * permission.
+   * 
                                            Requires `storage.objects.get` IAM permission on the bucket. To return object ACLs, the
+   * authenticated user must also have the `storage.objects.getIamPolicy` permission.
    *
    * 
                                            Sample code:
    *
@@ -2474,10 +2883,8 @@ public final Object getObject(String bucket, String object) {
    *
    * 
                                            **IAM Permissions**:
    *
-   * 
                                            Requires `storage.objects.get` [IAM
-   * permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket. To return
-   * object ACLs, the authenticated user must also have the `storage.objects.getIamPolicy`
-   * permission.
+   * 
                                            Requires `storage.objects.get` IAM permission on the bucket. To return object ACLs, the
+   * authenticated user must also have the `storage.objects.getIamPolicy` permission.
    *
    * 
                                            Sample code:
    *
@@ -2517,10 +2924,8 @@ public final Object getObject(BucketName bucket, String object, long generation)
    *
    * 
                                            **IAM Permissions**:
    *
-   * 
                                            Requires `storage.objects.get` [IAM
-   * permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket. To return
-   * object ACLs, the authenticated user must also have the `storage.objects.getIamPolicy`
-   * permission.
+   * 
                                            Requires `storage.objects.get` IAM permission on the bucket. To return object ACLs, the
+   * authenticated user must also have the `storage.objects.getIamPolicy` permission.
    *
    * 
                                            Sample code:
    *
@@ -2560,10 +2965,8 @@ public final Object getObject(String bucket, String object, long generation) {
    *
    * 
                                            **IAM Permissions**:
    *
-   * 
                                            Requires `storage.objects.get` [IAM
-   * permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket. To return
-   * object ACLs, the authenticated user must also have the `storage.objects.getIamPolicy`
-   * permission.
+   * 
                                            Requires `storage.objects.get` IAM permission on the bucket. To return object ACLs, the
+   * authenticated user must also have the `storage.objects.getIamPolicy` permission.
    *
    * 
                                            Sample code:
    *
@@ -2605,10 +3008,8 @@ public final Object getObject(GetObjectRequest request) {
    *
    * 
                                            **IAM Permissions**:
    *
-   * 
                                            Requires `storage.objects.get` [IAM
-   * permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket. To return
-   * object ACLs, the authenticated user must also have the `storage.objects.getIamPolicy`
-   * permission.
+   * 
                                            Requires `storage.objects.get` IAM permission on the bucket. To return object ACLs, the
+   * authenticated user must also have the `storage.objects.getIamPolicy` permission.
    *
    * 
                                            Sample code:
    *
@@ -2649,8 +3050,7 @@ public final UnaryCallable getObjectCallable() {
    *
    * 
                                            **IAM Permissions**:
    *
-   * 
                                            Requires `storage.objects.get` [IAM
-   * permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket.
+   * 
                                            Requires `storage.objects.get` IAM permission on the bucket.
    *
    * 
                                            Sample code:
    *
@@ -2690,20 +3090,15 @@ public final ServerStreamingCallable read
   /**
    * Reads an object's data.
    *
-   * 
                                            This is a bi-directional API with the added support for reading multiple ranges within one
-   * stream both within and across multiple messages. If the server encountered an error for any of
-   * the inputs, the stream will be closed with the relevant error code. Because the API allows for
-   * multiple outstanding requests, when the stream is closed the error response will contain a
-   * BidiReadObjectRangesError proto in the error extension describing the error for each
-   * outstanding 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 `BidiReadObjectRangesError` field detailing the
+   * specific error for each pending `read_id`.
    *
    * 
                                            **IAM Permissions**:
    *
-   * 
                                            Requires `storage.objects.get`
-   *
-   * 
                                            [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket.
-   *
-   * 
                                            This API is currently in preview and is not yet available for general use.
+   * 
                                            Requires `storage.objects.get` IAM permission on the bucket.
    *
    * 
                                            Sample code:
    *
@@ -2735,7 +3130,11 @@ public final ServerStreamingCallable read
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Updates an object's metadata. Equivalent to JSON API's storage.objects.patch.
+   * Updates an object's metadata. Equivalent to JSON API's `storage.objects.patch` method.
+   *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires `storage.objects.update` IAM permission on the bucket.
    *
    * 
                                            Sample code:
    *
@@ -2759,7 +3158,7 @@ public final ServerStreamingCallable read
    * @param updateMask Required. List of fields to be updated.
    *     
                                            To specify ALL fields, equivalent to the JSON API's "update" function, specify a single
    *     field with the value `*`. Note: not recommended. If a new field is introduced at a
-   *     later time, an older client updating with the `*` may accidentally reset the new
+   *     later time, an older client updating with the `*` might accidentally reset the new
    *     field's value.
    *     
                                            Not specifying any fields is an error.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
@@ -2772,7 +3171,11 @@ public final Object updateObject(Object object, FieldMask updateMask) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Updates an object's metadata. Equivalent to JSON API's storage.objects.patch.
+   * Updates an object's metadata. Equivalent to JSON API's `storage.objects.patch` method.
+   *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires `storage.objects.update` IAM permission on the bucket.
    *
    * 
                                            Sample code:
    *
@@ -2808,7 +3211,11 @@ public final Object updateObject(UpdateObjectRequest request) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Updates an object's metadata. Equivalent to JSON API's storage.objects.patch.
+   * Updates an object's metadata. Equivalent to JSON API's `storage.objects.patch` method.
+   *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires `storage.objects.update` IAM permission on the bucket.
    *
    * 
                                            Sample code:
    *
@@ -2855,45 +3262,45 @@ public final UnaryCallable updateObjectCallable() {
    * `WriteObjectSpec` into that request. They should then attach the returned `upload_id` to the
    * first message of each following call to `WriteObject`. If the stream is closed before finishing
    * the upload (either explicitly by the client or due to a network error or an error response from
-   * the server), the client should do as follows: - Check the result Status of the stream, to
-   * determine if writing can be resumed on this stream or must be restarted from scratch (by
-   * calling `StartResumableWrite()`). The resumable errors are DEADLINE_EXCEEDED, INTERNAL, and
-   * UNAVAILABLE. For each case, the client should use binary exponential backoff before retrying.
-   * Additionally, writes can be resumed after RESOURCE_EXHAUSTED errors, but only after taking
-   * appropriate measures, which may include reducing aggregate send rate across clients and/or
-   * requesting a quota increase for your project. - If the call to `WriteObject` returns `ABORTED`,
-   * that indicates concurrent attempts to update the resumable write, caused either by multiple
-   * racing clients or by a single client where the previous request was timed out on the client
-   * side but nonetheless reached the server. In this case the client should take steps to prevent
-   * further concurrent writes (e.g., increase the timeouts, stop using more than one process to
-   * perform the upload, etc.), and then should follow the steps below for resuming the upload. -
-   * For resumable errors, the client should call `QueryWriteStatus()` and then continue writing
-   * from the returned `persisted_size`. This may be less than the amount of data the client
-   * previously sent. Note also that it is acceptable to send data starting at an offset earlier
-   * than the returned `persisted_size`; in this case, the service will skip data at offsets that
-   * were already persisted (without checking that it matches the previously written data), and
-   * write only the data starting from the persisted offset. Even though the data isn't written, it
-   * may still incur a performance cost over resuming at the correct write offset. This behavior can
-   * make client-side handling simpler in some cases. - Clients must only send data that is a
-   * multiple of 256 KiB per message, unless the object is being finished with `finish_write` set to
-   * `true`.
-   *
-   * 
                                            The service will not view the object as complete until the client has sent a
+   * the server), the client should do as follows:
+   *
+   * 
                                            - Check the result Status of the stream, to determine if writing can be resumed on this
+   * stream or must be restarted from scratch (by calling `StartResumableWrite()`). The resumable
+   * errors are `DEADLINE_EXCEEDED`, `INTERNAL`, and `UNAVAILABLE`. For each case, the client should
+   * use binary exponential backoff before retrying. Additionally, writes can be resumed after
+   * `RESOURCE_EXHAUSTED` errors, but only after taking appropriate measures, which might include
+   * reducing aggregate send rate across clients and/or requesting a quota increase for your
+   * project. - If the call to `WriteObject` returns `ABORTED`, that indicates concurrent attempts
+   * to update the resumable write, caused either by multiple racing clients or by a single client
+   * where the previous request was timed out on the client side but nonetheless reached the server.
+   * In this case the client should take steps to prevent further concurrent writes. For example,
+   * increase the timeouts and stop using more than one process to perform the upload. Follow the
+   * steps below for resuming the upload. - For resumable errors, the client should call
+   * `QueryWriteStatus()` and then continue writing from the returned `persisted_size`. This might
+   * be less than the amount of data the client previously sent. Note also that it is acceptable to
+   * send data starting at an offset earlier than the returned `persisted_size`; in this case, the
+   * service skips data at offsets that were already persisted (without checking that it matches the
+   * previously written data), and write only the data starting from the persisted offset. Even
+   * though the data isn't written, it might still incur a performance cost over resuming at the
+   * correct write offset. This behavior can make client-side handling simpler in some cases. -
+   * Clients must only send data that is a multiple of 256 KiB per message, unless the object is
+   * being finished with `finish_write` set to `true`.
+   *
+   * 
                                            The service does not view the object as complete until the client has sent a
    * `WriteObjectRequest` with `finish_write` set to `true`. Sending any requests on a stream after
-   * sending a request with `finish_write` set to `true` will cause an error. The client
-   * **should** check the response it receives to determine how much data the
-   * service was able to commit and whether the service views the object as complete.
+   * sending a request with `finish_write` set to `true` causes an error. The client must check the
+   * response it receives to determine how much data the service is able to commit and whether the
+   * service views the object as complete.
    *
-   * 
                                            Attempting to resume an already finalized object will result in an OK status, with a
+   * 
                                            Attempting to resume an already finalized object results in an `OK` status, with a
    * `WriteObjectResponse` containing the finalized object's metadata.
    *
-   * 
                                            Alternatively, the BidiWriteObject operation may be used to write an object with controls
+   * 
                                            Alternatively, you can use the `BidiWriteObject` operation to write an object with controls
    * over flushing and the ability to fetch the ability to determine the current persisted size.
    *
    * 
                                            **IAM Permissions**:
    *
-   * 
                                            Requires `storage.objects.create` [IAM
-   * permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket.
+   * 
                                            Requires `storage.objects.create` IAM permission on the bucket.
    *
    * 
                                            Sample code:
    *
@@ -2943,18 +3350,18 @@ public final UnaryCallable updateObjectCallable() {
   /**
    * Stores a new object and metadata.
    *
-   * 
                                            This is similar to the WriteObject call with the added support for manual flushing of
+   * 
                                            This is similar to the `WriteObject` call with the added support for manual flushing of
    * persisted state, and the ability to determine current persisted size without closing the
    * stream.
    *
-   * 
                                            The client may specify one or both of the `state_lookup` and `flush` fields in each
-   * BidiWriteObjectRequest. If `flush` is specified, the data written so far will be persisted to
-   * storage. If `state_lookup` is specified, the service will respond with a
-   * BidiWriteObjectResponse that contains the persisted size. If both `flush` and `state_lookup`
-   * are specified, the flush will always occur before a `state_lookup`, so that both may be set in
-   * the same request and the returned state will be the state of the object post-flush. When the
-   * stream is closed, a BidiWriteObjectResponse will always be sent to the client, regardless of
-   * the value of `state_lookup`.
+   * 
                                            The client might specify one or both of the `state_lookup` and `flush` fields in each
+   * `BidiWriteObjectRequest`. If `flush` is specified, the data written so far is persisted to
+   * storage. If `state_lookup` is specified, the service responds with a `BidiWriteObjectResponse`
+   * that contains the persisted size. If both `flush` and `state_lookup` are specified, the flush
+   * always occurs before a `state_lookup`, so that both might be set in the same request and the
+   * returned state is the state of the object post-flush. When the stream is closed, a
+   * `BidiWriteObjectResponse` is always sent to the client, regardless of the value of
+   * `state_lookup`.
    *
    * 
                                            Sample code:
    *
@@ -2994,8 +3401,7 @@ public final UnaryCallable updateObjectCallable() {
    *
    * 
                                            **IAM Permissions**:
    *
-   * 
                                            The authenticated user requires `storage.objects.list` [IAM
-   * permission](https://cloud.google.com/iam/docs/overview#permissions) to use this method. To
+   * 
                                            The authenticated user requires `storage.objects.list` IAM permission to use this method. To
    * return object ACLs, the authenticated user must also have the `storage.objects.getIamPolicy`
    * permission.
    *
@@ -3032,8 +3438,7 @@ public final ListObjectsPagedResponse listObjects(BucketName parent) {
    *
    * 
                                            **IAM Permissions**:
    *
-   * 
                                            The authenticated user requires `storage.objects.list` [IAM
-   * permission](https://cloud.google.com/iam/docs/overview#permissions) to use this method. To
+   * 
                                            The authenticated user requires `storage.objects.list` IAM permission to use this method. To
    * return object ACLs, the authenticated user must also have the `storage.objects.getIamPolicy`
    * permission.
    *
@@ -3067,8 +3472,7 @@ public final ListObjectsPagedResponse listObjects(String parent) {
    *
    * 
                                            **IAM Permissions**:
    *
-   * 
                                            The authenticated user requires `storage.objects.list` [IAM
-   * permission](https://cloud.google.com/iam/docs/overview#permissions) to use this method. To
+   * 
                                            The authenticated user requires `storage.objects.list` IAM permission to use this method. To
    * return object ACLs, the authenticated user must also have the `storage.objects.getIamPolicy`
    * permission.
    *
@@ -3117,8 +3521,7 @@ public final ListObjectsPagedResponse listObjects(ListObjectsRequest request) {
    *
    * 
                                            **IAM Permissions**:
    *
-   * 
                                            The authenticated user requires `storage.objects.list` [IAM
-   * permission](https://cloud.google.com/iam/docs/overview#permissions) to use this method. To
+   * 
                                            The authenticated user requires `storage.objects.list` IAM permission to use this method. To
    * return object ACLs, the authenticated user must also have the `storage.objects.getIamPolicy`
    * permission.
    *
@@ -3167,8 +3570,7 @@ public final ListObjectsPagedResponse listObjects(ListObjectsRequest request) {
    *
    * 
                                            **IAM Permissions**:
    *
-   * 
                                            The authenticated user requires `storage.objects.list` [IAM
-   * permission](https://cloud.google.com/iam/docs/overview#permissions) to use this method. To
+   * 
                                            The authenticated user requires `storage.objects.list` IAM permission to use this method. To
    * return object ACLs, the authenticated user must also have the `storage.objects.getIamPolicy`
    * permission.
    *
@@ -3322,16 +3724,14 @@ public final UnaryCallable rewriteObjectC
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Starts a resumable write operation. This method is part of the [Resumable
-   * upload](https://cloud.google.com/storage/docs/resumable-uploads) feature. This allows you to
-   * upload large objects in multiple chunks, which is more resilient to network interruptions than
-   * a single upload. The validity duration of the write operation, and the consequences of it
-   * becoming invalid, are service-dependent.
+   * Starts a resumable write operation. This method is part of the Resumable upload feature. This
+   * allows you to upload large objects in multiple chunks, which is more resilient to network
+   * interruptions than a single upload. The validity duration of the write operation, and the
+   * consequences of it becoming invalid, are service-dependent.
    *
    * 
                                            **IAM Permissions**:
    *
-   * 
                                            Requires `storage.objects.create` [IAM
-   * permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket.
+   * 
                                            Requires `storage.objects.create` IAM permission on the bucket.
    *
    * 
                                            Sample code:
    *
@@ -3361,16 +3761,14 @@ public final StartResumableWriteResponse startResumableWrite(StartResumableWrite
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Starts a resumable write operation. This method is part of the [Resumable
-   * upload](https://cloud.google.com/storage/docs/resumable-uploads) feature. This allows you to
-   * upload large objects in multiple chunks, which is more resilient to network interruptions than
-   * a single upload. The validity duration of the write operation, and the consequences of it
-   * becoming invalid, are service-dependent.
+   * Starts a resumable write operation. This method is part of the Resumable upload feature. This
+   * allows you to upload large objects in multiple chunks, which is more resilient to network
+   * interruptions than a single upload. The validity duration of the write operation, and the
+   * consequences of it becoming invalid, are service-dependent.
    *
    * 
                                            **IAM Permissions**:
    *
-   * 
                                            Requires `storage.objects.create` [IAM
-   * permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket.
+   * 
                                            Requires `storage.objects.create` IAM permission on the bucket.
    *
    * 
                                            Sample code:
    *
@@ -3402,9 +3800,8 @@ public final StartResumableWriteResponse startResumableWrite(StartResumableWrite
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
    * Determines the `persisted_size` of an object that is being written. This method is part of the
-   * [resumable upload](https://cloud.google.com/storage/docs/resumable-uploads) feature. The
-   * returned value is the size of the object that has been persisted so far. The value can be used
-   * as the `write_offset` for the next `Write()` call.
+   * resumable upload feature. The returned value is the size of the object that has been persisted
+   * so far. The value can be used as the `write_offset` for the next `Write()` call.
    *
    * 
                                            If the object does not exist, meaning if it was deleted, or the first `Write()` has not yet
    * reached the service, this method returns the error `NOT_FOUND`.
@@ -3441,9 +3838,8 @@ public final QueryWriteStatusResponse queryWriteStatus(String uploadId) {
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
    * Determines the `persisted_size` of an object that is being written. This method is part of the
-   * [resumable upload](https://cloud.google.com/storage/docs/resumable-uploads) feature. The
-   * returned value is the size of the object that has been persisted so far. The value can be used
-   * as the `write_offset` for the next `Write()` call.
+   * resumable upload feature. The returned value is the size of the object that has been persisted
+   * so far. The value can be used as the `write_offset` for the next `Write()` call.
    *
    * 
                                            If the object does not exist, meaning if it was deleted, or the first `Write()` has not yet
    * reached the service, this method returns the error `NOT_FOUND`.
@@ -3481,9 +3877,8 @@ public final QueryWriteStatusResponse queryWriteStatus(QueryWriteStatusRequest r
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
    * Determines the `persisted_size` of an object that is being written. This method is part of the
-   * [resumable upload](https://cloud.google.com/storage/docs/resumable-uploads) feature. The
-   * returned value is the size of the object that has been persisted so far. The value can be used
-   * as the `write_offset` for the next `Write()` call.
+   * resumable upload feature. The returned value is the size of the object that has been persisted
+   * so far. The value can be used as the `write_offset` for the next `Write()` call.
    *
    * 
                                            If the object does not exist, meaning if it was deleted, or the first `Write()` has not yet
    * reached the service, this method returns the error `NOT_FOUND`.
@@ -3521,7 +3916,17 @@ public final QueryWriteStatusResponse queryWriteStatus(QueryWriteStatusRequest r
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Moves the source object to the destination object in the same bucket.
+   * Moves the source object to the destination object in the same bucket. This operation moves a
+   * source object to a destination object in the same bucket by renaming the object. The move
+   * itself is an atomic transaction, ensuring all steps either complete successfully or no changes
+   * are made.
+   *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires the following IAM permissions to use this method:
+   *
+   * 
                                            - `storage.objects.move` - `storage.objects.create` - `storage.objects.delete` (only
+   * required if overwriting an existing object)
    *
    * 
                                            Sample code:
    *
@@ -3556,7 +3961,17 @@ public final Object moveObject(BucketName bucket, String sourceObject, String de
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Moves the source object to the destination object in the same bucket.
+   * Moves the source object to the destination object in the same bucket. This operation moves a
+   * source object to a destination object in the same bucket by renaming the object. The move
+   * itself is an atomic transaction, ensuring all steps either complete successfully or no changes
+   * are made.
+   *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires the following IAM permissions to use this method:
+   *
+   * 
                                            - `storage.objects.move` - `storage.objects.create` - `storage.objects.delete` (only
+   * required if overwriting an existing object)
    *
    * 
                                            Sample code:
    *
@@ -3591,7 +4006,17 @@ public final Object moveObject(String bucket, String sourceObject, String destin
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Moves the source object to the destination object in the same bucket.
+   * Moves the source object to the destination object in the same bucket. This operation moves a
+   * source object to a destination object in the same bucket by renaming the object. The move
+   * itself is an atomic transaction, ensuring all steps either complete successfully or no changes
+   * are made.
+   *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires the following IAM permissions to use this method:
+   *
+   * 
                                            - `storage.objects.move` - `storage.objects.create` - `storage.objects.delete` (only
+   * required if overwriting an existing object)
    *
    * 
                                            Sample code:
    *
@@ -3629,7 +4054,17 @@ public final Object moveObject(MoveObjectRequest request) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Moves the source object to the destination object in the same bucket.
+   * Moves the source object to the destination object in the same bucket. This operation moves a
+   * source object to a destination object in the same bucket by renaming the object. The move
+   * itself is an atomic transaction, ensuring all steps either complete successfully or no changes
+   * are made.
+   *
+   * 
                                            **IAM Permissions**:
+   *
+   * 
                                            Requires the following IAM permissions to use this method:
+   *
+   * 
                                            - `storage.objects.move` - `storage.objects.create` - `storage.objects.delete` (only
+   * required if overwriting an existing object)
    *
    * 
                                            Sample code:
    *
diff --git a/gapic-google-cloud-storage-v2/src/main/java/com/google/storage/v2/package-info.java b/gapic-google-cloud-storage-v2/src/main/java/com/google/storage/v2/package-info.java
index c250e90f8c..cd43b211c7 100644
--- a/gapic-google-cloud-storage-v2/src/main/java/com/google/storage/v2/package-info.java
+++ b/gapic-google-cloud-storage-v2/src/main/java/com/google/storage/v2/package-info.java
@@ -24,18 +24,21 @@
  * 
                                            Service Description: ## API Overview and Naming Syntax
  *
  * 
                                            The Cloud Storage gRPC API allows applications to read and write data through the abstractions
- * of buckets and objects. For a description of these abstractions please see
- * https://cloud.google.com/storage/docs.
- *
- * 
                                            Resources are named as follows: - Projects are referred to as they are defined by the Resource
- * Manager API, using strings like `projects/123456` or `projects/my-string-id`. - Buckets are named
- * using string names of the form: `projects/{project}/buckets/{bucket}` For globally unique
- * buckets, `_` may be substituted for the project. - Objects are uniquely identified by their name
- * along with the name of the bucket they belong to, as separate strings in this API. For example:
- *
- * 
                                            ReadObjectRequest { bucket: 'projects/_/buckets/my-bucket' object: 'my-object' } Note that
- * object names can contain `/` characters, which are treated as any other character (no special
- * directory semantics).
+ * of buckets and objects. For a description of these abstractions please see [Cloud Storage
+ * documentation](https://cloud.google.com/storage/docs).
+ *
+ * 
                                            Resources are named as follows:
+ *
+ * 
                                            - Projects are referred to as they are defined by the Resource Manager API, using strings like
+ * `projects/123456` or `projects/my-string-id`. - Buckets are named using string names of the form:
+ * `projects/{project}/buckets/{bucket}`. For globally unique buckets, `_` might be substituted for
+ * the project. - Objects are uniquely identified by their name along with the name of the bucket
+ * they belong to, as separate strings in this API. For example:
+ *
+ * 
                                            ``` ReadObjectRequest { bucket: 'projects/_/buckets/my-bucket' object: 'my-object' } ```
+ *
+ * 
                                            Note that object names can contain `/` characters, which are treated as any other character
+ * (no special directory semantics).
  *
  * 
                                            Sample for StorageClient:
  *
diff --git a/generation_config.yaml b/generation_config.yaml
index 80b7630256..4cc603a6f5 100644
--- a/generation_config.yaml
+++ b/generation_config.yaml
@@ -1,5 +1,5 @@
-gapic_generator_version: 2.63.0
-googleapis_commitish: 72e7439c8e7e9986cf1865e337fc7c64ca5bda1f
+gapic_generator_version: 2.64.1
+googleapis_commitish: 1b5f8632487bce889ce05366647addc6ef5ee36d
 libraries_bom_version: 26.71.0
 libraries:
   - api_shortname: storage
diff --git a/grpc-google-cloud-storage-control-v2/src/main/java/com/google/storage/control/v2/StorageControlGrpc.java b/grpc-google-cloud-storage-control-v2/src/main/java/com/google/storage/control/v2/StorageControlGrpc.java
index a96d0106b1..ca0f2beb42 100644
--- a/grpc-google-cloud-storage-control-v2/src/main/java/com/google/storage/control/v2/StorageControlGrpc.java
+++ b/grpc-google-cloud-storage-control-v2/src/main/java/com/google/storage/control/v2/StorageControlGrpc.java
@@ -24,9 +24,6 @@
  * StorageControl service includes selected control plane operations.
  * 
                                            
  */
-@javax.annotation.Generated(
-    value = "by gRPC proto compiler",
-    comments = "Source: google/storage/control/v2/storage_control.proto")
 @io.grpc.stub.annotations.GrpcGenerated
 public final class StorageControlGrpc {
 
@@ -2234,8 +2231,8 @@ protected StorageControlBlockingV2Stub build(
      * 
                                            
      */
     public com.google.storage.control.v2.Folder createFolder(
-        com.google.storage.control.v2.CreateFolderRequest request) {
-      return io.grpc.stub.ClientCalls.blockingUnaryCall(
+        com.google.storage.control.v2.CreateFolderRequest request) throws io.grpc.StatusException {
+      return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
           getChannel(), getCreateFolderMethod(), getCallOptions(), request);
     }
 
@@ -2248,8 +2245,8 @@ public com.google.storage.control.v2.Folder createFolder(
      * 
                                            
      */
     public com.google.protobuf.Empty deleteFolder(
-        com.google.storage.control.v2.DeleteFolderRequest request) {
-      return io.grpc.stub.ClientCalls.blockingUnaryCall(
+        com.google.storage.control.v2.DeleteFolderRequest request) throws io.grpc.StatusException {
+      return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
           getChannel(), getDeleteFolderMethod(), getCallOptions(), request);
     }
 
@@ -2262,8 +2259,8 @@ public com.google.protobuf.Empty deleteFolder(
      * 
                                            
      */
     public com.google.storage.control.v2.Folder getFolder(
-        com.google.storage.control.v2.GetFolderRequest request) {
-      return io.grpc.stub.ClientCalls.blockingUnaryCall(
+        com.google.storage.control.v2.GetFolderRequest request) throws io.grpc.StatusException {
+      return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
           getChannel(), getGetFolderMethod(), getCallOptions(), request);
     }
 
@@ -2276,8 +2273,8 @@ public com.google.storage.control.v2.Folder getFolder(
      * 
                                            
      */
     public com.google.storage.control.v2.ListFoldersResponse listFolders(
-        com.google.storage.control.v2.ListFoldersRequest request) {
-      return io.grpc.stub.ClientCalls.blockingUnaryCall(
+        com.google.storage.control.v2.ListFoldersRequest request) throws io.grpc.StatusException {
+      return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
           getChannel(), getListFoldersMethod(), getCallOptions(), request);
     }
 
@@ -2292,8 +2289,8 @@ public com.google.storage.control.v2.ListFoldersResponse listFolders(
      * 
                                            
      */
     public com.google.longrunning.Operation renameFolder(
-        com.google.storage.control.v2.RenameFolderRequest request) {
-      return io.grpc.stub.ClientCalls.blockingUnaryCall(
+        com.google.storage.control.v2.RenameFolderRequest request) throws io.grpc.StatusException {
+      return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
           getChannel(), getRenameFolderMethod(), getCallOptions(), request);
     }
 
@@ -2305,8 +2302,9 @@ public com.google.longrunning.Operation renameFolder(
      * 
                                            
      */
     public com.google.storage.control.v2.StorageLayout getStorageLayout(
-        com.google.storage.control.v2.GetStorageLayoutRequest request) {
-      return io.grpc.stub.ClientCalls.blockingUnaryCall(
+        com.google.storage.control.v2.GetStorageLayoutRequest request)
+        throws io.grpc.StatusException {
+      return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
           getChannel(), getGetStorageLayoutMethod(), getCallOptions(), request);
     }
 
@@ -2318,8 +2316,9 @@ public com.google.storage.control.v2.StorageLayout getStorageLayout(
      * 
                                            
      */
     public com.google.storage.control.v2.ManagedFolder createManagedFolder(
-        com.google.storage.control.v2.CreateManagedFolderRequest request) {
-      return io.grpc.stub.ClientCalls.blockingUnaryCall(
+        com.google.storage.control.v2.CreateManagedFolderRequest request)
+        throws io.grpc.StatusException {
+      return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
           getChannel(), getCreateManagedFolderMethod(), getCallOptions(), request);
     }
 
@@ -2331,8 +2330,9 @@ public com.google.storage.control.v2.ManagedFolder createManagedFolder(
      *
                                            */ public com.google.protobuf.Empty deleteManagedFolder( - com.google.storage.control.v2.DeleteManagedFolderRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + com.google.storage.control.v2.DeleteManagedFolderRequest request) + throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getDeleteManagedFolderMethod(), getCallOptions(), request); } @@ -2344,8 +2344,9 @@ public com.google.protobuf.Empty deleteManagedFolder( * */ public com.google.storage.control.v2.ManagedFolder getManagedFolder( - com.google.storage.control.v2.GetManagedFolderRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + com.google.storage.control.v2.GetManagedFolderRequest request) + throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getGetManagedFolderMethod(), getCallOptions(), request); } @@ -2357,8 +2358,9 @@ public com.google.storage.control.v2.ManagedFolder getManagedFolder( * */ public com.google.storage.control.v2.ListManagedFoldersResponse listManagedFolders( - com.google.storage.control.v2.ListManagedFoldersRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + com.google.storage.control.v2.ListManagedFoldersRequest request) + throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getListManagedFoldersMethod(), getCallOptions(), request); } @@ -2370,8 +2372,9 @@ public com.google.storage.control.v2.ListManagedFoldersResponse listManagedFolde * */ public com.google.longrunning.Operation createAnywhereCache( - com.google.storage.control.v2.CreateAnywhereCacheRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + com.google.storage.control.v2.CreateAnywhereCacheRequest request) + throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getCreateAnywhereCacheMethod(), getCallOptions(), request); } @@ -2384,8 +2387,9 @@ public com.google.longrunning.Operation createAnywhereCache( * */ public com.google.longrunning.Operation updateAnywhereCache( - com.google.storage.control.v2.UpdateAnywhereCacheRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + com.google.storage.control.v2.UpdateAnywhereCacheRequest request) + throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getUpdateAnywhereCacheMethod(), getCallOptions(), request); } @@ -2400,8 +2404,9 @@ public com.google.longrunning.Operation updateAnywhereCache( * */ public com.google.storage.control.v2.AnywhereCache disableAnywhereCache( - com.google.storage.control.v2.DisableAnywhereCacheRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + com.google.storage.control.v2.DisableAnywhereCacheRequest request) + throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getDisableAnywhereCacheMethod(), getCallOptions(), request); } @@ -2413,8 +2418,9 @@ public com.google.storage.control.v2.AnywhereCache disableAnywhereCache( * */ public com.google.storage.control.v2.AnywhereCache pauseAnywhereCache( - com.google.storage.control.v2.PauseAnywhereCacheRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + com.google.storage.control.v2.PauseAnywhereCacheRequest request) + throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getPauseAnywhereCacheMethod(), getCallOptions(), request); } @@ -2426,8 +2432,9 @@ public com.google.storage.control.v2.AnywhereCache pauseAnywhereCache( * */ public com.google.storage.control.v2.AnywhereCache resumeAnywhereCache( - com.google.storage.control.v2.ResumeAnywhereCacheRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + com.google.storage.control.v2.ResumeAnywhereCacheRequest request) + throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getResumeAnywhereCacheMethod(), getCallOptions(), request); } @@ -2439,8 +2446,9 @@ public com.google.storage.control.v2.AnywhereCache resumeAnywhereCache( * */ public com.google.storage.control.v2.AnywhereCache getAnywhereCache( - com.google.storage.control.v2.GetAnywhereCacheRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + com.google.storage.control.v2.GetAnywhereCacheRequest request) + throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getGetAnywhereCacheMethod(), getCallOptions(), request); } @@ -2452,8 +2460,9 @@ public com.google.storage.control.v2.AnywhereCache getAnywhereCache( * */ public com.google.storage.control.v2.ListAnywhereCachesResponse listAnywhereCaches( - com.google.storage.control.v2.ListAnywhereCachesRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + com.google.storage.control.v2.ListAnywhereCachesRequest request) + throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getListAnywhereCachesMethod(), getCallOptions(), request); } @@ -2465,8 +2474,9 @@ public com.google.storage.control.v2.ListAnywhereCachesResponse listAnywhereCach * */ public com.google.storage.control.v2.IntelligenceConfig getProjectIntelligenceConfig( - com.google.storage.control.v2.GetProjectIntelligenceConfigRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + com.google.storage.control.v2.GetProjectIntelligenceConfigRequest request) + throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getGetProjectIntelligenceConfigMethod(), getCallOptions(), request); } @@ -2478,8 +2488,9 @@ public com.google.storage.control.v2.IntelligenceConfig getProjectIntelligenceCo * */ public com.google.storage.control.v2.IntelligenceConfig updateProjectIntelligenceConfig( - com.google.storage.control.v2.UpdateProjectIntelligenceConfigRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + com.google.storage.control.v2.UpdateProjectIntelligenceConfigRequest request) + throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getUpdateProjectIntelligenceConfigMethod(), getCallOptions(), request); } @@ -2491,8 +2502,9 @@ public com.google.storage.control.v2.IntelligenceConfig updateProjectIntelligenc * */ public com.google.storage.control.v2.IntelligenceConfig getFolderIntelligenceConfig( - com.google.storage.control.v2.GetFolderIntelligenceConfigRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + com.google.storage.control.v2.GetFolderIntelligenceConfigRequest request) + throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getGetFolderIntelligenceConfigMethod(), getCallOptions(), request); } @@ -2504,8 +2516,9 @@ public com.google.storage.control.v2.IntelligenceConfig getFolderIntelligenceCon * */ public com.google.storage.control.v2.IntelligenceConfig updateFolderIntelligenceConfig( - com.google.storage.control.v2.UpdateFolderIntelligenceConfigRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + com.google.storage.control.v2.UpdateFolderIntelligenceConfigRequest request) + throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getUpdateFolderIntelligenceConfigMethod(), getCallOptions(), request); } @@ -2517,8 +2530,9 @@ public com.google.storage.control.v2.IntelligenceConfig updateFolderIntelligence * */ public com.google.storage.control.v2.IntelligenceConfig getOrganizationIntelligenceConfig( - com.google.storage.control.v2.GetOrganizationIntelligenceConfigRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + com.google.storage.control.v2.GetOrganizationIntelligenceConfigRequest request) + throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getGetOrganizationIntelligenceConfigMethod(), getCallOptions(), request); } @@ -2530,8 +2544,9 @@ public com.google.storage.control.v2.IntelligenceConfig getOrganizationIntellige * */ public com.google.storage.control.v2.IntelligenceConfig updateOrganizationIntelligenceConfig( - com.google.storage.control.v2.UpdateOrganizationIntelligenceConfigRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + com.google.storage.control.v2.UpdateOrganizationIntelligenceConfigRequest request) + throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getUpdateOrganizationIntelligenceConfigMethod(), getCallOptions(), request); } @@ -2546,8 +2561,9 @@ public com.google.storage.control.v2.IntelligenceConfig updateOrganizationIntell * for a managed folder. * */ - public com.google.iam.v1.Policy getIamPolicy(com.google.iam.v1.GetIamPolicyRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + public com.google.iam.v1.Policy getIamPolicy(com.google.iam.v1.GetIamPolicyRequest request) + throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getGetIamPolicyMethod(), getCallOptions(), request); } @@ -2562,8 +2578,9 @@ public com.google.iam.v1.Policy getIamPolicy(com.google.iam.v1.GetIamPolicyReque * for a managed folder. * */ - public com.google.iam.v1.Policy setIamPolicy(com.google.iam.v1.SetIamPolicyRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + public com.google.iam.v1.Policy setIamPolicy(com.google.iam.v1.SetIamPolicyRequest request) + throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getSetIamPolicyMethod(), getCallOptions(), request); } @@ -2581,8 +2598,8 @@ public com.google.iam.v1.Policy setIamPolicy(com.google.iam.v1.SetIamPolicyReque * */ public com.google.iam.v1.TestIamPermissionsResponse testIamPermissions( - com.google.iam.v1.TestIamPermissionsRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + com.google.iam.v1.TestIamPermissionsRequest request) throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getTestIamPermissionsMethod(), getCallOptions(), request); } } diff --git a/grpc-google-cloud-storage-v2/src/main/java/com/google/storage/v2/StorageGrpc.java b/grpc-google-cloud-storage-v2/src/main/java/com/google/storage/v2/StorageGrpc.java index b68ebe1294..bdccd24c96 100644 --- a/grpc-google-cloud-storage-v2/src/main/java/com/google/storage/v2/StorageGrpc.java +++ b/grpc-google-cloud-storage-v2/src/main/java/com/google/storage/v2/StorageGrpc.java @@ -24,26 +24,26 @@ * ## API Overview and Naming Syntax * The Cloud Storage gRPC API allows applications to read and write data through * the abstractions of buckets and objects. For a description of these - * abstractions please see https://cloud.google.com/storage/docs. + * abstractions please see [Cloud Storage + * documentation](https://cloud.google.com/storage/docs). * Resources are named as follows: * - Projects are referred to as they are defined by the Resource Manager API, * using strings like `projects/123456` or `projects/my-string-id`. * - Buckets are named using string names of the form: - * `projects/{project}/buckets/{bucket}` - * For globally unique buckets, `_` may be substituted for the project. + * `projects/{project}/buckets/{bucket}`. + * For globally unique buckets, `_` might be substituted for the project. * - Objects are uniquely identified by their name along with the name of the * bucket they belong to, as separate strings in this API. For example: - * ReadObjectRequest { + * ``` + * ReadObjectRequest { * bucket: 'projects/_/buckets/my-bucket' * object: 'my-object' - * } - * Note that object names can contain `/` characters, which are treated as - * any other character (no special directory semantics). + * } + * ``` + * Note that object names can contain `/` characters, which are treated as + * any other character (no special directory semantics). * */ -@javax.annotation.Generated( - value = "by gRPC proto compiler", - comments = "Source: google/storage/v2/storage.proto") @io.grpc.stub.annotations.GrpcGenerated public final class StorageGrpc { @@ -1103,21 +1103,24 @@ public StorageFutureStub newStub( * ## API Overview and Naming Syntax * The Cloud Storage gRPC API allows applications to read and write data through * the abstractions of buckets and objects. For a description of these - * abstractions please see https://cloud.google.com/storage/docs. + * abstractions please see [Cloud Storage + * documentation](https://cloud.google.com/storage/docs). * Resources are named as follows: * - Projects are referred to as they are defined by the Resource Manager API, * using strings like `projects/123456` or `projects/my-string-id`. * - Buckets are named using string names of the form: - * `projects/{project}/buckets/{bucket}` - * For globally unique buckets, `_` may be substituted for the project. + * `projects/{project}/buckets/{bucket}`. + * For globally unique buckets, `_` might be substituted for the project. * - Objects are uniquely identified by their name along with the name of the * bucket they belong to, as separate strings in this API. For example: - * ReadObjectRequest { + * ``` + * ReadObjectRequest { * bucket: 'projects/_/buckets/my-bucket' * object: 'my-object' - * } - * Note that object names can contain `/` characters, which are treated as - * any other character (no special directory semantics). + * } + * ``` + * Note that object names can contain `/` characters, which are treated as + * any other character (no special directory semantics). * */ public interface AsyncService { @@ -1127,6 +1130,25 @@ public interface AsyncService { * * 
                                                  * Permanently deletes an empty bucket.
+     * The request fails if there are any live or
+     * noncurrent objects in the bucket, but the request succeeds if the
+     * bucket only contains soft-deleted objects or incomplete uploads, such
+     * as ongoing XML API multipart uploads. Does not permanently delete
+     * soft-deleted objects.
+     * When this API is used to delete a bucket containing an object that has a
+     * soft delete policy
+     * enabled, the object becomes soft deleted, and the
+     * `softDeleteTime` and `hardDeleteTime` properties are set on the
+     * object.
+     * Objects and multipart uploads that were in the bucket at the time of
+     * deletion are also retained for the specified retention duration. When
+     * a soft-deleted bucket reaches the end of its retention duration, it
+     * is permanently deleted. The `hardDeleteTime` of the bucket always
+     * equals
+     * or exceeds the expiration time of the last soft-deleted object in the
+     * bucket.
+     * **IAM Permissions**:
+     * Requires `storage.buckets.delete` IAM permission on the bucket.
      *
                                            */ default void deleteBucket( @@ -1141,6 +1163,13 @@ default void deleteBucket( * * 
                                                  * Returns metadata for the specified bucket.
+     * **IAM Permissions**:
+     * Requires `storage.buckets.get`
+     * IAM permission on
+     * the bucket. Additionally, to return specific bucket metadata, the
+     * authenticated user must have the following permissions:
+     * - To return the IAM policies: `storage.buckets.getIamPolicy`
+     * - To return the bucket IP filtering rules: `storage.buckets.getIpFilter`
      *
                                            */ default void getBucket( @@ -1154,6 +1183,13 @@ default void getBucket( * * 
                                                  * Creates a new bucket.
+     * **IAM Permissions**:
+     * Requires `storage.buckets.create` IAM permission on the bucket.
+     * Additionally, to enable specific bucket features, the authenticated user
+     * must have the following permissions:
+     * - To enable object retention using the `enableObjectRetention` query
+     * parameter: `storage.buckets.enableObjectRetention`
+     * - To set the bucket IP filtering rules: `storage.buckets.setIpFilter`
      *
                                            */ default void createBucket( @@ -1167,7 +1203,14 @@ default void createBucket( * * * 
                                            -     * Retrieves a list of buckets for a given project.
+     * Retrieves a list of buckets for a given project, ordered
+     * lexicographically by name.
+     * **IAM Permissions**:
+     * Requires `storage.buckets.list` IAM permission on the bucket.
+     * Additionally, to enable specific bucket features, the authenticated
+     * user must have the following permissions:
+     * - To list the IAM policies: `storage.buckets.getIamPolicy`
+     * - To list the bucket IP filtering rules: `storage.buckets.getIpFilter`
      *
                                            */ default void listBuckets( @@ -1181,7 +1224,20 @@ default void listBuckets( * * * 
                                            -     * Locks retention policy on a bucket.
+     * Permanently locks the retention
+     * policy that is
+     * currently applied to the specified bucket.
+     * Caution: Locking a bucket is an
+     * irreversible action. Once you lock a bucket:
+     * - You cannot remove the retention policy from the bucket.
+     * - You cannot decrease the retention period for the policy.
+     * Once locked, you must delete the entire bucket in order to remove the
+     * bucket's retention policy. However, before you can delete the bucket, you
+     * must delete all the objects in the bucket, which is only
+     * possible if all the objects have reached the retention period set by the
+     * retention policy.
+     * **IAM Permissions**:
+     * Requires `storage.buckets.update` IAM permission on the bucket.
      *
                                            */ default void lockBucketRetentionPolicy( @@ -1195,11 +1251,15 @@ default void lockBucketRetentionPolicy( * * * 
                                            -     * Gets the IAM policy for a specified bucket.
+     * Gets the IAM policy for a specified bucket or managed folder.
      * The `resource` field in the request should be
      * `projects/_/buckets/{bucket}` for a bucket, or
      * `projects/_/buckets/{bucket}/managedFolders/{managedFolder}`
      * for a managed folder.
+     * **IAM Permissions**:
+     * Requires `storage.buckets.getIamPolicy` on the bucket or
+     * `storage.managedFolders.getIamPolicy` IAM permission on the
+     * managed folder.
      *
                                            */ default void getIamPolicy( @@ -1213,7 +1273,7 @@ default void getIamPolicy( * * * 
                                            -     * Updates an IAM policy for the specified bucket.
+     * Updates an IAM policy for the specified bucket or managed folder.
      * The `resource` field in the request should be
      * `projects/_/buckets/{bucket}` for a bucket, or
      * `projects/_/buckets/{bucket}/managedFolders/{managedFolder}`
@@ -1232,9 +1292,8 @@ default void setIamPolicy(
      *
      * 
                                                  * Tests a set of permissions on the given bucket, object, or managed folder
-     * to see which, if any, are held by the caller.
-     * The `resource` field in the request should be
-     * `projects/_/buckets/{bucket}` for a bucket,
+     * to see which, if any, are held by the caller. The `resource` field in the
+     * request should be `projects/_/buckets/{bucket}` for a bucket,
      * `projects/_/buckets/{bucket}/objects/{object}` for an object, or
      * `projects/_/buckets/{bucket}/managedFolders/{managedFolder}`
      * for a managed folder.
@@ -1252,7 +1311,16 @@ default void testIamPermissions(
      *
      *
      * 
                                            -     * Updates a bucket. Equivalent to JSON API's storage.buckets.patch method.
+     * Updates a bucket. Changes to the bucket are readable immediately after
+     * writing, but configuration changes might take time to propagate. This
+     * method supports `patch` semantics.
+     * **IAM Permissions**:
+     * Requires `storage.buckets.update` IAM permission on the bucket.
+     * Additionally, to enable specific bucket features, the authenticated user
+     * must have the following permissions:
+     * - To set bucket IP filtering rules: `storage.buckets.setIpFilter`
+     * - To update public access prevention policies or access control lists
+     * (ACLs): `storage.buckets.setIamPolicy`
      * 
                                            
      */
     default void updateBucket(
@@ -1267,7 +1335,14 @@ default void updateBucket(
      *
      * 
                                                  * Concatenates a list of existing objects into a new object in the same
-     * bucket.
+     * bucket. The existing source objects are unaffected by this operation.
+     * **IAM Permissions**:
+     * Requires the `storage.objects.create` and `storage.objects.get` IAM
+     * permissions to use this method. If the new composite object
+     * overwrites an existing object, the authenticated user must also have
+     * the `storage.objects.delete` permission. If the request body includes
+     * the retention property, the authenticated user must also have the
+     * `storage.objects.setRetention` IAM permission.
      * 
                                            
      */
     default void composeObject(
@@ -1283,7 +1358,7 @@ default void composeObject(
      * 
                                                  * Deletes an object and its metadata. Deletions are permanent if versioning
      * is not enabled for the bucket, or if the generation parameter is used, or
-     * if [soft delete](https://cloud.google.com/storage/docs/soft-delete) is not
+     * if soft delete is not
      * enabled for the bucket.
      * When this API is used to delete an object from a bucket that has soft
      * delete policy enabled, the object becomes soft deleted, and the
@@ -1295,9 +1370,7 @@ default void composeObject(
      * API to restore soft-deleted objects until the soft delete retention period
      * has passed.
      * **IAM Permissions**:
-     * Requires `storage.objects.delete`
-     * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
-     * the bucket.
+     * Requires `storage.objects.delete` IAM permission on the bucket.
      * 
                                            
      */
     default void deleteObject(
@@ -1311,7 +1384,38 @@ default void deleteObject(
      *
      *
      * 
                                            -     * Restores a soft-deleted object.
+     * Restores a
+     * soft-deleted object.
+     * When a soft-deleted object is restored, a new copy of that object is
+     * created in the same bucket and inherits the same metadata as the
+     * soft-deleted object. The inherited metadata is the metadata that existed
+     * when the original object became soft deleted, with the following
+     * exceptions:
+     *   - The `createTime` of the new object is set to the time at which the
+     *   soft-deleted object was restored.
+     *   - The `softDeleteTime` and `hardDeleteTime` values are cleared.
+     *   - A new generation is assigned and the metageneration is reset to 1.
+     *   - If the soft-deleted object was in a bucket that had Autoclass enabled,
+     *   the new object is
+     *     restored to Standard storage.
+     *   - The restored object inherits the bucket's default object ACL, unless
+     *   `copySourceAcl` is `true`.
+     * If a live object using the same name already exists in the bucket and
+     * becomes overwritten, the live object becomes a noncurrent object if Object
+     * Versioning is enabled on the bucket. If Object Versioning is not enabled,
+     * the live object becomes soft deleted.
+     * **IAM Permissions**:
+     * Requires the following IAM permissions to use this method:
+     *   - `storage.objects.restore`
+     *   - `storage.objects.create`
+     *   - `storage.objects.delete` (only required if overwriting an existing
+     *   object)
+     *   - `storage.objects.getIamPolicy` (only required if `projection` is `full`
+     *   and the relevant bucket
+     *     has uniform bucket-level access disabled)
+     *   - `storage.objects.setIamPolicy` (only required if `copySourceAcl` is
+     *   `true` and the relevant
+     *     bucket has uniform bucket-level access disabled)
      * 
                                            
      */
     default void restoreObject(
@@ -1327,8 +1431,8 @@ default void restoreObject(
      * 
                                                  * Cancels an in-progress resumable upload.
      * Any attempts to write to the resumable upload after cancelling the upload
-     * will fail.
-     * The behavior for currently in progress write operations is not guaranteed -
+     * fail.
+     * The behavior for any in-progress write operations is not guaranteed;
      * they could either complete before the cancellation or fail if the
      * cancellation completes first.
      * 
                                            
@@ -1347,9 +1451,8 @@ default void cancelResumableWrite(
      * 
                                                  * Retrieves object metadata.
      * **IAM Permissions**:
-     * Requires `storage.objects.get`
-     * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
-     * the bucket. To return object ACLs, the authenticated user must also have
+     * Requires `storage.objects.get` IAM permission on the bucket.
+     * To return object ACLs, the authenticated user must also have
      * the `storage.objects.getIamPolicy` permission.
      * 
                                            
      */
@@ -1365,9 +1468,7 @@ default void getObject(
      * 
                                                  * Retrieves object data.
      * **IAM Permissions**:
-     * Requires `storage.objects.get`
-     * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
-     * the bucket.
+     * Requires `storage.objects.get` IAM permission on the bucket.
      * 
                                            
      */
     default void readObject(
@@ -1381,19 +1482,15 @@ default void readObject(
      *
      * 
                                                  * Reads an object's data.
-     * This is a bi-directional API with the added support for reading multiple
-     * ranges within one stream both within and across multiple messages.
-     * If the server encountered an error for any of the inputs, the stream will
-     * be closed with the relevant error code.
-     * Because the API allows for multiple outstanding requests, when the stream
-     * is closed the error response will contain a BidiReadObjectRangesError proto
-     * in the error extension describing the error for each outstanding read_id.
-     * **IAM Permissions**:
-     * Requires `storage.objects.get`
-     * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
-     * the bucket.
-     * This API is currently in preview and is not yet available for general
-     * use.
+     * 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`.
+     * **IAM Permissions**:
+     * Requires `storage.objects.get` IAM permission on the bucket.
      * 
                                            
      */
     default io.grpc.stub.StreamObserver bidiReadObject(
@@ -1408,7 +1505,9 @@ default io.grpc.stub.StreamObserver
      *
      * 
                                                  * Updates an object's metadata.
-     * Equivalent to JSON API's storage.objects.patch.
+     * Equivalent to JSON API's `storage.objects.patch` method.
+     * **IAM Permissions**:
+     * Requires `storage.objects.update` IAM permission on the bucket.
      * 
                                            
      */
     default void updateObject(
@@ -1438,47 +1537,47 @@ default void updateObject(
      * follows:
      *   - Check the result Status of the stream, to determine if writing can be
      *     resumed on this stream or must be restarted from scratch (by calling
-     *     `StartResumableWrite()`). The resumable errors are DEADLINE_EXCEEDED,
-     *     INTERNAL, and UNAVAILABLE. For each case, the client should use binary
-     *     exponential backoff before retrying.  Additionally, writes can be
-     *     resumed after RESOURCE_EXHAUSTED errors, but only after taking
-     *     appropriate measures, which may include reducing aggregate send rate
+     *     `StartResumableWrite()`). The resumable errors are `DEADLINE_EXCEEDED`,
+     *     `INTERNAL`, and `UNAVAILABLE`. For each case, the client should use
+     *     binary exponential backoff before retrying.  Additionally, writes can
+     *     be resumed after `RESOURCE_EXHAUSTED` errors, but only after taking
+     *     appropriate measures, which might include reducing aggregate send rate
      *     across clients and/or requesting a quota increase for your project.
      *   - If the call to `WriteObject` returns `ABORTED`, that indicates
      *     concurrent attempts to update the resumable write, caused either by
      *     multiple racing clients or by a single client where the previous
      *     request was timed out on the client side but nonetheless reached the
      *     server. In this case the client should take steps to prevent further
-     *     concurrent writes (e.g., increase the timeouts, stop using more than
-     *     one process to perform the upload, etc.), and then should follow the
-     *     steps below for resuming the upload.
+     *     concurrent writes. For example, increase the timeouts and stop using
+     *     more than one process to perform the upload. Follow the steps below for
+     *     resuming the upload.
      *   - For resumable errors, the client should call `QueryWriteStatus()` and
-     *     then continue writing from the returned `persisted_size`. This may be
+     *     then continue writing from the returned `persisted_size`. This might be
      *     less than the amount of data the client previously sent. Note also that
      *     it is acceptable to send data starting at an offset earlier than the
-     *     returned `persisted_size`; in this case, the service will skip data at
+     *     returned `persisted_size`; in this case, the service skips data at
      *     offsets that were already persisted (without checking that it matches
      *     the previously written data), and write only the data starting from the
-     *     persisted offset. Even though the data isn't written, it may still
+     *     persisted offset. Even though the data isn't written, it might still
      *     incur a performance cost over resuming at the correct write offset.
      *     This behavior can make client-side handling simpler in some cases.
      *   - Clients must only send data that is a multiple of 256 KiB per message,
      *     unless the object is being finished with `finish_write` set to `true`.
-     * The service will not view the object as complete until the client has
+     * The service does not view the object as complete until the client has
      * sent a `WriteObjectRequest` with `finish_write` set to `true`. Sending any
      * requests on a stream after sending a request with `finish_write` set to
-     * `true` will cause an error. The client **should** check the response it
-     * receives to determine how much data the service was able to commit and
+     * `true` causes an error. The client must check the response it
+     * receives to determine how much data the service is able to commit and
      * whether the service views the object as complete.
-     * Attempting to resume an already finalized object will result in an OK
+     * Attempting to resume an already finalized object results in an `OK`
      * status, with a `WriteObjectResponse` containing the finalized object's
      * metadata.
-     * Alternatively, the BidiWriteObject operation may be used to write an
+     * Alternatively, you can use the `BidiWriteObject` operation to write an
      * object with controls over flushing and the ability to fetch the ability to
      * determine the current persisted size.
      * **IAM Permissions**:
      * Requires `storage.objects.create`
-     * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
+     * IAM permission on
      * the bucket.
      * 
                                            
      */
@@ -1493,18 +1592,18 @@ default io.grpc.stub.StreamObserver wr
      *
      * 
                                                  * Stores a new object and metadata.
-     * This is similar to the WriteObject call with the added support for
+     * This is similar to the `WriteObject` call with the added support for
      * manual flushing of persisted state, and the ability to determine current
      * persisted size without closing the stream.
-     * The client may specify one or both of the `state_lookup` and `flush` fields
-     * in each BidiWriteObjectRequest. If `flush` is specified, the data written
-     * so far will be persisted to storage. If `state_lookup` is specified, the
-     * service will respond with a BidiWriteObjectResponse that contains the
+     * The client might specify one or both of the `state_lookup` and `flush`
+     * fields in each `BidiWriteObjectRequest`. If `flush` is specified, the data
+     * written so far is persisted to storage. If `state_lookup` is specified, the
+     * service responds with a `BidiWriteObjectResponse` that contains the
      * persisted size. If both `flush` and `state_lookup` are specified, the flush
-     * will always occur before a `state_lookup`, so that both may be set in the
-     * same request and the returned state will be the state of the object
-     * post-flush. When the stream is closed, a BidiWriteObjectResponse will
-     * always be sent to the client, regardless of the value of `state_lookup`.
+     * always occurs before a `state_lookup`, so that both might be set in the
+     * same request and the returned state is the state of the object
+     * post-flush. When the stream is closed, a `BidiWriteObjectResponse`
+     * is always sent to the client, regardless of the value of `state_lookup`.
      * 
                                            
      */
     default io.grpc.stub.StreamObserver
@@ -1522,8 +1621,8 @@ default io.grpc.stub.StreamObserver wr
      * Retrieves a list of objects matching the criteria.
      * **IAM Permissions**:
      * The authenticated user requires `storage.objects.list`
-     * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions)
-     * to use this method. To return object ACLs, the authenticated user must also
+     * IAM permission to use this method. To return object ACLs, the
+     * authenticated user must also
      * have the `storage.objects.getIamPolicy` permission.
      *
                                            */ @@ -1554,16 +1653,14 @@ default void rewriteObject( * * 
                                                  * Starts a resumable write operation. This
-     * method is part of the [Resumable
-     * upload](https://cloud.google.com/storage/docs/resumable-uploads) feature.
+     * method is part of the Resumable
+     * upload feature.
      * This allows you to upload large objects in multiple chunks, which is more
      * resilient to network interruptions than a single upload. The validity
      * duration of the write operation, and the consequences of it becoming
      * invalid, are service-dependent.
      * **IAM Permissions**:
-     * Requires `storage.objects.create`
-     * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
-     * the bucket.
+     * Requires `storage.objects.create` IAM permission on the bucket.
      *
                                            */ default void startResumableWrite( @@ -1579,8 +1676,8 @@ default void startResumableWrite( * * 
                                                  * Determines the `persisted_size` of an object that is being written. This
-     * method is part of the [resumable
-     * upload](https://cloud.google.com/storage/docs/resumable-uploads) feature.
+     * method is part of the resumable
+     * upload feature.
      * The returned value is the size of the object that has been persisted so
      * far. The value can be used as the `write_offset` for the next `Write()`
      * call.
@@ -1608,6 +1705,16 @@ default void queryWriteStatus(
      *
      * 
                                                  * Moves the source object to the destination object in the same bucket.
+     * This operation moves a source object to a destination object in the
+     * same bucket by renaming the object. The move itself is an atomic
+     * transaction, ensuring all steps either complete successfully or no
+     * changes are made.
+     * **IAM Permissions**:
+     * Requires the following IAM permissions to use this method:
+     *   - `storage.objects.move`
+     *   - `storage.objects.create`
+     *   - `storage.objects.delete` (only required if overwriting an existing
+     *   object)
      * 
                                            
      */
     default void moveObject(
@@ -1624,21 +1731,24 @@ default void moveObject(
    * ## API Overview and Naming Syntax
    * The Cloud Storage gRPC API allows applications to read and write data through
    * the abstractions of buckets and objects. For a description of these
-   * abstractions please see https://cloud.google.com/storage/docs.
+   * abstractions please see [Cloud Storage
+   * documentation](https://cloud.google.com/storage/docs).
    * Resources are named as follows:
    *   - Projects are referred to as they are defined by the Resource Manager API,
    *     using strings like `projects/123456` or `projects/my-string-id`.
    *   - Buckets are named using string names of the form:
-   *     `projects/{project}/buckets/{bucket}`
-   *     For globally unique buckets, `_` may be substituted for the project.
+   *     `projects/{project}/buckets/{bucket}`.
+   *     For globally unique buckets, `_` might be substituted for the project.
    *   - Objects are uniquely identified by their name along with the name of the
    *     bucket they belong to, as separate strings in this API. For example:
-   *       ReadObjectRequest {
+   *         ```
+   *         ReadObjectRequest {
    *         bucket: 'projects/_/buckets/my-bucket'
    *         object: 'my-object'
-   *       }
-   *     Note that object names can contain `/` characters, which are treated as
-   *     any other character (no special directory semantics).
+   *         }
+   *         ```
+   * Note that object names can contain `/` characters, which are treated as
+   * any other character (no special directory semantics).
    *
                                            */ public abstract static class StorageImplBase implements io.grpc.BindableService, AsyncService { @@ -1656,21 +1766,24 @@ public final io.grpc.ServerServiceDefinition bindService() { * ## API Overview and Naming Syntax * The Cloud Storage gRPC API allows applications to read and write data through * the abstractions of buckets and objects. For a description of these - * abstractions please see https://cloud.google.com/storage/docs. + * abstractions please see [Cloud Storage + * documentation](https://cloud.google.com/storage/docs). * Resources are named as follows: * - Projects are referred to as they are defined by the Resource Manager API, * using strings like `projects/123456` or `projects/my-string-id`. * - Buckets are named using string names of the form: - * `projects/{project}/buckets/{bucket}` - * For globally unique buckets, `_` may be substituted for the project. + * `projects/{project}/buckets/{bucket}`. + * For globally unique buckets, `_` might be substituted for the project. * - Objects are uniquely identified by their name along with the name of the * bucket they belong to, as separate strings in this API. For example: - * ReadObjectRequest { + * ``` + * ReadObjectRequest { * bucket: 'projects/_/buckets/my-bucket' * object: 'my-object' - * } - * Note that object names can contain `/` characters, which are treated as - * any other character (no special directory semantics). + * } + * ``` + * Note that object names can contain `/` characters, which are treated as + * any other character (no special directory semantics). * */ public static final class StorageStub extends io.grpc.stub.AbstractAsyncStub { @@ -1688,6 +1801,25 @@ protected StorageStub build(io.grpc.Channel channel, io.grpc.CallOptions callOpt * * 
                                                  * Permanently deletes an empty bucket.
+     * The request fails if there are any live or
+     * noncurrent objects in the bucket, but the request succeeds if the
+     * bucket only contains soft-deleted objects or incomplete uploads, such
+     * as ongoing XML API multipart uploads. Does not permanently delete
+     * soft-deleted objects.
+     * When this API is used to delete a bucket containing an object that has a
+     * soft delete policy
+     * enabled, the object becomes soft deleted, and the
+     * `softDeleteTime` and `hardDeleteTime` properties are set on the
+     * object.
+     * Objects and multipart uploads that were in the bucket at the time of
+     * deletion are also retained for the specified retention duration. When
+     * a soft-deleted bucket reaches the end of its retention duration, it
+     * is permanently deleted. The `hardDeleteTime` of the bucket always
+     * equals
+     * or exceeds the expiration time of the last soft-deleted object in the
+     * bucket.
+     * **IAM Permissions**:
+     * Requires `storage.buckets.delete` IAM permission on the bucket.
      *
                                            */ public void deleteBucket( @@ -1704,6 +1836,13 @@ public void deleteBucket( * * 
                                                  * Returns metadata for the specified bucket.
+     * **IAM Permissions**:
+     * Requires `storage.buckets.get`
+     * IAM permission on
+     * the bucket. Additionally, to return specific bucket metadata, the
+     * authenticated user must have the following permissions:
+     * - To return the IAM policies: `storage.buckets.getIamPolicy`
+     * - To return the bucket IP filtering rules: `storage.buckets.getIpFilter`
      *
                                            */ public void getBucket( @@ -1718,6 +1857,13 @@ public void getBucket( * * 
                                                  * Creates a new bucket.
+     * **IAM Permissions**:
+     * Requires `storage.buckets.create` IAM permission on the bucket.
+     * Additionally, to enable specific bucket features, the authenticated user
+     * must have the following permissions:
+     * - To enable object retention using the `enableObjectRetention` query
+     * parameter: `storage.buckets.enableObjectRetention`
+     * - To set the bucket IP filtering rules: `storage.buckets.setIpFilter`
      *
                                            */ public void createBucket( @@ -1733,7 +1879,14 @@ public void createBucket( * * * 
                                            -     * Retrieves a list of buckets for a given project.
+     * Retrieves a list of buckets for a given project, ordered
+     * lexicographically by name.
+     * **IAM Permissions**:
+     * Requires `storage.buckets.list` IAM permission on the bucket.
+     * Additionally, to enable specific bucket features, the authenticated
+     * user must have the following permissions:
+     * - To list the IAM policies: `storage.buckets.getIamPolicy`
+     * - To list the bucket IP filtering rules: `storage.buckets.getIpFilter`
      *
                                            */ public void listBuckets( @@ -1749,7 +1902,20 @@ public void listBuckets( * * * 
                                            -     * Locks retention policy on a bucket.
+     * Permanently locks the retention
+     * policy that is
+     * currently applied to the specified bucket.
+     * Caution: Locking a bucket is an
+     * irreversible action. Once you lock a bucket:
+     * - You cannot remove the retention policy from the bucket.
+     * - You cannot decrease the retention period for the policy.
+     * Once locked, you must delete the entire bucket in order to remove the
+     * bucket's retention policy. However, before you can delete the bucket, you
+     * must delete all the objects in the bucket, which is only
+     * possible if all the objects have reached the retention period set by the
+     * retention policy.
+     * **IAM Permissions**:
+     * Requires `storage.buckets.update` IAM permission on the bucket.
      *
                                            */ public void lockBucketRetentionPolicy( @@ -1765,11 +1931,15 @@ public void lockBucketRetentionPolicy( * * * 
                                            -     * Gets the IAM policy for a specified bucket.
+     * Gets the IAM policy for a specified bucket or managed folder.
      * The `resource` field in the request should be
      * `projects/_/buckets/{bucket}` for a bucket, or
      * `projects/_/buckets/{bucket}/managedFolders/{managedFolder}`
      * for a managed folder.
+     * **IAM Permissions**:
+     * Requires `storage.buckets.getIamPolicy` on the bucket or
+     * `storage.managedFolders.getIamPolicy` IAM permission on the
+     * managed folder.
      *
                                            */ public void getIamPolicy( @@ -1785,7 +1955,7 @@ public void getIamPolicy( * * * 
                                            -     * Updates an IAM policy for the specified bucket.
+     * Updates an IAM policy for the specified bucket or managed folder.
      * The `resource` field in the request should be
      * `projects/_/buckets/{bucket}` for a bucket, or
      * `projects/_/buckets/{bucket}/managedFolders/{managedFolder}`
@@ -1806,9 +1976,8 @@ public void setIamPolicy(
      *
      * 
                                                  * Tests a set of permissions on the given bucket, object, or managed folder
-     * to see which, if any, are held by the caller.
-     * The `resource` field in the request should be
-     * `projects/_/buckets/{bucket}` for a bucket,
+     * to see which, if any, are held by the caller. The `resource` field in the
+     * request should be `projects/_/buckets/{bucket}` for a bucket,
      * `projects/_/buckets/{bucket}/objects/{object}` for an object, or
      * `projects/_/buckets/{bucket}/managedFolders/{managedFolder}`
      * for a managed folder.
@@ -1828,7 +1997,16 @@ public void testIamPermissions(
      *
      *
      * 
                                            -     * Updates a bucket. Equivalent to JSON API's storage.buckets.patch method.
+     * Updates a bucket. Changes to the bucket are readable immediately after
+     * writing, but configuration changes might take time to propagate. This
+     * method supports `patch` semantics.
+     * **IAM Permissions**:
+     * Requires `storage.buckets.update` IAM permission on the bucket.
+     * Additionally, to enable specific bucket features, the authenticated user
+     * must have the following permissions:
+     * - To set bucket IP filtering rules: `storage.buckets.setIpFilter`
+     * - To update public access prevention policies or access control lists
+     * (ACLs): `storage.buckets.setIamPolicy`
      * 
                                            
      */
     public void updateBucket(
@@ -1845,7 +2023,14 @@ public void updateBucket(
      *
      * 
                                                  * Concatenates a list of existing objects into a new object in the same
-     * bucket.
+     * bucket. The existing source objects are unaffected by this operation.
+     * **IAM Permissions**:
+     * Requires the `storage.objects.create` and `storage.objects.get` IAM
+     * permissions to use this method. If the new composite object
+     * overwrites an existing object, the authenticated user must also have
+     * the `storage.objects.delete` permission. If the request body includes
+     * the retention property, the authenticated user must also have the
+     * `storage.objects.setRetention` IAM permission.
      * 
                                            
      */
     public void composeObject(
@@ -1863,7 +2048,7 @@ public void composeObject(
      * 
                                                  * Deletes an object and its metadata. Deletions are permanent if versioning
      * is not enabled for the bucket, or if the generation parameter is used, or
-     * if [soft delete](https://cloud.google.com/storage/docs/soft-delete) is not
+     * if soft delete is not
      * enabled for the bucket.
      * When this API is used to delete an object from a bucket that has soft
      * delete policy enabled, the object becomes soft deleted, and the
@@ -1875,9 +2060,7 @@ public void composeObject(
      * API to restore soft-deleted objects until the soft delete retention period
      * has passed.
      * **IAM Permissions**:
-     * Requires `storage.objects.delete`
-     * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
-     * the bucket.
+     * Requires `storage.objects.delete` IAM permission on the bucket.
      * 
                                            
      */
     public void deleteObject(
@@ -1893,7 +2076,38 @@ public void deleteObject(
      *
      *
      * 
                                            -     * Restores a soft-deleted object.
+     * Restores a
+     * soft-deleted object.
+     * When a soft-deleted object is restored, a new copy of that object is
+     * created in the same bucket and inherits the same metadata as the
+     * soft-deleted object. The inherited metadata is the metadata that existed
+     * when the original object became soft deleted, with the following
+     * exceptions:
+     *   - The `createTime` of the new object is set to the time at which the
+     *   soft-deleted object was restored.
+     *   - The `softDeleteTime` and `hardDeleteTime` values are cleared.
+     *   - A new generation is assigned and the metageneration is reset to 1.
+     *   - If the soft-deleted object was in a bucket that had Autoclass enabled,
+     *   the new object is
+     *     restored to Standard storage.
+     *   - The restored object inherits the bucket's default object ACL, unless
+     *   `copySourceAcl` is `true`.
+     * If a live object using the same name already exists in the bucket and
+     * becomes overwritten, the live object becomes a noncurrent object if Object
+     * Versioning is enabled on the bucket. If Object Versioning is not enabled,
+     * the live object becomes soft deleted.
+     * **IAM Permissions**:
+     * Requires the following IAM permissions to use this method:
+     *   - `storage.objects.restore`
+     *   - `storage.objects.create`
+     *   - `storage.objects.delete` (only required if overwriting an existing
+     *   object)
+     *   - `storage.objects.getIamPolicy` (only required if `projection` is `full`
+     *   and the relevant bucket
+     *     has uniform bucket-level access disabled)
+     *   - `storage.objects.setIamPolicy` (only required if `copySourceAcl` is
+     *   `true` and the relevant
+     *     bucket has uniform bucket-level access disabled)
      * 
                                            
      */
     public void restoreObject(
@@ -1911,8 +2125,8 @@ public void restoreObject(
      * 
                                                  * Cancels an in-progress resumable upload.
      * Any attempts to write to the resumable upload after cancelling the upload
-     * will fail.
-     * The behavior for currently in progress write operations is not guaranteed -
+     * fail.
+     * The behavior for any in-progress write operations is not guaranteed;
      * they could either complete before the cancellation or fail if the
      * cancellation completes first.
      * 
                                            
@@ -1933,9 +2147,8 @@ public void cancelResumableWrite(
      * 
                                                  * Retrieves object metadata.
      * **IAM Permissions**:
-     * Requires `storage.objects.get`
-     * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
-     * the bucket. To return object ACLs, the authenticated user must also have
+     * Requires `storage.objects.get` IAM permission on the bucket.
+     * To return object ACLs, the authenticated user must also have
      * the `storage.objects.getIamPolicy` permission.
      * 
                                            
      */
@@ -1952,9 +2165,7 @@ public void getObject(
      * 
                                                  * Retrieves object data.
      * **IAM Permissions**:
-     * Requires `storage.objects.get`
-     * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
-     * the bucket.
+     * Requires `storage.objects.get` IAM permission on the bucket.
      * 
                                            
      */
     public void readObject(
@@ -1969,19 +2180,15 @@ public void readObject(
      *
      * 
                                                  * Reads an object's data.
-     * This is a bi-directional API with the added support for reading multiple
-     * ranges within one stream both within and across multiple messages.
-     * If the server encountered an error for any of the inputs, the stream will
-     * be closed with the relevant error code.
-     * Because the API allows for multiple outstanding requests, when the stream
-     * is closed the error response will contain a BidiReadObjectRangesError proto
-     * in the error extension describing the error for each outstanding read_id.
-     * **IAM Permissions**:
-     * Requires `storage.objects.get`
-     * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
-     * the bucket.
-     * This API is currently in preview and is not yet available for general
-     * use.
+     * 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`.
+     * **IAM Permissions**:
+     * Requires `storage.objects.get` IAM permission on the bucket.
      * 
                                            
      */
     public io.grpc.stub.StreamObserver bidiReadObject(
@@ -1996,7 +2203,9 @@ public io.grpc.stub.StreamObserver
      *
      * 
                                                  * Updates an object's metadata.
-     * Equivalent to JSON API's storage.objects.patch.
+     * Equivalent to JSON API's `storage.objects.patch` method.
+     * **IAM Permissions**:
+     * Requires `storage.objects.update` IAM permission on the bucket.
      * 
                                            
      */
     public void updateObject(
@@ -2028,47 +2237,47 @@ public void updateObject(
      * follows:
      *   - Check the result Status of the stream, to determine if writing can be
      *     resumed on this stream or must be restarted from scratch (by calling
-     *     `StartResumableWrite()`). The resumable errors are DEADLINE_EXCEEDED,
-     *     INTERNAL, and UNAVAILABLE. For each case, the client should use binary
-     *     exponential backoff before retrying.  Additionally, writes can be
-     *     resumed after RESOURCE_EXHAUSTED errors, but only after taking
-     *     appropriate measures, which may include reducing aggregate send rate
+     *     `StartResumableWrite()`). The resumable errors are `DEADLINE_EXCEEDED`,
+     *     `INTERNAL`, and `UNAVAILABLE`. For each case, the client should use
+     *     binary exponential backoff before retrying.  Additionally, writes can
+     *     be resumed after `RESOURCE_EXHAUSTED` errors, but only after taking
+     *     appropriate measures, which might include reducing aggregate send rate
      *     across clients and/or requesting a quota increase for your project.
      *   - If the call to `WriteObject` returns `ABORTED`, that indicates
      *     concurrent attempts to update the resumable write, caused either by
      *     multiple racing clients or by a single client where the previous
      *     request was timed out on the client side but nonetheless reached the
      *     server. In this case the client should take steps to prevent further
-     *     concurrent writes (e.g., increase the timeouts, stop using more than
-     *     one process to perform the upload, etc.), and then should follow the
-     *     steps below for resuming the upload.
+     *     concurrent writes. For example, increase the timeouts and stop using
+     *     more than one process to perform the upload. Follow the steps below for
+     *     resuming the upload.
      *   - For resumable errors, the client should call `QueryWriteStatus()` and
-     *     then continue writing from the returned `persisted_size`. This may be
+     *     then continue writing from the returned `persisted_size`. This might be
      *     less than the amount of data the client previously sent. Note also that
      *     it is acceptable to send data starting at an offset earlier than the
-     *     returned `persisted_size`; in this case, the service will skip data at
+     *     returned `persisted_size`; in this case, the service skips data at
      *     offsets that were already persisted (without checking that it matches
      *     the previously written data), and write only the data starting from the
-     *     persisted offset. Even though the data isn't written, it may still
+     *     persisted offset. Even though the data isn't written, it might still
      *     incur a performance cost over resuming at the correct write offset.
      *     This behavior can make client-side handling simpler in some cases.
      *   - Clients must only send data that is a multiple of 256 KiB per message,
      *     unless the object is being finished with `finish_write` set to `true`.
-     * The service will not view the object as complete until the client has
+     * The service does not view the object as complete until the client has
      * sent a `WriteObjectRequest` with `finish_write` set to `true`. Sending any
      * requests on a stream after sending a request with `finish_write` set to
-     * `true` will cause an error. The client **should** check the response it
-     * receives to determine how much data the service was able to commit and
+     * `true` causes an error. The client must check the response it
+     * receives to determine how much data the service is able to commit and
      * whether the service views the object as complete.
-     * Attempting to resume an already finalized object will result in an OK
+     * Attempting to resume an already finalized object results in an `OK`
      * status, with a `WriteObjectResponse` containing the finalized object's
      * metadata.
-     * Alternatively, the BidiWriteObject operation may be used to write an
+     * Alternatively, you can use the `BidiWriteObject` operation to write an
      * object with controls over flushing and the ability to fetch the ability to
      * determine the current persisted size.
      * **IAM Permissions**:
      * Requires `storage.objects.create`
-     * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
+     * IAM permission on
      * the bucket.
      * 
                                            
      */
@@ -2083,18 +2292,18 @@ public io.grpc.stub.StreamObserver wri
      *
      * 
                                                  * Stores a new object and metadata.
-     * This is similar to the WriteObject call with the added support for
+     * This is similar to the `WriteObject` call with the added support for
      * manual flushing of persisted state, and the ability to determine current
      * persisted size without closing the stream.
-     * The client may specify one or both of the `state_lookup` and `flush` fields
-     * in each BidiWriteObjectRequest. If `flush` is specified, the data written
-     * so far will be persisted to storage. If `state_lookup` is specified, the
-     * service will respond with a BidiWriteObjectResponse that contains the
+     * The client might specify one or both of the `state_lookup` and `flush`
+     * fields in each `BidiWriteObjectRequest`. If `flush` is specified, the data
+     * written so far is persisted to storage. If `state_lookup` is specified, the
+     * service responds with a `BidiWriteObjectResponse` that contains the
      * persisted size. If both `flush` and `state_lookup` are specified, the flush
-     * will always occur before a `state_lookup`, so that both may be set in the
-     * same request and the returned state will be the state of the object
-     * post-flush. When the stream is closed, a BidiWriteObjectResponse will
-     * always be sent to the client, regardless of the value of `state_lookup`.
+     * always occurs before a `state_lookup`, so that both might be set in the
+     * same request and the returned state is the state of the object
+     * post-flush. When the stream is closed, a `BidiWriteObjectResponse`
+     * is always sent to the client, regardless of the value of `state_lookup`.
      * 
                                            
      */
     public io.grpc.stub.StreamObserver
@@ -2112,8 +2321,8 @@ public io.grpc.stub.StreamObserver wri
      * Retrieves a list of objects matching the criteria.
      * **IAM Permissions**:
      * The authenticated user requires `storage.objects.list`
-     * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions)
-     * to use this method. To return object ACLs, the authenticated user must also
+     * IAM permission to use this method. To return object ACLs, the
+     * authenticated user must also
      * have the `storage.objects.getIamPolicy` permission.
      *
                                            */ @@ -2148,16 +2357,14 @@ public void rewriteObject( * * 
                                                  * Starts a resumable write operation. This
-     * method is part of the [Resumable
-     * upload](https://cloud.google.com/storage/docs/resumable-uploads) feature.
+     * method is part of the Resumable
+     * upload feature.
      * This allows you to upload large objects in multiple chunks, which is more
      * resilient to network interruptions than a single upload. The validity
      * duration of the write operation, and the consequences of it becoming
      * invalid, are service-dependent.
      * **IAM Permissions**:
-     * Requires `storage.objects.create`
-     * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
-     * the bucket.
+     * Requires `storage.objects.create` IAM permission on the bucket.
      *
                                            */ public void startResumableWrite( @@ -2175,8 +2382,8 @@ public void startResumableWrite( * * 
                                                  * Determines the `persisted_size` of an object that is being written. This
-     * method is part of the [resumable
-     * upload](https://cloud.google.com/storage/docs/resumable-uploads) feature.
+     * method is part of the resumable
+     * upload feature.
      * The returned value is the size of the object that has been persisted so
      * far. The value can be used as the `write_offset` for the next `Write()`
      * call.
@@ -2206,6 +2413,16 @@ public void queryWriteStatus(
      *
      * 
                                                  * Moves the source object to the destination object in the same bucket.
+     * This operation moves a source object to a destination object in the
+     * same bucket by renaming the object. The move itself is an atomic
+     * transaction, ensuring all steps either complete successfully or no
+     * changes are made.
+     * **IAM Permissions**:
+     * Requires the following IAM permissions to use this method:
+     *   - `storage.objects.move`
+     *   - `storage.objects.create`
+     *   - `storage.objects.delete` (only required if overwriting an existing
+     *   object)
      * 
                                            
      */
     public void moveObject(
@@ -2223,21 +2440,24 @@ public void moveObject(
    * ## API Overview and Naming Syntax
    * The Cloud Storage gRPC API allows applications to read and write data through
    * the abstractions of buckets and objects. For a description of these
-   * abstractions please see https://cloud.google.com/storage/docs.
+   * abstractions please see [Cloud Storage
+   * documentation](https://cloud.google.com/storage/docs).
    * Resources are named as follows:
    *   - Projects are referred to as they are defined by the Resource Manager API,
    *     using strings like `projects/123456` or `projects/my-string-id`.
    *   - Buckets are named using string names of the form:
-   *     `projects/{project}/buckets/{bucket}`
-   *     For globally unique buckets, `_` may be substituted for the project.
+   *     `projects/{project}/buckets/{bucket}`.
+   *     For globally unique buckets, `_` might be substituted for the project.
    *   - Objects are uniquely identified by their name along with the name of the
    *     bucket they belong to, as separate strings in this API. For example:
-   *       ReadObjectRequest {
+   *         ```
+   *         ReadObjectRequest {
    *         bucket: 'projects/_/buckets/my-bucket'
    *         object: 'my-object'
-   *       }
-   *     Note that object names can contain `/` characters, which are treated as
-   *     any other character (no special directory semantics).
+   *         }
+   *         ```
+   * Note that object names can contain `/` characters, which are treated as
+   * any other character (no special directory semantics).
    *
                                            */ public static final class StorageBlockingV2Stub @@ -2257,11 +2477,30 @@ protected StorageBlockingV2Stub build( * * 
                                                  * Permanently deletes an empty bucket.
+     * The request fails if there are any live or
+     * noncurrent objects in the bucket, but the request succeeds if the
+     * bucket only contains soft-deleted objects or incomplete uploads, such
+     * as ongoing XML API multipart uploads. Does not permanently delete
+     * soft-deleted objects.
+     * When this API is used to delete a bucket containing an object that has a
+     * soft delete policy
+     * enabled, the object becomes soft deleted, and the
+     * `softDeleteTime` and `hardDeleteTime` properties are set on the
+     * object.
+     * Objects and multipart uploads that were in the bucket at the time of
+     * deletion are also retained for the specified retention duration. When
+     * a soft-deleted bucket reaches the end of its retention duration, it
+     * is permanently deleted. The `hardDeleteTime` of the bucket always
+     * equals
+     * or exceeds the expiration time of the last soft-deleted object in the
+     * bucket.
+     * **IAM Permissions**:
+     * Requires `storage.buckets.delete` IAM permission on the bucket.
      *
                                            */ - public com.google.protobuf.Empty deleteBucket( - com.google.storage.v2.DeleteBucketRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + public com.google.protobuf.Empty deleteBucket(com.google.storage.v2.DeleteBucketRequest request) + throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getDeleteBucketMethod(), getCallOptions(), request); } @@ -2270,10 +2509,18 @@ public com.google.protobuf.Empty deleteBucket( * * 
                                                  * Returns metadata for the specified bucket.
+     * **IAM Permissions**:
+     * Requires `storage.buckets.get`
+     * IAM permission on
+     * the bucket. Additionally, to return specific bucket metadata, the
+     * authenticated user must have the following permissions:
+     * - To return the IAM policies: `storage.buckets.getIamPolicy`
+     * - To return the bucket IP filtering rules: `storage.buckets.getIpFilter`
      *
                                            */ - public com.google.storage.v2.Bucket getBucket(com.google.storage.v2.GetBucketRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + public com.google.storage.v2.Bucket getBucket(com.google.storage.v2.GetBucketRequest request) + throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getGetBucketMethod(), getCallOptions(), request); } @@ -2282,11 +2529,18 @@ public com.google.storage.v2.Bucket getBucket(com.google.storage.v2.GetBucketReq * * 
                                                  * Creates a new bucket.
+     * **IAM Permissions**:
+     * Requires `storage.buckets.create` IAM permission on the bucket.
+     * Additionally, to enable specific bucket features, the authenticated user
+     * must have the following permissions:
+     * - To enable object retention using the `enableObjectRetention` query
+     * parameter: `storage.buckets.enableObjectRetention`
+     * - To set the bucket IP filtering rules: `storage.buckets.setIpFilter`
      *
                                            */ public com.google.storage.v2.Bucket createBucket( - com.google.storage.v2.CreateBucketRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + com.google.storage.v2.CreateBucketRequest request) throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getCreateBucketMethod(), getCallOptions(), request); } @@ -2294,12 +2548,19 @@ public com.google.storage.v2.Bucket createBucket( * * * 
                                            -     * Retrieves a list of buckets for a given project.
+     * Retrieves a list of buckets for a given project, ordered
+     * lexicographically by name.
+     * **IAM Permissions**:
+     * Requires `storage.buckets.list` IAM permission on the bucket.
+     * Additionally, to enable specific bucket features, the authenticated
+     * user must have the following permissions:
+     * - To list the IAM policies: `storage.buckets.getIamPolicy`
+     * - To list the bucket IP filtering rules: `storage.buckets.getIpFilter`
      *
                                            */ public com.google.storage.v2.ListBucketsResponse listBuckets( - com.google.storage.v2.ListBucketsRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + com.google.storage.v2.ListBucketsRequest request) throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getListBucketsMethod(), getCallOptions(), request); } @@ -2307,12 +2568,26 @@ public com.google.storage.v2.ListBucketsResponse listBuckets( * * * 
                                            -     * Locks retention policy on a bucket.
+     * Permanently locks the retention
+     * policy that is
+     * currently applied to the specified bucket.
+     * Caution: Locking a bucket is an
+     * irreversible action. Once you lock a bucket:
+     * - You cannot remove the retention policy from the bucket.
+     * - You cannot decrease the retention period for the policy.
+     * Once locked, you must delete the entire bucket in order to remove the
+     * bucket's retention policy. However, before you can delete the bucket, you
+     * must delete all the objects in the bucket, which is only
+     * possible if all the objects have reached the retention period set by the
+     * retention policy.
+     * **IAM Permissions**:
+     * Requires `storage.buckets.update` IAM permission on the bucket.
      *
                                            */ public com.google.storage.v2.Bucket lockBucketRetentionPolicy( - com.google.storage.v2.LockBucketRetentionPolicyRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + com.google.storage.v2.LockBucketRetentionPolicyRequest request) + throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getLockBucketRetentionPolicyMethod(), getCallOptions(), request); } @@ -2320,15 +2595,20 @@ public com.google.storage.v2.Bucket lockBucketRetentionPolicy( * * * 
                                            -     * Gets the IAM policy for a specified bucket.
+     * Gets the IAM policy for a specified bucket or managed folder.
      * The `resource` field in the request should be
      * `projects/_/buckets/{bucket}` for a bucket, or
      * `projects/_/buckets/{bucket}/managedFolders/{managedFolder}`
      * for a managed folder.
+     * **IAM Permissions**:
+     * Requires `storage.buckets.getIamPolicy` on the bucket or
+     * `storage.managedFolders.getIamPolicy` IAM permission on the
+     * managed folder.
      *
                                            */ - public com.google.iam.v1.Policy getIamPolicy(com.google.iam.v1.GetIamPolicyRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + public com.google.iam.v1.Policy getIamPolicy(com.google.iam.v1.GetIamPolicyRequest request) + throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getGetIamPolicyMethod(), getCallOptions(), request); } @@ -2336,15 +2616,16 @@ public com.google.iam.v1.Policy getIamPolicy(com.google.iam.v1.GetIamPolicyReque * * * 
                                            -     * Updates an IAM policy for the specified bucket.
+     * Updates an IAM policy for the specified bucket or managed folder.
      * The `resource` field in the request should be
      * `projects/_/buckets/{bucket}` for a bucket, or
      * `projects/_/buckets/{bucket}/managedFolders/{managedFolder}`
      * for a managed folder.
      *
                                            */ - public com.google.iam.v1.Policy setIamPolicy(com.google.iam.v1.SetIamPolicyRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + public com.google.iam.v1.Policy setIamPolicy(com.google.iam.v1.SetIamPolicyRequest request) + throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getSetIamPolicyMethod(), getCallOptions(), request); } @@ -2353,17 +2634,16 @@ public com.google.iam.v1.Policy setIamPolicy(com.google.iam.v1.SetIamPolicyReque * * 
                                                  * Tests a set of permissions on the given bucket, object, or managed folder
-     * to see which, if any, are held by the caller.
-     * The `resource` field in the request should be
-     * `projects/_/buckets/{bucket}` for a bucket,
+     * to see which, if any, are held by the caller. The `resource` field in the
+     * request should be `projects/_/buckets/{bucket}` for a bucket,
      * `projects/_/buckets/{bucket}/objects/{object}` for an object, or
      * `projects/_/buckets/{bucket}/managedFolders/{managedFolder}`
      * for a managed folder.
      *
                                            */ public com.google.iam.v1.TestIamPermissionsResponse testIamPermissions( - com.google.iam.v1.TestIamPermissionsRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + com.google.iam.v1.TestIamPermissionsRequest request) throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getTestIamPermissionsMethod(), getCallOptions(), request); } @@ -2371,12 +2651,21 @@ public com.google.iam.v1.TestIamPermissionsResponse testIamPermissions( * * * 
                                            -     * Updates a bucket. Equivalent to JSON API's storage.buckets.patch method.
+     * Updates a bucket. Changes to the bucket are readable immediately after
+     * writing, but configuration changes might take time to propagate. This
+     * method supports `patch` semantics.
+     * **IAM Permissions**:
+     * Requires `storage.buckets.update` IAM permission on the bucket.
+     * Additionally, to enable specific bucket features, the authenticated user
+     * must have the following permissions:
+     * - To set bucket IP filtering rules: `storage.buckets.setIpFilter`
+     * - To update public access prevention policies or access control lists
+     * (ACLs): `storage.buckets.setIamPolicy`
      *
                                            */ public com.google.storage.v2.Bucket updateBucket( - com.google.storage.v2.UpdateBucketRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + com.google.storage.v2.UpdateBucketRequest request) throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getUpdateBucketMethod(), getCallOptions(), request); } @@ -2385,12 +2674,19 @@ public com.google.storage.v2.Bucket updateBucket( * * 
                                                  * Concatenates a list of existing objects into a new object in the same
-     * bucket.
+     * bucket. The existing source objects are unaffected by this operation.
+     * **IAM Permissions**:
+     * Requires the `storage.objects.create` and `storage.objects.get` IAM
+     * permissions to use this method. If the new composite object
+     * overwrites an existing object, the authenticated user must also have
+     * the `storage.objects.delete` permission. If the request body includes
+     * the retention property, the authenticated user must also have the
+     * `storage.objects.setRetention` IAM permission.
      *
                                            */ public com.google.storage.v2.Object composeObject( - com.google.storage.v2.ComposeObjectRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + com.google.storage.v2.ComposeObjectRequest request) throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getComposeObjectMethod(), getCallOptions(), request); } @@ -2400,7 +2696,7 @@ public com.google.storage.v2.Object composeObject( * 
                                                  * Deletes an object and its metadata. Deletions are permanent if versioning
      * is not enabled for the bucket, or if the generation parameter is used, or
-     * if [soft delete](https://cloud.google.com/storage/docs/soft-delete) is not
+     * if soft delete is not
      * enabled for the bucket.
      * When this API is used to delete an object from a bucket that has soft
      * delete policy enabled, the object becomes soft deleted, and the
@@ -2412,14 +2708,12 @@ public com.google.storage.v2.Object composeObject(
      * API to restore soft-deleted objects until the soft delete retention period
      * has passed.
      * **IAM Permissions**:
-     * Requires `storage.objects.delete`
-     * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
-     * the bucket.
+     * Requires `storage.objects.delete` IAM permission on the bucket.
      *
                                            */ - public com.google.protobuf.Empty deleteObject( - com.google.storage.v2.DeleteObjectRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + public com.google.protobuf.Empty deleteObject(com.google.storage.v2.DeleteObjectRequest request) + throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getDeleteObjectMethod(), getCallOptions(), request); } @@ -2427,12 +2721,43 @@ public com.google.protobuf.Empty deleteObject( * * * 
                                            -     * Restores a soft-deleted object.
+     * Restores a
+     * soft-deleted object.
+     * When a soft-deleted object is restored, a new copy of that object is
+     * created in the same bucket and inherits the same metadata as the
+     * soft-deleted object. The inherited metadata is the metadata that existed
+     * when the original object became soft deleted, with the following
+     * exceptions:
+     *   - The `createTime` of the new object is set to the time at which the
+     *   soft-deleted object was restored.
+     *   - The `softDeleteTime` and `hardDeleteTime` values are cleared.
+     *   - A new generation is assigned and the metageneration is reset to 1.
+     *   - If the soft-deleted object was in a bucket that had Autoclass enabled,
+     *   the new object is
+     *     restored to Standard storage.
+     *   - The restored object inherits the bucket's default object ACL, unless
+     *   `copySourceAcl` is `true`.
+     * If a live object using the same name already exists in the bucket and
+     * becomes overwritten, the live object becomes a noncurrent object if Object
+     * Versioning is enabled on the bucket. If Object Versioning is not enabled,
+     * the live object becomes soft deleted.
+     * **IAM Permissions**:
+     * Requires the following IAM permissions to use this method:
+     *   - `storage.objects.restore`
+     *   - `storage.objects.create`
+     *   - `storage.objects.delete` (only required if overwriting an existing
+     *   object)
+     *   - `storage.objects.getIamPolicy` (only required if `projection` is `full`
+     *   and the relevant bucket
+     *     has uniform bucket-level access disabled)
+     *   - `storage.objects.setIamPolicy` (only required if `copySourceAcl` is
+     *   `true` and the relevant
+     *     bucket has uniform bucket-level access disabled)
      *
                                            */ public com.google.storage.v2.Object restoreObject( - com.google.storage.v2.RestoreObjectRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + com.google.storage.v2.RestoreObjectRequest request) throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getRestoreObjectMethod(), getCallOptions(), request); } @@ -2442,15 +2767,15 @@ public com.google.storage.v2.Object restoreObject( * 
                                                  * Cancels an in-progress resumable upload.
      * Any attempts to write to the resumable upload after cancelling the upload
-     * will fail.
-     * The behavior for currently in progress write operations is not guaranteed -
+     * fail.
+     * The behavior for any in-progress write operations is not guaranteed;
      * they could either complete before the cancellation or fail if the
      * cancellation completes first.
      *
                                            */ public com.google.storage.v2.CancelResumableWriteResponse cancelResumableWrite( - com.google.storage.v2.CancelResumableWriteRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + com.google.storage.v2.CancelResumableWriteRequest request) throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getCancelResumableWriteMethod(), getCallOptions(), request); } @@ -2460,14 +2785,14 @@ public com.google.storage.v2.CancelResumableWriteResponse cancelResumableWrite( * 
                                                  * Retrieves object metadata.
      * **IAM Permissions**:
-     * Requires `storage.objects.get`
-     * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
-     * the bucket. To return object ACLs, the authenticated user must also have
+     * Requires `storage.objects.get` IAM permission on the bucket.
+     * To return object ACLs, the authenticated user must also have
      * the `storage.objects.getIamPolicy` permission.
      *
                                            */ - public com.google.storage.v2.Object getObject(com.google.storage.v2.GetObjectRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + public com.google.storage.v2.Object getObject(com.google.storage.v2.GetObjectRequest request) + throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getGetObjectMethod(), getCallOptions(), request); } @@ -2477,9 +2802,7 @@ public com.google.storage.v2.Object getObject(com.google.storage.v2.GetObjectReq * 
                                                  * Retrieves object data.
      * **IAM Permissions**:
-     * Requires `storage.objects.get`
-     * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
-     * the bucket.
+     * Requires `storage.objects.get` IAM permission on the bucket.
      *
                                            */ @io.grpc.ExperimentalApi("https://github.com/grpc/grpc-java/issues/10918") @@ -2494,19 +2817,15 @@ public io.grpc.stub.BlockingClientCall * Reads an object's data. - * This is a bi-directional API with the added support for reading multiple - * ranges within one stream both within and across multiple messages. - * If the server encountered an error for any of the inputs, the stream will - * be closed with the relevant error code. - * Because the API allows for multiple outstanding requests, when the stream - * is closed the error response will contain a BidiReadObjectRangesError proto - * in the error extension describing the error for each outstanding read_id. - * **IAM Permissions**: - * Requires `storage.objects.get` - * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on - * the bucket. - * This API is currently in preview and is not yet available for general - * use. + * 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`. + * **IAM Permissions**: + * Requires `storage.objects.get` IAM permission on the bucket. * */ @io.grpc.ExperimentalApi("https://github.com/grpc/grpc-java/issues/10918") @@ -2523,12 +2842,14 @@ public io.grpc.stub.BlockingClientCall * Updates an object's metadata. - * Equivalent to JSON API's storage.objects.patch. + * Equivalent to JSON API's `storage.objects.patch` method. + * **IAM Permissions**: + * Requires `storage.objects.update` IAM permission on the bucket. * */ public com.google.storage.v2.Object updateObject( - com.google.storage.v2.UpdateObjectRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + com.google.storage.v2.UpdateObjectRequest request) throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getUpdateObjectMethod(), getCallOptions(), request); } @@ -2552,47 +2873,47 @@ public com.google.storage.v2.Object updateObject( * follows: * - Check the result Status of the stream, to determine if writing can be * resumed on this stream or must be restarted from scratch (by calling - * `StartResumableWrite()`). The resumable errors are DEADLINE_EXCEEDED, - * INTERNAL, and UNAVAILABLE. For each case, the client should use binary - * exponential backoff before retrying. Additionally, writes can be - * resumed after RESOURCE_EXHAUSTED errors, but only after taking - * appropriate measures, which may include reducing aggregate send rate + * `StartResumableWrite()`). The resumable errors are `DEADLINE_EXCEEDED`, + * `INTERNAL`, and `UNAVAILABLE`. For each case, the client should use + * binary exponential backoff before retrying. Additionally, writes can + * be resumed after `RESOURCE_EXHAUSTED` errors, but only after taking + * appropriate measures, which might include reducing aggregate send rate * across clients and/or requesting a quota increase for your project. * - If the call to `WriteObject` returns `ABORTED`, that indicates * concurrent attempts to update the resumable write, caused either by * multiple racing clients or by a single client where the previous * request was timed out on the client side but nonetheless reached the * server. In this case the client should take steps to prevent further - * concurrent writes (e.g., increase the timeouts, stop using more than - * one process to perform the upload, etc.), and then should follow the - * steps below for resuming the upload. + * concurrent writes. For example, increase the timeouts and stop using + * more than one process to perform the upload. Follow the steps below for + * resuming the upload. * - For resumable errors, the client should call `QueryWriteStatus()` and - * then continue writing from the returned `persisted_size`. This may be + * then continue writing from the returned `persisted_size`. This might be * less than the amount of data the client previously sent. Note also that * it is acceptable to send data starting at an offset earlier than the - * returned `persisted_size`; in this case, the service will skip data at + * returned `persisted_size`; in this case, the service skips data at * offsets that were already persisted (without checking that it matches * the previously written data), and write only the data starting from the - * persisted offset. Even though the data isn't written, it may still + * persisted offset. Even though the data isn't written, it might still * incur a performance cost over resuming at the correct write offset. * This behavior can make client-side handling simpler in some cases. * - Clients must only send data that is a multiple of 256 KiB per message, * unless the object is being finished with `finish_write` set to `true`. - * The service will not view the object as complete until the client has + * The service does not view the object as complete until the client has * sent a `WriteObjectRequest` with `finish_write` set to `true`. Sending any * requests on a stream after sending a request with `finish_write` set to - * `true` will cause an error. The client **should** check the response it - * receives to determine how much data the service was able to commit and + * `true` causes an error. The client must check the response it + * receives to determine how much data the service is able to commit and * whether the service views the object as complete. - * Attempting to resume an already finalized object will result in an OK + * Attempting to resume an already finalized object results in an `OK` * status, with a `WriteObjectResponse` containing the finalized object's * metadata. - * Alternatively, the BidiWriteObject operation may be used to write an + * Alternatively, you can use the `BidiWriteObject` operation to write an * object with controls over flushing and the ability to fetch the ability to * determine the current persisted size. * **IAM Permissions**: * Requires `storage.objects.create` - * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on + * IAM permission on * the bucket. * */ @@ -2609,18 +2930,18 @@ public com.google.storage.v2.Object updateObject( * * 
                                                  * Stores a new object and metadata.
-     * This is similar to the WriteObject call with the added support for
+     * This is similar to the `WriteObject` call with the added support for
      * manual flushing of persisted state, and the ability to determine current
      * persisted size without closing the stream.
-     * The client may specify one or both of the `state_lookup` and `flush` fields
-     * in each BidiWriteObjectRequest. If `flush` is specified, the data written
-     * so far will be persisted to storage. If `state_lookup` is specified, the
-     * service will respond with a BidiWriteObjectResponse that contains the
+     * The client might specify one or both of the `state_lookup` and `flush`
+     * fields in each `BidiWriteObjectRequest`. If `flush` is specified, the data
+     * written so far is persisted to storage. If `state_lookup` is specified, the
+     * service responds with a `BidiWriteObjectResponse` that contains the
      * persisted size. If both `flush` and `state_lookup` are specified, the flush
-     * will always occur before a `state_lookup`, so that both may be set in the
-     * same request and the returned state will be the state of the object
-     * post-flush. When the stream is closed, a BidiWriteObjectResponse will
-     * always be sent to the client, regardless of the value of `state_lookup`.
+     * always occurs before a `state_lookup`, so that both might be set in the
+     * same request and the returned state is the state of the object
+     * post-flush. When the stream is closed, a `BidiWriteObjectResponse`
+     * is always sent to the client, regardless of the value of `state_lookup`.
      *
                                            */ @io.grpc.ExperimentalApi("https://github.com/grpc/grpc-java/issues/10918") @@ -2639,14 +2960,14 @@ public com.google.storage.v2.Object updateObject( * Retrieves a list of objects matching the criteria. * **IAM Permissions**: * The authenticated user requires `storage.objects.list` - * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) - * to use this method. To return object ACLs, the authenticated user must also + * IAM permission to use this method. To return object ACLs, the + * authenticated user must also * have the `storage.objects.getIamPolicy` permission. * */ public com.google.storage.v2.ListObjectsResponse listObjects( - com.google.storage.v2.ListObjectsRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + com.google.storage.v2.ListObjectsRequest request) throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getListObjectsMethod(), getCallOptions(), request); } @@ -2659,8 +2980,8 @@ public com.google.storage.v2.ListObjectsResponse listObjects( * */ public com.google.storage.v2.RewriteResponse rewriteObject( - com.google.storage.v2.RewriteObjectRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + com.google.storage.v2.RewriteObjectRequest request) throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getRewriteObjectMethod(), getCallOptions(), request); } @@ -2669,21 +2990,19 @@ public com.google.storage.v2.RewriteResponse rewriteObject( * * 
                                                  * Starts a resumable write operation. This
-     * method is part of the [Resumable
-     * upload](https://cloud.google.com/storage/docs/resumable-uploads) feature.
+     * method is part of the Resumable
+     * upload feature.
      * This allows you to upload large objects in multiple chunks, which is more
      * resilient to network interruptions than a single upload. The validity
      * duration of the write operation, and the consequences of it becoming
      * invalid, are service-dependent.
      * **IAM Permissions**:
-     * Requires `storage.objects.create`
-     * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
-     * the bucket.
+     * Requires `storage.objects.create` IAM permission on the bucket.
      *
                                            */ public com.google.storage.v2.StartResumableWriteResponse startResumableWrite( - com.google.storage.v2.StartResumableWriteRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + com.google.storage.v2.StartResumableWriteRequest request) throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getStartResumableWriteMethod(), getCallOptions(), request); } @@ -2692,8 +3011,8 @@ public com.google.storage.v2.StartResumableWriteResponse startResumableWrite( * * 
                                                  * Determines the `persisted_size` of an object that is being written. This
-     * method is part of the [resumable
-     * upload](https://cloud.google.com/storage/docs/resumable-uploads) feature.
+     * method is part of the resumable
+     * upload feature.
      * The returned value is the size of the object that has been persisted so
      * far. The value can be used as the `write_offset` for the next `Write()`
      * call.
@@ -2709,8 +3028,8 @@ public com.google.storage.v2.StartResumableWriteResponse startResumableWrite(
      *
                                            */ public com.google.storage.v2.QueryWriteStatusResponse queryWriteStatus( - com.google.storage.v2.QueryWriteStatusRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + com.google.storage.v2.QueryWriteStatusRequest request) throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getQueryWriteStatusMethod(), getCallOptions(), request); } @@ -2719,11 +3038,21 @@ public com.google.storage.v2.QueryWriteStatusResponse queryWriteStatus( * * 
                                                  * Moves the source object to the destination object in the same bucket.
+     * This operation moves a source object to a destination object in the
+     * same bucket by renaming the object. The move itself is an atomic
+     * transaction, ensuring all steps either complete successfully or no
+     * changes are made.
+     * **IAM Permissions**:
+     * Requires the following IAM permissions to use this method:
+     *   - `storage.objects.move`
+     *   - `storage.objects.create`
+     *   - `storage.objects.delete` (only required if overwriting an existing
+     *   object)
      *
                                            */ - public com.google.storage.v2.Object moveObject( - com.google.storage.v2.MoveObjectRequest request) { - return io.grpc.stub.ClientCalls.blockingUnaryCall( + public com.google.storage.v2.Object moveObject(com.google.storage.v2.MoveObjectRequest request) + throws io.grpc.StatusException { + return io.grpc.stub.ClientCalls.blockingV2UnaryCall( getChannel(), getMoveObjectMethod(), getCallOptions(), request); } } @@ -2735,21 +3064,24 @@ public com.google.storage.v2.Object moveObject( * ## API Overview and Naming Syntax * The Cloud Storage gRPC API allows applications to read and write data through * the abstractions of buckets and objects. For a description of these - * abstractions please see https://cloud.google.com/storage/docs. + * abstractions please see [Cloud Storage + * documentation](https://cloud.google.com/storage/docs). * Resources are named as follows: * - Projects are referred to as they are defined by the Resource Manager API, * using strings like `projects/123456` or `projects/my-string-id`. * - Buckets are named using string names of the form: - * `projects/{project}/buckets/{bucket}` - * For globally unique buckets, `_` may be substituted for the project. + * `projects/{project}/buckets/{bucket}`. + * For globally unique buckets, `_` might be substituted for the project. * - Objects are uniquely identified by their name along with the name of the * bucket they belong to, as separate strings in this API. For example: - * ReadObjectRequest { + * ``` + * ReadObjectRequest { * bucket: 'projects/_/buckets/my-bucket' * object: 'my-object' - * } - * Note that object names can contain `/` characters, which are treated as - * any other character (no special directory semantics). + * } + * ``` + * Note that object names can contain `/` characters, which are treated as + * any other character (no special directory semantics). * */ public static final class StorageBlockingStub @@ -2768,6 +3100,25 @@ protected StorageBlockingStub build(io.grpc.Channel channel, io.grpc.CallOptions * * 
                                                  * Permanently deletes an empty bucket.
+     * The request fails if there are any live or
+     * noncurrent objects in the bucket, but the request succeeds if the
+     * bucket only contains soft-deleted objects or incomplete uploads, such
+     * as ongoing XML API multipart uploads. Does not permanently delete
+     * soft-deleted objects.
+     * When this API is used to delete a bucket containing an object that has a
+     * soft delete policy
+     * enabled, the object becomes soft deleted, and the
+     * `softDeleteTime` and `hardDeleteTime` properties are set on the
+     * object.
+     * Objects and multipart uploads that were in the bucket at the time of
+     * deletion are also retained for the specified retention duration. When
+     * a soft-deleted bucket reaches the end of its retention duration, it
+     * is permanently deleted. The `hardDeleteTime` of the bucket always
+     * equals
+     * or exceeds the expiration time of the last soft-deleted object in the
+     * bucket.
+     * **IAM Permissions**:
+     * Requires `storage.buckets.delete` IAM permission on the bucket.
      *
                                            */ public com.google.protobuf.Empty deleteBucket( @@ -2781,6 +3132,13 @@ public com.google.protobuf.Empty deleteBucket( * * 
                                                  * Returns metadata for the specified bucket.
+     * **IAM Permissions**:
+     * Requires `storage.buckets.get`
+     * IAM permission on
+     * the bucket. Additionally, to return specific bucket metadata, the
+     * authenticated user must have the following permissions:
+     * - To return the IAM policies: `storage.buckets.getIamPolicy`
+     * - To return the bucket IP filtering rules: `storage.buckets.getIpFilter`
      *
                                            */ public com.google.storage.v2.Bucket getBucket(com.google.storage.v2.GetBucketRequest request) { @@ -2793,6 +3151,13 @@ public com.google.storage.v2.Bucket getBucket(com.google.storage.v2.GetBucketReq * * 
                                                  * Creates a new bucket.
+     * **IAM Permissions**:
+     * Requires `storage.buckets.create` IAM permission on the bucket.
+     * Additionally, to enable specific bucket features, the authenticated user
+     * must have the following permissions:
+     * - To enable object retention using the `enableObjectRetention` query
+     * parameter: `storage.buckets.enableObjectRetention`
+     * - To set the bucket IP filtering rules: `storage.buckets.setIpFilter`
      *
                                            */ public com.google.storage.v2.Bucket createBucket( @@ -2805,7 +3170,14 @@ public com.google.storage.v2.Bucket createBucket( * * * 
                                            -     * Retrieves a list of buckets for a given project.
+     * Retrieves a list of buckets for a given project, ordered
+     * lexicographically by name.
+     * **IAM Permissions**:
+     * Requires `storage.buckets.list` IAM permission on the bucket.
+     * Additionally, to enable specific bucket features, the authenticated
+     * user must have the following permissions:
+     * - To list the IAM policies: `storage.buckets.getIamPolicy`
+     * - To list the bucket IP filtering rules: `storage.buckets.getIpFilter`
      *
                                            */ public com.google.storage.v2.ListBucketsResponse listBuckets( @@ -2818,7 +3190,20 @@ public com.google.storage.v2.ListBucketsResponse listBuckets( * * * 
                                            -     * Locks retention policy on a bucket.
+     * Permanently locks the retention
+     * policy that is
+     * currently applied to the specified bucket.
+     * Caution: Locking a bucket is an
+     * irreversible action. Once you lock a bucket:
+     * - You cannot remove the retention policy from the bucket.
+     * - You cannot decrease the retention period for the policy.
+     * Once locked, you must delete the entire bucket in order to remove the
+     * bucket's retention policy. However, before you can delete the bucket, you
+     * must delete all the objects in the bucket, which is only
+     * possible if all the objects have reached the retention period set by the
+     * retention policy.
+     * **IAM Permissions**:
+     * Requires `storage.buckets.update` IAM permission on the bucket.
      *
                                            */ public com.google.storage.v2.Bucket lockBucketRetentionPolicy( @@ -2831,11 +3216,15 @@ public com.google.storage.v2.Bucket lockBucketRetentionPolicy( * * * 
                                            -     * Gets the IAM policy for a specified bucket.
+     * Gets the IAM policy for a specified bucket or managed folder.
      * The `resource` field in the request should be
      * `projects/_/buckets/{bucket}` for a bucket, or
      * `projects/_/buckets/{bucket}/managedFolders/{managedFolder}`
      * for a managed folder.
+     * **IAM Permissions**:
+     * Requires `storage.buckets.getIamPolicy` on the bucket or
+     * `storage.managedFolders.getIamPolicy` IAM permission on the
+     * managed folder.
      *
                                            */ public com.google.iam.v1.Policy getIamPolicy(com.google.iam.v1.GetIamPolicyRequest request) { @@ -2847,7 +3236,7 @@ public com.google.iam.v1.Policy getIamPolicy(com.google.iam.v1.GetIamPolicyReque * * * 
                                            -     * Updates an IAM policy for the specified bucket.
+     * Updates an IAM policy for the specified bucket or managed folder.
      * The `resource` field in the request should be
      * `projects/_/buckets/{bucket}` for a bucket, or
      * `projects/_/buckets/{bucket}/managedFolders/{managedFolder}`
@@ -2864,9 +3253,8 @@ public com.google.iam.v1.Policy setIamPolicy(com.google.iam.v1.SetIamPolicyReque
      *
      * 
                                                  * Tests a set of permissions on the given bucket, object, or managed folder
-     * to see which, if any, are held by the caller.
-     * The `resource` field in the request should be
-     * `projects/_/buckets/{bucket}` for a bucket,
+     * to see which, if any, are held by the caller. The `resource` field in the
+     * request should be `projects/_/buckets/{bucket}` for a bucket,
      * `projects/_/buckets/{bucket}/objects/{object}` for an object, or
      * `projects/_/buckets/{bucket}/managedFolders/{managedFolder}`
      * for a managed folder.
@@ -2882,7 +3270,16 @@ public com.google.iam.v1.TestIamPermissionsResponse testIamPermissions(
      *
      *
      * 
                                            -     * Updates a bucket. Equivalent to JSON API's storage.buckets.patch method.
+     * Updates a bucket. Changes to the bucket are readable immediately after
+     * writing, but configuration changes might take time to propagate. This
+     * method supports `patch` semantics.
+     * **IAM Permissions**:
+     * Requires `storage.buckets.update` IAM permission on the bucket.
+     * Additionally, to enable specific bucket features, the authenticated user
+     * must have the following permissions:
+     * - To set bucket IP filtering rules: `storage.buckets.setIpFilter`
+     * - To update public access prevention policies or access control lists
+     * (ACLs): `storage.buckets.setIamPolicy`
      * 
                                            
      */
     public com.google.storage.v2.Bucket updateBucket(
@@ -2896,7 +3293,14 @@ public com.google.storage.v2.Bucket updateBucket(
      *
      * 
                                                  * Concatenates a list of existing objects into a new object in the same
-     * bucket.
+     * bucket. The existing source objects are unaffected by this operation.
+     * **IAM Permissions**:
+     * Requires the `storage.objects.create` and `storage.objects.get` IAM
+     * permissions to use this method. If the new composite object
+     * overwrites an existing object, the authenticated user must also have
+     * the `storage.objects.delete` permission. If the request body includes
+     * the retention property, the authenticated user must also have the
+     * `storage.objects.setRetention` IAM permission.
      * 
                                            
      */
     public com.google.storage.v2.Object composeObject(
@@ -2911,7 +3315,7 @@ public com.google.storage.v2.Object composeObject(
      * 
                                                  * Deletes an object and its metadata. Deletions are permanent if versioning
      * is not enabled for the bucket, or if the generation parameter is used, or
-     * if [soft delete](https://cloud.google.com/storage/docs/soft-delete) is not
+     * if soft delete is not
      * enabled for the bucket.
      * When this API is used to delete an object from a bucket that has soft
      * delete policy enabled, the object becomes soft deleted, and the
@@ -2923,9 +3327,7 @@ public com.google.storage.v2.Object composeObject(
      * API to restore soft-deleted objects until the soft delete retention period
      * has passed.
      * **IAM Permissions**:
-     * Requires `storage.objects.delete`
-     * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
-     * the bucket.
+     * Requires `storage.objects.delete` IAM permission on the bucket.
      * 
                                            
      */
     public com.google.protobuf.Empty deleteObject(
@@ -2938,7 +3340,38 @@ public com.google.protobuf.Empty deleteObject(
      *
      *
      * 
                                            -     * Restores a soft-deleted object.
+     * Restores a
+     * soft-deleted object.
+     * When a soft-deleted object is restored, a new copy of that object is
+     * created in the same bucket and inherits the same metadata as the
+     * soft-deleted object. The inherited metadata is the metadata that existed
+     * when the original object became soft deleted, with the following
+     * exceptions:
+     *   - The `createTime` of the new object is set to the time at which the
+     *   soft-deleted object was restored.
+     *   - The `softDeleteTime` and `hardDeleteTime` values are cleared.
+     *   - A new generation is assigned and the metageneration is reset to 1.
+     *   - If the soft-deleted object was in a bucket that had Autoclass enabled,
+     *   the new object is
+     *     restored to Standard storage.
+     *   - The restored object inherits the bucket's default object ACL, unless
+     *   `copySourceAcl` is `true`.
+     * If a live object using the same name already exists in the bucket and
+     * becomes overwritten, the live object becomes a noncurrent object if Object
+     * Versioning is enabled on the bucket. If Object Versioning is not enabled,
+     * the live object becomes soft deleted.
+     * **IAM Permissions**:
+     * Requires the following IAM permissions to use this method:
+     *   - `storage.objects.restore`
+     *   - `storage.objects.create`
+     *   - `storage.objects.delete` (only required if overwriting an existing
+     *   object)
+     *   - `storage.objects.getIamPolicy` (only required if `projection` is `full`
+     *   and the relevant bucket
+     *     has uniform bucket-level access disabled)
+     *   - `storage.objects.setIamPolicy` (only required if `copySourceAcl` is
+     *   `true` and the relevant
+     *     bucket has uniform bucket-level access disabled)
      * 
                                            
      */
     public com.google.storage.v2.Object restoreObject(
@@ -2953,8 +3386,8 @@ public com.google.storage.v2.Object restoreObject(
      * 
                                                  * Cancels an in-progress resumable upload.
      * Any attempts to write to the resumable upload after cancelling the upload
-     * will fail.
-     * The behavior for currently in progress write operations is not guaranteed -
+     * fail.
+     * The behavior for any in-progress write operations is not guaranteed;
      * they could either complete before the cancellation or fail if the
      * cancellation completes first.
      * 
                                            
@@ -2971,9 +3404,8 @@ public com.google.storage.v2.CancelResumableWriteResponse cancelResumableWrite(
      * 
                                                  * Retrieves object metadata.
      * **IAM Permissions**:
-     * Requires `storage.objects.get`
-     * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
-     * the bucket. To return object ACLs, the authenticated user must also have
+     * Requires `storage.objects.get` IAM permission on the bucket.
+     * To return object ACLs, the authenticated user must also have
      * the `storage.objects.getIamPolicy` permission.
      * 
                                            
      */
@@ -2988,9 +3420,7 @@ public com.google.storage.v2.Object getObject(com.google.storage.v2.GetObjectReq
      * 
                                                  * Retrieves object data.
      * **IAM Permissions**:
-     * Requires `storage.objects.get`
-     * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
-     * the bucket.
+     * Requires `storage.objects.get` IAM permission on the bucket.
      * 
                                            
      */
     public java.util.Iterator readObject(
@@ -3004,7 +3434,9 @@ public java.util.Iterator readObject(
      *
      * 
                                                  * Updates an object's metadata.
-     * Equivalent to JSON API's storage.objects.patch.
+     * Equivalent to JSON API's `storage.objects.patch` method.
+     * **IAM Permissions**:
+     * Requires `storage.objects.update` IAM permission on the bucket.
      * 
                                            
      */
     public com.google.storage.v2.Object updateObject(
@@ -3020,8 +3452,8 @@ public com.google.storage.v2.Object updateObject(
      * Retrieves a list of objects matching the criteria.
      * **IAM Permissions**:
      * The authenticated user requires `storage.objects.list`
-     * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions)
-     * to use this method. To return object ACLs, the authenticated user must also
+     * IAM permission to use this method. To return object ACLs, the
+     * authenticated user must also
      * have the `storage.objects.getIamPolicy` permission.
      * 
                                            
      */
@@ -3050,16 +3482,14 @@ public com.google.storage.v2.RewriteResponse rewriteObject(
      *
      * 
                                                  * Starts a resumable write operation. This
-     * method is part of the [Resumable
-     * upload](https://cloud.google.com/storage/docs/resumable-uploads) feature.
+     * method is part of the Resumable
+     * upload feature.
      * This allows you to upload large objects in multiple chunks, which is more
      * resilient to network interruptions than a single upload. The validity
      * duration of the write operation, and the consequences of it becoming
      * invalid, are service-dependent.
      * **IAM Permissions**:
-     * Requires `storage.objects.create`
-     * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
-     * the bucket.
+     * Requires `storage.objects.create` IAM permission on the bucket.
      * 
                                            
      */
     public com.google.storage.v2.StartResumableWriteResponse startResumableWrite(
@@ -3073,8 +3503,8 @@ public com.google.storage.v2.StartResumableWriteResponse startResumableWrite(
      *
      * 
                                                  * Determines the `persisted_size` of an object that is being written. This
-     * method is part of the [resumable
-     * upload](https://cloud.google.com/storage/docs/resumable-uploads) feature.
+     * method is part of the resumable
+     * upload feature.
      * The returned value is the size of the object that has been persisted so
      * far. The value can be used as the `write_offset` for the next `Write()`
      * call.
@@ -3100,6 +3530,16 @@ public com.google.storage.v2.QueryWriteStatusResponse queryWriteStatus(
      *
      * 
                                                  * Moves the source object to the destination object in the same bucket.
+     * This operation moves a source object to a destination object in the
+     * same bucket by renaming the object. The move itself is an atomic
+     * transaction, ensuring all steps either complete successfully or no
+     * changes are made.
+     * **IAM Permissions**:
+     * Requires the following IAM permissions to use this method:
+     *   - `storage.objects.move`
+     *   - `storage.objects.create`
+     *   - `storage.objects.delete` (only required if overwriting an existing
+     *   object)
      * 
                                            
      */
     public com.google.storage.v2.Object moveObject(
@@ -3116,21 +3556,24 @@ public com.google.storage.v2.Object moveObject(
    * ## API Overview and Naming Syntax
    * The Cloud Storage gRPC API allows applications to read and write data through
    * the abstractions of buckets and objects. For a description of these
-   * abstractions please see https://cloud.google.com/storage/docs.
+   * abstractions please see [Cloud Storage
+   * documentation](https://cloud.google.com/storage/docs).
    * Resources are named as follows:
    *   - Projects are referred to as they are defined by the Resource Manager API,
    *     using strings like `projects/123456` or `projects/my-string-id`.
    *   - Buckets are named using string names of the form:
-   *     `projects/{project}/buckets/{bucket}`
-   *     For globally unique buckets, `_` may be substituted for the project.
+   *     `projects/{project}/buckets/{bucket}`.
+   *     For globally unique buckets, `_` might be substituted for the project.
    *   - Objects are uniquely identified by their name along with the name of the
    *     bucket they belong to, as separate strings in this API. For example:
-   *       ReadObjectRequest {
+   *         ```
+   *         ReadObjectRequest {
    *         bucket: 'projects/_/buckets/my-bucket'
    *         object: 'my-object'
-   *       }
-   *     Note that object names can contain `/` characters, which are treated as
-   *     any other character (no special directory semantics).
+   *         }
+   *         ```
+   * Note that object names can contain `/` characters, which are treated as
+   * any other character (no special directory semantics).
    * 
                                            
    */
   public static final class StorageFutureStub
@@ -3149,6 +3592,25 @@ protected StorageFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
      *
      * 
                                                  * Permanently deletes an empty bucket.
+     * The request fails if there are any live or
+     * noncurrent objects in the bucket, but the request succeeds if the
+     * bucket only contains soft-deleted objects or incomplete uploads, such
+     * as ongoing XML API multipart uploads. Does not permanently delete
+     * soft-deleted objects.
+     * When this API is used to delete a bucket containing an object that has a
+     * soft delete policy
+     * enabled, the object becomes soft deleted, and the
+     * `softDeleteTime` and `hardDeleteTime` properties are set on the
+     * object.
+     * Objects and multipart uploads that were in the bucket at the time of
+     * deletion are also retained for the specified retention duration. When
+     * a soft-deleted bucket reaches the end of its retention duration, it
+     * is permanently deleted. The `hardDeleteTime` of the bucket always
+     * equals
+     * or exceeds the expiration time of the last soft-deleted object in the
+     * bucket.
+     * **IAM Permissions**:
+     * Requires `storage.buckets.delete` IAM permission on the bucket.
      * 
                                            
      */
     public com.google.common.util.concurrent.ListenableFuture
@@ -3162,6 +3624,13 @@ protected StorageFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
      *
      * 
                                                  * Returns metadata for the specified bucket.
+     * **IAM Permissions**:
+     * Requires `storage.buckets.get`
+     * IAM permission on
+     * the bucket. Additionally, to return specific bucket metadata, the
+     * authenticated user must have the following permissions:
+     * - To return the IAM policies: `storage.buckets.getIamPolicy`
+     * - To return the bucket IP filtering rules: `storage.buckets.getIpFilter`
      * 
                                            
      */
     public com.google.common.util.concurrent.ListenableFuture
@@ -3175,6 +3644,13 @@ protected StorageFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
      *
      * 
                                                  * Creates a new bucket.
+     * **IAM Permissions**:
+     * Requires `storage.buckets.create` IAM permission on the bucket.
+     * Additionally, to enable specific bucket features, the authenticated user
+     * must have the following permissions:
+     * - To enable object retention using the `enableObjectRetention` query
+     * parameter: `storage.buckets.enableObjectRetention`
+     * - To set the bucket IP filtering rules: `storage.buckets.setIpFilter`
      * 
                                            
      */
     public com.google.common.util.concurrent.ListenableFuture
@@ -3187,7 +3663,14 @@ protected StorageFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
      *
      *
      * 
                                            -     * Retrieves a list of buckets for a given project.
+     * Retrieves a list of buckets for a given project, ordered
+     * lexicographically by name.
+     * **IAM Permissions**:
+     * Requires `storage.buckets.list` IAM permission on the bucket.
+     * Additionally, to enable specific bucket features, the authenticated
+     * user must have the following permissions:
+     * - To list the IAM policies: `storage.buckets.getIamPolicy`
+     * - To list the bucket IP filtering rules: `storage.buckets.getIpFilter`
      * 
                                            
      */
     public com.google.common.util.concurrent.ListenableFuture<
@@ -3201,7 +3684,20 @@ protected StorageFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
      *
      *
      * 
                                            -     * Locks retention policy on a bucket.
+     * Permanently locks the retention
+     * policy that is
+     * currently applied to the specified bucket.
+     * Caution: Locking a bucket is an
+     * irreversible action. Once you lock a bucket:
+     * - You cannot remove the retention policy from the bucket.
+     * - You cannot decrease the retention period for the policy.
+     * Once locked, you must delete the entire bucket in order to remove the
+     * bucket's retention policy. However, before you can delete the bucket, you
+     * must delete all the objects in the bucket, which is only
+     * possible if all the objects have reached the retention period set by the
+     * retention policy.
+     * **IAM Permissions**:
+     * Requires `storage.buckets.update` IAM permission on the bucket.
      * 
                                            
      */
     public com.google.common.util.concurrent.ListenableFuture
@@ -3214,11 +3710,15 @@ protected StorageFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
      *
      *
      * 
                                            -     * Gets the IAM policy for a specified bucket.
+     * Gets the IAM policy for a specified bucket or managed folder.
      * The `resource` field in the request should be
      * `projects/_/buckets/{bucket}` for a bucket, or
      * `projects/_/buckets/{bucket}/managedFolders/{managedFolder}`
      * for a managed folder.
+     * **IAM Permissions**:
+     * Requires `storage.buckets.getIamPolicy` on the bucket or
+     * `storage.managedFolders.getIamPolicy` IAM permission on the
+     * managed folder.
      * 
                                            
      */
     public com.google.common.util.concurrent.ListenableFuture
@@ -3231,7 +3731,7 @@ protected StorageFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
      *
      *
      * 
                                            -     * Updates an IAM policy for the specified bucket.
+     * Updates an IAM policy for the specified bucket or managed folder.
      * The `resource` field in the request should be
      * `projects/_/buckets/{bucket}` for a bucket, or
      * `projects/_/buckets/{bucket}/managedFolders/{managedFolder}`
@@ -3249,9 +3749,8 @@ protected StorageFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
      *
      * 
                                                  * Tests a set of permissions on the given bucket, object, or managed folder
-     * to see which, if any, are held by the caller.
-     * The `resource` field in the request should be
-     * `projects/_/buckets/{bucket}` for a bucket,
+     * to see which, if any, are held by the caller. The `resource` field in the
+     * request should be `projects/_/buckets/{bucket}` for a bucket,
      * `projects/_/buckets/{bucket}/objects/{object}` for an object, or
      * `projects/_/buckets/{bucket}/managedFolders/{managedFolder}`
      * for a managed folder.
@@ -3268,7 +3767,16 @@ protected StorageFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
      *
      *
      * 
                                            -     * Updates a bucket. Equivalent to JSON API's storage.buckets.patch method.
+     * Updates a bucket. Changes to the bucket are readable immediately after
+     * writing, but configuration changes might take time to propagate. This
+     * method supports `patch` semantics.
+     * **IAM Permissions**:
+     * Requires `storage.buckets.update` IAM permission on the bucket.
+     * Additionally, to enable specific bucket features, the authenticated user
+     * must have the following permissions:
+     * - To set bucket IP filtering rules: `storage.buckets.setIpFilter`
+     * - To update public access prevention policies or access control lists
+     * (ACLs): `storage.buckets.setIamPolicy`
      * 
                                            
      */
     public com.google.common.util.concurrent.ListenableFuture
@@ -3282,7 +3790,14 @@ protected StorageFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
      *
      * 
                                                  * Concatenates a list of existing objects into a new object in the same
-     * bucket.
+     * bucket. The existing source objects are unaffected by this operation.
+     * **IAM Permissions**:
+     * Requires the `storage.objects.create` and `storage.objects.get` IAM
+     * permissions to use this method. If the new composite object
+     * overwrites an existing object, the authenticated user must also have
+     * the `storage.objects.delete` permission. If the request body includes
+     * the retention property, the authenticated user must also have the
+     * `storage.objects.setRetention` IAM permission.
      * 
                                            
      */
     public com.google.common.util.concurrent.ListenableFuture
@@ -3297,7 +3812,7 @@ protected StorageFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
      * 
                                                  * Deletes an object and its metadata. Deletions are permanent if versioning
      * is not enabled for the bucket, or if the generation parameter is used, or
-     * if [soft delete](https://cloud.google.com/storage/docs/soft-delete) is not
+     * if soft delete is not
      * enabled for the bucket.
      * When this API is used to delete an object from a bucket that has soft
      * delete policy enabled, the object becomes soft deleted, and the
@@ -3309,9 +3824,7 @@ protected StorageFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
      * API to restore soft-deleted objects until the soft delete retention period
      * has passed.
      * **IAM Permissions**:
-     * Requires `storage.objects.delete`
-     * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
-     * the bucket.
+     * Requires `storage.objects.delete` IAM permission on the bucket.
      * 
                                            
      */
     public com.google.common.util.concurrent.ListenableFuture
@@ -3324,7 +3837,38 @@ protected StorageFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
      *
      *
      * 
                                            -     * Restores a soft-deleted object.
+     * Restores a
+     * soft-deleted object.
+     * When a soft-deleted object is restored, a new copy of that object is
+     * created in the same bucket and inherits the same metadata as the
+     * soft-deleted object. The inherited metadata is the metadata that existed
+     * when the original object became soft deleted, with the following
+     * exceptions:
+     *   - The `createTime` of the new object is set to the time at which the
+     *   soft-deleted object was restored.
+     *   - The `softDeleteTime` and `hardDeleteTime` values are cleared.
+     *   - A new generation is assigned and the metageneration is reset to 1.
+     *   - If the soft-deleted object was in a bucket that had Autoclass enabled,
+     *   the new object is
+     *     restored to Standard storage.
+     *   - The restored object inherits the bucket's default object ACL, unless
+     *   `copySourceAcl` is `true`.
+     * If a live object using the same name already exists in the bucket and
+     * becomes overwritten, the live object becomes a noncurrent object if Object
+     * Versioning is enabled on the bucket. If Object Versioning is not enabled,
+     * the live object becomes soft deleted.
+     * **IAM Permissions**:
+     * Requires the following IAM permissions to use this method:
+     *   - `storage.objects.restore`
+     *   - `storage.objects.create`
+     *   - `storage.objects.delete` (only required if overwriting an existing
+     *   object)
+     *   - `storage.objects.getIamPolicy` (only required if `projection` is `full`
+     *   and the relevant bucket
+     *     has uniform bucket-level access disabled)
+     *   - `storage.objects.setIamPolicy` (only required if `copySourceAcl` is
+     *   `true` and the relevant
+     *     bucket has uniform bucket-level access disabled)
      * 
                                            
      */
     public com.google.common.util.concurrent.ListenableFuture
@@ -3339,8 +3883,8 @@ protected StorageFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
      * 
                                                  * Cancels an in-progress resumable upload.
      * Any attempts to write to the resumable upload after cancelling the upload
-     * will fail.
-     * The behavior for currently in progress write operations is not guaranteed -
+     * fail.
+     * The behavior for any in-progress write operations is not guaranteed;
      * they could either complete before the cancellation or fail if the
      * cancellation completes first.
      * 
                                            
@@ -3358,9 +3902,8 @@ protected StorageFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
      * 
                                                  * Retrieves object metadata.
      * **IAM Permissions**:
-     * Requires `storage.objects.get`
-     * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
-     * the bucket. To return object ACLs, the authenticated user must also have
+     * Requires `storage.objects.get` IAM permission on the bucket.
+     * To return object ACLs, the authenticated user must also have
      * the `storage.objects.getIamPolicy` permission.
      * 
                                            
      */
@@ -3375,7 +3918,9 @@ protected StorageFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
      *
      * 
                                                  * Updates an object's metadata.
-     * Equivalent to JSON API's storage.objects.patch.
+     * Equivalent to JSON API's `storage.objects.patch` method.
+     * **IAM Permissions**:
+     * Requires `storage.objects.update` IAM permission on the bucket.
      * 
                                            
      */
     public com.google.common.util.concurrent.ListenableFuture
@@ -3391,8 +3936,8 @@ protected StorageFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
      * Retrieves a list of objects matching the criteria.
      * **IAM Permissions**:
      * The authenticated user requires `storage.objects.list`
-     * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions)
-     * to use this method. To return object ACLs, the authenticated user must also
+     * IAM permission to use this method. To return object ACLs, the
+     * authenticated user must also
      * have the `storage.objects.getIamPolicy` permission.
      * 
                                            
      */
@@ -3422,16 +3967,14 @@ protected StorageFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
      *
      * 
                                                  * Starts a resumable write operation. This
-     * method is part of the [Resumable
-     * upload](https://cloud.google.com/storage/docs/resumable-uploads) feature.
+     * method is part of the Resumable
+     * upload feature.
      * This allows you to upload large objects in multiple chunks, which is more
      * resilient to network interruptions than a single upload. The validity
      * duration of the write operation, and the consequences of it becoming
      * invalid, are service-dependent.
      * **IAM Permissions**:
-     * Requires `storage.objects.create`
-     * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
-     * the bucket.
+     * Requires `storage.objects.create` IAM permission on the bucket.
      * 
                                            
      */
     public com.google.common.util.concurrent.ListenableFuture<
@@ -3446,8 +3989,8 @@ protected StorageFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
      *
      * 
                                                  * Determines the `persisted_size` of an object that is being written. This
-     * method is part of the [resumable
-     * upload](https://cloud.google.com/storage/docs/resumable-uploads) feature.
+     * method is part of the resumable
+     * upload feature.
      * The returned value is the size of the object that has been persisted so
      * far. The value can be used as the `write_offset` for the next `Write()`
      * call.
@@ -3474,6 +4017,16 @@ protected StorageFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
      *
      * 
                                                  * Moves the source object to the destination object in the same bucket.
+     * This operation moves a source object to a destination object in the
+     * same bucket by renaming the object. The move itself is an atomic
+     * transaction, ensuring all steps either complete successfully or no
+     * changes are made.
+     * **IAM Permissions**:
+     * Requires the following IAM permissions to use this method:
+     *   - `storage.objects.move`
+     *   - `storage.objects.create`
+     *   - `storage.objects.delete` (only required if overwriting an existing
+     *   object)
      * 
                                            
      */
     public com.google.common.util.concurrent.ListenableFuture
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/AppendObjectSpec.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/AppendObjectSpec.java
index f06e350657..7cedc36da2 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/AppendObjectSpec.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/AppendObjectSpec.java
@@ -292,7 +292,7 @@ public long getIfMetagenerationNotMatch() {
    *
    * 
                                                * An optional routing token that influences request routing for the stream.
-   * Must be provided if a BidiWriteObjectRedirectedError is returned.
+   * Must be provided if a `BidiWriteObjectRedirectedError` is returned.
    * 
                                            
    *
    * optional string routing_token = 6;
@@ -309,7 +309,7 @@ public boolean hasRoutingToken() {
    *
    * 
                                                * An optional routing token that influences request routing for the stream.
-   * Must be provided if a BidiWriteObjectRedirectedError is returned.
+   * Must be provided if a `BidiWriteObjectRedirectedError` is returned.
    * 
                                            
    *
    * optional string routing_token = 6;
@@ -334,7 +334,7 @@ public java.lang.String getRoutingToken() {
    *
    * 
                                                * An optional routing token that influences request routing for the stream.
-   * Must be provided if a BidiWriteObjectRedirectedError is returned.
+   * Must be provided if a `BidiWriteObjectRedirectedError` is returned.
    * 
                                            
    *
    * optional string routing_token = 6;
@@ -1407,7 +1407,7 @@ public Builder clearIfMetagenerationNotMatch() {
      *
      * 
                                                  * An optional routing token that influences request routing for the stream.
-     * Must be provided if a BidiWriteObjectRedirectedError is returned.
+     * Must be provided if a `BidiWriteObjectRedirectedError` is returned.
      * 
                                            
      *
      * optional string routing_token = 6;
@@ -1423,7 +1423,7 @@ public boolean hasRoutingToken() {
      *
      * 
                                                  * An optional routing token that influences request routing for the stream.
-     * Must be provided if a BidiWriteObjectRedirectedError is returned.
+     * Must be provided if a `BidiWriteObjectRedirectedError` is returned.
      * 
                                            
      *
      * optional string routing_token = 6;
@@ -1447,7 +1447,7 @@ public java.lang.String getRoutingToken() {
      *
      * 
                                                  * An optional routing token that influences request routing for the stream.
-     * Must be provided if a BidiWriteObjectRedirectedError is returned.
+     * Must be provided if a `BidiWriteObjectRedirectedError` is returned.
      * 
                                            
      *
      * optional string routing_token = 6;
@@ -1471,7 +1471,7 @@ public com.google.protobuf.ByteString getRoutingTokenBytes() {
      *
      * 
                                                  * An optional routing token that influences request routing for the stream.
-     * Must be provided if a BidiWriteObjectRedirectedError is returned.
+     * Must be provided if a `BidiWriteObjectRedirectedError` is returned.
      * 
                                            
      *
      * optional string routing_token = 6;
@@ -1494,7 +1494,7 @@ public Builder setRoutingToken(java.lang.String value) {
      *
      * 
                                                  * An optional routing token that influences request routing for the stream.
-     * Must be provided if a BidiWriteObjectRedirectedError is returned.
+     * Must be provided if a `BidiWriteObjectRedirectedError` is returned.
      * 
                                            
      *
      * optional string routing_token = 6;
@@ -1513,7 +1513,7 @@ public Builder clearRoutingToken() {
      *
      * 
                                                  * An optional routing token that influences request routing for the stream.
-     * Must be provided if a BidiWriteObjectRedirectedError is returned.
+     * Must be provided if a `BidiWriteObjectRedirectedError` is returned.
      * 
                                            
      *
      * optional string routing_token = 6;
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/AppendObjectSpecOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/AppendObjectSpecOrBuilder.java
index 1f3642ae3d..489924de7e 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/AppendObjectSpecOrBuilder.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/AppendObjectSpecOrBuilder.java
@@ -166,7 +166,7 @@ public interface AppendObjectSpecOrBuilder
    *
    * 
                                                * An optional routing token that influences request routing for the stream.
-   * Must be provided if a BidiWriteObjectRedirectedError is returned.
+   * Must be provided if a `BidiWriteObjectRedirectedError` is returned.
    * 
                                            
    *
    * optional string routing_token = 6;
@@ -180,7 +180,7 @@ public interface AppendObjectSpecOrBuilder
    *
    * 
                                                * An optional routing token that influences request routing for the stream.
-   * Must be provided if a BidiWriteObjectRedirectedError is returned.
+   * Must be provided if a `BidiWriteObjectRedirectedError` is returned.
    * 
                                            
    *
    * optional string routing_token = 6;
@@ -194,7 +194,7 @@ public interface AppendObjectSpecOrBuilder
    *
    * 
                                                * An optional routing token that influences request routing for the stream.
-   * Must be provided if a BidiWriteObjectRedirectedError is returned.
+   * Must be provided if a `BidiWriteObjectRedirectedError` is returned.
    * 
                                            
    *
    * optional string routing_token = 6;
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadHandle.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadHandle.java
index 3bf53ad542..90c60b537d 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadHandle.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadHandle.java
@@ -23,8 +23,8 @@
  *
  *
  * 
                                            - * BidiReadHandle contains a handle from a previous BiDiReadObject
- * invocation. The client can use this instead of BidiReadObjectSpec as an
+ * `BidiReadHandle` contains a handle from a previous `BiDiReadObject`
+ * invocation. The client can use this instead of `BidiReadObjectSpec` as an
  * optimized way of opening subsequent bidirectional streams to the same object.
  * 
                                            
  *
@@ -247,8 +247,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
                                            -   * BidiReadHandle contains a handle from a previous BiDiReadObject
-   * invocation. The client can use this instead of BidiReadObjectSpec as an
+   * `BidiReadHandle` contains a handle from a previous `BiDiReadObject`
+   * invocation. The client can use this instead of `BidiReadObjectSpec` as an
    * optimized way of opening subsequent bidirectional streams to the same object.
    * 
                                            
    *
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectRedirectedError.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectRedirectedError.java
index 97f2b0ca51..423c663e52 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectRedirectedError.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectRedirectedError.java
@@ -23,7 +23,7 @@
  *
  *
  * 
                                            - * Error proto containing details for a redirected read. This error may be
+ * Error proto containing details for a redirected read. This error might be
  * attached as details for an ABORTED response to BidiReadObject.
  * 
                                            
  *
@@ -73,8 +73,8 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * 
                                            -   * The read handle for the redirected read. If set, the client may use this in
-   * the BidiReadObjectSpec when retrying the read stream.
+   * The read handle for the redirected read. If set, the client might use this
+   * in the BidiReadObjectSpec when retrying the read stream.
    * 
                                            
    *
    * .google.storage.v2.BidiReadHandle read_handle = 1;
@@ -90,8 +90,8 @@ public boolean hasReadHandle() {
    *
    *
    * 
                                            -   * The read handle for the redirected read. If set, the client may use this in
-   * the BidiReadObjectSpec when retrying the read stream.
+   * The read handle for the redirected read. If set, the client might use this
+   * in the BidiReadObjectSpec when retrying the read stream.
    * 
                                            
    *
    * .google.storage.v2.BidiReadHandle read_handle = 1;
@@ -109,8 +109,8 @@ public com.google.storage.v2.BidiReadHandle getReadHandle() {
    *
    *
    * 
                                            -   * The read handle for the redirected read. If set, the client may use this in
-   * the BidiReadObjectSpec when retrying the read stream.
+   * The read handle for the redirected read. If set, the client might use this
+   * in the BidiReadObjectSpec when retrying the read stream.
    * 
                                            
    *
    * .google.storage.v2.BidiReadHandle read_handle = 1;
@@ -380,7 +380,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
                                            -   * Error proto containing details for a redirected read. This error may be
+   * Error proto containing details for a redirected read. This error might be
    * attached as details for an ABORTED response to BidiReadObject.
    * 
                                            
    *
@@ -601,8 +601,8 @@ public Builder mergeFrom(
      *
      *
      * 
                                            -     * The read handle for the redirected read. If set, the client may use this in
-     * the BidiReadObjectSpec when retrying the read stream.
+     * The read handle for the redirected read. If set, the client might use this
+     * in the BidiReadObjectSpec when retrying the read stream.
      * 
                                            
      *
      * .google.storage.v2.BidiReadHandle read_handle = 1;
@@ -617,8 +617,8 @@ public boolean hasReadHandle() {
      *
      *
      * 
                                            -     * The read handle for the redirected read. If set, the client may use this in
-     * the BidiReadObjectSpec when retrying the read stream.
+     * The read handle for the redirected read. If set, the client might use this
+     * in the BidiReadObjectSpec when retrying the read stream.
      * 
                                            
      *
      * .google.storage.v2.BidiReadHandle read_handle = 1;
@@ -639,8 +639,8 @@ public com.google.storage.v2.BidiReadHandle getReadHandle() {
      *
      *
      * 
                                            -     * The read handle for the redirected read. If set, the client may use this in
-     * the BidiReadObjectSpec when retrying the read stream.
+     * The read handle for the redirected read. If set, the client might use this
+     * in the BidiReadObjectSpec when retrying the read stream.
      * 
                                            
      *
      * .google.storage.v2.BidiReadHandle read_handle = 1;
@@ -663,8 +663,8 @@ public Builder setReadHandle(com.google.storage.v2.BidiReadHandle value) {
      *
      *
      * 
                                            -     * The read handle for the redirected read. If set, the client may use this in
-     * the BidiReadObjectSpec when retrying the read stream.
+     * The read handle for the redirected read. If set, the client might use this
+     * in the BidiReadObjectSpec when retrying the read stream.
      * 
                                            
      *
      * .google.storage.v2.BidiReadHandle read_handle = 1;
@@ -684,8 +684,8 @@ public Builder setReadHandle(com.google.storage.v2.BidiReadHandle.Builder builde
      *
      *
      * 
                                            -     * The read handle for the redirected read. If set, the client may use this in
-     * the BidiReadObjectSpec when retrying the read stream.
+     * The read handle for the redirected read. If set, the client might use this
+     * in the BidiReadObjectSpec when retrying the read stream.
      * 
                                            
      *
      * .google.storage.v2.BidiReadHandle read_handle = 1;
@@ -713,8 +713,8 @@ public Builder mergeReadHandle(com.google.storage.v2.BidiReadHandle value) {
      *
      *
      * 
                                            -     * The read handle for the redirected read. If set, the client may use this in
-     * the BidiReadObjectSpec when retrying the read stream.
+     * The read handle for the redirected read. If set, the client might use this
+     * in the BidiReadObjectSpec when retrying the read stream.
      * 
                                            
      *
      * .google.storage.v2.BidiReadHandle read_handle = 1;
@@ -734,8 +734,8 @@ public Builder clearReadHandle() {
      *
      *
      * 
                                            -     * The read handle for the redirected read. If set, the client may use this in
-     * the BidiReadObjectSpec when retrying the read stream.
+     * The read handle for the redirected read. If set, the client might use this
+     * in the BidiReadObjectSpec when retrying the read stream.
      * 
                                            
      *
      * .google.storage.v2.BidiReadHandle read_handle = 1;
@@ -750,8 +750,8 @@ public com.google.storage.v2.BidiReadHandle.Builder getReadHandleBuilder() {
      *
      *
      * 
                                            -     * The read handle for the redirected read. If set, the client may use this in
-     * the BidiReadObjectSpec when retrying the read stream.
+     * The read handle for the redirected read. If set, the client might use this
+     * in the BidiReadObjectSpec when retrying the read stream.
      * 
                                            
      *
      * .google.storage.v2.BidiReadHandle read_handle = 1;
@@ -770,8 +770,8 @@ public com.google.storage.v2.BidiReadHandleOrBuilder getReadHandleOrBuilder() {
      *
      *
      * 
                                            -     * The read handle for the redirected read. If set, the client may use this in
-     * the BidiReadObjectSpec when retrying the read stream.
+     * The read handle for the redirected read. If set, the client might use this
+     * in the BidiReadObjectSpec when retrying the read stream.
      * 
                                            
      *
      * .google.storage.v2.BidiReadHandle read_handle = 1;
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectRedirectedErrorOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectRedirectedErrorOrBuilder.java
index fe5c964b95..473c6030a4 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectRedirectedErrorOrBuilder.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectRedirectedErrorOrBuilder.java
@@ -28,8 +28,8 @@ public interface BidiReadObjectRedirectedErrorOrBuilder
    *
    *
    * 
                                            -   * The read handle for the redirected read. If set, the client may use this in
-   * the BidiReadObjectSpec when retrying the read stream.
+   * The read handle for the redirected read. If set, the client might use this
+   * in the BidiReadObjectSpec when retrying the read stream.
    * 
                                            
    *
    * .google.storage.v2.BidiReadHandle read_handle = 1;
@@ -42,8 +42,8 @@ public interface BidiReadObjectRedirectedErrorOrBuilder
    *
    *
    * 
                                            -   * The read handle for the redirected read. If set, the client may use this in
-   * the BidiReadObjectSpec when retrying the read stream.
+   * The read handle for the redirected read. If set, the client might use this
+   * in the BidiReadObjectSpec when retrying the read stream.
    * 
                                            
    *
    * .google.storage.v2.BidiReadHandle read_handle = 1;
@@ -56,8 +56,8 @@ public interface BidiReadObjectRedirectedErrorOrBuilder
    *
    *
    * 
                                            -   * The read handle for the redirected read. If set, the client may use this in
-   * the BidiReadObjectSpec when retrying the read stream.
+   * The read handle for the redirected read. If set, the client might use this
+   * in the BidiReadObjectSpec when retrying the read stream.
    * 
                                            
    *
    * .google.storage.v2.BidiReadHandle read_handle = 1;
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectRequest.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectRequest.java
index faf2cf9966..12da44f004 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectRequest.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectRequest.java
@@ -23,7 +23,8 @@
  *
  *
  * 
                                            - * Request message for BidiReadObject.
+ * Request message for
+ * [BidiReadObject][google.storage.v2.Storage.BidiReadObject].
  * 
                                            
  *
  * Protobuf type {@code google.storage.v2.BidiReadObjectRequest}
@@ -73,8 +74,8 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    * 
                                                * Optional. The first message of each stream should set this field. If this
-   * is not the first message, an error will be returned. Describes the object
-   * to read.
+   * is not the first message, an error is returned. Describes the object to
+   * read.
    * 
                                            
    *
    * 
@@ -93,8 +94,8 @@ public boolean hasReadObjectSpec() {
    *
    * 
                                                * Optional. The first message of each stream should set this field. If this
-   * is not the first message, an error will be returned. Describes the object
-   * to read.
+   * is not the first message, an error is returned. Describes the object to
+   * read.
    * 
                                            
    *
    * 
@@ -115,8 +116,8 @@ public com.google.storage.v2.BidiReadObjectSpec getReadObjectSpec() {
    *
    * 
                                                * Optional. The first message of each stream should set this field. If this
-   * is not the first message, an error will be returned. Describes the object
-   * to read.
+   * is not the first message, an error is returned. Describes the object to
+   * read.
    * 
                                            
    *
    * 
@@ -141,10 +142,10 @@ public com.google.storage.v2.BidiReadObjectSpecOrBuilder getReadObjectSpecOrBuil
    * 
                                                * Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
    * single range is large enough to require multiple responses, they are
-   * guaranteed to be delivered in increasing offset order. There are no
-   * ordering guarantees across ranges. When no ranges are provided, the
-   * response message will not include ObjectRangeData. For full object
-   * downloads, the offset and size can be set to 0.
+   * delivered in increasing offset order. There are no ordering guarantees
+   * across ranges. When no ranges are provided, the response message
+   * doesn't  include `ObjectRangeData`. For full object downloads, the
+   * offset and size can be set to `0`.
    * 
                                            
    *
    * 
@@ -162,10 +163,10 @@ public java.util.List getReadRangesList() {
    * 
                                                * Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
    * single range is large enough to require multiple responses, they are
-   * guaranteed to be delivered in increasing offset order. There are no
-   * ordering guarantees across ranges. When no ranges are provided, the
-   * response message will not include ObjectRangeData. For full object
-   * downloads, the offset and size can be set to 0.
+   * delivered in increasing offset order. There are no ordering guarantees
+   * across ranges. When no ranges are provided, the response message
+   * doesn't  include `ObjectRangeData`. For full object downloads, the
+   * offset and size can be set to `0`.
    * 
                                            
    *
    * 
@@ -184,10 +185,10 @@ public java.util.List getReadRangesList() {
    * 
                                                * Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
    * single range is large enough to require multiple responses, they are
-   * guaranteed to be delivered in increasing offset order. There are no
-   * ordering guarantees across ranges. When no ranges are provided, the
-   * response message will not include ObjectRangeData. For full object
-   * downloads, the offset and size can be set to 0.
+   * delivered in increasing offset order. There are no ordering guarantees
+   * across ranges. When no ranges are provided, the response message
+   * doesn't  include `ObjectRangeData`. For full object downloads, the
+   * offset and size can be set to `0`.
    * 
                                            
    *
    * 
@@ -205,10 +206,10 @@ public int getReadRangesCount() {
    * 
                                                * Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
    * single range is large enough to require multiple responses, they are
-   * guaranteed to be delivered in increasing offset order. There are no
-   * ordering guarantees across ranges. When no ranges are provided, the
-   * response message will not include ObjectRangeData. For full object
-   * downloads, the offset and size can be set to 0.
+   * delivered in increasing offset order. There are no ordering guarantees
+   * across ranges. When no ranges are provided, the response message
+   * doesn't  include `ObjectRangeData`. For full object downloads, the
+   * offset and size can be set to `0`.
    * 
                                            
    *
    * 
@@ -226,10 +227,10 @@ public com.google.storage.v2.ReadRange getReadRanges(int index) {
    * 
                                                * Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
    * single range is large enough to require multiple responses, they are
-   * guaranteed to be delivered in increasing offset order. There are no
-   * ordering guarantees across ranges. When no ranges are provided, the
-   * response message will not include ObjectRangeData. For full object
-   * downloads, the offset and size can be set to 0.
+   * delivered in increasing offset order. There are no ordering guarantees
+   * across ranges. When no ranges are provided, the response message
+   * doesn't  include `ObjectRangeData`. For full object downloads, the
+   * offset and size can be set to `0`.
    * 
                                            
    *
    * 
@@ -421,7 +422,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
                                            -   * Request message for BidiReadObject.
+   * Request message for
+   * [BidiReadObject][google.storage.v2.Storage.BidiReadObject].
    * 
                                            
    *
    * Protobuf type {@code google.storage.v2.BidiReadObjectRequest}
@@ -686,8 +688,8 @@ public Builder mergeFrom(
      *
      * 
                                                  * Optional. The first message of each stream should set this field. If this
-     * is not the first message, an error will be returned. Describes the object
-     * to read.
+     * is not the first message, an error is returned. Describes the object to
+     * read.
      * 
                                            
      *
      * 
@@ -705,8 +707,8 @@ public boolean hasReadObjectSpec() {
      *
      * 
                                                  * Optional. The first message of each stream should set this field. If this
-     * is not the first message, an error will be returned. Describes the object
-     * to read.
+     * is not the first message, an error is returned. Describes the object to
+     * read.
      * 
                                            
      *
      * 
@@ -730,8 +732,8 @@ public com.google.storage.v2.BidiReadObjectSpec getReadObjectSpec() {
      *
      * 
                                                  * Optional. The first message of each stream should set this field. If this
-     * is not the first message, an error will be returned. Describes the object
-     * to read.
+     * is not the first message, an error is returned. Describes the object to
+     * read.
      * 
                                            
      *
      * 
@@ -757,8 +759,8 @@ public Builder setReadObjectSpec(com.google.storage.v2.BidiReadObjectSpec value)
      *
      * 
                                                  * Optional. The first message of each stream should set this field. If this
-     * is not the first message, an error will be returned. Describes the object
-     * to read.
+     * is not the first message, an error is returned. Describes the object to
+     * read.
      * 
                                            
      *
      * 
@@ -782,8 +784,8 @@ public Builder setReadObjectSpec(
      *
      * 
                                                  * Optional. The first message of each stream should set this field. If this
-     * is not the first message, an error will be returned. Describes the object
-     * to read.
+     * is not the first message, an error is returned. Describes the object to
+     * read.
      * 
                                            
      *
      * 
@@ -814,8 +816,8 @@ public Builder mergeReadObjectSpec(com.google.storage.v2.BidiReadObjectSpec valu
      *
      * 
                                                  * Optional. The first message of each stream should set this field. If this
-     * is not the first message, an error will be returned. Describes the object
-     * to read.
+     * is not the first message, an error is returned. Describes the object to
+     * read.
      * 
                                            
      *
      * 
@@ -838,8 +840,8 @@ public Builder clearReadObjectSpec() {
      *
      * 
                                                  * Optional. The first message of each stream should set this field. If this
-     * is not the first message, an error will be returned. Describes the object
-     * to read.
+     * is not the first message, an error is returned. Describes the object to
+     * read.
      * 
                                            
      *
      * 
@@ -857,8 +859,8 @@ public com.google.storage.v2.BidiReadObjectSpec.Builder getReadObjectSpecBuilder
      *
      * 
                                                  * Optional. The first message of each stream should set this field. If this
-     * is not the first message, an error will be returned. Describes the object
-     * to read.
+     * is not the first message, an error is returned. Describes the object to
+     * read.
      * 
                                            
      *
      * 
@@ -880,8 +882,8 @@ public com.google.storage.v2.BidiReadObjectSpecOrBuilder getReadObjectSpecOrBuil
      *
      * 
                                                  * Optional. The first message of each stream should set this field. If this
-     * is not the first message, an error will be returned. Describes the object
-     * to read.
+     * is not the first message, an error is returned. Describes the object to
+     * read.
      * 
                                            
      *
      * 
@@ -927,10 +929,10 @@ private void ensureReadRangesIsMutable() {
      * 
                                                  * Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
      * single range is large enough to require multiple responses, they are
-     * guaranteed to be delivered in increasing offset order. There are no
-     * ordering guarantees across ranges. When no ranges are provided, the
-     * response message will not include ObjectRangeData. For full object
-     * downloads, the offset and size can be set to 0.
+     * delivered in increasing offset order. There are no ordering guarantees
+     * across ranges. When no ranges are provided, the response message
+     * doesn't  include `ObjectRangeData`. For full object downloads, the
+     * offset and size can be set to `0`.
      * 
                                            
      *
      * 
@@ -951,10 +953,10 @@ public java.util.List getReadRangesList() {
      * 
                                                  * Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
      * single range is large enough to require multiple responses, they are
-     * guaranteed to be delivered in increasing offset order. There are no
-     * ordering guarantees across ranges. When no ranges are provided, the
-     * response message will not include ObjectRangeData. For full object
-     * downloads, the offset and size can be set to 0.
+     * delivered in increasing offset order. There are no ordering guarantees
+     * across ranges. When no ranges are provided, the response message
+     * doesn't  include `ObjectRangeData`. For full object downloads, the
+     * offset and size can be set to `0`.
      * 
                                            
      *
      * 
@@ -975,10 +977,10 @@ public int getReadRangesCount() {
      * 
                                                  * Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
      * single range is large enough to require multiple responses, they are
-     * guaranteed to be delivered in increasing offset order. There are no
-     * ordering guarantees across ranges. When no ranges are provided, the
-     * response message will not include ObjectRangeData. For full object
-     * downloads, the offset and size can be set to 0.
+     * delivered in increasing offset order. There are no ordering guarantees
+     * across ranges. When no ranges are provided, the response message
+     * doesn't  include `ObjectRangeData`. For full object downloads, the
+     * offset and size can be set to `0`.
      * 
                                            
      *
      * 
@@ -999,10 +1001,10 @@ public com.google.storage.v2.ReadRange getReadRanges(int index) {
      * 
                                                  * Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
      * single range is large enough to require multiple responses, they are
-     * guaranteed to be delivered in increasing offset order. There are no
-     * ordering guarantees across ranges. When no ranges are provided, the
-     * response message will not include ObjectRangeData. For full object
-     * downloads, the offset and size can be set to 0.
+     * delivered in increasing offset order. There are no ordering guarantees
+     * across ranges. When no ranges are provided, the response message
+     * doesn't  include `ObjectRangeData`. For full object downloads, the
+     * offset and size can be set to `0`.
      * 
                                            
      *
      * 
@@ -1029,10 +1031,10 @@ public Builder setReadRanges(int index, com.google.storage.v2.ReadRange value) {
      * 
                                                  * Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
      * single range is large enough to require multiple responses, they are
-     * guaranteed to be delivered in increasing offset order. There are no
-     * ordering guarantees across ranges. When no ranges are provided, the
-     * response message will not include ObjectRangeData. For full object
-     * downloads, the offset and size can be set to 0.
+     * delivered in increasing offset order. There are no ordering guarantees
+     * across ranges. When no ranges are provided, the response message
+     * doesn't  include `ObjectRangeData`. For full object downloads, the
+     * offset and size can be set to `0`.
      * 
                                            
      *
      * 
@@ -1057,10 +1059,10 @@ public Builder setReadRanges(
      * 
                                                  * Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
      * single range is large enough to require multiple responses, they are
-     * guaranteed to be delivered in increasing offset order. There are no
-     * ordering guarantees across ranges. When no ranges are provided, the
-     * response message will not include ObjectRangeData. For full object
-     * downloads, the offset and size can be set to 0.
+     * delivered in increasing offset order. There are no ordering guarantees
+     * across ranges. When no ranges are provided, the response message
+     * doesn't  include `ObjectRangeData`. For full object downloads, the
+     * offset and size can be set to `0`.
      * 
                                            
      *
      * 
@@ -1087,10 +1089,10 @@ public Builder addReadRanges(com.google.storage.v2.ReadRange value) {
      * 
                                                  * Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
      * single range is large enough to require multiple responses, they are
-     * guaranteed to be delivered in increasing offset order. There are no
-     * ordering guarantees across ranges. When no ranges are provided, the
-     * response message will not include ObjectRangeData. For full object
-     * downloads, the offset and size can be set to 0.
+     * delivered in increasing offset order. There are no ordering guarantees
+     * across ranges. When no ranges are provided, the response message
+     * doesn't  include `ObjectRangeData`. For full object downloads, the
+     * offset and size can be set to `0`.
      * 
                                            
      *
      * 
@@ -1117,10 +1119,10 @@ public Builder addReadRanges(int index, com.google.storage.v2.ReadRange value) {
      * 
                                                  * Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
      * single range is large enough to require multiple responses, they are
-     * guaranteed to be delivered in increasing offset order. There are no
-     * ordering guarantees across ranges. When no ranges are provided, the
-     * response message will not include ObjectRangeData. For full object
-     * downloads, the offset and size can be set to 0.
+     * delivered in increasing offset order. There are no ordering guarantees
+     * across ranges. When no ranges are provided, the response message
+     * doesn't  include `ObjectRangeData`. For full object downloads, the
+     * offset and size can be set to `0`.
      * 
                                            
      *
      * 
@@ -1144,10 +1146,10 @@ public Builder addReadRanges(com.google.storage.v2.ReadRange.Builder builderForV
      * 
                                                  * Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
      * single range is large enough to require multiple responses, they are
-     * guaranteed to be delivered in increasing offset order. There are no
-     * ordering guarantees across ranges. When no ranges are provided, the
-     * response message will not include ObjectRangeData. For full object
-     * downloads, the offset and size can be set to 0.
+     * delivered in increasing offset order. There are no ordering guarantees
+     * across ranges. When no ranges are provided, the response message
+     * doesn't  include `ObjectRangeData`. For full object downloads, the
+     * offset and size can be set to `0`.
      * 
                                            
      *
      * 
@@ -1172,10 +1174,10 @@ public Builder addReadRanges(
      * 
                                                  * Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
      * single range is large enough to require multiple responses, they are
-     * guaranteed to be delivered in increasing offset order. There are no
-     * ordering guarantees across ranges. When no ranges are provided, the
-     * response message will not include ObjectRangeData. For full object
-     * downloads, the offset and size can be set to 0.
+     * delivered in increasing offset order. There are no ordering guarantees
+     * across ranges. When no ranges are provided, the response message
+     * doesn't  include `ObjectRangeData`. For full object downloads, the
+     * offset and size can be set to `0`.
      * 
                                            
      *
      * 
@@ -1200,10 +1202,10 @@ public Builder addAllReadRanges(
      * 
                                                  * Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
      * single range is large enough to require multiple responses, they are
-     * guaranteed to be delivered in increasing offset order. There are no
-     * ordering guarantees across ranges. When no ranges are provided, the
-     * response message will not include ObjectRangeData. For full object
-     * downloads, the offset and size can be set to 0.
+     * delivered in increasing offset order. There are no ordering guarantees
+     * across ranges. When no ranges are provided, the response message
+     * doesn't  include `ObjectRangeData`. For full object downloads, the
+     * offset and size can be set to `0`.
      * 
                                            
      *
      * 
@@ -1227,10 +1229,10 @@ public Builder clearReadRanges() {
      * 
                                                  * Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
      * single range is large enough to require multiple responses, they are
-     * guaranteed to be delivered in increasing offset order. There are no
-     * ordering guarantees across ranges. When no ranges are provided, the
-     * response message will not include ObjectRangeData. For full object
-     * downloads, the offset and size can be set to 0.
+     * delivered in increasing offset order. There are no ordering guarantees
+     * across ranges. When no ranges are provided, the response message
+     * doesn't  include `ObjectRangeData`. For full object downloads, the
+     * offset and size can be set to `0`.
      * 
                                            
      *
      * 
@@ -1254,10 +1256,10 @@ public Builder removeReadRanges(int index) {
      * 
                                                  * Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
      * single range is large enough to require multiple responses, they are
-     * guaranteed to be delivered in increasing offset order. There are no
-     * ordering guarantees across ranges. When no ranges are provided, the
-     * response message will not include ObjectRangeData. For full object
-     * downloads, the offset and size can be set to 0.
+     * delivered in increasing offset order. There are no ordering guarantees
+     * across ranges. When no ranges are provided, the response message
+     * doesn't  include `ObjectRangeData`. For full object downloads, the
+     * offset and size can be set to `0`.
      * 
                                            
      *
      * 
@@ -1274,10 +1276,10 @@ public com.google.storage.v2.ReadRange.Builder getReadRangesBuilder(int index) {
      * 
                                                  * Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
      * single range is large enough to require multiple responses, they are
-     * guaranteed to be delivered in increasing offset order. There are no
-     * ordering guarantees across ranges. When no ranges are provided, the
-     * response message will not include ObjectRangeData. For full object
-     * downloads, the offset and size can be set to 0.
+     * delivered in increasing offset order. There are no ordering guarantees
+     * across ranges. When no ranges are provided, the response message
+     * doesn't  include `ObjectRangeData`. For full object downloads, the
+     * offset and size can be set to `0`.
      * 
                                            
      *
      * 
@@ -1298,10 +1300,10 @@ public com.google.storage.v2.ReadRangeOrBuilder getReadRangesOrBuilder(int index
      * 
                                                  * Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
      * single range is large enough to require multiple responses, they are
-     * guaranteed to be delivered in increasing offset order. There are no
-     * ordering guarantees across ranges. When no ranges are provided, the
-     * response message will not include ObjectRangeData. For full object
-     * downloads, the offset and size can be set to 0.
+     * delivered in increasing offset order. There are no ordering guarantees
+     * across ranges. When no ranges are provided, the response message
+     * doesn't  include `ObjectRangeData`. For full object downloads, the
+     * offset and size can be set to `0`.
      * 
                                            
      *
      * 
@@ -1323,10 +1325,10 @@ public com.google.storage.v2.ReadRangeOrBuilder getReadRangesOrBuilder(int index
      * 
                                                  * Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
      * single range is large enough to require multiple responses, they are
-     * guaranteed to be delivered in increasing offset order. There are no
-     * ordering guarantees across ranges. When no ranges are provided, the
-     * response message will not include ObjectRangeData. For full object
-     * downloads, the offset and size can be set to 0.
+     * delivered in increasing offset order. There are no ordering guarantees
+     * across ranges. When no ranges are provided, the response message
+     * doesn't  include `ObjectRangeData`. For full object downloads, the
+     * offset and size can be set to `0`.
      * 
                                            
      *
      * 
@@ -1344,10 +1346,10 @@ public com.google.storage.v2.ReadRange.Builder addReadRangesBuilder() {
      * 
                                                  * Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
      * single range is large enough to require multiple responses, they are
-     * guaranteed to be delivered in increasing offset order. There are no
-     * ordering guarantees across ranges. When no ranges are provided, the
-     * response message will not include ObjectRangeData. For full object
-     * downloads, the offset and size can be set to 0.
+     * delivered in increasing offset order. There are no ordering guarantees
+     * across ranges. When no ranges are provided, the response message
+     * doesn't  include `ObjectRangeData`. For full object downloads, the
+     * offset and size can be set to `0`.
      * 
                                            
      *
      * 
@@ -1365,10 +1367,10 @@ public com.google.storage.v2.ReadRange.Builder addReadRangesBuilder(int index) {
      * 
                                                  * Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
      * single range is large enough to require multiple responses, they are
-     * guaranteed to be delivered in increasing offset order. There are no
-     * ordering guarantees across ranges. When no ranges are provided, the
-     * response message will not include ObjectRangeData. For full object
-     * downloads, the offset and size can be set to 0.
+     * delivered in increasing offset order. There are no ordering guarantees
+     * across ranges. When no ranges are provided, the response message
+     * doesn't  include `ObjectRangeData`. For full object downloads, the
+     * offset and size can be set to `0`.
      * 
                                            
      *
      * 
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectRequestOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectRequestOrBuilder.java
index a2153c64ae..511010dff7 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectRequestOrBuilder.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectRequestOrBuilder.java
@@ -29,8 +29,8 @@ public interface BidiReadObjectRequestOrBuilder
    *
    * 
                                                * Optional. The first message of each stream should set this field. If this
-   * is not the first message, an error will be returned. Describes the object
-   * to read.
+   * is not the first message, an error is returned. Describes the object to
+   * read.
    * 
                                            
    *
    * 
@@ -46,8 +46,8 @@ public interface BidiReadObjectRequestOrBuilder
    *
    * 
                                                * Optional. The first message of each stream should set this field. If this
-   * is not the first message, an error will be returned. Describes the object
-   * to read.
+   * is not the first message, an error is returned. Describes the object to
+   * read.
    * 
                                            
    *
    * 
@@ -63,8 +63,8 @@ public interface BidiReadObjectRequestOrBuilder
    *
    * 
                                                * Optional. The first message of each stream should set this field. If this
-   * is not the first message, an error will be returned. Describes the object
-   * to read.
+   * is not the first message, an error is returned. Describes the object to
+   * read.
    * 
                                            
    *
    * 
@@ -79,10 +79,10 @@ public interface BidiReadObjectRequestOrBuilder
    * 
                                                * Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
    * single range is large enough to require multiple responses, they are
-   * guaranteed to be delivered in increasing offset order. There are no
-   * ordering guarantees across ranges. When no ranges are provided, the
-   * response message will not include ObjectRangeData. For full object
-   * downloads, the offset and size can be set to 0.
+   * delivered in increasing offset order. There are no ordering guarantees
+   * across ranges. When no ranges are provided, the response message
+   * doesn't  include `ObjectRangeData`. For full object downloads, the
+   * offset and size can be set to `0`.
    * 
                                            
    *
    * 
@@ -97,10 +97,10 @@ public interface BidiReadObjectRequestOrBuilder
    * 
                                                * Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
    * single range is large enough to require multiple responses, they are
-   * guaranteed to be delivered in increasing offset order. There are no
-   * ordering guarantees across ranges. When no ranges are provided, the
-   * response message will not include ObjectRangeData. For full object
-   * downloads, the offset and size can be set to 0.
+   * delivered in increasing offset order. There are no ordering guarantees
+   * across ranges. When no ranges are provided, the response message
+   * doesn't  include `ObjectRangeData`. For full object downloads, the
+   * offset and size can be set to `0`.
    * 
                                            
    *
    * 
@@ -115,10 +115,10 @@ public interface BidiReadObjectRequestOrBuilder
    * 
                                                * Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
    * single range is large enough to require multiple responses, they are
-   * guaranteed to be delivered in increasing offset order. There are no
-   * ordering guarantees across ranges. When no ranges are provided, the
-   * response message will not include ObjectRangeData. For full object
-   * downloads, the offset and size can be set to 0.
+   * delivered in increasing offset order. There are no ordering guarantees
+   * across ranges. When no ranges are provided, the response message
+   * doesn't  include `ObjectRangeData`. For full object downloads, the
+   * offset and size can be set to `0`.
    * 
                                            
    *
    * 
@@ -133,10 +133,10 @@ public interface BidiReadObjectRequestOrBuilder
    * 
                                                * Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
    * single range is large enough to require multiple responses, they are
-   * guaranteed to be delivered in increasing offset order. There are no
-   * ordering guarantees across ranges. When no ranges are provided, the
-   * response message will not include ObjectRangeData. For full object
-   * downloads, the offset and size can be set to 0.
+   * delivered in increasing offset order. There are no ordering guarantees
+   * across ranges. When no ranges are provided, the response message
+   * doesn't  include `ObjectRangeData`. For full object downloads, the
+   * offset and size can be set to `0`.
    * 
                                            
    *
    * 
@@ -151,10 +151,10 @@ public interface BidiReadObjectRequestOrBuilder
    * 
                                                * Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
    * single range is large enough to require multiple responses, they are
-   * guaranteed to be delivered in increasing offset order. There are no
-   * ordering guarantees across ranges. When no ranges are provided, the
-   * response message will not include ObjectRangeData. For full object
-   * downloads, the offset and size can be set to 0.
+   * delivered in increasing offset order. There are no ordering guarantees
+   * across ranges. When no ranges are provided, the response message
+   * doesn't  include `ObjectRangeData`. For full object downloads, the
+   * offset and size can be set to `0`.
    * 
                                            
    *
    * 
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectResponse.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectResponse.java
index e73610a3d8..95c96e91f3 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectResponse.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectResponse.java
@@ -23,7 +23,8 @@
  *
  *
  * 
                                            - * Response message for BidiReadObject.
+ * Response message for
+ * [BidiReadObject][google.storage.v2.Storage.BidiReadObject].
  * 
                                            
  *
  * Protobuf type {@code google.storage.v2.BidiReadObjectResponse}
@@ -74,13 +75,13 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * 
                                            -   * A portion of the object's data. The service **may** leave data
-   * empty for any given ReadResponse. This enables the service to inform the
+   * A portion of the object's data. The service might leave data
+   * empty for any given `ReadResponse`. This enables the service to inform the
    * client that the request is still live while it is running an operation to
    * generate more data.
-   * The service **may** pipeline multiple responses belonging to different read
-   * requests. Each ObjectRangeData entry will have a read_id
-   * set to the same value as the corresponding source read request.
+   * The service might pipeline multiple responses belonging to different read
+   * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+   * to the same value as the corresponding source read request.
    * 
                                            
    *
    * repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -94,13 +95,13 @@ public java.util.List getObjectDataRanges
    *
    *
    * 
                                            -   * A portion of the object's data. The service **may** leave data
-   * empty for any given ReadResponse. This enables the service to inform the
+   * A portion of the object's data. The service might leave data
+   * empty for any given `ReadResponse`. This enables the service to inform the
    * client that the request is still live while it is running an operation to
    * generate more data.
-   * The service **may** pipeline multiple responses belonging to different read
-   * requests. Each ObjectRangeData entry will have a read_id
-   * set to the same value as the corresponding source read request.
+   * The service might pipeline multiple responses belonging to different read
+   * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+   * to the same value as the corresponding source read request.
    * 
                                            
    *
    * repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -115,13 +116,13 @@ public java.util.List getObjectDataRanges
    *
    *
    * 
                                            -   * A portion of the object's data. The service **may** leave data
-   * empty for any given ReadResponse. This enables the service to inform the
+   * A portion of the object's data. The service might leave data
+   * empty for any given `ReadResponse`. This enables the service to inform the
    * client that the request is still live while it is running an operation to
    * generate more data.
-   * The service **may** pipeline multiple responses belonging to different read
-   * requests. Each ObjectRangeData entry will have a read_id
-   * set to the same value as the corresponding source read request.
+   * The service might pipeline multiple responses belonging to different read
+   * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+   * to the same value as the corresponding source read request.
    * 
                                            
    *
    * repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -135,13 +136,13 @@ public int getObjectDataRangesCount() {
    *
    *
    * 
                                            -   * A portion of the object's data. The service **may** leave data
-   * empty for any given ReadResponse. This enables the service to inform the
+   * A portion of the object's data. The service might leave data
+   * empty for any given `ReadResponse`. This enables the service to inform the
    * client that the request is still live while it is running an operation to
    * generate more data.
-   * The service **may** pipeline multiple responses belonging to different read
-   * requests. Each ObjectRangeData entry will have a read_id
-   * set to the same value as the corresponding source read request.
+   * The service might pipeline multiple responses belonging to different read
+   * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+   * to the same value as the corresponding source read request.
    * 
                                            
    *
    * repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -155,13 +156,13 @@ public com.google.storage.v2.ObjectRangeData getObjectDataRanges(int index) {
    *
    *
    * 
                                            -   * A portion of the object's data. The service **may** leave data
-   * empty for any given ReadResponse. This enables the service to inform the
+   * A portion of the object's data. The service might leave data
+   * empty for any given `ReadResponse`. This enables the service to inform the
    * client that the request is still live while it is running an operation to
    * generate more data.
-   * The service **may** pipeline multiple responses belonging to different read
-   * requests. Each ObjectRangeData entry will have a read_id
-   * set to the same value as the corresponding source read request.
+   * The service might pipeline multiple responses belonging to different read
+   * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+   * to the same value as the corresponding source read request.
    * 
                                            
    *
    * repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -233,7 +234,7 @@ public com.google.storage.v2.ObjectOrBuilder getMetadataOrBuilder() {
    *
    *
    * 
                                            -   * This field will be periodically refreshed, however it may not be set in
+   * This field is periodically refreshed, however it might not be set in
    * every response. It allows the client to more efficiently open subsequent
    * bidirectional streams to the same object.
    * 
                                            
@@ -251,7 +252,7 @@ public boolean hasReadHandle() {
    *
    *
    * 
                                            -   * This field will be periodically refreshed, however it may not be set in
+   * This field is periodically refreshed, however it might not be set in
    * every response. It allows the client to more efficiently open subsequent
    * bidirectional streams to the same object.
    * 
                                            
@@ -271,7 +272,7 @@ public com.google.storage.v2.BidiReadHandle getReadHandle() {
    *
    *
    * 
                                            -   * This field will be periodically refreshed, however it may not be set in
+   * This field is periodically refreshed, however it might not be set in
    * every response. It allows the client to more efficiently open subsequent
    * bidirectional streams to the same object.
    * 
                                            
@@ -479,7 +480,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
                                            -   * Response message for BidiReadObject.
+   * Response message for
+   * [BidiReadObject][google.storage.v2.Storage.BidiReadObject].
    * 
                                            
    *
    * Protobuf type {@code google.storage.v2.BidiReadObjectResponse}
@@ -772,13 +774,13 @@ private void ensureObjectDataRangesIsMutable() {
      *
      *
      * 
                                            -     * A portion of the object's data. The service **may** leave data
-     * empty for any given ReadResponse. This enables the service to inform the
+     * A portion of the object's data. The service might leave data
+     * empty for any given `ReadResponse`. This enables the service to inform the
      * client that the request is still live while it is running an operation to
      * generate more data.
-     * The service **may** pipeline multiple responses belonging to different read
-     * requests. Each ObjectRangeData entry will have a read_id
-     * set to the same value as the corresponding source read request.
+     * The service might pipeline multiple responses belonging to different read
+     * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+     * to the same value as the corresponding source read request.
      * 
                                            
      *
      * repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -795,13 +797,13 @@ public java.util.List getObjectDataRanges
      *
      *
      * 
                                            -     * A portion of the object's data. The service **may** leave data
-     * empty for any given ReadResponse. This enables the service to inform the
+     * A portion of the object's data. The service might leave data
+     * empty for any given `ReadResponse`. This enables the service to inform the
      * client that the request is still live while it is running an operation to
      * generate more data.
-     * The service **may** pipeline multiple responses belonging to different read
-     * requests. Each ObjectRangeData entry will have a read_id
-     * set to the same value as the corresponding source read request.
+     * The service might pipeline multiple responses belonging to different read
+     * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+     * to the same value as the corresponding source read request.
      * 
                                            
      *
      * repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -818,13 +820,13 @@ public int getObjectDataRangesCount() {
      *
      *
      * 
                                            -     * A portion of the object's data. The service **may** leave data
-     * empty for any given ReadResponse. This enables the service to inform the
+     * A portion of the object's data. The service might leave data
+     * empty for any given `ReadResponse`. This enables the service to inform the
      * client that the request is still live while it is running an operation to
      * generate more data.
-     * The service **may** pipeline multiple responses belonging to different read
-     * requests. Each ObjectRangeData entry will have a read_id
-     * set to the same value as the corresponding source read request.
+     * The service might pipeline multiple responses belonging to different read
+     * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+     * to the same value as the corresponding source read request.
      * 
                                            
      *
      * repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -841,13 +843,13 @@ public com.google.storage.v2.ObjectRangeData getObjectDataRanges(int index) {
      *
      *
      * 
                                            -     * A portion of the object's data. The service **may** leave data
-     * empty for any given ReadResponse. This enables the service to inform the
+     * A portion of the object's data. The service might leave data
+     * empty for any given `ReadResponse`. This enables the service to inform the
      * client that the request is still live while it is running an operation to
      * generate more data.
-     * The service **may** pipeline multiple responses belonging to different read
-     * requests. Each ObjectRangeData entry will have a read_id
-     * set to the same value as the corresponding source read request.
+     * The service might pipeline multiple responses belonging to different read
+     * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+     * to the same value as the corresponding source read request.
      * 
                                            
      *
      * repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -870,13 +872,13 @@ public Builder setObjectDataRanges(int index, com.google.storage.v2.ObjectRangeD
      *
      *
      * 
                                            -     * A portion of the object's data. The service **may** leave data
-     * empty for any given ReadResponse. This enables the service to inform the
+     * A portion of the object's data. The service might leave data
+     * empty for any given `ReadResponse`. This enables the service to inform the
      * client that the request is still live while it is running an operation to
      * generate more data.
-     * The service **may** pipeline multiple responses belonging to different read
-     * requests. Each ObjectRangeData entry will have a read_id
-     * set to the same value as the corresponding source read request.
+     * The service might pipeline multiple responses belonging to different read
+     * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+     * to the same value as the corresponding source read request.
      * 
                                            
      *
      * repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -897,13 +899,13 @@ public Builder setObjectDataRanges(
      *
      *
      * 
                                            -     * A portion of the object's data. The service **may** leave data
-     * empty for any given ReadResponse. This enables the service to inform the
+     * A portion of the object's data. The service might leave data
+     * empty for any given `ReadResponse`. This enables the service to inform the
      * client that the request is still live while it is running an operation to
      * generate more data.
-     * The service **may** pipeline multiple responses belonging to different read
-     * requests. Each ObjectRangeData entry will have a read_id
-     * set to the same value as the corresponding source read request.
+     * The service might pipeline multiple responses belonging to different read
+     * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+     * to the same value as the corresponding source read request.
      * 
                                            
      *
      * repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -926,13 +928,13 @@ public Builder addObjectDataRanges(com.google.storage.v2.ObjectRangeData value)
      *
      *
      * 
                                            -     * A portion of the object's data. The service **may** leave data
-     * empty for any given ReadResponse. This enables the service to inform the
+     * A portion of the object's data. The service might leave data
+     * empty for any given `ReadResponse`. This enables the service to inform the
      * client that the request is still live while it is running an operation to
      * generate more data.
-     * The service **may** pipeline multiple responses belonging to different read
-     * requests. Each ObjectRangeData entry will have a read_id
-     * set to the same value as the corresponding source read request.
+     * The service might pipeline multiple responses belonging to different read
+     * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+     * to the same value as the corresponding source read request.
      * 
                                            
      *
      * repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -955,13 +957,13 @@ public Builder addObjectDataRanges(int index, com.google.storage.v2.ObjectRangeD
      *
      *
      * 
                                            -     * A portion of the object's data. The service **may** leave data
-     * empty for any given ReadResponse. This enables the service to inform the
+     * A portion of the object's data. The service might leave data
+     * empty for any given `ReadResponse`. This enables the service to inform the
      * client that the request is still live while it is running an operation to
      * generate more data.
-     * The service **may** pipeline multiple responses belonging to different read
-     * requests. Each ObjectRangeData entry will have a read_id
-     * set to the same value as the corresponding source read request.
+     * The service might pipeline multiple responses belonging to different read
+     * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+     * to the same value as the corresponding source read request.
      * 
                                            
      *
      * repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -982,13 +984,13 @@ public Builder addObjectDataRanges(
      *
      *
      * 
                                            -     * A portion of the object's data. The service **may** leave data
-     * empty for any given ReadResponse. This enables the service to inform the
+     * A portion of the object's data. The service might leave data
+     * empty for any given `ReadResponse`. This enables the service to inform the
      * client that the request is still live while it is running an operation to
      * generate more data.
-     * The service **may** pipeline multiple responses belonging to different read
-     * requests. Each ObjectRangeData entry will have a read_id
-     * set to the same value as the corresponding source read request.
+     * The service might pipeline multiple responses belonging to different read
+     * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+     * to the same value as the corresponding source read request.
      * 
                                            
      *
      * repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -1009,13 +1011,13 @@ public Builder addObjectDataRanges(
      *
      *
      * 
                                            -     * A portion of the object's data. The service **may** leave data
-     * empty for any given ReadResponse. This enables the service to inform the
+     * A portion of the object's data. The service might leave data
+     * empty for any given `ReadResponse`. This enables the service to inform the
      * client that the request is still live while it is running an operation to
      * generate more data.
-     * The service **may** pipeline multiple responses belonging to different read
-     * requests. Each ObjectRangeData entry will have a read_id
-     * set to the same value as the corresponding source read request.
+     * The service might pipeline multiple responses belonging to different read
+     * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+     * to the same value as the corresponding source read request.
      * 
                                            
      *
      * repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -1036,13 +1038,13 @@ public Builder addAllObjectDataRanges(
      *
      *
      * 
                                            -     * A portion of the object's data. The service **may** leave data
-     * empty for any given ReadResponse. This enables the service to inform the
+     * A portion of the object's data. The service might leave data
+     * empty for any given `ReadResponse`. This enables the service to inform the
      * client that the request is still live while it is running an operation to
      * generate more data.
-     * The service **may** pipeline multiple responses belonging to different read
-     * requests. Each ObjectRangeData entry will have a read_id
-     * set to the same value as the corresponding source read request.
+     * The service might pipeline multiple responses belonging to different read
+     * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+     * to the same value as the corresponding source read request.
      * 
                                            
      *
      * repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -1062,13 +1064,13 @@ public Builder clearObjectDataRanges() {
      *
      *
      * 
                                            -     * A portion of the object's data. The service **may** leave data
-     * empty for any given ReadResponse. This enables the service to inform the
+     * A portion of the object's data. The service might leave data
+     * empty for any given `ReadResponse`. This enables the service to inform the
      * client that the request is still live while it is running an operation to
      * generate more data.
-     * The service **may** pipeline multiple responses belonging to different read
-     * requests. Each ObjectRangeData entry will have a read_id
-     * set to the same value as the corresponding source read request.
+     * The service might pipeline multiple responses belonging to different read
+     * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+     * to the same value as the corresponding source read request.
      * 
                                            
      *
      * repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -1088,13 +1090,13 @@ public Builder removeObjectDataRanges(int index) {
      *
      *
      * 
                                            -     * A portion of the object's data. The service **may** leave data
-     * empty for any given ReadResponse. This enables the service to inform the
+     * A portion of the object's data. The service might leave data
+     * empty for any given `ReadResponse`. This enables the service to inform the
      * client that the request is still live while it is running an operation to
      * generate more data.
-     * The service **may** pipeline multiple responses belonging to different read
-     * requests. Each ObjectRangeData entry will have a read_id
-     * set to the same value as the corresponding source read request.
+     * The service might pipeline multiple responses belonging to different read
+     * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+     * to the same value as the corresponding source read request.
      * 
                                            
      *
      * repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -1107,13 +1109,13 @@ public com.google.storage.v2.ObjectRangeData.Builder getObjectDataRangesBuilder(
      *
      *
      * 
                                            -     * A portion of the object's data. The service **may** leave data
-     * empty for any given ReadResponse. This enables the service to inform the
+     * A portion of the object's data. The service might leave data
+     * empty for any given `ReadResponse`. This enables the service to inform the
      * client that the request is still live while it is running an operation to
      * generate more data.
-     * The service **may** pipeline multiple responses belonging to different read
-     * requests. Each ObjectRangeData entry will have a read_id
-     * set to the same value as the corresponding source read request.
+     * The service might pipeline multiple responses belonging to different read
+     * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+     * to the same value as the corresponding source read request.
      * 
                                            
      *
      * repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -1130,13 +1132,13 @@ public com.google.storage.v2.ObjectRangeDataOrBuilder getObjectDataRangesOrBuild
      *
      *
      * 
                                            -     * A portion of the object's data. The service **may** leave data
-     * empty for any given ReadResponse. This enables the service to inform the
+     * A portion of the object's data. The service might leave data
+     * empty for any given `ReadResponse`. This enables the service to inform the
      * client that the request is still live while it is running an operation to
      * generate more data.
-     * The service **may** pipeline multiple responses belonging to different read
-     * requests. Each ObjectRangeData entry will have a read_id
-     * set to the same value as the corresponding source read request.
+     * The service might pipeline multiple responses belonging to different read
+     * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+     * to the same value as the corresponding source read request.
      * 
                                            
      *
      * repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -1154,13 +1156,13 @@ public com.google.storage.v2.ObjectRangeDataOrBuilder getObjectDataRangesOrBuild
      *
      *
      * 
                                            -     * A portion of the object's data. The service **may** leave data
-     * empty for any given ReadResponse. This enables the service to inform the
+     * A portion of the object's data. The service might leave data
+     * empty for any given `ReadResponse`. This enables the service to inform the
      * client that the request is still live while it is running an operation to
      * generate more data.
-     * The service **may** pipeline multiple responses belonging to different read
-     * requests. Each ObjectRangeData entry will have a read_id
-     * set to the same value as the corresponding source read request.
+     * The service might pipeline multiple responses belonging to different read
+     * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+     * to the same value as the corresponding source read request.
      * 
                                            
      *
      * repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -1174,13 +1176,13 @@ public com.google.storage.v2.ObjectRangeData.Builder addObjectDataRangesBuilder(
      *
      *
      * 
                                            -     * A portion of the object's data. The service **may** leave data
-     * empty for any given ReadResponse. This enables the service to inform the
+     * A portion of the object's data. The service might leave data
+     * empty for any given `ReadResponse`. This enables the service to inform the
      * client that the request is still live while it is running an operation to
      * generate more data.
-     * The service **may** pipeline multiple responses belonging to different read
-     * requests. Each ObjectRangeData entry will have a read_id
-     * set to the same value as the corresponding source read request.
+     * The service might pipeline multiple responses belonging to different read
+     * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+     * to the same value as the corresponding source read request.
      * 
                                            
      *
      * repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -1194,13 +1196,13 @@ public com.google.storage.v2.ObjectRangeData.Builder addObjectDataRangesBuilder(
      *
      *
      * 
                                            -     * A portion of the object's data. The service **may** leave data
-     * empty for any given ReadResponse. This enables the service to inform the
+     * A portion of the object's data. The service might leave data
+     * empty for any given `ReadResponse`. This enables the service to inform the
      * client that the request is still live while it is running an operation to
      * generate more data.
-     * The service **may** pipeline multiple responses belonging to different read
-     * requests. Each ObjectRangeData entry will have a read_id
-     * set to the same value as the corresponding source read request.
+     * The service might pipeline multiple responses belonging to different read
+     * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+     * to the same value as the corresponding source read request.
      * 
                                            
      *
      * repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -1449,7 +1451,7 @@ public com.google.storage.v2.ObjectOrBuilder getMetadataOrBuilder() {
      *
      *
      * 
                                            -     * This field will be periodically refreshed, however it may not be set in
+     * This field is periodically refreshed, however it might not be set in
      * every response. It allows the client to more efficiently open subsequent
      * bidirectional streams to the same object.
      * 
                                            
@@ -1466,7 +1468,7 @@ public boolean hasReadHandle() {
      *
      *
      * 
                                            -     * This field will be periodically refreshed, however it may not be set in
+     * This field is periodically refreshed, however it might not be set in
      * every response. It allows the client to more efficiently open subsequent
      * bidirectional streams to the same object.
      * 
                                            
@@ -1489,7 +1491,7 @@ public com.google.storage.v2.BidiReadHandle getReadHandle() {
      *
      *
      * 
                                            -     * This field will be periodically refreshed, however it may not be set in
+     * This field is periodically refreshed, however it might not be set in
      * every response. It allows the client to more efficiently open subsequent
      * bidirectional streams to the same object.
      * 
                                            
@@ -1514,7 +1516,7 @@ public Builder setReadHandle(com.google.storage.v2.BidiReadHandle value) {
      *
      *
      * 
                                            -     * This field will be periodically refreshed, however it may not be set in
+     * This field is periodically refreshed, however it might not be set in
      * every response. It allows the client to more efficiently open subsequent
      * bidirectional streams to the same object.
      * 
                                            
@@ -1536,7 +1538,7 @@ public Builder setReadHandle(com.google.storage.v2.BidiReadHandle.Builder builde
      *
      *
      * 
                                            -     * This field will be periodically refreshed, however it may not be set in
+     * This field is periodically refreshed, however it might not be set in
      * every response. It allows the client to more efficiently open subsequent
      * bidirectional streams to the same object.
      * 
                                            
@@ -1566,7 +1568,7 @@ public Builder mergeReadHandle(com.google.storage.v2.BidiReadHandle value) {
      *
      *
      * 
                                            -     * This field will be periodically refreshed, however it may not be set in
+     * This field is periodically refreshed, however it might not be set in
      * every response. It allows the client to more efficiently open subsequent
      * bidirectional streams to the same object.
      * 
                                            
@@ -1588,7 +1590,7 @@ public Builder clearReadHandle() {
      *
      *
      * 
                                            -     * This field will be periodically refreshed, however it may not be set in
+     * This field is periodically refreshed, however it might not be set in
      * every response. It allows the client to more efficiently open subsequent
      * bidirectional streams to the same object.
      * 
                                            
@@ -1605,7 +1607,7 @@ public com.google.storage.v2.BidiReadHandle.Builder getReadHandleBuilder() {
      *
      *
      * 
                                            -     * This field will be periodically refreshed, however it may not be set in
+     * This field is periodically refreshed, however it might not be set in
      * every response. It allows the client to more efficiently open subsequent
      * bidirectional streams to the same object.
      * 
                                            
@@ -1626,7 +1628,7 @@ public com.google.storage.v2.BidiReadHandleOrBuilder getReadHandleOrBuilder() {
      *
      *
      * 
                                            -     * This field will be periodically refreshed, however it may not be set in
+     * This field is periodically refreshed, however it might not be set in
      * every response. It allows the client to more efficiently open subsequent
      * bidirectional streams to the same object.
      * 
                                            
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectResponseOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectResponseOrBuilder.java
index 351816bbe9..baa53920bf 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectResponseOrBuilder.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectResponseOrBuilder.java
@@ -28,13 +28,13 @@ public interface BidiReadObjectResponseOrBuilder
    *
    *
    * 
                                            -   * A portion of the object's data. The service **may** leave data
-   * empty for any given ReadResponse. This enables the service to inform the
+   * A portion of the object's data. The service might leave data
+   * empty for any given `ReadResponse`. This enables the service to inform the
    * client that the request is still live while it is running an operation to
    * generate more data.
-   * The service **may** pipeline multiple responses belonging to different read
-   * requests. Each ObjectRangeData entry will have a read_id
-   * set to the same value as the corresponding source read request.
+   * The service might pipeline multiple responses belonging to different read
+   * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+   * to the same value as the corresponding source read request.
    * 
                                            
    *
    * repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -45,13 +45,13 @@ public interface BidiReadObjectResponseOrBuilder
    *
    *
    * 
                                            -   * A portion of the object's data. The service **may** leave data
-   * empty for any given ReadResponse. This enables the service to inform the
+   * A portion of the object's data. The service might leave data
+   * empty for any given `ReadResponse`. This enables the service to inform the
    * client that the request is still live while it is running an operation to
    * generate more data.
-   * The service **may** pipeline multiple responses belonging to different read
-   * requests. Each ObjectRangeData entry will have a read_id
-   * set to the same value as the corresponding source read request.
+   * The service might pipeline multiple responses belonging to different read
+   * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+   * to the same value as the corresponding source read request.
    * 
                                            
    *
    * repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -62,13 +62,13 @@ public interface BidiReadObjectResponseOrBuilder
    *
    *
    * 
                                            -   * A portion of the object's data. The service **may** leave data
-   * empty for any given ReadResponse. This enables the service to inform the
+   * A portion of the object's data. The service might leave data
+   * empty for any given `ReadResponse`. This enables the service to inform the
    * client that the request is still live while it is running an operation to
    * generate more data.
-   * The service **may** pipeline multiple responses belonging to different read
-   * requests. Each ObjectRangeData entry will have a read_id
-   * set to the same value as the corresponding source read request.
+   * The service might pipeline multiple responses belonging to different read
+   * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+   * to the same value as the corresponding source read request.
    * 
                                            
    *
    * repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -79,13 +79,13 @@ public interface BidiReadObjectResponseOrBuilder
    *
    *
    * 
                                            -   * A portion of the object's data. The service **may** leave data
-   * empty for any given ReadResponse. This enables the service to inform the
+   * A portion of the object's data. The service might leave data
+   * empty for any given `ReadResponse`. This enables the service to inform the
    * client that the request is still live while it is running an operation to
    * generate more data.
-   * The service **may** pipeline multiple responses belonging to different read
-   * requests. Each ObjectRangeData entry will have a read_id
-   * set to the same value as the corresponding source read request.
+   * The service might pipeline multiple responses belonging to different read
+   * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+   * to the same value as the corresponding source read request.
    * 
                                            
    *
    * repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -97,13 +97,13 @@ public interface BidiReadObjectResponseOrBuilder
    *
    *
    * 
                                            -   * A portion of the object's data. The service **may** leave data
-   * empty for any given ReadResponse. This enables the service to inform the
+   * A portion of the object's data. The service might leave data
+   * empty for any given `ReadResponse`. This enables the service to inform the
    * client that the request is still live while it is running an operation to
    * generate more data.
-   * The service **may** pipeline multiple responses belonging to different read
-   * requests. Each ObjectRangeData entry will have a read_id
-   * set to the same value as the corresponding source read request.
+   * The service might pipeline multiple responses belonging to different read
+   * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+   * to the same value as the corresponding source read request.
    * 
                                            
    *
    * repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -157,7 +157,7 @@ public interface BidiReadObjectResponseOrBuilder
    *
    *
    * 
                                            -   * This field will be periodically refreshed, however it may not be set in
+   * This field is periodically refreshed, however it might not be set in
    * every response. It allows the client to more efficiently open subsequent
    * bidirectional streams to the same object.
    * 
                                            
@@ -172,7 +172,7 @@ public interface BidiReadObjectResponseOrBuilder
    *
    *
    * 
                                            -   * This field will be periodically refreshed, however it may not be set in
+   * This field is periodically refreshed, however it might not be set in
    * every response. It allows the client to more efficiently open subsequent
    * bidirectional streams to the same object.
    * 
                                            
@@ -187,7 +187,7 @@ public interface BidiReadObjectResponseOrBuilder
    *
    *
    * 
                                            -   * This field will be periodically refreshed, however it may not be set in
+   * This field is periodically refreshed, however it might not be set in
    * every response. It allows the client to more efficiently open subsequent
    * bidirectional streams to the same object.
    * 
                                            
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectSpec.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectSpec.java
index 9b4e87d911..63ba0c2c82 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectSpec.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectSpec.java
@@ -422,19 +422,18 @@ public com.google.storage.v2.CommonObjectRequestParams getCommonObjectRequestPar
    *
    * 
                                                * Mask specifying which fields to read.
-   * The checksummed_data field and its children will always be present.
-   * If no mask is specified, will default to all fields except metadata.owner
-   * and metadata.acl.
-   * * may be used to mean "all fields".
+   * The `checksummed_data` field and its children are always present.
+   * If no mask is specified, it defaults to all fields except `metadata.
+   * owner` and `metadata.acl`.
+   * `*` might be used to mean "all fields".
    * As per https://google.aip.dev/161, this field is deprecated.
-   * As an alternative, grpc metadata can be used:
-   * https://cloud.google.com/apis/docs/system-parameters#definitions
+   * As an alternative, `grpc metadata` can be used:
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 12 [deprecated = true];
    *
    * @deprecated google.storage.v2.BidiReadObjectSpec.read_mask is deprecated. See
-   *     google/storage/v2/storage.proto;l=1027
+   *     google/storage/v2/storage.proto;l=1187
    * @return Whether the readMask field is set.
    */
   @java.lang.Override
@@ -448,19 +447,18 @@ public boolean hasReadMask() {
    *
    * 
                                                * Mask specifying which fields to read.
-   * The checksummed_data field and its children will always be present.
-   * If no mask is specified, will default to all fields except metadata.owner
-   * and metadata.acl.
-   * * may be used to mean "all fields".
+   * The `checksummed_data` field and its children are always present.
+   * If no mask is specified, it defaults to all fields except `metadata.
+   * owner` and `metadata.acl`.
+   * `*` might be used to mean "all fields".
    * As per https://google.aip.dev/161, this field is deprecated.
-   * As an alternative, grpc metadata can be used:
-   * https://cloud.google.com/apis/docs/system-parameters#definitions
+   * As an alternative, `grpc metadata` can be used:
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 12 [deprecated = true];
    *
    * @deprecated google.storage.v2.BidiReadObjectSpec.read_mask is deprecated. See
-   *     google/storage/v2/storage.proto;l=1027
+   *     google/storage/v2/storage.proto;l=1187
    * @return The readMask.
    */
   @java.lang.Override
@@ -474,13 +472,12 @@ public com.google.protobuf.FieldMask getReadMask() {
    *
    * 
                                                * Mask specifying which fields to read.
-   * The checksummed_data field and its children will always be present.
-   * If no mask is specified, will default to all fields except metadata.owner
-   * and metadata.acl.
-   * * may be used to mean "all fields".
+   * The `checksummed_data` field and its children are always present.
+   * If no mask is specified, it defaults to all fields except `metadata.
+   * owner` and `metadata.acl`.
+   * `*` might be used to mean "all fields".
    * As per https://google.aip.dev/161, this field is deprecated.
-   * As an alternative, grpc metadata can be used:
-   * https://cloud.google.com/apis/docs/system-parameters#definitions
+   * As an alternative, `grpc metadata` can be used:
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 12 [deprecated = true];
@@ -2113,19 +2110,18 @@ public Builder clearCommonObjectRequestParams() {
      *
      * 
                                                  * Mask specifying which fields to read.
-     * The checksummed_data field and its children will always be present.
-     * If no mask is specified, will default to all fields except metadata.owner
-     * and metadata.acl.
-     * * may be used to mean "all fields".
+     * The `checksummed_data` field and its children are always present.
+     * If no mask is specified, it defaults to all fields except `metadata.
+     * owner` and `metadata.acl`.
+     * `*` might be used to mean "all fields".
      * As per https://google.aip.dev/161, this field is deprecated.
-     * As an alternative, grpc metadata can be used:
-     * https://cloud.google.com/apis/docs/system-parameters#definitions
+     * As an alternative, `grpc metadata` can be used:
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 12 [deprecated = true];
      *
      * @deprecated google.storage.v2.BidiReadObjectSpec.read_mask is deprecated. See
-     *     google/storage/v2/storage.proto;l=1027
+     *     google/storage/v2/storage.proto;l=1187
      * @return Whether the readMask field is set.
      */
     @java.lang.Deprecated
@@ -2138,19 +2134,18 @@ public boolean hasReadMask() {
      *
      * 
                                                  * Mask specifying which fields to read.
-     * The checksummed_data field and its children will always be present.
-     * If no mask is specified, will default to all fields except metadata.owner
-     * and metadata.acl.
-     * * may be used to mean "all fields".
+     * The `checksummed_data` field and its children are always present.
+     * If no mask is specified, it defaults to all fields except `metadata.
+     * owner` and `metadata.acl`.
+     * `*` might be used to mean "all fields".
      * As per https://google.aip.dev/161, this field is deprecated.
-     * As an alternative, grpc metadata can be used:
-     * https://cloud.google.com/apis/docs/system-parameters#definitions
+     * As an alternative, `grpc metadata` can be used:
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 12 [deprecated = true];
      *
      * @deprecated google.storage.v2.BidiReadObjectSpec.read_mask is deprecated. See
-     *     google/storage/v2/storage.proto;l=1027
+     *     google/storage/v2/storage.proto;l=1187
      * @return The readMask.
      */
     @java.lang.Deprecated
@@ -2167,13 +2162,12 @@ public com.google.protobuf.FieldMask getReadMask() {
      *
      * 
                                                  * Mask specifying which fields to read.
-     * The checksummed_data field and its children will always be present.
-     * If no mask is specified, will default to all fields except metadata.owner
-     * and metadata.acl.
-     * * may be used to mean "all fields".
+     * The `checksummed_data` field and its children are always present.
+     * If no mask is specified, it defaults to all fields except `metadata.
+     * owner` and `metadata.acl`.
+     * `*` might be used to mean "all fields".
      * As per https://google.aip.dev/161, this field is deprecated.
-     * As an alternative, grpc metadata can be used:
-     * https://cloud.google.com/apis/docs/system-parameters#definitions
+     * As an alternative, `grpc metadata` can be used:
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 12 [deprecated = true];
@@ -2198,13 +2192,12 @@ public Builder setReadMask(com.google.protobuf.FieldMask value) {
      *
      * 
                                                  * Mask specifying which fields to read.
-     * The checksummed_data field and its children will always be present.
-     * If no mask is specified, will default to all fields except metadata.owner
-     * and metadata.acl.
-     * * may be used to mean "all fields".
+     * The `checksummed_data` field and its children are always present.
+     * If no mask is specified, it defaults to all fields except `metadata.
+     * owner` and `metadata.acl`.
+     * `*` might be used to mean "all fields".
      * As per https://google.aip.dev/161, this field is deprecated.
-     * As an alternative, grpc metadata can be used:
-     * https://cloud.google.com/apis/docs/system-parameters#definitions
+     * As an alternative, `grpc metadata` can be used:
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 12 [deprecated = true];
@@ -2226,13 +2219,12 @@ public Builder setReadMask(com.google.protobuf.FieldMask.Builder builderForValue
      *
      * 
                                                  * Mask specifying which fields to read.
-     * The checksummed_data field and its children will always be present.
-     * If no mask is specified, will default to all fields except metadata.owner
-     * and metadata.acl.
-     * * may be used to mean "all fields".
+     * The `checksummed_data` field and its children are always present.
+     * If no mask is specified, it defaults to all fields except `metadata.
+     * owner` and `metadata.acl`.
+     * `*` might be used to mean "all fields".
      * As per https://google.aip.dev/161, this field is deprecated.
-     * As an alternative, grpc metadata can be used:
-     * https://cloud.google.com/apis/docs/system-parameters#definitions
+     * As an alternative, `grpc metadata` can be used:
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 12 [deprecated = true];
@@ -2262,13 +2254,12 @@ public Builder mergeReadMask(com.google.protobuf.FieldMask value) {
      *
      * 
                                                  * Mask specifying which fields to read.
-     * The checksummed_data field and its children will always be present.
-     * If no mask is specified, will default to all fields except metadata.owner
-     * and metadata.acl.
-     * * may be used to mean "all fields".
+     * The `checksummed_data` field and its children are always present.
+     * If no mask is specified, it defaults to all fields except `metadata.
+     * owner` and `metadata.acl`.
+     * `*` might be used to mean "all fields".
      * As per https://google.aip.dev/161, this field is deprecated.
-     * As an alternative, grpc metadata can be used:
-     * https://cloud.google.com/apis/docs/system-parameters#definitions
+     * As an alternative, `grpc metadata` can be used:
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 12 [deprecated = true];
@@ -2290,13 +2281,12 @@ public Builder clearReadMask() {
      *
      * 
                                                  * Mask specifying which fields to read.
-     * The checksummed_data field and its children will always be present.
-     * If no mask is specified, will default to all fields except metadata.owner
-     * and metadata.acl.
-     * * may be used to mean "all fields".
+     * The `checksummed_data` field and its children are always present.
+     * If no mask is specified, it defaults to all fields except `metadata.
+     * owner` and `metadata.acl`.
+     * `*` might be used to mean "all fields".
      * As per https://google.aip.dev/161, this field is deprecated.
-     * As an alternative, grpc metadata can be used:
-     * https://cloud.google.com/apis/docs/system-parameters#definitions
+     * As an alternative, `grpc metadata` can be used:
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 12 [deprecated = true];
@@ -2313,13 +2303,12 @@ public com.google.protobuf.FieldMask.Builder getReadMaskBuilder() {
      *
      * 
                                                  * Mask specifying which fields to read.
-     * The checksummed_data field and its children will always be present.
-     * If no mask is specified, will default to all fields except metadata.owner
-     * and metadata.acl.
-     * * may be used to mean "all fields".
+     * The `checksummed_data` field and its children are always present.
+     * If no mask is specified, it defaults to all fields except `metadata.
+     * owner` and `metadata.acl`.
+     * `*` might be used to mean "all fields".
      * As per https://google.aip.dev/161, this field is deprecated.
-     * As an alternative, grpc metadata can be used:
-     * https://cloud.google.com/apis/docs/system-parameters#definitions
+     * As an alternative, `grpc metadata` can be used:
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 12 [deprecated = true];
@@ -2338,13 +2327,12 @@ public com.google.protobuf.FieldMaskOrBuilder getReadMaskOrBuilder() {
      *
      * 
                                                  * Mask specifying which fields to read.
-     * The checksummed_data field and its children will always be present.
-     * If no mask is specified, will default to all fields except metadata.owner
-     * and metadata.acl.
-     * * may be used to mean "all fields".
+     * The `checksummed_data` field and its children are always present.
+     * If no mask is specified, it defaults to all fields except `metadata.
+     * owner` and `metadata.acl`.
+     * `*` might be used to mean "all fields".
      * As per https://google.aip.dev/161, this field is deprecated.
-     * As an alternative, grpc metadata can be used:
-     * https://cloud.google.com/apis/docs/system-parameters#definitions
+     * As an alternative, `grpc metadata` can be used:
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 12 [deprecated = true];
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectSpecOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectSpecOrBuilder.java
index 6859b67d6d..56673655f0 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectSpecOrBuilder.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectSpecOrBuilder.java
@@ -263,19 +263,18 @@ public interface BidiReadObjectSpecOrBuilder
    *
    * 
                                                * Mask specifying which fields to read.
-   * The checksummed_data field and its children will always be present.
-   * If no mask is specified, will default to all fields except metadata.owner
-   * and metadata.acl.
-   * * may be used to mean "all fields".
+   * The `checksummed_data` field and its children are always present.
+   * If no mask is specified, it defaults to all fields except `metadata.
+   * owner` and `metadata.acl`.
+   * `*` might be used to mean "all fields".
    * As per https://google.aip.dev/161, this field is deprecated.
-   * As an alternative, grpc metadata can be used:
-   * https://cloud.google.com/apis/docs/system-parameters#definitions
+   * As an alternative, `grpc metadata` can be used:
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 12 [deprecated = true];
    *
    * @deprecated google.storage.v2.BidiReadObjectSpec.read_mask is deprecated. See
-   *     google/storage/v2/storage.proto;l=1027
+   *     google/storage/v2/storage.proto;l=1187
    * @return Whether the readMask field is set.
    */
   @java.lang.Deprecated
@@ -286,19 +285,18 @@ public interface BidiReadObjectSpecOrBuilder
    *
    * 
                                                * Mask specifying which fields to read.
-   * The checksummed_data field and its children will always be present.
-   * If no mask is specified, will default to all fields except metadata.owner
-   * and metadata.acl.
-   * * may be used to mean "all fields".
+   * The `checksummed_data` field and its children are always present.
+   * If no mask is specified, it defaults to all fields except `metadata.
+   * owner` and `metadata.acl`.
+   * `*` might be used to mean "all fields".
    * As per https://google.aip.dev/161, this field is deprecated.
-   * As an alternative, grpc metadata can be used:
-   * https://cloud.google.com/apis/docs/system-parameters#definitions
+   * As an alternative, `grpc metadata` can be used:
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 12 [deprecated = true];
    *
    * @deprecated google.storage.v2.BidiReadObjectSpec.read_mask is deprecated. See
-   *     google/storage/v2/storage.proto;l=1027
+   *     google/storage/v2/storage.proto;l=1187
    * @return The readMask.
    */
   @java.lang.Deprecated
@@ -309,13 +307,12 @@ public interface BidiReadObjectSpecOrBuilder
    *
    * 
                                                * Mask specifying which fields to read.
-   * The checksummed_data field and its children will always be present.
-   * If no mask is specified, will default to all fields except metadata.owner
-   * and metadata.acl.
-   * * may be used to mean "all fields".
+   * The `checksummed_data` field and its children are always present.
+   * If no mask is specified, it defaults to all fields except `metadata.
+   * owner` and `metadata.acl`.
+   * `*` might be used to mean "all fields".
    * As per https://google.aip.dev/161, this field is deprecated.
-   * As an alternative, grpc metadata can be used:
-   * https://cloud.google.com/apis/docs/system-parameters#definitions
+   * As an alternative, `grpc metadata` can be used:
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 12 [deprecated = true];
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteHandle.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteHandle.java
index 65e5149c73..e86ed2a824 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteHandle.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteHandle.java
@@ -23,9 +23,9 @@
  *
  *
  * 
                                            - * BidiWriteHandle contains a handle from a previous BidiWriteObject
- * invocation. The client can use this as an optimized way of opening subsequent
- * bidirectional streams to the same object.
+ * `BidiWriteHandle` contains a handle from a previous `BidiWriteObject`
+ * invocation. The client can use this instead of `BidiReadObjectSpec` as an
+ * optimized way of opening subsequent bidirectional streams to the same object.
  * 
                                            
  *
  * Protobuf type {@code google.storage.v2.BidiWriteHandle}
@@ -247,9 +247,9 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
                                            -   * BidiWriteHandle contains a handle from a previous BidiWriteObject
-   * invocation. The client can use this as an optimized way of opening subsequent
-   * bidirectional streams to the same object.
+   * `BidiWriteHandle` contains a handle from a previous `BidiWriteObject`
+   * invocation. The client can use this instead of `BidiReadObjectSpec` as an
+   * optimized way of opening subsequent bidirectional streams to the same object.
    * 
                                            
    *
    * Protobuf type {@code google.storage.v2.BidiWriteHandle}
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectRedirectedError.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectRedirectedError.java
index d785d0a379..9932c5982f 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectRedirectedError.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectRedirectedError.java
@@ -23,7 +23,7 @@
  *
  *
  * 
                                            - * Error proto containing details for a redirected write. This error may be
+ * Error proto containing details for a redirected write. This error might be
  * attached as details for an ABORTED response to BidiWriteObject.
  * 
                                            
  *
@@ -151,7 +151,7 @@ public com.google.protobuf.ByteString getRoutingTokenBytes() {
    * 
                                                * Opaque value describing a previous write. If set, the client must use this
    * in an AppendObjectSpec first_message when retrying the write stream. If not
-   * set, clients may retry the original request.
+   * set, clients might retry the original request.
    * 
                                            
    *
    * optional .google.storage.v2.BidiWriteHandle write_handle = 2;
@@ -169,7 +169,7 @@ public boolean hasWriteHandle() {
    * 
                                                * Opaque value describing a previous write. If set, the client must use this
    * in an AppendObjectSpec first_message when retrying the write stream. If not
-   * set, clients may retry the original request.
+   * set, clients might retry the original request.
    * 
                                            
    *
    * optional .google.storage.v2.BidiWriteHandle write_handle = 2;
@@ -189,7 +189,7 @@ public com.google.storage.v2.BidiWriteHandle getWriteHandle() {
    * 
                                                * Opaque value describing a previous write. If set, the client must use this
    * in an AppendObjectSpec first_message when retrying the write stream. If not
-   * set, clients may retry the original request.
+   * set, clients might retry the original request.
    * 
                                            
    *
    * optional .google.storage.v2.BidiWriteHandle write_handle = 2;
@@ -208,9 +208,9 @@ public com.google.storage.v2.BidiWriteHandleOrBuilder getWriteHandleOrBuilder()
    *
    *
    * 
                                            -   * The generation of the object that triggered the redirect. This will be set
-   * iff write_handle is set. If set, the client must use this in an
-   * AppendObjectSpec first_message when retrying the write stream.
+   * The generation of the object that triggered the redirect. This is set
+   * iff `write_handle` is set. If set, the client must use this in an
+   * `AppendObjectSpec` first_message when retrying the write stream.
    * 
                                            
    *
    * optional int64 generation = 3;
@@ -226,9 +226,9 @@ public boolean hasGeneration() {
    *
    *
    * 
                                            -   * The generation of the object that triggered the redirect. This will be set
-   * iff write_handle is set. If set, the client must use this in an
-   * AppendObjectSpec first_message when retrying the write stream.
+   * The generation of the object that triggered the redirect. This is set
+   * iff `write_handle` is set. If set, the client must use this in an
+   * `AppendObjectSpec` first_message when retrying the write stream.
    * 
                                            
    *
    * optional int64 generation = 3;
@@ -437,7 +437,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
                                            -   * Error proto containing details for a redirected write. This error may be
+   * Error proto containing details for a redirected write. This error might be
    * attached as details for an ABORTED response to BidiWriteObject.
    * 
                                            
    *
@@ -813,7 +813,7 @@ public Builder setRoutingTokenBytes(com.google.protobuf.ByteString value) {
      * 
                                                  * Opaque value describing a previous write. If set, the client must use this
      * in an AppendObjectSpec first_message when retrying the write stream. If not
-     * set, clients may retry the original request.
+     * set, clients might retry the original request.
      * 
                                            
      *
      * optional .google.storage.v2.BidiWriteHandle write_handle = 2;
@@ -830,7 +830,7 @@ public boolean hasWriteHandle() {
      * 
                                                  * Opaque value describing a previous write. If set, the client must use this
      * in an AppendObjectSpec first_message when retrying the write stream. If not
-     * set, clients may retry the original request.
+     * set, clients might retry the original request.
      * 
                                            
      *
      * optional .google.storage.v2.BidiWriteHandle write_handle = 2;
@@ -853,7 +853,7 @@ public com.google.storage.v2.BidiWriteHandle getWriteHandle() {
      * 
                                                  * Opaque value describing a previous write. If set, the client must use this
      * in an AppendObjectSpec first_message when retrying the write stream. If not
-     * set, clients may retry the original request.
+     * set, clients might retry the original request.
      * 
                                            
      *
      * optional .google.storage.v2.BidiWriteHandle write_handle = 2;
@@ -878,7 +878,7 @@ public Builder setWriteHandle(com.google.storage.v2.BidiWriteHandle value) {
      * 
                                                  * Opaque value describing a previous write. If set, the client must use this
      * in an AppendObjectSpec first_message when retrying the write stream. If not
-     * set, clients may retry the original request.
+     * set, clients might retry the original request.
      * 
                                            
      *
      * optional .google.storage.v2.BidiWriteHandle write_handle = 2;
@@ -900,7 +900,7 @@ public Builder setWriteHandle(com.google.storage.v2.BidiWriteHandle.Builder buil
      * 
                                                  * Opaque value describing a previous write. If set, the client must use this
      * in an AppendObjectSpec first_message when retrying the write stream. If not
-     * set, clients may retry the original request.
+     * set, clients might retry the original request.
      * 
                                            
      *
      * optional .google.storage.v2.BidiWriteHandle write_handle = 2;
@@ -930,7 +930,7 @@ public Builder mergeWriteHandle(com.google.storage.v2.BidiWriteHandle value) {
      * 
                                                  * Opaque value describing a previous write. If set, the client must use this
      * in an AppendObjectSpec first_message when retrying the write stream. If not
-     * set, clients may retry the original request.
+     * set, clients might retry the original request.
      * 
                                            
      *
      * optional .google.storage.v2.BidiWriteHandle write_handle = 2;
@@ -952,7 +952,7 @@ public Builder clearWriteHandle() {
      * 
                                                  * Opaque value describing a previous write. If set, the client must use this
      * in an AppendObjectSpec first_message when retrying the write stream. If not
-     * set, clients may retry the original request.
+     * set, clients might retry the original request.
      * 
                                            
      *
      * optional .google.storage.v2.BidiWriteHandle write_handle = 2;
@@ -969,7 +969,7 @@ public com.google.storage.v2.BidiWriteHandle.Builder getWriteHandleBuilder() {
      * 
                                                  * Opaque value describing a previous write. If set, the client must use this
      * in an AppendObjectSpec first_message when retrying the write stream. If not
-     * set, clients may retry the original request.
+     * set, clients might retry the original request.
      * 
                                            
      *
      * optional .google.storage.v2.BidiWriteHandle write_handle = 2;
@@ -990,7 +990,7 @@ public com.google.storage.v2.BidiWriteHandleOrBuilder getWriteHandleOrBuilder()
      * 
                                                  * Opaque value describing a previous write. If set, the client must use this
      * in an AppendObjectSpec first_message when retrying the write stream. If not
-     * set, clients may retry the original request.
+     * set, clients might retry the original request.
      * 
                                            
      *
      * optional .google.storage.v2.BidiWriteHandle write_handle = 2;
@@ -1018,9 +1018,9 @@ public com.google.storage.v2.BidiWriteHandleOrBuilder getWriteHandleOrBuilder()
      *
      *
      * 
                                            -     * The generation of the object that triggered the redirect. This will be set
-     * iff write_handle is set. If set, the client must use this in an
-     * AppendObjectSpec first_message when retrying the write stream.
+     * The generation of the object that triggered the redirect. This is set
+     * iff `write_handle` is set. If set, the client must use this in an
+     * `AppendObjectSpec` first_message when retrying the write stream.
      * 
                                            
      *
      * optional int64 generation = 3;
@@ -1036,9 +1036,9 @@ public boolean hasGeneration() {
      *
      *
      * 
                                            -     * The generation of the object that triggered the redirect. This will be set
-     * iff write_handle is set. If set, the client must use this in an
-     * AppendObjectSpec first_message when retrying the write stream.
+     * The generation of the object that triggered the redirect. This is set
+     * iff `write_handle` is set. If set, the client must use this in an
+     * `AppendObjectSpec` first_message when retrying the write stream.
      * 
                                            
      *
      * optional int64 generation = 3;
@@ -1054,9 +1054,9 @@ public long getGeneration() {
      *
      *
      * 
                                            -     * The generation of the object that triggered the redirect. This will be set
-     * iff write_handle is set. If set, the client must use this in an
-     * AppendObjectSpec first_message when retrying the write stream.
+     * The generation of the object that triggered the redirect. This is set
+     * iff `write_handle` is set. If set, the client must use this in an
+     * `AppendObjectSpec` first_message when retrying the write stream.
      * 
                                            
      *
      * optional int64 generation = 3;
@@ -1076,9 +1076,9 @@ public Builder setGeneration(long value) {
      *
      *
      * 
                                            -     * The generation of the object that triggered the redirect. This will be set
-     * iff write_handle is set. If set, the client must use this in an
-     * AppendObjectSpec first_message when retrying the write stream.
+     * The generation of the object that triggered the redirect. This is set
+     * iff `write_handle` is set. If set, the client must use this in an
+     * `AppendObjectSpec` first_message when retrying the write stream.
      * 
                                            
      *
      * optional int64 generation = 3;
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectRedirectedErrorOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectRedirectedErrorOrBuilder.java
index 82f32c15df..beaef65e1e 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectRedirectedErrorOrBuilder.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectRedirectedErrorOrBuilder.java
@@ -75,7 +75,7 @@ public interface BidiWriteObjectRedirectedErrorOrBuilder
    * 
                                                * Opaque value describing a previous write. If set, the client must use this
    * in an AppendObjectSpec first_message when retrying the write stream. If not
-   * set, clients may retry the original request.
+   * set, clients might retry the original request.
    * 
                                            
    *
    * optional .google.storage.v2.BidiWriteHandle write_handle = 2;
@@ -90,7 +90,7 @@ public interface BidiWriteObjectRedirectedErrorOrBuilder
    * 
                                                * Opaque value describing a previous write. If set, the client must use this
    * in an AppendObjectSpec first_message when retrying the write stream. If not
-   * set, clients may retry the original request.
+   * set, clients might retry the original request.
    * 
                                            
    *
    * optional .google.storage.v2.BidiWriteHandle write_handle = 2;
@@ -105,7 +105,7 @@ public interface BidiWriteObjectRedirectedErrorOrBuilder
    * 
                                                * Opaque value describing a previous write. If set, the client must use this
    * in an AppendObjectSpec first_message when retrying the write stream. If not
-   * set, clients may retry the original request.
+   * set, clients might retry the original request.
    * 
                                            
    *
    * optional .google.storage.v2.BidiWriteHandle write_handle = 2;
@@ -116,9 +116,9 @@ public interface BidiWriteObjectRedirectedErrorOrBuilder
    *
    *
    * 
                                            -   * The generation of the object that triggered the redirect. This will be set
-   * iff write_handle is set. If set, the client must use this in an
-   * AppendObjectSpec first_message when retrying the write stream.
+   * The generation of the object that triggered the redirect. This is set
+   * iff `write_handle` is set. If set, the client must use this in an
+   * `AppendObjectSpec` first_message when retrying the write stream.
    * 
                                            
    *
    * optional int64 generation = 3;
@@ -131,9 +131,9 @@ public interface BidiWriteObjectRedirectedErrorOrBuilder
    *
    *
    * 
                                            -   * The generation of the object that triggered the redirect. This will be set
-   * iff write_handle is set. If set, the client must use this in an
-   * AppendObjectSpec first_message when retrying the write stream.
+   * The generation of the object that triggered the redirect. This is set
+   * iff `write_handle` is set. If set, the client must use this in an
+   * `AppendObjectSpec` first_message when retrying the write stream.
    * 
                                            
    *
    * optional int64 generation = 3;
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectRequest.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectRequest.java
index 87a4ad4257..18c12adff4 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectRequest.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectRequest.java
@@ -23,7 +23,8 @@
  *
  *
  * 
                                            - * Request message for BidiWriteObject.
+ * Request message for
+ * [BidiWriteObject][google.storage.v2.Storage.BidiWriteObject].
  * 
                                            
  *
  * Protobuf type {@code google.storage.v2.BidiWriteObjectRequest}
@@ -361,15 +362,15 @@ public com.google.storage.v2.AppendObjectSpecOrBuilder getAppendObjectSpecOrBuil
    * should be written.
    *
    * In the first `WriteObjectRequest` of a `WriteObject()` action, it
-   * indicates the initial offset for the `Write()` call. The value **must** be
+   * indicates the initial offset for the `Write()` call. The value must be
    * equal to the `persisted_size` that a call to `QueryWriteStatus()` would
    * return (0 if this is the first write to the object).
    *
-   * On subsequent calls, this value **must** be no larger than the sum of the
+   * On subsequent calls, this value must be no larger than the sum of the
    * first `write_offset` and the sizes of all `data` chunks sent previously on
    * this stream.
    *
-   * An invalid value will cause an error.
+   * An invalid value causes an error.
    * 
                                            
    *
    * int64 write_offset = 3 [(.google.api.field_behavior) = REQUIRED];
@@ -388,7 +389,7 @@ public long getWriteOffset() {
    *
    * 
                                                * The data to insert. If a crc32c checksum is provided that doesn't match
-   * the checksum computed by the service, the request will fail.
+   * the checksum computed by the service, the request fails.
    * 
                                            
    *
    * .google.storage.v2.ChecksummedData checksummed_data = 4;
@@ -405,7 +406,7 @@ public boolean hasChecksummedData() {
    *
    * 
                                                * The data to insert. If a crc32c checksum is provided that doesn't match
-   * the checksum computed by the service, the request will fail.
+   * the checksum computed by the service, the request fails.
    * 
                                            
    *
    * .google.storage.v2.ChecksummedData checksummed_data = 4;
@@ -425,7 +426,7 @@ public com.google.storage.v2.ChecksummedData getChecksummedData() {
    *
    * 
                                                * The data to insert. If a crc32c checksum is provided that doesn't match
-   * the checksum computed by the service, the request will fail.
+   * the checksum computed by the service, the request fails.
    * 
                                            
    *
    * .google.storage.v2.ChecksummedData checksummed_data = 4;
@@ -446,9 +447,9 @@ public com.google.storage.v2.ChecksummedDataOrBuilder getChecksummedDataOrBuilde
    *
    * 
                                                * Optional. Checksums for the complete object. If the checksums computed by
-   * the service don't match the specified checksums the call will fail. May
-   * only be provided in the first request or the last request (with
-   * finish_write set).
+   * the service don't match the specified checksums the call fails. Might only
+   * be provided in the first request or the last request (with finish_write
+   * set).
    * 
                                            
    *
    * 
@@ -467,9 +468,9 @@ public boolean hasObjectChecksums() {
    *
    * 
                                                * Optional. Checksums for the complete object. If the checksums computed by
-   * the service don't match the specified checksums the call will fail. May
-   * only be provided in the first request or the last request (with
-   * finish_write set).
+   * the service don't match the specified checksums the call fails. Might only
+   * be provided in the first request or the last request (with finish_write
+   * set).
    * 
                                            
    *
    * 
@@ -490,9 +491,9 @@ public com.google.storage.v2.ObjectChecksums getObjectChecksums() {
    *
    * 
                                                * Optional. Checksums for the complete object. If the checksums computed by
-   * the service don't match the specified checksums the call will fail. May
-   * only be provided in the first request or the last request (with
-   * finish_write set).
+   * the service don't match the specified checksums the call fails. Might only
+   * be provided in the first request or the last request (with finish_write
+   * set).
    * 
                                            
    *
    * 
@@ -513,14 +514,14 @@ public com.google.storage.v2.ObjectChecksumsOrBuilder getObjectChecksumsOrBuilde
    *
    *
    * 
                                            -   * Optional. For each BidiWriteObjectRequest where state_lookup is `true` or
-   * the client closes the stream, the service will send a
-   * BidiWriteObjectResponse containing the current persisted size. The
+   * Optional. For each `BidiWriteObjectRequest` where `state_lookup` is `true`
+   * or the client closes the stream, the service sends a
+   * `BidiWriteObjectResponse` containing the current persisted size. The
    * persisted size sent in responses covers all the bytes the server has
    * persisted thus far and can be used to decide what data is safe for the
    * client to drop. Note that the object's current size reported by the
-   * BidiWriteObjectResponse may lag behind the number of bytes written by the
-   * client. This field is ignored if `finish_write` is set to true.
+   * `BidiWriteObjectResponse` might lag behind the number of bytes written by
+   * the client. This field is ignored if `finish_write` is set to true.
    * 
                                            
    *
    * bool state_lookup = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -541,7 +542,7 @@ public boolean getStateLookup() {
    * 
                                                * Optional. Persists data written on the stream, up to and including the
    * current message, to permanent storage. This option should be used sparingly
-   * as it may reduce performance. Ongoing writes will periodically be persisted
+   * as it might reduce performance. Ongoing writes are periodically persisted
    * on the server even when `flush` is not set. This field is ignored if
    * `finish_write` is set to true since there's no need to checkpoint or flush
    * if this message completes the write.
@@ -565,8 +566,8 @@ public boolean getFlush() {
    * 
                                                * Optional. If `true`, this indicates that the write is complete. Sending any
    * `WriteObjectRequest`s subsequent to one in which `finish_write` is `true`
-   * will cause an error.
-   * For a non-resumable write (where the upload_id was not set in the first
+   * causes an error.
+   * For a non-resumable write (where the `upload_id` was not set in the first
    * message), it is an error not to set this field in the final message of the
    * stream.
    * 
                                            
@@ -941,7 +942,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
                                            -   * Request message for BidiWriteObject.
+   * Request message for
+   * [BidiWriteObject][google.storage.v2.Storage.BidiWriteObject].
    * 
                                            
    *
    * Protobuf type {@code google.storage.v2.BidiWriteObjectRequest}
@@ -1927,15 +1929,15 @@ public com.google.storage.v2.AppendObjectSpecOrBuilder getAppendObjectSpecOrBuil
      * should be written.
      *
      * In the first `WriteObjectRequest` of a `WriteObject()` action, it
-     * indicates the initial offset for the `Write()` call. The value **must** be
+     * indicates the initial offset for the `Write()` call. The value must be
      * equal to the `persisted_size` that a call to `QueryWriteStatus()` would
      * return (0 if this is the first write to the object).
      *
-     * On subsequent calls, this value **must** be no larger than the sum of the
+     * On subsequent calls, this value must be no larger than the sum of the
      * first `write_offset` and the sizes of all `data` chunks sent previously on
      * this stream.
      *
-     * An invalid value will cause an error.
+     * An invalid value causes an error.
      * 
                                            
      *
      * int64 write_offset = 3 [(.google.api.field_behavior) = REQUIRED];
@@ -1955,15 +1957,15 @@ public long getWriteOffset() {
      * should be written.
      *
      * In the first `WriteObjectRequest` of a `WriteObject()` action, it
-     * indicates the initial offset for the `Write()` call. The value **must** be
+     * indicates the initial offset for the `Write()` call. The value must be
      * equal to the `persisted_size` that a call to `QueryWriteStatus()` would
      * return (0 if this is the first write to the object).
      *
-     * On subsequent calls, this value **must** be no larger than the sum of the
+     * On subsequent calls, this value must be no larger than the sum of the
      * first `write_offset` and the sizes of all `data` chunks sent previously on
      * this stream.
      *
-     * An invalid value will cause an error.
+     * An invalid value causes an error.
      * 
                                            
      *
      * int64 write_offset = 3 [(.google.api.field_behavior) = REQUIRED];
@@ -1987,15 +1989,15 @@ public Builder setWriteOffset(long value) {
      * should be written.
      *
      * In the first `WriteObjectRequest` of a `WriteObject()` action, it
-     * indicates the initial offset for the `Write()` call. The value **must** be
+     * indicates the initial offset for the `Write()` call. The value must be
      * equal to the `persisted_size` that a call to `QueryWriteStatus()` would
      * return (0 if this is the first write to the object).
      *
-     * On subsequent calls, this value **must** be no larger than the sum of the
+     * On subsequent calls, this value must be no larger than the sum of the
      * first `write_offset` and the sizes of all `data` chunks sent previously on
      * this stream.
      *
-     * An invalid value will cause an error.
+     * An invalid value causes an error.
      *
                                            * * int64 write_offset = 3 [(.google.api.field_behavior) = REQUIRED]; @@ -2020,7 +2022,7 @@ public Builder clearWriteOffset() { * * 
                                                  * The data to insert. If a crc32c checksum is provided that doesn't match
-     * the checksum computed by the service, the request will fail.
+     * the checksum computed by the service, the request fails.
      *
                                            * * .google.storage.v2.ChecksummedData checksummed_data = 4; @@ -2037,7 +2039,7 @@ public boolean hasChecksummedData() { * * 
                                                  * The data to insert. If a crc32c checksum is provided that doesn't match
-     * the checksum computed by the service, the request will fail.
+     * the checksum computed by the service, the request fails.
      *
                                            * * .google.storage.v2.ChecksummedData checksummed_data = 4; @@ -2064,7 +2066,7 @@ public com.google.storage.v2.ChecksummedData getChecksummedData() { * * 
                                                  * The data to insert. If a crc32c checksum is provided that doesn't match
-     * the checksum computed by the service, the request will fail.
+     * the checksum computed by the service, the request fails.
      *
                                            * * .google.storage.v2.ChecksummedData checksummed_data = 4; @@ -2088,7 +2090,7 @@ public Builder setChecksummedData(com.google.storage.v2.ChecksummedData value) { * * 
                                                  * The data to insert. If a crc32c checksum is provided that doesn't match
-     * the checksum computed by the service, the request will fail.
+     * the checksum computed by the service, the request fails.
      *
                                            * * .google.storage.v2.ChecksummedData checksummed_data = 4; @@ -2110,7 +2112,7 @@ public Builder setChecksummedData( * * 
                                                  * The data to insert. If a crc32c checksum is provided that doesn't match
-     * the checksum computed by the service, the request will fail.
+     * the checksum computed by the service, the request fails.
      *
                                            * * .google.storage.v2.ChecksummedData checksummed_data = 4; @@ -2143,7 +2145,7 @@ public Builder mergeChecksummedData(com.google.storage.v2.ChecksummedData value) * * 
                                                  * The data to insert. If a crc32c checksum is provided that doesn't match
-     * the checksum computed by the service, the request will fail.
+     * the checksum computed by the service, the request fails.
      *
                                            * * .google.storage.v2.ChecksummedData checksummed_data = 4; @@ -2170,7 +2172,7 @@ public Builder clearChecksummedData() { * * 
                                                  * The data to insert. If a crc32c checksum is provided that doesn't match
-     * the checksum computed by the service, the request will fail.
+     * the checksum computed by the service, the request fails.
      *
                                            * * .google.storage.v2.ChecksummedData checksummed_data = 4; @@ -2184,7 +2186,7 @@ public com.google.storage.v2.ChecksummedData.Builder getChecksummedDataBuilder() * * 
                                                  * The data to insert. If a crc32c checksum is provided that doesn't match
-     * the checksum computed by the service, the request will fail.
+     * the checksum computed by the service, the request fails.
      *
                                            * * .google.storage.v2.ChecksummedData checksummed_data = 4; @@ -2206,7 +2208,7 @@ public com.google.storage.v2.ChecksummedDataOrBuilder getChecksummedDataOrBuilde * * 
                                                  * The data to insert. If a crc32c checksum is provided that doesn't match
-     * the checksum computed by the service, the request will fail.
+     * the checksum computed by the service, the request fails.
      *
                                            * * .google.storage.v2.ChecksummedData checksummed_data = 4; @@ -2245,9 +2247,9 @@ public com.google.storage.v2.ChecksummedDataOrBuilder getChecksummedDataOrBuilde * * 
                                                  * Optional. Checksums for the complete object. If the checksums computed by
-     * the service don't match the specified checksums the call will fail. May
-     * only be provided in the first request or the last request (with
-     * finish_write set).
+     * the service don't match the specified checksums the call fails. Might only
+     * be provided in the first request or the last request (with finish_write
+     * set).
      *
                                            * * @@ -2265,9 +2267,9 @@ public boolean hasObjectChecksums() { * * 
                                                  * Optional. Checksums for the complete object. If the checksums computed by
-     * the service don't match the specified checksums the call will fail. May
-     * only be provided in the first request or the last request (with
-     * finish_write set).
+     * the service don't match the specified checksums the call fails. Might only
+     * be provided in the first request or the last request (with finish_write
+     * set).
      *
                                            * * @@ -2291,9 +2293,9 @@ public com.google.storage.v2.ObjectChecksums getObjectChecksums() { * * 
                                                  * Optional. Checksums for the complete object. If the checksums computed by
-     * the service don't match the specified checksums the call will fail. May
-     * only be provided in the first request or the last request (with
-     * finish_write set).
+     * the service don't match the specified checksums the call fails. Might only
+     * be provided in the first request or the last request (with finish_write
+     * set).
      *
                                            * * @@ -2319,9 +2321,9 @@ public Builder setObjectChecksums(com.google.storage.v2.ObjectChecksums value) { * * 
                                                  * Optional. Checksums for the complete object. If the checksums computed by
-     * the service don't match the specified checksums the call will fail. May
-     * only be provided in the first request or the last request (with
-     * finish_write set).
+     * the service don't match the specified checksums the call fails. Might only
+     * be provided in the first request or the last request (with finish_write
+     * set).
      *
                                            * * @@ -2345,9 +2347,9 @@ public Builder setObjectChecksums( * * 
                                                  * Optional. Checksums for the complete object. If the checksums computed by
-     * the service don't match the specified checksums the call will fail. May
-     * only be provided in the first request or the last request (with
-     * finish_write set).
+     * the service don't match the specified checksums the call fails. Might only
+     * be provided in the first request or the last request (with finish_write
+     * set).
      *
                                            * * @@ -2378,9 +2380,9 @@ public Builder mergeObjectChecksums(com.google.storage.v2.ObjectChecksums value) * * 
                                                  * Optional. Checksums for the complete object. If the checksums computed by
-     * the service don't match the specified checksums the call will fail. May
-     * only be provided in the first request or the last request (with
-     * finish_write set).
+     * the service don't match the specified checksums the call fails. Might only
+     * be provided in the first request or the last request (with finish_write
+     * set).
      *
                                            * * @@ -2403,9 +2405,9 @@ public Builder clearObjectChecksums() { * * 
                                                  * Optional. Checksums for the complete object. If the checksums computed by
-     * the service don't match the specified checksums the call will fail. May
-     * only be provided in the first request or the last request (with
-     * finish_write set).
+     * the service don't match the specified checksums the call fails. Might only
+     * be provided in the first request or the last request (with finish_write
+     * set).
      *
                                            * * @@ -2423,9 +2425,9 @@ public com.google.storage.v2.ObjectChecksums.Builder getObjectChecksumsBuilder() * * 
                                                  * Optional. Checksums for the complete object. If the checksums computed by
-     * the service don't match the specified checksums the call will fail. May
-     * only be provided in the first request or the last request (with
-     * finish_write set).
+     * the service don't match the specified checksums the call fails. Might only
+     * be provided in the first request or the last request (with finish_write
+     * set).
      *
                                            * * @@ -2447,9 +2449,9 @@ public com.google.storage.v2.ObjectChecksumsOrBuilder getObjectChecksumsOrBuilde * * 
                                                  * Optional. Checksums for the complete object. If the checksums computed by
-     * the service don't match the specified checksums the call will fail. May
-     * only be provided in the first request or the last request (with
-     * finish_write set).
+     * the service don't match the specified checksums the call fails. Might only
+     * be provided in the first request or the last request (with finish_write
+     * set).
      *
                                            * * @@ -2479,14 +2481,14 @@ public com.google.storage.v2.ObjectChecksumsOrBuilder getObjectChecksumsOrBuilde * * * 
                                            -     * Optional. For each BidiWriteObjectRequest where state_lookup is `true` or
-     * the client closes the stream, the service will send a
-     * BidiWriteObjectResponse containing the current persisted size. The
+     * Optional. For each `BidiWriteObjectRequest` where `state_lookup` is `true`
+     * or the client closes the stream, the service sends a
+     * `BidiWriteObjectResponse` containing the current persisted size. The
      * persisted size sent in responses covers all the bytes the server has
      * persisted thus far and can be used to decide what data is safe for the
      * client to drop. Note that the object's current size reported by the
-     * BidiWriteObjectResponse may lag behind the number of bytes written by the
-     * client. This field is ignored if `finish_write` is set to true.
+     * `BidiWriteObjectResponse` might lag behind the number of bytes written by
+     * the client. This field is ignored if `finish_write` is set to true.
      *
                                            * * bool state_lookup = 7 [(.google.api.field_behavior) = OPTIONAL]; @@ -2502,14 +2504,14 @@ public boolean getStateLookup() { * * * 
                                            -     * Optional. For each BidiWriteObjectRequest where state_lookup is `true` or
-     * the client closes the stream, the service will send a
-     * BidiWriteObjectResponse containing the current persisted size. The
+     * Optional. For each `BidiWriteObjectRequest` where `state_lookup` is `true`
+     * or the client closes the stream, the service sends a
+     * `BidiWriteObjectResponse` containing the current persisted size. The
      * persisted size sent in responses covers all the bytes the server has
      * persisted thus far and can be used to decide what data is safe for the
      * client to drop. Note that the object's current size reported by the
-     * BidiWriteObjectResponse may lag behind the number of bytes written by the
-     * client. This field is ignored if `finish_write` is set to true.
+     * `BidiWriteObjectResponse` might lag behind the number of bytes written by
+     * the client. This field is ignored if `finish_write` is set to true.
      *
                                            * * bool state_lookup = 7 [(.google.api.field_behavior) = OPTIONAL]; @@ -2529,14 +2531,14 @@ public Builder setStateLookup(boolean value) { * * * 
                                            -     * Optional. For each BidiWriteObjectRequest where state_lookup is `true` or
-     * the client closes the stream, the service will send a
-     * BidiWriteObjectResponse containing the current persisted size. The
+     * Optional. For each `BidiWriteObjectRequest` where `state_lookup` is `true`
+     * or the client closes the stream, the service sends a
+     * `BidiWriteObjectResponse` containing the current persisted size. The
      * persisted size sent in responses covers all the bytes the server has
      * persisted thus far and can be used to decide what data is safe for the
      * client to drop. Note that the object's current size reported by the
-     * BidiWriteObjectResponse may lag behind the number of bytes written by the
-     * client. This field is ignored if `finish_write` is set to true.
+     * `BidiWriteObjectResponse` might lag behind the number of bytes written by
+     * the client. This field is ignored if `finish_write` is set to true.
      *
                                            * * bool state_lookup = 7 [(.google.api.field_behavior) = OPTIONAL]; @@ -2558,7 +2560,7 @@ public Builder clearStateLookup() { * 
                                                  * Optional. Persists data written on the stream, up to and including the
      * current message, to permanent storage. This option should be used sparingly
-     * as it may reduce performance. Ongoing writes will periodically be persisted
+     * as it might reduce performance. Ongoing writes are periodically persisted
      * on the server even when `flush` is not set. This field is ignored if
      * `finish_write` is set to true since there's no need to checkpoint or flush
      * if this message completes the write.
@@ -2579,7 +2581,7 @@ public boolean getFlush() {
      * 
                                                  * Optional. Persists data written on the stream, up to and including the
      * current message, to permanent storage. This option should be used sparingly
-     * as it may reduce performance. Ongoing writes will periodically be persisted
+     * as it might reduce performance. Ongoing writes are periodically persisted
      * on the server even when `flush` is not set. This field is ignored if
      * `finish_write` is set to true since there's no need to checkpoint or flush
      * if this message completes the write.
@@ -2604,7 +2606,7 @@ public Builder setFlush(boolean value) {
      * 
                                                  * Optional. Persists data written on the stream, up to and including the
      * current message, to permanent storage. This option should be used sparingly
-     * as it may reduce performance. Ongoing writes will periodically be persisted
+     * as it might reduce performance. Ongoing writes are periodically persisted
      * on the server even when `flush` is not set. This field is ignored if
      * `finish_write` is set to true since there's no need to checkpoint or flush
      * if this message completes the write.
@@ -2629,8 +2631,8 @@ public Builder clearFlush() {
      * 
                                                  * Optional. If `true`, this indicates that the write is complete. Sending any
      * `WriteObjectRequest`s subsequent to one in which `finish_write` is `true`
-     * will cause an error.
-     * For a non-resumable write (where the upload_id was not set in the first
+     * causes an error.
+     * For a non-resumable write (where the `upload_id` was not set in the first
      * message), it is an error not to set this field in the final message of the
      * stream.
      * 
                                            
@@ -2650,8 +2652,8 @@ public boolean getFinishWrite() {
      * 
                                                  * Optional. If `true`, this indicates that the write is complete. Sending any
      * `WriteObjectRequest`s subsequent to one in which `finish_write` is `true`
-     * will cause an error.
-     * For a non-resumable write (where the upload_id was not set in the first
+     * causes an error.
+     * For a non-resumable write (where the `upload_id` was not set in the first
      * message), it is an error not to set this field in the final message of the
      * stream.
      * 
                                            
@@ -2675,8 +2677,8 @@ public Builder setFinishWrite(boolean value) {
      * 
                                                  * Optional. If `true`, this indicates that the write is complete. Sending any
      * `WriteObjectRequest`s subsequent to one in which `finish_write` is `true`
-     * will cause an error.
-     * For a non-resumable write (where the upload_id was not set in the first
+     * causes an error.
+     * For a non-resumable write (where the `upload_id` was not set in the first
      * message), it is an error not to set this field in the final message of the
      * stream.
      * 
                                            
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectRequestOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectRequestOrBuilder.java
index adb098818e..4224583eb9 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectRequestOrBuilder.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectRequestOrBuilder.java
@@ -151,15 +151,15 @@ public interface BidiWriteObjectRequestOrBuilder
    * should be written.
    *
    * In the first `WriteObjectRequest` of a `WriteObject()` action, it
-   * indicates the initial offset for the `Write()` call. The value **must** be
+   * indicates the initial offset for the `Write()` call. The value must be
    * equal to the `persisted_size` that a call to `QueryWriteStatus()` would
    * return (0 if this is the first write to the object).
    *
-   * On subsequent calls, this value **must** be no larger than the sum of the
+   * On subsequent calls, this value must be no larger than the sum of the
    * first `write_offset` and the sizes of all `data` chunks sent previously on
    * this stream.
    *
-   * An invalid value will cause an error.
+   * An invalid value causes an error.
    * 
                                            
    *
    * int64 write_offset = 3 [(.google.api.field_behavior) = REQUIRED];
@@ -173,7 +173,7 @@ public interface BidiWriteObjectRequestOrBuilder
    *
    * 
                                                * The data to insert. If a crc32c checksum is provided that doesn't match
-   * the checksum computed by the service, the request will fail.
+   * the checksum computed by the service, the request fails.
    * 
                                            
    *
    * .google.storage.v2.ChecksummedData checksummed_data = 4;
@@ -187,7 +187,7 @@ public interface BidiWriteObjectRequestOrBuilder
    *
    * 
                                                * The data to insert. If a crc32c checksum is provided that doesn't match
-   * the checksum computed by the service, the request will fail.
+   * the checksum computed by the service, the request fails.
    * 
                                            
    *
    * .google.storage.v2.ChecksummedData checksummed_data = 4;
@@ -201,7 +201,7 @@ public interface BidiWriteObjectRequestOrBuilder
    *
    * 
                                                * The data to insert. If a crc32c checksum is provided that doesn't match
-   * the checksum computed by the service, the request will fail.
+   * the checksum computed by the service, the request fails.
    * 
                                            
    *
    * .google.storage.v2.ChecksummedData checksummed_data = 4;
@@ -213,9 +213,9 @@ public interface BidiWriteObjectRequestOrBuilder
    *
    * 
                                                * Optional. Checksums for the complete object. If the checksums computed by
-   * the service don't match the specified checksums the call will fail. May
-   * only be provided in the first request or the last request (with
-   * finish_write set).
+   * the service don't match the specified checksums the call fails. Might only
+   * be provided in the first request or the last request (with finish_write
+   * set).
    * 
                                            
    *
    * 
@@ -231,9 +231,9 @@ public interface BidiWriteObjectRequestOrBuilder
    *
    * 
                                                * Optional. Checksums for the complete object. If the checksums computed by
-   * the service don't match the specified checksums the call will fail. May
-   * only be provided in the first request or the last request (with
-   * finish_write set).
+   * the service don't match the specified checksums the call fails. Might only
+   * be provided in the first request or the last request (with finish_write
+   * set).
    * 
                                            
    *
    * 
@@ -249,9 +249,9 @@ public interface BidiWriteObjectRequestOrBuilder
    *
    * 
                                                * Optional. Checksums for the complete object. If the checksums computed by
-   * the service don't match the specified checksums the call will fail. May
-   * only be provided in the first request or the last request (with
-   * finish_write set).
+   * the service don't match the specified checksums the call fails. Might only
+   * be provided in the first request or the last request (with finish_write
+   * set).
    * 
                                            
    *
    * 
@@ -264,14 +264,14 @@ public interface BidiWriteObjectRequestOrBuilder
    *
    *
    * 
                                            -   * Optional. For each BidiWriteObjectRequest where state_lookup is `true` or
-   * the client closes the stream, the service will send a
-   * BidiWriteObjectResponse containing the current persisted size. The
+   * Optional. For each `BidiWriteObjectRequest` where `state_lookup` is `true`
+   * or the client closes the stream, the service sends a
+   * `BidiWriteObjectResponse` containing the current persisted size. The
    * persisted size sent in responses covers all the bytes the server has
    * persisted thus far and can be used to decide what data is safe for the
    * client to drop. Note that the object's current size reported by the
-   * BidiWriteObjectResponse may lag behind the number of bytes written by the
-   * client. This field is ignored if `finish_write` is set to true.
+   * `BidiWriteObjectResponse` might lag behind the number of bytes written by
+   * the client. This field is ignored if `finish_write` is set to true.
    * 
                                            
    *
    * bool state_lookup = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -286,7 +286,7 @@ public interface BidiWriteObjectRequestOrBuilder
    * 
                                                * Optional. Persists data written on the stream, up to and including the
    * current message, to permanent storage. This option should be used sparingly
-   * as it may reduce performance. Ongoing writes will periodically be persisted
+   * as it might reduce performance. Ongoing writes are periodically persisted
    * on the server even when `flush` is not set. This field is ignored if
    * `finish_write` is set to true since there's no need to checkpoint or flush
    * if this message completes the write.
@@ -304,8 +304,8 @@ public interface BidiWriteObjectRequestOrBuilder
    * 
                                                * Optional. If `true`, this indicates that the write is complete. Sending any
    * `WriteObjectRequest`s subsequent to one in which `finish_write` is `true`
-   * will cause an error.
-   * For a non-resumable write (where the upload_id was not set in the first
+   * causes an error.
+   * For a non-resumable write (where the `upload_id` was not set in the first
    * message), it is an error not to set this field in the final message of the
    * stream.
    * 
                                            
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectResponse.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectResponse.java
index e1f30195fe..20f5aac8e4 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectResponse.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectResponse.java
@@ -216,7 +216,7 @@ public com.google.storage.v2.ObjectOrBuilder getResourceOrBuilder() {
    *
    *
    * 
                                            -   * An optional write handle that will periodically be present in response
+   * An optional write handle that is returned periodically in response
    * messages. Clients should save it for later use in establishing a new stream
    * if a connection is interrupted.
    * 
                                            
@@ -234,7 +234,7 @@ public boolean hasWriteHandle() {
    *
    *
    * 
                                            -   * An optional write handle that will periodically be present in response
+   * An optional write handle that is returned periodically in response
    * messages. Clients should save it for later use in establishing a new stream
    * if a connection is interrupted.
    * 
                                            
@@ -254,7 +254,7 @@ public com.google.storage.v2.BidiWriteHandle getWriteHandle() {
    *
    *
    * 
                                            -   * An optional write handle that will periodically be present in response
+   * An optional write handle that is returned periodically in response
    * messages. Clients should save it for later use in establishing a new stream
    * if a connection is interrupted.
    * 
                                            
@@ -1036,7 +1036,7 @@ public com.google.storage.v2.ObjectOrBuilder getResourceOrBuilder() {
      *
      *
      * 
                                            -     * An optional write handle that will periodically be present in response
+     * An optional write handle that is returned periodically in response
      * messages. Clients should save it for later use in establishing a new stream
      * if a connection is interrupted.
      * 
                                            
@@ -1053,7 +1053,7 @@ public boolean hasWriteHandle() {
      *
      *
      * 
                                            -     * An optional write handle that will periodically be present in response
+     * An optional write handle that is returned periodically in response
      * messages. Clients should save it for later use in establishing a new stream
      * if a connection is interrupted.
      * 
                                            
@@ -1076,7 +1076,7 @@ public com.google.storage.v2.BidiWriteHandle getWriteHandle() {
      *
      *
      * 
                                            -     * An optional write handle that will periodically be present in response
+     * An optional write handle that is returned periodically in response
      * messages. Clients should save it for later use in establishing a new stream
      * if a connection is interrupted.
      * 
                                            
@@ -1101,7 +1101,7 @@ public Builder setWriteHandle(com.google.storage.v2.BidiWriteHandle value) {
      *
      *
      * 
                                            -     * An optional write handle that will periodically be present in response
+     * An optional write handle that is returned periodically in response
      * messages. Clients should save it for later use in establishing a new stream
      * if a connection is interrupted.
      * 
                                            
@@ -1123,7 +1123,7 @@ public Builder setWriteHandle(com.google.storage.v2.BidiWriteHandle.Builder buil
      *
      *
      * 
                                            -     * An optional write handle that will periodically be present in response
+     * An optional write handle that is returned periodically in response
      * messages. Clients should save it for later use in establishing a new stream
      * if a connection is interrupted.
      * 
                                            
@@ -1153,7 +1153,7 @@ public Builder mergeWriteHandle(com.google.storage.v2.BidiWriteHandle value) {
      *
      *
      * 
                                            -     * An optional write handle that will periodically be present in response
+     * An optional write handle that is returned periodically in response
      * messages. Clients should save it for later use in establishing a new stream
      * if a connection is interrupted.
      * 
                                            
@@ -1175,7 +1175,7 @@ public Builder clearWriteHandle() {
      *
      *
      * 
                                            -     * An optional write handle that will periodically be present in response
+     * An optional write handle that is returned periodically in response
      * messages. Clients should save it for later use in establishing a new stream
      * if a connection is interrupted.
      * 
                                            
@@ -1192,7 +1192,7 @@ public com.google.storage.v2.BidiWriteHandle.Builder getWriteHandleBuilder() {
      *
      *
      * 
                                            -     * An optional write handle that will periodically be present in response
+     * An optional write handle that is returned periodically in response
      * messages. Clients should save it for later use in establishing a new stream
      * if a connection is interrupted.
      * 
                                            
@@ -1213,7 +1213,7 @@ public com.google.storage.v2.BidiWriteHandleOrBuilder getWriteHandleOrBuilder()
      *
      *
      * 
                                            -     * An optional write handle that will periodically be present in response
+     * An optional write handle that is returned periodically in response
      * messages. Clients should save it for later use in establishing a new stream
      * if a connection is interrupted.
      * 
                                            
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectResponseOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectResponseOrBuilder.java
index 34457ee6ad..8976401bad 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectResponseOrBuilder.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectResponseOrBuilder.java
@@ -96,7 +96,7 @@ public interface BidiWriteObjectResponseOrBuilder
    *
    *
    * 
                                            -   * An optional write handle that will periodically be present in response
+   * An optional write handle that is returned periodically in response
    * messages. Clients should save it for later use in establishing a new stream
    * if a connection is interrupted.
    * 
                                            
@@ -111,7 +111,7 @@ public interface BidiWriteObjectResponseOrBuilder
    *
    *
    * 
                                            -   * An optional write handle that will periodically be present in response
+   * An optional write handle that is returned periodically in response
    * messages. Clients should save it for later use in establishing a new stream
    * if a connection is interrupted.
    * 
                                            
@@ -126,7 +126,7 @@ public interface BidiWriteObjectResponseOrBuilder
    *
    *
    * 
                                            -   * An optional write handle that will periodically be present in response
+   * An optional write handle that is returned periodically in response
    * messages. Clients should save it for later use in establishing a new stream
    * if a connection is interrupted.
    * 
                                            
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/Bucket.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/Bucket.java
index 617f2d1754..207c401c04 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/Bucket.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/Bucket.java
@@ -637,9 +637,10 @@ public interface CorsOrBuilder
      *
      *
      * 
                                            -     * Optional. The list of Origins eligible to receive CORS response headers.
-     * See [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
-     * Note: "*" is permitted in the list of origins, and means "any Origin".
+     * Optional. The list of origins eligible to receive CORS response headers.
+     * For more information about origins, see [RFC
+     * 6454](https://tools.ietf.org/html/rfc6454). Note: `*` is permitted in the
+     * list of origins, and means `any origin`.
      * 
                                            
      *
      * repeated string origin = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -652,9 +653,10 @@ public interface CorsOrBuilder
      *
      *
      * 
                                            -     * Optional. The list of Origins eligible to receive CORS response headers.
-     * See [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
-     * Note: "*" is permitted in the list of origins, and means "any Origin".
+     * Optional. The list of origins eligible to receive CORS response headers.
+     * For more information about origins, see [RFC
+     * 6454](https://tools.ietf.org/html/rfc6454). Note: `*` is permitted in the
+     * list of origins, and means `any origin`.
      * 
                                            
      *
      * repeated string origin = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -667,9 +669,10 @@ public interface CorsOrBuilder
      *
      *
      * 
                                            -     * Optional. The list of Origins eligible to receive CORS response headers.
-     * See [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
-     * Note: "*" is permitted in the list of origins, and means "any Origin".
+     * Optional. The list of origins eligible to receive CORS response headers.
+     * For more information about origins, see [RFC
+     * 6454](https://tools.ietf.org/html/rfc6454). Note: `*` is permitted in the
+     * list of origins, and means `any origin`.
      * 
                                            
      *
      * repeated string origin = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -683,9 +686,10 @@ public interface CorsOrBuilder
      *
      *
      * 
                                            -     * Optional. The list of Origins eligible to receive CORS response headers.
-     * See [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
-     * Note: "*" is permitted in the list of origins, and means "any Origin".
+     * Optional. The list of origins eligible to receive CORS response headers.
+     * For more information about origins, see [RFC
+     * 6454](https://tools.ietf.org/html/rfc6454). Note: `*` is permitted in the
+     * list of origins, and means `any origin`.
      * 
                                            
      *
      * repeated string origin = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -701,7 +705,7 @@ public interface CorsOrBuilder
      * 
                                                  * Optional. The list of HTTP methods on which to include CORS response
      * headers,
-     * (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+     * (`GET`, `OPTIONS`, `POST`, etc) Note: `*` is permitted in the list of
      * methods, and means "any method".
      * 
                                            
      *
@@ -717,7 +721,7 @@ public interface CorsOrBuilder
      * 
                                                  * Optional. The list of HTTP methods on which to include CORS response
      * headers,
-     * (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+     * (`GET`, `OPTIONS`, `POST`, etc) Note: `*` is permitted in the list of
      * methods, and means "any method".
      * 
                                            
      *
@@ -733,7 +737,7 @@ public interface CorsOrBuilder
      * 
                                                  * Optional. The list of HTTP methods on which to include CORS response
      * headers,
-     * (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+     * (`GET`, `OPTIONS`, `POST`, etc) Note: `*` is permitted in the list of
      * methods, and means "any method".
      * 
                                            
      *
@@ -750,7 +754,7 @@ public interface CorsOrBuilder
      * 
                                                  * Optional. The list of HTTP methods on which to include CORS response
      * headers,
-     * (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+     * (`GET`, `OPTIONS`, `POST`, etc) Note: `*` is permitted in the list of
      * methods, and means "any method".
      * 
                                            
      *
@@ -765,9 +769,9 @@ public interface CorsOrBuilder
      *
      *
      * 
                                            -     * Optional. The list of HTTP headers other than the
-     * [https://www.w3.org/TR/cors/#simple-response-header][simple response
-     * headers] to give permission for the user-agent to share across domains.
+     * Optional. The list of HTTP headers other than the [simple response
+     * headers](https://www.w3.org/TR/cors/#simple-response-headers) to give
+     * permission for the user-agent to share across domains.
      * 
                                            
      *
      * repeated string response_header = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -780,9 +784,9 @@ public interface CorsOrBuilder
      *
      *
      * 
                                            -     * Optional. The list of HTTP headers other than the
-     * [https://www.w3.org/TR/cors/#simple-response-header][simple response
-     * headers] to give permission for the user-agent to share across domains.
+     * Optional. The list of HTTP headers other than the [simple response
+     * headers](https://www.w3.org/TR/cors/#simple-response-headers) to give
+     * permission for the user-agent to share across domains.
      * 
                                            
      *
      * repeated string response_header = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -795,9 +799,9 @@ public interface CorsOrBuilder
      *
      *
      * 
                                            -     * Optional. The list of HTTP headers other than the
-     * [https://www.w3.org/TR/cors/#simple-response-header][simple response
-     * headers] to give permission for the user-agent to share across domains.
+     * Optional. The list of HTTP headers other than the [simple response
+     * headers](https://www.w3.org/TR/cors/#simple-response-headers) to give
+     * permission for the user-agent to share across domains.
      * 
                                            
      *
      * repeated string response_header = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -811,9 +815,9 @@ public interface CorsOrBuilder
      *
      *
      * 
                                            -     * Optional. The list of HTTP headers other than the
-     * [https://www.w3.org/TR/cors/#simple-response-header][simple response
-     * headers] to give permission for the user-agent to share across domains.
+     * Optional. The list of HTTP headers other than the [simple response
+     * headers](https://www.w3.org/TR/cors/#simple-response-headers) to give
+     * permission for the user-agent to share across domains.
      * 
                                            
      *
      * repeated string response_header = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -827,9 +831,9 @@ public interface CorsOrBuilder
      *
      *
      * 
                                            -     * Optional. The value, in seconds, to return in the
-     * [https://www.w3.org/TR/cors/#access-control-max-age-response-header][Access-Control-Max-Age
-     * header] used in preflight responses.
+     * Optional. The value, in seconds, to return in the [Access-Control-Max-Age
+     * header](https://www.w3.org/TR/cors/#access-control-max-age-response-header)
+     * used in preflight responses.
      * 
                                            
      *
      * int32 max_age_seconds = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -899,9 +903,10 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
      *
      *
      * 
                                            -     * Optional. The list of Origins eligible to receive CORS response headers.
-     * See [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
-     * Note: "*" is permitted in the list of origins, and means "any Origin".
+     * Optional. The list of origins eligible to receive CORS response headers.
+     * For more information about origins, see [RFC
+     * 6454](https://tools.ietf.org/html/rfc6454). Note: `*` is permitted in the
+     * list of origins, and means `any origin`.
      * 
                                            
      *
      * repeated string origin = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -916,9 +921,10 @@ public com.google.protobuf.ProtocolStringList getOriginList() {
      *
      *
      * 
                                            -     * Optional. The list of Origins eligible to receive CORS response headers.
-     * See [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
-     * Note: "*" is permitted in the list of origins, and means "any Origin".
+     * Optional. The list of origins eligible to receive CORS response headers.
+     * For more information about origins, see [RFC
+     * 6454](https://tools.ietf.org/html/rfc6454). Note: `*` is permitted in the
+     * list of origins, and means `any origin`.
      * 
                                            
      *
      * repeated string origin = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -933,9 +939,10 @@ public int getOriginCount() {
      *
      *
      * 
                                            -     * Optional. The list of Origins eligible to receive CORS response headers.
-     * See [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
-     * Note: "*" is permitted in the list of origins, and means "any Origin".
+     * Optional. The list of origins eligible to receive CORS response headers.
+     * For more information about origins, see [RFC
+     * 6454](https://tools.ietf.org/html/rfc6454). Note: `*` is permitted in the
+     * list of origins, and means `any origin`.
      * 
                                            
      *
      * repeated string origin = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -951,9 +958,10 @@ public java.lang.String getOrigin(int index) {
      *
      *
      * 
                                            -     * Optional. The list of Origins eligible to receive CORS response headers.
-     * See [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
-     * Note: "*" is permitted in the list of origins, and means "any Origin".
+     * Optional. The list of origins eligible to receive CORS response headers.
+     * For more information about origins, see [RFC
+     * 6454](https://tools.ietf.org/html/rfc6454). Note: `*` is permitted in the
+     * list of origins, and means `any origin`.
      * 
                                            
      *
      * repeated string origin = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -977,7 +985,7 @@ public com.google.protobuf.ByteString getOriginBytes(int index) {
      * 
                                                  * Optional. The list of HTTP methods on which to include CORS response
      * headers,
-     * (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+     * (`GET`, `OPTIONS`, `POST`, etc) Note: `*` is permitted in the list of
      * methods, and means "any method".
      * 
                                            
      *
@@ -995,7 +1003,7 @@ public com.google.protobuf.ProtocolStringList getMethodList() {
      * 
                                                  * Optional. The list of HTTP methods on which to include CORS response
      * headers,
-     * (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+     * (`GET`, `OPTIONS`, `POST`, etc) Note: `*` is permitted in the list of
      * methods, and means "any method".
      * 
                                            
      *
@@ -1013,7 +1021,7 @@ public int getMethodCount() {
      * 
                                                  * Optional. The list of HTTP methods on which to include CORS response
      * headers,
-     * (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+     * (`GET`, `OPTIONS`, `POST`, etc) Note: `*` is permitted in the list of
      * methods, and means "any method".
      * 
                                            
      *
@@ -1032,7 +1040,7 @@ public java.lang.String getMethod(int index) {
      * 
                                                  * Optional. The list of HTTP methods on which to include CORS response
      * headers,
-     * (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+     * (`GET`, `OPTIONS`, `POST`, etc) Note: `*` is permitted in the list of
      * methods, and means "any method".
      * 
                                            
      *
@@ -1055,9 +1063,9 @@ public com.google.protobuf.ByteString getMethodBytes(int index) {
      *
      *
      * 
                                            -     * Optional. The list of HTTP headers other than the
-     * [https://www.w3.org/TR/cors/#simple-response-header][simple response
-     * headers] to give permission for the user-agent to share across domains.
+     * Optional. The list of HTTP headers other than the [simple response
+     * headers](https://www.w3.org/TR/cors/#simple-response-headers) to give
+     * permission for the user-agent to share across domains.
      * 
                                            
      *
      * repeated string response_header = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -1072,9 +1080,9 @@ public com.google.protobuf.ProtocolStringList getResponseHeaderList() {
      *
      *
      * 
                                            -     * Optional. The list of HTTP headers other than the
-     * [https://www.w3.org/TR/cors/#simple-response-header][simple response
-     * headers] to give permission for the user-agent to share across domains.
+     * Optional. The list of HTTP headers other than the [simple response
+     * headers](https://www.w3.org/TR/cors/#simple-response-headers) to give
+     * permission for the user-agent to share across domains.
      * 
                                            
      *
      * repeated string response_header = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -1089,9 +1097,9 @@ public int getResponseHeaderCount() {
      *
      *
      * 
                                            -     * Optional. The list of HTTP headers other than the
-     * [https://www.w3.org/TR/cors/#simple-response-header][simple response
-     * headers] to give permission for the user-agent to share across domains.
+     * Optional. The list of HTTP headers other than the [simple response
+     * headers](https://www.w3.org/TR/cors/#simple-response-headers) to give
+     * permission for the user-agent to share across domains.
      * 
                                            
      *
      * repeated string response_header = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -1107,9 +1115,9 @@ public java.lang.String getResponseHeader(int index) {
      *
      *
      * 
                                            -     * Optional. The list of HTTP headers other than the
-     * [https://www.w3.org/TR/cors/#simple-response-header][simple response
-     * headers] to give permission for the user-agent to share across domains.
+     * Optional. The list of HTTP headers other than the [simple response
+     * headers](https://www.w3.org/TR/cors/#simple-response-headers) to give
+     * permission for the user-agent to share across domains.
      * 
                                            
      *
      * repeated string response_header = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -1128,9 +1136,9 @@ public com.google.protobuf.ByteString getResponseHeaderBytes(int index) {
      *
      *
      * 
                                            -     * Optional. The value, in seconds, to return in the
-     * [https://www.w3.org/TR/cors/#access-control-max-age-response-header][Access-Control-Max-Age
-     * header] used in preflight responses.
+     * Optional. The value, in seconds, to return in the [Access-Control-Max-Age
+     * header](https://www.w3.org/TR/cors/#access-control-max-age-response-header)
+     * used in preflight responses.
      * 
                                            
      *
      * int32 max_age_seconds = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -1614,9 +1622,10 @@ private void ensureOriginIsMutable() {
        *
        *
        * 
                                            -       * Optional. The list of Origins eligible to receive CORS response headers.
-       * See [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
-       * Note: "*" is permitted in the list of origins, and means "any Origin".
+       * Optional. The list of origins eligible to receive CORS response headers.
+       * For more information about origins, see [RFC
+       * 6454](https://tools.ietf.org/html/rfc6454). Note: `*` is permitted in the
+       * list of origins, and means `any origin`.
        * 
                                            
        *
        * repeated string origin = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -1632,9 +1641,10 @@ public com.google.protobuf.ProtocolStringList getOriginList() {
        *
        *
        * 
                                            -       * Optional. The list of Origins eligible to receive CORS response headers.
-       * See [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
-       * Note: "*" is permitted in the list of origins, and means "any Origin".
+       * Optional. The list of origins eligible to receive CORS response headers.
+       * For more information about origins, see [RFC
+       * 6454](https://tools.ietf.org/html/rfc6454). Note: `*` is permitted in the
+       * list of origins, and means `any origin`.
        * 
                                            
        *
        * repeated string origin = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -1649,9 +1659,10 @@ public int getOriginCount() {
        *
        *
        * 
                                            -       * Optional. The list of Origins eligible to receive CORS response headers.
-       * See [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
-       * Note: "*" is permitted in the list of origins, and means "any Origin".
+       * Optional. The list of origins eligible to receive CORS response headers.
+       * For more information about origins, see [RFC
+       * 6454](https://tools.ietf.org/html/rfc6454). Note: `*` is permitted in the
+       * list of origins, and means `any origin`.
        * 
                                            
        *
        * repeated string origin = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -1667,9 +1678,10 @@ public java.lang.String getOrigin(int index) {
        *
        *
        * 
                                            -       * Optional. The list of Origins eligible to receive CORS response headers.
-       * See [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
-       * Note: "*" is permitted in the list of origins, and means "any Origin".
+       * Optional. The list of origins eligible to receive CORS response headers.
+       * For more information about origins, see [RFC
+       * 6454](https://tools.ietf.org/html/rfc6454). Note: `*` is permitted in the
+       * list of origins, and means `any origin`.
        * 
                                            
        *
        * repeated string origin = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -1685,9 +1697,10 @@ public com.google.protobuf.ByteString getOriginBytes(int index) {
        *
        *
        * 
                                            -       * Optional. The list of Origins eligible to receive CORS response headers.
-       * See [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
-       * Note: "*" is permitted in the list of origins, and means "any Origin".
+       * Optional. The list of origins eligible to receive CORS response headers.
+       * For more information about origins, see [RFC
+       * 6454](https://tools.ietf.org/html/rfc6454). Note: `*` is permitted in the
+       * list of origins, and means `any origin`.
        * 
                                            
        *
        * repeated string origin = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -1711,9 +1724,10 @@ public Builder setOrigin(int index, java.lang.String value) {
        *
        *
        * 
                                            -       * Optional. The list of Origins eligible to receive CORS response headers.
-       * See [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
-       * Note: "*" is permitted in the list of origins, and means "any Origin".
+       * Optional. The list of origins eligible to receive CORS response headers.
+       * For more information about origins, see [RFC
+       * 6454](https://tools.ietf.org/html/rfc6454). Note: `*` is permitted in the
+       * list of origins, and means `any origin`.
        * 
                                            
        *
        * repeated string origin = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -1736,9 +1750,10 @@ public Builder addOrigin(java.lang.String value) {
        *
        *
        * 
                                            -       * Optional. The list of Origins eligible to receive CORS response headers.
-       * See [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
-       * Note: "*" is permitted in the list of origins, and means "any Origin".
+       * Optional. The list of origins eligible to receive CORS response headers.
+       * For more information about origins, see [RFC
+       * 6454](https://tools.ietf.org/html/rfc6454). Note: `*` is permitted in the
+       * list of origins, and means `any origin`.
        * 
                                            
        *
        * repeated string origin = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -1758,9 +1773,10 @@ public Builder addAllOrigin(java.lang.Iterable values) {
        *
        *
        * 
                                            -       * Optional. The list of Origins eligible to receive CORS response headers.
-       * See [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
-       * Note: "*" is permitted in the list of origins, and means "any Origin".
+       * Optional. The list of origins eligible to receive CORS response headers.
+       * For more information about origins, see [RFC
+       * 6454](https://tools.ietf.org/html/rfc6454). Note: `*` is permitted in the
+       * list of origins, and means `any origin`.
        * 
                                            
        *
        * repeated string origin = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -1779,9 +1795,10 @@ public Builder clearOrigin() {
        *
        *
        * 
                                            -       * Optional. The list of Origins eligible to receive CORS response headers.
-       * See [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
-       * Note: "*" is permitted in the list of origins, and means "any Origin".
+       * Optional. The list of origins eligible to receive CORS response headers.
+       * For more information about origins, see [RFC
+       * 6454](https://tools.ietf.org/html/rfc6454). Note: `*` is permitted in the
+       * list of origins, and means `any origin`.
        * 
                                            
        *
        * repeated string origin = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -1817,7 +1834,7 @@ private void ensureMethodIsMutable() {
        * 
                                                    * Optional. The list of HTTP methods on which to include CORS response
        * headers,
-       * (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+       * (`GET`, `OPTIONS`, `POST`, etc) Note: `*` is permitted in the list of
        * methods, and means "any method".
        * 
                                            
        *
@@ -1836,7 +1853,7 @@ public com.google.protobuf.ProtocolStringList getMethodList() {
        * 
                                                    * Optional. The list of HTTP methods on which to include CORS response
        * headers,
-       * (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+       * (`GET`, `OPTIONS`, `POST`, etc) Note: `*` is permitted in the list of
        * methods, and means "any method".
        * 
                                            
        *
@@ -1854,7 +1871,7 @@ public int getMethodCount() {
        * 
                                                    * Optional. The list of HTTP methods on which to include CORS response
        * headers,
-       * (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+       * (`GET`, `OPTIONS`, `POST`, etc) Note: `*` is permitted in the list of
        * methods, and means "any method".
        * 
                                            
        *
@@ -1873,7 +1890,7 @@ public java.lang.String getMethod(int index) {
        * 
                                                    * Optional. The list of HTTP methods on which to include CORS response
        * headers,
-       * (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+       * (`GET`, `OPTIONS`, `POST`, etc) Note: `*` is permitted in the list of
        * methods, and means "any method".
        * 
                                            
        *
@@ -1892,7 +1909,7 @@ public com.google.protobuf.ByteString getMethodBytes(int index) {
        * 
                                                    * Optional. The list of HTTP methods on which to include CORS response
        * headers,
-       * (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+       * (`GET`, `OPTIONS`, `POST`, etc) Note: `*` is permitted in the list of
        * methods, and means "any method".
        * 
                                            
        *
@@ -1919,7 +1936,7 @@ public Builder setMethod(int index, java.lang.String value) {
        * 
                                                    * Optional. The list of HTTP methods on which to include CORS response
        * headers,
-       * (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+       * (`GET`, `OPTIONS`, `POST`, etc) Note: `*` is permitted in the list of
        * methods, and means "any method".
        * 
                                            
        *
@@ -1945,7 +1962,7 @@ public Builder addMethod(java.lang.String value) {
        * 
                                                    * Optional. The list of HTTP methods on which to include CORS response
        * headers,
-       * (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+       * (`GET`, `OPTIONS`, `POST`, etc) Note: `*` is permitted in the list of
        * methods, and means "any method".
        * 
                                            
        *
@@ -1968,7 +1985,7 @@ public Builder addAllMethod(java.lang.Iterable values) {
        * 
                                                    * Optional. The list of HTTP methods on which to include CORS response
        * headers,
-       * (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+       * (`GET`, `OPTIONS`, `POST`, etc) Note: `*` is permitted in the list of
        * methods, and means "any method".
        * 
                                            
        *
@@ -1990,7 +2007,7 @@ public Builder clearMethod() {
        * 
                                                    * Optional. The list of HTTP methods on which to include CORS response
        * headers,
-       * (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+       * (`GET`, `OPTIONS`, `POST`, etc) Note: `*` is permitted in the list of
        * methods, and means "any method".
        * 
                                            
        *
@@ -2025,9 +2042,9 @@ private void ensureResponseHeaderIsMutable() {
        *
        *
        * 
                                            -       * Optional. The list of HTTP headers other than the
-       * [https://www.w3.org/TR/cors/#simple-response-header][simple response
-       * headers] to give permission for the user-agent to share across domains.
+       * Optional. The list of HTTP headers other than the [simple response
+       * headers](https://www.w3.org/TR/cors/#simple-response-headers) to give
+       * permission for the user-agent to share across domains.
        * 
                                            
        *
        * repeated string response_header = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -2043,9 +2060,9 @@ public com.google.protobuf.ProtocolStringList getResponseHeaderList() {
        *
        *
        * 
                                            -       * Optional. The list of HTTP headers other than the
-       * [https://www.w3.org/TR/cors/#simple-response-header][simple response
-       * headers] to give permission for the user-agent to share across domains.
+       * Optional. The list of HTTP headers other than the [simple response
+       * headers](https://www.w3.org/TR/cors/#simple-response-headers) to give
+       * permission for the user-agent to share across domains.
        * 
                                            
        *
        * repeated string response_header = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -2060,9 +2077,9 @@ public int getResponseHeaderCount() {
        *
        *
        * 
                                            -       * Optional. The list of HTTP headers other than the
-       * [https://www.w3.org/TR/cors/#simple-response-header][simple response
-       * headers] to give permission for the user-agent to share across domains.
+       * Optional. The list of HTTP headers other than the [simple response
+       * headers](https://www.w3.org/TR/cors/#simple-response-headers) to give
+       * permission for the user-agent to share across domains.
        * 
                                            
        *
        * repeated string response_header = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -2078,9 +2095,9 @@ public java.lang.String getResponseHeader(int index) {
        *
        *
        * 
                                            -       * Optional. The list of HTTP headers other than the
-       * [https://www.w3.org/TR/cors/#simple-response-header][simple response
-       * headers] to give permission for the user-agent to share across domains.
+       * Optional. The list of HTTP headers other than the [simple response
+       * headers](https://www.w3.org/TR/cors/#simple-response-headers) to give
+       * permission for the user-agent to share across domains.
        * 
                                            
        *
        * repeated string response_header = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -2096,9 +2113,9 @@ public com.google.protobuf.ByteString getResponseHeaderBytes(int index) {
        *
        *
        * 
                                            -       * Optional. The list of HTTP headers other than the
-       * [https://www.w3.org/TR/cors/#simple-response-header][simple response
-       * headers] to give permission for the user-agent to share across domains.
+       * Optional. The list of HTTP headers other than the [simple response
+       * headers](https://www.w3.org/TR/cors/#simple-response-headers) to give
+       * permission for the user-agent to share across domains.
        * 
                                            
        *
        * repeated string response_header = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -2122,9 +2139,9 @@ public Builder setResponseHeader(int index, java.lang.String value) {
        *
        *
        * 
                                            -       * Optional. The list of HTTP headers other than the
-       * [https://www.w3.org/TR/cors/#simple-response-header][simple response
-       * headers] to give permission for the user-agent to share across domains.
+       * Optional. The list of HTTP headers other than the [simple response
+       * headers](https://www.w3.org/TR/cors/#simple-response-headers) to give
+       * permission for the user-agent to share across domains.
        * 
                                            
        *
        * repeated string response_header = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -2147,9 +2164,9 @@ public Builder addResponseHeader(java.lang.String value) {
        *
        *
        * 
                                            -       * Optional. The list of HTTP headers other than the
-       * [https://www.w3.org/TR/cors/#simple-response-header][simple response
-       * headers] to give permission for the user-agent to share across domains.
+       * Optional. The list of HTTP headers other than the [simple response
+       * headers](https://www.w3.org/TR/cors/#simple-response-headers) to give
+       * permission for the user-agent to share across domains.
        * 
                                            
        *
        * repeated string response_header = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -2169,9 +2186,9 @@ public Builder addAllResponseHeader(java.lang.Iterable values)
        *
        *
        * 
                                            -       * Optional. The list of HTTP headers other than the
-       * [https://www.w3.org/TR/cors/#simple-response-header][simple response
-       * headers] to give permission for the user-agent to share across domains.
+       * Optional. The list of HTTP headers other than the [simple response
+       * headers](https://www.w3.org/TR/cors/#simple-response-headers) to give
+       * permission for the user-agent to share across domains.
        * 
                                            
        *
        * repeated string response_header = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -2190,9 +2207,9 @@ public Builder clearResponseHeader() {
        *
        *
        * 
                                            -       * Optional. The list of HTTP headers other than the
-       * [https://www.w3.org/TR/cors/#simple-response-header][simple response
-       * headers] to give permission for the user-agent to share across domains.
+       * Optional. The list of HTTP headers other than the [simple response
+       * headers](https://www.w3.org/TR/cors/#simple-response-headers) to give
+       * permission for the user-agent to share across domains.
        * 
                                            
        *
        * repeated string response_header = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -2218,9 +2235,9 @@ public Builder addResponseHeaderBytes(com.google.protobuf.ByteString value) {
        *
        *
        * 
                                            -       * Optional. The value, in seconds, to return in the
-       * [https://www.w3.org/TR/cors/#access-control-max-age-response-header][Access-Control-Max-Age
-       * header] used in preflight responses.
+       * Optional. The value, in seconds, to return in the [Access-Control-Max-Age
+       * header](https://www.w3.org/TR/cors/#access-control-max-age-response-header)
+       * used in preflight responses.
        * 
                                            
        *
        * int32 max_age_seconds = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -2236,9 +2253,9 @@ public int getMaxAgeSeconds() {
        *
        *
        * 
                                            -       * Optional. The value, in seconds, to return in the
-       * [https://www.w3.org/TR/cors/#access-control-max-age-response-header][Access-Control-Max-Age
-       * header] used in preflight responses.
+       * Optional. The value, in seconds, to return in the [Access-Control-Max-Age
+       * header](https://www.w3.org/TR/cors/#access-control-max-age-response-header)
+       * used in preflight responses.
        * 
                                            
        *
        * int32 max_age_seconds = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -2258,9 +2275,9 @@ public Builder setMaxAgeSeconds(int value) {
        *
        *
        * 
                                            -       * Optional. The value, in seconds, to return in the
-       * [https://www.w3.org/TR/cors/#access-control-max-age-response-header][Access-Control-Max-Age
-       * header] used in preflight responses.
+       * Optional. The value, in seconds, to return in the [Access-Control-Max-Age
+       * header](https://www.w3.org/TR/cors/#access-control-max-age-response-header)
+       * used in preflight responses.
        * 
                                            
        *
        * int32 max_age_seconds = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -2347,8 +2364,8 @@ public interface EncryptionOrBuilder
      *
      *
      * 
                                            -     * Optional. The name of the Cloud KMS key that will be used to encrypt
-     * objects inserted into this bucket, if no encryption method is specified.
+     * Optional. The name of the Cloud KMS key that is used to encrypt objects
+     * inserted into this bucket, if no encryption method is specified.
      * 
                                            
      *
      * 
@@ -2363,8 +2380,8 @@ public interface EncryptionOrBuilder
      *
      *
      * 
                                            -     * Optional. The name of the Cloud KMS key that will be used to encrypt
-     * objects inserted into this bucket, if no encryption method is specified.
+     * Optional. The name of the Cloud KMS key that is used to encrypt objects
+     * inserted into this bucket, if no encryption method is specified.
      * 
                                            
      *
      * 
@@ -2593,7 +2610,7 @@ public interface GoogleManagedEncryptionEnforcementConfigOrBuilder
        *
        * 
                                                    * Restriction mode for google-managed encryption for new objects within
-       * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+       * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
        * If `NotRestricted` or unset, creation of new objects with
        * google-managed encryption is allowed.
        * If `FullyRestricted`, new objects can't be created using google-managed
@@ -2611,7 +2628,7 @@ public interface GoogleManagedEncryptionEnforcementConfigOrBuilder
        *
        * 
                                                    * Restriction mode for google-managed encryption for new objects within
-       * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+       * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
        * If `NotRestricted` or unset, creation of new objects with
        * google-managed encryption is allowed.
        * If `FullyRestricted`, new objects can't be created using google-managed
@@ -2629,7 +2646,7 @@ public interface GoogleManagedEncryptionEnforcementConfigOrBuilder
        *
        * 
                                                    * Restriction mode for google-managed encryption for new objects within
-       * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+       * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
        * If `NotRestricted` or unset, creation of new objects with
        * google-managed encryption is allowed.
        * If `FullyRestricted`, new objects can't be created using google-managed
@@ -2741,7 +2758,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
        *
        * 
                                                    * Restriction mode for google-managed encryption for new objects within
-       * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+       * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
        * If `NotRestricted` or unset, creation of new objects with
        * google-managed encryption is allowed.
        * If `FullyRestricted`, new objects can't be created using google-managed
@@ -2762,7 +2779,7 @@ public boolean hasRestrictionMode() {
        *
        * 
                                                    * Restriction mode for google-managed encryption for new objects within
-       * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+       * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
        * If `NotRestricted` or unset, creation of new objects with
        * google-managed encryption is allowed.
        * If `FullyRestricted`, new objects can't be created using google-managed
@@ -2791,7 +2808,7 @@ public java.lang.String getRestrictionMode() {
        *
        * 
                                                    * Restriction mode for google-managed encryption for new objects within
-       * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+       * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
        * If `NotRestricted` or unset, creation of new objects with
        * google-managed encryption is allowed.
        * If `FullyRestricted`, new objects can't be created using google-managed
@@ -3305,7 +3322,7 @@ public Builder mergeFrom(
          *
          * 
                                                      * Restriction mode for google-managed encryption for new objects within
-         * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+         * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
          * If `NotRestricted` or unset, creation of new objects with
          * google-managed encryption is allowed.
          * If `FullyRestricted`, new objects can't be created using google-managed
@@ -3325,7 +3342,7 @@ public boolean hasRestrictionMode() {
          *
          * 
                                                      * Restriction mode for google-managed encryption for new objects within
-         * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+         * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
          * If `NotRestricted` or unset, creation of new objects with
          * google-managed encryption is allowed.
          * If `FullyRestricted`, new objects can't be created using google-managed
@@ -3353,7 +3370,7 @@ public java.lang.String getRestrictionMode() {
          *
          * 
                                                      * Restriction mode for google-managed encryption for new objects within
-         * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+         * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
          * If `NotRestricted` or unset, creation of new objects with
          * google-managed encryption is allowed.
          * If `FullyRestricted`, new objects can't be created using google-managed
@@ -3381,7 +3398,7 @@ public com.google.protobuf.ByteString getRestrictionModeBytes() {
          *
          * 
                                                      * Restriction mode for google-managed encryption for new objects within
-         * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+         * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
          * If `NotRestricted` or unset, creation of new objects with
          * google-managed encryption is allowed.
          * If `FullyRestricted`, new objects can't be created using google-managed
@@ -3408,7 +3425,7 @@ public Builder setRestrictionMode(java.lang.String value) {
          *
          * 
                                                      * Restriction mode for google-managed encryption for new objects within
-         * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+         * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
          * If `NotRestricted` or unset, creation of new objects with
          * google-managed encryption is allowed.
          * If `FullyRestricted`, new objects can't be created using google-managed
@@ -3431,7 +3448,7 @@ public Builder clearRestrictionMode() {
          *
          * 
                                                      * Restriction mode for google-managed encryption for new objects within
-         * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+         * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
          * If `NotRestricted` or unset, creation of new objects with
          * google-managed encryption is allowed.
          * If `FullyRestricted`, new objects can't be created using google-managed
@@ -3729,7 +3746,7 @@ public interface CustomerManagedEncryptionEnforcementConfigOrBuilder
        *
        * 
                                                    * Restriction mode for customer-managed encryption for new objects within
-       * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+       * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
        * If `NotRestricted` or unset, creation of new objects with
        * customer-managed encryption is allowed.
        * If `FullyRestricted`, new objects can't be created using
@@ -3747,7 +3764,7 @@ public interface CustomerManagedEncryptionEnforcementConfigOrBuilder
        *
        * 
                                                    * Restriction mode for customer-managed encryption for new objects within
-       * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+       * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
        * If `NotRestricted` or unset, creation of new objects with
        * customer-managed encryption is allowed.
        * If `FullyRestricted`, new objects can't be created using
@@ -3765,7 +3782,7 @@ public interface CustomerManagedEncryptionEnforcementConfigOrBuilder
        *
        * 
                                                    * Restriction mode for customer-managed encryption for new objects within
-       * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+       * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
        * If `NotRestricted` or unset, creation of new objects with
        * customer-managed encryption is allowed.
        * If `FullyRestricted`, new objects can't be created using
@@ -3877,7 +3894,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
        *
        * 
                                                    * Restriction mode for customer-managed encryption for new objects within
-       * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+       * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
        * If `NotRestricted` or unset, creation of new objects with
        * customer-managed encryption is allowed.
        * If `FullyRestricted`, new objects can't be created using
@@ -3898,7 +3915,7 @@ public boolean hasRestrictionMode() {
        *
        * 
                                                    * Restriction mode for customer-managed encryption for new objects within
-       * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+       * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
        * If `NotRestricted` or unset, creation of new objects with
        * customer-managed encryption is allowed.
        * If `FullyRestricted`, new objects can't be created using
@@ -3927,7 +3944,7 @@ public java.lang.String getRestrictionMode() {
        *
        * 
                                                    * Restriction mode for customer-managed encryption for new objects within
-       * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+       * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
        * If `NotRestricted` or unset, creation of new objects with
        * customer-managed encryption is allowed.
        * If `FullyRestricted`, new objects can't be created using
@@ -4455,7 +4472,7 @@ public Builder mergeFrom(
          *
          * 
                                                      * Restriction mode for customer-managed encryption for new objects within
-         * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+         * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
          * If `NotRestricted` or unset, creation of new objects with
          * customer-managed encryption is allowed.
          * If `FullyRestricted`, new objects can't be created using
@@ -4475,7 +4492,7 @@ public boolean hasRestrictionMode() {
          *
          * 
                                                      * Restriction mode for customer-managed encryption for new objects within
-         * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+         * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
          * If `NotRestricted` or unset, creation of new objects with
          * customer-managed encryption is allowed.
          * If `FullyRestricted`, new objects can't be created using
@@ -4503,7 +4520,7 @@ public java.lang.String getRestrictionMode() {
          *
          * 
                                                      * Restriction mode for customer-managed encryption for new objects within
-         * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+         * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
          * If `NotRestricted` or unset, creation of new objects with
          * customer-managed encryption is allowed.
          * If `FullyRestricted`, new objects can't be created using
@@ -4531,7 +4548,7 @@ public com.google.protobuf.ByteString getRestrictionModeBytes() {
          *
          * 
                                                      * Restriction mode for customer-managed encryption for new objects within
-         * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+         * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
          * If `NotRestricted` or unset, creation of new objects with
          * customer-managed encryption is allowed.
          * If `FullyRestricted`, new objects can't be created using
@@ -4558,7 +4575,7 @@ public Builder setRestrictionMode(java.lang.String value) {
          *
          * 
                                                      * Restriction mode for customer-managed encryption for new objects within
-         * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+         * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
          * If `NotRestricted` or unset, creation of new objects with
          * customer-managed encryption is allowed.
          * If `FullyRestricted`, new objects can't be created using
@@ -4581,7 +4598,7 @@ public Builder clearRestrictionMode() {
          *
          * 
                                                      * Restriction mode for customer-managed encryption for new objects within
-         * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+         * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
          * If `NotRestricted` or unset, creation of new objects with
          * customer-managed encryption is allowed.
          * If `FullyRestricted`, new objects can't be created using
@@ -4882,8 +4899,8 @@ public interface CustomerSuppliedEncryptionEnforcementConfigOrBuilder
        *
        * 
                                                    * Restriction mode for customer-supplied encryption for new objects
-       * within the bucket. Valid values are: "NotRestricted",
-       * "FullyRestricted".
+       * within the bucket. Valid values are: `NotRestricted` and
+       * `FullyRestricted`.
        * If `NotRestricted` or unset, creation of new objects with
        * customer-supplied encryption is allowed.
        * If `FullyRestricted`, new objects can't be created using
@@ -4901,8 +4918,8 @@ public interface CustomerSuppliedEncryptionEnforcementConfigOrBuilder
        *
        * 
                                                    * Restriction mode for customer-supplied encryption for new objects
-       * within the bucket. Valid values are: "NotRestricted",
-       * "FullyRestricted".
+       * within the bucket. Valid values are: `NotRestricted` and
+       * `FullyRestricted`.
        * If `NotRestricted` or unset, creation of new objects with
        * customer-supplied encryption is allowed.
        * If `FullyRestricted`, new objects can't be created using
@@ -4920,8 +4937,8 @@ public interface CustomerSuppliedEncryptionEnforcementConfigOrBuilder
        *
        * 
                                                    * Restriction mode for customer-supplied encryption for new objects
-       * within the bucket. Valid values are: "NotRestricted",
-       * "FullyRestricted".
+       * within the bucket. Valid values are: `NotRestricted` and
+       * `FullyRestricted`.
        * If `NotRestricted` or unset, creation of new objects with
        * customer-supplied encryption is allowed.
        * If `FullyRestricted`, new objects can't be created using
@@ -5033,8 +5050,8 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
        *
        * 
                                                    * Restriction mode for customer-supplied encryption for new objects
-       * within the bucket. Valid values are: "NotRestricted",
-       * "FullyRestricted".
+       * within the bucket. Valid values are: `NotRestricted` and
+       * `FullyRestricted`.
        * If `NotRestricted` or unset, creation of new objects with
        * customer-supplied encryption is allowed.
        * If `FullyRestricted`, new objects can't be created using
@@ -5055,8 +5072,8 @@ public boolean hasRestrictionMode() {
        *
        * 
                                                    * Restriction mode for customer-supplied encryption for new objects
-       * within the bucket. Valid values are: "NotRestricted",
-       * "FullyRestricted".
+       * within the bucket. Valid values are: `NotRestricted` and
+       * `FullyRestricted`.
        * If `NotRestricted` or unset, creation of new objects with
        * customer-supplied encryption is allowed.
        * If `FullyRestricted`, new objects can't be created using
@@ -5085,8 +5102,8 @@ public java.lang.String getRestrictionMode() {
        *
        * 
                                                    * Restriction mode for customer-supplied encryption for new objects
-       * within the bucket. Valid values are: "NotRestricted",
-       * "FullyRestricted".
+       * within the bucket. Valid values are: `NotRestricted` and
+       * `FullyRestricted`.
        * If `NotRestricted` or unset, creation of new objects with
        * customer-supplied encryption is allowed.
        * If `FullyRestricted`, new objects can't be created using
@@ -5615,8 +5632,8 @@ public Builder mergeFrom(
          *
          * 
                                                      * Restriction mode for customer-supplied encryption for new objects
-         * within the bucket. Valid values are: "NotRestricted",
-         * "FullyRestricted".
+         * within the bucket. Valid values are: `NotRestricted` and
+         * `FullyRestricted`.
          * If `NotRestricted` or unset, creation of new objects with
          * customer-supplied encryption is allowed.
          * If `FullyRestricted`, new objects can't be created using
@@ -5636,8 +5653,8 @@ public boolean hasRestrictionMode() {
          *
          * 
                                                      * Restriction mode for customer-supplied encryption for new objects
-         * within the bucket. Valid values are: "NotRestricted",
-         * "FullyRestricted".
+         * within the bucket. Valid values are: `NotRestricted` and
+         * `FullyRestricted`.
          * If `NotRestricted` or unset, creation of new objects with
          * customer-supplied encryption is allowed.
          * If `FullyRestricted`, new objects can't be created using
@@ -5665,8 +5682,8 @@ public java.lang.String getRestrictionMode() {
          *
          * 
                                                      * Restriction mode for customer-supplied encryption for new objects
-         * within the bucket. Valid values are: "NotRestricted",
-         * "FullyRestricted".
+         * within the bucket. Valid values are: `NotRestricted` and
+         * `FullyRestricted`.
          * If `NotRestricted` or unset, creation of new objects with
          * customer-supplied encryption is allowed.
          * If `FullyRestricted`, new objects can't be created using
@@ -5694,8 +5711,8 @@ public com.google.protobuf.ByteString getRestrictionModeBytes() {
          *
          * 
                                                      * Restriction mode for customer-supplied encryption for new objects
-         * within the bucket. Valid values are: "NotRestricted",
-         * "FullyRestricted".
+         * within the bucket. Valid values are: `NotRestricted` and
+         * `FullyRestricted`.
          * If `NotRestricted` or unset, creation of new objects with
          * customer-supplied encryption is allowed.
          * If `FullyRestricted`, new objects can't be created using
@@ -5722,8 +5739,8 @@ public Builder setRestrictionMode(java.lang.String value) {
          *
          * 
                                                      * Restriction mode for customer-supplied encryption for new objects
-         * within the bucket. Valid values are: "NotRestricted",
-         * "FullyRestricted".
+         * within the bucket. Valid values are: `NotRestricted` and
+         * `FullyRestricted`.
          * If `NotRestricted` or unset, creation of new objects with
          * customer-supplied encryption is allowed.
          * If `FullyRestricted`, new objects can't be created using
@@ -5746,8 +5763,8 @@ public Builder clearRestrictionMode() {
          *
          * 
                                                      * Restriction mode for customer-supplied encryption for new objects
-         * within the bucket. Valid values are: "NotRestricted",
-         * "FullyRestricted".
+         * within the bucket. Valid values are: `NotRestricted` and
+         * `FullyRestricted`.
          * If `NotRestricted` or unset, creation of new objects with
          * customer-supplied encryption is allowed.
          * If `FullyRestricted`, new objects can't be created using
@@ -6049,8 +6066,8 @@ public CustomerSuppliedEncryptionEnforcementConfig parsePartialFrom(
      *
      *
      * 
                                            -     * Optional. The name of the Cloud KMS key that will be used to encrypt
-     * objects inserted into this bucket, if no encryption method is specified.
+     * Optional. The name of the Cloud KMS key that is used to encrypt objects
+     * inserted into this bucket, if no encryption method is specified.
      * 
                                            
      *
      * 
@@ -6076,8 +6093,8 @@ public java.lang.String getDefaultKmsKey() {
      *
      *
      * 
                                            -     * Optional. The name of the Cloud KMS key that will be used to encrypt
-     * objects inserted into this bucket, if no encryption method is specified.
+     * Optional. The name of the Cloud KMS key that is used to encrypt objects
+     * inserted into this bucket, if no encryption method is specified.
      * 
                                            
      *
      * 
@@ -6810,8 +6827,8 @@ public Builder mergeFrom(
        *
        *
        * 
                                            -       * Optional. The name of the Cloud KMS key that will be used to encrypt
-       * objects inserted into this bucket, if no encryption method is specified.
+       * Optional. The name of the Cloud KMS key that is used to encrypt objects
+       * inserted into this bucket, if no encryption method is specified.
        * 
                                            
        *
        * 
@@ -6836,8 +6853,8 @@ public java.lang.String getDefaultKmsKey() {
        *
        *
        * 
                                            -       * Optional. The name of the Cloud KMS key that will be used to encrypt
-       * objects inserted into this bucket, if no encryption method is specified.
+       * Optional. The name of the Cloud KMS key that is used to encrypt objects
+       * inserted into this bucket, if no encryption method is specified.
        * 
                                            
        *
        * 
@@ -6862,8 +6879,8 @@ public com.google.protobuf.ByteString getDefaultKmsKeyBytes() {
        *
        *
        * 
                                            -       * Optional. The name of the Cloud KMS key that will be used to encrypt
-       * objects inserted into this bucket, if no encryption method is specified.
+       * Optional. The name of the Cloud KMS key that is used to encrypt objects
+       * inserted into this bucket, if no encryption method is specified.
        * 
                                            
        *
        * 
@@ -6887,8 +6904,8 @@ public Builder setDefaultKmsKey(java.lang.String value) {
        *
        *
        * 
                                            -       * Optional. The name of the Cloud KMS key that will be used to encrypt
-       * objects inserted into this bucket, if no encryption method is specified.
+       * Optional. The name of the Cloud KMS key that is used to encrypt objects
+       * inserted into this bucket, if no encryption method is specified.
        * 
                                            
        *
        * 
@@ -6908,8 +6925,8 @@ public Builder clearDefaultKmsKey() {
        *
        *
        * 
                                            -       * Optional. The name of the Cloud KMS key that will be used to encrypt
-       * objects inserted into this bucket, if no encryption method is specified.
+       * Optional. The name of the Cloud KMS key that is used to encrypt objects
+       * inserted into this bucket, if no encryption method is specified.
        * 
                                            
        *
        * 
@@ -7835,8 +7852,8 @@ public interface IamConfigOrBuilder
      *
      *
      * 
                                            -     * Optional. Whether IAM will enforce public access prevention. Valid values
-     * are "enforced" or "inherited".
+     * Optional. Whether IAM enforces public access prevention. Valid values are
+     * `enforced` or `inherited`.
      * 
                                            
      *
      * string public_access_prevention = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -7849,8 +7866,8 @@ public interface IamConfigOrBuilder
      *
      *
      * 
                                            -     * Optional. Whether IAM will enforce public access prevention. Valid values
-     * are "enforced" or "inherited".
+     * Optional. Whether IAM enforces public access prevention. Valid values are
+     * `enforced` or `inherited`.
      * 
                                            
      *
      * string public_access_prevention = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -8928,8 +8945,8 @@ public boolean hasUniformBucketLevelAccess() {
      *
      *
      * 
                                            -     * Optional. Whether IAM will enforce public access prevention. Valid values
-     * are "enforced" or "inherited".
+     * Optional. Whether IAM enforces public access prevention. Valid values are
+     * `enforced` or `inherited`.
      * 
                                            
      *
      * string public_access_prevention = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -8953,8 +8970,8 @@ public java.lang.String getPublicAccessPrevention() {
      *
      *
      * 
                                            -     * Optional. Whether IAM will enforce public access prevention. Valid values
-     * are "enforced" or "inherited".
+     * Optional. Whether IAM enforces public access prevention. Valid values are
+     * `enforced` or `inherited`.
      * 
                                            
      *
      * string public_access_prevention = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -9597,8 +9614,8 @@ public Builder clearUniformBucketLevelAccess() {
        *
        *
        * 
                                            -       * Optional. Whether IAM will enforce public access prevention. Valid values
-       * are "enforced" or "inherited".
+       * Optional. Whether IAM enforces public access prevention. Valid values are
+       * `enforced` or `inherited`.
        * 
                                            
        *
        * string public_access_prevention = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -9621,8 +9638,8 @@ public java.lang.String getPublicAccessPrevention() {
        *
        *
        * 
                                            -       * Optional. Whether IAM will enforce public access prevention. Valid values
-       * are "enforced" or "inherited".
+       * Optional. Whether IAM enforces public access prevention. Valid values are
+       * `enforced` or `inherited`.
        * 
                                            
        *
        * string public_access_prevention = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -9645,8 +9662,8 @@ public com.google.protobuf.ByteString getPublicAccessPreventionBytes() {
        *
        *
        * 
                                            -       * Optional. Whether IAM will enforce public access prevention. Valid values
-       * are "enforced" or "inherited".
+       * Optional. Whether IAM enforces public access prevention. Valid values are
+       * `enforced` or `inherited`.
        * 
                                            
        *
        * string public_access_prevention = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -9668,8 +9685,8 @@ public Builder setPublicAccessPrevention(java.lang.String value) {
        *
        *
        * 
                                            -       * Optional. Whether IAM will enforce public access prevention. Valid values
-       * are "enforced" or "inherited".
+       * Optional. Whether IAM enforces public access prevention. Valid values are
+       * `enforced` or `inherited`.
        * 
                                            
        *
        * string public_access_prevention = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -9687,8 +9704,8 @@ public Builder clearPublicAccessPrevention() {
        *
        *
        * 
                                            -       * Optional. Whether IAM will enforce public access prevention. Valid values
-       * are "enforced" or "inherited".
+       * Optional. Whether IAM enforces public access prevention. Valid values are
+       * `enforced` or `inherited`.
        * 
                                            
        *
        * string public_access_prevention = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -9781,7 +9798,7 @@ public interface LifecycleOrBuilder
      *
      * 
                                                  * Optional. A lifecycle management rule, which is made of an action to take
-     * and the condition(s) under which the action will be taken.
+     * and the condition under which the action is taken.
      * 
                                            
      *
      * 
@@ -9795,7 +9812,7 @@ public interface LifecycleOrBuilder
      *
      * 
                                                  * Optional. A lifecycle management rule, which is made of an action to take
-     * and the condition(s) under which the action will be taken.
+     * and the condition under which the action is taken.
      * 
                                            
      *
      * 
@@ -9809,7 +9826,7 @@ public interface LifecycleOrBuilder
      *
      * 
                                                  * Optional. A lifecycle management rule, which is made of an action to take
-     * and the condition(s) under which the action will be taken.
+     * and the condition under which the action is taken.
      * 
                                            
      *
      * 
@@ -9823,7 +9840,7 @@ public interface LifecycleOrBuilder
      *
      * 
                                                  * Optional. A lifecycle management rule, which is made of an action to take
-     * and the condition(s) under which the action will be taken.
+     * and the condition under which the action is taken.
      * 
                                            
      *
      * 
@@ -9838,7 +9855,7 @@ public interface LifecycleOrBuilder
      *
      * 
                                                  * Optional. A lifecycle management rule, which is made of an action to take
-     * and the condition(s) under which the action will be taken.
+     * and the condition under which the action is taken.
      * 
                                            
      *
      * 
@@ -9853,7 +9870,8 @@ public interface LifecycleOrBuilder
    *
    * 
                                                * Lifecycle properties of a bucket.
-   * For more information, see https://cloud.google.com/storage/docs/lifecycle.
+   * For more information, see [Object Lifecycle
+   * Management](https://cloud.google.com/storage/docs/lifecycle).
    * 
                                            
    *
    * Protobuf type {@code google.storage.v2.Bucket.Lifecycle}
@@ -9946,7 +9964,7 @@ public interface RuleOrBuilder
        *
        *
        * 
                                            -       * Optional. The condition(s) under which the action will be taken.
+       * Optional. The condition under which the action is taken.
        * 
                                            
        *
        * 
@@ -9961,7 +9979,7 @@ public interface RuleOrBuilder
        *
        *
        * 
                                            -       * Optional. The condition(s) under which the action will be taken.
+       * Optional. The condition under which the action is taken.
        * 
                                            
        *
        * 
@@ -9976,7 +9994,7 @@ public interface RuleOrBuilder
        *
        *
        * 
                                            -       * Optional. The condition(s) under which the action will be taken.
+       * Optional. The condition under which the action is taken.
        * 
                                            
        *
        * 
@@ -9991,7 +10009,7 @@ public interface RuleOrBuilder
      *
      * 
                                                  * A lifecycle Rule, combining an action to take on an object and a
-     * condition which will trigger that action.
+     * condition which triggers that action.
      * 
                                            
      *
      * Protobuf type {@code google.storage.v2.Bucket.Lifecycle.Rule}
@@ -11072,8 +11090,8 @@ public interface ConditionOrBuilder
          *
          * 
                                                      * Optional. Objects having any of the storage classes specified by this
-         * condition will be matched. Values include `MULTI_REGIONAL`,
-         * `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and
+         * condition are matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+         * `NEARLINE`, `COLDLINE`, `STANDARD`, and
          * `DURABLE_REDUCED_AVAILABILITY`.
          * 
                                            
          *
@@ -11090,8 +11108,8 @@ public interface ConditionOrBuilder
          *
          * 
                                                      * Optional. Objects having any of the storage classes specified by this
-         * condition will be matched. Values include `MULTI_REGIONAL`,
-         * `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and
+         * condition are matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+         * `NEARLINE`, `COLDLINE`, `STANDARD`, and
          * `DURABLE_REDUCED_AVAILABILITY`.
          * 
                                            
          *
@@ -11108,8 +11126,8 @@ public interface ConditionOrBuilder
          *
          * 
                                                      * Optional. Objects having any of the storage classes specified by this
-         * condition will be matched. Values include `MULTI_REGIONAL`,
-         * `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and
+         * condition are matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+         * `NEARLINE`, `COLDLINE`, `STANDARD`, and
          * `DURABLE_REDUCED_AVAILABILITY`.
          * 
                                            
          *
@@ -11127,8 +11145,8 @@ public interface ConditionOrBuilder
          *
          * 
                                                      * Optional. Objects having any of the storage classes specified by this
-         * condition will be matched. Values include `MULTI_REGIONAL`,
-         * `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and
+         * condition are matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+         * `NEARLINE`, `COLDLINE`, `STANDARD`, and
          * `DURABLE_REDUCED_AVAILABILITY`.
          * 
                                            
          *
@@ -11221,7 +11239,7 @@ public interface ConditionOrBuilder
          * This condition is relevant only for versioned objects. An object
          * version satisfies this condition only if these many days have been
          * passed since it became noncurrent. The value of the field must be a
-         * nonnegative integer. If it's zero, the object version will become
+         * nonnegative integer. If it's zero, the object version becomes
          * eligible for Lifecycle action as soon as it becomes noncurrent.
          * 
                                            
          *
@@ -11238,7 +11256,7 @@ public interface ConditionOrBuilder
          * This condition is relevant only for versioned objects. An object
          * version satisfies this condition only if these many days have been
          * passed since it became noncurrent. The value of the field must be a
-         * nonnegative integer. If it's zero, the object version will become
+         * nonnegative integer. If it's zero, the object version becomes
          * eligible for Lifecycle action as soon as it becomes noncurrent.
          * 
                                            
          *
@@ -11659,8 +11677,8 @@ public int getNumNewerVersions() {
          *
          * 
                                                      * Optional. Objects having any of the storage classes specified by this
-         * condition will be matched. Values include `MULTI_REGIONAL`,
-         * `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and
+         * condition are matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+         * `NEARLINE`, `COLDLINE`, `STANDARD`, and
          * `DURABLE_REDUCED_AVAILABILITY`.
          * 
                                            
          *
@@ -11679,8 +11697,8 @@ public com.google.protobuf.ProtocolStringList getMatchesStorageClassList() {
          *
          * 
                                                      * Optional. Objects having any of the storage classes specified by this
-         * condition will be matched. Values include `MULTI_REGIONAL`,
-         * `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and
+         * condition are matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+         * `NEARLINE`, `COLDLINE`, `STANDARD`, and
          * `DURABLE_REDUCED_AVAILABILITY`.
          * 
                                            
          *
@@ -11699,8 +11717,8 @@ public int getMatchesStorageClassCount() {
          *
          * 
                                                      * Optional. Objects having any of the storage classes specified by this
-         * condition will be matched. Values include `MULTI_REGIONAL`,
-         * `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and
+         * condition are matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+         * `NEARLINE`, `COLDLINE`, `STANDARD`, and
          * `DURABLE_REDUCED_AVAILABILITY`.
          * 
                                            
          *
@@ -11720,8 +11738,8 @@ public java.lang.String getMatchesStorageClass(int index) {
          *
          * 
                                                      * Optional. Objects having any of the storage classes specified by this
-         * condition will be matched. Values include `MULTI_REGIONAL`,
-         * `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and
+         * condition are matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+         * `NEARLINE`, `COLDLINE`, `STANDARD`, and
          * `DURABLE_REDUCED_AVAILABILITY`.
          * 
                                            
          *
@@ -11844,7 +11862,7 @@ public com.google.type.DateOrBuilder getCustomTimeBeforeOrBuilder() {
          * This condition is relevant only for versioned objects. An object
          * version satisfies this condition only if these many days have been
          * passed since it became noncurrent. The value of the field must be a
-         * nonnegative integer. If it's zero, the object version will become
+         * nonnegative integer. If it's zero, the object version becomes
          * eligible for Lifecycle action as soon as it becomes noncurrent.
          * 
                                            
          *
@@ -11864,7 +11882,7 @@ public boolean hasDaysSinceNoncurrentTime() {
          * This condition is relevant only for versioned objects. An object
          * version satisfies this condition only if these many days have been
          * passed since it became noncurrent. The value of the field must be a
-         * nonnegative integer. If it's zero, the object version will become
+         * nonnegative integer. If it's zero, the object version becomes
          * eligible for Lifecycle action as soon as it becomes noncurrent.
          * 
                                            
          *
@@ -13269,8 +13287,8 @@ private void ensureMatchesStorageClassIsMutable() {
            *
            * 
                                                        * Optional. Objects having any of the storage classes specified by this
-           * condition will be matched. Values include `MULTI_REGIONAL`,
-           * `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and
+           * condition are matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+           * `NEARLINE`, `COLDLINE`, `STANDARD`, and
            * `DURABLE_REDUCED_AVAILABILITY`.
            * 
                                            
            *
@@ -13290,8 +13308,8 @@ public com.google.protobuf.ProtocolStringList getMatchesStorageClassList() {
            *
            * 
                                                        * Optional. Objects having any of the storage classes specified by this
-           * condition will be matched. Values include `MULTI_REGIONAL`,
-           * `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and
+           * condition are matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+           * `NEARLINE`, `COLDLINE`, `STANDARD`, and
            * `DURABLE_REDUCED_AVAILABILITY`.
            * 
                                            
            *
@@ -13310,8 +13328,8 @@ public int getMatchesStorageClassCount() {
            *
            * 
                                                        * Optional. Objects having any of the storage classes specified by this
-           * condition will be matched. Values include `MULTI_REGIONAL`,
-           * `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and
+           * condition are matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+           * `NEARLINE`, `COLDLINE`, `STANDARD`, and
            * `DURABLE_REDUCED_AVAILABILITY`.
            * 
                                            
            *
@@ -13331,8 +13349,8 @@ public java.lang.String getMatchesStorageClass(int index) {
            *
            * 
                                                        * Optional. Objects having any of the storage classes specified by this
-           * condition will be matched. Values include `MULTI_REGIONAL`,
-           * `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and
+           * condition are matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+           * `NEARLINE`, `COLDLINE`, `STANDARD`, and
            * `DURABLE_REDUCED_AVAILABILITY`.
            * 
                                            
            *
@@ -13352,8 +13370,8 @@ public com.google.protobuf.ByteString getMatchesStorageClassBytes(int index) {
            *
            * 
                                                        * Optional. Objects having any of the storage classes specified by this
-           * condition will be matched. Values include `MULTI_REGIONAL`,
-           * `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and
+           * condition are matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+           * `NEARLINE`, `COLDLINE`, `STANDARD`, and
            * `DURABLE_REDUCED_AVAILABILITY`.
            * 
                                            
            *
@@ -13381,8 +13399,8 @@ public Builder setMatchesStorageClass(int index, java.lang.String value) {
            *
            * 
                                                        * Optional. Objects having any of the storage classes specified by this
-           * condition will be matched. Values include `MULTI_REGIONAL`,
-           * `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and
+           * condition are matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+           * `NEARLINE`, `COLDLINE`, `STANDARD`, and
            * `DURABLE_REDUCED_AVAILABILITY`.
            * 
                                            
            *
@@ -13409,8 +13427,8 @@ public Builder addMatchesStorageClass(java.lang.String value) {
            *
            * 
                                                        * Optional. Objects having any of the storage classes specified by this
-           * condition will be matched. Values include `MULTI_REGIONAL`,
-           * `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and
+           * condition are matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+           * `NEARLINE`, `COLDLINE`, `STANDARD`, and
            * `DURABLE_REDUCED_AVAILABILITY`.
            * 
                                            
            *
@@ -13434,8 +13452,8 @@ public Builder addAllMatchesStorageClass(java.lang.Iterable va
            *
            * 
                                                        * Optional. Objects having any of the storage classes specified by this
-           * condition will be matched. Values include `MULTI_REGIONAL`,
-           * `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and
+           * condition are matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+           * `NEARLINE`, `COLDLINE`, `STANDARD`, and
            * `DURABLE_REDUCED_AVAILABILITY`.
            * 
                                            
            *
@@ -13458,8 +13476,8 @@ public Builder clearMatchesStorageClass() {
            *
            * 
                                                        * Optional. Objects having any of the storage classes specified by this
-           * condition will be matched. Values include `MULTI_REGIONAL`,
-           * `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and
+           * condition are matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+           * `NEARLINE`, `COLDLINE`, `STANDARD`, and
            * `DURABLE_REDUCED_AVAILABILITY`.
            * 
                                            
            *
@@ -13788,7 +13806,7 @@ public com.google.type.DateOrBuilder getCustomTimeBeforeOrBuilder() {
            * This condition is relevant only for versioned objects. An object
            * version satisfies this condition only if these many days have been
            * passed since it became noncurrent. The value of the field must be a
-           * nonnegative integer. If it's zero, the object version will become
+           * nonnegative integer. If it's zero, the object version becomes
            * eligible for Lifecycle action as soon as it becomes noncurrent.
            * 
                                            
            *
@@ -13808,7 +13826,7 @@ public boolean hasDaysSinceNoncurrentTime() {
            * This condition is relevant only for versioned objects. An object
            * version satisfies this condition only if these many days have been
            * passed since it became noncurrent. The value of the field must be a
-           * nonnegative integer. If it's zero, the object version will become
+           * nonnegative integer. If it's zero, the object version becomes
            * eligible for Lifecycle action as soon as it becomes noncurrent.
            * 
                                            
            *
@@ -13828,7 +13846,7 @@ public int getDaysSinceNoncurrentTime() {
            * This condition is relevant only for versioned objects. An object
            * version satisfies this condition only if these many days have been
            * passed since it became noncurrent. The value of the field must be a
-           * nonnegative integer. If it's zero, the object version will become
+           * nonnegative integer. If it's zero, the object version becomes
            * eligible for Lifecycle action as soon as it becomes noncurrent.
            * 
                                            
            *
@@ -13852,7 +13870,7 @@ public Builder setDaysSinceNoncurrentTime(int value) {
            * This condition is relevant only for versioned objects. An object
            * version satisfies this condition only if these many days have been
            * passed since it became noncurrent. The value of the field must be a
-           * nonnegative integer. If it's zero, the object version will become
+           * nonnegative integer. If it's zero, the object version becomes
            * eligible for Lifecycle action as soon as it becomes noncurrent.
            * 
                                            
            *
@@ -14626,7 +14644,7 @@ public com.google.storage.v2.Bucket.Lifecycle.Rule.ActionOrBuilder getActionOrBu
        *
        *
        * 
                                            -       * Optional. The condition(s) under which the action will be taken.
+       * Optional. The condition under which the action is taken.
        * 
                                            
        *
        * 
@@ -14644,7 +14662,7 @@ public boolean hasCondition() {
        *
        *
        * 
                                            -       * Optional. The condition(s) under which the action will be taken.
+       * Optional. The condition under which the action is taken.
        * 
                                            
        *
        * 
@@ -14664,7 +14682,7 @@ public com.google.storage.v2.Bucket.Lifecycle.Rule.Condition getCondition() {
        *
        *
        * 
                                            -       * Optional. The condition(s) under which the action will be taken.
+       * Optional. The condition under which the action is taken.
        * 
                                            
        *
        * 
@@ -14864,7 +14882,7 @@ protected Builder newBuilderForType(
        *
        * 
                                                    * A lifecycle Rule, combining an action to take on an object and a
-       * condition which will trigger that action.
+       * condition which triggers that action.
        * 
                                            
        *
        * Protobuf type {@code google.storage.v2.Bucket.Lifecycle.Rule}
@@ -15304,7 +15322,7 @@ public com.google.storage.v2.Bucket.Lifecycle.Rule.ActionOrBuilder getActionOrBu
          *
          *
          * 
                                            -         * Optional. The condition(s) under which the action will be taken.
+         * Optional. The condition under which the action is taken.
          * 
                                            
          *
          * 
@@ -15321,7 +15339,7 @@ public boolean hasCondition() {
          *
          *
          * 
                                            -         * Optional. The condition(s) under which the action will be taken.
+         * Optional. The condition under which the action is taken.
          * 
                                            
          *
          * 
@@ -15344,7 +15362,7 @@ public com.google.storage.v2.Bucket.Lifecycle.Rule.Condition getCondition() {
          *
          *
          * 
                                            -         * Optional. The condition(s) under which the action will be taken.
+         * Optional. The condition under which the action is taken.
          * 
                                            
          *
          * 
@@ -15369,7 +15387,7 @@ public Builder setCondition(com.google.storage.v2.Bucket.Lifecycle.Rule.Conditio
          *
          *
          * 
                                            -         * Optional. The condition(s) under which the action will be taken.
+         * Optional. The condition under which the action is taken.
          * 
                                            
          *
          * 
@@ -15392,7 +15410,7 @@ public Builder setCondition(
          *
          *
          * 
                                            -         * Optional. The condition(s) under which the action will be taken.
+         * Optional. The condition under which the action is taken.
          * 
                                            
          *
          * 
@@ -15423,7 +15441,7 @@ public Builder mergeCondition(com.google.storage.v2.Bucket.Lifecycle.Rule.Condit
          *
          *
          * 
                                            -         * Optional. The condition(s) under which the action will be taken.
+         * Optional. The condition under which the action is taken.
          * 
                                            
          *
          * 
@@ -15445,7 +15463,7 @@ public Builder clearCondition() {
          *
          *
          * 
                                            -         * Optional. The condition(s) under which the action will be taken.
+         * Optional. The condition under which the action is taken.
          * 
                                            
          *
          * 
@@ -15462,7 +15480,7 @@ public com.google.storage.v2.Bucket.Lifecycle.Rule.Condition.Builder getConditio
          *
          *
          * 
                                            -         * Optional. The condition(s) under which the action will be taken.
+         * Optional. The condition under which the action is taken.
          * 
                                            
          *
          * 
@@ -15484,7 +15502,7 @@ public com.google.storage.v2.Bucket.Lifecycle.Rule.Condition.Builder getConditio
          *
          *
          * 
                                            -         * Optional. The condition(s) under which the action will be taken.
+         * Optional. The condition under which the action is taken.
          * 
                                            
          *
          * 
@@ -15582,7 +15600,7 @@ public com.google.storage.v2.Bucket.Lifecycle.Rule getDefaultInstanceForType() {
      *
      * 
                                                  * Optional. A lifecycle management rule, which is made of an action to take
-     * and the condition(s) under which the action will be taken.
+     * and the condition under which the action is taken.
      * 
                                            
      *
      * 
@@ -15599,7 +15617,7 @@ public java.util.List getRuleList()
      *
      * 
                                                  * Optional. A lifecycle management rule, which is made of an action to take
-     * and the condition(s) under which the action will be taken.
+     * and the condition under which the action is taken.
      * 
                                            
      *
      * 
@@ -15617,7 +15635,7 @@ public java.util.List getRuleList()
      *
      * 
                                                  * Optional. A lifecycle management rule, which is made of an action to take
-     * and the condition(s) under which the action will be taken.
+     * and the condition under which the action is taken.
      * 
                                            
      *
      * 
@@ -15634,7 +15652,7 @@ public int getRuleCount() {
      *
      * 
                                                  * Optional. A lifecycle management rule, which is made of an action to take
-     * and the condition(s) under which the action will be taken.
+     * and the condition under which the action is taken.
      * 
                                            
      *
      * 
@@ -15651,7 +15669,7 @@ public com.google.storage.v2.Bucket.Lifecycle.Rule getRule(int index) {
      *
      * 
                                                  * Optional. A lifecycle management rule, which is made of an action to take
-     * and the condition(s) under which the action will be taken.
+     * and the condition under which the action is taken.
      * 
                                            
      *
      * 
@@ -15830,7 +15848,8 @@ protected Builder newBuilderForType(
      *
      * 
                                                  * Lifecycle properties of a bucket.
-     * For more information, see https://cloud.google.com/storage/docs/lifecycle.
+     * For more information, see [Object Lifecycle
+     * Management](https://cloud.google.com/storage/docs/lifecycle).
      * 
                                            
      *
      * Protobuf type {@code google.storage.v2.Bucket.Lifecycle}
@@ -16077,7 +16096,7 @@ private void ensureRuleIsMutable() {
        *
        * 
                                                    * Optional. A lifecycle management rule, which is made of an action to take
-       * and the condition(s) under which the action will be taken.
+       * and the condition under which the action is taken.
        * 
                                            
        *
        * 
@@ -16097,7 +16116,7 @@ public java.util.List getRuleList()
        *
        * 
                                                    * Optional. A lifecycle management rule, which is made of an action to take
-       * and the condition(s) under which the action will be taken.
+       * and the condition under which the action is taken.
        * 
                                            
        *
        * 
@@ -16117,7 +16136,7 @@ public int getRuleCount() {
        *
        * 
                                                    * Optional. A lifecycle management rule, which is made of an action to take
-       * and the condition(s) under which the action will be taken.
+       * and the condition under which the action is taken.
        * 
                                            
        *
        * 
@@ -16137,7 +16156,7 @@ public com.google.storage.v2.Bucket.Lifecycle.Rule getRule(int index) {
        *
        * 
                                                    * Optional. A lifecycle management rule, which is made of an action to take
-       * and the condition(s) under which the action will be taken.
+       * and the condition under which the action is taken.
        * 
                                            
        *
        * 
@@ -16163,7 +16182,7 @@ public Builder setRule(int index, com.google.storage.v2.Bucket.Lifecycle.Rule va
        *
        * 
                                                    * Optional. A lifecycle management rule, which is made of an action to take
-       * and the condition(s) under which the action will be taken.
+       * and the condition under which the action is taken.
        * 
                                            
        *
        * 
@@ -16187,7 +16206,7 @@ public Builder setRule(
        *
        * 
                                                    * Optional. A lifecycle management rule, which is made of an action to take
-       * and the condition(s) under which the action will be taken.
+       * and the condition under which the action is taken.
        * 
                                            
        *
        * 
@@ -16213,7 +16232,7 @@ public Builder addRule(com.google.storage.v2.Bucket.Lifecycle.Rule value) {
        *
        * 
                                                    * Optional. A lifecycle management rule, which is made of an action to take
-       * and the condition(s) under which the action will be taken.
+       * and the condition under which the action is taken.
        * 
                                            
        *
        * 
@@ -16239,7 +16258,7 @@ public Builder addRule(int index, com.google.storage.v2.Bucket.Lifecycle.Rule va
        *
        * 
                                                    * Optional. A lifecycle management rule, which is made of an action to take
-       * and the condition(s) under which the action will be taken.
+       * and the condition under which the action is taken.
        * 
                                            
        *
        * 
@@ -16262,7 +16281,7 @@ public Builder addRule(com.google.storage.v2.Bucket.Lifecycle.Rule.Builder build
        *
        * 
                                                    * Optional. A lifecycle management rule, which is made of an action to take
-       * and the condition(s) under which the action will be taken.
+       * and the condition under which the action is taken.
        * 
                                            
        *
        * 
@@ -16286,7 +16305,7 @@ public Builder addRule(
        *
        * 
                                                    * Optional. A lifecycle management rule, which is made of an action to take
-       * and the condition(s) under which the action will be taken.
+       * and the condition under which the action is taken.
        * 
                                            
        *
        * 
@@ -16310,7 +16329,7 @@ public Builder addAllRule(
        *
        * 
                                                    * Optional. A lifecycle management rule, which is made of an action to take
-       * and the condition(s) under which the action will be taken.
+       * and the condition under which the action is taken.
        * 
                                            
        *
        * 
@@ -16333,7 +16352,7 @@ public Builder clearRule() {
        *
        * 
                                                    * Optional. A lifecycle management rule, which is made of an action to take
-       * and the condition(s) under which the action will be taken.
+       * and the condition under which the action is taken.
        * 
                                            
        *
        * 
@@ -16356,7 +16375,7 @@ public Builder removeRule(int index) {
        *
        * 
                                                    * Optional. A lifecycle management rule, which is made of an action to take
-       * and the condition(s) under which the action will be taken.
+       * and the condition under which the action is taken.
        * 
                                            
        *
        * 
@@ -16372,7 +16391,7 @@ public com.google.storage.v2.Bucket.Lifecycle.Rule.Builder getRuleBuilder(int in
        *
        * 
                                                    * Optional. A lifecycle management rule, which is made of an action to take
-       * and the condition(s) under which the action will be taken.
+       * and the condition under which the action is taken.
        * 
                                            
        *
        * 
@@ -16392,7 +16411,7 @@ public com.google.storage.v2.Bucket.Lifecycle.RuleOrBuilder getRuleOrBuilder(int
        *
        * 
                                                    * Optional. A lifecycle management rule, which is made of an action to take
-       * and the condition(s) under which the action will be taken.
+       * and the condition under which the action is taken.
        * 
                                            
        *
        * 
@@ -16413,7 +16432,7 @@ public com.google.storage.v2.Bucket.Lifecycle.RuleOrBuilder getRuleOrBuilder(int
        *
        * 
                                                    * Optional. A lifecycle management rule, which is made of an action to take
-       * and the condition(s) under which the action will be taken.
+       * and the condition under which the action is taken.
        * 
                                            
        *
        * 
@@ -16430,7 +16449,7 @@ public com.google.storage.v2.Bucket.Lifecycle.Rule.Builder addRuleBuilder() {
        *
        * 
                                                    * Optional. A lifecycle management rule, which is made of an action to take
-       * and the condition(s) under which the action will be taken.
+       * and the condition under which the action is taken.
        * 
                                            
        *
        * 
@@ -16447,7 +16466,7 @@ public com.google.storage.v2.Bucket.Lifecycle.Rule.Builder addRuleBuilder(int in
        *
        * 
                                                    * Optional. A lifecycle management rule, which is made of an action to take
-       * and the condition(s) under which the action will be taken.
+       * and the condition under which the action is taken.
        * 
                                            
        *
        * 
@@ -18046,7 +18065,7 @@ public interface RetentionPolicyOrBuilder
      * duration must be greater than zero and less than 100 years. Note that
      * enforcement of retention periods less than a day is not guaranteed. Such
      * periods should only be used for testing purposes. Any `nanos` value
-     * specified will be rounded down to the nearest second.
+     * specified is rounded down to the nearest second.
      * 
                                            
      *
      * 
@@ -18065,7 +18084,7 @@ public interface RetentionPolicyOrBuilder
      * duration must be greater than zero and less than 100 years. Note that
      * enforcement of retention periods less than a day is not guaranteed. Such
      * periods should only be used for testing purposes. Any `nanos` value
-     * specified will be rounded down to the nearest second.
+     * specified is rounded down to the nearest second.
      * 
                                            
      *
      * 
@@ -18084,7 +18103,7 @@ public interface RetentionPolicyOrBuilder
      * duration must be greater than zero and less than 100 years. Note that
      * enforcement of retention periods less than a day is not guaranteed. Such
      * periods should only be used for testing purposes. Any `nanos` value
-     * specified will be rounded down to the nearest second.
+     * specified is rounded down to the nearest second.
      * 
                                            
      *
      * 
@@ -18230,7 +18249,7 @@ public boolean getIsLocked() {
      * duration must be greater than zero and less than 100 years. Note that
      * enforcement of retention periods less than a day is not guaranteed. Such
      * periods should only be used for testing purposes. Any `nanos` value
-     * specified will be rounded down to the nearest second.
+     * specified is rounded down to the nearest second.
      * 
                                            
      *
      * 
@@ -18252,7 +18271,7 @@ public boolean hasRetentionDuration() {
      * duration must be greater than zero and less than 100 years. Note that
      * enforcement of retention periods less than a day is not guaranteed. Such
      * periods should only be used for testing purposes. Any `nanos` value
-     * specified will be rounded down to the nearest second.
+     * specified is rounded down to the nearest second.
      * 
                                            
      *
      * 
@@ -18276,7 +18295,7 @@ public com.google.protobuf.Duration getRetentionDuration() {
      * duration must be greater than zero and less than 100 years. Note that
      * enforcement of retention periods less than a day is not guaranteed. Such
      * periods should only be used for testing purposes. Any `nanos` value
-     * specified will be rounded down to the nearest second.
+     * specified is rounded down to the nearest second.
      * 
                                            
      *
      * 
@@ -19007,7 +19026,7 @@ public Builder clearIsLocked() {
        * duration must be greater than zero and less than 100 years. Note that
        * enforcement of retention periods less than a day is not guaranteed. Such
        * periods should only be used for testing purposes. Any `nanos` value
-       * specified will be rounded down to the nearest second.
+       * specified is rounded down to the nearest second.
        * 
                                            
        *
        * 
@@ -19028,7 +19047,7 @@ public boolean hasRetentionDuration() {
        * duration must be greater than zero and less than 100 years. Note that
        * enforcement of retention periods less than a day is not guaranteed. Such
        * periods should only be used for testing purposes. Any `nanos` value
-       * specified will be rounded down to the nearest second.
+       * specified is rounded down to the nearest second.
        * 
                                            
        *
        * 
@@ -19055,7 +19074,7 @@ public com.google.protobuf.Duration getRetentionDuration() {
        * duration must be greater than zero and less than 100 years. Note that
        * enforcement of retention periods less than a day is not guaranteed. Such
        * periods should only be used for testing purposes. Any `nanos` value
-       * specified will be rounded down to the nearest second.
+       * specified is rounded down to the nearest second.
        * 
                                            
        *
        * 
@@ -19084,7 +19103,7 @@ public Builder setRetentionDuration(com.google.protobuf.Duration value) {
        * duration must be greater than zero and less than 100 years. Note that
        * enforcement of retention periods less than a day is not guaranteed. Such
        * periods should only be used for testing purposes. Any `nanos` value
-       * specified will be rounded down to the nearest second.
+       * specified is rounded down to the nearest second.
        * 
                                            
        *
        * 
@@ -19110,7 +19129,7 @@ public Builder setRetentionDuration(com.google.protobuf.Duration.Builder builder
        * duration must be greater than zero and less than 100 years. Note that
        * enforcement of retention periods less than a day is not guaranteed. Such
        * periods should only be used for testing purposes. Any `nanos` value
-       * specified will be rounded down to the nearest second.
+       * specified is rounded down to the nearest second.
        * 
                                            
        *
        * 
@@ -19144,7 +19163,7 @@ public Builder mergeRetentionDuration(com.google.protobuf.Duration value) {
        * duration must be greater than zero and less than 100 years. Note that
        * enforcement of retention periods less than a day is not guaranteed. Such
        * periods should only be used for testing purposes. Any `nanos` value
-       * specified will be rounded down to the nearest second.
+       * specified is rounded down to the nearest second.
        * 
                                            
        *
        * 
@@ -19170,7 +19189,7 @@ public Builder clearRetentionDuration() {
        * duration must be greater than zero and less than 100 years. Note that
        * enforcement of retention periods less than a day is not guaranteed. Such
        * periods should only be used for testing purposes. Any `nanos` value
-       * specified will be rounded down to the nearest second.
+       * specified is rounded down to the nearest second.
        * 
                                            
        *
        * 
@@ -19191,7 +19210,7 @@ public com.google.protobuf.Duration.Builder getRetentionDurationBuilder() {
        * duration must be greater than zero and less than 100 years. Note that
        * enforcement of retention periods less than a day is not guaranteed. Such
        * periods should only be used for testing purposes. Any `nanos` value
-       * specified will be rounded down to the nearest second.
+       * specified is rounded down to the nearest second.
        * 
                                            
        *
        * 
@@ -19216,7 +19235,7 @@ public com.google.protobuf.DurationOrBuilder getRetentionDurationOrBuilder() {
        * duration must be greater than zero and less than 100 years. Note that
        * enforcement of retention periods less than a day is not guaranteed. Such
        * periods should only be used for testing purposes. Any `nanos` value
-       * specified will be rounded down to the nearest second.
+       * specified is rounded down to the nearest second.
        * 
                                            
        *
        * 
@@ -20444,8 +20463,8 @@ public interface VersioningOrBuilder
    *
    * 
                                                * Properties of a bucket related to versioning.
-   * For more on Cloud Storage versioning, see
-   * https://cloud.google.com/storage/docs/object-versioning.
+   * For more information about Cloud Storage versioning, see [Object
+   * versioning](https://cloud.google.com/storage/docs/object-versioning).
    * 
                                            
    *
    * Protobuf type {@code google.storage.v2.Bucket.Versioning}
@@ -20668,8 +20687,8 @@ protected Builder newBuilderForType(
      *
      * 
                                                  * Properties of a bucket related to versioning.
-     * For more on Cloud Storage versioning, see
-     * https://cloud.google.com/storage/docs/object-versioning.
+     * For more information about Cloud Storage versioning, see [Object
+     * versioning](https://cloud.google.com/storage/docs/object-versioning).
      * 
                                            
      *
      * Protobuf type {@code google.storage.v2.Bucket.Versioning}
@@ -20977,10 +20996,10 @@ public interface WebsiteOrBuilder
      *
      *
      * 
                                            -     * Optional. If the requested object path is missing, the service will
-     * ensure the path has a trailing '/', append this suffix, and attempt to
-     * retrieve the resulting object. This allows the creation of `index.html`
-     * objects to represent directory pages.
+     * Optional. If the requested object path is missing, the service ensures
+     * the path has a trailing '/', append this suffix, and attempt to retrieve
+     * the resulting object. This allows the creation of `index.html` objects to
+     * represent directory pages.
      * 
                                            
      *
      * string main_page_suffix = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -20993,10 +21012,10 @@ public interface WebsiteOrBuilder
      *
      *
      * 
                                            -     * Optional. If the requested object path is missing, the service will
-     * ensure the path has a trailing '/', append this suffix, and attempt to
-     * retrieve the resulting object. This allows the creation of `index.html`
-     * objects to represent directory pages.
+     * Optional. If the requested object path is missing, the service ensures
+     * the path has a trailing '/', append this suffix, and attempt to retrieve
+     * the resulting object. This allows the creation of `index.html` objects to
+     * represent directory pages.
      * 
                                            
      *
      * string main_page_suffix = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -21011,8 +21030,8 @@ public interface WebsiteOrBuilder
      * 
                                                  * Optional. If the requested object path is missing, and any
      * `mainPageSuffix` object is missing, if applicable, the service
-     * will return the named object from this bucket as the content for a
-     * [https://tools.ietf.org/html/rfc7231#section-6.5.4][404 Not Found]
+     * returns the named object from this bucket as the content for a
+     * [404 Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)
      * result.
      * 
                                            
      *
@@ -21028,8 +21047,8 @@ public interface WebsiteOrBuilder
      * 
                                                  * Optional. If the requested object path is missing, and any
      * `mainPageSuffix` object is missing, if applicable, the service
-     * will return the named object from this bucket as the content for a
-     * [https://tools.ietf.org/html/rfc7231#section-6.5.4][404 Not Found]
+     * returns the named object from this bucket as the content for a
+     * [404 Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)
      * result.
      * 
                                            
      *
@@ -21045,8 +21064,8 @@ public interface WebsiteOrBuilder
    *
    * 
                                                * Properties of a bucket related to accessing the contents as a static
-   * website. For more on hosting a static website via Cloud Storage, see
-   * https://cloud.google.com/storage/docs/hosting-static-website.
+   * website. For details, see [hosting a static website using Cloud
+   * Storage](https://cloud.google.com/storage/docs/hosting-static-website).
    * 
                                            
    *
    * Protobuf type {@code google.storage.v2.Bucket.Website}
@@ -21097,10 +21116,10 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
      *
      *
      * 
                                            -     * Optional. If the requested object path is missing, the service will
-     * ensure the path has a trailing '/', append this suffix, and attempt to
-     * retrieve the resulting object. This allows the creation of `index.html`
-     * objects to represent directory pages.
+     * Optional. If the requested object path is missing, the service ensures
+     * the path has a trailing '/', append this suffix, and attempt to retrieve
+     * the resulting object. This allows the creation of `index.html` objects to
+     * represent directory pages.
      * 
                                            
      *
      * string main_page_suffix = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -21124,10 +21143,10 @@ public java.lang.String getMainPageSuffix() {
      *
      *
      * 
                                            -     * Optional. If the requested object path is missing, the service will
-     * ensure the path has a trailing '/', append this suffix, and attempt to
-     * retrieve the resulting object. This allows the creation of `index.html`
-     * objects to represent directory pages.
+     * Optional. If the requested object path is missing, the service ensures
+     * the path has a trailing '/', append this suffix, and attempt to retrieve
+     * the resulting object. This allows the creation of `index.html` objects to
+     * represent directory pages.
      * 
                                            
      *
      * string main_page_suffix = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -21158,8 +21177,8 @@ public com.google.protobuf.ByteString getMainPageSuffixBytes() {
      * 
                                                  * Optional. If the requested object path is missing, and any
      * `mainPageSuffix` object is missing, if applicable, the service
-     * will return the named object from this bucket as the content for a
-     * [https://tools.ietf.org/html/rfc7231#section-6.5.4][404 Not Found]
+     * returns the named object from this bucket as the content for a
+     * [404 Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)
      * result.
      * 
                                            
      *
@@ -21186,8 +21205,8 @@ public java.lang.String getNotFoundPage() {
      * 
                                                  * Optional. If the requested object path is missing, and any
      * `mainPageSuffix` object is missing, if applicable, the service
-     * will return the named object from this bucket as the content for a
-     * [https://tools.ietf.org/html/rfc7231#section-6.5.4][404 Not Found]
+     * returns the named object from this bucket as the content for a
+     * [404 Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)
      * result.
      * 
                                            
      *
@@ -21382,8 +21401,8 @@ protected Builder newBuilderForType(
      *
      * 
                                                  * Properties of a bucket related to accessing the contents as a static
-     * website. For more on hosting a static website via Cloud Storage, see
-     * https://cloud.google.com/storage/docs/hosting-static-website.
+     * website. For details, see [hosting a static website using Cloud
+     * Storage](https://cloud.google.com/storage/docs/hosting-static-website).
      * 
                                            
      *
      * Protobuf type {@code google.storage.v2.Bucket.Website}
@@ -21585,10 +21604,10 @@ public Builder mergeFrom(
        *
        *
        * 
                                            -       * Optional. If the requested object path is missing, the service will
-       * ensure the path has a trailing '/', append this suffix, and attempt to
-       * retrieve the resulting object. This allows the creation of `index.html`
-       * objects to represent directory pages.
+       * Optional. If the requested object path is missing, the service ensures
+       * the path has a trailing '/', append this suffix, and attempt to retrieve
+       * the resulting object. This allows the creation of `index.html` objects to
+       * represent directory pages.
        * 
                                            
        *
        * string main_page_suffix = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -21611,10 +21630,10 @@ public java.lang.String getMainPageSuffix() {
        *
        *
        * 
                                            -       * Optional. If the requested object path is missing, the service will
-       * ensure the path has a trailing '/', append this suffix, and attempt to
-       * retrieve the resulting object. This allows the creation of `index.html`
-       * objects to represent directory pages.
+       * Optional. If the requested object path is missing, the service ensures
+       * the path has a trailing '/', append this suffix, and attempt to retrieve
+       * the resulting object. This allows the creation of `index.html` objects to
+       * represent directory pages.
        * 
                                            
        *
        * string main_page_suffix = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -21637,10 +21656,10 @@ public com.google.protobuf.ByteString getMainPageSuffixBytes() {
        *
        *
        * 
                                            -       * Optional. If the requested object path is missing, the service will
-       * ensure the path has a trailing '/', append this suffix, and attempt to
-       * retrieve the resulting object. This allows the creation of `index.html`
-       * objects to represent directory pages.
+       * Optional. If the requested object path is missing, the service ensures
+       * the path has a trailing '/', append this suffix, and attempt to retrieve
+       * the resulting object. This allows the creation of `index.html` objects to
+       * represent directory pages.
        * 
                                            
        *
        * string main_page_suffix = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -21662,10 +21681,10 @@ public Builder setMainPageSuffix(java.lang.String value) {
        *
        *
        * 
                                            -       * Optional. If the requested object path is missing, the service will
-       * ensure the path has a trailing '/', append this suffix, and attempt to
-       * retrieve the resulting object. This allows the creation of `index.html`
-       * objects to represent directory pages.
+       * Optional. If the requested object path is missing, the service ensures
+       * the path has a trailing '/', append this suffix, and attempt to retrieve
+       * the resulting object. This allows the creation of `index.html` objects to
+       * represent directory pages.
        * 
                                            
        *
        * string main_page_suffix = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -21683,10 +21702,10 @@ public Builder clearMainPageSuffix() {
        *
        *
        * 
                                            -       * Optional. If the requested object path is missing, the service will
-       * ensure the path has a trailing '/', append this suffix, and attempt to
-       * retrieve the resulting object. This allows the creation of `index.html`
-       * objects to represent directory pages.
+       * Optional. If the requested object path is missing, the service ensures
+       * the path has a trailing '/', append this suffix, and attempt to retrieve
+       * the resulting object. This allows the creation of `index.html` objects to
+       * represent directory pages.
        * 
                                            
        *
        * string main_page_suffix = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -21713,8 +21732,8 @@ public Builder setMainPageSuffixBytes(com.google.protobuf.ByteString value) {
        * 
                                                    * Optional. If the requested object path is missing, and any
        * `mainPageSuffix` object is missing, if applicable, the service
-       * will return the named object from this bucket as the content for a
-       * [https://tools.ietf.org/html/rfc7231#section-6.5.4][404 Not Found]
+       * returns the named object from this bucket as the content for a
+       * [404 Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)
        * result.
        * 
                                            
        *
@@ -21740,8 +21759,8 @@ public java.lang.String getNotFoundPage() {
        * 
                                                    * Optional. If the requested object path is missing, and any
        * `mainPageSuffix` object is missing, if applicable, the service
-       * will return the named object from this bucket as the content for a
-       * [https://tools.ietf.org/html/rfc7231#section-6.5.4][404 Not Found]
+       * returns the named object from this bucket as the content for a
+       * [404 Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)
        * result.
        * 
                                            
        *
@@ -21767,8 +21786,8 @@ public com.google.protobuf.ByteString getNotFoundPageBytes() {
        * 
                                                    * Optional. If the requested object path is missing, and any
        * `mainPageSuffix` object is missing, if applicable, the service
-       * will return the named object from this bucket as the content for a
-       * [https://tools.ietf.org/html/rfc7231#section-6.5.4][404 Not Found]
+       * returns the named object from this bucket as the content for a
+       * [404 Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)
        * result.
        * 
                                            
        *
@@ -21793,8 +21812,8 @@ public Builder setNotFoundPage(java.lang.String value) {
        * 
                                                    * Optional. If the requested object path is missing, and any
        * `mainPageSuffix` object is missing, if applicable, the service
-       * will return the named object from this bucket as the content for a
-       * [https://tools.ietf.org/html/rfc7231#section-6.5.4][404 Not Found]
+       * returns the named object from this bucket as the content for a
+       * [404 Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)
        * result.
        * 
                                            
        *
@@ -21815,8 +21834,8 @@ public Builder clearNotFoundPage() {
        * 
                                                    * Optional. If the requested object path is missing, and any
        * `mainPageSuffix` object is missing, if applicable, the service
-       * will return the named object from this bucket as the content for a
-       * [https://tools.ietf.org/html/rfc7231#section-6.5.4][404 Not Found]
+       * returns the named object from this bucket as the content for a
+       * [404 Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)
        * result.
        * 
                                            
        *
@@ -21964,9 +21983,11 @@ public interface CustomPlacementConfigOrBuilder
    *
    *
    * 
                                            -   * Configuration for Custom Dual Regions.  It should specify precisely two
-   * eligible regions within the same Multiregion. More information on regions
-   * may be found [here](https://cloud.google.com/storage/docs/locations).
+   * Configuration for [configurable dual-
+   * regions](https://cloud.google.com/storage/docs/locations#configurable). It
+   * should specify precisely two eligible regions within the same multi-region.
+   * For details, see
+   * [locations](https://cloud.google.com/storage/docs/locations).
    * 
                                            
    *
    * Protobuf type {@code google.storage.v2.Bucket.CustomPlacementConfig}
@@ -22247,9 +22268,11 @@ protected Builder newBuilderForType(
      *
      *
      * 
                                            -     * Configuration for Custom Dual Regions.  It should specify precisely two
-     * eligible regions within the same Multiregion. More information on regions
-     * may be found [here](https://cloud.google.com/storage/docs/locations).
+     * Configuration for [configurable dual-
+     * regions](https://cloud.google.com/storage/docs/locations#configurable). It
+     * should specify precisely two eligible regions within the same multi-region.
+     * For details, see
+     * [locations](https://cloud.google.com/storage/docs/locations).
      * 
                                            
      *
      * Protobuf type {@code google.storage.v2.Bucket.CustomPlacementConfig}
@@ -22709,8 +22732,8 @@ public interface AutoclassOrBuilder
      * 
                                                  * Output only. Latest instant at which the `enabled` field was set to true
      * after being disabled/unconfigured or set to false after being enabled. If
-     * Autoclass is enabled when the bucket is created, the toggle_time is set
-     * to the bucket creation time.
+     * Autoclass is enabled when the bucket is created, the value of the
+     * `toggle_time` field is set to the bucket `create_time`.
      * 
                                            
      *
      * 
@@ -22727,8 +22750,8 @@ public interface AutoclassOrBuilder
      * 
                                                  * Output only. Latest instant at which the `enabled` field was set to true
      * after being disabled/unconfigured or set to false after being enabled. If
-     * Autoclass is enabled when the bucket is created, the toggle_time is set
-     * to the bucket creation time.
+     * Autoclass is enabled when the bucket is created, the value of the
+     * `toggle_time` field is set to the bucket `create_time`.
      * 
                                            
      *
      * 
@@ -22745,8 +22768,8 @@ public interface AutoclassOrBuilder
      * 
                                                  * Output only. Latest instant at which the `enabled` field was set to true
      * after being disabled/unconfigured or set to false after being enabled. If
-     * Autoclass is enabled when the bucket is created, the toggle_time is set
-     * to the bucket creation time.
+     * Autoclass is enabled when the bucket is created, the value of the
+     * `toggle_time` field is set to the bucket `create_time`.
      * 
                                            
      *
      * 
@@ -22759,7 +22782,7 @@ public interface AutoclassOrBuilder
      *
      *
      * 
                                            -     * An object in an Autoclass bucket will eventually cool down to the
+     * An object in an Autoclass bucket eventually cools down to the
      * terminal storage class if there is no access to the object.
      * The only valid values are NEARLINE and ARCHIVE.
      * 
                                            
@@ -22774,7 +22797,7 @@ public interface AutoclassOrBuilder
      *
      *
      * 
                                            -     * An object in an Autoclass bucket will eventually cool down to the
+     * An object in an Autoclass bucket eventually cools down to the
      * terminal storage class if there is no access to the object.
      * The only valid values are NEARLINE and ARCHIVE.
      * 
                                            
@@ -22789,7 +22812,7 @@ public interface AutoclassOrBuilder
      *
      *
      * 
                                            -     * An object in an Autoclass bucket will eventually cool down to the
+     * An object in an Autoclass bucket eventually cools down to the
      * terminal storage class if there is no access to the object.
      * The only valid values are NEARLINE and ARCHIVE.
      * 
                                            
@@ -22921,8 +22944,8 @@ public boolean getEnabled() {
      * 
                                                  * Output only. Latest instant at which the `enabled` field was set to true
      * after being disabled/unconfigured or set to false after being enabled. If
-     * Autoclass is enabled when the bucket is created, the toggle_time is set
-     * to the bucket creation time.
+     * Autoclass is enabled when the bucket is created, the value of the
+     * `toggle_time` field is set to the bucket `create_time`.
      * 
                                            
      *
      * 
@@ -22942,8 +22965,8 @@ public boolean hasToggleTime() {
      * 
                                                  * Output only. Latest instant at which the `enabled` field was set to true
      * after being disabled/unconfigured or set to false after being enabled. If
-     * Autoclass is enabled when the bucket is created, the toggle_time is set
-     * to the bucket creation time.
+     * Autoclass is enabled when the bucket is created, the value of the
+     * `toggle_time` field is set to the bucket `create_time`.
      * 
                                            
      *
      * 
@@ -22963,8 +22986,8 @@ public com.google.protobuf.Timestamp getToggleTime() {
      * 
                                                  * Output only. Latest instant at which the `enabled` field was set to true
      * after being disabled/unconfigured or set to false after being enabled. If
-     * Autoclass is enabled when the bucket is created, the toggle_time is set
-     * to the bucket creation time.
+     * Autoclass is enabled when the bucket is created, the value of the
+     * `toggle_time` field is set to the bucket `create_time`.
      * 
                                            
      *
      * 
@@ -22985,7 +23008,7 @@ public com.google.protobuf.TimestampOrBuilder getToggleTimeOrBuilder() {
      *
      *
      * 
                                            -     * An object in an Autoclass bucket will eventually cool down to the
+     * An object in an Autoclass bucket eventually cools down to the
      * terminal storage class if there is no access to the object.
      * The only valid values are NEARLINE and ARCHIVE.
      * 
                                            
@@ -23003,7 +23026,7 @@ public boolean hasTerminalStorageClass() {
      *
      *
      * 
                                            -     * An object in an Autoclass bucket will eventually cool down to the
+     * An object in an Autoclass bucket eventually cools down to the
      * terminal storage class if there is no access to the object.
      * The only valid values are NEARLINE and ARCHIVE.
      * 
                                            
@@ -23029,7 +23052,7 @@ public java.lang.String getTerminalStorageClass() {
      *
      *
      * 
                                            -     * An object in an Autoclass bucket will eventually cool down to the
+     * An object in an Autoclass bucket eventually cools down to the
      * terminal storage class if there is no access to the object.
      * The only valid values are NEARLINE and ARCHIVE.
      * 
                                            
@@ -23641,8 +23664,8 @@ public Builder clearEnabled() {
        * 
                                                    * Output only. Latest instant at which the `enabled` field was set to true
        * after being disabled/unconfigured or set to false after being enabled. If
-       * Autoclass is enabled when the bucket is created, the toggle_time is set
-       * to the bucket creation time.
+       * Autoclass is enabled when the bucket is created, the value of the
+       * `toggle_time` field is set to the bucket `create_time`.
        * 
                                            
        *
        * 
@@ -23661,8 +23684,8 @@ public boolean hasToggleTime() {
        * 
                                                    * Output only. Latest instant at which the `enabled` field was set to true
        * after being disabled/unconfigured or set to false after being enabled. If
-       * Autoclass is enabled when the bucket is created, the toggle_time is set
-       * to the bucket creation time.
+       * Autoclass is enabled when the bucket is created, the value of the
+       * `toggle_time` field is set to the bucket `create_time`.
        * 
                                            
        *
        * 
@@ -23687,8 +23710,8 @@ public com.google.protobuf.Timestamp getToggleTime() {
        * 
                                                    * Output only. Latest instant at which the `enabled` field was set to true
        * after being disabled/unconfigured or set to false after being enabled. If
-       * Autoclass is enabled when the bucket is created, the toggle_time is set
-       * to the bucket creation time.
+       * Autoclass is enabled when the bucket is created, the value of the
+       * `toggle_time` field is set to the bucket `create_time`.
        * 
                                            
        *
        * 
@@ -23715,8 +23738,8 @@ public Builder setToggleTime(com.google.protobuf.Timestamp value) {
        * 
                                                    * Output only. Latest instant at which the `enabled` field was set to true
        * after being disabled/unconfigured or set to false after being enabled. If
-       * Autoclass is enabled when the bucket is created, the toggle_time is set
-       * to the bucket creation time.
+       * Autoclass is enabled when the bucket is created, the value of the
+       * `toggle_time` field is set to the bucket `create_time`.
        * 
                                            
        *
        * 
@@ -23740,8 +23763,8 @@ public Builder setToggleTime(com.google.protobuf.Timestamp.Builder builderForVal
        * 
                                                    * Output only. Latest instant at which the `enabled` field was set to true
        * after being disabled/unconfigured or set to false after being enabled. If
-       * Autoclass is enabled when the bucket is created, the toggle_time is set
-       * to the bucket creation time.
+       * Autoclass is enabled when the bucket is created, the value of the
+       * `toggle_time` field is set to the bucket `create_time`.
        * 
                                            
        *
        * 
@@ -23773,8 +23796,8 @@ public Builder mergeToggleTime(com.google.protobuf.Timestamp value) {
        * 
                                                    * Output only. Latest instant at which the `enabled` field was set to true
        * after being disabled/unconfigured or set to false after being enabled. If
-       * Autoclass is enabled when the bucket is created, the toggle_time is set
-       * to the bucket creation time.
+       * Autoclass is enabled when the bucket is created, the value of the
+       * `toggle_time` field is set to the bucket `create_time`.
        * 
                                            
        *
        * 
@@ -23798,8 +23821,8 @@ public Builder clearToggleTime() {
        * 
                                                    * Output only. Latest instant at which the `enabled` field was set to true
        * after being disabled/unconfigured or set to false after being enabled. If
-       * Autoclass is enabled when the bucket is created, the toggle_time is set
-       * to the bucket creation time.
+       * Autoclass is enabled when the bucket is created, the value of the
+       * `toggle_time` field is set to the bucket `create_time`.
        * 
                                            
        *
        * 
@@ -23818,8 +23841,8 @@ public com.google.protobuf.Timestamp.Builder getToggleTimeBuilder() {
        * 
                                                    * Output only. Latest instant at which the `enabled` field was set to true
        * after being disabled/unconfigured or set to false after being enabled. If
-       * Autoclass is enabled when the bucket is created, the toggle_time is set
-       * to the bucket creation time.
+       * Autoclass is enabled when the bucket is created, the value of the
+       * `toggle_time` field is set to the bucket `create_time`.
        * 
                                            
        *
        * 
@@ -23842,8 +23865,8 @@ public com.google.protobuf.TimestampOrBuilder getToggleTimeOrBuilder() {
        * 
                                                    * Output only. Latest instant at which the `enabled` field was set to true
        * after being disabled/unconfigured or set to false after being enabled. If
-       * Autoclass is enabled when the bucket is created, the toggle_time is set
-       * to the bucket creation time.
+       * Autoclass is enabled when the bucket is created, the value of the
+       * `toggle_time` field is set to the bucket `create_time`.
        * 
                                            
        *
        * 
@@ -23873,7 +23896,7 @@ public com.google.protobuf.TimestampOrBuilder getToggleTimeOrBuilder() {
        *
        *
        * 
                                            -       * An object in an Autoclass bucket will eventually cool down to the
+       * An object in an Autoclass bucket eventually cools down to the
        * terminal storage class if there is no access to the object.
        * The only valid values are NEARLINE and ARCHIVE.
        * 
                                            
@@ -23890,7 +23913,7 @@ public boolean hasTerminalStorageClass() {
        *
        *
        * 
                                            -       * An object in an Autoclass bucket will eventually cool down to the
+       * An object in an Autoclass bucket eventually cools down to the
        * terminal storage class if there is no access to the object.
        * The only valid values are NEARLINE and ARCHIVE.
        * 
                                            
@@ -23915,7 +23938,7 @@ public java.lang.String getTerminalStorageClass() {
        *
        *
        * 
                                            -       * An object in an Autoclass bucket will eventually cool down to the
+       * An object in an Autoclass bucket eventually cools down to the
        * terminal storage class if there is no access to the object.
        * The only valid values are NEARLINE and ARCHIVE.
        * 
                                            
@@ -23940,7 +23963,7 @@ public com.google.protobuf.ByteString getTerminalStorageClassBytes() {
        *
        *
        * 
                                            -       * An object in an Autoclass bucket will eventually cool down to the
+       * An object in an Autoclass bucket eventually cools down to the
        * terminal storage class if there is no access to the object.
        * The only valid values are NEARLINE and ARCHIVE.
        * 
                                            
@@ -23964,7 +23987,7 @@ public Builder setTerminalStorageClass(java.lang.String value) {
        *
        *
        * 
                                            -       * An object in an Autoclass bucket will eventually cool down to the
+       * An object in an Autoclass bucket eventually cools down to the
        * terminal storage class if there is no access to the object.
        * The only valid values are NEARLINE and ARCHIVE.
        * 
                                            
@@ -23984,7 +24007,7 @@ public Builder clearTerminalStorageClass() {
        *
        *
        * 
                                            -       * An object in an Autoclass bucket will eventually cool down to the
+       * An object in an Autoclass bucket eventually cools down to the
        * terminal storage class if there is no access to the object.
        * The only valid values are NEARLINE and ARCHIVE.
        * 
                                            
@@ -24305,7 +24328,7 @@ public interface IpFilterOrBuilder
      * `Disabled`. When set to `Enabled`, IP filtering rules are applied to a
      * bucket and all incoming requests to the bucket are evaluated against
      * these rules. When set to `Disabled`, IP filtering rules are not applied
-     * to a bucket.".
+     * to a bucket.
      * 
                                            
      *
      * optional string mode = 1;
@@ -24322,7 +24345,7 @@ public interface IpFilterOrBuilder
      * `Disabled`. When set to `Enabled`, IP filtering rules are applied to a
      * bucket and all incoming requests to the bucket are evaluated against
      * these rules. When set to `Disabled`, IP filtering rules are not applied
-     * to a bucket.".
+     * to a bucket.
      * 
                                            
      *
      * optional string mode = 1;
@@ -24339,7 +24362,7 @@ public interface IpFilterOrBuilder
      * `Disabled`. When set to `Enabled`, IP filtering rules are applied to a
      * bucket and all incoming requests to the bucket are evaluated against
      * these rules. When set to `Disabled`, IP filtering rules are not applied
-     * to a bucket.".
+     * to a bucket.
      * 
                                            
      *
      * optional string mode = 1;
@@ -24472,8 +24495,8 @@ com.google.storage.v2.Bucket.IpFilter.VpcNetworkSourceOrBuilder getVpcNetworkSou
      * Optional. Whether or not to allow VPCs from orgs different than the
      * bucket's parent org to access the bucket. When set to true, validations
      * on the existence of the VPCs won't be performed. If set to false, each
-     * VPC network source will be checked to belong to the same org as the
-     * bucket as well as validated for existence.
+     * VPC network source is checked to belong to the same org as the bucket as
+     * well as validated for existence.
      * 
                                            
      *
      * bool allow_cross_org_vpcs = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -24487,7 +24510,7 @@ com.google.storage.v2.Bucket.IpFilter.VpcNetworkSourceOrBuilder getVpcNetworkSou
      *
      * 
                                                  * Whether or not to allow all P4SA access to the bucket. When set to true,
-     * IP filter config validation will not apply.
+     * IP filter config validation doesn't apply.
      * 
                                            
      *
      * optional bool allow_all_service_agent_access = 5;
@@ -24501,7 +24524,7 @@ com.google.storage.v2.Bucket.IpFilter.VpcNetworkSourceOrBuilder getVpcNetworkSou
      *
      * 
                                                  * Whether or not to allow all P4SA access to the bucket. When set to true,
-     * IP filter config validation will not apply.
+     * IP filter config validation doesn't apply.
      * 
                                            
      *
      * optional bool allow_all_service_agent_access = 5;
@@ -26594,7 +26617,7 @@ public com.google.storage.v2.Bucket.IpFilter.VpcNetworkSource getDefaultInstance
      * `Disabled`. When set to `Enabled`, IP filtering rules are applied to a
      * bucket and all incoming requests to the bucket are evaluated against
      * these rules. When set to `Disabled`, IP filtering rules are not applied
-     * to a bucket.".
+     * to a bucket.
      * 
                                            
      *
      * optional string mode = 1;
@@ -26614,7 +26637,7 @@ public boolean hasMode() {
      * `Disabled`. When set to `Enabled`, IP filtering rules are applied to a
      * bucket and all incoming requests to the bucket are evaluated against
      * these rules. When set to `Disabled`, IP filtering rules are not applied
-     * to a bucket.".
+     * to a bucket.
      * 
                                            
      *
      * optional string mode = 1;
@@ -26642,7 +26665,7 @@ public java.lang.String getMode() {
      * `Disabled`. When set to `Enabled`, IP filtering rules are applied to a
      * bucket and all incoming requests to the bucket are evaluated against
      * these rules. When set to `Disabled`, IP filtering rules are not applied
-     * to a bucket.".
+     * to a bucket.
      * 
                                            
      *
      * optional string mode = 1;
@@ -26826,8 +26849,8 @@ public com.google.storage.v2.Bucket.IpFilter.VpcNetworkSource getVpcNetworkSourc
      * Optional. Whether or not to allow VPCs from orgs different than the
      * bucket's parent org to access the bucket. When set to true, validations
      * on the existence of the VPCs won't be performed. If set to false, each
-     * VPC network source will be checked to belong to the same org as the
-     * bucket as well as validated for existence.
+     * VPC network source is checked to belong to the same org as the bucket as
+     * well as validated for existence.
      * 
                                            
      *
      * bool allow_cross_org_vpcs = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -26847,7 +26870,7 @@ public boolean getAllowCrossOrgVpcs() {
      *
      * 
                                                  * Whether or not to allow all P4SA access to the bucket. When set to true,
-     * IP filter config validation will not apply.
+     * IP filter config validation doesn't apply.
      * 
                                            
      *
      * optional bool allow_all_service_agent_access = 5;
@@ -26864,7 +26887,7 @@ public boolean hasAllowAllServiceAgentAccess() {
      *
      * 
                                                  * Whether or not to allow all P4SA access to the bucket. When set to true,
-     * IP filter config validation will not apply.
+     * IP filter config validation doesn't apply.
      * 
                                            
      *
      * optional bool allow_all_service_agent_access = 5;
@@ -27414,7 +27437,7 @@ public Builder mergeFrom(
        * `Disabled`. When set to `Enabled`, IP filtering rules are applied to a
        * bucket and all incoming requests to the bucket are evaluated against
        * these rules. When set to `Disabled`, IP filtering rules are not applied
-       * to a bucket.".
+       * to a bucket.
        * 
                                            
        *
        * optional string mode = 1;
@@ -27433,7 +27456,7 @@ public boolean hasMode() {
        * `Disabled`. When set to `Enabled`, IP filtering rules are applied to a
        * bucket and all incoming requests to the bucket are evaluated against
        * these rules. When set to `Disabled`, IP filtering rules are not applied
-       * to a bucket.".
+       * to a bucket.
        * 
                                            
        *
        * optional string mode = 1;
@@ -27460,7 +27483,7 @@ public java.lang.String getMode() {
        * `Disabled`. When set to `Enabled`, IP filtering rules are applied to a
        * bucket and all incoming requests to the bucket are evaluated against
        * these rules. When set to `Disabled`, IP filtering rules are not applied
-       * to a bucket.".
+       * to a bucket.
        * 
                                            
        *
        * optional string mode = 1;
@@ -27487,7 +27510,7 @@ public com.google.protobuf.ByteString getModeBytes() {
        * `Disabled`. When set to `Enabled`, IP filtering rules are applied to a
        * bucket and all incoming requests to the bucket are evaluated against
        * these rules. When set to `Disabled`, IP filtering rules are not applied
-       * to a bucket.".
+       * to a bucket.
        * 
                                            
        *
        * optional string mode = 1;
@@ -27513,7 +27536,7 @@ public Builder setMode(java.lang.String value) {
        * `Disabled`. When set to `Enabled`, IP filtering rules are applied to a
        * bucket and all incoming requests to the bucket are evaluated against
        * these rules. When set to `Disabled`, IP filtering rules are not applied
-       * to a bucket.".
+       * to a bucket.
        * 
                                            
        *
        * optional string mode = 1;
@@ -27535,7 +27558,7 @@ public Builder clearMode() {
        * `Disabled`. When set to `Enabled`, IP filtering rules are applied to a
        * bucket and all incoming requests to the bucket are evaluated against
        * these rules. When set to `Disabled`, IP filtering rules are not applied
-       * to a bucket.".
+       * to a bucket.
        * 
                                            
        *
        * optional string mode = 1;
@@ -28223,8 +28246,8 @@ public Builder removeVpcNetworkSources(int index) {
        * Optional. Whether or not to allow VPCs from orgs different than the
        * bucket's parent org to access the bucket. When set to true, validations
        * on the existence of the VPCs won't be performed. If set to false, each
-       * VPC network source will be checked to belong to the same org as the
-       * bucket as well as validated for existence.
+       * VPC network source is checked to belong to the same org as the bucket as
+       * well as validated for existence.
        * 
                                            
        *
        * bool allow_cross_org_vpcs = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -28243,8 +28266,8 @@ public boolean getAllowCrossOrgVpcs() {
        * Optional. Whether or not to allow VPCs from orgs different than the
        * bucket's parent org to access the bucket. When set to true, validations
        * on the existence of the VPCs won't be performed. If set to false, each
-       * VPC network source will be checked to belong to the same org as the
-       * bucket as well as validated for existence.
+       * VPC network source is checked to belong to the same org as the bucket as
+       * well as validated for existence.
        *
                                            * * bool allow_cross_org_vpcs = 4 [(.google.api.field_behavior) = OPTIONAL]; @@ -28267,8 +28290,8 @@ public Builder setAllowCrossOrgVpcs(boolean value) { * Optional. Whether or not to allow VPCs from orgs different than the * bucket's parent org to access the bucket. When set to true, validations * on the existence of the VPCs won't be performed. If set to false, each - * VPC network source will be checked to belong to the same org as the - * bucket as well as validated for existence. + * VPC network source is checked to belong to the same org as the bucket as + * well as validated for existence. * * * bool allow_cross_org_vpcs = 4 [(.google.api.field_behavior) = OPTIONAL]; @@ -28289,7 +28312,7 @@ public Builder clearAllowCrossOrgVpcs() { * * 
                                                    * Whether or not to allow all P4SA access to the bucket. When set to true,
-       * IP filter config validation will not apply.
+       * IP filter config validation doesn't apply.
        *
                                            * * optional bool allow_all_service_agent_access = 5; @@ -28306,7 +28329,7 @@ public boolean hasAllowAllServiceAgentAccess() { * * 
                                                    * Whether or not to allow all P4SA access to the bucket. When set to true,
-       * IP filter config validation will not apply.
+       * IP filter config validation doesn't apply.
        *
                                            * * optional bool allow_all_service_agent_access = 5; @@ -28323,7 +28346,7 @@ public boolean getAllowAllServiceAgentAccess() { * * 
                                                    * Whether or not to allow all P4SA access to the bucket. When set to true,
-       * IP filter config validation will not apply.
+       * IP filter config validation doesn't apply.
        *
                                            * * optional bool allow_all_service_agent_access = 5; @@ -28344,7 +28367,7 @@ public Builder setAllowAllServiceAgentAccess(boolean value) { * * 
                                                    * Whether or not to allow all P4SA access to the bucket. When set to true,
-       * IP filter config validation will not apply.
+       * IP filter config validation doesn't apply.
        *
                                            * * optional bool allow_all_service_agent_access = 5; @@ -29035,7 +29058,7 @@ public com.google.protobuf.ByteString getNameBytes() { * 
                                                * Output only. The user-chosen part of the bucket name. The `{bucket}`
    * portion of the `name` field. For globally unique buckets, this is equal to
-   * the "bucket name" of other Cloud Storage APIs. Example: "pub".
+   * the `bucket name` of other Cloud Storage APIs. Example: `pub`.
    *
                                            * * string bucket_id = 2 [(.google.api.field_behavior) = OUTPUT_ONLY]; @@ -29061,7 +29084,7 @@ public java.lang.String getBucketId() { * 
                                                * Output only. The user-chosen part of the bucket name. The `{bucket}`
    * portion of the `name` field. For globally unique buckets, this is equal to
-   * the "bucket name" of other Cloud Storage APIs. Example: "pub".
+   * the `bucket name` of other Cloud Storage APIs. Example: `pub`.
    *
                                            * * string bucket_id = 2 [(.google.api.field_behavior) = OUTPUT_ONLY]; @@ -29091,8 +29114,8 @@ public com.google.protobuf.ByteString getBucketIdBytes() { * * 
                                                * The etag of the bucket.
-   * If included in the metadata of an UpdateBucketRequest, the operation will
-   * only be performed if the etag matches that of the bucket.
+   * If included in the metadata of an `UpdateBucketRequest`, the operation is
+   * only performed if the `etag` matches that of the bucket.
    *
                                            * * string etag = 29; @@ -29117,8 +29140,8 @@ public java.lang.String getEtag() { * * 
                                                * The etag of the bucket.
-   * If included in the metadata of an UpdateBucketRequest, the operation will
-   * only be performed if the etag matches that of the bucket.
+   * If included in the metadata of an `UpdateBucketRequest`, the operation is
+   * only performed if the `etag` matches that of the bucket.
    *
                                            * * string etag = 29; @@ -29148,9 +29171,9 @@ public com.google.protobuf.ByteString getEtagBytes() { * * 
                                                * Immutable. The project which owns this bucket, in the format of
-   * "projects/{projectIdentifier}".
-   * {projectIdentifier} can be the project ID or project number.
-   * Output values will always be in project number format.
+   * `projects/{projectIdentifier}`.
+   * `{projectIdentifier}` can be the project ID or project number.
+   * Output values are always in the project number format.
    *
                                            * * @@ -29177,9 +29200,9 @@ public java.lang.String getProject() { * * 
                                                * Immutable. The project which owns this bucket, in the format of
-   * "projects/{projectIdentifier}".
-   * {projectIdentifier} can be the project ID or project number.
-   * Output values will always be in project number format.
+   * `projects/{projectIdentifier}`.
+   * `{projectIdentifier}` can be the project ID or project number.
+   * Output values are always in the project number format.
    *
                                            * * @@ -29231,10 +29254,8 @@ public long getMetageneration() { * 
                                                * Immutable. The location of the bucket. Object data for objects in the
    * bucket resides in physical storage within this region.  Defaults to `US`.
-   * See the
-   * [https://developers.google.com/storage/docs/concepts-techniques#specifyinglocations"][developer's
-   * guide] for the authoritative list. Attempting to update this field after
-   * the bucket is created will result in an error.
+   * Attempting to update this field after the bucket is created results in an
+   * error.
    *
                                            * * string location = 5 [(.google.api.field_behavior) = IMMUTABLE]; @@ -29260,10 +29281,8 @@ public java.lang.String getLocation() { * 
                                                * Immutable. The location of the bucket. Object data for objects in the
    * bucket resides in physical storage within this region.  Defaults to `US`.
-   * See the
-   * [https://developers.google.com/storage/docs/concepts-techniques#specifyinglocations"][developer's
-   * guide] for the authoritative list. Attempting to update this field after
-   * the bucket is created will result in an error.
+   * Attempting to update this field after the bucket is created results in an
+   * error.
    *
                                            * * string location = 5 [(.google.api.field_behavior) = IMMUTABLE]; @@ -29350,9 +29369,9 @@ public com.google.protobuf.ByteString getLocationTypeBytes() { * Optional. The bucket's default storage class, used whenever no storageClass * is specified for a newly-created object. This defines how objects in the * bucket are stored and determines the SLA and the cost of storage. - * If this value is not specified when the bucket is created, it will default - * to `STANDARD`. For more information, see - * https://developers.google.com/storage/docs/storage-classes. + * If this value is not specified when the bucket is created, it defaults + * to `STANDARD`. For more information, see [Storage + * classes](https://developers.google.com/storage/docs/storage-classes). * * * string storage_class = 7 [(.google.api.field_behavior) = OPTIONAL]; @@ -29379,9 +29398,9 @@ public java.lang.String getStorageClass() { * Optional. The bucket's default storage class, used whenever no storageClass * is specified for a newly-created object. This defines how objects in the * bucket are stored and determines the SLA and the cost of storage. - * If this value is not specified when the bucket is created, it will default - * to `STANDARD`. For more information, see - * https://developers.google.com/storage/docs/storage-classes. + * If this value is not specified when the bucket is created, it defaults + * to `STANDARD`. For more information, see [Storage + * classes](https://developers.google.com/storage/docs/storage-classes). * * * string storage_class = 7 [(.google.api.field_behavior) = OPTIONAL]; @@ -29411,11 +29430,11 @@ public com.google.protobuf.ByteString getStorageClassBytes() { * * 
                                                * Optional. The recovery point objective for cross-region replication of the
-   * bucket. Applicable only for dual- and multi-region buckets. "DEFAULT" uses
-   * default replication. "ASYNC_TURBO" enables turbo replication, valid for
+   * bucket. Applicable only for dual- and multi-region buckets. `DEFAULT` uses
+   * default replication. `ASYNC_TURBO` enables turbo replication, valid for
    * dual-region buckets only. If rpo is not specified when the bucket is
-   * created, it defaults to "DEFAULT". For more information, see
-   * https://cloud.google.com/storage/docs/availability-durability#turbo-replication.
+   * created, it defaults to `DEFAULT`. For more information, see [Turbo
+   * replication](https://cloud.google.com/storage/docs/availability-durability#turbo-replication).
    *
                                            * * string rpo = 27 [(.google.api.field_behavior) = OPTIONAL]; @@ -29440,11 +29459,11 @@ public java.lang.String getRpo() { * * 
                                                * Optional. The recovery point objective for cross-region replication of the
-   * bucket. Applicable only for dual- and multi-region buckets. "DEFAULT" uses
-   * default replication. "ASYNC_TURBO" enables turbo replication, valid for
+   * bucket. Applicable only for dual- and multi-region buckets. `DEFAULT` uses
+   * default replication. `ASYNC_TURBO` enables turbo replication, valid for
    * dual-region buckets only. If rpo is not specified when the bucket is
-   * created, it defaults to "DEFAULT". For more information, see
-   * https://cloud.google.com/storage/docs/availability-durability#turbo-replication.
+   * created, it defaults to `DEFAULT`. For more information, see [Turbo
+   * replication](https://cloud.google.com/storage/docs/availability-durability#turbo-replication).
    *
                                            * * string rpo = 27 [(.google.api.field_behavior) = OPTIONAL]; @@ -29474,7 +29493,7 @@ public com.google.protobuf.ByteString getRpoBytes() { * * 
                                                * Optional. Access controls on the bucket.
-   * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+   * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
    * requests to set, read, or modify acl is an error.
    *
                                            * @@ -29492,7 +29511,7 @@ public java.util.List getAclList() { * * 
                                                * Optional. Access controls on the bucket.
-   * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+   * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
    * requests to set, read, or modify acl is an error.
    *
                                            * @@ -29511,7 +29530,7 @@ public java.util.List getAclList() { * * 
                                                * Optional. Access controls on the bucket.
-   * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+   * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
    * requests to set, read, or modify acl is an error.
    *
                                            * @@ -29529,7 +29548,7 @@ public int getAclCount() { * * 
                                                * Optional. Access controls on the bucket.
-   * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+   * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
    * requests to set, read, or modify acl is an error.
    *
                                            * @@ -29547,7 +29566,7 @@ public com.google.storage.v2.BucketAccessControl getAcl(int index) { * * 
                                                * Optional. Access controls on the bucket.
-   * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+   * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
    * requests to set, read, or modify acl is an error.
    *
                                            * @@ -29570,7 +29589,7 @@ public com.google.storage.v2.BucketAccessControlOrBuilder getAclOrBuilder(int in * * 
                                                * Optional. Default access controls to apply to new objects when no ACL is
-   * provided. If iam_config.uniform_bucket_level_access is enabled on this
+   * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
    * bucket, requests to set, read, or modify acl is an error.
    *
                                            * @@ -29588,7 +29607,7 @@ public java.util.List getDefaultObjec * * 
                                                * Optional. Default access controls to apply to new objects when no ACL is
-   * provided. If iam_config.uniform_bucket_level_access is enabled on this
+   * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
    * bucket, requests to set, read, or modify acl is an error.
    *
                                            * @@ -29607,7 +29626,7 @@ public java.util.List getDefaultObjec * * 
                                                * Optional. Default access controls to apply to new objects when no ACL is
-   * provided. If iam_config.uniform_bucket_level_access is enabled on this
+   * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
    * bucket, requests to set, read, or modify acl is an error.
    *
                                            * @@ -29625,7 +29644,7 @@ public int getDefaultObjectAclCount() { * * 
                                                * Optional. Default access controls to apply to new objects when no ACL is
-   * provided. If iam_config.uniform_bucket_level_access is enabled on this
+   * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
    * bucket, requests to set, read, or modify acl is an error.
    *
                                            * @@ -29643,7 +29662,7 @@ public com.google.storage.v2.ObjectAccessControl getDefaultObjectAcl(int index) * * 
                                                * Optional. Default access controls to apply to new objects when no ACL is
-   * provided. If iam_config.uniform_bucket_level_access is enabled on this
+   * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
    * bucket, requests to set, read, or modify acl is an error.
    *
                                            * @@ -29664,9 +29683,9 @@ public com.google.storage.v2.ObjectAccessControlOrBuilder getDefaultObjectAclOrB * * * 
                                            -   * Optional. The bucket's lifecycle config. See
-   * [https://developers.google.com/storage/docs/lifecycle]Lifecycle Management]
-   * for more information.
+   * Optional. The bucket's lifecycle configuration. See [Lifecycle
+   * Management](https://developers.google.com/storage/docs/lifecycle) for more
+   * information.
    *
                                            * * @@ -29684,9 +29703,9 @@ public boolean hasLifecycle() { * * * 
                                            -   * Optional. The bucket's lifecycle config. See
-   * [https://developers.google.com/storage/docs/lifecycle]Lifecycle Management]
-   * for more information.
+   * Optional. The bucket's lifecycle configuration. See [Lifecycle
+   * Management](https://developers.google.com/storage/docs/lifecycle) for more
+   * information.
    *
                                            * * @@ -29706,9 +29725,9 @@ public com.google.storage.v2.Bucket.Lifecycle getLifecycle() { * * * 
                                            -   * Optional. The bucket's lifecycle config. See
-   * [https://developers.google.com/storage/docs/lifecycle]Lifecycle Management]
-   * for more information.
+   * Optional. The bucket's lifecycle configuration. See [Lifecycle
+   * Management](https://developers.google.com/storage/docs/lifecycle) for more
+   * information.
    *
                                            * * @@ -29783,8 +29802,8 @@ public com.google.protobuf.TimestampOrBuilder getCreateTimeOrBuilder() { * * * 
                                            -   * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
-   * Sharing] (CORS) config.
+   * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+   * configuration.
    *
                                            * * @@ -29800,8 +29819,8 @@ public java.util.List getCorsList() { * * * 
                                            -   * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
-   * Sharing] (CORS) config.
+   * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+   * configuration.
    *
                                            * * @@ -29818,8 +29837,8 @@ public java.util.List getCorsList() { * * * 
                                            -   * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
-   * Sharing] (CORS) config.
+   * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+   * configuration.
    *
                                            * * @@ -29835,8 +29854,8 @@ public int getCorsCount() { * * * 
                                            -   * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
-   * Sharing] (CORS) config.
+   * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+   * configuration.
    *
                                            * * @@ -29852,8 +29871,8 @@ public com.google.storage.v2.Bucket.Cors getCors(int index) { * * * 
                                            -   * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
-   * Sharing] (CORS) config.
+   * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+   * configuration.
    *
                                            * * @@ -29927,11 +29946,11 @@ public com.google.protobuf.TimestampOrBuilder getUpdateTimeOrBuilder() { * Optional. The default value for event-based hold on newly created objects * in this bucket. Event-based hold is a way to retain objects indefinitely * until an event occurs, signified by the hold's release. After being - * released, such objects will be subject to bucket-level retention (if any). - * One sample use case of this flag is for banks to hold loan documents for at + * released, such objects are subject to bucket-level retention (if any). One + * sample use case of this flag is for banks to hold loan documents for at * least 3 years after loan is paid in full. Here, bucket-level retention is 3 * years and the event is loan being paid in full. In this example, these - * objects will be held intact for any number of years until the event has + * objects are held intact for any number of years until the event has * occurred (event-based hold on the object is released) and then 3 more years * after that. That means retention duration of the objects begins from the * moment event-based hold transitioned from true to false. Objects under @@ -30063,9 +30082,9 @@ public java.lang.String getLabelsOrThrow(java.lang.String key) { * * 
                                                * Optional. The bucket's website config, controlling how the service behaves
-   * when accessing bucket contents as a web site. See the
-   * [https://cloud.google.com/storage/docs/static-website][Static Website
-   * Examples] for more information.
+   * when accessing bucket contents as a web site. See the [Static website
+   * examples](https://cloud.google.com/storage/docs/static-website) for more
+   * information.
    *
                                            * * .google.storage.v2.Bucket.Website website = 16 [(.google.api.field_behavior) = OPTIONAL]; @@ -30083,9 +30102,9 @@ public boolean hasWebsite() { * * 
                                                * Optional. The bucket's website config, controlling how the service behaves
-   * when accessing bucket contents as a web site. See the
-   * [https://cloud.google.com/storage/docs/static-website][Static Website
-   * Examples] for more information.
+   * when accessing bucket contents as a web site. See the [Static website
+   * examples](https://cloud.google.com/storage/docs/static-website) for more
+   * information.
    *
                                            * * .google.storage.v2.Bucket.Website website = 16 [(.google.api.field_behavior) = OPTIONAL]; @@ -30103,9 +30122,9 @@ public com.google.storage.v2.Bucket.Website getWebsite() { * * 
                                                * Optional. The bucket's website config, controlling how the service behaves
-   * when accessing bucket contents as a web site. See the
-   * [https://cloud.google.com/storage/docs/static-website][Static Website
-   * Examples] for more information.
+   * when accessing bucket contents as a web site. See the [Static website
+   * examples](https://cloud.google.com/storage/docs/static-website) for more
+   * information.
    *
                                            * * .google.storage.v2.Bucket.Website website = 16 [(.google.api.field_behavior) = OPTIONAL]; @@ -30123,7 +30142,7 @@ public com.google.storage.v2.Bucket.WebsiteOrBuilder getWebsiteOrBuilder() { * * * 
                                            -   * Optional. The bucket's versioning config.
+   * Optional. The bucket's versioning configuration.
    *
                                            * * @@ -30141,7 +30160,7 @@ public boolean hasVersioning() { * * * 
                                            -   * Optional. The bucket's versioning config.
+   * Optional. The bucket's versioning configuration.
    *
                                            * * @@ -30161,7 +30180,7 @@ public com.google.storage.v2.Bucket.Versioning getVersioning() { * * * 
                                            -   * Optional. The bucket's versioning config.
+   * Optional. The bucket's versioning configuration.
    *
                                            * * @@ -30348,7 +30367,7 @@ public com.google.storage.v2.Bucket.EncryptionOrBuilder getEncryptionOrBuilder() * * * 
                                            -   * Optional. The bucket's billing config.
+   * Optional. The bucket's billing configuration.
    *
                                            * * .google.storage.v2.Bucket.Billing billing = 21 [(.google.api.field_behavior) = OPTIONAL]; @@ -30365,7 +30384,7 @@ public boolean hasBilling() { * * * 
                                            -   * Optional. The bucket's billing config.
+   * Optional. The bucket's billing configuration.
    *
                                            * * .google.storage.v2.Bucket.Billing billing = 21 [(.google.api.field_behavior) = OPTIONAL]; @@ -30382,7 +30401,7 @@ public com.google.storage.v2.Bucket.Billing getBilling() { * * * 
                                            -   * Optional. The bucket's billing config.
+   * Optional. The bucket's billing configuration.
    *
                                            * * .google.storage.v2.Bucket.Billing billing = 21 [(.google.api.field_behavior) = OPTIONAL]; @@ -30403,12 +30422,12 @@ public com.google.storage.v2.Bucket.BillingOrBuilder getBillingOrBuilder() { * Optional. The bucket's retention policy. The retention policy enforces a * minimum retention time for all objects contained in the bucket, based on * their creation time. Any attempt to overwrite or delete objects younger - * than the retention period will result in a PERMISSION_DENIED error. An + * than the retention period results in a `PERMISSION_DENIED` error. An * unlocked retention policy can be modified or removed from the bucket via a * storage.buckets.update operation. A locked retention policy cannot be * removed or shortened in duration for the lifetime of the bucket. - * Attempting to remove or decrease period of a locked retention policy will - * result in a PERMISSION_DENIED error. + * Attempting to remove or decrease period of a locked retention policy + * results in a `PERMISSION_DENIED` error. * * * @@ -30429,12 +30448,12 @@ public boolean hasRetentionPolicy() { * Optional. The bucket's retention policy. The retention policy enforces a * minimum retention time for all objects contained in the bucket, based on * their creation time. Any attempt to overwrite or delete objects younger - * than the retention period will result in a PERMISSION_DENIED error. An + * than the retention period results in a `PERMISSION_DENIED` error. An * unlocked retention policy can be modified or removed from the bucket via a * storage.buckets.update operation. A locked retention policy cannot be * removed or shortened in duration for the lifetime of the bucket. - * Attempting to remove or decrease period of a locked retention policy will - * result in a PERMISSION_DENIED error. + * Attempting to remove or decrease period of a locked retention policy + * results in a `PERMISSION_DENIED` error. * * * @@ -30457,12 +30476,12 @@ public com.google.storage.v2.Bucket.RetentionPolicy getRetentionPolicy() { * Optional. The bucket's retention policy. The retention policy enforces a * minimum retention time for all objects contained in the bucket, based on * their creation time. Any attempt to overwrite or delete objects younger - * than the retention period will result in a PERMISSION_DENIED error. An + * than the retention period results in a `PERMISSION_DENIED` error. An * unlocked retention policy can be modified or removed from the bucket via a * storage.buckets.update operation. A locked retention policy cannot be * removed or shortened in duration for the lifetime of the bucket. - * Attempting to remove or decrease period of a locked retention policy will - * result in a PERMISSION_DENIED error. + * Attempting to remove or decrease period of a locked retention policy + * results in a `PERMISSION_DENIED` error. * * * @@ -30483,7 +30502,7 @@ public com.google.storage.v2.Bucket.RetentionPolicyOrBuilder getRetentionPolicyO * * * 
                                            -   * Optional. The bucket's IAM config.
+   * Optional. The bucket's IAM configuration.
    *
                                            * * @@ -30501,7 +30520,7 @@ public boolean hasIamConfig() { * * * 
                                            -   * Optional. The bucket's IAM config.
+   * Optional. The bucket's IAM configuration.
    *
                                            * * @@ -30521,7 +30540,7 @@ public com.google.storage.v2.Bucket.IamConfig getIamConfig() { * * * 
                                            -   * Optional. The bucket's IAM config.
+   * Optional. The bucket's IAM configuration.
    *
                                            * * @@ -30562,9 +30581,8 @@ public boolean getSatisfiesPzs() { * * 
                                                * Optional. Configuration that, if present, specifies the data placement for
-   * a
-   * [https://cloud.google.com/storage/docs/locations#location-dr][configurable
-   * dual-region].
+   * a [configurable
+   * dual-region](https://cloud.google.com/storage/docs/locations#location-dr).
    *
                                            * * @@ -30583,9 +30601,8 @@ public boolean hasCustomPlacementConfig() { * * 
                                                * Optional. Configuration that, if present, specifies the data placement for
-   * a
-   * [https://cloud.google.com/storage/docs/locations#location-dr][configurable
-   * dual-region].
+   * a [configurable
+   * dual-region](https://cloud.google.com/storage/docs/locations#location-dr).
    *
                                            * * @@ -30606,9 +30623,8 @@ public com.google.storage.v2.Bucket.CustomPlacementConfig getCustomPlacementConf * * 
                                                * Optional. Configuration that, if present, specifies the data placement for
-   * a
-   * [https://cloud.google.com/storage/docs/locations#location-dr][configurable
-   * dual-region].
+   * a [configurable
+   * dual-region](https://cloud.google.com/storage/docs/locations#location-dr).
    *
                                            * * @@ -30631,8 +30647,8 @@ public com.google.storage.v2.Bucket.CustomPlacementConfig getCustomPlacementConf * * 
                                                * Optional. The bucket's Autoclass configuration. If there is no
-   * configuration, the Autoclass feature will be disabled and have no effect on
-   * the bucket.
+   * configuration, the Autoclass feature is disabled and has no effect on the
+   * bucket.
    *
                                            * * @@ -30651,8 +30667,8 @@ public boolean hasAutoclass() { * * 
                                                * Optional. The bucket's Autoclass configuration. If there is no
-   * configuration, the Autoclass feature will be disabled and have no effect on
-   * the bucket.
+   * configuration, the Autoclass feature is disabled and has no effect on the
+   * bucket.
    *
                                            * * @@ -30673,8 +30689,8 @@ public com.google.storage.v2.Bucket.Autoclass getAutoclass() { * * 
                                                * Optional. The bucket's Autoclass configuration. If there is no
-   * configuration, the Autoclass feature will be disabled and have no effect on
-   * the bucket.
+   * configuration, the Autoclass feature is disabled and has no effect on the
+   * bucket.
    *
                                            * * @@ -30696,7 +30712,7 @@ public com.google.storage.v2.Bucket.AutoclassOrBuilder getAutoclassOrBuilder() { * * 
                                                * Optional. The bucket's hierarchical namespace configuration. If there is no
-   * configuration, the hierarchical namespace feature will be disabled and have
+   * configuration, the hierarchical namespace feature is disabled and has
    * no effect on the bucket.
    *
                                            * @@ -30716,7 +30732,7 @@ public boolean hasHierarchicalNamespace() { * * 
                                                * Optional. The bucket's hierarchical namespace configuration. If there is no
-   * configuration, the hierarchical namespace feature will be disabled and have
+   * configuration, the hierarchical namespace feature is disabled and has
    * no effect on the bucket.
    *
                                            * @@ -30738,7 +30754,7 @@ public com.google.storage.v2.Bucket.HierarchicalNamespace getHierarchicalNamespa * * 
                                                * Optional. The bucket's hierarchical namespace configuration. If there is no
-   * configuration, the hierarchical namespace feature will be disabled and have
+   * configuration, the hierarchical namespace feature is disabled and has
    * no effect on the bucket.
    *
                                            * @@ -30824,7 +30840,7 @@ public com.google.storage.v2.Bucket.SoftDeletePolicyOrBuilder getSoftDeletePolic * * 
                                                * Optional. The bucket's object retention configuration. Must be enabled
-   * before objects in the bucket may have retention configured.
+   * before objects in the bucket might have retention configured.
    *
                                            * * @@ -30843,7 +30859,7 @@ public boolean hasObjectRetention() { * * 
                                                * Optional. The bucket's object retention configuration. Must be enabled
-   * before objects in the bucket may have retention configured.
+   * before objects in the bucket might have retention configured.
    *
                                            * * @@ -30864,7 +30880,7 @@ public com.google.storage.v2.Bucket.ObjectRetention getObjectRetention() { * * 
                                                * Optional. The bucket's object retention configuration. Must be enabled
-   * before objects in the bucket may have retention configured.
+   * before objects in the bucket might have retention configured.
    *
                                            * * @@ -32482,7 +32498,7 @@ public Builder setNameBytes(com.google.protobuf.ByteString value) { * 
                                                  * Output only. The user-chosen part of the bucket name. The `{bucket}`
      * portion of the `name` field. For globally unique buckets, this is equal to
-     * the "bucket name" of other Cloud Storage APIs. Example: "pub".
+     * the `bucket name` of other Cloud Storage APIs. Example: `pub`.
      *
                                            * * string bucket_id = 2 [(.google.api.field_behavior) = OUTPUT_ONLY]; @@ -32507,7 +32523,7 @@ public java.lang.String getBucketId() { * 
                                                  * Output only. The user-chosen part of the bucket name. The `{bucket}`
      * portion of the `name` field. For globally unique buckets, this is equal to
-     * the "bucket name" of other Cloud Storage APIs. Example: "pub".
+     * the `bucket name` of other Cloud Storage APIs. Example: `pub`.
      *
                                            * * string bucket_id = 2 [(.google.api.field_behavior) = OUTPUT_ONLY]; @@ -32532,7 +32548,7 @@ public com.google.protobuf.ByteString getBucketIdBytes() { * 
                                                  * Output only. The user-chosen part of the bucket name. The `{bucket}`
      * portion of the `name` field. For globally unique buckets, this is equal to
-     * the "bucket name" of other Cloud Storage APIs. Example: "pub".
+     * the `bucket name` of other Cloud Storage APIs. Example: `pub`.
      *
                                            * * string bucket_id = 2 [(.google.api.field_behavior) = OUTPUT_ONLY]; @@ -32556,7 +32572,7 @@ public Builder setBucketId(java.lang.String value) { * 
                                                  * Output only. The user-chosen part of the bucket name. The `{bucket}`
      * portion of the `name` field. For globally unique buckets, this is equal to
-     * the "bucket name" of other Cloud Storage APIs. Example: "pub".
+     * the `bucket name` of other Cloud Storage APIs. Example: `pub`.
      *
                                            * * string bucket_id = 2 [(.google.api.field_behavior) = OUTPUT_ONLY]; @@ -32576,7 +32592,7 @@ public Builder clearBucketId() { * 
                                                  * Output only. The user-chosen part of the bucket name. The `{bucket}`
      * portion of the `name` field. For globally unique buckets, this is equal to
-     * the "bucket name" of other Cloud Storage APIs. Example: "pub".
+     * the `bucket name` of other Cloud Storage APIs. Example: `pub`.
      *
                                            * * string bucket_id = 2 [(.google.api.field_behavior) = OUTPUT_ONLY]; @@ -32602,8 +32618,8 @@ public Builder setBucketIdBytes(com.google.protobuf.ByteString value) { * * 
                                                  * The etag of the bucket.
-     * If included in the metadata of an UpdateBucketRequest, the operation will
-     * only be performed if the etag matches that of the bucket.
+     * If included in the metadata of an `UpdateBucketRequest`, the operation is
+     * only performed if the `etag` matches that of the bucket.
      *
                                            * * string etag = 29; @@ -32627,8 +32643,8 @@ public java.lang.String getEtag() { * * 
                                                  * The etag of the bucket.
-     * If included in the metadata of an UpdateBucketRequest, the operation will
-     * only be performed if the etag matches that of the bucket.
+     * If included in the metadata of an `UpdateBucketRequest`, the operation is
+     * only performed if the `etag` matches that of the bucket.
      *
                                            * * string etag = 29; @@ -32652,8 +32668,8 @@ public com.google.protobuf.ByteString getEtagBytes() { * * 
                                                  * The etag of the bucket.
-     * If included in the metadata of an UpdateBucketRequest, the operation will
-     * only be performed if the etag matches that of the bucket.
+     * If included in the metadata of an `UpdateBucketRequest`, the operation is
+     * only performed if the `etag` matches that of the bucket.
      *
                                            * * string etag = 29; @@ -32676,8 +32692,8 @@ public Builder setEtag(java.lang.String value) { * * 
                                                  * The etag of the bucket.
-     * If included in the metadata of an UpdateBucketRequest, the operation will
-     * only be performed if the etag matches that of the bucket.
+     * If included in the metadata of an `UpdateBucketRequest`, the operation is
+     * only performed if the `etag` matches that of the bucket.
      *
                                            * * string etag = 29; @@ -32696,8 +32712,8 @@ public Builder clearEtag() { * * 
                                                  * The etag of the bucket.
-     * If included in the metadata of an UpdateBucketRequest, the operation will
-     * only be performed if the etag matches that of the bucket.
+     * If included in the metadata of an `UpdateBucketRequest`, the operation is
+     * only performed if the `etag` matches that of the bucket.
      *
                                            * * string etag = 29; @@ -32723,9 +32739,9 @@ public Builder setEtagBytes(com.google.protobuf.ByteString value) { * * 
                                                  * Immutable. The project which owns this bucket, in the format of
-     * "projects/{projectIdentifier}".
-     * {projectIdentifier} can be the project ID or project number.
-     * Output values will always be in project number format.
+     * `projects/{projectIdentifier}`.
+     * `{projectIdentifier}` can be the project ID or project number.
+     * Output values are always in the project number format.
      *
                                            * * @@ -32751,9 +32767,9 @@ public java.lang.String getProject() { * * 
                                                  * Immutable. The project which owns this bucket, in the format of
-     * "projects/{projectIdentifier}".
-     * {projectIdentifier} can be the project ID or project number.
-     * Output values will always be in project number format.
+     * `projects/{projectIdentifier}`.
+     * `{projectIdentifier}` can be the project ID or project number.
+     * Output values are always in the project number format.
      *
                                            * * @@ -32779,9 +32795,9 @@ public com.google.protobuf.ByteString getProjectBytes() { * * 
                                                  * Immutable. The project which owns this bucket, in the format of
-     * "projects/{projectIdentifier}".
-     * {projectIdentifier} can be the project ID or project number.
-     * Output values will always be in project number format.
+     * `projects/{projectIdentifier}`.
+     * `{projectIdentifier}` can be the project ID or project number.
+     * Output values are always in the project number format.
      *
                                            * * @@ -32806,9 +32822,9 @@ public Builder setProject(java.lang.String value) { * * 
                                                  * Immutable. The project which owns this bucket, in the format of
-     * "projects/{projectIdentifier}".
-     * {projectIdentifier} can be the project ID or project number.
-     * Output values will always be in project number format.
+     * `projects/{projectIdentifier}`.
+     * `{projectIdentifier}` can be the project ID or project number.
+     * Output values are always in the project number format.
      *
                                            * * @@ -32829,9 +32845,9 @@ public Builder clearProject() { * * 
                                                  * Immutable. The project which owns this bucket, in the format of
-     * "projects/{projectIdentifier}".
-     * {projectIdentifier} can be the project ID or project number.
-     * Output values will always be in project number format.
+     * `projects/{projectIdentifier}`.
+     * `{projectIdentifier}` can be the project ID or project number.
+     * Output values are always in the project number format.
      *
                                            * * @@ -32916,10 +32932,8 @@ public Builder clearMetageneration() { * 
                                                  * Immutable. The location of the bucket. Object data for objects in the
      * bucket resides in physical storage within this region.  Defaults to `US`.
-     * See the
-     * [https://developers.google.com/storage/docs/concepts-techniques#specifyinglocations"][developer's
-     * guide] for the authoritative list. Attempting to update this field after
-     * the bucket is created will result in an error.
+     * Attempting to update this field after the bucket is created results in an
+     * error.
      *
                                            * * string location = 5 [(.google.api.field_behavior) = IMMUTABLE]; @@ -32944,10 +32958,8 @@ public java.lang.String getLocation() { * 
                                                  * Immutable. The location of the bucket. Object data for objects in the
      * bucket resides in physical storage within this region.  Defaults to `US`.
-     * See the
-     * [https://developers.google.com/storage/docs/concepts-techniques#specifyinglocations"][developer's
-     * guide] for the authoritative list. Attempting to update this field after
-     * the bucket is created will result in an error.
+     * Attempting to update this field after the bucket is created results in an
+     * error.
      *
                                            * * string location = 5 [(.google.api.field_behavior) = IMMUTABLE]; @@ -32972,10 +32984,8 @@ public com.google.protobuf.ByteString getLocationBytes() { * 
                                                  * Immutable. The location of the bucket. Object data for objects in the
      * bucket resides in physical storage within this region.  Defaults to `US`.
-     * See the
-     * [https://developers.google.com/storage/docs/concepts-techniques#specifyinglocations"][developer's
-     * guide] for the authoritative list. Attempting to update this field after
-     * the bucket is created will result in an error.
+     * Attempting to update this field after the bucket is created results in an
+     * error.
      *
                                            * * string location = 5 [(.google.api.field_behavior) = IMMUTABLE]; @@ -32999,10 +33009,8 @@ public Builder setLocation(java.lang.String value) { * 
                                                  * Immutable. The location of the bucket. Object data for objects in the
      * bucket resides in physical storage within this region.  Defaults to `US`.
-     * See the
-     * [https://developers.google.com/storage/docs/concepts-techniques#specifyinglocations"][developer's
-     * guide] for the authoritative list. Attempting to update this field after
-     * the bucket is created will result in an error.
+     * Attempting to update this field after the bucket is created results in an
+     * error.
      *
                                            * * string location = 5 [(.google.api.field_behavior) = IMMUTABLE]; @@ -33022,10 +33030,8 @@ public Builder clearLocation() { * 
                                                  * Immutable. The location of the bucket. Object data for objects in the
      * bucket resides in physical storage within this region.  Defaults to `US`.
-     * See the
-     * [https://developers.google.com/storage/docs/concepts-techniques#specifyinglocations"][developer's
-     * guide] for the authoritative list. Attempting to update this field after
-     * the bucket is created will result in an error.
+     * Attempting to update this field after the bucket is created results in an
+     * error.
      *
                                            * * string location = 5 [(.google.api.field_behavior) = IMMUTABLE]; @@ -33169,9 +33175,9 @@ public Builder setLocationTypeBytes(com.google.protobuf.ByteString value) { * Optional. The bucket's default storage class, used whenever no storageClass * is specified for a newly-created object. This defines how objects in the * bucket are stored and determines the SLA and the cost of storage. - * If this value is not specified when the bucket is created, it will default - * to `STANDARD`. For more information, see - * https://developers.google.com/storage/docs/storage-classes. + * If this value is not specified when the bucket is created, it defaults + * to `STANDARD`. For more information, see [Storage + * classes](https://developers.google.com/storage/docs/storage-classes). * * * string storage_class = 7 [(.google.api.field_behavior) = OPTIONAL]; @@ -33197,9 +33203,9 @@ public java.lang.String getStorageClass() { * Optional. The bucket's default storage class, used whenever no storageClass * is specified for a newly-created object. This defines how objects in the * bucket are stored and determines the SLA and the cost of storage. - * If this value is not specified when the bucket is created, it will default - * to `STANDARD`. For more information, see - * https://developers.google.com/storage/docs/storage-classes. + * If this value is not specified when the bucket is created, it defaults + * to `STANDARD`. For more information, see [Storage + * classes](https://developers.google.com/storage/docs/storage-classes). * * * string storage_class = 7 [(.google.api.field_behavior) = OPTIONAL]; @@ -33225,9 +33231,9 @@ public com.google.protobuf.ByteString getStorageClassBytes() { * Optional. The bucket's default storage class, used whenever no storageClass * is specified for a newly-created object. This defines how objects in the * bucket are stored and determines the SLA and the cost of storage. - * If this value is not specified when the bucket is created, it will default - * to `STANDARD`. For more information, see - * https://developers.google.com/storage/docs/storage-classes. + * If this value is not specified when the bucket is created, it defaults + * to `STANDARD`. For more information, see [Storage + * classes](https://developers.google.com/storage/docs/storage-classes). * * * string storage_class = 7 [(.google.api.field_behavior) = OPTIONAL]; @@ -33252,9 +33258,9 @@ public Builder setStorageClass(java.lang.String value) { * Optional. The bucket's default storage class, used whenever no storageClass * is specified for a newly-created object. This defines how objects in the * bucket are stored and determines the SLA and the cost of storage. - * If this value is not specified when the bucket is created, it will default - * to `STANDARD`. For more information, see - * https://developers.google.com/storage/docs/storage-classes. + * If this value is not specified when the bucket is created, it defaults + * to `STANDARD`. For more information, see [Storage + * classes](https://developers.google.com/storage/docs/storage-classes). * * * string storage_class = 7 [(.google.api.field_behavior) = OPTIONAL]; @@ -33275,9 +33281,9 @@ public Builder clearStorageClass() { * Optional. The bucket's default storage class, used whenever no storageClass * is specified for a newly-created object. This defines how objects in the * bucket are stored and determines the SLA and the cost of storage. - * If this value is not specified when the bucket is created, it will default - * to `STANDARD`. For more information, see - * https://developers.google.com/storage/docs/storage-classes. + * If this value is not specified when the bucket is created, it defaults + * to `STANDARD`. For more information, see [Storage + * classes](https://developers.google.com/storage/docs/storage-classes). * * * string storage_class = 7 [(.google.api.field_behavior) = OPTIONAL]; @@ -33303,11 +33309,11 @@ public Builder setStorageClassBytes(com.google.protobuf.ByteString value) { * * 
                                                  * Optional. The recovery point objective for cross-region replication of the
-     * bucket. Applicable only for dual- and multi-region buckets. "DEFAULT" uses
-     * default replication. "ASYNC_TURBO" enables turbo replication, valid for
+     * bucket. Applicable only for dual- and multi-region buckets. `DEFAULT` uses
+     * default replication. `ASYNC_TURBO` enables turbo replication, valid for
      * dual-region buckets only. If rpo is not specified when the bucket is
-     * created, it defaults to "DEFAULT". For more information, see
-     * https://cloud.google.com/storage/docs/availability-durability#turbo-replication.
+     * created, it defaults to `DEFAULT`. For more information, see [Turbo
+     * replication](https://cloud.google.com/storage/docs/availability-durability#turbo-replication).
      *
                                            * * string rpo = 27 [(.google.api.field_behavior) = OPTIONAL]; @@ -33331,11 +33337,11 @@ public java.lang.String getRpo() { * * 
                                                  * Optional. The recovery point objective for cross-region replication of the
-     * bucket. Applicable only for dual- and multi-region buckets. "DEFAULT" uses
-     * default replication. "ASYNC_TURBO" enables turbo replication, valid for
+     * bucket. Applicable only for dual- and multi-region buckets. `DEFAULT` uses
+     * default replication. `ASYNC_TURBO` enables turbo replication, valid for
      * dual-region buckets only. If rpo is not specified when the bucket is
-     * created, it defaults to "DEFAULT". For more information, see
-     * https://cloud.google.com/storage/docs/availability-durability#turbo-replication.
+     * created, it defaults to `DEFAULT`. For more information, see [Turbo
+     * replication](https://cloud.google.com/storage/docs/availability-durability#turbo-replication).
      *
                                            * * string rpo = 27 [(.google.api.field_behavior) = OPTIONAL]; @@ -33359,11 +33365,11 @@ public com.google.protobuf.ByteString getRpoBytes() { * * 
                                                  * Optional. The recovery point objective for cross-region replication of the
-     * bucket. Applicable only for dual- and multi-region buckets. "DEFAULT" uses
-     * default replication. "ASYNC_TURBO" enables turbo replication, valid for
+     * bucket. Applicable only for dual- and multi-region buckets. `DEFAULT` uses
+     * default replication. `ASYNC_TURBO` enables turbo replication, valid for
      * dual-region buckets only. If rpo is not specified when the bucket is
-     * created, it defaults to "DEFAULT". For more information, see
-     * https://cloud.google.com/storage/docs/availability-durability#turbo-replication.
+     * created, it defaults to `DEFAULT`. For more information, see [Turbo
+     * replication](https://cloud.google.com/storage/docs/availability-durability#turbo-replication).
      *
                                            * * string rpo = 27 [(.google.api.field_behavior) = OPTIONAL]; @@ -33386,11 +33392,11 @@ public Builder setRpo(java.lang.String value) { * * 
                                                  * Optional. The recovery point objective for cross-region replication of the
-     * bucket. Applicable only for dual- and multi-region buckets. "DEFAULT" uses
-     * default replication. "ASYNC_TURBO" enables turbo replication, valid for
+     * bucket. Applicable only for dual- and multi-region buckets. `DEFAULT` uses
+     * default replication. `ASYNC_TURBO` enables turbo replication, valid for
      * dual-region buckets only. If rpo is not specified when the bucket is
-     * created, it defaults to "DEFAULT". For more information, see
-     * https://cloud.google.com/storage/docs/availability-durability#turbo-replication.
+     * created, it defaults to `DEFAULT`. For more information, see [Turbo
+     * replication](https://cloud.google.com/storage/docs/availability-durability#turbo-replication).
      *
                                            * * string rpo = 27 [(.google.api.field_behavior) = OPTIONAL]; @@ -33409,11 +33415,11 @@ public Builder clearRpo() { * * 
                                                  * Optional. The recovery point objective for cross-region replication of the
-     * bucket. Applicable only for dual- and multi-region buckets. "DEFAULT" uses
-     * default replication. "ASYNC_TURBO" enables turbo replication, valid for
+     * bucket. Applicable only for dual- and multi-region buckets. `DEFAULT` uses
+     * default replication. `ASYNC_TURBO` enables turbo replication, valid for
      * dual-region buckets only. If rpo is not specified when the bucket is
-     * created, it defaults to "DEFAULT". For more information, see
-     * https://cloud.google.com/storage/docs/availability-durability#turbo-replication.
+     * created, it defaults to `DEFAULT`. For more information, see [Turbo
+     * replication](https://cloud.google.com/storage/docs/availability-durability#turbo-replication).
      *
                                            * * string rpo = 27 [(.google.api.field_behavior) = OPTIONAL]; @@ -33453,7 +33459,7 @@ private void ensureAclIsMutable() { * * 
                                                  * Optional. Access controls on the bucket.
-     * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+     * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
      * requests to set, read, or modify acl is an error.
      *
                                            * @@ -33474,7 +33480,7 @@ public java.util.List getAclList() { * * 
                                                  * Optional. Access controls on the bucket.
-     * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+     * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
      * requests to set, read, or modify acl is an error.
      *
                                            * @@ -33495,7 +33501,7 @@ public int getAclCount() { * * 
                                                  * Optional. Access controls on the bucket.
-     * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+     * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
      * requests to set, read, or modify acl is an error.
      *
                                            * @@ -33516,7 +33522,7 @@ public com.google.storage.v2.BucketAccessControl getAcl(int index) { * * 
                                                  * Optional. Access controls on the bucket.
-     * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+     * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
      * requests to set, read, or modify acl is an error.
      *
                                            * @@ -33543,7 +33549,7 @@ public Builder setAcl(int index, com.google.storage.v2.BucketAccessControl value * * 
                                                  * Optional. Access controls on the bucket.
-     * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+     * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
      * requests to set, read, or modify acl is an error.
      *
                                            * @@ -33568,7 +33574,7 @@ public Builder setAcl( * * 
                                                  * Optional. Access controls on the bucket.
-     * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+     * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
      * requests to set, read, or modify acl is an error.
      *
                                            * @@ -33595,7 +33601,7 @@ public Builder addAcl(com.google.storage.v2.BucketAccessControl value) { * * 
                                                  * Optional. Access controls on the bucket.
-     * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+     * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
      * requests to set, read, or modify acl is an error.
      *
                                            * @@ -33622,7 +33628,7 @@ public Builder addAcl(int index, com.google.storage.v2.BucketAccessControl value * * 
                                                  * Optional. Access controls on the bucket.
-     * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+     * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
      * requests to set, read, or modify acl is an error.
      *
                                            * @@ -33646,7 +33652,7 @@ public Builder addAcl(com.google.storage.v2.BucketAccessControl.Builder builderF * * 
                                                  * Optional. Access controls on the bucket.
-     * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+     * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
      * requests to set, read, or modify acl is an error.
      *
                                            * @@ -33671,7 +33677,7 @@ public Builder addAcl( * * 
                                                  * Optional. Access controls on the bucket.
-     * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+     * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
      * requests to set, read, or modify acl is an error.
      *
                                            * @@ -33696,7 +33702,7 @@ public Builder addAllAcl( * * 
                                                  * Optional. Access controls on the bucket.
-     * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+     * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
      * requests to set, read, or modify acl is an error.
      *
                                            * @@ -33720,7 +33726,7 @@ public Builder clearAcl() { * * 
                                                  * Optional. Access controls on the bucket.
-     * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+     * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
      * requests to set, read, or modify acl is an error.
      *
                                            * @@ -33744,7 +33750,7 @@ public Builder removeAcl(int index) { * * 
                                                  * Optional. Access controls on the bucket.
-     * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+     * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
      * requests to set, read, or modify acl is an error.
      *
                                            * @@ -33761,7 +33767,7 @@ public com.google.storage.v2.BucketAccessControl.Builder getAclBuilder(int index * * 
                                                  * Optional. Access controls on the bucket.
-     * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+     * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
      * requests to set, read, or modify acl is an error.
      *
                                            * @@ -33782,7 +33788,7 @@ public com.google.storage.v2.BucketAccessControlOrBuilder getAclOrBuilder(int in * * 
                                                  * Optional. Access controls on the bucket.
-     * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+     * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
      * requests to set, read, or modify acl is an error.
      *
                                            * @@ -33804,7 +33810,7 @@ public com.google.storage.v2.BucketAccessControlOrBuilder getAclOrBuilder(int in * * 
                                                  * Optional. Access controls on the bucket.
-     * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+     * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
      * requests to set, read, or modify acl is an error.
      *
                                            * @@ -33822,7 +33828,7 @@ public com.google.storage.v2.BucketAccessControl.Builder addAclBuilder() { * * 
                                                  * Optional. Access controls on the bucket.
-     * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+     * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
      * requests to set, read, or modify acl is an error.
      *
                                            * @@ -33840,7 +33846,7 @@ public com.google.storage.v2.BucketAccessControl.Builder addAclBuilder(int index * * 
                                                  * Optional. Access controls on the bucket.
-     * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+     * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
      * requests to set, read, or modify acl is an error.
      *
                                            * @@ -33891,7 +33897,7 @@ private void ensureDefaultObjectAclIsMutable() { * * 
                                                  * Optional. Default access controls to apply to new objects when no ACL is
-     * provided. If iam_config.uniform_bucket_level_access is enabled on this
+     * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
      * bucket, requests to set, read, or modify acl is an error.
      *
                                            * @@ -33912,7 +33918,7 @@ public java.util.List getDefaultObjec * * 
                                                  * Optional. Default access controls to apply to new objects when no ACL is
-     * provided. If iam_config.uniform_bucket_level_access is enabled on this
+     * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
      * bucket, requests to set, read, or modify acl is an error.
      *
                                            * @@ -33933,7 +33939,7 @@ public int getDefaultObjectAclCount() { * * 
                                                  * Optional. Default access controls to apply to new objects when no ACL is
-     * provided. If iam_config.uniform_bucket_level_access is enabled on this
+     * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
      * bucket, requests to set, read, or modify acl is an error.
      *
                                            * @@ -33954,7 +33960,7 @@ public com.google.storage.v2.ObjectAccessControl getDefaultObjectAcl(int index) * * 
                                                  * Optional. Default access controls to apply to new objects when no ACL is
-     * provided. If iam_config.uniform_bucket_level_access is enabled on this
+     * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
      * bucket, requests to set, read, or modify acl is an error.
      *
                                            * @@ -33981,7 +33987,7 @@ public Builder setDefaultObjectAcl(int index, com.google.storage.v2.ObjectAccess * * 
                                                  * Optional. Default access controls to apply to new objects when no ACL is
-     * provided. If iam_config.uniform_bucket_level_access is enabled on this
+     * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
      * bucket, requests to set, read, or modify acl is an error.
      *
                                            * @@ -34006,7 +34012,7 @@ public Builder setDefaultObjectAcl( * * 
                                                  * Optional. Default access controls to apply to new objects when no ACL is
-     * provided. If iam_config.uniform_bucket_level_access is enabled on this
+     * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
      * bucket, requests to set, read, or modify acl is an error.
      *
                                            * @@ -34033,7 +34039,7 @@ public Builder addDefaultObjectAcl(com.google.storage.v2.ObjectAccessControl val * * 
                                                  * Optional. Default access controls to apply to new objects when no ACL is
-     * provided. If iam_config.uniform_bucket_level_access is enabled on this
+     * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
      * bucket, requests to set, read, or modify acl is an error.
      *
                                            * @@ -34060,7 +34066,7 @@ public Builder addDefaultObjectAcl(int index, com.google.storage.v2.ObjectAccess * * 
                                                  * Optional. Default access controls to apply to new objects when no ACL is
-     * provided. If iam_config.uniform_bucket_level_access is enabled on this
+     * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
      * bucket, requests to set, read, or modify acl is an error.
      *
                                            * @@ -34085,7 +34091,7 @@ public Builder addDefaultObjectAcl( * * 
                                                  * Optional. Default access controls to apply to new objects when no ACL is
-     * provided. If iam_config.uniform_bucket_level_access is enabled on this
+     * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
      * bucket, requests to set, read, or modify acl is an error.
      *
                                            * @@ -34110,7 +34116,7 @@ public Builder addDefaultObjectAcl( * * 
                                                  * Optional. Default access controls to apply to new objects when no ACL is
-     * provided. If iam_config.uniform_bucket_level_access is enabled on this
+     * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
      * bucket, requests to set, read, or modify acl is an error.
      *
                                            * @@ -34135,7 +34141,7 @@ public Builder addAllDefaultObjectAcl( * * 
                                                  * Optional. Default access controls to apply to new objects when no ACL is
-     * provided. If iam_config.uniform_bucket_level_access is enabled on this
+     * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
      * bucket, requests to set, read, or modify acl is an error.
      *
                                            * @@ -34159,7 +34165,7 @@ public Builder clearDefaultObjectAcl() { * * 
                                                  * Optional. Default access controls to apply to new objects when no ACL is
-     * provided. If iam_config.uniform_bucket_level_access is enabled on this
+     * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
      * bucket, requests to set, read, or modify acl is an error.
      *
                                            * @@ -34183,7 +34189,7 @@ public Builder removeDefaultObjectAcl(int index) { * * 
                                                  * Optional. Default access controls to apply to new objects when no ACL is
-     * provided. If iam_config.uniform_bucket_level_access is enabled on this
+     * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
      * bucket, requests to set, read, or modify acl is an error.
      *
                                            * @@ -34200,7 +34206,7 @@ public com.google.storage.v2.ObjectAccessControl.Builder getDefaultObjectAclBuil * * 
                                                  * Optional. Default access controls to apply to new objects when no ACL is
-     * provided. If iam_config.uniform_bucket_level_access is enabled on this
+     * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
      * bucket, requests to set, read, or modify acl is an error.
      *
                                            * @@ -34222,7 +34228,7 @@ public com.google.storage.v2.ObjectAccessControlOrBuilder getDefaultObjectAclOrB * * 
                                                  * Optional. Default access controls to apply to new objects when no ACL is
-     * provided. If iam_config.uniform_bucket_level_access is enabled on this
+     * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
      * bucket, requests to set, read, or modify acl is an error.
      *
                                            * @@ -34244,7 +34250,7 @@ public com.google.storage.v2.ObjectAccessControlOrBuilder getDefaultObjectAclOrB * * 
                                                  * Optional. Default access controls to apply to new objects when no ACL is
-     * provided. If iam_config.uniform_bucket_level_access is enabled on this
+     * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
      * bucket, requests to set, read, or modify acl is an error.
      *
                                            * @@ -34262,7 +34268,7 @@ public com.google.storage.v2.ObjectAccessControl.Builder addDefaultObjectAclBuil * * 
                                                  * Optional. Default access controls to apply to new objects when no ACL is
-     * provided. If iam_config.uniform_bucket_level_access is enabled on this
+     * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
      * bucket, requests to set, read, or modify acl is an error.
      *
                                            * @@ -34280,7 +34286,7 @@ public com.google.storage.v2.ObjectAccessControl.Builder addDefaultObjectAclBuil * * 
                                                  * Optional. Default access controls to apply to new objects when no ACL is
-     * provided. If iam_config.uniform_bucket_level_access is enabled on this
+     * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
      * bucket, requests to set, read, or modify acl is an error.
      *
                                            * @@ -34324,9 +34330,9 @@ public com.google.storage.v2.ObjectAccessControl.Builder addDefaultObjectAclBuil * * * 
                                            -     * Optional. The bucket's lifecycle config. See
-     * [https://developers.google.com/storage/docs/lifecycle]Lifecycle Management]
-     * for more information.
+     * Optional. The bucket's lifecycle configuration. See [Lifecycle
+     * Management](https://developers.google.com/storage/docs/lifecycle) for more
+     * information.
      *
                                            * * @@ -34343,9 +34349,9 @@ public boolean hasLifecycle() { * * * 
                                            -     * Optional. The bucket's lifecycle config. See
-     * [https://developers.google.com/storage/docs/lifecycle]Lifecycle Management]
-     * for more information.
+     * Optional. The bucket's lifecycle configuration. See [Lifecycle
+     * Management](https://developers.google.com/storage/docs/lifecycle) for more
+     * information.
      *
                                            * * @@ -34368,9 +34374,9 @@ public com.google.storage.v2.Bucket.Lifecycle getLifecycle() { * * * 
                                            -     * Optional. The bucket's lifecycle config. See
-     * [https://developers.google.com/storage/docs/lifecycle]Lifecycle Management]
-     * for more information.
+     * Optional. The bucket's lifecycle configuration. See [Lifecycle
+     * Management](https://developers.google.com/storage/docs/lifecycle) for more
+     * information.
      *
                                            * * @@ -34395,9 +34401,9 @@ public Builder setLifecycle(com.google.storage.v2.Bucket.Lifecycle value) { * * * 
                                            -     * Optional. The bucket's lifecycle config. See
-     * [https://developers.google.com/storage/docs/lifecycle]Lifecycle Management]
-     * for more information.
+     * Optional. The bucket's lifecycle configuration. See [Lifecycle
+     * Management](https://developers.google.com/storage/docs/lifecycle) for more
+     * information.
      *
                                            * * @@ -34419,9 +34425,9 @@ public Builder setLifecycle(com.google.storage.v2.Bucket.Lifecycle.Builder build * * * 
                                            -     * Optional. The bucket's lifecycle config. See
-     * [https://developers.google.com/storage/docs/lifecycle]Lifecycle Management]
-     * for more information.
+     * Optional. The bucket's lifecycle configuration. See [Lifecycle
+     * Management](https://developers.google.com/storage/docs/lifecycle) for more
+     * information.
      *
                                            * * @@ -34451,9 +34457,9 @@ public Builder mergeLifecycle(com.google.storage.v2.Bucket.Lifecycle value) { * * * 
                                            -     * Optional. The bucket's lifecycle config. See
-     * [https://developers.google.com/storage/docs/lifecycle]Lifecycle Management]
-     * for more information.
+     * Optional. The bucket's lifecycle configuration. See [Lifecycle
+     * Management](https://developers.google.com/storage/docs/lifecycle) for more
+     * information.
      *
                                            * * @@ -34475,9 +34481,9 @@ public Builder clearLifecycle() { * * * 
                                            -     * Optional. The bucket's lifecycle config. See
-     * [https://developers.google.com/storage/docs/lifecycle]Lifecycle Management]
-     * for more information.
+     * Optional. The bucket's lifecycle configuration. See [Lifecycle
+     * Management](https://developers.google.com/storage/docs/lifecycle) for more
+     * information.
      *
                                            * * @@ -34494,9 +34500,9 @@ public com.google.storage.v2.Bucket.Lifecycle.Builder getLifecycleBuilder() { * * * 
                                            -     * Optional. The bucket's lifecycle config. See
-     * [https://developers.google.com/storage/docs/lifecycle]Lifecycle Management]
-     * for more information.
+     * Optional. The bucket's lifecycle configuration. See [Lifecycle
+     * Management](https://developers.google.com/storage/docs/lifecycle) for more
+     * information.
      *
                                            * * @@ -34517,9 +34523,9 @@ public com.google.storage.v2.Bucket.LifecycleOrBuilder getLifecycleOrBuilder() { * * * 
                                            -     * Optional. The bucket's lifecycle config. See
-     * [https://developers.google.com/storage/docs/lifecycle]Lifecycle Management]
-     * for more information.
+     * Optional. The bucket's lifecycle configuration. See [Lifecycle
+     * Management](https://developers.google.com/storage/docs/lifecycle) for more
+     * information.
      *
                                            * * @@ -34775,8 +34781,8 @@ private void ensureCorsIsMutable() { * * * 
                                            -     * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
-     * Sharing] (CORS) config.
+     * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+     * configuration.
      *
                                            * * @@ -34795,8 +34801,8 @@ public java.util.List getCorsList() { * * * 
                                            -     * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
-     * Sharing] (CORS) config.
+     * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+     * configuration.
      *
                                            * * @@ -34815,8 +34821,8 @@ public int getCorsCount() { * * * 
                                            -     * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
-     * Sharing] (CORS) config.
+     * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+     * configuration.
      *
                                            * * @@ -34835,8 +34841,8 @@ public com.google.storage.v2.Bucket.Cors getCors(int index) { * * * 
                                            -     * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
-     * Sharing] (CORS) config.
+     * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+     * configuration.
      *
                                            * * @@ -34861,8 +34867,8 @@ public Builder setCors(int index, com.google.storage.v2.Bucket.Cors value) { * * * 
                                            -     * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
-     * Sharing] (CORS) config.
+     * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+     * configuration.
      *
                                            * * @@ -34884,8 +34890,8 @@ public Builder setCors(int index, com.google.storage.v2.Bucket.Cors.Builder buil * * * 
                                            -     * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
-     * Sharing] (CORS) config.
+     * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+     * configuration.
      *
                                            * * @@ -34910,8 +34916,8 @@ public Builder addCors(com.google.storage.v2.Bucket.Cors value) { * * * 
                                            -     * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
-     * Sharing] (CORS) config.
+     * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+     * configuration.
      *
                                            * * @@ -34936,8 +34942,8 @@ public Builder addCors(int index, com.google.storage.v2.Bucket.Cors value) { * * * 
                                            -     * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
-     * Sharing] (CORS) config.
+     * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+     * configuration.
      *
                                            * * @@ -34959,8 +34965,8 @@ public Builder addCors(com.google.storage.v2.Bucket.Cors.Builder builderForValue * * * 
                                            -     * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
-     * Sharing] (CORS) config.
+     * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+     * configuration.
      *
                                            * * @@ -34982,8 +34988,8 @@ public Builder addCors(int index, com.google.storage.v2.Bucket.Cors.Builder buil * * * 
                                            -     * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
-     * Sharing] (CORS) config.
+     * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+     * configuration.
      *
                                            * * @@ -35006,8 +35012,8 @@ public Builder addAllCors( * * * 
                                            -     * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
-     * Sharing] (CORS) config.
+     * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+     * configuration.
      *
                                            * * @@ -35029,8 +35035,8 @@ public Builder clearCors() { * * * 
                                            -     * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
-     * Sharing] (CORS) config.
+     * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+     * configuration.
      *
                                            * * @@ -35052,8 +35058,8 @@ public Builder removeCors(int index) { * * * 
                                            -     * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
-     * Sharing] (CORS) config.
+     * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+     * configuration.
      *
                                            * * @@ -35068,8 +35074,8 @@ public com.google.storage.v2.Bucket.Cors.Builder getCorsBuilder(int index) { * * * 
                                            -     * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
-     * Sharing] (CORS) config.
+     * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+     * configuration.
      *
                                            * * @@ -35088,8 +35094,8 @@ public com.google.storage.v2.Bucket.CorsOrBuilder getCorsOrBuilder(int index) { * * * 
                                            -     * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
-     * Sharing] (CORS) config.
+     * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+     * configuration.
      *
                                            * * @@ -35109,8 +35115,8 @@ public com.google.storage.v2.Bucket.CorsOrBuilder getCorsOrBuilder(int index) { * * * 
                                            -     * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
-     * Sharing] (CORS) config.
+     * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+     * configuration.
      *
                                            * * @@ -35126,8 +35132,8 @@ public com.google.storage.v2.Bucket.Cors.Builder addCorsBuilder() { * * * 
                                            -     * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
-     * Sharing] (CORS) config.
+     * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+     * configuration.
      *
                                            * * @@ -35143,8 +35149,8 @@ public com.google.storage.v2.Bucket.Cors.Builder addCorsBuilder(int index) { * * * 
                                            -     * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
-     * Sharing] (CORS) config.
+     * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+     * configuration.
      *
                                            * * @@ -35393,11 +35399,11 @@ public com.google.protobuf.TimestampOrBuilder getUpdateTimeOrBuilder() { * Optional. The default value for event-based hold on newly created objects * in this bucket. Event-based hold is a way to retain objects indefinitely * until an event occurs, signified by the hold's release. After being - * released, such objects will be subject to bucket-level retention (if any). - * One sample use case of this flag is for banks to hold loan documents for at + * released, such objects are subject to bucket-level retention (if any). One + * sample use case of this flag is for banks to hold loan documents for at * least 3 years after loan is paid in full. Here, bucket-level retention is 3 * years and the event is loan being paid in full. In this example, these - * objects will be held intact for any number of years until the event has + * objects are held intact for any number of years until the event has * occurred (event-based hold on the object is released) and then 3 more years * after that. That means retention duration of the objects begins from the * moment event-based hold transitioned from true to false. Objects under @@ -35421,11 +35427,11 @@ public boolean getDefaultEventBasedHold() { * Optional. The default value for event-based hold on newly created objects * in this bucket. Event-based hold is a way to retain objects indefinitely * until an event occurs, signified by the hold's release. After being - * released, such objects will be subject to bucket-level retention (if any). - * One sample use case of this flag is for banks to hold loan documents for at + * released, such objects are subject to bucket-level retention (if any). One + * sample use case of this flag is for banks to hold loan documents for at * least 3 years after loan is paid in full. Here, bucket-level retention is 3 * years and the event is loan being paid in full. In this example, these - * objects will be held intact for any number of years until the event has + * objects are held intact for any number of years until the event has * occurred (event-based hold on the object is released) and then 3 more years * after that. That means retention duration of the objects begins from the * moment event-based hold transitioned from true to false. Objects under @@ -35453,11 +35459,11 @@ public Builder setDefaultEventBasedHold(boolean value) { * Optional. The default value for event-based hold on newly created objects * in this bucket. Event-based hold is a way to retain objects indefinitely * until an event occurs, signified by the hold's release. After being - * released, such objects will be subject to bucket-level retention (if any). - * One sample use case of this flag is for banks to hold loan documents for at + * released, such objects are subject to bucket-level retention (if any). One + * sample use case of this flag is for banks to hold loan documents for at * least 3 years after loan is paid in full. Here, bucket-level retention is 3 * years and the event is loan being paid in full. In this example, these - * objects will be held intact for any number of years until the event has + * objects are held intact for any number of years until the event has * occurred (event-based hold on the object is released) and then 3 more years * after that. That means retention duration of the objects begins from the * moment event-based hold transitioned from true to false. Objects under @@ -35660,9 +35666,9 @@ public Builder putAllLabels(java.util.Map va * * 
                                                  * Optional. The bucket's website config, controlling how the service behaves
-     * when accessing bucket contents as a web site. See the
-     * [https://cloud.google.com/storage/docs/static-website][Static Website
-     * Examples] for more information.
+     * when accessing bucket contents as a web site. See the [Static website
+     * examples](https://cloud.google.com/storage/docs/static-website) for more
+     * information.
      *
                                            * * @@ -35680,9 +35686,9 @@ public boolean hasWebsite() { * * 
                                                  * Optional. The bucket's website config, controlling how the service behaves
-     * when accessing bucket contents as a web site. See the
-     * [https://cloud.google.com/storage/docs/static-website][Static Website
-     * Examples] for more information.
+     * when accessing bucket contents as a web site. See the [Static website
+     * examples](https://cloud.google.com/storage/docs/static-website) for more
+     * information.
      *
                                            * * @@ -35706,9 +35712,9 @@ public com.google.storage.v2.Bucket.Website getWebsite() { * * 
                                                  * Optional. The bucket's website config, controlling how the service behaves
-     * when accessing bucket contents as a web site. See the
-     * [https://cloud.google.com/storage/docs/static-website][Static Website
-     * Examples] for more information.
+     * when accessing bucket contents as a web site. See the [Static website
+     * examples](https://cloud.google.com/storage/docs/static-website) for more
+     * information.
      *
                                            * * @@ -35734,9 +35740,9 @@ public Builder setWebsite(com.google.storage.v2.Bucket.Website value) { * * 
                                                  * Optional. The bucket's website config, controlling how the service behaves
-     * when accessing bucket contents as a web site. See the
-     * [https://cloud.google.com/storage/docs/static-website][Static Website
-     * Examples] for more information.
+     * when accessing bucket contents as a web site. See the [Static website
+     * examples](https://cloud.google.com/storage/docs/static-website) for more
+     * information.
      *
                                            * * @@ -35759,9 +35765,9 @@ public Builder setWebsite(com.google.storage.v2.Bucket.Website.Builder builderFo * * 
                                                  * Optional. The bucket's website config, controlling how the service behaves
-     * when accessing bucket contents as a web site. See the
-     * [https://cloud.google.com/storage/docs/static-website][Static Website
-     * Examples] for more information.
+     * when accessing bucket contents as a web site. See the [Static website
+     * examples](https://cloud.google.com/storage/docs/static-website) for more
+     * information.
      *
                                            * * @@ -35792,9 +35798,9 @@ public Builder mergeWebsite(com.google.storage.v2.Bucket.Website value) { * * 
                                                  * Optional. The bucket's website config, controlling how the service behaves
-     * when accessing bucket contents as a web site. See the
-     * [https://cloud.google.com/storage/docs/static-website][Static Website
-     * Examples] for more information.
+     * when accessing bucket contents as a web site. See the [Static website
+     * examples](https://cloud.google.com/storage/docs/static-website) for more
+     * information.
      *
                                            * * @@ -35817,9 +35823,9 @@ public Builder clearWebsite() { * * 
                                                  * Optional. The bucket's website config, controlling how the service behaves
-     * when accessing bucket contents as a web site. See the
-     * [https://cloud.google.com/storage/docs/static-website][Static Website
-     * Examples] for more information.
+     * when accessing bucket contents as a web site. See the [Static website
+     * examples](https://cloud.google.com/storage/docs/static-website) for more
+     * information.
      *
                                            * * @@ -35837,9 +35843,9 @@ public com.google.storage.v2.Bucket.Website.Builder getWebsiteBuilder() { * * 
                                                  * Optional. The bucket's website config, controlling how the service behaves
-     * when accessing bucket contents as a web site. See the
-     * [https://cloud.google.com/storage/docs/static-website][Static Website
-     * Examples] for more information.
+     * when accessing bucket contents as a web site. See the [Static website
+     * examples](https://cloud.google.com/storage/docs/static-website) for more
+     * information.
      *
                                            * * @@ -35861,9 +35867,9 @@ public com.google.storage.v2.Bucket.WebsiteOrBuilder getWebsiteOrBuilder() { * * 
                                                  * Optional. The bucket's website config, controlling how the service behaves
-     * when accessing bucket contents as a web site. See the
-     * [https://cloud.google.com/storage/docs/static-website][Static Website
-     * Examples] for more information.
+     * when accessing bucket contents as a web site. See the [Static website
+     * examples](https://cloud.google.com/storage/docs/static-website) for more
+     * information.
      *
                                            * * @@ -35898,7 +35904,7 @@ public com.google.storage.v2.Bucket.WebsiteOrBuilder getWebsiteOrBuilder() { * * * 
                                            -     * Optional. The bucket's versioning config.
+     * Optional. The bucket's versioning configuration.
      *
                                            * * @@ -35915,7 +35921,7 @@ public boolean hasVersioning() { * * * 
                                            -     * Optional. The bucket's versioning config.
+     * Optional. The bucket's versioning configuration.
      *
                                            * * @@ -35938,7 +35944,7 @@ public com.google.storage.v2.Bucket.Versioning getVersioning() { * * * 
                                            -     * Optional. The bucket's versioning config.
+     * Optional. The bucket's versioning configuration.
      *
                                            * * @@ -35963,7 +35969,7 @@ public Builder setVersioning(com.google.storage.v2.Bucket.Versioning value) { * * * 
                                            -     * Optional. The bucket's versioning config.
+     * Optional. The bucket's versioning configuration.
      *
                                            * * @@ -35985,7 +35991,7 @@ public Builder setVersioning(com.google.storage.v2.Bucket.Versioning.Builder bui * * * 
                                            -     * Optional. The bucket's versioning config.
+     * Optional. The bucket's versioning configuration.
      *
                                            * * @@ -36015,7 +36021,7 @@ public Builder mergeVersioning(com.google.storage.v2.Bucket.Versioning value) { * * * 
                                            -     * Optional. The bucket's versioning config.
+     * Optional. The bucket's versioning configuration.
      *
                                            * * @@ -36037,7 +36043,7 @@ public Builder clearVersioning() { * * * 
                                            -     * Optional. The bucket's versioning config.
+     * Optional. The bucket's versioning configuration.
      *
                                            * * @@ -36054,7 +36060,7 @@ public com.google.storage.v2.Bucket.Versioning.Builder getVersioningBuilder() { * * * 
                                            -     * Optional. The bucket's versioning config.
+     * Optional. The bucket's versioning configuration.
      *
                                            * * @@ -36075,7 +36081,7 @@ public com.google.storage.v2.Bucket.VersioningOrBuilder getVersioningOrBuilder() * * * 
                                            -     * Optional. The bucket's versioning config.
+     * Optional. The bucket's versioning configuration.
      *
                                            * * @@ -36751,7 +36757,7 @@ public com.google.storage.v2.Bucket.EncryptionOrBuilder getEncryptionOrBuilder() * * * 
                                            -     * Optional. The bucket's billing config.
+     * Optional. The bucket's billing configuration.
      *
                                            * * @@ -36768,7 +36774,7 @@ public boolean hasBilling() { * * * 
                                            -     * Optional. The bucket's billing config.
+     * Optional. The bucket's billing configuration.
      *
                                            * * @@ -36791,7 +36797,7 @@ public com.google.storage.v2.Bucket.Billing getBilling() { * * * 
                                            -     * Optional. The bucket's billing config.
+     * Optional. The bucket's billing configuration.
      *
                                            * * @@ -36816,7 +36822,7 @@ public Builder setBilling(com.google.storage.v2.Bucket.Billing value) { * * * 
                                            -     * Optional. The bucket's billing config.
+     * Optional. The bucket's billing configuration.
      *
                                            * * @@ -36838,7 +36844,7 @@ public Builder setBilling(com.google.storage.v2.Bucket.Billing.Builder builderFo * * * 
                                            -     * Optional. The bucket's billing config.
+     * Optional. The bucket's billing configuration.
      *
                                            * * @@ -36868,7 +36874,7 @@ public Builder mergeBilling(com.google.storage.v2.Bucket.Billing value) { * * * 
                                            -     * Optional. The bucket's billing config.
+     * Optional. The bucket's billing configuration.
      *
                                            * * @@ -36890,7 +36896,7 @@ public Builder clearBilling() { * * * 
                                            -     * Optional. The bucket's billing config.
+     * Optional. The bucket's billing configuration.
      *
                                            * * @@ -36907,7 +36913,7 @@ public com.google.storage.v2.Bucket.Billing.Builder getBillingBuilder() { * * * 
                                            -     * Optional. The bucket's billing config.
+     * Optional. The bucket's billing configuration.
      *
                                            * * @@ -36928,7 +36934,7 @@ public com.google.storage.v2.Bucket.BillingOrBuilder getBillingOrBuilder() { * * * 
                                            -     * Optional. The bucket's billing config.
+     * Optional. The bucket's billing configuration.
      *
                                            * * @@ -36966,12 +36972,12 @@ public com.google.storage.v2.Bucket.BillingOrBuilder getBillingOrBuilder() { * Optional. The bucket's retention policy. The retention policy enforces a * minimum retention time for all objects contained in the bucket, based on * their creation time. Any attempt to overwrite or delete objects younger - * than the retention period will result in a PERMISSION_DENIED error. An + * than the retention period results in a `PERMISSION_DENIED` error. An * unlocked retention policy can be modified or removed from the bucket via a * storage.buckets.update operation. A locked retention policy cannot be * removed or shortened in duration for the lifetime of the bucket. - * Attempting to remove or decrease period of a locked retention policy will - * result in a PERMISSION_DENIED error. + * Attempting to remove or decrease period of a locked retention policy + * results in a `PERMISSION_DENIED` error. * * * @@ -36991,12 +36997,12 @@ public boolean hasRetentionPolicy() { * Optional. The bucket's retention policy. The retention policy enforces a * minimum retention time for all objects contained in the bucket, based on * their creation time. Any attempt to overwrite or delete objects younger - * than the retention period will result in a PERMISSION_DENIED error. An + * than the retention period results in a `PERMISSION_DENIED` error. An * unlocked retention policy can be modified or removed from the bucket via a * storage.buckets.update operation. A locked retention policy cannot be * removed or shortened in duration for the lifetime of the bucket. - * Attempting to remove or decrease period of a locked retention policy will - * result in a PERMISSION_DENIED error. + * Attempting to remove or decrease period of a locked retention policy + * results in a `PERMISSION_DENIED` error. * * * @@ -37022,12 +37028,12 @@ public com.google.storage.v2.Bucket.RetentionPolicy getRetentionPolicy() { * Optional. The bucket's retention policy. The retention policy enforces a * minimum retention time for all objects contained in the bucket, based on * their creation time. Any attempt to overwrite or delete objects younger - * than the retention period will result in a PERMISSION_DENIED error. An + * than the retention period results in a `PERMISSION_DENIED` error. An * unlocked retention policy can be modified or removed from the bucket via a * storage.buckets.update operation. A locked retention policy cannot be * removed or shortened in duration for the lifetime of the bucket. - * Attempting to remove or decrease period of a locked retention policy will - * result in a PERMISSION_DENIED error. + * Attempting to remove or decrease period of a locked retention policy + * results in a `PERMISSION_DENIED` error. * * * @@ -37055,12 +37061,12 @@ public Builder setRetentionPolicy(com.google.storage.v2.Bucket.RetentionPolicy v * Optional. The bucket's retention policy. The retention policy enforces a * minimum retention time for all objects contained in the bucket, based on * their creation time. Any attempt to overwrite or delete objects younger - * than the retention period will result in a PERMISSION_DENIED error. An + * than the retention period results in a `PERMISSION_DENIED` error. An * unlocked retention policy can be modified or removed from the bucket via a * storage.buckets.update operation. A locked retention policy cannot be * removed or shortened in duration for the lifetime of the bucket. - * Attempting to remove or decrease period of a locked retention policy will - * result in a PERMISSION_DENIED error. + * Attempting to remove or decrease period of a locked retention policy + * results in a `PERMISSION_DENIED` error. * * * @@ -37086,12 +37092,12 @@ public Builder setRetentionPolicy( * Optional. The bucket's retention policy. The retention policy enforces a * minimum retention time for all objects contained in the bucket, based on * their creation time. Any attempt to overwrite or delete objects younger - * than the retention period will result in a PERMISSION_DENIED error. An + * than the retention period results in a `PERMISSION_DENIED` error. An * unlocked retention policy can be modified or removed from the bucket via a * storage.buckets.update operation. A locked retention policy cannot be * removed or shortened in duration for the lifetime of the bucket. - * Attempting to remove or decrease period of a locked retention policy will - * result in a PERMISSION_DENIED error. + * Attempting to remove or decrease period of a locked retention policy + * results in a `PERMISSION_DENIED` error. * * * @@ -37125,12 +37131,12 @@ public Builder mergeRetentionPolicy(com.google.storage.v2.Bucket.RetentionPolicy * Optional. The bucket's retention policy. The retention policy enforces a * minimum retention time for all objects contained in the bucket, based on * their creation time. Any attempt to overwrite or delete objects younger - * than the retention period will result in a PERMISSION_DENIED error. An + * than the retention period results in a `PERMISSION_DENIED` error. An * unlocked retention policy can be modified or removed from the bucket via a * storage.buckets.update operation. A locked retention policy cannot be * removed or shortened in duration for the lifetime of the bucket. - * Attempting to remove or decrease period of a locked retention policy will - * result in a PERMISSION_DENIED error. + * Attempting to remove or decrease period of a locked retention policy + * results in a `PERMISSION_DENIED` error. * * * @@ -37155,12 +37161,12 @@ public Builder clearRetentionPolicy() { * Optional. The bucket's retention policy. The retention policy enforces a * minimum retention time for all objects contained in the bucket, based on * their creation time. Any attempt to overwrite or delete objects younger - * than the retention period will result in a PERMISSION_DENIED error. An + * than the retention period results in a `PERMISSION_DENIED` error. An * unlocked retention policy can be modified or removed from the bucket via a * storage.buckets.update operation. A locked retention policy cannot be * removed or shortened in duration for the lifetime of the bucket. - * Attempting to remove or decrease period of a locked retention policy will - * result in a PERMISSION_DENIED error. + * Attempting to remove or decrease period of a locked retention policy + * results in a `PERMISSION_DENIED` error. * * * @@ -37180,12 +37186,12 @@ public com.google.storage.v2.Bucket.RetentionPolicy.Builder getRetentionPolicyBu * Optional. The bucket's retention policy. The retention policy enforces a * minimum retention time for all objects contained in the bucket, based on * their creation time. Any attempt to overwrite or delete objects younger - * than the retention period will result in a PERMISSION_DENIED error. An + * than the retention period results in a `PERMISSION_DENIED` error. An * unlocked retention policy can be modified or removed from the bucket via a * storage.buckets.update operation. A locked retention policy cannot be * removed or shortened in duration for the lifetime of the bucket. - * Attempting to remove or decrease period of a locked retention policy will - * result in a PERMISSION_DENIED error. + * Attempting to remove or decrease period of a locked retention policy + * results in a `PERMISSION_DENIED` error. * * * @@ -37209,12 +37215,12 @@ public com.google.storage.v2.Bucket.RetentionPolicyOrBuilder getRetentionPolicyO * Optional. The bucket's retention policy. The retention policy enforces a * minimum retention time for all objects contained in the bucket, based on * their creation time. Any attempt to overwrite or delete objects younger - * than the retention period will result in a PERMISSION_DENIED error. An + * than the retention period results in a `PERMISSION_DENIED` error. An * unlocked retention policy can be modified or removed from the bucket via a * storage.buckets.update operation. A locked retention policy cannot be * removed or shortened in duration for the lifetime of the bucket. - * Attempting to remove or decrease period of a locked retention policy will - * result in a PERMISSION_DENIED error. + * Attempting to remove or decrease period of a locked retention policy + * results in a `PERMISSION_DENIED` error. * * * @@ -37249,7 +37255,7 @@ public com.google.storage.v2.Bucket.RetentionPolicyOrBuilder getRetentionPolicyO * * * 
                                            -     * Optional. The bucket's IAM config.
+     * Optional. The bucket's IAM configuration.
      *
                                            * * @@ -37266,7 +37272,7 @@ public boolean hasIamConfig() { * * * 
                                            -     * Optional. The bucket's IAM config.
+     * Optional. The bucket's IAM configuration.
      *
                                            * * @@ -37289,7 +37295,7 @@ public com.google.storage.v2.Bucket.IamConfig getIamConfig() { * * * 
                                            -     * Optional. The bucket's IAM config.
+     * Optional. The bucket's IAM configuration.
      *
                                            * * @@ -37314,7 +37320,7 @@ public Builder setIamConfig(com.google.storage.v2.Bucket.IamConfig value) { * * * 
                                            -     * Optional. The bucket's IAM config.
+     * Optional. The bucket's IAM configuration.
      *
                                            * * @@ -37336,7 +37342,7 @@ public Builder setIamConfig(com.google.storage.v2.Bucket.IamConfig.Builder build * * * 
                                            -     * Optional. The bucket's IAM config.
+     * Optional. The bucket's IAM configuration.
      *
                                            * * @@ -37366,7 +37372,7 @@ public Builder mergeIamConfig(com.google.storage.v2.Bucket.IamConfig value) { * * * 
                                            -     * Optional. The bucket's IAM config.
+     * Optional. The bucket's IAM configuration.
      *
                                            * * @@ -37388,7 +37394,7 @@ public Builder clearIamConfig() { * * * 
                                            -     * Optional. The bucket's IAM config.
+     * Optional. The bucket's IAM configuration.
      *
                                            * * @@ -37405,7 +37411,7 @@ public com.google.storage.v2.Bucket.IamConfig.Builder getIamConfigBuilder() { * * * 
                                            -     * Optional. The bucket's IAM config.
+     * Optional. The bucket's IAM configuration.
      *
                                            * * @@ -37426,7 +37432,7 @@ public com.google.storage.v2.Bucket.IamConfigOrBuilder getIamConfigOrBuilder() { * * * 
                                            -     * Optional. The bucket's IAM config.
+     * Optional. The bucket's IAM configuration.
      *
                                            * * @@ -37518,9 +37524,8 @@ public Builder clearSatisfiesPzs() { * * 
                                                  * Optional. Configuration that, if present, specifies the data placement for
-     * a
-     * [https://cloud.google.com/storage/docs/locations#location-dr][configurable
-     * dual-region].
+     * a [configurable
+     * dual-region](https://cloud.google.com/storage/docs/locations#location-dr).
      *
                                            * * @@ -37538,9 +37543,8 @@ public boolean hasCustomPlacementConfig() { * * 
                                                  * Optional. Configuration that, if present, specifies the data placement for
-     * a
-     * [https://cloud.google.com/storage/docs/locations#location-dr][configurable
-     * dual-region].
+     * a [configurable
+     * dual-region](https://cloud.google.com/storage/docs/locations#location-dr).
      *
                                            * * @@ -37564,9 +37568,8 @@ public com.google.storage.v2.Bucket.CustomPlacementConfig getCustomPlacementConf * * 
                                                  * Optional. Configuration that, if present, specifies the data placement for
-     * a
-     * [https://cloud.google.com/storage/docs/locations#location-dr][configurable
-     * dual-region].
+     * a [configurable
+     * dual-region](https://cloud.google.com/storage/docs/locations#location-dr).
      *
                                            * * @@ -37593,9 +37596,8 @@ public Builder setCustomPlacementConfig( * * 
                                                  * Optional. Configuration that, if present, specifies the data placement for
-     * a
-     * [https://cloud.google.com/storage/docs/locations#location-dr][configurable
-     * dual-region].
+     * a [configurable
+     * dual-region](https://cloud.google.com/storage/docs/locations#location-dr).
      *
                                            * * @@ -37619,9 +37621,8 @@ public Builder setCustomPlacementConfig( * * 
                                                  * Optional. Configuration that, if present, specifies the data placement for
-     * a
-     * [https://cloud.google.com/storage/docs/locations#location-dr][configurable
-     * dual-region].
+     * a [configurable
+     * dual-region](https://cloud.google.com/storage/docs/locations#location-dr).
      *
                                            * * @@ -37654,9 +37655,8 @@ public Builder mergeCustomPlacementConfig( * * 
                                                  * Optional. Configuration that, if present, specifies the data placement for
-     * a
-     * [https://cloud.google.com/storage/docs/locations#location-dr][configurable
-     * dual-region].
+     * a [configurable
+     * dual-region](https://cloud.google.com/storage/docs/locations#location-dr).
      *
                                            * * @@ -37679,9 +37679,8 @@ public Builder clearCustomPlacementConfig() { * * 
                                                  * Optional. Configuration that, if present, specifies the data placement for
-     * a
-     * [https://cloud.google.com/storage/docs/locations#location-dr][configurable
-     * dual-region].
+     * a [configurable
+     * dual-region](https://cloud.google.com/storage/docs/locations#location-dr).
      *
                                            * * @@ -37700,9 +37699,8 @@ public Builder clearCustomPlacementConfig() { * * 
                                                  * Optional. Configuration that, if present, specifies the data placement for
-     * a
-     * [https://cloud.google.com/storage/docs/locations#location-dr][configurable
-     * dual-region].
+     * a [configurable
+     * dual-region](https://cloud.google.com/storage/docs/locations#location-dr).
      *
                                            * * @@ -37725,9 +37723,8 @@ public Builder clearCustomPlacementConfig() { * * 
                                                  * Optional. Configuration that, if present, specifies the data placement for
-     * a
-     * [https://cloud.google.com/storage/docs/locations#location-dr][configurable
-     * dual-region].
+     * a [configurable
+     * dual-region](https://cloud.google.com/storage/docs/locations#location-dr).
      *
                                            * * @@ -37763,8 +37760,8 @@ public Builder clearCustomPlacementConfig() { * * 
                                                  * Optional. The bucket's Autoclass configuration. If there is no
-     * configuration, the Autoclass feature will be disabled and have no effect on
-     * the bucket.
+     * configuration, the Autoclass feature is disabled and has no effect on the
+     * bucket.
      *
                                            * * @@ -37782,8 +37779,8 @@ public boolean hasAutoclass() { * * 
                                                  * Optional. The bucket's Autoclass configuration. If there is no
-     * configuration, the Autoclass feature will be disabled and have no effect on
-     * the bucket.
+     * configuration, the Autoclass feature is disabled and has no effect on the
+     * bucket.
      *
                                            * * @@ -37807,8 +37804,8 @@ public com.google.storage.v2.Bucket.Autoclass getAutoclass() { * * 
                                                  * Optional. The bucket's Autoclass configuration. If there is no
-     * configuration, the Autoclass feature will be disabled and have no effect on
-     * the bucket.
+     * configuration, the Autoclass feature is disabled and has no effect on the
+     * bucket.
      *
                                            * * @@ -37834,8 +37831,8 @@ public Builder setAutoclass(com.google.storage.v2.Bucket.Autoclass value) { * * 
                                                  * Optional. The bucket's Autoclass configuration. If there is no
-     * configuration, the Autoclass feature will be disabled and have no effect on
-     * the bucket.
+     * configuration, the Autoclass feature is disabled and has no effect on the
+     * bucket.
      *
                                            * * @@ -37858,8 +37855,8 @@ public Builder setAutoclass(com.google.storage.v2.Bucket.Autoclass.Builder build * * 
                                                  * Optional. The bucket's Autoclass configuration. If there is no
-     * configuration, the Autoclass feature will be disabled and have no effect on
-     * the bucket.
+     * configuration, the Autoclass feature is disabled and has no effect on the
+     * bucket.
      *
                                            * * @@ -37890,8 +37887,8 @@ public Builder mergeAutoclass(com.google.storage.v2.Bucket.Autoclass value) { * * 
                                                  * Optional. The bucket's Autoclass configuration. If there is no
-     * configuration, the Autoclass feature will be disabled and have no effect on
-     * the bucket.
+     * configuration, the Autoclass feature is disabled and has no effect on the
+     * bucket.
      *
                                            * * @@ -37914,8 +37911,8 @@ public Builder clearAutoclass() { * * 
                                                  * Optional. The bucket's Autoclass configuration. If there is no
-     * configuration, the Autoclass feature will be disabled and have no effect on
-     * the bucket.
+     * configuration, the Autoclass feature is disabled and has no effect on the
+     * bucket.
      *
                                            * * @@ -37933,8 +37930,8 @@ public com.google.storage.v2.Bucket.Autoclass.Builder getAutoclassBuilder() { * * 
                                                  * Optional. The bucket's Autoclass configuration. If there is no
-     * configuration, the Autoclass feature will be disabled and have no effect on
-     * the bucket.
+     * configuration, the Autoclass feature is disabled and has no effect on the
+     * bucket.
      *
                                            * * @@ -37956,8 +37953,8 @@ public com.google.storage.v2.Bucket.AutoclassOrBuilder getAutoclassOrBuilder() { * * 
                                                  * Optional. The bucket's Autoclass configuration. If there is no
-     * configuration, the Autoclass feature will be disabled and have no effect on
-     * the bucket.
+     * configuration, the Autoclass feature is disabled and has no effect on the
+     * bucket.
      *
                                            * * @@ -37993,7 +37990,7 @@ public com.google.storage.v2.Bucket.AutoclassOrBuilder getAutoclassOrBuilder() { * * 
                                                  * Optional. The bucket's hierarchical namespace configuration. If there is no
-     * configuration, the hierarchical namespace feature will be disabled and have
+     * configuration, the hierarchical namespace feature is disabled and has
      * no effect on the bucket.
      *
                                            * @@ -38012,7 +38009,7 @@ public boolean hasHierarchicalNamespace() { * * 
                                                  * Optional. The bucket's hierarchical namespace configuration. If there is no
-     * configuration, the hierarchical namespace feature will be disabled and have
+     * configuration, the hierarchical namespace feature is disabled and has
      * no effect on the bucket.
      *
                                            * @@ -38037,7 +38034,7 @@ public com.google.storage.v2.Bucket.HierarchicalNamespace getHierarchicalNamespa * * 
                                                  * Optional. The bucket's hierarchical namespace configuration. If there is no
-     * configuration, the hierarchical namespace feature will be disabled and have
+     * configuration, the hierarchical namespace feature is disabled and has
      * no effect on the bucket.
      *
                                            * @@ -38065,7 +38062,7 @@ public Builder setHierarchicalNamespace( * * 
                                                  * Optional. The bucket's hierarchical namespace configuration. If there is no
-     * configuration, the hierarchical namespace feature will be disabled and have
+     * configuration, the hierarchical namespace feature is disabled and has
      * no effect on the bucket.
      *
                                            * @@ -38090,7 +38087,7 @@ public Builder setHierarchicalNamespace( * * 
                                                  * Optional. The bucket's hierarchical namespace configuration. If there is no
-     * configuration, the hierarchical namespace feature will be disabled and have
+     * configuration, the hierarchical namespace feature is disabled and has
      * no effect on the bucket.
      *
                                            * @@ -38124,7 +38121,7 @@ public Builder mergeHierarchicalNamespace( * * 
                                                  * Optional. The bucket's hierarchical namespace configuration. If there is no
-     * configuration, the hierarchical namespace feature will be disabled and have
+     * configuration, the hierarchical namespace feature is disabled and has
      * no effect on the bucket.
      *
                                            * @@ -38148,7 +38145,7 @@ public Builder clearHierarchicalNamespace() { * * 
                                                  * Optional. The bucket's hierarchical namespace configuration. If there is no
-     * configuration, the hierarchical namespace feature will be disabled and have
+     * configuration, the hierarchical namespace feature is disabled and has
      * no effect on the bucket.
      *
                                            * @@ -38168,7 +38165,7 @@ public Builder clearHierarchicalNamespace() { * * 
                                                  * Optional. The bucket's hierarchical namespace configuration. If there is no
-     * configuration, the hierarchical namespace feature will be disabled and have
+     * configuration, the hierarchical namespace feature is disabled and has
      * no effect on the bucket.
      *
                                            * @@ -38192,7 +38189,7 @@ public Builder clearHierarchicalNamespace() { * * 
                                                  * Optional. The bucket's hierarchical namespace configuration. If there is no
-     * configuration, the hierarchical namespace feature will be disabled and have
+     * configuration, the hierarchical namespace feature is disabled and has
      * no effect on the bucket.
      *
                                            * @@ -38452,7 +38449,7 @@ public com.google.storage.v2.Bucket.SoftDeletePolicyOrBuilder getSoftDeletePolic * * 
                                                  * Optional. The bucket's object retention configuration. Must be enabled
-     * before objects in the bucket may have retention configured.
+     * before objects in the bucket might have retention configured.
      *
                                            * * @@ -38470,7 +38467,7 @@ public boolean hasObjectRetention() { * * 
                                                  * Optional. The bucket's object retention configuration. Must be enabled
-     * before objects in the bucket may have retention configured.
+     * before objects in the bucket might have retention configured.
      *
                                            * * @@ -38494,7 +38491,7 @@ public com.google.storage.v2.Bucket.ObjectRetention getObjectRetention() { * * 
                                                  * Optional. The bucket's object retention configuration. Must be enabled
-     * before objects in the bucket may have retention configured.
+     * before objects in the bucket might have retention configured.
      *
                                            * * @@ -38520,7 +38517,7 @@ public Builder setObjectRetention(com.google.storage.v2.Bucket.ObjectRetention v * * 
                                                  * Optional. The bucket's object retention configuration. Must be enabled
-     * before objects in the bucket may have retention configured.
+     * before objects in the bucket might have retention configured.
      *
                                            * * @@ -38544,7 +38541,7 @@ public Builder setObjectRetention( * * 
                                                  * Optional. The bucket's object retention configuration. Must be enabled
-     * before objects in the bucket may have retention configured.
+     * before objects in the bucket might have retention configured.
      *
                                            * * @@ -38576,7 +38573,7 @@ public Builder mergeObjectRetention(com.google.storage.v2.Bucket.ObjectRetention * * 
                                                  * Optional. The bucket's object retention configuration. Must be enabled
-     * before objects in the bucket may have retention configured.
+     * before objects in the bucket might have retention configured.
      *
                                            * * @@ -38599,7 +38596,7 @@ public Builder clearObjectRetention() { * * 
                                                  * Optional. The bucket's object retention configuration. Must be enabled
-     * before objects in the bucket may have retention configured.
+     * before objects in the bucket might have retention configured.
      *
                                            * * @@ -38617,7 +38614,7 @@ public com.google.storage.v2.Bucket.ObjectRetention.Builder getObjectRetentionBu * * 
                                                  * Optional. The bucket's object retention configuration. Must be enabled
-     * before objects in the bucket may have retention configured.
+     * before objects in the bucket might have retention configured.
      *
                                            * * @@ -38639,7 +38636,7 @@ public com.google.storage.v2.Bucket.ObjectRetentionOrBuilder getObjectRetentionO * * 
                                                  * Optional. The bucket's object retention configuration. Must be enabled
-     * before objects in the bucket may have retention configured.
+     * before objects in the bucket might have retention configured.
      *
                                            * * diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BucketAccessControl.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BucketAccessControl.java index ad4d5e0414..78ba0b195e 100644 --- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BucketAccessControl.java +++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BucketAccessControl.java @@ -203,7 +203,7 @@ public com.google.protobuf.ByteString getIdBytes() { * `group-example@googlegroups.com` * * All members of the Google Apps for Business domain `example.com` would be * `domain-example.com` - * For project entities, `project-{team}-{projectnumber}` format will be + * For project entities, `project-{team}-{projectnumber}` format is * returned on response. * * @@ -244,7 +244,7 @@ public java.lang.String getEntity() { * `group-example@googlegroups.com` * * All members of the Google Apps for Business domain `example.com` would be * `domain-example.com` - * For project entities, `project-{team}-{projectnumber}` format will be + * For project entities, `project-{team}-{projectnumber}` format is * returned on response. * * @@ -275,7 +275,7 @@ public com.google.protobuf.ByteString getEntityBytes() { * * 
                                                * Output only. The alternative entity format, if exists. For project
-   * entities, `project-{team}-{projectid}` format will be returned on response.
+   * entities, `project-{team}-{projectid}` format is returned in the response.
    *
                                            * * string entity_alt = 9 [(.google.api.field_behavior) = OUTPUT_ONLY]; @@ -300,7 +300,7 @@ public java.lang.String getEntityAlt() { * * 
                                                * Output only. The alternative entity format, if exists. For project
-   * entities, `project-{team}-{projectid}` format will be returned on response.
+   * entities, `project-{team}-{projectid}` format is returned in the response.
    *
                                            * * string entity_alt = 9 [(.google.api.field_behavior) = OUTPUT_ONLY]; @@ -382,10 +382,10 @@ public com.google.protobuf.ByteString getEntityIdBytes() { * * * 
                                            -   * Optional. The etag of the BucketAccessControl.
+   * Optional. The `etag` of the `BucketAccessControl`.
    * If included in the metadata of an update or delete request message, the
-   * operation operation will only be performed if the etag matches that of the
-   * bucket's BucketAccessControl.
+   * operation operation is only performed if the etag matches that of the
+   * bucket's `BucketAccessControl`.
    *
                                            * * string etag = 8 [(.google.api.field_behavior) = OPTIONAL]; @@ -409,10 +409,10 @@ public java.lang.String getEtag() { * * * 
                                            -   * Optional. The etag of the BucketAccessControl.
+   * Optional. The `etag` of the `BucketAccessControl`.
    * If included in the metadata of an update or delete request message, the
-   * operation operation will only be performed if the etag matches that of the
-   * bucket's BucketAccessControl.
+   * operation operation is only performed if the etag matches that of the
+   * bucket's `BucketAccessControl`.
    *
                                            * * string etag = 8 [(.google.api.field_behavior) = OPTIONAL]; @@ -1395,7 +1395,7 @@ public Builder setIdBytes(com.google.protobuf.ByteString value) { * `group-example@googlegroups.com` * * All members of the Google Apps for Business domain `example.com` would be * `domain-example.com` - * For project entities, `project-{team}-{projectnumber}` format will be + * For project entities, `project-{team}-{projectnumber}` format is * returned on response. * * @@ -1435,7 +1435,7 @@ public java.lang.String getEntity() { * `group-example@googlegroups.com` * * All members of the Google Apps for Business domain `example.com` would be * `domain-example.com` - * For project entities, `project-{team}-{projectnumber}` format will be + * For project entities, `project-{team}-{projectnumber}` format is * returned on response. * * @@ -1475,7 +1475,7 @@ public com.google.protobuf.ByteString getEntityBytes() { * `group-example@googlegroups.com` * * All members of the Google Apps for Business domain `example.com` would be * `domain-example.com` - * For project entities, `project-{team}-{projectnumber}` format will be + * For project entities, `project-{team}-{projectnumber}` format is * returned on response. * * @@ -1514,7 +1514,7 @@ public Builder setEntity(java.lang.String value) { * `group-example@googlegroups.com` * * All members of the Google Apps for Business domain `example.com` would be * `domain-example.com` - * For project entities, `project-{team}-{projectnumber}` format will be + * For project entities, `project-{team}-{projectnumber}` format is * returned on response. * * @@ -1549,7 +1549,7 @@ public Builder clearEntity() { * `group-example@googlegroups.com` * * All members of the Google Apps for Business domain `example.com` would be * `domain-example.com` - * For project entities, `project-{team}-{projectnumber}` format will be + * For project entities, `project-{team}-{projectnumber}` format is * returned on response. * * @@ -1576,7 +1576,7 @@ public Builder setEntityBytes(com.google.protobuf.ByteString value) { * * 
                                                  * Output only. The alternative entity format, if exists. For project
-     * entities, `project-{team}-{projectid}` format will be returned on response.
+     * entities, `project-{team}-{projectid}` format is returned in the response.
      *
                                            * * string entity_alt = 9 [(.google.api.field_behavior) = OUTPUT_ONLY]; @@ -1600,7 +1600,7 @@ public java.lang.String getEntityAlt() { * * 
                                                  * Output only. The alternative entity format, if exists. For project
-     * entities, `project-{team}-{projectid}` format will be returned on response.
+     * entities, `project-{team}-{projectid}` format is returned in the response.
      *
                                            * * string entity_alt = 9 [(.google.api.field_behavior) = OUTPUT_ONLY]; @@ -1624,7 +1624,7 @@ public com.google.protobuf.ByteString getEntityAltBytes() { * * 
                                                  * Output only. The alternative entity format, if exists. For project
-     * entities, `project-{team}-{projectid}` format will be returned on response.
+     * entities, `project-{team}-{projectid}` format is returned in the response.
      *
                                            * * string entity_alt = 9 [(.google.api.field_behavior) = OUTPUT_ONLY]; @@ -1647,7 +1647,7 @@ public Builder setEntityAlt(java.lang.String value) { * * 
                                                  * Output only. The alternative entity format, if exists. For project
-     * entities, `project-{team}-{projectid}` format will be returned on response.
+     * entities, `project-{team}-{projectid}` format is returned in the response.
      *
                                            * * string entity_alt = 9 [(.google.api.field_behavior) = OUTPUT_ONLY]; @@ -1666,7 +1666,7 @@ public Builder clearEntityAlt() { * * 
                                                  * Output only. The alternative entity format, if exists. For project
-     * entities, `project-{team}-{projectid}` format will be returned on response.
+     * entities, `project-{team}-{projectid}` format is returned in the response.
      *
                                            * * string entity_alt = 9 [(.google.api.field_behavior) = OUTPUT_ONLY]; @@ -1802,10 +1802,10 @@ public Builder setEntityIdBytes(com.google.protobuf.ByteString value) { * * * 
                                            -     * Optional. The etag of the BucketAccessControl.
+     * Optional. The `etag` of the `BucketAccessControl`.
      * If included in the metadata of an update or delete request message, the
-     * operation operation will only be performed if the etag matches that of the
-     * bucket's BucketAccessControl.
+     * operation operation is only performed if the etag matches that of the
+     * bucket's `BucketAccessControl`.
      *
                                            * * string etag = 8 [(.google.api.field_behavior) = OPTIONAL]; @@ -1828,10 +1828,10 @@ public java.lang.String getEtag() { * * * 
                                            -     * Optional. The etag of the BucketAccessControl.
+     * Optional. The `etag` of the `BucketAccessControl`.
      * If included in the metadata of an update or delete request message, the
-     * operation operation will only be performed if the etag matches that of the
-     * bucket's BucketAccessControl.
+     * operation operation is only performed if the etag matches that of the
+     * bucket's `BucketAccessControl`.
      *
                                            * * string etag = 8 [(.google.api.field_behavior) = OPTIONAL]; @@ -1854,10 +1854,10 @@ public com.google.protobuf.ByteString getEtagBytes() { * * * 
                                            -     * Optional. The etag of the BucketAccessControl.
+     * Optional. The `etag` of the `BucketAccessControl`.
      * If included in the metadata of an update or delete request message, the
-     * operation operation will only be performed if the etag matches that of the
-     * bucket's BucketAccessControl.
+     * operation operation is only performed if the etag matches that of the
+     * bucket's `BucketAccessControl`.
      *
                                            * * string etag = 8 [(.google.api.field_behavior) = OPTIONAL]; @@ -1879,10 +1879,10 @@ public Builder setEtag(java.lang.String value) { * * * 
                                            -     * Optional. The etag of the BucketAccessControl.
+     * Optional. The `etag` of the `BucketAccessControl`.
      * If included in the metadata of an update or delete request message, the
-     * operation operation will only be performed if the etag matches that of the
-     * bucket's BucketAccessControl.
+     * operation operation is only performed if the etag matches that of the
+     * bucket's `BucketAccessControl`.
      *
                                            * * string etag = 8 [(.google.api.field_behavior) = OPTIONAL]; @@ -1900,10 +1900,10 @@ public Builder clearEtag() { * * * 
                                            -     * Optional. The etag of the BucketAccessControl.
+     * Optional. The `etag` of the `BucketAccessControl`.
      * If included in the metadata of an update or delete request message, the
-     * operation operation will only be performed if the etag matches that of the
-     * bucket's BucketAccessControl.
+     * operation operation is only performed if the etag matches that of the
+     * bucket's `BucketAccessControl`.
      *
                                            * * string etag = 8 [(.google.api.field_behavior) = OPTIONAL]; diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BucketAccessControlOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BucketAccessControlOrBuilder.java index 85135aacec..43c897e583 100644 --- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BucketAccessControlOrBuilder.java +++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BucketAccessControlOrBuilder.java @@ -96,7 +96,7 @@ public interface BucketAccessControlOrBuilder * `group-example@googlegroups.com` * * All members of the Google Apps for Business domain `example.com` would be * `domain-example.com` - * For project entities, `project-{team}-{projectnumber}` format will be + * For project entities, `project-{team}-{projectnumber}` format is * returned on response. * * @@ -126,7 +126,7 @@ public interface BucketAccessControlOrBuilder * `group-example@googlegroups.com` * * All members of the Google Apps for Business domain `example.com` would be * `domain-example.com` - * For project entities, `project-{team}-{projectnumber}` format will be + * For project entities, `project-{team}-{projectnumber}` format is * returned on response. * * @@ -141,7 +141,7 @@ public interface BucketAccessControlOrBuilder * * 
                                                * Output only. The alternative entity format, if exists. For project
-   * entities, `project-{team}-{projectid}` format will be returned on response.
+   * entities, `project-{team}-{projectid}` format is returned in the response.
    *
                                            * * string entity_alt = 9 [(.google.api.field_behavior) = OUTPUT_ONLY]; @@ -155,7 +155,7 @@ public interface BucketAccessControlOrBuilder * * 
                                                * Output only. The alternative entity format, if exists. For project
-   * entities, `project-{team}-{projectid}` format will be returned on response.
+   * entities, `project-{team}-{projectid}` format is returned in the response.
    *
                                            * * string entity_alt = 9 [(.google.api.field_behavior) = OUTPUT_ONLY]; @@ -194,10 +194,10 @@ public interface BucketAccessControlOrBuilder * * * 
                                            -   * Optional. The etag of the BucketAccessControl.
+   * Optional. The `etag` of the `BucketAccessControl`.
    * If included in the metadata of an update or delete request message, the
-   * operation operation will only be performed if the etag matches that of the
-   * bucket's BucketAccessControl.
+   * operation operation is only performed if the etag matches that of the
+   * bucket's `BucketAccessControl`.
    *
                                            * * string etag = 8 [(.google.api.field_behavior) = OPTIONAL]; @@ -210,10 +210,10 @@ public interface BucketAccessControlOrBuilder * * * 
                                            -   * Optional. The etag of the BucketAccessControl.
+   * Optional. The `etag` of the `BucketAccessControl`.
    * If included in the metadata of an update or delete request message, the
-   * operation operation will only be performed if the etag matches that of the
-   * bucket's BucketAccessControl.
+   * operation operation is only performed if the etag matches that of the
+   * bucket's `BucketAccessControl`.
    *
                                            * * string etag = 8 [(.google.api.field_behavior) = OPTIONAL]; diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BucketOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BucketOrBuilder.java index 9f5b931207..a3b2d5d013 100644 --- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BucketOrBuilder.java +++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BucketOrBuilder.java @@ -58,7 +58,7 @@ public interface BucketOrBuilder * 
                                                * Output only. The user-chosen part of the bucket name. The `{bucket}`
    * portion of the `name` field. For globally unique buckets, this is equal to
-   * the "bucket name" of other Cloud Storage APIs. Example: "pub".
+   * the `bucket name` of other Cloud Storage APIs. Example: `pub`.
    *
                                            * * string bucket_id = 2 [(.google.api.field_behavior) = OUTPUT_ONLY]; @@ -73,7 +73,7 @@ public interface BucketOrBuilder * 
                                                * Output only. The user-chosen part of the bucket name. The `{bucket}`
    * portion of the `name` field. For globally unique buckets, this is equal to
-   * the "bucket name" of other Cloud Storage APIs. Example: "pub".
+   * the `bucket name` of other Cloud Storage APIs. Example: `pub`.
    *
                                            * * string bucket_id = 2 [(.google.api.field_behavior) = OUTPUT_ONLY]; @@ -87,8 +87,8 @@ public interface BucketOrBuilder * * 
                                                * The etag of the bucket.
-   * If included in the metadata of an UpdateBucketRequest, the operation will
-   * only be performed if the etag matches that of the bucket.
+   * If included in the metadata of an `UpdateBucketRequest`, the operation is
+   * only performed if the `etag` matches that of the bucket.
    *
                                            * * string etag = 29; @@ -102,8 +102,8 @@ public interface BucketOrBuilder * * 
                                                * The etag of the bucket.
-   * If included in the metadata of an UpdateBucketRequest, the operation will
-   * only be performed if the etag matches that of the bucket.
+   * If included in the metadata of an `UpdateBucketRequest`, the operation is
+   * only performed if the `etag` matches that of the bucket.
    *
                                            * * string etag = 29; @@ -117,9 +117,9 @@ public interface BucketOrBuilder * * 
                                                * Immutable. The project which owns this bucket, in the format of
-   * "projects/{projectIdentifier}".
-   * {projectIdentifier} can be the project ID or project number.
-   * Output values will always be in project number format.
+   * `projects/{projectIdentifier}`.
+   * `{projectIdentifier}` can be the project ID or project number.
+   * Output values are always in the project number format.
    *
                                            * * @@ -135,9 +135,9 @@ public interface BucketOrBuilder * * 
                                                * Immutable. The project which owns this bucket, in the format of
-   * "projects/{projectIdentifier}".
-   * {projectIdentifier} can be the project ID or project number.
-   * Output values will always be in project number format.
+   * `projects/{projectIdentifier}`.
+   * `{projectIdentifier}` can be the project ID or project number.
+   * Output values are always in the project number format.
    *
                                            * * @@ -167,10 +167,8 @@ public interface BucketOrBuilder * 
                                                * Immutable. The location of the bucket. Object data for objects in the
    * bucket resides in physical storage within this region.  Defaults to `US`.
-   * See the
-   * [https://developers.google.com/storage/docs/concepts-techniques#specifyinglocations"][developer's
-   * guide] for the authoritative list. Attempting to update this field after
-   * the bucket is created will result in an error.
+   * Attempting to update this field after the bucket is created results in an
+   * error.
    *
                                            * * string location = 5 [(.google.api.field_behavior) = IMMUTABLE]; @@ -185,10 +183,8 @@ public interface BucketOrBuilder * 
                                                * Immutable. The location of the bucket. Object data for objects in the
    * bucket resides in physical storage within this region.  Defaults to `US`.
-   * See the
-   * [https://developers.google.com/storage/docs/concepts-techniques#specifyinglocations"][developer's
-   * guide] for the authoritative list. Attempting to update this field after
-   * the bucket is created will result in an error.
+   * Attempting to update this field after the bucket is created results in an
+   * error.
    *
                                            * * string location = 5 [(.google.api.field_behavior) = IMMUTABLE]; @@ -232,9 +228,9 @@ public interface BucketOrBuilder * Optional. The bucket's default storage class, used whenever no storageClass * is specified for a newly-created object. This defines how objects in the * bucket are stored and determines the SLA and the cost of storage. - * If this value is not specified when the bucket is created, it will default - * to `STANDARD`. For more information, see - * https://developers.google.com/storage/docs/storage-classes. + * If this value is not specified when the bucket is created, it defaults + * to `STANDARD`. For more information, see [Storage + * classes](https://developers.google.com/storage/docs/storage-classes). * * * string storage_class = 7 [(.google.api.field_behavior) = OPTIONAL]; @@ -250,9 +246,9 @@ public interface BucketOrBuilder * Optional. The bucket's default storage class, used whenever no storageClass * is specified for a newly-created object. This defines how objects in the * bucket are stored and determines the SLA and the cost of storage. - * If this value is not specified when the bucket is created, it will default - * to `STANDARD`. For more information, see - * https://developers.google.com/storage/docs/storage-classes. + * If this value is not specified when the bucket is created, it defaults + * to `STANDARD`. For more information, see [Storage + * classes](https://developers.google.com/storage/docs/storage-classes). * * * string storage_class = 7 [(.google.api.field_behavior) = OPTIONAL]; @@ -266,11 +262,11 @@ public interface BucketOrBuilder * * 
                                                * Optional. The recovery point objective for cross-region replication of the
-   * bucket. Applicable only for dual- and multi-region buckets. "DEFAULT" uses
-   * default replication. "ASYNC_TURBO" enables turbo replication, valid for
+   * bucket. Applicable only for dual- and multi-region buckets. `DEFAULT` uses
+   * default replication. `ASYNC_TURBO` enables turbo replication, valid for
    * dual-region buckets only. If rpo is not specified when the bucket is
-   * created, it defaults to "DEFAULT". For more information, see
-   * https://cloud.google.com/storage/docs/availability-durability#turbo-replication.
+   * created, it defaults to `DEFAULT`. For more information, see [Turbo
+   * replication](https://cloud.google.com/storage/docs/availability-durability#turbo-replication).
    *
                                            * * string rpo = 27 [(.google.api.field_behavior) = OPTIONAL]; @@ -284,11 +280,11 @@ public interface BucketOrBuilder * * 
                                                * Optional. The recovery point objective for cross-region replication of the
-   * bucket. Applicable only for dual- and multi-region buckets. "DEFAULT" uses
-   * default replication. "ASYNC_TURBO" enables turbo replication, valid for
+   * bucket. Applicable only for dual- and multi-region buckets. `DEFAULT` uses
+   * default replication. `ASYNC_TURBO` enables turbo replication, valid for
    * dual-region buckets only. If rpo is not specified when the bucket is
-   * created, it defaults to "DEFAULT". For more information, see
-   * https://cloud.google.com/storage/docs/availability-durability#turbo-replication.
+   * created, it defaults to `DEFAULT`. For more information, see [Turbo
+   * replication](https://cloud.google.com/storage/docs/availability-durability#turbo-replication).
    *
                                            * * string rpo = 27 [(.google.api.field_behavior) = OPTIONAL]; @@ -302,7 +298,7 @@ public interface BucketOrBuilder * * 
                                                * Optional. Access controls on the bucket.
-   * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+   * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
    * requests to set, read, or modify acl is an error.
    *
                                            * @@ -317,7 +313,7 @@ public interface BucketOrBuilder * * 
                                                * Optional. Access controls on the bucket.
-   * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+   * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
    * requests to set, read, or modify acl is an error.
    *
                                            * @@ -332,7 +328,7 @@ public interface BucketOrBuilder * * 
                                                * Optional. Access controls on the bucket.
-   * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+   * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
    * requests to set, read, or modify acl is an error.
    *
                                            * @@ -347,7 +343,7 @@ public interface BucketOrBuilder * * 
                                                * Optional. Access controls on the bucket.
-   * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+   * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
    * requests to set, read, or modify acl is an error.
    *
                                            * @@ -363,7 +359,7 @@ public interface BucketOrBuilder * * 
                                                * Optional. Access controls on the bucket.
-   * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+   * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
    * requests to set, read, or modify acl is an error.
    *
                                            * @@ -378,7 +374,7 @@ public interface BucketOrBuilder * * 
                                                * Optional. Default access controls to apply to new objects when no ACL is
-   * provided. If iam_config.uniform_bucket_level_access is enabled on this
+   * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
    * bucket, requests to set, read, or modify acl is an error.
    *
                                            * @@ -393,7 +389,7 @@ public interface BucketOrBuilder * * 
                                                * Optional. Default access controls to apply to new objects when no ACL is
-   * provided. If iam_config.uniform_bucket_level_access is enabled on this
+   * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
    * bucket, requests to set, read, or modify acl is an error.
    *
                                            * @@ -408,7 +404,7 @@ public interface BucketOrBuilder * * 
                                                * Optional. Default access controls to apply to new objects when no ACL is
-   * provided. If iam_config.uniform_bucket_level_access is enabled on this
+   * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
    * bucket, requests to set, read, or modify acl is an error.
    *
                                            * @@ -423,7 +419,7 @@ public interface BucketOrBuilder * * 
                                                * Optional. Default access controls to apply to new objects when no ACL is
-   * provided. If iam_config.uniform_bucket_level_access is enabled on this
+   * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
    * bucket, requests to set, read, or modify acl is an error.
    *
                                            * @@ -439,7 +435,7 @@ public interface BucketOrBuilder * * 
                                                * Optional. Default access controls to apply to new objects when no ACL is
-   * provided. If iam_config.uniform_bucket_level_access is enabled on this
+   * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
    * bucket, requests to set, read, or modify acl is an error.
    *
                                            * @@ -453,9 +449,9 @@ public interface BucketOrBuilder * * * 
                                            -   * Optional. The bucket's lifecycle config. See
-   * [https://developers.google.com/storage/docs/lifecycle]Lifecycle Management]
-   * for more information.
+   * Optional. The bucket's lifecycle configuration. See [Lifecycle
+   * Management](https://developers.google.com/storage/docs/lifecycle) for more
+   * information.
    *
                                            * * @@ -470,9 +466,9 @@ public interface BucketOrBuilder * * * 
                                            -   * Optional. The bucket's lifecycle config. See
-   * [https://developers.google.com/storage/docs/lifecycle]Lifecycle Management]
-   * for more information.
+   * Optional. The bucket's lifecycle configuration. See [Lifecycle
+   * Management](https://developers.google.com/storage/docs/lifecycle) for more
+   * information.
    *
                                            * * @@ -487,9 +483,9 @@ public interface BucketOrBuilder * * * 
                                            -   * Optional. The bucket's lifecycle config. See
-   * [https://developers.google.com/storage/docs/lifecycle]Lifecycle Management]
-   * for more information.
+   * Optional. The bucket's lifecycle configuration. See [Lifecycle
+   * Management](https://developers.google.com/storage/docs/lifecycle) for more
+   * information.
    *
                                            * * @@ -542,8 +538,8 @@ public interface BucketOrBuilder * * * 
                                            -   * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
-   * Sharing] (CORS) config.
+   * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+   * configuration.
    *
                                            * * @@ -556,8 +552,8 @@ public interface BucketOrBuilder * * * 
                                            -   * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
-   * Sharing] (CORS) config.
+   * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+   * configuration.
    *
                                            * * @@ -570,8 +566,8 @@ public interface BucketOrBuilder * * * 
                                            -   * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
-   * Sharing] (CORS) config.
+   * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+   * configuration.
    *
                                            * * @@ -584,8 +580,8 @@ public interface BucketOrBuilder * * * 
                                            -   * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
-   * Sharing] (CORS) config.
+   * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+   * configuration.
    *
                                            * * @@ -598,8 +594,8 @@ public interface BucketOrBuilder * * * 
                                            -   * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
-   * Sharing] (CORS) config.
+   * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+   * configuration.
    *
                                            * * @@ -655,11 +651,11 @@ public interface BucketOrBuilder * Optional. The default value for event-based hold on newly created objects * in this bucket. Event-based hold is a way to retain objects indefinitely * until an event occurs, signified by the hold's release. After being - * released, such objects will be subject to bucket-level retention (if any). - * One sample use case of this flag is for banks to hold loan documents for at + * released, such objects are subject to bucket-level retention (if any). One + * sample use case of this flag is for banks to hold loan documents for at * least 3 years after loan is paid in full. Here, bucket-level retention is 3 * years and the event is loan being paid in full. In this example, these - * objects will be held intact for any number of years until the event has + * objects are held intact for any number of years until the event has * occurred (event-based hold on the object is released) and then 3 more years * after that. That means retention duration of the objects begins from the * moment event-based hold transitioned from true to false. Objects under @@ -741,9 +737,9 @@ java.lang.String getLabelsOrDefault( * * 
                                                * Optional. The bucket's website config, controlling how the service behaves
-   * when accessing bucket contents as a web site. See the
-   * [https://cloud.google.com/storage/docs/static-website][Static Website
-   * Examples] for more information.
+   * when accessing bucket contents as a web site. See the [Static website
+   * examples](https://cloud.google.com/storage/docs/static-website) for more
+   * information.
    *
                                            * * .google.storage.v2.Bucket.Website website = 16 [(.google.api.field_behavior) = OPTIONAL]; @@ -758,9 +754,9 @@ java.lang.String getLabelsOrDefault( * * 
                                                * Optional. The bucket's website config, controlling how the service behaves
-   * when accessing bucket contents as a web site. See the
-   * [https://cloud.google.com/storage/docs/static-website][Static Website
-   * Examples] for more information.
+   * when accessing bucket contents as a web site. See the [Static website
+   * examples](https://cloud.google.com/storage/docs/static-website) for more
+   * information.
    *
                                            * * .google.storage.v2.Bucket.Website website = 16 [(.google.api.field_behavior) = OPTIONAL]; @@ -775,9 +771,9 @@ java.lang.String getLabelsOrDefault( * * 
                                                * Optional. The bucket's website config, controlling how the service behaves
-   * when accessing bucket contents as a web site. See the
-   * [https://cloud.google.com/storage/docs/static-website][Static Website
-   * Examples] for more information.
+   * when accessing bucket contents as a web site. See the [Static website
+   * examples](https://cloud.google.com/storage/docs/static-website) for more
+   * information.
    *
                                            * * .google.storage.v2.Bucket.Website website = 16 [(.google.api.field_behavior) = OPTIONAL]; @@ -789,7 +785,7 @@ java.lang.String getLabelsOrDefault( * * * 
                                            -   * Optional. The bucket's versioning config.
+   * Optional. The bucket's versioning configuration.
    *
                                            * * @@ -804,7 +800,7 @@ java.lang.String getLabelsOrDefault( * * * 
                                            -   * Optional. The bucket's versioning config.
+   * Optional. The bucket's versioning configuration.
    *
                                            * * @@ -819,7 +815,7 @@ java.lang.String getLabelsOrDefault( * * * 
                                            -   * Optional. The bucket's versioning config.
+   * Optional. The bucket's versioning configuration.
    *
                                            * * @@ -958,7 +954,7 @@ java.lang.String getLabelsOrDefault( * * * 
                                            -   * Optional. The bucket's billing config.
+   * Optional. The bucket's billing configuration.
    *
                                            * * .google.storage.v2.Bucket.Billing billing = 21 [(.google.api.field_behavior) = OPTIONAL]; @@ -972,7 +968,7 @@ java.lang.String getLabelsOrDefault( * * * 
                                            -   * Optional. The bucket's billing config.
+   * Optional. The bucket's billing configuration.
    *
                                            * * .google.storage.v2.Bucket.Billing billing = 21 [(.google.api.field_behavior) = OPTIONAL]; @@ -986,7 +982,7 @@ java.lang.String getLabelsOrDefault( * * * 
                                            -   * Optional. The bucket's billing config.
+   * Optional. The bucket's billing configuration.
    *
                                            * * .google.storage.v2.Bucket.Billing billing = 21 [(.google.api.field_behavior) = OPTIONAL]; @@ -1001,12 +997,12 @@ java.lang.String getLabelsOrDefault( * Optional. The bucket's retention policy. The retention policy enforces a * minimum retention time for all objects contained in the bucket, based on * their creation time. Any attempt to overwrite or delete objects younger - * than the retention period will result in a PERMISSION_DENIED error. An + * than the retention period results in a `PERMISSION_DENIED` error. An * unlocked retention policy can be modified or removed from the bucket via a * storage.buckets.update operation. A locked retention policy cannot be * removed or shortened in duration for the lifetime of the bucket. - * Attempting to remove or decrease period of a locked retention policy will - * result in a PERMISSION_DENIED error. + * Attempting to remove or decrease period of a locked retention policy + * results in a `PERMISSION_DENIED` error. * * * @@ -1024,12 +1020,12 @@ java.lang.String getLabelsOrDefault( * Optional. The bucket's retention policy. The retention policy enforces a * minimum retention time for all objects contained in the bucket, based on * their creation time. Any attempt to overwrite or delete objects younger - * than the retention period will result in a PERMISSION_DENIED error. An + * than the retention period results in a `PERMISSION_DENIED` error. An * unlocked retention policy can be modified or removed from the bucket via a * storage.buckets.update operation. A locked retention policy cannot be * removed or shortened in duration for the lifetime of the bucket. - * Attempting to remove or decrease period of a locked retention policy will - * result in a PERMISSION_DENIED error. + * Attempting to remove or decrease period of a locked retention policy + * results in a `PERMISSION_DENIED` error. * * * @@ -1047,12 +1043,12 @@ java.lang.String getLabelsOrDefault( * Optional. The bucket's retention policy. The retention policy enforces a * minimum retention time for all objects contained in the bucket, based on * their creation time. Any attempt to overwrite or delete objects younger - * than the retention period will result in a PERMISSION_DENIED error. An + * than the retention period results in a `PERMISSION_DENIED` error. An * unlocked retention policy can be modified or removed from the bucket via a * storage.buckets.update operation. A locked retention policy cannot be * removed or shortened in duration for the lifetime of the bucket. - * Attempting to remove or decrease period of a locked retention policy will - * result in a PERMISSION_DENIED error. + * Attempting to remove or decrease period of a locked retention policy + * results in a `PERMISSION_DENIED` error. * * * @@ -1065,7 +1061,7 @@ java.lang.String getLabelsOrDefault( * * * 
                                            -   * Optional. The bucket's IAM config.
+   * Optional. The bucket's IAM configuration.
    *
                                            * * @@ -1080,7 +1076,7 @@ java.lang.String getLabelsOrDefault( * * * 
                                            -   * Optional. The bucket's IAM config.
+   * Optional. The bucket's IAM configuration.
    *
                                            * * @@ -1095,7 +1091,7 @@ java.lang.String getLabelsOrDefault( * * * 
                                            -   * Optional. The bucket's IAM config.
+   * Optional. The bucket's IAM configuration.
    *
                                            * * @@ -1122,9 +1118,8 @@ java.lang.String getLabelsOrDefault( * * 
                                                * Optional. Configuration that, if present, specifies the data placement for
-   * a
-   * [https://cloud.google.com/storage/docs/locations#location-dr][configurable
-   * dual-region].
+   * a [configurable
+   * dual-region](https://cloud.google.com/storage/docs/locations#location-dr).
    *
                                            * * @@ -1140,9 +1135,8 @@ java.lang.String getLabelsOrDefault( * * 
                                                * Optional. Configuration that, if present, specifies the data placement for
-   * a
-   * [https://cloud.google.com/storage/docs/locations#location-dr][configurable
-   * dual-region].
+   * a [configurable
+   * dual-region](https://cloud.google.com/storage/docs/locations#location-dr).
    *
                                            * * @@ -1158,9 +1152,8 @@ java.lang.String getLabelsOrDefault( * * 
                                                * Optional. Configuration that, if present, specifies the data placement for
-   * a
-   * [https://cloud.google.com/storage/docs/locations#location-dr][configurable
-   * dual-region].
+   * a [configurable
+   * dual-region](https://cloud.google.com/storage/docs/locations#location-dr).
    *
                                            * * @@ -1174,8 +1167,8 @@ java.lang.String getLabelsOrDefault( * * 
                                                * Optional. The bucket's Autoclass configuration. If there is no
-   * configuration, the Autoclass feature will be disabled and have no effect on
-   * the bucket.
+   * configuration, the Autoclass feature is disabled and has no effect on the
+   * bucket.
    *
                                            * * @@ -1191,8 +1184,8 @@ java.lang.String getLabelsOrDefault( * * 
                                                * Optional. The bucket's Autoclass configuration. If there is no
-   * configuration, the Autoclass feature will be disabled and have no effect on
-   * the bucket.
+   * configuration, the Autoclass feature is disabled and has no effect on the
+   * bucket.
    *
                                            * * @@ -1208,8 +1201,8 @@ java.lang.String getLabelsOrDefault( * * 
                                                * Optional. The bucket's Autoclass configuration. If there is no
-   * configuration, the Autoclass feature will be disabled and have no effect on
-   * the bucket.
+   * configuration, the Autoclass feature is disabled and has no effect on the
+   * bucket.
    *
                                            * * @@ -1223,7 +1216,7 @@ java.lang.String getLabelsOrDefault( * * 
                                                * Optional. The bucket's hierarchical namespace configuration. If there is no
-   * configuration, the hierarchical namespace feature will be disabled and have
+   * configuration, the hierarchical namespace feature is disabled and has
    * no effect on the bucket.
    *
                                            * @@ -1240,7 +1233,7 @@ java.lang.String getLabelsOrDefault( * * 
                                                * Optional. The bucket's hierarchical namespace configuration. If there is no
-   * configuration, the hierarchical namespace feature will be disabled and have
+   * configuration, the hierarchical namespace feature is disabled and has
    * no effect on the bucket.
    *
                                            * @@ -1257,7 +1250,7 @@ java.lang.String getLabelsOrDefault( * * 
                                                * Optional. The bucket's hierarchical namespace configuration. If there is no
-   * configuration, the hierarchical namespace feature will be disabled and have
+   * configuration, the hierarchical namespace feature is disabled and has
    * no effect on the bucket.
    *
                                            * @@ -1318,7 +1311,7 @@ java.lang.String getLabelsOrDefault( * * 
                                                * Optional. The bucket's object retention configuration. Must be enabled
-   * before objects in the bucket may have retention configured.
+   * before objects in the bucket might have retention configured.
    *
                                            * * @@ -1334,7 +1327,7 @@ java.lang.String getLabelsOrDefault( * * 
                                                * Optional. The bucket's object retention configuration. Must be enabled
-   * before objects in the bucket may have retention configured.
+   * before objects in the bucket might have retention configured.
    *
                                            * * @@ -1350,7 +1343,7 @@ java.lang.String getLabelsOrDefault( * * 
                                                * Optional. The bucket's object retention configuration. Must be enabled
-   * before objects in the bucket may have retention configured.
+   * before objects in the bucket might have retention configured.
    *
                                            * * diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CancelResumableWriteRequest.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CancelResumableWriteRequest.java index f04c659c3d..87068a617c 100644 --- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CancelResumableWriteRequest.java +++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CancelResumableWriteRequest.java @@ -23,8 +23,8 @@ * * * 
                                            - * Message for canceling an in-progress resumable upload.
- * `upload_id` **must** be set.
+ * Request message for
+ * [CancelResumableWrite][google.storage.v2.Storage.CancelResumableWrite].
  *
                                            * * Protobuf type {@code google.storage.v2.CancelResumableWriteRequest} @@ -284,8 +284,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build * * * 
                                            -   * Message for canceling an in-progress resumable upload.
-   * `upload_id` **must** be set.
+   * Request message for
+   * [CancelResumableWrite][google.storage.v2.Storage.CancelResumableWrite].
    *
                                            * * Protobuf type {@code google.storage.v2.CancelResumableWriteRequest} diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CancelResumableWriteResponse.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CancelResumableWriteResponse.java index 152703df5f..46fcde480b 100644 --- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CancelResumableWriteResponse.java +++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CancelResumableWriteResponse.java @@ -23,7 +23,7 @@ * * * 
                                            - * Empty response message for canceling an in-progress resumable upload, will be
+ * Empty response message for canceling an in-progress resumable upload, is
  * extended as needed.
  *
                                            * @@ -218,7 +218,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build * * * 
                                            -   * Empty response message for canceling an in-progress resumable upload, will be
+   * Empty response message for canceling an in-progress resumable upload, is
    * extended as needed.
    *
                                            * diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CommonObjectRequestParams.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CommonObjectRequestParams.java index 80c644af5b..b48bb51c98 100644 --- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CommonObjectRequestParams.java +++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CommonObjectRequestParams.java @@ -149,8 +149,8 @@ public com.google.protobuf.ByteString getEncryptionKeyBytes() { * * * 
                                            -   * Optional. SHA256 hash of encryption key used with the Customer-Supplied
-   * Encryption Keys feature.
+   * Optional. SHA256 hash of encryption key used with the Customer-supplied
+   * encryption keys feature.
    *
                                            * * bytes encryption_key_sha256_bytes = 5 [(.google.api.field_behavior) = OPTIONAL]; @@ -734,8 +734,8 @@ public Builder clearEncryptionKeyBytes() { * * * 
                                            -     * Optional. SHA256 hash of encryption key used with the Customer-Supplied
-     * Encryption Keys feature.
+     * Optional. SHA256 hash of encryption key used with the Customer-supplied
+     * encryption keys feature.
      *
                                            * * bytes encryption_key_sha256_bytes = 5 [(.google.api.field_behavior) = OPTIONAL]; @@ -751,8 +751,8 @@ public com.google.protobuf.ByteString getEncryptionKeySha256Bytes() { * * * 
                                            -     * Optional. SHA256 hash of encryption key used with the Customer-Supplied
-     * Encryption Keys feature.
+     * Optional. SHA256 hash of encryption key used with the Customer-supplied
+     * encryption keys feature.
      *
                                            * * bytes encryption_key_sha256_bytes = 5 [(.google.api.field_behavior) = OPTIONAL]; @@ -774,8 +774,8 @@ public Builder setEncryptionKeySha256Bytes(com.google.protobuf.ByteString value) * * * 
                                            -     * Optional. SHA256 hash of encryption key used with the Customer-Supplied
-     * Encryption Keys feature.
+     * Optional. SHA256 hash of encryption key used with the Customer-supplied
+     * encryption keys feature.
      *
                                            * * bytes encryption_key_sha256_bytes = 5 [(.google.api.field_behavior) = OPTIONAL]; diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CommonObjectRequestParamsOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CommonObjectRequestParamsOrBuilder.java index f329aea4fc..4119c7784e 100644 --- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CommonObjectRequestParamsOrBuilder.java +++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CommonObjectRequestParamsOrBuilder.java @@ -70,8 +70,8 @@ public interface CommonObjectRequestParamsOrBuilder * * * 
                                            -   * Optional. SHA256 hash of encryption key used with the Customer-Supplied
-   * Encryption Keys feature.
+   * Optional. SHA256 hash of encryption key used with the Customer-supplied
+   * encryption keys feature.
    *
                                            * * bytes encryption_key_sha256_bytes = 5 [(.google.api.field_behavior) = OPTIONAL]; diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ComposeObjectRequest.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ComposeObjectRequest.java index f242141cdc..0994d8309c 100644 --- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ComposeObjectRequest.java +++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ComposeObjectRequest.java @@ -23,7 +23,7 @@ * * * 
                                            - * Request message for ComposeObject.
+ * Request message for [ComposeObject][google.storage.v2.Storage.ComposeObject].
  *
                                            * * Protobuf type {@code google.storage.v2.ComposeObjectRequest} @@ -214,7 +214,7 @@ public interface ObjectPreconditionsOrBuilder * 
                                                    * Only perform the composition if the generation of the source object
        * that would be used matches this value.  If this value and a generation
-       * are both specified, they must be the same value or the call will fail.
+       * are both specified, they must be the same value or the call fails.
        *
                                            * * optional int64 if_generation_match = 1; @@ -229,7 +229,7 @@ public interface ObjectPreconditionsOrBuilder * 
                                                    * Only perform the composition if the generation of the source object
        * that would be used matches this value.  If this value and a generation
-       * are both specified, they must be the same value or the call will fail.
+       * are both specified, they must be the same value or the call fails.
        *
                                            * * optional int64 if_generation_match = 1; @@ -293,7 +293,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() { * 
                                                    * Only perform the composition if the generation of the source object
        * that would be used matches this value.  If this value and a generation
-       * are both specified, they must be the same value or the call will fail.
+       * are both specified, they must be the same value or the call fails.
        *
                                            * * optional int64 if_generation_match = 1; @@ -311,7 +311,7 @@ public boolean hasIfGenerationMatch() { * 
                                                    * Only perform the composition if the generation of the source object
        * that would be used matches this value.  If this value and a generation
-       * are both specified, they must be the same value or the call will fail.
+       * are both specified, they must be the same value or the call fails.
        *
                                            * * optional int64 if_generation_match = 1; @@ -709,7 +709,7 @@ public Builder mergeFrom( * 
                                                      * Only perform the composition if the generation of the source object
          * that would be used matches this value.  If this value and a generation
-         * are both specified, they must be the same value or the call will fail.
+         * are both specified, they must be the same value or the call fails.
          *
                                            * * optional int64 if_generation_match = 1; @@ -727,7 +727,7 @@ public boolean hasIfGenerationMatch() { * 
                                                      * Only perform the composition if the generation of the source object
          * that would be used matches this value.  If this value and a generation
-         * are both specified, they must be the same value or the call will fail.
+         * are both specified, they must be the same value or the call fails.
          *
                                            * * optional int64 if_generation_match = 1; @@ -745,7 +745,7 @@ public long getIfGenerationMatch() { * 
                                                      * Only perform the composition if the generation of the source object
          * that would be used matches this value.  If this value and a generation
-         * are both specified, they must be the same value or the call will fail.
+         * are both specified, they must be the same value or the call fails.
          *
                                            * * optional int64 if_generation_match = 1; @@ -767,7 +767,7 @@ public Builder setIfGenerationMatch(long value) { * 
                                                      * Only perform the composition if the generation of the source object
          * that would be used matches this value.  If this value and a generation
-         * are both specified, they must be the same value or the call will fail.
+         * are both specified, they must be the same value or the call fails.
          *
                                            * * optional int64 if_generation_match = 1; @@ -1931,8 +1931,8 @@ public com.google.storage.v2.ObjectOrBuilder getDestinationOrBuilder() { * * * 
                                            -   * Optional. The list of source objects that will be concatenated into a
-   * single object.
+   * Optional. The list of source objects that is concatenated into a single
+   * object.
    *
                                            * * @@ -1949,8 +1949,8 @@ public com.google.storage.v2.ObjectOrBuilder getDestinationOrBuilder() { * * * 
                                            -   * Optional. The list of source objects that will be concatenated into a
-   * single object.
+   * Optional. The list of source objects that is concatenated into a single
+   * object.
    *
                                            * * @@ -1967,8 +1967,8 @@ public com.google.storage.v2.ObjectOrBuilder getDestinationOrBuilder() { * * * 
                                            -   * Optional. The list of source objects that will be concatenated into a
-   * single object.
+   * Optional. The list of source objects that is concatenated into a single
+   * object.
    *
                                            * * @@ -1984,8 +1984,8 @@ public int getSourceObjectsCount() { * * * 
                                            -   * Optional. The list of source objects that will be concatenated into a
-   * single object.
+   * Optional. The list of source objects that is concatenated into a single
+   * object.
    *
                                            * * @@ -2001,8 +2001,8 @@ public com.google.storage.v2.ComposeObjectRequest.SourceObject getSourceObjects( * * * 
                                            -   * Optional. The list of source objects that will be concatenated into a
-   * single object.
+   * Optional. The list of source objects that is concatenated into a single
+   * object.
    *
                                            * * @@ -2025,8 +2025,8 @@ public com.google.storage.v2.ComposeObjectRequest.SourceObjectOrBuilder getSourc * * 
                                                * Optional. Apply a predefined set of access controls to the destination
-   * object. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-   * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+   * object. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+   * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
    *
                                            * * string destination_predefined_acl = 9 [(.google.api.field_behavior) = OPTIONAL]; @@ -2051,8 +2051,8 @@ public java.lang.String getDestinationPredefinedAcl() { * * 
                                                * Optional. Apply a predefined set of access controls to the destination
-   * object. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-   * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+   * object. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+   * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
    *
                                            * * string destination_predefined_acl = 9 [(.google.api.field_behavior) = OPTIONAL]; @@ -2159,7 +2159,7 @@ public long getIfMetagenerationMatch() { * 
                                                * Optional. Resource name of the Cloud KMS key, of the form
    * `projects/my-project/locations/my-location/keyRings/my-kr/cryptoKeys/my-key`,
-   * that will be used to encrypt the object. Overrides the object
+   * that is used to encrypt the object. Overrides the object
    * metadata's `kms_key_name` value, if any.
    *
                                            * @@ -2188,7 +2188,7 @@ public java.lang.String getKmsKey() { * 
                                                * Optional. Resource name of the Cloud KMS key, of the form
    * `projects/my-project/locations/my-location/keyRings/my-kr/cryptoKeys/my-key`,
-   * that will be used to encrypt the object. Overrides the object
+   * that is used to encrypt the object. Overrides the object
    * metadata's `kms_key_name` value, if any.
    *
                                            * @@ -2281,8 +2281,8 @@ public com.google.storage.v2.CommonObjectRequestParams getCommonObjectRequestPar * * * 
                                            -   * Optional. The checksums of the complete object. This will be validated
-   * against the combined checksums of the component objects.
+   * Optional. The checksums of the complete object. This is validated against
+   * the combined checksums of the component objects.
    *
                                            * * @@ -2300,8 +2300,8 @@ public boolean hasObjectChecksums() { * * * 
                                            -   * Optional. The checksums of the complete object. This will be validated
-   * against the combined checksums of the component objects.
+   * Optional. The checksums of the complete object. This is validated against
+   * the combined checksums of the component objects.
    *
                                            * * @@ -2321,8 +2321,8 @@ public com.google.storage.v2.ObjectChecksums getObjectChecksums() { * * * 
                                            -   * Optional. The checksums of the complete object. This will be validated
-   * against the combined checksums of the component objects.
+   * Optional. The checksums of the complete object. This is validated against
+   * the combined checksums of the component objects.
    *
                                            * * @@ -2594,7 +2594,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build * * * 
                                            -   * Request message for ComposeObject.
+   * Request message for [ComposeObject][google.storage.v2.Storage.ComposeObject].
    *
                                            * * Protobuf type {@code google.storage.v2.ComposeObjectRequest} @@ -3175,8 +3175,8 @@ private void ensureSourceObjectsIsMutable() { * * * 
                                            -     * Optional. The list of source objects that will be concatenated into a
-     * single object.
+     * Optional. The list of source objects that is concatenated into a single
+     * object.
      *
                                            * * @@ -3196,8 +3196,8 @@ private void ensureSourceObjectsIsMutable() { * * * 
                                            -     * Optional. The list of source objects that will be concatenated into a
-     * single object.
+     * Optional. The list of source objects that is concatenated into a single
+     * object.
      *
                                            * * @@ -3216,8 +3216,8 @@ public int getSourceObjectsCount() { * * * 
                                            -     * Optional. The list of source objects that will be concatenated into a
-     * single object.
+     * Optional. The list of source objects that is concatenated into a single
+     * object.
      *
                                            * * @@ -3236,8 +3236,8 @@ public com.google.storage.v2.ComposeObjectRequest.SourceObject getSourceObjects( * * * 
                                            -     * Optional. The list of source objects that will be concatenated into a
-     * single object.
+     * Optional. The list of source objects that is concatenated into a single
+     * object.
      *
                                            * * @@ -3263,8 +3263,8 @@ public Builder setSourceObjects( * * * 
                                            -     * Optional. The list of source objects that will be concatenated into a
-     * single object.
+     * Optional. The list of source objects that is concatenated into a single
+     * object.
      *
                                            * * @@ -3288,8 +3288,8 @@ public Builder setSourceObjects( * * * 
                                            -     * Optional. The list of source objects that will be concatenated into a
-     * single object.
+     * Optional. The list of source objects that is concatenated into a single
+     * object.
      *
                                            * * @@ -3314,8 +3314,8 @@ public Builder addSourceObjects(com.google.storage.v2.ComposeObjectRequest.Sourc * * * 
                                            -     * Optional. The list of source objects that will be concatenated into a
-     * single object.
+     * Optional. The list of source objects that is concatenated into a single
+     * object.
      *
                                            * * @@ -3341,8 +3341,8 @@ public Builder addSourceObjects( * * * 
                                            -     * Optional. The list of source objects that will be concatenated into a
-     * single object.
+     * Optional. The list of source objects that is concatenated into a single
+     * object.
      *
                                            * * @@ -3365,8 +3365,8 @@ public Builder addSourceObjects( * * * 
                                            -     * Optional. The list of source objects that will be concatenated into a
-     * single object.
+     * Optional. The list of source objects that is concatenated into a single
+     * object.
      *
                                            * * @@ -3390,8 +3390,8 @@ public Builder addSourceObjects( * * * 
                                            -     * Optional. The list of source objects that will be concatenated into a
-     * single object.
+     * Optional. The list of source objects that is concatenated into a single
+     * object.
      *
                                            * * @@ -3415,8 +3415,8 @@ public Builder addAllSourceObjects( * * * 
                                            -     * Optional. The list of source objects that will be concatenated into a
-     * single object.
+     * Optional. The list of source objects that is concatenated into a single
+     * object.
      *
                                            * * @@ -3438,8 +3438,8 @@ public Builder clearSourceObjects() { * * * 
                                            -     * Optional. The list of source objects that will be concatenated into a
-     * single object.
+     * Optional. The list of source objects that is concatenated into a single
+     * object.
      *
                                            * * @@ -3461,8 +3461,8 @@ public Builder removeSourceObjects(int index) { * * * 
                                            -     * Optional. The list of source objects that will be concatenated into a
-     * single object.
+     * Optional. The list of source objects that is concatenated into a single
+     * object.
      *
                                            * * @@ -3478,8 +3478,8 @@ public com.google.storage.v2.ComposeObjectRequest.SourceObject.Builder getSource * * * 
                                            -     * Optional. The list of source objects that will be concatenated into a
-     * single object.
+     * Optional. The list of source objects that is concatenated into a single
+     * object.
      *
                                            * * @@ -3499,8 +3499,8 @@ public com.google.storage.v2.ComposeObjectRequest.SourceObject.Builder getSource * * * 
                                            -     * Optional. The list of source objects that will be concatenated into a
-     * single object.
+     * Optional. The list of source objects that is concatenated into a single
+     * object.
      *
                                            * * @@ -3521,8 +3521,8 @@ public com.google.storage.v2.ComposeObjectRequest.SourceObject.Builder getSource * * * 
                                            -     * Optional. The list of source objects that will be concatenated into a
-     * single object.
+     * Optional. The list of source objects that is concatenated into a single
+     * object.
      *
                                            * * @@ -3539,8 +3539,8 @@ public com.google.storage.v2.ComposeObjectRequest.SourceObject.Builder getSource * * * 
                                            -     * Optional. The list of source objects that will be concatenated into a
-     * single object.
+     * Optional. The list of source objects that is concatenated into a single
+     * object.
      *
                                            * * @@ -3558,8 +3558,8 @@ public com.google.storage.v2.ComposeObjectRequest.SourceObject.Builder addSource * * * 
                                            -     * Optional. The list of source objects that will be concatenated into a
-     * single object.
+     * Optional. The list of source objects that is concatenated into a single
+     * object.
      *
                                            * * @@ -3598,8 +3598,8 @@ public com.google.storage.v2.ComposeObjectRequest.SourceObject.Builder addSource * * 
                                                  * Optional. Apply a predefined set of access controls to the destination
-     * object. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-     * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+     * object. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+     * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
      *
                                            * * string destination_predefined_acl = 9 [(.google.api.field_behavior) = OPTIONAL]; @@ -3623,8 +3623,8 @@ public java.lang.String getDestinationPredefinedAcl() { * * 
                                                  * Optional. Apply a predefined set of access controls to the destination
-     * object. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-     * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+     * object. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+     * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
      *
                                            * * string destination_predefined_acl = 9 [(.google.api.field_behavior) = OPTIONAL]; @@ -3648,8 +3648,8 @@ public com.google.protobuf.ByteString getDestinationPredefinedAclBytes() { * * 
                                                  * Optional. Apply a predefined set of access controls to the destination
-     * object. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-     * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+     * object. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+     * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
      *
                                            * * string destination_predefined_acl = 9 [(.google.api.field_behavior) = OPTIONAL]; @@ -3672,8 +3672,8 @@ public Builder setDestinationPredefinedAcl(java.lang.String value) { * * 
                                                  * Optional. Apply a predefined set of access controls to the destination
-     * object. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-     * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+     * object. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+     * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
      *
                                            * * string destination_predefined_acl = 9 [(.google.api.field_behavior) = OPTIONAL]; @@ -3692,8 +3692,8 @@ public Builder clearDestinationPredefinedAcl() { * * 
                                                  * Optional. Apply a predefined set of access controls to the destination
-     * object. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-     * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+     * object. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+     * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
      *
                                            * * string destination_predefined_acl = 9 [(.google.api.field_behavior) = OPTIONAL]; @@ -3876,7 +3876,7 @@ public Builder clearIfMetagenerationMatch() { * 
                                                  * Optional. Resource name of the Cloud KMS key, of the form
      * `projects/my-project/locations/my-location/keyRings/my-kr/cryptoKeys/my-key`,
-     * that will be used to encrypt the object. Overrides the object
+     * that is used to encrypt the object. Overrides the object
      * metadata's `kms_key_name` value, if any.
      *
                                            * @@ -3904,7 +3904,7 @@ public java.lang.String getKmsKey() { * 
                                                  * Optional. Resource name of the Cloud KMS key, of the form
      * `projects/my-project/locations/my-location/keyRings/my-kr/cryptoKeys/my-key`,
-     * that will be used to encrypt the object. Overrides the object
+     * that is used to encrypt the object. Overrides the object
      * metadata's `kms_key_name` value, if any.
      *
                                            * @@ -3932,7 +3932,7 @@ public com.google.protobuf.ByteString getKmsKeyBytes() { * 
                                                  * Optional. Resource name of the Cloud KMS key, of the form
      * `projects/my-project/locations/my-location/keyRings/my-kr/cryptoKeys/my-key`,
-     * that will be used to encrypt the object. Overrides the object
+     * that is used to encrypt the object. Overrides the object
      * metadata's `kms_key_name` value, if any.
      *
                                            * @@ -3959,7 +3959,7 @@ public Builder setKmsKey(java.lang.String value) { * 
                                                  * Optional. Resource name of the Cloud KMS key, of the form
      * `projects/my-project/locations/my-location/keyRings/my-kr/cryptoKeys/my-key`,
-     * that will be used to encrypt the object. Overrides the object
+     * that is used to encrypt the object. Overrides the object
      * metadata's `kms_key_name` value, if any.
      *
                                            * @@ -3982,7 +3982,7 @@ public Builder clearKmsKey() { * 
                                                  * Optional. Resource name of the Cloud KMS key, of the form
      * `projects/my-project/locations/my-location/keyRings/my-kr/cryptoKeys/my-key`,
-     * that will be used to encrypt the object. Overrides the object
+     * that is used to encrypt the object. Overrides the object
      * metadata's `kms_key_name` value, if any.
      *
                                            * @@ -4242,8 +4242,8 @@ public Builder clearCommonObjectRequestParams() { * * * 
                                            -     * Optional. The checksums of the complete object. This will be validated
-     * against the combined checksums of the component objects.
+     * Optional. The checksums of the complete object. This is validated against
+     * the combined checksums of the component objects.
      *
                                            * * @@ -4260,8 +4260,8 @@ public boolean hasObjectChecksums() { * * * 
                                            -     * Optional. The checksums of the complete object. This will be validated
-     * against the combined checksums of the component objects.
+     * Optional. The checksums of the complete object. This is validated against
+     * the combined checksums of the component objects.
      *
                                            * * @@ -4284,8 +4284,8 @@ public com.google.storage.v2.ObjectChecksums getObjectChecksums() { * * * 
                                            -     * Optional. The checksums of the complete object. This will be validated
-     * against the combined checksums of the component objects.
+     * Optional. The checksums of the complete object. This is validated against
+     * the combined checksums of the component objects.
      *
                                            * * @@ -4310,8 +4310,8 @@ public Builder setObjectChecksums(com.google.storage.v2.ObjectChecksums value) { * * * 
                                            -     * Optional. The checksums of the complete object. This will be validated
-     * against the combined checksums of the component objects.
+     * Optional. The checksums of the complete object. This is validated against
+     * the combined checksums of the component objects.
      *
                                            * * @@ -4334,8 +4334,8 @@ public Builder setObjectChecksums( * * * 
                                            -     * Optional. The checksums of the complete object. This will be validated
-     * against the combined checksums of the component objects.
+     * Optional. The checksums of the complete object. This is validated against
+     * the combined checksums of the component objects.
      *
                                            * * @@ -4365,8 +4365,8 @@ public Builder mergeObjectChecksums(com.google.storage.v2.ObjectChecksums value) * * * 
                                            -     * Optional. The checksums of the complete object. This will be validated
-     * against the combined checksums of the component objects.
+     * Optional. The checksums of the complete object. This is validated against
+     * the combined checksums of the component objects.
      *
                                            * * @@ -4388,8 +4388,8 @@ public Builder clearObjectChecksums() { * * * 
                                            -     * Optional. The checksums of the complete object. This will be validated
-     * against the combined checksums of the component objects.
+     * Optional. The checksums of the complete object. This is validated against
+     * the combined checksums of the component objects.
      *
                                            * * @@ -4406,8 +4406,8 @@ public com.google.storage.v2.ObjectChecksums.Builder getObjectChecksumsBuilder() * * * 
                                            -     * Optional. The checksums of the complete object. This will be validated
-     * against the combined checksums of the component objects.
+     * Optional. The checksums of the complete object. This is validated against
+     * the combined checksums of the component objects.
      *
                                            * * @@ -4428,8 +4428,8 @@ public com.google.storage.v2.ObjectChecksumsOrBuilder getObjectChecksumsOrBuilde * * * 
                                            -     * Optional. The checksums of the complete object. This will be validated
-     * against the combined checksums of the component objects.
+     * Optional. The checksums of the complete object. This is validated against
+     * the combined checksums of the component objects.
      *
                                            * * diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ComposeObjectRequestOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ComposeObjectRequestOrBuilder.java index 4063d0640b..5eabc026c4 100644 --- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ComposeObjectRequestOrBuilder.java +++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ComposeObjectRequestOrBuilder.java @@ -68,8 +68,8 @@ public interface ComposeObjectRequestOrBuilder * * * 
                                            -   * Optional. The list of source objects that will be concatenated into a
-   * single object.
+   * Optional. The list of source objects that is concatenated into a single
+   * object.
    *
                                            * * @@ -82,8 +82,8 @@ public interface ComposeObjectRequestOrBuilder * * * 
                                            -   * Optional. The list of source objects that will be concatenated into a
-   * single object.
+   * Optional. The list of source objects that is concatenated into a single
+   * object.
    *
                                            * * @@ -96,8 +96,8 @@ public interface ComposeObjectRequestOrBuilder * * * 
                                            -   * Optional. The list of source objects that will be concatenated into a
-   * single object.
+   * Optional. The list of source objects that is concatenated into a single
+   * object.
    *
                                            * * @@ -110,8 +110,8 @@ public interface ComposeObjectRequestOrBuilder * * * 
                                            -   * Optional. The list of source objects that will be concatenated into a
-   * single object.
+   * Optional. The list of source objects that is concatenated into a single
+   * object.
    *
                                            * * @@ -125,8 +125,8 @@ public interface ComposeObjectRequestOrBuilder * * * 
                                            -   * Optional. The list of source objects that will be concatenated into a
-   * single object.
+   * Optional. The list of source objects that is concatenated into a single
+   * object.
    *
                                            * * @@ -141,8 +141,8 @@ com.google.storage.v2.ComposeObjectRequest.SourceObjectOrBuilder getSourceObject * * 
                                                * Optional. Apply a predefined set of access controls to the destination
-   * object. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-   * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+   * object. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+   * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
    *
                                            * * string destination_predefined_acl = 9 [(.google.api.field_behavior) = OPTIONAL]; @@ -156,8 +156,8 @@ com.google.storage.v2.ComposeObjectRequest.SourceObjectOrBuilder getSourceObject * * 
                                                * Optional. Apply a predefined set of access controls to the destination
-   * object. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-   * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+   * object. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+   * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
    *
                                            * * string destination_predefined_acl = 9 [(.google.api.field_behavior) = OPTIONAL]; @@ -230,7 +230,7 @@ com.google.storage.v2.ComposeObjectRequest.SourceObjectOrBuilder getSourceObject * 
                                                * Optional. Resource name of the Cloud KMS key, of the form
    * `projects/my-project/locations/my-location/keyRings/my-kr/cryptoKeys/my-key`,
-   * that will be used to encrypt the object. Overrides the object
+   * that is used to encrypt the object. Overrides the object
    * metadata's `kms_key_name` value, if any.
    *
                                            * @@ -248,7 +248,7 @@ com.google.storage.v2.ComposeObjectRequest.SourceObjectOrBuilder getSourceObject * 
                                                * Optional. Resource name of the Cloud KMS key, of the form
    * `projects/my-project/locations/my-location/keyRings/my-kr/cryptoKeys/my-key`,
-   * that will be used to encrypt the object. Overrides the object
+   * that is used to encrypt the object. Overrides the object
    * metadata's `kms_key_name` value, if any.
    *
                                            * @@ -310,8 +310,8 @@ com.google.storage.v2.ComposeObjectRequest.SourceObjectOrBuilder getSourceObject * * * 
                                            -   * Optional. The checksums of the complete object. This will be validated
-   * against the combined checksums of the component objects.
+   * Optional. The checksums of the complete object. This is validated against
+   * the combined checksums of the component objects.
    *
                                            * * @@ -326,8 +326,8 @@ com.google.storage.v2.ComposeObjectRequest.SourceObjectOrBuilder getSourceObject * * * 
                                            -   * Optional. The checksums of the complete object. This will be validated
-   * against the combined checksums of the component objects.
+   * Optional. The checksums of the complete object. This is validated against
+   * the combined checksums of the component objects.
    *
                                            * * @@ -342,8 +342,8 @@ com.google.storage.v2.ComposeObjectRequest.SourceObjectOrBuilder getSourceObject * * * 
                                            -   * Optional. The checksums of the complete object. This will be validated
-   * against the combined checksums of the component objects.
+   * Optional. The checksums of the complete object. This is validated against
+   * the combined checksums of the component objects.
    *
                                            * * diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CreateBucketRequest.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CreateBucketRequest.java index 68ab235b1b..256de39c83 100644 --- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CreateBucketRequest.java +++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CreateBucketRequest.java @@ -23,7 +23,7 @@ * * * 
                                            - * Request message for CreateBucket.
+ * Request message for [CreateBucket][google.storage.v2.Storage.CreateBucket].
  *
                                            * * Protobuf type {@code google.storage.v2.CreateBucketRequest} @@ -77,9 +77,9 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() { * * * 
                                            -   * Required. The project to which this bucket will belong. This field must
-   * either be empty or `projects/_`. The project ID that owns this bucket
-   * should be specified in the `bucket.project` field.
+   * Required. The project to which this bucket belongs. This field must either
+   * be empty or `projects/_`. The project ID that owns this bucket should be
+   * specified in the `bucket.project` field.
    *
                                            * * @@ -105,9 +105,9 @@ public java.lang.String getParent() { * * * 
                                            -   * Required. The project to which this bucket will belong. This field must
-   * either be empty or `projects/_`. The project ID that owns this bucket
-   * should be specified in the `bucket.project` field.
+   * Required. The project to which this bucket belongs. This field must either
+   * be empty or `projects/_`. The project ID that owns this bucket should be
+   * specified in the `bucket.project` field.
    *
                                            * * @@ -138,7 +138,7 @@ public com.google.protobuf.ByteString getParentBytes() { * 
                                                * Optional. Properties of the new bucket being inserted.
    * The name of the bucket is specified in the `bucket_id` field. Populating
-   * `bucket.name` field will result in an error.
+   * `bucket.name` field results in an error.
    * The project of the bucket must be specified in the `bucket.project` field.
    * This field must be in `projects/{projectIdentifier}` format,
    * {projectIdentifier} can be the project ID or project number. The `parent`
@@ -160,7 +160,7 @@ public boolean hasBucket() {
    * 
                                                * Optional. Properties of the new bucket being inserted.
    * The name of the bucket is specified in the `bucket_id` field. Populating
-   * `bucket.name` field will result in an error.
+   * `bucket.name` field results in an error.
    * The project of the bucket must be specified in the `bucket.project` field.
    * This field must be in `projects/{projectIdentifier}` format,
    * {projectIdentifier} can be the project ID or project number. The `parent`
@@ -182,7 +182,7 @@ public com.google.storage.v2.Bucket getBucket() {
    * 
                                                * Optional. Properties of the new bucket being inserted.
    * The name of the bucket is specified in the `bucket_id` field. Populating
-   * `bucket.name` field will result in an error.
+   * `bucket.name` field results in an error.
    * The project of the bucket must be specified in the `bucket.project` field.
    * This field must be in `projects/{projectIdentifier}` format,
    * {projectIdentifier} can be the project ID or project number. The `parent`
@@ -205,9 +205,9 @@ public com.google.storage.v2.BucketOrBuilder getBucketOrBuilder() {
    *
    *
    * 
                                            -   * Required. The ID to use for this bucket, which will become the final
-   * component of the bucket's resource name. For example, the value `foo` might
-   * result in a bucket with the name `projects/123456/buckets/foo`.
+   * Required. The ID to use for this bucket, which becomes the final component
+   * of the bucket's resource name. For example, the value `foo` might result in
+   * a bucket with the name `projects/123456/buckets/foo`.
    * 
                                            
    *
    * string bucket_id = 3 [(.google.api.field_behavior) = REQUIRED];
@@ -231,9 +231,9 @@ public java.lang.String getBucketId() {
    *
    *
    * 
                                            -   * Required. The ID to use for this bucket, which will become the final
-   * component of the bucket's resource name. For example, the value `foo` might
-   * result in a bucket with the name `projects/123456/buckets/foo`.
+   * Required. The ID to use for this bucket, which becomes the final component
+   * of the bucket's resource name. For example, the value `foo` might result in
+   * a bucket with the name `projects/123456/buckets/foo`.
    * 
                                            
    *
    * string bucket_id = 3 [(.google.api.field_behavior) = REQUIRED];
@@ -263,8 +263,8 @@ public com.google.protobuf.ByteString getBucketIdBytes() {
    *
    * 
                                                * Optional. Apply a predefined set of access controls to this bucket.
-   * Valid values are "authenticatedRead", "private", "projectPrivate",
-   * "publicRead", or "publicReadWrite".
+   * Valid values are `authenticatedRead`, `private`, `projectPrivate`,
+   * `publicRead`, or `publicReadWrite`.
    * 
                                            
    *
    * string predefined_acl = 6 [(.google.api.field_behavior) = OPTIONAL];
@@ -289,8 +289,8 @@ public java.lang.String getPredefinedAcl() {
    *
    * 
                                                * Optional. Apply a predefined set of access controls to this bucket.
-   * Valid values are "authenticatedRead", "private", "projectPrivate",
-   * "publicRead", or "publicReadWrite".
+   * Valid values are `authenticatedRead`, `private`, `projectPrivate`,
+   * `publicRead`, or `publicReadWrite`.
    * 
                                            
    *
    * string predefined_acl = 6 [(.google.api.field_behavior) = OPTIONAL];
@@ -320,8 +320,8 @@ public com.google.protobuf.ByteString getPredefinedAclBytes() {
    *
    * 
                                                * Optional. Apply a predefined set of default object access controls to this
-   * bucket. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-   * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+   * bucket. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+   * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
    * 
                                            
    *
    * string predefined_default_object_acl = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -347,8 +347,8 @@ public java.lang.String getPredefinedDefaultObjectAcl() {
    *
    * 
                                                * Optional. Apply a predefined set of default object access controls to this
-   * bucket. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-   * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+   * bucket. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+   * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
    * 
                                            
    *
    * string predefined_default_object_acl = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -604,7 +604,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
                                            -   * Request message for CreateBucket.
+   * Request message for [CreateBucket][google.storage.v2.Storage.CreateBucket].
    * 
                                            
    *
    * Protobuf type {@code google.storage.v2.CreateBucketRequest}
@@ -875,9 +875,9 @@ public Builder mergeFrom(
      *
      *
      * 
                                            -     * Required. The project to which this bucket will belong. This field must
-     * either be empty or `projects/_`. The project ID that owns this bucket
-     * should be specified in the `bucket.project` field.
+     * Required. The project to which this bucket belongs. This field must either
+     * be empty or `projects/_`. The project ID that owns this bucket should be
+     * specified in the `bucket.project` field.
      * 
                                            
      *
      * 
@@ -902,9 +902,9 @@ public java.lang.String getParent() {
      *
      *
      * 
                                            -     * Required. The project to which this bucket will belong. This field must
-     * either be empty or `projects/_`. The project ID that owns this bucket
-     * should be specified in the `bucket.project` field.
+     * Required. The project to which this bucket belongs. This field must either
+     * be empty or `projects/_`. The project ID that owns this bucket should be
+     * specified in the `bucket.project` field.
      * 
                                            
      *
      * 
@@ -929,9 +929,9 @@ public com.google.protobuf.ByteString getParentBytes() {
      *
      *
      * 
                                            -     * Required. The project to which this bucket will belong. This field must
-     * either be empty or `projects/_`. The project ID that owns this bucket
-     * should be specified in the `bucket.project` field.
+     * Required. The project to which this bucket belongs. This field must either
+     * be empty or `projects/_`. The project ID that owns this bucket should be
+     * specified in the `bucket.project` field.
      * 
                                            
      *
      * 
@@ -955,9 +955,9 @@ public Builder setParent(java.lang.String value) {
      *
      *
      * 
                                            -     * Required. The project to which this bucket will belong. This field must
-     * either be empty or `projects/_`. The project ID that owns this bucket
-     * should be specified in the `bucket.project` field.
+     * Required. The project to which this bucket belongs. This field must either
+     * be empty or `projects/_`. The project ID that owns this bucket should be
+     * specified in the `bucket.project` field.
      * 
                                            
      *
      * 
@@ -977,9 +977,9 @@ public Builder clearParent() {
      *
      *
      * 
                                            -     * Required. The project to which this bucket will belong. This field must
-     * either be empty or `projects/_`. The project ID that owns this bucket
-     * should be specified in the `bucket.project` field.
+     * Required. The project to which this bucket belongs. This field must either
+     * be empty or `projects/_`. The project ID that owns this bucket should be
+     * specified in the `bucket.project` field.
      * 
                                            
      *
      * 
@@ -1013,7 +1013,7 @@ public Builder setParentBytes(com.google.protobuf.ByteString value) {
      * 
                                                  * Optional. Properties of the new bucket being inserted.
      * The name of the bucket is specified in the `bucket_id` field. Populating
-     * `bucket.name` field will result in an error.
+     * `bucket.name` field results in an error.
      * The project of the bucket must be specified in the `bucket.project` field.
      * This field must be in `projects/{projectIdentifier}` format,
      * {projectIdentifier} can be the project ID or project number. The `parent`
@@ -1034,7 +1034,7 @@ public boolean hasBucket() {
      * 
                                                  * Optional. Properties of the new bucket being inserted.
      * The name of the bucket is specified in the `bucket_id` field. Populating
-     * `bucket.name` field will result in an error.
+     * `bucket.name` field results in an error.
      * The project of the bucket must be specified in the `bucket.project` field.
      * This field must be in `projects/{projectIdentifier}` format,
      * {projectIdentifier} can be the project ID or project number. The `parent`
@@ -1059,7 +1059,7 @@ public com.google.storage.v2.Bucket getBucket() {
      * 
                                                  * Optional. Properties of the new bucket being inserted.
      * The name of the bucket is specified in the `bucket_id` field. Populating
-     * `bucket.name` field will result in an error.
+     * `bucket.name` field results in an error.
      * The project of the bucket must be specified in the `bucket.project` field.
      * This field must be in `projects/{projectIdentifier}` format,
      * {projectIdentifier} can be the project ID or project number. The `parent`
@@ -1088,7 +1088,7 @@ public Builder setBucket(com.google.storage.v2.Bucket value) {
      * 
                                                  * Optional. Properties of the new bucket being inserted.
      * The name of the bucket is specified in the `bucket_id` field. Populating
-     * `bucket.name` field will result in an error.
+     * `bucket.name` field results in an error.
      * The project of the bucket must be specified in the `bucket.project` field.
      * This field must be in `projects/{projectIdentifier}` format,
      * {projectIdentifier} can be the project ID or project number. The `parent`
@@ -1114,7 +1114,7 @@ public Builder setBucket(com.google.storage.v2.Bucket.Builder builderForValue) {
      * 
                                                  * Optional. Properties of the new bucket being inserted.
      * The name of the bucket is specified in the `bucket_id` field. Populating
-     * `bucket.name` field will result in an error.
+     * `bucket.name` field results in an error.
      * The project of the bucket must be specified in the `bucket.project` field.
      * This field must be in `projects/{projectIdentifier}` format,
      * {projectIdentifier} can be the project ID or project number. The `parent`
@@ -1148,7 +1148,7 @@ public Builder mergeBucket(com.google.storage.v2.Bucket value) {
      * 
                                                  * Optional. Properties of the new bucket being inserted.
      * The name of the bucket is specified in the `bucket_id` field. Populating
-     * `bucket.name` field will result in an error.
+     * `bucket.name` field results in an error.
      * The project of the bucket must be specified in the `bucket.project` field.
      * This field must be in `projects/{projectIdentifier}` format,
      * {projectIdentifier} can be the project ID or project number. The `parent`
@@ -1174,7 +1174,7 @@ public Builder clearBucket() {
      * 
                                                  * Optional. Properties of the new bucket being inserted.
      * The name of the bucket is specified in the `bucket_id` field. Populating
-     * `bucket.name` field will result in an error.
+     * `bucket.name` field results in an error.
      * The project of the bucket must be specified in the `bucket.project` field.
      * This field must be in `projects/{projectIdentifier}` format,
      * {projectIdentifier} can be the project ID or project number. The `parent`
@@ -1195,7 +1195,7 @@ public com.google.storage.v2.Bucket.Builder getBucketBuilder() {
      * 
                                                  * Optional. Properties of the new bucket being inserted.
      * The name of the bucket is specified in the `bucket_id` field. Populating
-     * `bucket.name` field will result in an error.
+     * `bucket.name` field results in an error.
      * The project of the bucket must be specified in the `bucket.project` field.
      * This field must be in `projects/{projectIdentifier}` format,
      * {projectIdentifier} can be the project ID or project number. The `parent`
@@ -1218,7 +1218,7 @@ public com.google.storage.v2.BucketOrBuilder getBucketOrBuilder() {
      * 
                                                  * Optional. Properties of the new bucket being inserted.
      * The name of the bucket is specified in the `bucket_id` field. Populating
-     * `bucket.name` field will result in an error.
+     * `bucket.name` field results in an error.
      * The project of the bucket must be specified in the `bucket.project` field.
      * This field must be in `projects/{projectIdentifier}` format,
      * {projectIdentifier} can be the project ID or project number. The `parent`
@@ -1250,9 +1250,9 @@ public com.google.storage.v2.BucketOrBuilder getBucketOrBuilder() {
      *
      *
      * 
                                            -     * Required. The ID to use for this bucket, which will become the final
-     * component of the bucket's resource name. For example, the value `foo` might
-     * result in a bucket with the name `projects/123456/buckets/foo`.
+     * Required. The ID to use for this bucket, which becomes the final component
+     * of the bucket's resource name. For example, the value `foo` might result in
+     * a bucket with the name `projects/123456/buckets/foo`.
      * 
                                            
      *
      * string bucket_id = 3 [(.google.api.field_behavior) = REQUIRED];
@@ -1275,9 +1275,9 @@ public java.lang.String getBucketId() {
      *
      *
      * 
                                            -     * Required. The ID to use for this bucket, which will become the final
-     * component of the bucket's resource name. For example, the value `foo` might
-     * result in a bucket with the name `projects/123456/buckets/foo`.
+     * Required. The ID to use for this bucket, which becomes the final component
+     * of the bucket's resource name. For example, the value `foo` might result in
+     * a bucket with the name `projects/123456/buckets/foo`.
      * 
                                            
      *
      * string bucket_id = 3 [(.google.api.field_behavior) = REQUIRED];
@@ -1300,9 +1300,9 @@ public com.google.protobuf.ByteString getBucketIdBytes() {
      *
      *
      * 
                                            -     * Required. The ID to use for this bucket, which will become the final
-     * component of the bucket's resource name. For example, the value `foo` might
-     * result in a bucket with the name `projects/123456/buckets/foo`.
+     * Required. The ID to use for this bucket, which becomes the final component
+     * of the bucket's resource name. For example, the value `foo` might result in
+     * a bucket with the name `projects/123456/buckets/foo`.
      * 
                                            
      *
      * string bucket_id = 3 [(.google.api.field_behavior) = REQUIRED];
@@ -1324,9 +1324,9 @@ public Builder setBucketId(java.lang.String value) {
      *
      *
      * 
                                            -     * Required. The ID to use for this bucket, which will become the final
-     * component of the bucket's resource name. For example, the value `foo` might
-     * result in a bucket with the name `projects/123456/buckets/foo`.
+     * Required. The ID to use for this bucket, which becomes the final component
+     * of the bucket's resource name. For example, the value `foo` might result in
+     * a bucket with the name `projects/123456/buckets/foo`.
      * 
                                            
      *
      * string bucket_id = 3 [(.google.api.field_behavior) = REQUIRED];
@@ -1344,9 +1344,9 @@ public Builder clearBucketId() {
      *
      *
      * 
                                            -     * Required. The ID to use for this bucket, which will become the final
-     * component of the bucket's resource name. For example, the value `foo` might
-     * result in a bucket with the name `projects/123456/buckets/foo`.
+     * Required. The ID to use for this bucket, which becomes the final component
+     * of the bucket's resource name. For example, the value `foo` might result in
+     * a bucket with the name `projects/123456/buckets/foo`.
      * 
                                            
      *
      * string bucket_id = 3 [(.google.api.field_behavior) = REQUIRED];
@@ -1372,8 +1372,8 @@ public Builder setBucketIdBytes(com.google.protobuf.ByteString value) {
      *
      * 
                                                  * Optional. Apply a predefined set of access controls to this bucket.
-     * Valid values are "authenticatedRead", "private", "projectPrivate",
-     * "publicRead", or "publicReadWrite".
+     * Valid values are `authenticatedRead`, `private`, `projectPrivate`,
+     * `publicRead`, or `publicReadWrite`.
      * 
                                            
      *
      * string predefined_acl = 6 [(.google.api.field_behavior) = OPTIONAL];
@@ -1397,8 +1397,8 @@ public java.lang.String getPredefinedAcl() {
      *
      * 
                                                  * Optional. Apply a predefined set of access controls to this bucket.
-     * Valid values are "authenticatedRead", "private", "projectPrivate",
-     * "publicRead", or "publicReadWrite".
+     * Valid values are `authenticatedRead`, `private`, `projectPrivate`,
+     * `publicRead`, or `publicReadWrite`.
      * 
                                            
      *
      * string predefined_acl = 6 [(.google.api.field_behavior) = OPTIONAL];
@@ -1422,8 +1422,8 @@ public com.google.protobuf.ByteString getPredefinedAclBytes() {
      *
      * 
                                                  * Optional. Apply a predefined set of access controls to this bucket.
-     * Valid values are "authenticatedRead", "private", "projectPrivate",
-     * "publicRead", or "publicReadWrite".
+     * Valid values are `authenticatedRead`, `private`, `projectPrivate`,
+     * `publicRead`, or `publicReadWrite`.
      * 
                                            
      *
      * string predefined_acl = 6 [(.google.api.field_behavior) = OPTIONAL];
@@ -1446,8 +1446,8 @@ public Builder setPredefinedAcl(java.lang.String value) {
      *
      * 
                                                  * Optional. Apply a predefined set of access controls to this bucket.
-     * Valid values are "authenticatedRead", "private", "projectPrivate",
-     * "publicRead", or "publicReadWrite".
+     * Valid values are `authenticatedRead`, `private`, `projectPrivate`,
+     * `publicRead`, or `publicReadWrite`.
      * 
                                            
      *
      * string predefined_acl = 6 [(.google.api.field_behavior) = OPTIONAL];
@@ -1466,8 +1466,8 @@ public Builder clearPredefinedAcl() {
      *
      * 
                                                  * Optional. Apply a predefined set of access controls to this bucket.
-     * Valid values are "authenticatedRead", "private", "projectPrivate",
-     * "publicRead", or "publicReadWrite".
+     * Valid values are `authenticatedRead`, `private`, `projectPrivate`,
+     * `publicRead`, or `publicReadWrite`.
      * 
                                            
      *
      * string predefined_acl = 6 [(.google.api.field_behavior) = OPTIONAL];
@@ -1493,8 +1493,8 @@ public Builder setPredefinedAclBytes(com.google.protobuf.ByteString value) {
      *
      * 
                                                  * Optional. Apply a predefined set of default object access controls to this
-     * bucket. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-     * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+     * bucket. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+     * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
      * 
                                            
      *
      * string predefined_default_object_acl = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -1519,8 +1519,8 @@ public java.lang.String getPredefinedDefaultObjectAcl() {
      *
      * 
                                                  * Optional. Apply a predefined set of default object access controls to this
-     * bucket. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-     * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+     * bucket. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+     * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
      * 
                                            
      *
      * string predefined_default_object_acl = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -1545,8 +1545,8 @@ public com.google.protobuf.ByteString getPredefinedDefaultObjectAclBytes() {
      *
      * 
                                                  * Optional. Apply a predefined set of default object access controls to this
-     * bucket. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-     * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+     * bucket. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+     * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
      * 
                                            
      *
      * string predefined_default_object_acl = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -1570,8 +1570,8 @@ public Builder setPredefinedDefaultObjectAcl(java.lang.String value) {
      *
      * 
                                                  * Optional. Apply a predefined set of default object access controls to this
-     * bucket. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-     * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+     * bucket. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+     * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
      * 
                                            
      *
      * string predefined_default_object_acl = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -1591,8 +1591,8 @@ public Builder clearPredefinedDefaultObjectAcl() {
      *
      * 
                                                  * Optional. Apply a predefined set of default object access controls to this
-     * bucket. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-     * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+     * bucket. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+     * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
      * 
                                            
      *
      * string predefined_default_object_acl = 7 [(.google.api.field_behavior) = OPTIONAL];
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CreateBucketRequestOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CreateBucketRequestOrBuilder.java
index ec1f60218b..7c646f2191 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CreateBucketRequestOrBuilder.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CreateBucketRequestOrBuilder.java
@@ -28,9 +28,9 @@ public interface CreateBucketRequestOrBuilder
    *
    *
    * 
                                            -   * Required. The project to which this bucket will belong. This field must
-   * either be empty or `projects/_`. The project ID that owns this bucket
-   * should be specified in the `bucket.project` field.
+   * Required. The project to which this bucket belongs. This field must either
+   * be empty or `projects/_`. The project ID that owns this bucket should be
+   * specified in the `bucket.project` field.
    * 
                                            
    *
    * 
@@ -45,9 +45,9 @@ public interface CreateBucketRequestOrBuilder
    *
    *
    * 
                                            -   * Required. The project to which this bucket will belong. This field must
-   * either be empty or `projects/_`. The project ID that owns this bucket
-   * should be specified in the `bucket.project` field.
+   * Required. The project to which this bucket belongs. This field must either
+   * be empty or `projects/_`. The project ID that owns this bucket should be
+   * specified in the `bucket.project` field.
    * 
                                            
    *
    * 
@@ -64,7 +64,7 @@ public interface CreateBucketRequestOrBuilder
    * 
                                                * Optional. Properties of the new bucket being inserted.
    * The name of the bucket is specified in the `bucket_id` field. Populating
-   * `bucket.name` field will result in an error.
+   * `bucket.name` field results in an error.
    * The project of the bucket must be specified in the `bucket.project` field.
    * This field must be in `projects/{projectIdentifier}` format,
    * {projectIdentifier} can be the project ID or project number. The `parent`
@@ -83,7 +83,7 @@ public interface CreateBucketRequestOrBuilder
    * 
                                                * Optional. Properties of the new bucket being inserted.
    * The name of the bucket is specified in the `bucket_id` field. Populating
-   * `bucket.name` field will result in an error.
+   * `bucket.name` field results in an error.
    * The project of the bucket must be specified in the `bucket.project` field.
    * This field must be in `projects/{projectIdentifier}` format,
    * {projectIdentifier} can be the project ID or project number. The `parent`
@@ -102,7 +102,7 @@ public interface CreateBucketRequestOrBuilder
    * 
                                                * Optional. Properties of the new bucket being inserted.
    * The name of the bucket is specified in the `bucket_id` field. Populating
-   * `bucket.name` field will result in an error.
+   * `bucket.name` field results in an error.
    * The project of the bucket must be specified in the `bucket.project` field.
    * This field must be in `projects/{projectIdentifier}` format,
    * {projectIdentifier} can be the project ID or project number. The `parent`
@@ -117,9 +117,9 @@ public interface CreateBucketRequestOrBuilder
    *
    *
    * 
                                            -   * Required. The ID to use for this bucket, which will become the final
-   * component of the bucket's resource name. For example, the value `foo` might
-   * result in a bucket with the name `projects/123456/buckets/foo`.
+   * Required. The ID to use for this bucket, which becomes the final component
+   * of the bucket's resource name. For example, the value `foo` might result in
+   * a bucket with the name `projects/123456/buckets/foo`.
    * 
                                            
    *
    * string bucket_id = 3 [(.google.api.field_behavior) = REQUIRED];
@@ -132,9 +132,9 @@ public interface CreateBucketRequestOrBuilder
    *
    *
    * 
                                            -   * Required. The ID to use for this bucket, which will become the final
-   * component of the bucket's resource name. For example, the value `foo` might
-   * result in a bucket with the name `projects/123456/buckets/foo`.
+   * Required. The ID to use for this bucket, which becomes the final component
+   * of the bucket's resource name. For example, the value `foo` might result in
+   * a bucket with the name `projects/123456/buckets/foo`.
    * 
                                            
    *
    * string bucket_id = 3 [(.google.api.field_behavior) = REQUIRED];
@@ -148,8 +148,8 @@ public interface CreateBucketRequestOrBuilder
    *
    * 
                                                * Optional. Apply a predefined set of access controls to this bucket.
-   * Valid values are "authenticatedRead", "private", "projectPrivate",
-   * "publicRead", or "publicReadWrite".
+   * Valid values are `authenticatedRead`, `private`, `projectPrivate`,
+   * `publicRead`, or `publicReadWrite`.
    * 
                                            
    *
    * string predefined_acl = 6 [(.google.api.field_behavior) = OPTIONAL];
@@ -163,8 +163,8 @@ public interface CreateBucketRequestOrBuilder
    *
    * 
                                                * Optional. Apply a predefined set of access controls to this bucket.
-   * Valid values are "authenticatedRead", "private", "projectPrivate",
-   * "publicRead", or "publicReadWrite".
+   * Valid values are `authenticatedRead`, `private`, `projectPrivate`,
+   * `publicRead`, or `publicReadWrite`.
    * 
                                            
    *
    * string predefined_acl = 6 [(.google.api.field_behavior) = OPTIONAL];
@@ -178,8 +178,8 @@ public interface CreateBucketRequestOrBuilder
    *
    * 
                                                * Optional. Apply a predefined set of default object access controls to this
-   * bucket. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-   * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+   * bucket. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+   * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
    * 
                                            
    *
    * string predefined_default_object_acl = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -194,8 +194,8 @@ public interface CreateBucketRequestOrBuilder
    *
    * 
                                                * Optional. Apply a predefined set of default object access controls to this
-   * bucket. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-   * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+   * bucket. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+   * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
    * 
                                            
    *
    * string predefined_default_object_acl = 7 [(.google.api.field_behavior) = OPTIONAL];
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CustomerEncryption.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CustomerEncryption.java
index 9fbbb6cb84..44e4d733ad 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CustomerEncryption.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CustomerEncryption.java
@@ -23,8 +23,8 @@
  *
  *
  * 
                                            - * Describes the Customer-Supplied Encryption Key mechanism used to store an
- * Object's data at rest.
+ * Describes the customer-supplied encryption key mechanism used to store an
+ * object's data at rest.
  * 
                                            
  *
  * Protobuf type {@code google.storage.v2.CustomerEncryption}
@@ -311,8 +311,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
                                            -   * Describes the Customer-Supplied Encryption Key mechanism used to store an
-   * Object's data at rest.
+   * Describes the customer-supplied encryption key mechanism used to store an
+   * object's data at rest.
    * 
                                            
    *
    * Protobuf type {@code google.storage.v2.CustomerEncryption}
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/DeleteBucketRequest.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/DeleteBucketRequest.java
index 048d27d275..65ba3e8487 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/DeleteBucketRequest.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/DeleteBucketRequest.java
@@ -23,7 +23,7 @@
  *
  *
  * 
                                            - * Request message for DeleteBucket.
+ * Request message for [DeleteBucket][google.storage.v2.Storage.DeleteBucket].
  * 
                                            
  *
  * Protobuf type {@code google.storage.v2.DeleteBucketRequest}
@@ -386,7 +386,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
                                            -   * Request message for DeleteBucket.
+   * Request message for [DeleteBucket][google.storage.v2.Storage.DeleteBucket].
    * 
                                            
    *
    * Protobuf type {@code google.storage.v2.DeleteBucketRequest}
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/DeleteObjectRequest.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/DeleteObjectRequest.java
index 4d3966842d..2089b35aef 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/DeleteObjectRequest.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/DeleteObjectRequest.java
@@ -23,8 +23,7 @@
  *
  *
  * 
                                            - * Message for deleting an object.
- * `bucket` and `object` **must** be set.
+ * Request message for deleting an object.
  * 
                                            
  *
  * Protobuf type {@code google.storage.v2.DeleteObjectRequest}
@@ -673,8 +672,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
                                            -   * Message for deleting an object.
-   * `bucket` and `object` **must** be set.
+   * Request message for deleting an object.
    * 
                                            
    *
    * Protobuf type {@code google.storage.v2.DeleteObjectRequest}
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/GetBucketRequest.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/GetBucketRequest.java
index ca1a62ceb4..86004338eb 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/GetBucketRequest.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/GetBucketRequest.java
@@ -23,7 +23,7 @@
  *
  *
  * 
                                            - * Request message for GetBucket.
+ * Request message for [GetBucket][google.storage.v2.Storage.GetBucket].
  * 
                                            
  *
  * Protobuf type {@code google.storage.v2.GetBucketRequest}
@@ -129,8 +129,8 @@ public com.google.protobuf.ByteString getNameBytes() {
    *
    *
    * 
                                            -   * If set, and if the bucket's current metageneration does not match the
-   * specified value, the request will return an error.
+   * If set, only gets the bucket metadata if its metageneration matches this
+   * value.
    * 
                                            
    *
    * optional int64 if_metageneration_match = 2;
@@ -146,8 +146,8 @@ public boolean hasIfMetagenerationMatch() {
    *
    *
    * 
                                            -   * If set, and if the bucket's current metageneration does not match the
-   * specified value, the request will return an error.
+   * If set, only gets the bucket metadata if its metageneration matches this
+   * value.
    * 
                                            
    *
    * optional int64 if_metageneration_match = 2;
@@ -167,7 +167,7 @@ public long getIfMetagenerationMatch() {
    *
    * 
                                                * If set, and if the bucket's current metageneration matches the specified
-   * value, the request will return an error.
+   * value, the request returns an error.
    * 
                                            
    *
    * optional int64 if_metageneration_not_match = 3;
@@ -184,7 +184,7 @@ public boolean hasIfMetagenerationNotMatch() {
    *
    * 
                                                * If set, and if the bucket's current metageneration matches the specified
-   * value, the request will return an error.
+   * value, the request returns an error.
    * 
                                            
    *
    * optional int64 if_metageneration_not_match = 3;
@@ -204,8 +204,8 @@ public long getIfMetagenerationNotMatch() {
    *
    * 
                                                * Mask specifying which fields to read.
-   * A "*" field may be used to indicate all fields.
-   * If no mask is specified, will default to all fields.
+   * A `*` field might be used to indicate all fields.
+   * If no mask is specified, it defaults to all fields.
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 5;
@@ -222,8 +222,8 @@ public boolean hasReadMask() {
    *
    * 
                                                * Mask specifying which fields to read.
-   * A "*" field may be used to indicate all fields.
-   * If no mask is specified, will default to all fields.
+   * A `*` field might be used to indicate all fields.
+   * If no mask is specified, it defaults to all fields.
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 5;
@@ -240,8 +240,8 @@ public com.google.protobuf.FieldMask getReadMask() {
    *
    * 
                                                * Mask specifying which fields to read.
-   * A "*" field may be used to indicate all fields.
-   * If no mask is specified, will default to all fields.
+   * A `*` field might be used to indicate all fields.
+   * If no mask is specified, it defaults to all fields.
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 5;
@@ -456,7 +456,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
                                            -   * Request message for GetBucket.
+   * Request message for [GetBucket][google.storage.v2.Storage.GetBucket].
    * 
                                            
    *
    * Protobuf type {@code google.storage.v2.GetBucketRequest}
@@ -818,8 +818,8 @@ public Builder setNameBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
                                            -     * If set, and if the bucket's current metageneration does not match the
-     * specified value, the request will return an error.
+     * If set, only gets the bucket metadata if its metageneration matches this
+     * value.
      * 
                                            
      *
      * optional int64 if_metageneration_match = 2;
@@ -835,8 +835,8 @@ public boolean hasIfMetagenerationMatch() {
      *
      *
      * 
                                            -     * If set, and if the bucket's current metageneration does not match the
-     * specified value, the request will return an error.
+     * If set, only gets the bucket metadata if its metageneration matches this
+     * value.
      * 
                                            
      *
      * optional int64 if_metageneration_match = 2;
@@ -852,8 +852,8 @@ public long getIfMetagenerationMatch() {
      *
      *
      * 
                                            -     * If set, and if the bucket's current metageneration does not match the
-     * specified value, the request will return an error.
+     * If set, only gets the bucket metadata if its metageneration matches this
+     * value.
      * 
                                            
      *
      * optional int64 if_metageneration_match = 2;
@@ -873,8 +873,8 @@ public Builder setIfMetagenerationMatch(long value) {
      *
      *
      * 
                                            -     * If set, and if the bucket's current metageneration does not match the
-     * specified value, the request will return an error.
+     * If set, only gets the bucket metadata if its metageneration matches this
+     * value.
      * 
                                            
      *
      * optional int64 if_metageneration_match = 2;
@@ -895,7 +895,7 @@ public Builder clearIfMetagenerationMatch() {
      *
      * 
                                                  * If set, and if the bucket's current metageneration matches the specified
-     * value, the request will return an error.
+     * value, the request returns an error.
      * 
                                            
      *
      * optional int64 if_metageneration_not_match = 3;
@@ -912,7 +912,7 @@ public boolean hasIfMetagenerationNotMatch() {
      *
      * 
                                                  * If set, and if the bucket's current metageneration matches the specified
-     * value, the request will return an error.
+     * value, the request returns an error.
      * 
                                            
      *
      * optional int64 if_metageneration_not_match = 3;
@@ -929,7 +929,7 @@ public long getIfMetagenerationNotMatch() {
      *
      * 
                                                  * If set, and if the bucket's current metageneration matches the specified
-     * value, the request will return an error.
+     * value, the request returns an error.
      * 
                                            
      *
      * optional int64 if_metageneration_not_match = 3;
@@ -950,7 +950,7 @@ public Builder setIfMetagenerationNotMatch(long value) {
      *
      * 
                                                  * If set, and if the bucket's current metageneration matches the specified
-     * value, the request will return an error.
+     * value, the request returns an error.
      * 
                                            
      *
      * optional int64 if_metageneration_not_match = 3;
@@ -976,8 +976,8 @@ public Builder clearIfMetagenerationNotMatch() {
      *
      * 
                                                  * Mask specifying which fields to read.
-     * A "*" field may be used to indicate all fields.
-     * If no mask is specified, will default to all fields.
+     * A `*` field might be used to indicate all fields.
+     * If no mask is specified, it defaults to all fields.
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 5;
@@ -993,8 +993,8 @@ public boolean hasReadMask() {
      *
      * 
                                                  * Mask specifying which fields to read.
-     * A "*" field may be used to indicate all fields.
-     * If no mask is specified, will default to all fields.
+     * A `*` field might be used to indicate all fields.
+     * If no mask is specified, it defaults to all fields.
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 5;
@@ -1014,8 +1014,8 @@ public com.google.protobuf.FieldMask getReadMask() {
      *
      * 
                                                  * Mask specifying which fields to read.
-     * A "*" field may be used to indicate all fields.
-     * If no mask is specified, will default to all fields.
+     * A `*` field might be used to indicate all fields.
+     * If no mask is specified, it defaults to all fields.
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 5;
@@ -1039,8 +1039,8 @@ public Builder setReadMask(com.google.protobuf.FieldMask value) {
      *
      * 
                                                  * Mask specifying which fields to read.
-     * A "*" field may be used to indicate all fields.
-     * If no mask is specified, will default to all fields.
+     * A `*` field might be used to indicate all fields.
+     * If no mask is specified, it defaults to all fields.
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 5;
@@ -1061,8 +1061,8 @@ public Builder setReadMask(com.google.protobuf.FieldMask.Builder builderForValue
      *
      * 
                                                  * Mask specifying which fields to read.
-     * A "*" field may be used to indicate all fields.
-     * If no mask is specified, will default to all fields.
+     * A `*` field might be used to indicate all fields.
+     * If no mask is specified, it defaults to all fields.
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 5;
@@ -1091,8 +1091,8 @@ public Builder mergeReadMask(com.google.protobuf.FieldMask value) {
      *
      * 
                                                  * Mask specifying which fields to read.
-     * A "*" field may be used to indicate all fields.
-     * If no mask is specified, will default to all fields.
+     * A `*` field might be used to indicate all fields.
+     * If no mask is specified, it defaults to all fields.
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 5;
@@ -1113,8 +1113,8 @@ public Builder clearReadMask() {
      *
      * 
                                                  * Mask specifying which fields to read.
-     * A "*" field may be used to indicate all fields.
-     * If no mask is specified, will default to all fields.
+     * A `*` field might be used to indicate all fields.
+     * If no mask is specified, it defaults to all fields.
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 5;
@@ -1130,8 +1130,8 @@ public com.google.protobuf.FieldMask.Builder getReadMaskBuilder() {
      *
      * 
                                                  * Mask specifying which fields to read.
-     * A "*" field may be used to indicate all fields.
-     * If no mask is specified, will default to all fields.
+     * A `*` field might be used to indicate all fields.
+     * If no mask is specified, it defaults to all fields.
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 5;
@@ -1149,8 +1149,8 @@ public com.google.protobuf.FieldMaskOrBuilder getReadMaskOrBuilder() {
      *
      * 
                                                  * Mask specifying which fields to read.
-     * A "*" field may be used to indicate all fields.
-     * If no mask is specified, will default to all fields.
+     * A `*` field might be used to indicate all fields.
+     * If no mask is specified, it defaults to all fields.
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 5;
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/GetBucketRequestOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/GetBucketRequestOrBuilder.java
index d5c9974e5b..fed5323d2a 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/GetBucketRequestOrBuilder.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/GetBucketRequestOrBuilder.java
@@ -58,8 +58,8 @@ public interface GetBucketRequestOrBuilder
    *
    *
    * 
                                            -   * If set, and if the bucket's current metageneration does not match the
-   * specified value, the request will return an error.
+   * If set, only gets the bucket metadata if its metageneration matches this
+   * value.
    * 
                                            
    *
    * optional int64 if_metageneration_match = 2;
@@ -72,8 +72,8 @@ public interface GetBucketRequestOrBuilder
    *
    *
    * 
                                            -   * If set, and if the bucket's current metageneration does not match the
-   * specified value, the request will return an error.
+   * If set, only gets the bucket metadata if its metageneration matches this
+   * value.
    * 
                                            
    *
    * optional int64 if_metageneration_match = 2;
@@ -87,7 +87,7 @@ public interface GetBucketRequestOrBuilder
    *
    * 
                                                * If set, and if the bucket's current metageneration matches the specified
-   * value, the request will return an error.
+   * value, the request returns an error.
    * 
                                            
    *
    * optional int64 if_metageneration_not_match = 3;
@@ -101,7 +101,7 @@ public interface GetBucketRequestOrBuilder
    *
    * 
                                                * If set, and if the bucket's current metageneration matches the specified
-   * value, the request will return an error.
+   * value, the request returns an error.
    * 
                                            
    *
    * optional int64 if_metageneration_not_match = 3;
@@ -115,8 +115,8 @@ public interface GetBucketRequestOrBuilder
    *
    * 
                                                * Mask specifying which fields to read.
-   * A "*" field may be used to indicate all fields.
-   * If no mask is specified, will default to all fields.
+   * A `*` field might be used to indicate all fields.
+   * If no mask is specified, it defaults to all fields.
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 5;
@@ -130,8 +130,8 @@ public interface GetBucketRequestOrBuilder
    *
    * 
                                                * Mask specifying which fields to read.
-   * A "*" field may be used to indicate all fields.
-   * If no mask is specified, will default to all fields.
+   * A `*` field might be used to indicate all fields.
+   * If no mask is specified, it defaults to all fields.
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 5;
@@ -145,8 +145,8 @@ public interface GetBucketRequestOrBuilder
    *
    * 
                                                * Mask specifying which fields to read.
-   * A "*" field may be used to indicate all fields.
-   * If no mask is specified, will default to all fields.
+   * A `*` field might be used to indicate all fields.
+   * If no mask is specified, it defaults to all fields.
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 5;
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/GetObjectRequest.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/GetObjectRequest.java
index a184b3b8a0..d63a19fbf8 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/GetObjectRequest.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/GetObjectRequest.java
@@ -23,7 +23,7 @@
  *
  *
  * 
                                            - * Request message for GetObject.
+ * Request message for [GetObject][google.storage.v2.Storage.GetObject].
  * 
                                            
  *
  * Protobuf type {@code google.storage.v2.GetObjectRequest}
@@ -457,9 +457,9 @@ public com.google.storage.v2.CommonObjectRequestParams getCommonObjectRequestPar
    *
    * 
                                                * Mask specifying which fields to read.
-   * If no mask is specified, will default to all fields except metadata.acl and
-   * metadata.owner.
-   * * may be used to mean "all fields".
+   * If no mask is specified, it defaults to all fields except `metadata.
+   * acl` and `metadata.owner`.
+   * `*` might be used to mean "all fields".
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 10;
@@ -476,9 +476,9 @@ public boolean hasReadMask() {
    *
    * 
                                                * Mask specifying which fields to read.
-   * If no mask is specified, will default to all fields except metadata.acl and
-   * metadata.owner.
-   * * may be used to mean "all fields".
+   * If no mask is specified, it defaults to all fields except `metadata.
+   * acl` and `metadata.owner`.
+   * `*` might be used to mean "all fields".
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 10;
@@ -495,9 +495,9 @@ public com.google.protobuf.FieldMask getReadMask() {
    *
    * 
                                                * Mask specifying which fields to read.
-   * If no mask is specified, will default to all fields except metadata.acl and
-   * metadata.owner.
-   * * may be used to mean "all fields".
+   * If no mask is specified, it defaults to all fields except `metadata.
+   * acl` and `metadata.owner`.
+   * `*` might be used to mean "all fields".
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 10;
@@ -518,9 +518,9 @@ public com.google.protobuf.FieldMaskOrBuilder getReadMaskOrBuilder() {
    * 
                                                * Optional. Restore token used to differentiate soft-deleted objects with the
    * same name and generation. Only applicable for hierarchical namespace
-   * buckets and if soft_deleted is set to true. This parameter is optional, and
-   * is only required in the rare case when there are multiple soft-deleted
-   * objects with the same name and generation.
+   * buckets and if `soft_deleted` is set to `true`. This parameter is optional,
+   * and is only required in the rare case when there are multiple soft-deleted
+   * objects with the same `name` and `generation`.
    * 
                                            
    *
    * string restore_token = 12 [(.google.api.field_behavior) = OPTIONAL];
@@ -546,9 +546,9 @@ public java.lang.String getRestoreToken() {
    * 
                                                * Optional. Restore token used to differentiate soft-deleted objects with the
    * same name and generation. Only applicable for hierarchical namespace
-   * buckets and if soft_deleted is set to true. This parameter is optional, and
-   * is only required in the rare case when there are multiple soft-deleted
-   * objects with the same name and generation.
+   * buckets and if `soft_deleted` is set to `true`. This parameter is optional,
+   * and is only required in the rare case when there are multiple soft-deleted
+   * objects with the same `name` and `generation`.
    * 
                                            
    *
    * string restore_token = 12 [(.google.api.field_behavior) = OPTIONAL];
@@ -859,7 +859,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
                                            -   * Request message for GetObject.
+   * Request message for [GetObject][google.storage.v2.Storage.GetObject].
    * 
                                            
    *
    * Protobuf type {@code google.storage.v2.GetObjectRequest}
@@ -2120,9 +2120,9 @@ public Builder clearCommonObjectRequestParams() {
      *
      * 
                                                  * Mask specifying which fields to read.
-     * If no mask is specified, will default to all fields except metadata.acl and
-     * metadata.owner.
-     * * may be used to mean "all fields".
+     * If no mask is specified, it defaults to all fields except `metadata.
+     * acl` and `metadata.owner`.
+     * `*` might be used to mean "all fields".
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 10;
@@ -2138,9 +2138,9 @@ public boolean hasReadMask() {
      *
      * 
                                                  * Mask specifying which fields to read.
-     * If no mask is specified, will default to all fields except metadata.acl and
-     * metadata.owner.
-     * * may be used to mean "all fields".
+     * If no mask is specified, it defaults to all fields except `metadata.
+     * acl` and `metadata.owner`.
+     * `*` might be used to mean "all fields".
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 10;
@@ -2160,9 +2160,9 @@ public com.google.protobuf.FieldMask getReadMask() {
      *
      * 
                                                  * Mask specifying which fields to read.
-     * If no mask is specified, will default to all fields except metadata.acl and
-     * metadata.owner.
-     * * may be used to mean "all fields".
+     * If no mask is specified, it defaults to all fields except `metadata.
+     * acl` and `metadata.owner`.
+     * `*` might be used to mean "all fields".
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 10;
@@ -2186,9 +2186,9 @@ public Builder setReadMask(com.google.protobuf.FieldMask value) {
      *
      * 
                                                  * Mask specifying which fields to read.
-     * If no mask is specified, will default to all fields except metadata.acl and
-     * metadata.owner.
-     * * may be used to mean "all fields".
+     * If no mask is specified, it defaults to all fields except `metadata.
+     * acl` and `metadata.owner`.
+     * `*` might be used to mean "all fields".
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 10;
@@ -2209,9 +2209,9 @@ public Builder setReadMask(com.google.protobuf.FieldMask.Builder builderForValue
      *
      * 
                                                  * Mask specifying which fields to read.
-     * If no mask is specified, will default to all fields except metadata.acl and
-     * metadata.owner.
-     * * may be used to mean "all fields".
+     * If no mask is specified, it defaults to all fields except `metadata.
+     * acl` and `metadata.owner`.
+     * `*` might be used to mean "all fields".
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 10;
@@ -2240,9 +2240,9 @@ public Builder mergeReadMask(com.google.protobuf.FieldMask value) {
      *
      * 
                                                  * Mask specifying which fields to read.
-     * If no mask is specified, will default to all fields except metadata.acl and
-     * metadata.owner.
-     * * may be used to mean "all fields".
+     * If no mask is specified, it defaults to all fields except `metadata.
+     * acl` and `metadata.owner`.
+     * `*` might be used to mean "all fields".
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 10;
@@ -2263,9 +2263,9 @@ public Builder clearReadMask() {
      *
      * 
                                                  * Mask specifying which fields to read.
-     * If no mask is specified, will default to all fields except metadata.acl and
-     * metadata.owner.
-     * * may be used to mean "all fields".
+     * If no mask is specified, it defaults to all fields except `metadata.
+     * acl` and `metadata.owner`.
+     * `*` might be used to mean "all fields".
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 10;
@@ -2281,9 +2281,9 @@ public com.google.protobuf.FieldMask.Builder getReadMaskBuilder() {
      *
      * 
                                                  * Mask specifying which fields to read.
-     * If no mask is specified, will default to all fields except metadata.acl and
-     * metadata.owner.
-     * * may be used to mean "all fields".
+     * If no mask is specified, it defaults to all fields except `metadata.
+     * acl` and `metadata.owner`.
+     * `*` might be used to mean "all fields".
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 10;
@@ -2301,9 +2301,9 @@ public com.google.protobuf.FieldMaskOrBuilder getReadMaskOrBuilder() {
      *
      * 
                                                  * Mask specifying which fields to read.
-     * If no mask is specified, will default to all fields except metadata.acl and
-     * metadata.owner.
-     * * may be used to mean "all fields".
+     * If no mask is specified, it defaults to all fields except `metadata.
+     * acl` and `metadata.owner`.
+     * `*` might be used to mean "all fields".
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 10;
@@ -2333,9 +2333,9 @@ public com.google.protobuf.FieldMaskOrBuilder getReadMaskOrBuilder() {
      * 
                                                  * Optional. Restore token used to differentiate soft-deleted objects with the
      * same name and generation. Only applicable for hierarchical namespace
-     * buckets and if soft_deleted is set to true. This parameter is optional, and
-     * is only required in the rare case when there are multiple soft-deleted
-     * objects with the same name and generation.
+     * buckets and if `soft_deleted` is set to `true`. This parameter is optional,
+     * and is only required in the rare case when there are multiple soft-deleted
+     * objects with the same `name` and `generation`.
      * 
                                            
      *
      * string restore_token = 12 [(.google.api.field_behavior) = OPTIONAL];
@@ -2360,9 +2360,9 @@ public java.lang.String getRestoreToken() {
      * 
                                                  * Optional. Restore token used to differentiate soft-deleted objects with the
      * same name and generation. Only applicable for hierarchical namespace
-     * buckets and if soft_deleted is set to true. This parameter is optional, and
-     * is only required in the rare case when there are multiple soft-deleted
-     * objects with the same name and generation.
+     * buckets and if `soft_deleted` is set to `true`. This parameter is optional,
+     * and is only required in the rare case when there are multiple soft-deleted
+     * objects with the same `name` and `generation`.
      * 
                                            
      *
      * string restore_token = 12 [(.google.api.field_behavior) = OPTIONAL];
@@ -2387,9 +2387,9 @@ public com.google.protobuf.ByteString getRestoreTokenBytes() {
      * 
                                                  * Optional. Restore token used to differentiate soft-deleted objects with the
      * same name and generation. Only applicable for hierarchical namespace
-     * buckets and if soft_deleted is set to true. This parameter is optional, and
-     * is only required in the rare case when there are multiple soft-deleted
-     * objects with the same name and generation.
+     * buckets and if `soft_deleted` is set to `true`. This parameter is optional,
+     * and is only required in the rare case when there are multiple soft-deleted
+     * objects with the same `name` and `generation`.
      * 
                                            
      *
      * string restore_token = 12 [(.google.api.field_behavior) = OPTIONAL];
@@ -2413,9 +2413,9 @@ public Builder setRestoreToken(java.lang.String value) {
      * 
                                                  * Optional. Restore token used to differentiate soft-deleted objects with the
      * same name and generation. Only applicable for hierarchical namespace
-     * buckets and if soft_deleted is set to true. This parameter is optional, and
-     * is only required in the rare case when there are multiple soft-deleted
-     * objects with the same name and generation.
+     * buckets and if `soft_deleted` is set to `true`. This parameter is optional,
+     * and is only required in the rare case when there are multiple soft-deleted
+     * objects with the same `name` and `generation`.
      * 
                                            
      *
      * string restore_token = 12 [(.google.api.field_behavior) = OPTIONAL];
@@ -2435,9 +2435,9 @@ public Builder clearRestoreToken() {
      * 
                                                  * Optional. Restore token used to differentiate soft-deleted objects with the
      * same name and generation. Only applicable for hierarchical namespace
-     * buckets and if soft_deleted is set to true. This parameter is optional, and
-     * is only required in the rare case when there are multiple soft-deleted
-     * objects with the same name and generation.
+     * buckets and if `soft_deleted` is set to `true`. This parameter is optional,
+     * and is only required in the rare case when there are multiple soft-deleted
+     * objects with the same `name` and `generation`.
      * 
                                            
      *
      * string restore_token = 12 [(.google.api.field_behavior) = OPTIONAL];
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/GetObjectRequestOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/GetObjectRequestOrBuilder.java
index 884f2cefb4..f6255e4913 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/GetObjectRequestOrBuilder.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/GetObjectRequestOrBuilder.java
@@ -289,9 +289,9 @@ public interface GetObjectRequestOrBuilder
    *
    * 
                                                * Mask specifying which fields to read.
-   * If no mask is specified, will default to all fields except metadata.acl and
-   * metadata.owner.
-   * * may be used to mean "all fields".
+   * If no mask is specified, it defaults to all fields except `metadata.
+   * acl` and `metadata.owner`.
+   * `*` might be used to mean "all fields".
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 10;
@@ -305,9 +305,9 @@ public interface GetObjectRequestOrBuilder
    *
    * 
                                                * Mask specifying which fields to read.
-   * If no mask is specified, will default to all fields except metadata.acl and
-   * metadata.owner.
-   * * may be used to mean "all fields".
+   * If no mask is specified, it defaults to all fields except `metadata.
+   * acl` and `metadata.owner`.
+   * `*` might be used to mean "all fields".
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 10;
@@ -321,9 +321,9 @@ public interface GetObjectRequestOrBuilder
    *
    * 
                                                * Mask specifying which fields to read.
-   * If no mask is specified, will default to all fields except metadata.acl and
-   * metadata.owner.
-   * * may be used to mean "all fields".
+   * If no mask is specified, it defaults to all fields except `metadata.
+   * acl` and `metadata.owner`.
+   * `*` might be used to mean "all fields".
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 10;
@@ -336,9 +336,9 @@ public interface GetObjectRequestOrBuilder
    * 
                                                * Optional. Restore token used to differentiate soft-deleted objects with the
    * same name and generation. Only applicable for hierarchical namespace
-   * buckets and if soft_deleted is set to true. This parameter is optional, and
-   * is only required in the rare case when there are multiple soft-deleted
-   * objects with the same name and generation.
+   * buckets and if `soft_deleted` is set to `true`. This parameter is optional,
+   * and is only required in the rare case when there are multiple soft-deleted
+   * objects with the same `name` and `generation`.
    * 
                                            
    *
    * string restore_token = 12 [(.google.api.field_behavior) = OPTIONAL];
@@ -353,9 +353,9 @@ public interface GetObjectRequestOrBuilder
    * 
                                                * Optional. Restore token used to differentiate soft-deleted objects with the
    * same name and generation. Only applicable for hierarchical namespace
-   * buckets and if soft_deleted is set to true. This parameter is optional, and
-   * is only required in the rare case when there are multiple soft-deleted
-   * objects with the same name and generation.
+   * buckets and if `soft_deleted` is set to `true`. This parameter is optional,
+   * and is only required in the rare case when there are multiple soft-deleted
+   * objects with the same `name` and `generation`.
    * 
                                            
    *
    * string restore_token = 12 [(.google.api.field_behavior) = OPTIONAL];
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ListBucketsRequest.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ListBucketsRequest.java
index 167c7ca79c..8ecb77cdf5 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ListBucketsRequest.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ListBucketsRequest.java
@@ -23,7 +23,7 @@
  *
  *
  * 
                                            - * Request message for ListBuckets.
+ * Request message for [ListBuckets][google.storage.v2.Storage.ListBuckets].
  * 
                                            
  *
  * Protobuf type {@code google.storage.v2.ListBucketsRequest}
@@ -132,9 +132,9 @@ public com.google.protobuf.ByteString getParentBytes() {
    *
    * 
                                                * Optional. Maximum number of buckets to return in a single response. The
-   * service will use this parameter or 1,000 items, whichever is smaller. If
-   * "acl" is present in the read_mask, the service will use this parameter of
-   * 200 items, whichever is smaller.
+   * service uses this parameter or `1,000` items, whichever is smaller. If
+   * `acl` is present in the `read_mask`, the service uses this parameter of
+   * `200` items, whichever is smaller.
    * 
                                            
    *
    * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -262,9 +262,9 @@ public com.google.protobuf.ByteString getPrefixBytes() {
    *
    * 
                                                * Mask specifying which fields to read from each result.
-   * If no mask is specified, will default to all fields except items.owner,
-   * items.acl, and items.default_object_acl.
-   * * may be used to mean "all fields".
+   * If no mask is specified, it defaults to all fields except `items.
+   * owner`, `items.acl`, and `items.default_object_acl`.
+   * `*` might be used to mean "all fields".
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 5;
@@ -281,9 +281,9 @@ public boolean hasReadMask() {
    *
    * 
                                                * Mask specifying which fields to read from each result.
-   * If no mask is specified, will default to all fields except items.owner,
-   * items.acl, and items.default_object_acl.
-   * * may be used to mean "all fields".
+   * If no mask is specified, it defaults to all fields except `items.
+   * owner`, `items.acl`, and `items.default_object_acl`.
+   * `*` might be used to mean "all fields".
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 5;
@@ -300,9 +300,9 @@ public com.google.protobuf.FieldMask getReadMask() {
    *
    * 
                                                * Mask specifying which fields to read from each result.
-   * If no mask is specified, will default to all fields except items.owner,
-   * items.acl, and items.default_object_acl.
-   * * may be used to mean "all fields".
+   * If no mask is specified, it defaults to all fields except `items.
+   * owner`, `items.acl`, and `items.default_object_acl`.
+   * `*` might be used to mean "all fields".
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 5;
@@ -312,6 +312,26 @@ public com.google.protobuf.FieldMaskOrBuilder getReadMaskOrBuilder() {
     return readMask_ == null ? com.google.protobuf.FieldMask.getDefaultInstance() : readMask_;
   }
 
+  public static final int RETURN_PARTIAL_SUCCESS_FIELD_NUMBER = 9;
+  private boolean returnPartialSuccess_ = false;
+
+  /**
+   *
+   *
+   * 
                                            +   * Optional. Allows listing of buckets, even if there are buckets that are
+   * unreachable.
+   * 
                                            
+   *
+   * bool return_partial_success = 9 [(.google.api.field_behavior) = OPTIONAL];
+   *
+   * @return The returnPartialSuccess.
+   */
+  @java.lang.Override
+  public boolean getReturnPartialSuccess() {
+    return returnPartialSuccess_;
+  }
+
   private byte memoizedIsInitialized = -1;
 
   @java.lang.Override
@@ -341,6 +361,9 @@ public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io
     if (((bitField0_ & 0x00000001) != 0)) {
       output.writeMessage(5, getReadMask());
     }
+    if (returnPartialSuccess_ != false) {
+      output.writeBool(9, returnPartialSuccess_);
+    }
     getUnknownFields().writeTo(output);
   }
 
@@ -365,6 +388,9 @@ public int getSerializedSize() {
     if (((bitField0_ & 0x00000001) != 0)) {
       size += com.google.protobuf.CodedOutputStream.computeMessageSize(5, getReadMask());
     }
+    if (returnPartialSuccess_ != false) {
+      size += com.google.protobuf.CodedOutputStream.computeBoolSize(9, returnPartialSuccess_);
+    }
     size += getUnknownFields().getSerializedSize();
     memoizedSize = size;
     return size;
@@ -388,6 +414,7 @@ public boolean equals(final java.lang.Object obj) {
     if (hasReadMask()) {
       if (!getReadMask().equals(other.getReadMask())) return false;
     }
+    if (getReturnPartialSuccess() != other.getReturnPartialSuccess()) return false;
     if (!getUnknownFields().equals(other.getUnknownFields())) return false;
     return true;
   }
@@ -411,6 +438,8 @@ public int hashCode() {
       hash = (37 * hash) + READ_MASK_FIELD_NUMBER;
       hash = (53 * hash) + getReadMask().hashCode();
     }
+    hash = (37 * hash) + RETURN_PARTIAL_SUCCESS_FIELD_NUMBER;
+    hash = (53 * hash) + com.google.protobuf.Internal.hashBoolean(getReturnPartialSuccess());
     hash = (29 * hash) + getUnknownFields().hashCode();
     memoizedHashCode = hash;
     return hash;
@@ -516,7 +545,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
                                            -   * Request message for ListBuckets.
+   * Request message for [ListBuckets][google.storage.v2.Storage.ListBuckets].
    * 
                                            
    *
    * Protobuf type {@code google.storage.v2.ListBucketsRequest}
@@ -569,6 +598,7 @@ public Builder clear() {
         readMaskBuilder_.dispose();
         readMaskBuilder_ = null;
       }
+      returnPartialSuccess_ = false;
       return this;
     }
 
@@ -622,6 +652,9 @@ private void buildPartial0(com.google.storage.v2.ListBucketsRequest result) {
         result.readMask_ = readMaskBuilder_ == null ? readMask_ : readMaskBuilder_.build();
         to_bitField0_ |= 0x00000001;
       }
+      if (((from_bitField0_ & 0x00000020) != 0)) {
+        result.returnPartialSuccess_ = returnPartialSuccess_;
+      }
       result.bitField0_ |= to_bitField0_;
     }
 
@@ -691,6 +724,9 @@ public Builder mergeFrom(com.google.storage.v2.ListBucketsRequest other) {
       if (other.hasReadMask()) {
         mergeReadMask(other.getReadMask());
       }
+      if (other.getReturnPartialSuccess() != false) {
+        setReturnPartialSuccess(other.getReturnPartialSuccess());
+      }
       this.mergeUnknownFields(other.getUnknownFields());
       onChanged();
       return this;
@@ -747,6 +783,12 @@ public Builder mergeFrom(
                 bitField0_ |= 0x00000010;
                 break;
               } // case 42
+            case 72:
+              {
+                returnPartialSuccess_ = input.readBool();
+                bitField0_ |= 0x00000020;
+                break;
+              } // case 72
             default:
               {
                 if (!super.parseUnknownField(input, extensionRegistry, tag)) {
@@ -894,9 +936,9 @@ public Builder setParentBytes(com.google.protobuf.ByteString value) {
      *
      * 
                                                  * Optional. Maximum number of buckets to return in a single response. The
-     * service will use this parameter or 1,000 items, whichever is smaller. If
-     * "acl" is present in the read_mask, the service will use this parameter of
-     * 200 items, whichever is smaller.
+     * service uses this parameter or `1,000` items, whichever is smaller. If
+     * `acl` is present in the `read_mask`, the service uses this parameter of
+     * `200` items, whichever is smaller.
      * 
                                            
      *
      * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -913,9 +955,9 @@ public int getPageSize() {
      *
      * 
                                                  * Optional. Maximum number of buckets to return in a single response. The
-     * service will use this parameter or 1,000 items, whichever is smaller. If
-     * "acl" is present in the read_mask, the service will use this parameter of
-     * 200 items, whichever is smaller.
+     * service uses this parameter or `1,000` items, whichever is smaller. If
+     * `acl` is present in the `read_mask`, the service uses this parameter of
+     * `200` items, whichever is smaller.
      * 
                                            
      *
      * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -936,9 +978,9 @@ public Builder setPageSize(int value) {
      *
      * 
                                                  * Optional. Maximum number of buckets to return in a single response. The
-     * service will use this parameter or 1,000 items, whichever is smaller. If
-     * "acl" is present in the read_mask, the service will use this parameter of
-     * 200 items, whichever is smaller.
+     * service uses this parameter or `1,000` items, whichever is smaller. If
+     * `acl` is present in the `read_mask`, the service uses this parameter of
+     * `200` items, whichever is smaller.
      * 
                                            
      *
      * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -1191,9 +1233,9 @@ public Builder setPrefixBytes(com.google.protobuf.ByteString value) {
      *
      * 
                                                  * Mask specifying which fields to read from each result.
-     * If no mask is specified, will default to all fields except items.owner,
-     * items.acl, and items.default_object_acl.
-     * * may be used to mean "all fields".
+     * If no mask is specified, it defaults to all fields except `items.
+     * owner`, `items.acl`, and `items.default_object_acl`.
+     * `*` might be used to mean "all fields".
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 5;
@@ -1209,9 +1251,9 @@ public boolean hasReadMask() {
      *
      * 
                                                  * Mask specifying which fields to read from each result.
-     * If no mask is specified, will default to all fields except items.owner,
-     * items.acl, and items.default_object_acl.
-     * * may be used to mean "all fields".
+     * If no mask is specified, it defaults to all fields except `items.
+     * owner`, `items.acl`, and `items.default_object_acl`.
+     * `*` might be used to mean "all fields".
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 5;
@@ -1231,9 +1273,9 @@ public com.google.protobuf.FieldMask getReadMask() {
      *
      * 
                                                  * Mask specifying which fields to read from each result.
-     * If no mask is specified, will default to all fields except items.owner,
-     * items.acl, and items.default_object_acl.
-     * * may be used to mean "all fields".
+     * If no mask is specified, it defaults to all fields except `items.
+     * owner`, `items.acl`, and `items.default_object_acl`.
+     * `*` might be used to mean "all fields".
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 5;
@@ -1257,9 +1299,9 @@ public Builder setReadMask(com.google.protobuf.FieldMask value) {
      *
      * 
                                                  * Mask specifying which fields to read from each result.
-     * If no mask is specified, will default to all fields except items.owner,
-     * items.acl, and items.default_object_acl.
-     * * may be used to mean "all fields".
+     * If no mask is specified, it defaults to all fields except `items.
+     * owner`, `items.acl`, and `items.default_object_acl`.
+     * `*` might be used to mean "all fields".
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 5;
@@ -1280,9 +1322,9 @@ public Builder setReadMask(com.google.protobuf.FieldMask.Builder builderForValue
      *
      * 
                                                  * Mask specifying which fields to read from each result.
-     * If no mask is specified, will default to all fields except items.owner,
-     * items.acl, and items.default_object_acl.
-     * * may be used to mean "all fields".
+     * If no mask is specified, it defaults to all fields except `items.
+     * owner`, `items.acl`, and `items.default_object_acl`.
+     * `*` might be used to mean "all fields".
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 5;
@@ -1311,9 +1353,9 @@ public Builder mergeReadMask(com.google.protobuf.FieldMask value) {
      *
      * 
                                                  * Mask specifying which fields to read from each result.
-     * If no mask is specified, will default to all fields except items.owner,
-     * items.acl, and items.default_object_acl.
-     * * may be used to mean "all fields".
+     * If no mask is specified, it defaults to all fields except `items.
+     * owner`, `items.acl`, and `items.default_object_acl`.
+     * `*` might be used to mean "all fields".
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 5;
@@ -1334,9 +1376,9 @@ public Builder clearReadMask() {
      *
      * 
                                                  * Mask specifying which fields to read from each result.
-     * If no mask is specified, will default to all fields except items.owner,
-     * items.acl, and items.default_object_acl.
-     * * may be used to mean "all fields".
+     * If no mask is specified, it defaults to all fields except `items.
+     * owner`, `items.acl`, and `items.default_object_acl`.
+     * `*` might be used to mean "all fields".
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 5;
@@ -1352,9 +1394,9 @@ public com.google.protobuf.FieldMask.Builder getReadMaskBuilder() {
      *
      * 
                                                  * Mask specifying which fields to read from each result.
-     * If no mask is specified, will default to all fields except items.owner,
-     * items.acl, and items.default_object_acl.
-     * * may be used to mean "all fields".
+     * If no mask is specified, it defaults to all fields except `items.
+     * owner`, `items.acl`, and `items.default_object_acl`.
+     * `*` might be used to mean "all fields".
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 5;
@@ -1372,9 +1414,9 @@ public com.google.protobuf.FieldMaskOrBuilder getReadMaskOrBuilder() {
      *
      * 
                                                  * Mask specifying which fields to read from each result.
-     * If no mask is specified, will default to all fields except items.owner,
-     * items.acl, and items.default_object_acl.
-     * * may be used to mean "all fields".
+     * If no mask is specified, it defaults to all fields except `items.
+     * owner`, `items.acl`, and `items.default_object_acl`.
+     * `*` might be used to mean "all fields".
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 5;
@@ -1396,6 +1438,65 @@ public com.google.protobuf.FieldMaskOrBuilder getReadMaskOrBuilder() {
       return readMaskBuilder_;
     }
 
+    private boolean returnPartialSuccess_;
+
+    /**
+     *
+     *
+     * 
                                            +     * Optional. Allows listing of buckets, even if there are buckets that are
+     * unreachable.
+     * 
                                            
+     *
+     * bool return_partial_success = 9 [(.google.api.field_behavior) = OPTIONAL];
+     *
+     * @return The returnPartialSuccess.
+     */
+    @java.lang.Override
+    public boolean getReturnPartialSuccess() {
+      return returnPartialSuccess_;
+    }
+
+    /**
+     *
+     *
+     * 
                                            +     * Optional. Allows listing of buckets, even if there are buckets that are
+     * unreachable.
+     * 
                                            
+     *
+     * bool return_partial_success = 9 [(.google.api.field_behavior) = OPTIONAL];
+     *
+     * @param value The returnPartialSuccess to set.
+     * @return This builder for chaining.
+     */
+    public Builder setReturnPartialSuccess(boolean value) {
+
+      returnPartialSuccess_ = value;
+      bitField0_ |= 0x00000020;
+      onChanged();
+      return this;
+    }
+
+    /**
+     *
+     *
+     * 
                                            +     * Optional. Allows listing of buckets, even if there are buckets that are
+     * unreachable.
+     * 
                                            
+     *
+     * bool return_partial_success = 9 [(.google.api.field_behavior) = OPTIONAL];
+     *
+     * @return This builder for chaining.
+     */
+    public Builder clearReturnPartialSuccess() {
+      bitField0_ = (bitField0_ & ~0x00000020);
+      returnPartialSuccess_ = false;
+      onChanged();
+      return this;
+    }
+
     @java.lang.Override
     public final Builder setUnknownFields(final com.google.protobuf.UnknownFieldSet unknownFields) {
       return super.setUnknownFields(unknownFields);
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ListBucketsRequestOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ListBucketsRequestOrBuilder.java
index 85afd4ef43..e6e530df58 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ListBucketsRequestOrBuilder.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ListBucketsRequestOrBuilder.java
@@ -59,9 +59,9 @@ public interface ListBucketsRequestOrBuilder
    *
    * 
                                                * Optional. Maximum number of buckets to return in a single response. The
-   * service will use this parameter or 1,000 items, whichever is smaller. If
-   * "acl" is present in the read_mask, the service will use this parameter of
-   * 200 items, whichever is smaller.
+   * service uses this parameter or `1,000` items, whichever is smaller. If
+   * `acl` is present in the `read_mask`, the service uses this parameter of
+   * `200` items, whichever is smaller.
    * 
                                            
    *
    * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -129,9 +129,9 @@ public interface ListBucketsRequestOrBuilder
    *
    * 
                                                * Mask specifying which fields to read from each result.
-   * If no mask is specified, will default to all fields except items.owner,
-   * items.acl, and items.default_object_acl.
-   * * may be used to mean "all fields".
+   * If no mask is specified, it defaults to all fields except `items.
+   * owner`, `items.acl`, and `items.default_object_acl`.
+   * `*` might be used to mean "all fields".
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 5;
@@ -145,9 +145,9 @@ public interface ListBucketsRequestOrBuilder
    *
    * 
                                                * Mask specifying which fields to read from each result.
-   * If no mask is specified, will default to all fields except items.owner,
-   * items.acl, and items.default_object_acl.
-   * * may be used to mean "all fields".
+   * If no mask is specified, it defaults to all fields except `items.
+   * owner`, `items.acl`, and `items.default_object_acl`.
+   * `*` might be used to mean "all fields".
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 5;
@@ -161,12 +161,26 @@ public interface ListBucketsRequestOrBuilder
    *
    * 
                                                * Mask specifying which fields to read from each result.
-   * If no mask is specified, will default to all fields except items.owner,
-   * items.acl, and items.default_object_acl.
-   * * may be used to mean "all fields".
+   * If no mask is specified, it defaults to all fields except `items.
+   * owner`, `items.acl`, and `items.default_object_acl`.
+   * `*` might be used to mean "all fields".
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 5;
    */
   com.google.protobuf.FieldMaskOrBuilder getReadMaskOrBuilder();
+
+  /**
+   *
+   *
+   * 
                                            +   * Optional. Allows listing of buckets, even if there are buckets that are
+   * unreachable.
+   * 
                                            
+   *
+   * bool return_partial_success = 9 [(.google.api.field_behavior) = OPTIONAL];
+   *
+   * @return The returnPartialSuccess.
+   */
+  boolean getReturnPartialSuccess();
 }
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ListBucketsResponse.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ListBucketsResponse.java
index a18c229eb8..f347139e4e 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ListBucketsResponse.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ListBucketsResponse.java
@@ -23,7 +23,7 @@
  *
  *
  * 
                                            - * The result of a call to Buckets.ListBuckets
+ * Response message for [ListBuckets][google.storage.v2.Storage.ListBuckets].
  * 
                                            
  *
  * Protobuf type {@code google.storage.v2.ListBucketsResponse}
@@ -42,6 +42,7 @@ private ListBucketsResponse(com.google.protobuf.GeneratedMessageV3.Builder bu
   private ListBucketsResponse() {
     buckets_ = java.util.Collections.emptyList();
     nextPageToken_ = "";
+    unreachable_ = com.google.protobuf.LazyStringArrayList.emptyList();
   }
 
   @java.lang.Override
@@ -195,6 +196,110 @@ public com.google.protobuf.ByteString getNextPageTokenBytes() {
     }
   }
 
+  public static final int UNREACHABLE_FIELD_NUMBER = 3;
+
+  @SuppressWarnings("serial")
+  private com.google.protobuf.LazyStringArrayList unreachable_ =
+      com.google.protobuf.LazyStringArrayList.emptyList();
+
+  /**
+   *
+   *
+   * 
                                            +   * Unreachable resources.
+   * This field can only be present if the caller specified
+   * return_partial_success to be true in the request to receive indications
+   * of temporarily missing resources.
+   * unreachable might be:
+   * unreachable = [
+   *  "projects/_/buckets/bucket1",
+   *  "projects/_/buckets/bucket2",
+   *  "projects/_/buckets/bucket3",
+   * ]
+   * 
                                            
+   *
+   * repeated string unreachable = 3;
+   *
+   * @return A list containing the unreachable.
+   */
+  public com.google.protobuf.ProtocolStringList getUnreachableList() {
+    return unreachable_;
+  }
+
+  /**
+   *
+   *
+   * 
                                            +   * Unreachable resources.
+   * This field can only be present if the caller specified
+   * return_partial_success to be true in the request to receive indications
+   * of temporarily missing resources.
+   * unreachable might be:
+   * unreachable = [
+   *  "projects/_/buckets/bucket1",
+   *  "projects/_/buckets/bucket2",
+   *  "projects/_/buckets/bucket3",
+   * ]
+   * 
                                            
+   *
+   * repeated string unreachable = 3;
+   *
+   * @return The count of unreachable.
+   */
+  public int getUnreachableCount() {
+    return unreachable_.size();
+  }
+
+  /**
+   *
+   *
+   * 
                                            +   * Unreachable resources.
+   * This field can only be present if the caller specified
+   * return_partial_success to be true in the request to receive indications
+   * of temporarily missing resources.
+   * unreachable might be:
+   * unreachable = [
+   *  "projects/_/buckets/bucket1",
+   *  "projects/_/buckets/bucket2",
+   *  "projects/_/buckets/bucket3",
+   * ]
+   * 
                                            
+   *
+   * repeated string unreachable = 3;
+   *
+   * @param index The index of the element to return.
+   * @return The unreachable at the given index.
+   */
+  public java.lang.String getUnreachable(int index) {
+    return unreachable_.get(index);
+  }
+
+  /**
+   *
+   *
+   * 
                                            +   * Unreachable resources.
+   * This field can only be present if the caller specified
+   * return_partial_success to be true in the request to receive indications
+   * of temporarily missing resources.
+   * unreachable might be:
+   * unreachable = [
+   *  "projects/_/buckets/bucket1",
+   *  "projects/_/buckets/bucket2",
+   *  "projects/_/buckets/bucket3",
+   * ]
+   * 
                                            
+   *
+   * repeated string unreachable = 3;
+   *
+   * @param index The index of the value to return.
+   * @return The bytes of the unreachable at the given index.
+   */
+  public com.google.protobuf.ByteString getUnreachableBytes(int index) {
+    return unreachable_.getByteString(index);
+  }
+
   private byte memoizedIsInitialized = -1;
 
   @java.lang.Override
@@ -215,6 +320,9 @@ public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io
     if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(nextPageToken_)) {
       com.google.protobuf.GeneratedMessageV3.writeString(output, 2, nextPageToken_);
     }
+    for (int i = 0; i < unreachable_.size(); i++) {
+      com.google.protobuf.GeneratedMessageV3.writeString(output, 3, unreachable_.getRaw(i));
+    }
     getUnknownFields().writeTo(output);
   }
 
@@ -230,6 +338,14 @@ public int getSerializedSize() {
     if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(nextPageToken_)) {
       size += com.google.protobuf.GeneratedMessageV3.computeStringSize(2, nextPageToken_);
     }
+    {
+      int dataSize = 0;
+      for (int i = 0; i < unreachable_.size(); i++) {
+        dataSize += computeStringSizeNoTag(unreachable_.getRaw(i));
+      }
+      size += dataSize;
+      size += 1 * getUnreachableList().size();
+    }
     size += getUnknownFields().getSerializedSize();
     memoizedSize = size;
     return size;
@@ -248,6 +364,7 @@ public boolean equals(final java.lang.Object obj) {
 
     if (!getBucketsList().equals(other.getBucketsList())) return false;
     if (!getNextPageToken().equals(other.getNextPageToken())) return false;
+    if (!getUnreachableList().equals(other.getUnreachableList())) return false;
     if (!getUnknownFields().equals(other.getUnknownFields())) return false;
     return true;
   }
@@ -265,6 +382,10 @@ public int hashCode() {
     }
     hash = (37 * hash) + NEXT_PAGE_TOKEN_FIELD_NUMBER;
     hash = (53 * hash) + getNextPageToken().hashCode();
+    if (getUnreachableCount() > 0) {
+      hash = (37 * hash) + UNREACHABLE_FIELD_NUMBER;
+      hash = (53 * hash) + getUnreachableList().hashCode();
+    }
     hash = (29 * hash) + getUnknownFields().hashCode();
     memoizedHashCode = hash;
     return hash;
@@ -370,7 +491,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
                                            -   * The result of a call to Buckets.ListBuckets
+   * Response message for [ListBuckets][google.storage.v2.Storage.ListBuckets].
    * 
                                            
    *
    * Protobuf type {@code google.storage.v2.ListBucketsResponse}
@@ -413,6 +534,7 @@ public Builder clear() {
       }
       bitField0_ = (bitField0_ & ~0x00000001);
       nextPageToken_ = "";
+      unreachable_ = com.google.protobuf.LazyStringArrayList.emptyList();
       return this;
     }
 
@@ -465,6 +587,10 @@ private void buildPartial0(com.google.storage.v2.ListBucketsResponse result) {
       if (((from_bitField0_ & 0x00000002) != 0)) {
         result.nextPageToken_ = nextPageToken_;
       }
+      if (((from_bitField0_ & 0x00000004) != 0)) {
+        unreachable_.makeImmutable();
+        result.unreachable_ = unreachable_;
+      }
     }
 
     @java.lang.Override
@@ -544,6 +670,16 @@ public Builder mergeFrom(com.google.storage.v2.ListBucketsResponse other) {
         bitField0_ |= 0x00000002;
         onChanged();
       }
+      if (!other.unreachable_.isEmpty()) {
+        if (unreachable_.isEmpty()) {
+          unreachable_ = other.unreachable_;
+          bitField0_ |= 0x00000004;
+        } else {
+          ensureUnreachableIsMutable();
+          unreachable_.addAll(other.unreachable_);
+        }
+        onChanged();
+      }
       this.mergeUnknownFields(other.getUnknownFields());
       onChanged();
       return this;
@@ -588,6 +724,13 @@ public Builder mergeFrom(
                 bitField0_ |= 0x00000002;
                 break;
               } // case 18
+            case 26:
+              {
+                java.lang.String s = input.readStringRequireUtf8();
+                ensureUnreachableIsMutable();
+                unreachable_.add(s);
+                break;
+              } // case 26
             default:
               {
                 if (!super.parseUnknownField(input, extensionRegistry, tag)) {
@@ -1085,6 +1228,270 @@ public Builder setNextPageTokenBytes(com.google.protobuf.ByteString value) {
       return this;
     }
 
+    private com.google.protobuf.LazyStringArrayList unreachable_ =
+        com.google.protobuf.LazyStringArrayList.emptyList();
+
+    private void ensureUnreachableIsMutable() {
+      if (!unreachable_.isModifiable()) {
+        unreachable_ = new com.google.protobuf.LazyStringArrayList(unreachable_);
+      }
+      bitField0_ |= 0x00000004;
+    }
+
+    /**
+     *
+     *
+     * 
                                            +     * Unreachable resources.
+     * This field can only be present if the caller specified
+     * return_partial_success to be true in the request to receive indications
+     * of temporarily missing resources.
+     * unreachable might be:
+     * unreachable = [
+     *  "projects/_/buckets/bucket1",
+     *  "projects/_/buckets/bucket2",
+     *  "projects/_/buckets/bucket3",
+     * ]
+     * 
                                            
+     *
+     * repeated string unreachable = 3;
+     *
+     * @return A list containing the unreachable.
+     */
+    public com.google.protobuf.ProtocolStringList getUnreachableList() {
+      unreachable_.makeImmutable();
+      return unreachable_;
+    }
+
+    /**
+     *
+     *
+     * 
                                            +     * Unreachable resources.
+     * This field can only be present if the caller specified
+     * return_partial_success to be true in the request to receive indications
+     * of temporarily missing resources.
+     * unreachable might be:
+     * unreachable = [
+     *  "projects/_/buckets/bucket1",
+     *  "projects/_/buckets/bucket2",
+     *  "projects/_/buckets/bucket3",
+     * ]
+     * 
                                            
+     *
+     * repeated string unreachable = 3;
+     *
+     * @return The count of unreachable.
+     */
+    public int getUnreachableCount() {
+      return unreachable_.size();
+    }
+
+    /**
+     *
+     *
+     * 
                                            +     * Unreachable resources.
+     * This field can only be present if the caller specified
+     * return_partial_success to be true in the request to receive indications
+     * of temporarily missing resources.
+     * unreachable might be:
+     * unreachable = [
+     *  "projects/_/buckets/bucket1",
+     *  "projects/_/buckets/bucket2",
+     *  "projects/_/buckets/bucket3",
+     * ]
+     * 
                                            
+     *
+     * repeated string unreachable = 3;
+     *
+     * @param index The index of the element to return.
+     * @return The unreachable at the given index.
+     */
+    public java.lang.String getUnreachable(int index) {
+      return unreachable_.get(index);
+    }
+
+    /**
+     *
+     *
+     * 
                                            +     * Unreachable resources.
+     * This field can only be present if the caller specified
+     * return_partial_success to be true in the request to receive indications
+     * of temporarily missing resources.
+     * unreachable might be:
+     * unreachable = [
+     *  "projects/_/buckets/bucket1",
+     *  "projects/_/buckets/bucket2",
+     *  "projects/_/buckets/bucket3",
+     * ]
+     * 
                                            
+     *
+     * repeated string unreachable = 3;
+     *
+     * @param index The index of the value to return.
+     * @return The bytes of the unreachable at the given index.
+     */
+    public com.google.protobuf.ByteString getUnreachableBytes(int index) {
+      return unreachable_.getByteString(index);
+    }
+
+    /**
+     *
+     *
+     * 
                                            +     * Unreachable resources.
+     * This field can only be present if the caller specified
+     * return_partial_success to be true in the request to receive indications
+     * of temporarily missing resources.
+     * unreachable might be:
+     * unreachable = [
+     *  "projects/_/buckets/bucket1",
+     *  "projects/_/buckets/bucket2",
+     *  "projects/_/buckets/bucket3",
+     * ]
+     * 
                                            
+     *
+     * repeated string unreachable = 3;
+     *
+     * @param index The index to set the value at.
+     * @param value The unreachable to set.
+     * @return This builder for chaining.
+     */
+    public Builder setUnreachable(int index, java.lang.String value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+      ensureUnreachableIsMutable();
+      unreachable_.set(index, value);
+      bitField0_ |= 0x00000004;
+      onChanged();
+      return this;
+    }
+
+    /**
+     *
+     *
+     * 
                                            +     * Unreachable resources.
+     * This field can only be present if the caller specified
+     * return_partial_success to be true in the request to receive indications
+     * of temporarily missing resources.
+     * unreachable might be:
+     * unreachable = [
+     *  "projects/_/buckets/bucket1",
+     *  "projects/_/buckets/bucket2",
+     *  "projects/_/buckets/bucket3",
+     * ]
+     * 
                                            
+     *
+     * repeated string unreachable = 3;
+     *
+     * @param value The unreachable to add.
+     * @return This builder for chaining.
+     */
+    public Builder addUnreachable(java.lang.String value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+      ensureUnreachableIsMutable();
+      unreachable_.add(value);
+      bitField0_ |= 0x00000004;
+      onChanged();
+      return this;
+    }
+
+    /**
+     *
+     *
+     * 
                                            +     * Unreachable resources.
+     * This field can only be present if the caller specified
+     * return_partial_success to be true in the request to receive indications
+     * of temporarily missing resources.
+     * unreachable might be:
+     * unreachable = [
+     *  "projects/_/buckets/bucket1",
+     *  "projects/_/buckets/bucket2",
+     *  "projects/_/buckets/bucket3",
+     * ]
+     * 
                                            
+     *
+     * repeated string unreachable = 3;
+     *
+     * @param values The unreachable to add.
+     * @return This builder for chaining.
+     */
+    public Builder addAllUnreachable(java.lang.Iterable values) {
+      ensureUnreachableIsMutable();
+      com.google.protobuf.AbstractMessageLite.Builder.addAll(values, unreachable_);
+      bitField0_ |= 0x00000004;
+      onChanged();
+      return this;
+    }
+
+    /**
+     *
+     *
+     * 
                                            +     * Unreachable resources.
+     * This field can only be present if the caller specified
+     * return_partial_success to be true in the request to receive indications
+     * of temporarily missing resources.
+     * unreachable might be:
+     * unreachable = [
+     *  "projects/_/buckets/bucket1",
+     *  "projects/_/buckets/bucket2",
+     *  "projects/_/buckets/bucket3",
+     * ]
+     * 
                                            
+     *
+     * repeated string unreachable = 3;
+     *
+     * @return This builder for chaining.
+     */
+    public Builder clearUnreachable() {
+      unreachable_ = com.google.protobuf.LazyStringArrayList.emptyList();
+      bitField0_ = (bitField0_ & ~0x00000004);
+      ;
+      onChanged();
+      return this;
+    }
+
+    /**
+     *
+     *
+     * 
                                            +     * Unreachable resources.
+     * This field can only be present if the caller specified
+     * return_partial_success to be true in the request to receive indications
+     * of temporarily missing resources.
+     * unreachable might be:
+     * unreachable = [
+     *  "projects/_/buckets/bucket1",
+     *  "projects/_/buckets/bucket2",
+     *  "projects/_/buckets/bucket3",
+     * ]
+     * 
                                            
+     *
+     * repeated string unreachable = 3;
+     *
+     * @param value The bytes of the unreachable to add.
+     * @return This builder for chaining.
+     */
+    public Builder addUnreachableBytes(com.google.protobuf.ByteString value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+      checkByteStringIsUtf8(value);
+      ensureUnreachableIsMutable();
+      unreachable_.add(value);
+      bitField0_ |= 0x00000004;
+      onChanged();
+      return this;
+    }
+
     @java.lang.Override
     public final Builder setUnknownFields(final com.google.protobuf.UnknownFieldSet unknownFields) {
       return super.setUnknownFields(unknownFields);
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ListBucketsResponseOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ListBucketsResponseOrBuilder.java
index 5746479f08..eed2d224d7 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ListBucketsResponseOrBuilder.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ListBucketsResponseOrBuilder.java
@@ -106,4 +106,94 @@ public interface ListBucketsResponseOrBuilder
    * @return The bytes for nextPageToken.
    */
   com.google.protobuf.ByteString getNextPageTokenBytes();
+
+  /**
+   *
+   *
+   * 
                                            +   * Unreachable resources.
+   * This field can only be present if the caller specified
+   * return_partial_success to be true in the request to receive indications
+   * of temporarily missing resources.
+   * unreachable might be:
+   * unreachable = [
+   *  "projects/_/buckets/bucket1",
+   *  "projects/_/buckets/bucket2",
+   *  "projects/_/buckets/bucket3",
+   * ]
+   * 
                                            
+   *
+   * repeated string unreachable = 3;
+   *
+   * @return A list containing the unreachable.
+   */
+  java.util.List getUnreachableList();
+
+  /**
+   *
+   *
+   * 
                                            +   * Unreachable resources.
+   * This field can only be present if the caller specified
+   * return_partial_success to be true in the request to receive indications
+   * of temporarily missing resources.
+   * unreachable might be:
+   * unreachable = [
+   *  "projects/_/buckets/bucket1",
+   *  "projects/_/buckets/bucket2",
+   *  "projects/_/buckets/bucket3",
+   * ]
+   * 
                                            
+   *
+   * repeated string unreachable = 3;
+   *
+   * @return The count of unreachable.
+   */
+  int getUnreachableCount();
+
+  /**
+   *
+   *
+   * 
                                            +   * Unreachable resources.
+   * This field can only be present if the caller specified
+   * return_partial_success to be true in the request to receive indications
+   * of temporarily missing resources.
+   * unreachable might be:
+   * unreachable = [
+   *  "projects/_/buckets/bucket1",
+   *  "projects/_/buckets/bucket2",
+   *  "projects/_/buckets/bucket3",
+   * ]
+   * 
                                            
+   *
+   * repeated string unreachable = 3;
+   *
+   * @param index The index of the element to return.
+   * @return The unreachable at the given index.
+   */
+  java.lang.String getUnreachable(int index);
+
+  /**
+   *
+   *
+   * 
                                            +   * Unreachable resources.
+   * This field can only be present if the caller specified
+   * return_partial_success to be true in the request to receive indications
+   * of temporarily missing resources.
+   * unreachable might be:
+   * unreachable = [
+   *  "projects/_/buckets/bucket1",
+   *  "projects/_/buckets/bucket2",
+   *  "projects/_/buckets/bucket3",
+   * ]
+   * 
                                            
+   *
+   * repeated string unreachable = 3;
+   *
+   * @param index The index of the value to return.
+   * @return The bytes of the unreachable at the given index.
+   */
+  com.google.protobuf.ByteString getUnreachableBytes(int index);
 }
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ListObjectsRequest.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ListObjectsRequest.java
index cec4a76d0a..a01df7f8f2 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ListObjectsRequest.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ListObjectsRequest.java
@@ -23,7 +23,7 @@
  *
  *
  * 
                                            - * Request message for ListObjects.
+ * Request message for [ListObjects][google.storage.v2.Storage.ListObjects].
  * 
                                            
  *
  * Protobuf type {@code google.storage.v2.ListObjectsRequest}
@@ -138,8 +138,8 @@ public com.google.protobuf.ByteString getParentBytes() {
    * 
                                                * Optional. Maximum number of `items` plus `prefixes` to return
    * in a single page of responses. As duplicate `prefixes` are
-   * omitted, fewer total results may be returned than requested. The service
-   * will use this parameter or 1,000 items, whichever is smaller.
+   * omitted, fewer total results might be returned than requested. The service
+   * uses this parameter or 1,000 items, whichever is smaller.
    * 
                                            
    *
    * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -215,11 +215,11 @@ public com.google.protobuf.ByteString getPageTokenBytes() {
    *
    *
    * 
                                            -   * Optional. If set, returns results in a directory-like mode. `items` will
-   * contain only objects whose names, aside from the `prefix`, do not contain
+   * Optional. If set, returns results in a directory-like mode. `items`
+   * contains only objects whose names, aside from the `prefix`, do not contain
    * `delimiter`. Objects whose names, aside from the `prefix`, contain
-   * `delimiter` will have their name, truncated after the `delimiter`, returned
-   * in `prefixes`. Duplicate `prefixes` are omitted.
+   * `delimiter` has their name, truncated after the `delimiter`, returned in
+   * `prefixes`. Duplicate `prefixes` are omitted.
    * 
                                            
    *
    * string delimiter = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -243,11 +243,11 @@ public java.lang.String getDelimiter() {
    *
    *
    * 
                                            -   * Optional. If set, returns results in a directory-like mode. `items` will
-   * contain only objects whose names, aside from the `prefix`, do not contain
+   * Optional. If set, returns results in a directory-like mode. `items`
+   * contains only objects whose names, aside from the `prefix`, do not contain
    * `delimiter`. Objects whose names, aside from the `prefix`, contain
-   * `delimiter` will have their name, truncated after the `delimiter`, returned
-   * in `prefixes`. Duplicate `prefixes` are omitted.
+   * `delimiter` has their name, truncated after the `delimiter`, returned in
+   * `prefixes`. Duplicate `prefixes` are omitted.
    * 
                                            
    *
    * string delimiter = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -275,7 +275,7 @@ public com.google.protobuf.ByteString getDelimiterBytes() {
    *
    * 
                                                * Optional. If true, objects that end in exactly one instance of `delimiter`
-   * will have their metadata included in `items` in addition to
+   * has their metadata included in `items` in addition to
    * `prefixes`.
    * 
                                            
    *
@@ -349,9 +349,6 @@ public com.google.protobuf.ByteString getPrefixBytes() {
    *
    * 
                                                * Optional. If `true`, lists all versions of an object as distinct results.
-   * For more information, see
-   * [Object
-   * Versioning](https://cloud.google.com/storage/docs/object-versioning).
    * 
                                            
    *
    * bool versions = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -371,9 +368,9 @@ public boolean getVersions() {
    *
    * 
                                                * Mask specifying which fields to read from each result.
-   * If no mask is specified, will default to all fields except items.acl and
-   * items.owner.
-   * * may be used to mean "all fields".
+   * If no mask is specified, defaults to all fields except `items.acl` and
+   * `items.owner`.
+   * `*` might be used to mean all fields.
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 8;
@@ -390,9 +387,9 @@ public boolean hasReadMask() {
    *
    * 
                                                * Mask specifying which fields to read from each result.
-   * If no mask is specified, will default to all fields except items.acl and
-   * items.owner.
-   * * may be used to mean "all fields".
+   * If no mask is specified, defaults to all fields except `items.acl` and
+   * `items.owner`.
+   * `*` might be used to mean all fields.
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 8;
@@ -409,9 +406,9 @@ public com.google.protobuf.FieldMask getReadMask() {
    *
    * 
                                                * Mask specifying which fields to read from each result.
-   * If no mask is specified, will default to all fields except items.acl and
-   * items.owner.
-   * * may be used to mean "all fields".
+   * If no mask is specified, defaults to all fields except `items.acl` and
+   * `items.owner`.
+   * `*` might be used to mean all fields.
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 8;
@@ -431,9 +428,9 @@ public com.google.protobuf.FieldMaskOrBuilder getReadMaskOrBuilder() {
    *
    * 
                                                * Optional. Filter results to objects whose names are lexicographically equal
-   * to or after lexicographic_start. If lexicographic_end is also set, the
-   * objects listed have names between lexicographic_start (inclusive) and
-   * lexicographic_end (exclusive).
+   * to or after `lexicographic_start`. If `lexicographic_end` is also set, the
+   * objects listed have names between `lexicographic_start` (inclusive) and
+   * `lexicographic_end` (exclusive).
    * 
                                            
    *
    * string lexicographic_start = 10 [(.google.api.field_behavior) = OPTIONAL];
@@ -458,9 +455,9 @@ public java.lang.String getLexicographicStart() {
    *
    * 
                                                * Optional. Filter results to objects whose names are lexicographically equal
-   * to or after lexicographic_start. If lexicographic_end is also set, the
-   * objects listed have names between lexicographic_start (inclusive) and
-   * lexicographic_end (exclusive).
+   * to or after `lexicographic_start`. If `lexicographic_end` is also set, the
+   * objects listed have names between `lexicographic_start` (inclusive) and
+   * `lexicographic_end` (exclusive).
    * 
                                            
    *
    * string lexicographic_start = 10 [(.google.api.field_behavior) = OPTIONAL];
@@ -490,9 +487,9 @@ public com.google.protobuf.ByteString getLexicographicStartBytes() {
    *
    * 
                                                * Optional. Filter results to objects whose names are lexicographically
-   * before lexicographic_end. If lexicographic_start is also set, the objects
-   * listed have names between lexicographic_start (inclusive) and
-   * lexicographic_end (exclusive).
+   * before `lexicographic_end`. If `lexicographic_start` is also set, the
+   * objects listed have names between `lexicographic_start` (inclusive) and
+   * `lexicographic_end` (exclusive).
    * 
                                            
    *
    * string lexicographic_end = 11 [(.google.api.field_behavior) = OPTIONAL];
@@ -517,9 +514,9 @@ public java.lang.String getLexicographicEnd() {
    *
    * 
                                                * Optional. Filter results to objects whose names are lexicographically
-   * before lexicographic_end. If lexicographic_start is also set, the objects
-   * listed have names between lexicographic_start (inclusive) and
-   * lexicographic_end (exclusive).
+   * before `lexicographic_end`. If `lexicographic_start` is also set, the
+   * objects listed have names between `lexicographic_start` (inclusive) and
+   * `lexicographic_end` (exclusive).
    * 
                                            
    *
    * string lexicographic_end = 11 [(.google.api.field_behavior) = OPTIONAL];
@@ -566,8 +563,8 @@ public boolean getSoftDeleted() {
    *
    *
    * 
                                            -   * Optional. If true, will also include folders and managed folders (besides
-   * objects) in the returned `prefixes`. Requires `delimiter` to be set to '/'.
+   * Optional. If true, includes folders and managed folders (besides objects)
+   * in the returned `prefixes`. Requires `delimiter` to be set to '/'.
    * 
                                            
    *
    * bool include_folders_as_prefixes = 13 [(.google.api.field_behavior) = OPTIONAL];
@@ -589,8 +586,8 @@ public boolean getIncludeFoldersAsPrefixes() {
    *
    * 
                                                * Optional. Filter results to objects and prefixes that match this glob
-   * pattern. See [List Objects Using
-   * Glob](https://cloud.google.com/storage/docs/json_api/v1/objects/list#list-objects-and-prefixes-using-glob)
+   * pattern. See [List objects using
+   * glob](https://cloud.google.com/storage/docs/json_api/v1/objects/list#list-objects-and-prefixes-using-glob)
    * for the full syntax.
    * 
                                            
    *
@@ -616,8 +613,8 @@ public java.lang.String getMatchGlob() {
    *
    * 
                                                * Optional. Filter results to objects and prefixes that match this glob
-   * pattern. See [List Objects Using
-   * Glob](https://cloud.google.com/storage/docs/json_api/v1/objects/list#list-objects-and-prefixes-using-glob)
+   * pattern. See [List objects using
+   * glob](https://cloud.google.com/storage/docs/json_api/v1/objects/list#list-objects-and-prefixes-using-glob)
    * for the full syntax.
    * 
                                            
    *
@@ -647,9 +644,11 @@ public com.google.protobuf.ByteString getMatchGlobBytes() {
    *
    *
    * 
                                            -   * Optional. Filter the returned objects. Currently only supported for the
-   * `contexts` field. If `delimiter` is set, the returned `prefixes` are exempt
-   * from this filter.
+   * Optional. An expression used to filter the returned objects by the
+   * `context` field. For the full syntax, see [Filter objects by contexts
+   * syntax](https://cloud.google.com/storage/docs/listing-objects#filter-by-object-contexts-syntax).
+   * If a `delimiter` is set, the returned `prefixes` are exempt from this
+   * filter.
    * 
                                            
    *
    * string filter = 15 [(.google.api.field_behavior) = OPTIONAL];
@@ -673,9 +672,11 @@ public java.lang.String getFilter() {
    *
    *
    * 
                                            -   * Optional. Filter the returned objects. Currently only supported for the
-   * `contexts` field. If `delimiter` is set, the returned `prefixes` are exempt
-   * from this filter.
+   * Optional. An expression used to filter the returned objects by the
+   * `context` field. For the full syntax, see [Filter objects by contexts
+   * syntax](https://cloud.google.com/storage/docs/listing-objects#filter-by-object-contexts-syntax).
+   * If a `delimiter` is set, the returned `prefixes` are exempt from this
+   * filter.
    * 
                                            
    *
    * string filter = 15 [(.google.api.field_behavior) = OPTIONAL];
@@ -980,7 +981,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
                                            -   * Request message for ListObjects.
+   * Request message for [ListObjects][google.storage.v2.Storage.ListObjects].
    * 
                                            
    *
    * Protobuf type {@code google.storage.v2.ListObjectsRequest}
@@ -1486,8 +1487,8 @@ public Builder setParentBytes(com.google.protobuf.ByteString value) {
      * 
                                                  * Optional. Maximum number of `items` plus `prefixes` to return
      * in a single page of responses. As duplicate `prefixes` are
-     * omitted, fewer total results may be returned than requested. The service
-     * will use this parameter or 1,000 items, whichever is smaller.
+     * omitted, fewer total results might be returned than requested. The service
+     * uses this parameter or 1,000 items, whichever is smaller.
      * 
                                            
      *
      * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -1505,8 +1506,8 @@ public int getPageSize() {
      * 
                                                  * Optional. Maximum number of `items` plus `prefixes` to return
      * in a single page of responses. As duplicate `prefixes` are
-     * omitted, fewer total results may be returned than requested. The service
-     * will use this parameter or 1,000 items, whichever is smaller.
+     * omitted, fewer total results might be returned than requested. The service
+     * uses this parameter or 1,000 items, whichever is smaller.
      * 
                                            
      *
      * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -1528,8 +1529,8 @@ public Builder setPageSize(int value) {
      * 
                                                  * Optional. Maximum number of `items` plus `prefixes` to return
      * in a single page of responses. As duplicate `prefixes` are
-     * omitted, fewer total results may be returned than requested. The service
-     * will use this parameter or 1,000 items, whichever is smaller.
+     * omitted, fewer total results might be returned than requested. The service
+     * uses this parameter or 1,000 items, whichever is smaller.
      * 
                                            
      *
      * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -1665,11 +1666,11 @@ public Builder setPageTokenBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
                                            -     * Optional. If set, returns results in a directory-like mode. `items` will
-     * contain only objects whose names, aside from the `prefix`, do not contain
+     * Optional. If set, returns results in a directory-like mode. `items`
+     * contains only objects whose names, aside from the `prefix`, do not contain
      * `delimiter`. Objects whose names, aside from the `prefix`, contain
-     * `delimiter` will have their name, truncated after the `delimiter`, returned
-     * in `prefixes`. Duplicate `prefixes` are omitted.
+     * `delimiter` has their name, truncated after the `delimiter`, returned in
+     * `prefixes`. Duplicate `prefixes` are omitted.
      * 
                                            
      *
      * string delimiter = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -1692,11 +1693,11 @@ public java.lang.String getDelimiter() {
      *
      *
      * 
                                            -     * Optional. If set, returns results in a directory-like mode. `items` will
-     * contain only objects whose names, aside from the `prefix`, do not contain
+     * Optional. If set, returns results in a directory-like mode. `items`
+     * contains only objects whose names, aside from the `prefix`, do not contain
      * `delimiter`. Objects whose names, aside from the `prefix`, contain
-     * `delimiter` will have their name, truncated after the `delimiter`, returned
-     * in `prefixes`. Duplicate `prefixes` are omitted.
+     * `delimiter` has their name, truncated after the `delimiter`, returned in
+     * `prefixes`. Duplicate `prefixes` are omitted.
      * 
                                            
      *
      * string delimiter = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -1719,11 +1720,11 @@ public com.google.protobuf.ByteString getDelimiterBytes() {
      *
      *
      * 
                                            -     * Optional. If set, returns results in a directory-like mode. `items` will
-     * contain only objects whose names, aside from the `prefix`, do not contain
+     * Optional. If set, returns results in a directory-like mode. `items`
+     * contains only objects whose names, aside from the `prefix`, do not contain
      * `delimiter`. Objects whose names, aside from the `prefix`, contain
-     * `delimiter` will have their name, truncated after the `delimiter`, returned
-     * in `prefixes`. Duplicate `prefixes` are omitted.
+     * `delimiter` has their name, truncated after the `delimiter`, returned in
+     * `prefixes`. Duplicate `prefixes` are omitted.
      * 
                                            
      *
      * string delimiter = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -1745,11 +1746,11 @@ public Builder setDelimiter(java.lang.String value) {
      *
      *
      * 
                                            -     * Optional. If set, returns results in a directory-like mode. `items` will
-     * contain only objects whose names, aside from the `prefix`, do not contain
+     * Optional. If set, returns results in a directory-like mode. `items`
+     * contains only objects whose names, aside from the `prefix`, do not contain
      * `delimiter`. Objects whose names, aside from the `prefix`, contain
-     * `delimiter` will have their name, truncated after the `delimiter`, returned
-     * in `prefixes`. Duplicate `prefixes` are omitted.
+     * `delimiter` has their name, truncated after the `delimiter`, returned in
+     * `prefixes`. Duplicate `prefixes` are omitted.
      * 
                                            
      *
      * string delimiter = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -1767,11 +1768,11 @@ public Builder clearDelimiter() {
      *
      *
      * 
                                            -     * Optional. If set, returns results in a directory-like mode. `items` will
-     * contain only objects whose names, aside from the `prefix`, do not contain
+     * Optional. If set, returns results in a directory-like mode. `items`
+     * contains only objects whose names, aside from the `prefix`, do not contain
      * `delimiter`. Objects whose names, aside from the `prefix`, contain
-     * `delimiter` will have their name, truncated after the `delimiter`, returned
-     * in `prefixes`. Duplicate `prefixes` are omitted.
+     * `delimiter` has their name, truncated after the `delimiter`, returned in
+     * `prefixes`. Duplicate `prefixes` are omitted.
      * 
                                            
      *
      * string delimiter = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -1797,7 +1798,7 @@ public Builder setDelimiterBytes(com.google.protobuf.ByteString value) {
      *
      * 
                                                  * Optional. If true, objects that end in exactly one instance of `delimiter`
-     * will have their metadata included in `items` in addition to
+     * has their metadata included in `items` in addition to
      * `prefixes`.
      * 
                                            
      *
@@ -1815,7 +1816,7 @@ public boolean getIncludeTrailingDelimiter() {
      *
      * 
                                                  * Optional. If true, objects that end in exactly one instance of `delimiter`
-     * will have their metadata included in `items` in addition to
+     * has their metadata included in `items` in addition to
      * `prefixes`.
      * 
                                            
      *
@@ -1837,7 +1838,7 @@ public Builder setIncludeTrailingDelimiter(boolean value) {
      *
      * 
                                                  * Optional. If true, objects that end in exactly one instance of `delimiter`
-     * will have their metadata included in `items` in addition to
+     * has their metadata included in `items` in addition to
      * `prefixes`.
      * 
                                            
      *
@@ -1970,9 +1971,6 @@ public Builder setPrefixBytes(com.google.protobuf.ByteString value) {
      *
      * 
                                                  * Optional. If `true`, lists all versions of an object as distinct results.
-     * For more information, see
-     * [Object
-     * Versioning](https://cloud.google.com/storage/docs/object-versioning).
      * 
                                            
      *
      * bool versions = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -1989,9 +1987,6 @@ public boolean getVersions() {
      *
      * 
                                                  * Optional. If `true`, lists all versions of an object as distinct results.
-     * For more information, see
-     * [Object
-     * Versioning](https://cloud.google.com/storage/docs/object-versioning).
      * 
                                            
      *
      * bool versions = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -2012,9 +2007,6 @@ public Builder setVersions(boolean value) {
      *
      * 
                                                  * Optional. If `true`, lists all versions of an object as distinct results.
-     * For more information, see
-     * [Object
-     * Versioning](https://cloud.google.com/storage/docs/object-versioning).
      * 
                                            
      *
      * bool versions = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -2040,9 +2032,9 @@ public Builder clearVersions() {
      *
      * 
                                                  * Mask specifying which fields to read from each result.
-     * If no mask is specified, will default to all fields except items.acl and
-     * items.owner.
-     * * may be used to mean "all fields".
+     * If no mask is specified, defaults to all fields except `items.acl` and
+     * `items.owner`.
+     * `*` might be used to mean all fields.
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 8;
@@ -2058,9 +2050,9 @@ public boolean hasReadMask() {
      *
      * 
                                                  * Mask specifying which fields to read from each result.
-     * If no mask is specified, will default to all fields except items.acl and
-     * items.owner.
-     * * may be used to mean "all fields".
+     * If no mask is specified, defaults to all fields except `items.acl` and
+     * `items.owner`.
+     * `*` might be used to mean all fields.
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 8;
@@ -2080,9 +2072,9 @@ public com.google.protobuf.FieldMask getReadMask() {
      *
      * 
                                                  * Mask specifying which fields to read from each result.
-     * If no mask is specified, will default to all fields except items.acl and
-     * items.owner.
-     * * may be used to mean "all fields".
+     * If no mask is specified, defaults to all fields except `items.acl` and
+     * `items.owner`.
+     * `*` might be used to mean all fields.
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 8;
@@ -2106,9 +2098,9 @@ public Builder setReadMask(com.google.protobuf.FieldMask value) {
      *
      * 
                                                  * Mask specifying which fields to read from each result.
-     * If no mask is specified, will default to all fields except items.acl and
-     * items.owner.
-     * * may be used to mean "all fields".
+     * If no mask is specified, defaults to all fields except `items.acl` and
+     * `items.owner`.
+     * `*` might be used to mean all fields.
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 8;
@@ -2129,9 +2121,9 @@ public Builder setReadMask(com.google.protobuf.FieldMask.Builder builderForValue
      *
      * 
                                                  * Mask specifying which fields to read from each result.
-     * If no mask is specified, will default to all fields except items.acl and
-     * items.owner.
-     * * may be used to mean "all fields".
+     * If no mask is specified, defaults to all fields except `items.acl` and
+     * `items.owner`.
+     * `*` might be used to mean all fields.
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 8;
@@ -2160,9 +2152,9 @@ public Builder mergeReadMask(com.google.protobuf.FieldMask value) {
      *
      * 
                                                  * Mask specifying which fields to read from each result.
-     * If no mask is specified, will default to all fields except items.acl and
-     * items.owner.
-     * * may be used to mean "all fields".
+     * If no mask is specified, defaults to all fields except `items.acl` and
+     * `items.owner`.
+     * `*` might be used to mean all fields.
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 8;
@@ -2183,9 +2175,9 @@ public Builder clearReadMask() {
      *
      * 
                                                  * Mask specifying which fields to read from each result.
-     * If no mask is specified, will default to all fields except items.acl and
-     * items.owner.
-     * * may be used to mean "all fields".
+     * If no mask is specified, defaults to all fields except `items.acl` and
+     * `items.owner`.
+     * `*` might be used to mean all fields.
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 8;
@@ -2201,9 +2193,9 @@ public com.google.protobuf.FieldMask.Builder getReadMaskBuilder() {
      *
      * 
                                                  * Mask specifying which fields to read from each result.
-     * If no mask is specified, will default to all fields except items.acl and
-     * items.owner.
-     * * may be used to mean "all fields".
+     * If no mask is specified, defaults to all fields except `items.acl` and
+     * `items.owner`.
+     * `*` might be used to mean all fields.
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 8;
@@ -2221,9 +2213,9 @@ public com.google.protobuf.FieldMaskOrBuilder getReadMaskOrBuilder() {
      *
      * 
                                                  * Mask specifying which fields to read from each result.
-     * If no mask is specified, will default to all fields except items.acl and
-     * items.owner.
-     * * may be used to mean "all fields".
+     * If no mask is specified, defaults to all fields except `items.acl` and
+     * `items.owner`.
+     * `*` might be used to mean all fields.
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 8;
@@ -2252,9 +2244,9 @@ public com.google.protobuf.FieldMaskOrBuilder getReadMaskOrBuilder() {
      *
      * 
                                                  * Optional. Filter results to objects whose names are lexicographically equal
-     * to or after lexicographic_start. If lexicographic_end is also set, the
-     * objects listed have names between lexicographic_start (inclusive) and
-     * lexicographic_end (exclusive).
+     * to or after `lexicographic_start`. If `lexicographic_end` is also set, the
+     * objects listed have names between `lexicographic_start` (inclusive) and
+     * `lexicographic_end` (exclusive).
      * 
                                            
      *
      * string lexicographic_start = 10 [(.google.api.field_behavior) = OPTIONAL];
@@ -2278,9 +2270,9 @@ public java.lang.String getLexicographicStart() {
      *
      * 
                                                  * Optional. Filter results to objects whose names are lexicographically equal
-     * to or after lexicographic_start. If lexicographic_end is also set, the
-     * objects listed have names between lexicographic_start (inclusive) and
-     * lexicographic_end (exclusive).
+     * to or after `lexicographic_start`. If `lexicographic_end` is also set, the
+     * objects listed have names between `lexicographic_start` (inclusive) and
+     * `lexicographic_end` (exclusive).
      * 
                                            
      *
      * string lexicographic_start = 10 [(.google.api.field_behavior) = OPTIONAL];
@@ -2304,9 +2296,9 @@ public com.google.protobuf.ByteString getLexicographicStartBytes() {
      *
      * 
                                                  * Optional. Filter results to objects whose names are lexicographically equal
-     * to or after lexicographic_start. If lexicographic_end is also set, the
-     * objects listed have names between lexicographic_start (inclusive) and
-     * lexicographic_end (exclusive).
+     * to or after `lexicographic_start`. If `lexicographic_end` is also set, the
+     * objects listed have names between `lexicographic_start` (inclusive) and
+     * `lexicographic_end` (exclusive).
      * 
                                            
      *
      * string lexicographic_start = 10 [(.google.api.field_behavior) = OPTIONAL];
@@ -2329,9 +2321,9 @@ public Builder setLexicographicStart(java.lang.String value) {
      *
      * 
                                                  * Optional. Filter results to objects whose names are lexicographically equal
-     * to or after lexicographic_start. If lexicographic_end is also set, the
-     * objects listed have names between lexicographic_start (inclusive) and
-     * lexicographic_end (exclusive).
+     * to or after `lexicographic_start`. If `lexicographic_end` is also set, the
+     * objects listed have names between `lexicographic_start` (inclusive) and
+     * `lexicographic_end` (exclusive).
      * 
                                            
      *
      * string lexicographic_start = 10 [(.google.api.field_behavior) = OPTIONAL];
@@ -2350,9 +2342,9 @@ public Builder clearLexicographicStart() {
      *
      * 
                                                  * Optional. Filter results to objects whose names are lexicographically equal
-     * to or after lexicographic_start. If lexicographic_end is also set, the
-     * objects listed have names between lexicographic_start (inclusive) and
-     * lexicographic_end (exclusive).
+     * to or after `lexicographic_start`. If `lexicographic_end` is also set, the
+     * objects listed have names between `lexicographic_start` (inclusive) and
+     * `lexicographic_end` (exclusive).
      * 
                                            
      *
      * string lexicographic_start = 10 [(.google.api.field_behavior) = OPTIONAL];
@@ -2378,9 +2370,9 @@ public Builder setLexicographicStartBytes(com.google.protobuf.ByteString value)
      *
      * 
                                                  * Optional. Filter results to objects whose names are lexicographically
-     * before lexicographic_end. If lexicographic_start is also set, the objects
-     * listed have names between lexicographic_start (inclusive) and
-     * lexicographic_end (exclusive).
+     * before `lexicographic_end`. If `lexicographic_start` is also set, the
+     * objects listed have names between `lexicographic_start` (inclusive) and
+     * `lexicographic_end` (exclusive).
      * 
                                            
      *
      * string lexicographic_end = 11 [(.google.api.field_behavior) = OPTIONAL];
@@ -2404,9 +2396,9 @@ public java.lang.String getLexicographicEnd() {
      *
      * 
                                                  * Optional. Filter results to objects whose names are lexicographically
-     * before lexicographic_end. If lexicographic_start is also set, the objects
-     * listed have names between lexicographic_start (inclusive) and
-     * lexicographic_end (exclusive).
+     * before `lexicographic_end`. If `lexicographic_start` is also set, the
+     * objects listed have names between `lexicographic_start` (inclusive) and
+     * `lexicographic_end` (exclusive).
      * 
                                            
      *
      * string lexicographic_end = 11 [(.google.api.field_behavior) = OPTIONAL];
@@ -2430,9 +2422,9 @@ public com.google.protobuf.ByteString getLexicographicEndBytes() {
      *
      * 
                                                  * Optional. Filter results to objects whose names are lexicographically
-     * before lexicographic_end. If lexicographic_start is also set, the objects
-     * listed have names between lexicographic_start (inclusive) and
-     * lexicographic_end (exclusive).
+     * before `lexicographic_end`. If `lexicographic_start` is also set, the
+     * objects listed have names between `lexicographic_start` (inclusive) and
+     * `lexicographic_end` (exclusive).
      * 
                                            
      *
      * string lexicographic_end = 11 [(.google.api.field_behavior) = OPTIONAL];
@@ -2455,9 +2447,9 @@ public Builder setLexicographicEnd(java.lang.String value) {
      *
      * 
                                                  * Optional. Filter results to objects whose names are lexicographically
-     * before lexicographic_end. If lexicographic_start is also set, the objects
-     * listed have names between lexicographic_start (inclusive) and
-     * lexicographic_end (exclusive).
+     * before `lexicographic_end`. If `lexicographic_start` is also set, the
+     * objects listed have names between `lexicographic_start` (inclusive) and
+     * `lexicographic_end` (exclusive).
      * 
                                            
      *
      * string lexicographic_end = 11 [(.google.api.field_behavior) = OPTIONAL];
@@ -2476,9 +2468,9 @@ public Builder clearLexicographicEnd() {
      *
      * 
                                                  * Optional. Filter results to objects whose names are lexicographically
-     * before lexicographic_end. If lexicographic_start is also set, the objects
-     * listed have names between lexicographic_start (inclusive) and
-     * lexicographic_end (exclusive).
+     * before `lexicographic_end`. If `lexicographic_start` is also set, the
+     * objects listed have names between `lexicographic_start` (inclusive) and
+     * `lexicographic_end` (exclusive).
      * 
                                            
      *
      * string lexicographic_end = 11 [(.google.api.field_behavior) = OPTIONAL];
@@ -2562,8 +2554,8 @@ public Builder clearSoftDeleted() {
      *
      *
      * 
                                            -     * Optional. If true, will also include folders and managed folders (besides
-     * objects) in the returned `prefixes`. Requires `delimiter` to be set to '/'.
+     * Optional. If true, includes folders and managed folders (besides objects)
+     * in the returned `prefixes`. Requires `delimiter` to be set to '/'.
      * 
                                            
      *
      * bool include_folders_as_prefixes = 13 [(.google.api.field_behavior) = OPTIONAL];
@@ -2579,8 +2571,8 @@ public boolean getIncludeFoldersAsPrefixes() {
      *
      *
      * 
                                            -     * Optional. If true, will also include folders and managed folders (besides
-     * objects) in the returned `prefixes`. Requires `delimiter` to be set to '/'.
+     * Optional. If true, includes folders and managed folders (besides objects)
+     * in the returned `prefixes`. Requires `delimiter` to be set to '/'.
      * 
                                            
      *
      * bool include_folders_as_prefixes = 13 [(.google.api.field_behavior) = OPTIONAL];
@@ -2600,8 +2592,8 @@ public Builder setIncludeFoldersAsPrefixes(boolean value) {
      *
      *
      * 
                                            -     * Optional. If true, will also include folders and managed folders (besides
-     * objects) in the returned `prefixes`. Requires `delimiter` to be set to '/'.
+     * Optional. If true, includes folders and managed folders (besides objects)
+     * in the returned `prefixes`. Requires `delimiter` to be set to '/'.
      * 
                                            
      *
      * bool include_folders_as_prefixes = 13 [(.google.api.field_behavior) = OPTIONAL];
@@ -2622,8 +2614,8 @@ public Builder clearIncludeFoldersAsPrefixes() {
      *
      * 
                                                  * Optional. Filter results to objects and prefixes that match this glob
-     * pattern. See [List Objects Using
-     * Glob](https://cloud.google.com/storage/docs/json_api/v1/objects/list#list-objects-and-prefixes-using-glob)
+     * pattern. See [List objects using
+     * glob](https://cloud.google.com/storage/docs/json_api/v1/objects/list#list-objects-and-prefixes-using-glob)
      * for the full syntax.
      * 
                                            
      *
@@ -2648,8 +2640,8 @@ public java.lang.String getMatchGlob() {
      *
      * 
                                                  * Optional. Filter results to objects and prefixes that match this glob
-     * pattern. See [List Objects Using
-     * Glob](https://cloud.google.com/storage/docs/json_api/v1/objects/list#list-objects-and-prefixes-using-glob)
+     * pattern. See [List objects using
+     * glob](https://cloud.google.com/storage/docs/json_api/v1/objects/list#list-objects-and-prefixes-using-glob)
      * for the full syntax.
      * 
                                            
      *
@@ -2674,8 +2666,8 @@ public com.google.protobuf.ByteString getMatchGlobBytes() {
      *
      * 
                                                  * Optional. Filter results to objects and prefixes that match this glob
-     * pattern. See [List Objects Using
-     * Glob](https://cloud.google.com/storage/docs/json_api/v1/objects/list#list-objects-and-prefixes-using-glob)
+     * pattern. See [List objects using
+     * glob](https://cloud.google.com/storage/docs/json_api/v1/objects/list#list-objects-and-prefixes-using-glob)
      * for the full syntax.
      * 
                                            
      *
@@ -2699,8 +2691,8 @@ public Builder setMatchGlob(java.lang.String value) {
      *
      * 
                                                  * Optional. Filter results to objects and prefixes that match this glob
-     * pattern. See [List Objects Using
-     * Glob](https://cloud.google.com/storage/docs/json_api/v1/objects/list#list-objects-and-prefixes-using-glob)
+     * pattern. See [List objects using
+     * glob](https://cloud.google.com/storage/docs/json_api/v1/objects/list#list-objects-and-prefixes-using-glob)
      * for the full syntax.
      * 
                                            
      *
@@ -2720,8 +2712,8 @@ public Builder clearMatchGlob() {
      *
      * 
                                                  * Optional. Filter results to objects and prefixes that match this glob
-     * pattern. See [List Objects Using
-     * Glob](https://cloud.google.com/storage/docs/json_api/v1/objects/list#list-objects-and-prefixes-using-glob)
+     * pattern. See [List objects using
+     * glob](https://cloud.google.com/storage/docs/json_api/v1/objects/list#list-objects-and-prefixes-using-glob)
      * for the full syntax.
      * 
                                            
      *
@@ -2747,9 +2739,11 @@ public Builder setMatchGlobBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
                                            -     * Optional. Filter the returned objects. Currently only supported for the
-     * `contexts` field. If `delimiter` is set, the returned `prefixes` are exempt
-     * from this filter.
+     * Optional. An expression used to filter the returned objects by the
+     * `context` field. For the full syntax, see [Filter objects by contexts
+     * syntax](https://cloud.google.com/storage/docs/listing-objects#filter-by-object-contexts-syntax).
+     * If a `delimiter` is set, the returned `prefixes` are exempt from this
+     * filter.
      * 
                                            
      *
      * string filter = 15 [(.google.api.field_behavior) = OPTIONAL];
@@ -2772,9 +2766,11 @@ public java.lang.String getFilter() {
      *
      *
      * 
                                            -     * Optional. Filter the returned objects. Currently only supported for the
-     * `contexts` field. If `delimiter` is set, the returned `prefixes` are exempt
-     * from this filter.
+     * Optional. An expression used to filter the returned objects by the
+     * `context` field. For the full syntax, see [Filter objects by contexts
+     * syntax](https://cloud.google.com/storage/docs/listing-objects#filter-by-object-contexts-syntax).
+     * If a `delimiter` is set, the returned `prefixes` are exempt from this
+     * filter.
      * 
                                            
      *
      * string filter = 15 [(.google.api.field_behavior) = OPTIONAL];
@@ -2797,9 +2793,11 @@ public com.google.protobuf.ByteString getFilterBytes() {
      *
      *
      * 
                                            -     * Optional. Filter the returned objects. Currently only supported for the
-     * `contexts` field. If `delimiter` is set, the returned `prefixes` are exempt
-     * from this filter.
+     * Optional. An expression used to filter the returned objects by the
+     * `context` field. For the full syntax, see [Filter objects by contexts
+     * syntax](https://cloud.google.com/storage/docs/listing-objects#filter-by-object-contexts-syntax).
+     * If a `delimiter` is set, the returned `prefixes` are exempt from this
+     * filter.
      * 
                                            
      *
      * string filter = 15 [(.google.api.field_behavior) = OPTIONAL];
@@ -2821,9 +2819,11 @@ public Builder setFilter(java.lang.String value) {
      *
      *
      * 
                                            -     * Optional. Filter the returned objects. Currently only supported for the
-     * `contexts` field. If `delimiter` is set, the returned `prefixes` are exempt
-     * from this filter.
+     * Optional. An expression used to filter the returned objects by the
+     * `context` field. For the full syntax, see [Filter objects by contexts
+     * syntax](https://cloud.google.com/storage/docs/listing-objects#filter-by-object-contexts-syntax).
+     * If a `delimiter` is set, the returned `prefixes` are exempt from this
+     * filter.
      * 
                                            
      *
      * string filter = 15 [(.google.api.field_behavior) = OPTIONAL];
@@ -2841,9 +2841,11 @@ public Builder clearFilter() {
      *
      *
      * 
                                            -     * Optional. Filter the returned objects. Currently only supported for the
-     * `contexts` field. If `delimiter` is set, the returned `prefixes` are exempt
-     * from this filter.
+     * Optional. An expression used to filter the returned objects by the
+     * `context` field. For the full syntax, see [Filter objects by contexts
+     * syntax](https://cloud.google.com/storage/docs/listing-objects#filter-by-object-contexts-syntax).
+     * If a `delimiter` is set, the returned `prefixes` are exempt from this
+     * filter.
      * 
                                            
      *
      * string filter = 15 [(.google.api.field_behavior) = OPTIONAL];
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ListObjectsRequestOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ListObjectsRequestOrBuilder.java
index 3a1ac19054..09aefff184 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ListObjectsRequestOrBuilder.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ListObjectsRequestOrBuilder.java
@@ -60,8 +60,8 @@ public interface ListObjectsRequestOrBuilder
    * 
                                                * Optional. Maximum number of `items` plus `prefixes` to return
    * in a single page of responses. As duplicate `prefixes` are
-   * omitted, fewer total results may be returned than requested. The service
-   * will use this parameter or 1,000 items, whichever is smaller.
+   * omitted, fewer total results might be returned than requested. The service
+   * uses this parameter or 1,000 items, whichever is smaller.
    * 
                                            
    *
    * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -102,11 +102,11 @@ public interface ListObjectsRequestOrBuilder
    *
    *
    * 
                                            -   * Optional. If set, returns results in a directory-like mode. `items` will
-   * contain only objects whose names, aside from the `prefix`, do not contain
+   * Optional. If set, returns results in a directory-like mode. `items`
+   * contains only objects whose names, aside from the `prefix`, do not contain
    * `delimiter`. Objects whose names, aside from the `prefix`, contain
-   * `delimiter` will have their name, truncated after the `delimiter`, returned
-   * in `prefixes`. Duplicate `prefixes` are omitted.
+   * `delimiter` has their name, truncated after the `delimiter`, returned in
+   * `prefixes`. Duplicate `prefixes` are omitted.
    * 
                                            
    *
    * string delimiter = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -119,11 +119,11 @@ public interface ListObjectsRequestOrBuilder
    *
    *
    * 
                                            -   * Optional. If set, returns results in a directory-like mode. `items` will
-   * contain only objects whose names, aside from the `prefix`, do not contain
+   * Optional. If set, returns results in a directory-like mode. `items`
+   * contains only objects whose names, aside from the `prefix`, do not contain
    * `delimiter`. Objects whose names, aside from the `prefix`, contain
-   * `delimiter` will have their name, truncated after the `delimiter`, returned
-   * in `prefixes`. Duplicate `prefixes` are omitted.
+   * `delimiter` has their name, truncated after the `delimiter`, returned in
+   * `prefixes`. Duplicate `prefixes` are omitted.
    * 
                                            
    *
    * string delimiter = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -137,7 +137,7 @@ public interface ListObjectsRequestOrBuilder
    *
    * 
                                                * Optional. If true, objects that end in exactly one instance of `delimiter`
-   * will have their metadata included in `items` in addition to
+   * has their metadata included in `items` in addition to
    * `prefixes`.
    * 
                                            
    *
@@ -178,9 +178,6 @@ public interface ListObjectsRequestOrBuilder
    *
    * 
                                                * Optional. If `true`, lists all versions of an object as distinct results.
-   * For more information, see
-   * [Object
-   * Versioning](https://cloud.google.com/storage/docs/object-versioning).
    * 
                                            
    *
    * bool versions = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -194,9 +191,9 @@ public interface ListObjectsRequestOrBuilder
    *
    * 
                                                * Mask specifying which fields to read from each result.
-   * If no mask is specified, will default to all fields except items.acl and
-   * items.owner.
-   * * may be used to mean "all fields".
+   * If no mask is specified, defaults to all fields except `items.acl` and
+   * `items.owner`.
+   * `*` might be used to mean all fields.
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 8;
@@ -210,9 +207,9 @@ public interface ListObjectsRequestOrBuilder
    *
    * 
                                                * Mask specifying which fields to read from each result.
-   * If no mask is specified, will default to all fields except items.acl and
-   * items.owner.
-   * * may be used to mean "all fields".
+   * If no mask is specified, defaults to all fields except `items.acl` and
+   * `items.owner`.
+   * `*` might be used to mean all fields.
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 8;
@@ -226,9 +223,9 @@ public interface ListObjectsRequestOrBuilder
    *
    * 
                                                * Mask specifying which fields to read from each result.
-   * If no mask is specified, will default to all fields except items.acl and
-   * items.owner.
-   * * may be used to mean "all fields".
+   * If no mask is specified, defaults to all fields except `items.acl` and
+   * `items.owner`.
+   * `*` might be used to mean all fields.
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 8;
@@ -240,9 +237,9 @@ public interface ListObjectsRequestOrBuilder
    *
    * 
                                                * Optional. Filter results to objects whose names are lexicographically equal
-   * to or after lexicographic_start. If lexicographic_end is also set, the
-   * objects listed have names between lexicographic_start (inclusive) and
-   * lexicographic_end (exclusive).
+   * to or after `lexicographic_start`. If `lexicographic_end` is also set, the
+   * objects listed have names between `lexicographic_start` (inclusive) and
+   * `lexicographic_end` (exclusive).
    * 
                                            
    *
    * string lexicographic_start = 10 [(.google.api.field_behavior) = OPTIONAL];
@@ -256,9 +253,9 @@ public interface ListObjectsRequestOrBuilder
    *
    * 
                                                * Optional. Filter results to objects whose names are lexicographically equal
-   * to or after lexicographic_start. If lexicographic_end is also set, the
-   * objects listed have names between lexicographic_start (inclusive) and
-   * lexicographic_end (exclusive).
+   * to or after `lexicographic_start`. If `lexicographic_end` is also set, the
+   * objects listed have names between `lexicographic_start` (inclusive) and
+   * `lexicographic_end` (exclusive).
    * 
                                            
    *
    * string lexicographic_start = 10 [(.google.api.field_behavior) = OPTIONAL];
@@ -272,9 +269,9 @@ public interface ListObjectsRequestOrBuilder
    *
    * 
                                                * Optional. Filter results to objects whose names are lexicographically
-   * before lexicographic_end. If lexicographic_start is also set, the objects
-   * listed have names between lexicographic_start (inclusive) and
-   * lexicographic_end (exclusive).
+   * before `lexicographic_end`. If `lexicographic_start` is also set, the
+   * objects listed have names between `lexicographic_start` (inclusive) and
+   * `lexicographic_end` (exclusive).
    * 
                                            
    *
    * string lexicographic_end = 11 [(.google.api.field_behavior) = OPTIONAL];
@@ -288,9 +285,9 @@ public interface ListObjectsRequestOrBuilder
    *
    * 
                                                * Optional. Filter results to objects whose names are lexicographically
-   * before lexicographic_end. If lexicographic_start is also set, the objects
-   * listed have names between lexicographic_start (inclusive) and
-   * lexicographic_end (exclusive).
+   * before `lexicographic_end`. If `lexicographic_start` is also set, the
+   * objects listed have names between `lexicographic_start` (inclusive) and
+   * `lexicographic_end` (exclusive).
    * 
                                            
    *
    * string lexicographic_end = 11 [(.google.api.field_behavior) = OPTIONAL];
@@ -317,8 +314,8 @@ public interface ListObjectsRequestOrBuilder
    *
    *
    * 
                                            -   * Optional. If true, will also include folders and managed folders (besides
-   * objects) in the returned `prefixes`. Requires `delimiter` to be set to '/'.
+   * Optional. If true, includes folders and managed folders (besides objects)
+   * in the returned `prefixes`. Requires `delimiter` to be set to '/'.
    * 
                                            
    *
    * bool include_folders_as_prefixes = 13 [(.google.api.field_behavior) = OPTIONAL];
@@ -332,8 +329,8 @@ public interface ListObjectsRequestOrBuilder
    *
    * 
                                                * Optional. Filter results to objects and prefixes that match this glob
-   * pattern. See [List Objects Using
-   * Glob](https://cloud.google.com/storage/docs/json_api/v1/objects/list#list-objects-and-prefixes-using-glob)
+   * pattern. See [List objects using
+   * glob](https://cloud.google.com/storage/docs/json_api/v1/objects/list#list-objects-and-prefixes-using-glob)
    * for the full syntax.
    * 
                                            
    *
@@ -348,8 +345,8 @@ public interface ListObjectsRequestOrBuilder
    *
    * 
                                                * Optional. Filter results to objects and prefixes that match this glob
-   * pattern. See [List Objects Using
-   * Glob](https://cloud.google.com/storage/docs/json_api/v1/objects/list#list-objects-and-prefixes-using-glob)
+   * pattern. See [List objects using
+   * glob](https://cloud.google.com/storage/docs/json_api/v1/objects/list#list-objects-and-prefixes-using-glob)
    * for the full syntax.
    * 
                                            
    *
@@ -363,9 +360,11 @@ public interface ListObjectsRequestOrBuilder
    *
    *
    * 
                                            -   * Optional. Filter the returned objects. Currently only supported for the
-   * `contexts` field. If `delimiter` is set, the returned `prefixes` are exempt
-   * from this filter.
+   * Optional. An expression used to filter the returned objects by the
+   * `context` field. For the full syntax, see [Filter objects by contexts
+   * syntax](https://cloud.google.com/storage/docs/listing-objects#filter-by-object-contexts-syntax).
+   * If a `delimiter` is set, the returned `prefixes` are exempt from this
+   * filter.
    * 
                                            
    *
    * string filter = 15 [(.google.api.field_behavior) = OPTIONAL];
@@ -378,9 +377,11 @@ public interface ListObjectsRequestOrBuilder
    *
    *
    * 
                                            -   * Optional. Filter the returned objects. Currently only supported for the
-   * `contexts` field. If `delimiter` is set, the returned `prefixes` are exempt
-   * from this filter.
+   * Optional. An expression used to filter the returned objects by the
+   * `context` field. For the full syntax, see [Filter objects by contexts
+   * syntax](https://cloud.google.com/storage/docs/listing-objects#filter-by-object-contexts-syntax).
+   * If a `delimiter` is set, the returned `prefixes` are exempt from this
+   * filter.
    * 
                                            
    *
    * string filter = 15 [(.google.api.field_behavior) = OPTIONAL];
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/LockBucketRetentionPolicyRequest.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/LockBucketRetentionPolicyRequest.java
index b67203a8e5..c208a63ed4 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/LockBucketRetentionPolicyRequest.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/LockBucketRetentionPolicyRequest.java
@@ -23,7 +23,8 @@
  *
  *
  * 
                                            - * Request message for LockBucketRetentionPolicyRequest.
+ * Request message for
+ * [LockBucketRetentionPolicy][google.storage.v2.Storage.LockBucketRetentionPolicy].
  * 
                                            
  *
  * Protobuf type {@code google.storage.v2.LockBucketRetentionPolicyRequest}
@@ -316,7 +317,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
                                            -   * Request message for LockBucketRetentionPolicyRequest.
+   * Request message for
+   * [LockBucketRetentionPolicy][google.storage.v2.Storage.LockBucketRetentionPolicy].
    * 
                                            
    *
    * Protobuf type {@code google.storage.v2.LockBucketRetentionPolicyRequest}
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/MoveObjectRequest.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/MoveObjectRequest.java
index a9e86271f1..3db3ee0b5b 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/MoveObjectRequest.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/MoveObjectRequest.java
@@ -23,7 +23,7 @@
  *
  *
  * 
                                            - * Request message for MoveObject.
+ * Request message for [MoveObject][google.storage.v2.Storage.MoveObject].
  * 
                                            
  *
  * Protobuf type {@code google.storage.v2.MoveObjectRequest}
@@ -896,7 +896,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
                                            -   * Request message for MoveObject.
+   * Request message for [MoveObject][google.storage.v2.Storage.MoveObject].
    * 
                                            
    *
    * Protobuf type {@code google.storage.v2.MoveObjectRequest}
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/Object.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/Object.java
index 90ccca273d..1202cbf6e1 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/Object.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/Object.java
@@ -237,9 +237,9 @@ public enum Mode implements com.google.protobuf.ProtocolMessageEnum {
        *
        *
        * 
                                            -       * Retention period may be decreased or increased.
-       * The Retention configuration may be removed.
-       * The mode may be changed to locked.
+       * Retention period might be decreased or increased.
+       * The Retention configuration might be removed.
+       * The mode might be changed to locked.
        * 
                                            
        *
        * UNLOCKED = 1;
@@ -249,7 +249,7 @@ public enum Mode implements com.google.protobuf.ProtocolMessageEnum {
        *
        *
        * 
                                            -       * Retention period may be increased.
+       * Retention period might be increased.
        * The Retention configuration cannot be removed.
        * The mode cannot be changed.
        * 
                                            
@@ -275,9 +275,9 @@ public enum Mode implements com.google.protobuf.ProtocolMessageEnum {
        *
        *
        * 
                                            -       * Retention period may be decreased or increased.
-       * The Retention configuration may be removed.
-       * The mode may be changed to locked.
+       * Retention period might be decreased or increased.
+       * The Retention configuration might be removed.
+       * The mode might be changed to locked.
        * 
                                            
        *
        * UNLOCKED = 1;
@@ -288,7 +288,7 @@ public enum Mode implements com.google.protobuf.ProtocolMessageEnum {
        *
        *
        * 
                                            -       * Retention period may be increased.
+       * Retention period might be increased.
        * The Retention configuration cannot be removed.
        * The mode cannot be changed.
        * 
                                            
@@ -1395,9 +1395,9 @@ public com.google.protobuf.ByteString getBucketBytes() {
    *
    *
    * 
                                            -   * Optional. The etag of the object.
+   * Optional. The `etag` of an object.
    * If included in the metadata of an update or delete request message, the
-   * operation will only be performed if the etag matches that of the live
+   * operation is only performed if the etag matches that of the live
    * object.
    * 
                                            
    *
@@ -1422,9 +1422,9 @@ public java.lang.String getEtag() {
    *
    *
    * 
                                            -   * Optional. The etag of the object.
+   * Optional. The `etag` of an object.
    * If included in the metadata of an update or delete request message, the
-   * operation will only be performed if the etag matches that of the live
+   * operation is only performed if the etag matches that of the live
    * object.
    * 
                                            
    *
@@ -1623,7 +1623,7 @@ public com.google.protobuf.ByteString getStorageClassBytes() {
    *
    * 
                                                * Output only. Content-Length of the object data in bytes, matching
-   * [https://tools.ietf.org/html/rfc7230#section-3.3.2][RFC 7230 §3.3.2].
+   * [RFC 7230 §3.3.2](https://tools.ietf.org/html/rfc7230#section-3.3.2]).
    * 
                                            
    *
    * int64 size = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -1645,7 +1645,7 @@ public long getSize() {
    *
    * 
                                                * Optional. Content-Encoding of the object data, matching
-   * [https://tools.ietf.org/html/rfc7231#section-3.1.2.2][RFC 7231 §3.1.2.2]
+   * [RFC 7231 §3.1.2.2](https://tools.ietf.org/html/rfc7231#section-3.1.2.2)
    * 
                                            
    *
    * string content_encoding = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -1670,7 +1670,7 @@ public java.lang.String getContentEncoding() {
    *
    * 
                                                * Optional. Content-Encoding of the object data, matching
-   * [https://tools.ietf.org/html/rfc7231#section-3.1.2.2][RFC 7231 §3.1.2.2]
+   * [RFC 7231 §3.1.2.2](https://tools.ietf.org/html/rfc7231#section-3.1.2.2)
    * 
                                            
    *
    * string content_encoding = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -1700,7 +1700,7 @@ public com.google.protobuf.ByteString getContentEncodingBytes() {
    *
    * 
                                                * Optional. Content-Disposition of the object data, matching
-   * [https://tools.ietf.org/html/rfc6266][RFC 6266].
+   * [RFC 6266](https://tools.ietf.org/html/rfc6266).
    * 
                                            
    *
    * string content_disposition = 8 [(.google.api.field_behavior) = OPTIONAL];
@@ -1725,7 +1725,7 @@ public java.lang.String getContentDisposition() {
    *
    * 
                                                * Optional. Content-Disposition of the object data, matching
-   * [https://tools.ietf.org/html/rfc6266][RFC 6266].
+   * [RFC 6266](https://tools.ietf.org/html/rfc6266).
    * 
                                            
    *
    * string content_disposition = 8 [(.google.api.field_behavior) = OPTIONAL];
@@ -1755,9 +1755,9 @@ public com.google.protobuf.ByteString getContentDispositionBytes() {
    *
    * 
                                                * Optional. Cache-Control directive for the object data, matching
-   * [https://tools.ietf.org/html/rfc7234#section-5.2"][RFC 7234 §5.2].
+   * [RFC 7234 §5.2](https://tools.ietf.org/html/rfc7234#section-5.2).
    * If omitted, and the object is accessible to all anonymous users, the
-   * default will be `public, max-age=3600`.
+   * default is `public, max-age=3600`.
    * 
                                            
    *
    * string cache_control = 9 [(.google.api.field_behavior) = OPTIONAL];
@@ -1782,9 +1782,9 @@ public java.lang.String getCacheControl() {
    *
    * 
                                                * Optional. Cache-Control directive for the object data, matching
-   * [https://tools.ietf.org/html/rfc7234#section-5.2"][RFC 7234 §5.2].
+   * [RFC 7234 §5.2](https://tools.ietf.org/html/rfc7234#section-5.2).
    * If omitted, and the object is accessible to all anonymous users, the
-   * default will be `public, max-age=3600`.
+   * default is `public, max-age=3600`.
    * 
                                            
    *
    * string cache_control = 9 [(.google.api.field_behavior) = OPTIONAL];
@@ -1814,7 +1814,7 @@ public com.google.protobuf.ByteString getCacheControlBytes() {
    *
    * 
                                                * Optional. Access controls on the object.
-   * If iam_config.uniform_bucket_level_access is enabled on the parent
+   * If `iam_config.uniform_bucket_level_access` is enabled on the parent
    * bucket, requests to set, read, or modify acl is an error.
    * 
                                            
    *
@@ -1832,7 +1832,7 @@ public java.util.List getAclList() {
    *
    * 
                                                * Optional. Access controls on the object.
-   * If iam_config.uniform_bucket_level_access is enabled on the parent
+   * If `iam_config.uniform_bucket_level_access` is enabled on the parent
    * bucket, requests to set, read, or modify acl is an error.
    * 
                                            
    *
@@ -1851,7 +1851,7 @@ public java.util.List getAclList() {
    *
    * 
                                                * Optional. Access controls on the object.
-   * If iam_config.uniform_bucket_level_access is enabled on the parent
+   * If `iam_config.uniform_bucket_level_access` is enabled on the parent
    * bucket, requests to set, read, or modify acl is an error.
    * 
                                            
    *
@@ -1869,7 +1869,7 @@ public int getAclCount() {
    *
    * 
                                                * Optional. Access controls on the object.
-   * If iam_config.uniform_bucket_level_access is enabled on the parent
+   * If `iam_config.uniform_bucket_level_access` is enabled on the parent
    * bucket, requests to set, read, or modify acl is an error.
    * 
                                            
    *
@@ -1887,7 +1887,7 @@ public com.google.storage.v2.ObjectAccessControl getAcl(int index) {
    *
    * 
                                                * Optional. Access controls on the object.
-   * If iam_config.uniform_bucket_level_access is enabled on the parent
+   * If `iam_config.uniform_bucket_level_access` is enabled on the parent
    * bucket, requests to set, read, or modify acl is an error.
    * 
                                            
    *
@@ -1910,7 +1910,7 @@ public com.google.storage.v2.ObjectAccessControlOrBuilder getAclOrBuilder(int in
    *
    * 
                                                * Optional. Content-Language of the object data, matching
-   * [https://tools.ietf.org/html/rfc7231#section-3.1.3.2][RFC 7231 §3.1.3.2].
+   * [RFC 7231 §3.1.3.2](https://tools.ietf.org/html/rfc7231#section-3.1.3.2).
    * 
                                            
    *
    * string content_language = 11 [(.google.api.field_behavior) = OPTIONAL];
@@ -1935,7 +1935,7 @@ public java.lang.String getContentLanguage() {
    *
    * 
                                                * Optional. Content-Language of the object data, matching
-   * [https://tools.ietf.org/html/rfc7231#section-3.1.3.2][RFC 7231 §3.1.3.2].
+   * [RFC 7231 §3.1.3.2](https://tools.ietf.org/html/rfc7231#section-3.1.3.2).
    * 
                                            
    *
    * string content_language = 11 [(.google.api.field_behavior) = OPTIONAL];
@@ -2079,7 +2079,7 @@ public com.google.protobuf.TimestampOrBuilder getFinalizeTimeOrBuilder() {
    *
    * 
                                                * Optional. Content-Type of the object data, matching
-   * [https://tools.ietf.org/html/rfc7231#section-3.1.1.5][RFC 7231 §3.1.1.5].
+   * [RFC 7231 §3.1.1.5](https://tools.ietf.org/html/rfc7231#section-3.1.1.5).
    * If an object is stored without a Content-Type, it is served as
    * `application/octet-stream`.
    * 
                                            
@@ -2106,7 +2106,7 @@ public java.lang.String getContentType() {
    *
    * 
                                                * Optional. Content-Type of the object data, matching
-   * [https://tools.ietf.org/html/rfc7231#section-3.1.1.5][RFC 7231 §3.1.1.5].
+   * [RFC 7231 §3.1.1.5](https://tools.ietf.org/html/rfc7231#section-3.1.1.5).
    * If an object is stored without a Content-Type, it is served as
    * `application/octet-stream`.
    * 
                                            
@@ -2208,7 +2208,7 @@ public int getComponentCount() {
    *
    * 
                                                * Output only. Hashes for the data part of this object. This field is used
-   * for output only and will be silently ignored if provided in requests. The
+   * for output only and is silently ignored if provided in requests. The
    * checksums of the complete object regardless of data range. If the object is
    * downloaded in full, the client should compute one of these checksums over
    * the downloaded object and compare it against the value provided here.
@@ -2230,7 +2230,7 @@ public boolean hasChecksums() {
    *
    * 
                                                * Output only. Hashes for the data part of this object. This field is used
-   * for output only and will be silently ignored if provided in requests. The
+   * for output only and is silently ignored if provided in requests. The
    * checksums of the complete object regardless of data range. If the object is
    * downloaded in full, the client should compute one of these checksums over
    * the downloaded object and compare it against the value provided here.
@@ -2254,7 +2254,7 @@ public com.google.storage.v2.ObjectChecksums getChecksums() {
    *
    * 
                                                * Output only. Hashes for the data part of this object. This field is used
-   * for output only and will be silently ignored if provided in requests. The
+   * for output only and is silently ignored if provided in requests. The
    * checksums of the complete object regardless of data range. If the object is
    * downloaded in full, the client should compute one of these checksums over
    * the downloaded object and compare it against the value provided here.
@@ -2405,7 +2405,7 @@ public com.google.protobuf.ByteString getKmsKeyBytes() {
    *
    * 
                                                * Output only. The time at which the object's storage class was last changed.
-   * When the object is initially created, it will be set to time_created.
+   * When the object is initially created, it is set to `time_created`.
    * 
                                            
    *
    * 
@@ -2424,7 +2424,7 @@ public boolean hasUpdateStorageClassTime() {
    *
    * 
                                                * Output only. The time at which the object's storage class was last changed.
-   * When the object is initially created, it will be set to time_created.
+   * When the object is initially created, it is set to `time_created`.
    * 
                                            
    *
    * 
@@ -2445,7 +2445,7 @@ public com.google.protobuf.Timestamp getUpdateStorageClassTime() {
    *
    * 
                                                * Output only. The time at which the object's storage class was last changed.
-   * When the object is initially created, it will be set to time_created.
+   * When the object is initially created, it is set to `time_created`.
    * 
                                            
    *
    * 
@@ -2739,14 +2739,14 @@ public com.google.storage.v2.ObjectContextsOrBuilder getContextsOrBuilder() {
    * 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
-   * this field to false, the object will become subject to any bucket-level
-   * retention policy, except that the retention duration will be calculated
+   * this field to `false`, the object becomes subject to any bucket-level
+   * retention policy, except that the retention duration is calculated
    * from the time the event based hold was lifted, rather than the time the
    * object was created.
    *
-   * In a WriteObject request, not setting this field implies that the value
-   * should be taken from the parent bucket's "default_event_based_hold" field.
-   * In a response, this field will always be set to true or false.
+   * In a `WriteObject` request, not setting this field implies that the value
+   * should be taken from the parent bucket's `default_event_based_hold` field.
+   * In a response, this field is always set to `true` or `false`.
    * 
                                            
    *
    * optional bool event_based_hold = 23;
@@ -2765,14 +2765,14 @@ public boolean hasEventBasedHold() {
    * 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
-   * this field to false, the object will become subject to any bucket-level
-   * retention policy, except that the retention duration will be calculated
+   * this field to `false`, the object becomes subject to any bucket-level
+   * retention policy, except that the retention duration is calculated
    * from the time the event based hold was lifted, rather than the time the
    * object was created.
    *
-   * In a WriteObject request, not setting this field implies that the value
-   * should be taken from the parent bucket's "default_event_based_hold" field.
-   * In a response, this field will always be set to true or false.
+   * In a `WriteObject` request, not setting this field implies that the value
+   * should be taken from the parent bucket's `default_event_based_hold` field.
+   * In a response, this field is always set to `true` or `false`.
    * 
                                            
    *
    * optional bool event_based_hold = 23;
@@ -2791,8 +2791,8 @@ public boolean getEventBasedHold() {
    *
    *
    * 
                                            -   * Output only. The owner of the object. This will always be the uploader of
-   * the object.
+   * Output only. The owner of the object. This is always the uploader of the
+   * object.
    * 
                                            
    *
    * .google.storage.v2.Owner owner = 24 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -2808,8 +2808,8 @@ public boolean hasOwner() {
    *
    *
    * 
                                            -   * Output only. The owner of the object. This will always be the uploader of
-   * the object.
+   * Output only. The owner of the object. This is always the uploader of the
+   * object.
    * 
                                            
    *
    * .google.storage.v2.Owner owner = 24 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -2825,8 +2825,8 @@ public com.google.storage.v2.Owner getOwner() {
    *
    *
    * 
                                            -   * Output only. The owner of the object. This will always be the uploader of
-   * the object.
+   * Output only. The owner of the object. This is always the uploader of the
+   * object.
    * 
                                            
    *
    * .google.storage.v2.Owner owner = 24 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -2843,7 +2843,7 @@ public com.google.storage.v2.OwnerOrBuilder getOwnerOrBuilder() {
    *
    *
    * 
                                            -   * Optional. Metadata of Customer-Supplied Encryption Key, if the object is
+   * Optional. Metadata of customer-supplied encryption key, if the object is
    * encrypted by such a key.
    * 
                                            
    *
@@ -2862,7 +2862,7 @@ public boolean hasCustomerEncryption() {
    *
    *
    * 
                                            -   * Optional. Metadata of Customer-Supplied Encryption Key, if the object is
+   * Optional. Metadata of customer-supplied encryption key, if the object is
    * encrypted by such a key.
    * 
                                            
    *
@@ -2883,7 +2883,7 @@ public com.google.storage.v2.CustomerEncryption getCustomerEncryption() {
    *
    *
    * 
                                            -   * Optional. Metadata of Customer-Supplied Encryption Key, if the object is
+   * Optional. Metadata of customer-supplied encryption key, if the object is
    * encrypted by such a key.
    * 
                                            
    *
@@ -2960,7 +2960,7 @@ public com.google.protobuf.TimestampOrBuilder getCustomTimeOrBuilder() {
    * Output only. This is the time when the object became soft-deleted.
    *
    * Soft-deleted objects are only accessible if a soft_delete_policy is
-   * enabled. Also see hard_delete_time.
+   * enabled. Also see `hard_delete_time`.
    * 
                                            
    *
    * 
@@ -2981,7 +2981,7 @@ public boolean hasSoftDeleteTime() {
    * Output only. This is the time when the object became soft-deleted.
    *
    * Soft-deleted objects are only accessible if a soft_delete_policy is
-   * enabled. Also see hard_delete_time.
+   * enabled. Also see `hard_delete_time`.
    * 
                                            
    *
    * 
@@ -3004,7 +3004,7 @@ public com.google.protobuf.Timestamp getSoftDeleteTime() {
    * Output only. This is the time when the object became soft-deleted.
    *
    * Soft-deleted objects are only accessible if a soft_delete_policy is
-   * enabled. Also see hard_delete_time.
+   * enabled. Also see `hard_delete_time`.
    * 
                                            
    *
    * 
@@ -3025,10 +3025,10 @@ public com.google.protobuf.TimestampOrBuilder getSoftDeleteTimeOrBuilder() {
    *
    *
    * 
                                            -   * Output only. The time when the object will be permanently deleted.
+   * Output only. The time when the object is permanently deleted.
    *
-   * Only set when an object becomes soft-deleted with a soft_delete_policy.
-   * Otherwise, the object will not be accessible.
+   * Only set when an object becomes soft-deleted with a `soft_delete_policy`.
+   * Otherwise, the object is not accessible.
    * 
                                            
    *
    * 
@@ -3046,10 +3046,10 @@ public boolean hasHardDeleteTime() {
    *
    *
    * 
                                            -   * Output only. The time when the object will be permanently deleted.
+   * Output only. The time when the object is permanently deleted.
    *
-   * Only set when an object becomes soft-deleted with a soft_delete_policy.
-   * Otherwise, the object will not be accessible.
+   * Only set when an object becomes soft-deleted with a `soft_delete_policy`.
+   * Otherwise, the object is not accessible.
    * 
                                            
    *
    * 
@@ -3069,10 +3069,10 @@ public com.google.protobuf.Timestamp getHardDeleteTime() {
    *
    *
    * 
                                            -   * Output only. The time when the object will be permanently deleted.
+   * Output only. The time when the object is permanently deleted.
    *
-   * Only set when an object becomes soft-deleted with a soft_delete_policy.
-   * Otherwise, the object will not be accessible.
+   * Only set when an object becomes soft-deleted with a `soft_delete_policy`.
+   * Otherwise, the object is not accessible.
    * 
                                            
    *
    * 
@@ -3094,7 +3094,7 @@ public com.google.protobuf.TimestampOrBuilder getHardDeleteTimeOrBuilder() {
    *
    * 
                                                * Optional. Retention configuration of this object.
-   * May only be configured if the bucket has object retention enabled.
+   * Might only be configured if the bucket has object retention enabled.
    * 
                                            
    *
    * 
@@ -3113,7 +3113,7 @@ public boolean hasRetention() {
    *
    * 
                                                * Optional. Retention configuration of this object.
-   * May only be configured if the bucket has object retention enabled.
+   * Might only be configured if the bucket has object retention enabled.
    * 
                                            
    *
    * 
@@ -3134,7 +3134,7 @@ public com.google.storage.v2.Object.Retention getRetention() {
    *
    * 
                                                * Optional. Retention configuration of this object.
-   * May only be configured if the bucket has object retention enabled.
+   * Might only be configured if the bucket has object retention enabled.
    * 
                                            
    *
    * 
@@ -4766,9 +4766,9 @@ public Builder setBucketBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
                                            -     * Optional. The etag of the object.
+     * Optional. The `etag` of an object.
      * If included in the metadata of an update or delete request message, the
-     * operation will only be performed if the etag matches that of the live
+     * operation is only performed if the etag matches that of the live
      * object.
      * 
                                            
      *
@@ -4792,9 +4792,9 @@ public java.lang.String getEtag() {
      *
      *
      * 
                                            -     * Optional. The etag of the object.
+     * Optional. The `etag` of an object.
      * If included in the metadata of an update or delete request message, the
-     * operation will only be performed if the etag matches that of the live
+     * operation is only performed if the etag matches that of the live
      * object.
      * 
                                            
      *
@@ -4818,9 +4818,9 @@ public com.google.protobuf.ByteString getEtagBytes() {
      *
      *
      * 
                                            -     * Optional. The etag of the object.
+     * Optional. The `etag` of an object.
      * If included in the metadata of an update or delete request message, the
-     * operation will only be performed if the etag matches that of the live
+     * operation is only performed if the etag matches that of the live
      * object.
      * 
                                            
      *
@@ -4843,9 +4843,9 @@ public Builder setEtag(java.lang.String value) {
      *
      *
      * 
                                            -     * Optional. The etag of the object.
+     * Optional. The `etag` of an object.
      * If included in the metadata of an update or delete request message, the
-     * operation will only be performed if the etag matches that of the live
+     * operation is only performed if the etag matches that of the live
      * object.
      * 
                                            
      *
@@ -4864,9 +4864,9 @@ public Builder clearEtag() {
      *
      *
      * 
                                            -     * Optional. The etag of the object.
+     * Optional. The `etag` of an object.
      * If included in the metadata of an update or delete request message, the
-     * operation will only be performed if the etag matches that of the live
+     * operation is only performed if the etag matches that of the live
      * object.
      * 
                                            
      *
@@ -5266,7 +5266,7 @@ public Builder setStorageClassBytes(com.google.protobuf.ByteString value) {
      *
      * 
                                                  * Output only. Content-Length of the object data in bytes, matching
-     * [https://tools.ietf.org/html/rfc7230#section-3.3.2][RFC 7230 §3.3.2].
+     * [RFC 7230 §3.3.2](https://tools.ietf.org/html/rfc7230#section-3.3.2]).
      * 
                                            
      *
      * int64 size = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -5283,7 +5283,7 @@ public long getSize() {
      *
      * 
                                                  * Output only. Content-Length of the object data in bytes, matching
-     * [https://tools.ietf.org/html/rfc7230#section-3.3.2][RFC 7230 §3.3.2].
+     * [RFC 7230 §3.3.2](https://tools.ietf.org/html/rfc7230#section-3.3.2]).
      * 
                                            
      *
      * int64 size = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -5304,7 +5304,7 @@ public Builder setSize(long value) {
      *
      * 
                                                  * Output only. Content-Length of the object data in bytes, matching
-     * [https://tools.ietf.org/html/rfc7230#section-3.3.2][RFC 7230 §3.3.2].
+     * [RFC 7230 §3.3.2](https://tools.ietf.org/html/rfc7230#section-3.3.2]).
      * 
                                            
      *
      * int64 size = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -5325,7 +5325,7 @@ public Builder clearSize() {
      *
      * 
                                                  * Optional. Content-Encoding of the object data, matching
-     * [https://tools.ietf.org/html/rfc7231#section-3.1.2.2][RFC 7231 §3.1.2.2]
+     * [RFC 7231 §3.1.2.2](https://tools.ietf.org/html/rfc7231#section-3.1.2.2)
      * 
                                            
      *
      * string content_encoding = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -5349,7 +5349,7 @@ public java.lang.String getContentEncoding() {
      *
      * 
                                                  * Optional. Content-Encoding of the object data, matching
-     * [https://tools.ietf.org/html/rfc7231#section-3.1.2.2][RFC 7231 §3.1.2.2]
+     * [RFC 7231 §3.1.2.2](https://tools.ietf.org/html/rfc7231#section-3.1.2.2)
      * 
                                            
      *
      * string content_encoding = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -5373,7 +5373,7 @@ public com.google.protobuf.ByteString getContentEncodingBytes() {
      *
      * 
                                                  * Optional. Content-Encoding of the object data, matching
-     * [https://tools.ietf.org/html/rfc7231#section-3.1.2.2][RFC 7231 §3.1.2.2]
+     * [RFC 7231 §3.1.2.2](https://tools.ietf.org/html/rfc7231#section-3.1.2.2)
      * 
                                            
      *
      * string content_encoding = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -5396,7 +5396,7 @@ public Builder setContentEncoding(java.lang.String value) {
      *
      * 
                                                  * Optional. Content-Encoding of the object data, matching
-     * [https://tools.ietf.org/html/rfc7231#section-3.1.2.2][RFC 7231 §3.1.2.2]
+     * [RFC 7231 §3.1.2.2](https://tools.ietf.org/html/rfc7231#section-3.1.2.2)
      * 
                                            
      *
      * string content_encoding = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -5415,7 +5415,7 @@ public Builder clearContentEncoding() {
      *
      * 
                                                  * Optional. Content-Encoding of the object data, matching
-     * [https://tools.ietf.org/html/rfc7231#section-3.1.2.2][RFC 7231 §3.1.2.2]
+     * [RFC 7231 §3.1.2.2](https://tools.ietf.org/html/rfc7231#section-3.1.2.2)
      * 
                                            
      *
      * string content_encoding = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -5441,7 +5441,7 @@ public Builder setContentEncodingBytes(com.google.protobuf.ByteString value) {
      *
      * 
                                                  * Optional. Content-Disposition of the object data, matching
-     * [https://tools.ietf.org/html/rfc6266][RFC 6266].
+     * [RFC 6266](https://tools.ietf.org/html/rfc6266).
      * 
                                            
      *
      * string content_disposition = 8 [(.google.api.field_behavior) = OPTIONAL];
@@ -5465,7 +5465,7 @@ public java.lang.String getContentDisposition() {
      *
      * 
                                                  * Optional. Content-Disposition of the object data, matching
-     * [https://tools.ietf.org/html/rfc6266][RFC 6266].
+     * [RFC 6266](https://tools.ietf.org/html/rfc6266).
      * 
                                            
      *
      * string content_disposition = 8 [(.google.api.field_behavior) = OPTIONAL];
@@ -5489,7 +5489,7 @@ public com.google.protobuf.ByteString getContentDispositionBytes() {
      *
      * 
                                                  * Optional. Content-Disposition of the object data, matching
-     * [https://tools.ietf.org/html/rfc6266][RFC 6266].
+     * [RFC 6266](https://tools.ietf.org/html/rfc6266).
      * 
                                            
      *
      * string content_disposition = 8 [(.google.api.field_behavior) = OPTIONAL];
@@ -5512,7 +5512,7 @@ public Builder setContentDisposition(java.lang.String value) {
      *
      * 
                                                  * Optional. Content-Disposition of the object data, matching
-     * [https://tools.ietf.org/html/rfc6266][RFC 6266].
+     * [RFC 6266](https://tools.ietf.org/html/rfc6266).
      * 
                                            
      *
      * string content_disposition = 8 [(.google.api.field_behavior) = OPTIONAL];
@@ -5531,7 +5531,7 @@ public Builder clearContentDisposition() {
      *
      * 
                                                  * Optional. Content-Disposition of the object data, matching
-     * [https://tools.ietf.org/html/rfc6266][RFC 6266].
+     * [RFC 6266](https://tools.ietf.org/html/rfc6266).
      * 
                                            
      *
      * string content_disposition = 8 [(.google.api.field_behavior) = OPTIONAL];
@@ -5557,9 +5557,9 @@ public Builder setContentDispositionBytes(com.google.protobuf.ByteString value)
      *
      * 
                                                  * Optional. Cache-Control directive for the object data, matching
-     * [https://tools.ietf.org/html/rfc7234#section-5.2"][RFC 7234 §5.2].
+     * [RFC 7234 §5.2](https://tools.ietf.org/html/rfc7234#section-5.2).
      * If omitted, and the object is accessible to all anonymous users, the
-     * default will be `public, max-age=3600`.
+     * default is `public, max-age=3600`.
      * 
                                            
      *
      * string cache_control = 9 [(.google.api.field_behavior) = OPTIONAL];
@@ -5583,9 +5583,9 @@ public java.lang.String getCacheControl() {
      *
      * 
                                                  * Optional. Cache-Control directive for the object data, matching
-     * [https://tools.ietf.org/html/rfc7234#section-5.2"][RFC 7234 §5.2].
+     * [RFC 7234 §5.2](https://tools.ietf.org/html/rfc7234#section-5.2).
      * If omitted, and the object is accessible to all anonymous users, the
-     * default will be `public, max-age=3600`.
+     * default is `public, max-age=3600`.
      * 
                                            
      *
      * string cache_control = 9 [(.google.api.field_behavior) = OPTIONAL];
@@ -5609,9 +5609,9 @@ public com.google.protobuf.ByteString getCacheControlBytes() {
      *
      * 
                                                  * Optional. Cache-Control directive for the object data, matching
-     * [https://tools.ietf.org/html/rfc7234#section-5.2"][RFC 7234 §5.2].
+     * [RFC 7234 §5.2](https://tools.ietf.org/html/rfc7234#section-5.2).
      * If omitted, and the object is accessible to all anonymous users, the
-     * default will be `public, max-age=3600`.
+     * default is `public, max-age=3600`.
      * 
                                            
      *
      * string cache_control = 9 [(.google.api.field_behavior) = OPTIONAL];
@@ -5634,9 +5634,9 @@ public Builder setCacheControl(java.lang.String value) {
      *
      * 
                                                  * Optional. Cache-Control directive for the object data, matching
-     * [https://tools.ietf.org/html/rfc7234#section-5.2"][RFC 7234 §5.2].
+     * [RFC 7234 §5.2](https://tools.ietf.org/html/rfc7234#section-5.2).
      * If omitted, and the object is accessible to all anonymous users, the
-     * default will be `public, max-age=3600`.
+     * default is `public, max-age=3600`.
      * 
                                            
      *
      * string cache_control = 9 [(.google.api.field_behavior) = OPTIONAL];
@@ -5655,9 +5655,9 @@ public Builder clearCacheControl() {
      *
      * 
                                                  * Optional. Cache-Control directive for the object data, matching
-     * [https://tools.ietf.org/html/rfc7234#section-5.2"][RFC 7234 §5.2].
+     * [RFC 7234 §5.2](https://tools.ietf.org/html/rfc7234#section-5.2).
      * If omitted, and the object is accessible to all anonymous users, the
-     * default will be `public, max-age=3600`.
+     * default is `public, max-age=3600`.
      * 
                                            
      *
      * string cache_control = 9 [(.google.api.field_behavior) = OPTIONAL];
@@ -5697,7 +5697,7 @@ private void ensureAclIsMutable() {
      *
      * 
                                                  * Optional. Access controls on the object.
-     * If iam_config.uniform_bucket_level_access is enabled on the parent
+     * If `iam_config.uniform_bucket_level_access` is enabled on the parent
      * bucket, requests to set, read, or modify acl is an error.
      * 
                                            
      *
@@ -5718,7 +5718,7 @@ public java.util.List getAclList() {
      *
      * 
                                                  * Optional. Access controls on the object.
-     * If iam_config.uniform_bucket_level_access is enabled on the parent
+     * If `iam_config.uniform_bucket_level_access` is enabled on the parent
      * bucket, requests to set, read, or modify acl is an error.
      * 
                                            
      *
@@ -5739,7 +5739,7 @@ public int getAclCount() {
      *
      * 
                                                  * Optional. Access controls on the object.
-     * If iam_config.uniform_bucket_level_access is enabled on the parent
+     * If `iam_config.uniform_bucket_level_access` is enabled on the parent
      * bucket, requests to set, read, or modify acl is an error.
      * 
                                            
      *
@@ -5760,7 +5760,7 @@ public com.google.storage.v2.ObjectAccessControl getAcl(int index) {
      *
      * 
                                                  * Optional. Access controls on the object.
-     * If iam_config.uniform_bucket_level_access is enabled on the parent
+     * If `iam_config.uniform_bucket_level_access` is enabled on the parent
      * bucket, requests to set, read, or modify acl is an error.
      * 
                                            
      *
@@ -5787,7 +5787,7 @@ public Builder setAcl(int index, com.google.storage.v2.ObjectAccessControl value
      *
      * 
                                                  * Optional. Access controls on the object.
-     * If iam_config.uniform_bucket_level_access is enabled on the parent
+     * If `iam_config.uniform_bucket_level_access` is enabled on the parent
      * bucket, requests to set, read, or modify acl is an error.
      * 
                                            
      *
@@ -5812,7 +5812,7 @@ public Builder setAcl(
      *
      * 
                                                  * Optional. Access controls on the object.
-     * If iam_config.uniform_bucket_level_access is enabled on the parent
+     * If `iam_config.uniform_bucket_level_access` is enabled on the parent
      * bucket, requests to set, read, or modify acl is an error.
      * 
                                            
      *
@@ -5839,7 +5839,7 @@ public Builder addAcl(com.google.storage.v2.ObjectAccessControl value) {
      *
      * 
                                                  * Optional. Access controls on the object.
-     * If iam_config.uniform_bucket_level_access is enabled on the parent
+     * If `iam_config.uniform_bucket_level_access` is enabled on the parent
      * bucket, requests to set, read, or modify acl is an error.
      * 
                                            
      *
@@ -5866,7 +5866,7 @@ public Builder addAcl(int index, com.google.storage.v2.ObjectAccessControl value
      *
      * 
                                                  * Optional. Access controls on the object.
-     * If iam_config.uniform_bucket_level_access is enabled on the parent
+     * If `iam_config.uniform_bucket_level_access` is enabled on the parent
      * bucket, requests to set, read, or modify acl is an error.
      * 
                                            
      *
@@ -5890,7 +5890,7 @@ public Builder addAcl(com.google.storage.v2.ObjectAccessControl.Builder builderF
      *
      * 
                                                  * Optional. Access controls on the object.
-     * If iam_config.uniform_bucket_level_access is enabled on the parent
+     * If `iam_config.uniform_bucket_level_access` is enabled on the parent
      * bucket, requests to set, read, or modify acl is an error.
      * 
                                            
      *
@@ -5915,7 +5915,7 @@ public Builder addAcl(
      *
      * 
                                                  * Optional. Access controls on the object.
-     * If iam_config.uniform_bucket_level_access is enabled on the parent
+     * If `iam_config.uniform_bucket_level_access` is enabled on the parent
      * bucket, requests to set, read, or modify acl is an error.
      * 
                                            
      *
@@ -5940,7 +5940,7 @@ public Builder addAllAcl(
      *
      * 
                                                  * Optional. Access controls on the object.
-     * If iam_config.uniform_bucket_level_access is enabled on the parent
+     * If `iam_config.uniform_bucket_level_access` is enabled on the parent
      * bucket, requests to set, read, or modify acl is an error.
      * 
                                            
      *
@@ -5964,7 +5964,7 @@ public Builder clearAcl() {
      *
      * 
                                                  * Optional. Access controls on the object.
-     * If iam_config.uniform_bucket_level_access is enabled on the parent
+     * If `iam_config.uniform_bucket_level_access` is enabled on the parent
      * bucket, requests to set, read, or modify acl is an error.
      * 
                                            
      *
@@ -5988,7 +5988,7 @@ public Builder removeAcl(int index) {
      *
      * 
                                                  * Optional. Access controls on the object.
-     * If iam_config.uniform_bucket_level_access is enabled on the parent
+     * If `iam_config.uniform_bucket_level_access` is enabled on the parent
      * bucket, requests to set, read, or modify acl is an error.
      * 
                                            
      *
@@ -6005,7 +6005,7 @@ public com.google.storage.v2.ObjectAccessControl.Builder getAclBuilder(int index
      *
      * 
                                                  * Optional. Access controls on the object.
-     * If iam_config.uniform_bucket_level_access is enabled on the parent
+     * If `iam_config.uniform_bucket_level_access` is enabled on the parent
      * bucket, requests to set, read, or modify acl is an error.
      * 
                                            
      *
@@ -6026,7 +6026,7 @@ public com.google.storage.v2.ObjectAccessControlOrBuilder getAclOrBuilder(int in
      *
      * 
                                                  * Optional. Access controls on the object.
-     * If iam_config.uniform_bucket_level_access is enabled on the parent
+     * If `iam_config.uniform_bucket_level_access` is enabled on the parent
      * bucket, requests to set, read, or modify acl is an error.
      * 
                                            
      *
@@ -6048,7 +6048,7 @@ public com.google.storage.v2.ObjectAccessControlOrBuilder getAclOrBuilder(int in
      *
      * 
                                                  * Optional. Access controls on the object.
-     * If iam_config.uniform_bucket_level_access is enabled on the parent
+     * If `iam_config.uniform_bucket_level_access` is enabled on the parent
      * bucket, requests to set, read, or modify acl is an error.
      * 
                                            
      *
@@ -6066,7 +6066,7 @@ public com.google.storage.v2.ObjectAccessControl.Builder addAclBuilder() {
      *
      * 
                                                  * Optional. Access controls on the object.
-     * If iam_config.uniform_bucket_level_access is enabled on the parent
+     * If `iam_config.uniform_bucket_level_access` is enabled on the parent
      * bucket, requests to set, read, or modify acl is an error.
      * 
                                            
      *
@@ -6084,7 +6084,7 @@ public com.google.storage.v2.ObjectAccessControl.Builder addAclBuilder(int index
      *
      * 
                                                  * Optional. Access controls on the object.
-     * If iam_config.uniform_bucket_level_access is enabled on the parent
+     * If `iam_config.uniform_bucket_level_access` is enabled on the parent
      * bucket, requests to set, read, or modify acl is an error.
      * 
                                            
      *
@@ -6120,7 +6120,7 @@ public java.util.List getAclB
      *
      * 
                                                  * Optional. Content-Language of the object data, matching
-     * [https://tools.ietf.org/html/rfc7231#section-3.1.3.2][RFC 7231 §3.1.3.2].
+     * [RFC 7231 §3.1.3.2](https://tools.ietf.org/html/rfc7231#section-3.1.3.2).
      * 
                                            
      *
      * string content_language = 11 [(.google.api.field_behavior) = OPTIONAL];
@@ -6144,7 +6144,7 @@ public java.lang.String getContentLanguage() {
      *
      * 
                                                  * Optional. Content-Language of the object data, matching
-     * [https://tools.ietf.org/html/rfc7231#section-3.1.3.2][RFC 7231 §3.1.3.2].
+     * [RFC 7231 §3.1.3.2](https://tools.ietf.org/html/rfc7231#section-3.1.3.2).
      * 
                                            
      *
      * string content_language = 11 [(.google.api.field_behavior) = OPTIONAL];
@@ -6168,7 +6168,7 @@ public com.google.protobuf.ByteString getContentLanguageBytes() {
      *
      * 
                                                  * Optional. Content-Language of the object data, matching
-     * [https://tools.ietf.org/html/rfc7231#section-3.1.3.2][RFC 7231 §3.1.3.2].
+     * [RFC 7231 §3.1.3.2](https://tools.ietf.org/html/rfc7231#section-3.1.3.2).
      * 
                                            
      *
      * string content_language = 11 [(.google.api.field_behavior) = OPTIONAL];
@@ -6191,7 +6191,7 @@ public Builder setContentLanguage(java.lang.String value) {
      *
      * 
                                                  * Optional. Content-Language of the object data, matching
-     * [https://tools.ietf.org/html/rfc7231#section-3.1.3.2][RFC 7231 §3.1.3.2].
+     * [RFC 7231 §3.1.3.2](https://tools.ietf.org/html/rfc7231#section-3.1.3.2).
      * 
                                            
      *
      * string content_language = 11 [(.google.api.field_behavior) = OPTIONAL];
@@ -6210,7 +6210,7 @@ public Builder clearContentLanguage() {
      *
      * 
                                                  * Optional. Content-Language of the object data, matching
-     * [https://tools.ietf.org/html/rfc7231#section-3.1.3.2][RFC 7231 §3.1.3.2].
+     * [RFC 7231 §3.1.3.2](https://tools.ietf.org/html/rfc7231#section-3.1.3.2).
      * 
                                            
      *
      * string content_language = 11 [(.google.api.field_behavior) = OPTIONAL];
@@ -6669,7 +6669,7 @@ public com.google.protobuf.TimestampOrBuilder getFinalizeTimeOrBuilder() {
      *
      * 
                                                  * Optional. Content-Type of the object data, matching
-     * [https://tools.ietf.org/html/rfc7231#section-3.1.1.5][RFC 7231 §3.1.1.5].
+     * [RFC 7231 §3.1.1.5](https://tools.ietf.org/html/rfc7231#section-3.1.1.5).
      * If an object is stored without a Content-Type, it is served as
      * `application/octet-stream`.
      * 
                                            
@@ -6695,7 +6695,7 @@ public java.lang.String getContentType() {
      *
      * 
                                                  * Optional. Content-Type of the object data, matching
-     * [https://tools.ietf.org/html/rfc7231#section-3.1.1.5][RFC 7231 §3.1.1.5].
+     * [RFC 7231 §3.1.1.5](https://tools.ietf.org/html/rfc7231#section-3.1.1.5).
      * If an object is stored without a Content-Type, it is served as
      * `application/octet-stream`.
      * 
                                            
@@ -6721,7 +6721,7 @@ public com.google.protobuf.ByteString getContentTypeBytes() {
      *
      * 
                                                  * Optional. Content-Type of the object data, matching
-     * [https://tools.ietf.org/html/rfc7231#section-3.1.1.5][RFC 7231 §3.1.1.5].
+     * [RFC 7231 §3.1.1.5](https://tools.ietf.org/html/rfc7231#section-3.1.1.5).
      * If an object is stored without a Content-Type, it is served as
      * `application/octet-stream`.
      * 
                                            
@@ -6746,7 +6746,7 @@ public Builder setContentType(java.lang.String value) {
      *
      * 
                                                  * Optional. Content-Type of the object data, matching
-     * [https://tools.ietf.org/html/rfc7231#section-3.1.1.5][RFC 7231 §3.1.1.5].
+     * [RFC 7231 §3.1.1.5](https://tools.ietf.org/html/rfc7231#section-3.1.1.5).
      * If an object is stored without a Content-Type, it is served as
      * `application/octet-stream`.
      * 
                                            
@@ -6767,7 +6767,7 @@ public Builder clearContentType() {
      *
      * 
                                                  * Optional. Content-Type of the object data, matching
-     * [https://tools.ietf.org/html/rfc7231#section-3.1.1.5][RFC 7231 §3.1.1.5].
+     * [RFC 7231 §3.1.1.5](https://tools.ietf.org/html/rfc7231#section-3.1.1.5).
      * If an object is stored without a Content-Type, it is served as
      * `application/octet-stream`.
      * 
                                            
@@ -7071,7 +7071,7 @@ public Builder clearComponentCount() {
      *
      * 
                                                  * Output only. Hashes for the data part of this object. This field is used
-     * for output only and will be silently ignored if provided in requests. The
+     * for output only and is silently ignored if provided in requests. The
      * checksums of the complete object regardless of data range. If the object is
      * downloaded in full, the client should compute one of these checksums over
      * the downloaded object and compare it against the value provided here.
@@ -7092,7 +7092,7 @@ public boolean hasChecksums() {
      *
      * 
                                                  * Output only. Hashes for the data part of this object. This field is used
-     * for output only and will be silently ignored if provided in requests. The
+     * for output only and is silently ignored if provided in requests. The
      * checksums of the complete object regardless of data range. If the object is
      * downloaded in full, the client should compute one of these checksums over
      * the downloaded object and compare it against the value provided here.
@@ -7119,7 +7119,7 @@ public com.google.storage.v2.ObjectChecksums getChecksums() {
      *
      * 
                                                  * Output only. Hashes for the data part of this object. This field is used
-     * for output only and will be silently ignored if provided in requests. The
+     * for output only and is silently ignored if provided in requests. The
      * checksums of the complete object regardless of data range. If the object is
      * downloaded in full, the client should compute one of these checksums over
      * the downloaded object and compare it against the value provided here.
@@ -7148,7 +7148,7 @@ public Builder setChecksums(com.google.storage.v2.ObjectChecksums value) {
      *
      * 
                                                  * Output only. Hashes for the data part of this object. This field is used
-     * for output only and will be silently ignored if provided in requests. The
+     * for output only and is silently ignored if provided in requests. The
      * checksums of the complete object regardless of data range. If the object is
      * downloaded in full, the client should compute one of these checksums over
      * the downloaded object and compare it against the value provided here.
@@ -7174,7 +7174,7 @@ public Builder setChecksums(com.google.storage.v2.ObjectChecksums.Builder builde
      *
      * 
                                                  * Output only. Hashes for the data part of this object. This field is used
-     * for output only and will be silently ignored if provided in requests. The
+     * for output only and is silently ignored if provided in requests. The
      * checksums of the complete object regardless of data range. If the object is
      * downloaded in full, the client should compute one of these checksums over
      * the downloaded object and compare it against the value provided here.
@@ -7208,7 +7208,7 @@ public Builder mergeChecksums(com.google.storage.v2.ObjectChecksums value) {
      *
      * 
                                                  * Output only. Hashes for the data part of this object. This field is used
-     * for output only and will be silently ignored if provided in requests. The
+     * for output only and is silently ignored if provided in requests. The
      * checksums of the complete object regardless of data range. If the object is
      * downloaded in full, the client should compute one of these checksums over
      * the downloaded object and compare it against the value provided here.
@@ -7234,7 +7234,7 @@ public Builder clearChecksums() {
      *
      * 
                                                  * Output only. Hashes for the data part of this object. This field is used
-     * for output only and will be silently ignored if provided in requests. The
+     * for output only and is silently ignored if provided in requests. The
      * checksums of the complete object regardless of data range. If the object is
      * downloaded in full, the client should compute one of these checksums over
      * the downloaded object and compare it against the value provided here.
@@ -7255,7 +7255,7 @@ public com.google.storage.v2.ObjectChecksums.Builder getChecksumsBuilder() {
      *
      * 
                                                  * Output only. Hashes for the data part of this object. This field is used
-     * for output only and will be silently ignored if provided in requests. The
+     * for output only and is silently ignored if provided in requests. The
      * checksums of the complete object regardless of data range. If the object is
      * downloaded in full, the client should compute one of these checksums over
      * the downloaded object and compare it against the value provided here.
@@ -7280,7 +7280,7 @@ public com.google.storage.v2.ObjectChecksumsOrBuilder getChecksumsOrBuilder() {
      *
      * 
                                                  * Output only. Hashes for the data part of this object. This field is used
-     * for output only and will be silently ignored if provided in requests. The
+     * for output only and is silently ignored if provided in requests. The
      * checksums of the complete object regardless of data range. If the object is
      * downloaded in full, the client should compute one of these checksums over
      * the downloaded object and compare it against the value provided here.
@@ -7702,7 +7702,7 @@ public Builder setKmsKeyBytes(com.google.protobuf.ByteString value) {
      *
      * 
                                                  * Output only. The time at which the object's storage class was last changed.
-     * When the object is initially created, it will be set to time_created.
+     * When the object is initially created, it is set to `time_created`.
      * 
                                            
      *
      * 
@@ -7720,7 +7720,7 @@ public boolean hasUpdateStorageClassTime() {
      *
      * 
                                                  * Output only. The time at which the object's storage class was last changed.
-     * When the object is initially created, it will be set to time_created.
+     * When the object is initially created, it is set to `time_created`.
      * 
                                            
      *
      * 
@@ -7744,7 +7744,7 @@ public com.google.protobuf.Timestamp getUpdateStorageClassTime() {
      *
      * 
                                                  * Output only. The time at which the object's storage class was last changed.
-     * When the object is initially created, it will be set to time_created.
+     * When the object is initially created, it is set to `time_created`.
      * 
                                            
      *
      * 
@@ -7770,7 +7770,7 @@ public Builder setUpdateStorageClassTime(com.google.protobuf.Timestamp value) {
      *
      * 
                                                  * Output only. The time at which the object's storage class was last changed.
-     * When the object is initially created, it will be set to time_created.
+     * When the object is initially created, it is set to `time_created`.
      * 
                                            
      *
      * 
@@ -7794,7 +7794,7 @@ public Builder setUpdateStorageClassTime(
      *
      * 
                                                  * Output only. The time at which the object's storage class was last changed.
-     * When the object is initially created, it will be set to time_created.
+     * When the object is initially created, it is set to `time_created`.
      * 
                                            
      *
      * 
@@ -7825,7 +7825,7 @@ public Builder mergeUpdateStorageClassTime(com.google.protobuf.Timestamp value)
      *
      * 
                                                  * Output only. The time at which the object's storage class was last changed.
-     * When the object is initially created, it will be set to time_created.
+     * When the object is initially created, it is set to `time_created`.
      * 
                                            
      *
      * 
@@ -7848,7 +7848,7 @@ public Builder clearUpdateStorageClassTime() {
      *
      * 
                                                  * Output only. The time at which the object's storage class was last changed.
-     * When the object is initially created, it will be set to time_created.
+     * When the object is initially created, it is set to `time_created`.
      * 
                                            
      *
      * 
@@ -7866,7 +7866,7 @@ public com.google.protobuf.Timestamp.Builder getUpdateStorageClassTimeBuilder()
      *
      * 
                                                  * Output only. The time at which the object's storage class was last changed.
-     * When the object is initially created, it will be set to time_created.
+     * When the object is initially created, it is set to `time_created`.
      * 
                                            
      *
      * 
@@ -7888,7 +7888,7 @@ public com.google.protobuf.TimestampOrBuilder getUpdateStorageClassTimeOrBuilder
      *
      * 
                                                  * Output only. The time at which the object's storage class was last changed.
-     * When the object is initially created, it will be set to time_created.
+     * When the object is initially created, it is set to `time_created`.
      * 
                                            
      *
      * 
@@ -8659,14 +8659,14 @@ public com.google.storage.v2.ObjectContextsOrBuilder getContextsOrBuilder() {
      * 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
-     * this field to false, the object will become subject to any bucket-level
-     * retention policy, except that the retention duration will be calculated
+     * this field to `false`, the object becomes subject to any bucket-level
+     * retention policy, except that the retention duration is calculated
      * from the time the event based hold was lifted, rather than the time the
      * object was created.
      *
-     * In a WriteObject request, not setting this field implies that the value
-     * should be taken from the parent bucket's "default_event_based_hold" field.
-     * In a response, this field will always be set to true or false.
+     * In a `WriteObject` request, not setting this field implies that the value
+     * should be taken from the parent bucket's `default_event_based_hold` field.
+     * In a response, this field is always set to `true` or `false`.
      * 
                                            
      *
      * optional bool event_based_hold = 23;
@@ -8685,14 +8685,14 @@ public boolean hasEventBasedHold() {
      * 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
-     * this field to false, the object will become subject to any bucket-level
-     * retention policy, except that the retention duration will be calculated
+     * this field to `false`, the object becomes subject to any bucket-level
+     * retention policy, except that the retention duration is calculated
      * from the time the event based hold was lifted, rather than the time the
      * object was created.
      *
-     * In a WriteObject request, not setting this field implies that the value
-     * should be taken from the parent bucket's "default_event_based_hold" field.
-     * In a response, this field will always be set to true or false.
+     * In a `WriteObject` request, not setting this field implies that the value
+     * should be taken from the parent bucket's `default_event_based_hold` field.
+     * In a response, this field is always set to `true` or `false`.
      * 
                                            
      *
      * optional bool event_based_hold = 23;
@@ -8711,14 +8711,14 @@ public boolean getEventBasedHold() {
      * 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
-     * this field to false, the object will become subject to any bucket-level
-     * retention policy, except that the retention duration will be calculated
+     * this field to `false`, the object becomes subject to any bucket-level
+     * retention policy, except that the retention duration is calculated
      * from the time the event based hold was lifted, rather than the time the
      * object was created.
      *
-     * In a WriteObject request, not setting this field implies that the value
-     * should be taken from the parent bucket's "default_event_based_hold" field.
-     * In a response, this field will always be set to true or false.
+     * In a `WriteObject` request, not setting this field implies that the value
+     * should be taken from the parent bucket's `default_event_based_hold` field.
+     * In a response, this field is always set to `true` or `false`.
      * 
                                            
      *
      * optional bool event_based_hold = 23;
@@ -8741,14 +8741,14 @@ public Builder setEventBasedHold(boolean value) {
      * 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
-     * this field to false, the object will become subject to any bucket-level
-     * retention policy, except that the retention duration will be calculated
+     * this field to `false`, the object becomes subject to any bucket-level
+     * retention policy, except that the retention duration is calculated
      * from the time the event based hold was lifted, rather than the time the
      * object was created.
      *
-     * In a WriteObject request, not setting this field implies that the value
-     * should be taken from the parent bucket's "default_event_based_hold" field.
-     * In a response, this field will always be set to true or false.
+     * In a `WriteObject` request, not setting this field implies that the value
+     * should be taken from the parent bucket's `default_event_based_hold` field.
+     * In a response, this field is always set to `true` or `false`.
      * 
                                            
      *
      * optional bool event_based_hold = 23;
@@ -8773,8 +8773,8 @@ public Builder clearEventBasedHold() {
      *
      *
      * 
                                            -     * Output only. The owner of the object. This will always be the uploader of
-     * the object.
+     * Output only. The owner of the object. This is always the uploader of the
+     * object.
      * 
                                            
      *
      * .google.storage.v2.Owner owner = 24 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -8790,8 +8790,8 @@ public boolean hasOwner() {
      *
      *
      * 
                                            -     * Output only. The owner of the object. This will always be the uploader of
-     * the object.
+     * Output only. The owner of the object. This is always the uploader of the
+     * object.
      * 
                                            
      *
      * .google.storage.v2.Owner owner = 24 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -8811,8 +8811,8 @@ public com.google.storage.v2.Owner getOwner() {
      *
      *
      * 
                                            -     * Output only. The owner of the object. This will always be the uploader of
-     * the object.
+     * Output only. The owner of the object. This is always the uploader of the
+     * object.
      * 
                                            
      *
      * .google.storage.v2.Owner owner = 24 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -8836,8 +8836,8 @@ public Builder setOwner(com.google.storage.v2.Owner value) {
      *
      *
      * 
                                            -     * Output only. The owner of the object. This will always be the uploader of
-     * the object.
+     * Output only. The owner of the object. This is always the uploader of the
+     * object.
      * 
                                            
      *
      * .google.storage.v2.Owner owner = 24 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -8858,8 +8858,8 @@ public Builder setOwner(com.google.storage.v2.Owner.Builder builderForValue) {
      *
      *
      * 
                                            -     * Output only. The owner of the object. This will always be the uploader of
-     * the object.
+     * Output only. The owner of the object. This is always the uploader of the
+     * object.
      * 
                                            
      *
      * .google.storage.v2.Owner owner = 24 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -8888,8 +8888,8 @@ public Builder mergeOwner(com.google.storage.v2.Owner value) {
      *
      *
      * 
                                            -     * Output only. The owner of the object. This will always be the uploader of
-     * the object.
+     * Output only. The owner of the object. This is always the uploader of the
+     * object.
      * 
                                            
      *
      * .google.storage.v2.Owner owner = 24 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -8910,8 +8910,8 @@ public Builder clearOwner() {
      *
      *
      * 
                                            -     * Output only. The owner of the object. This will always be the uploader of
-     * the object.
+     * Output only. The owner of the object. This is always the uploader of the
+     * object.
      * 
                                            
      *
      * .google.storage.v2.Owner owner = 24 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -8927,8 +8927,8 @@ public com.google.storage.v2.Owner.Builder getOwnerBuilder() {
      *
      *
      * 
                                            -     * Output only. The owner of the object. This will always be the uploader of
-     * the object.
+     * Output only. The owner of the object. This is always the uploader of the
+     * object.
      * 
                                            
      *
      * .google.storage.v2.Owner owner = 24 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -8946,8 +8946,8 @@ public com.google.storage.v2.OwnerOrBuilder getOwnerOrBuilder() {
      *
      *
      * 
                                            -     * Output only. The owner of the object. This will always be the uploader of
-     * the object.
+     * Output only. The owner of the object. This is always the uploader of the
+     * object.
      * 
                                            
      *
      * .google.storage.v2.Owner owner = 24 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -8981,7 +8981,7 @@ public com.google.storage.v2.OwnerOrBuilder getOwnerOrBuilder() {
      *
      *
      * 
                                            -     * Optional. Metadata of Customer-Supplied Encryption Key, if the object is
+     * Optional. Metadata of customer-supplied encryption key, if the object is
      * encrypted by such a key.
      * 
                                            
      *
@@ -8999,7 +8999,7 @@ public boolean hasCustomerEncryption() {
      *
      *
      * 
                                            -     * Optional. Metadata of Customer-Supplied Encryption Key, if the object is
+     * Optional. Metadata of customer-supplied encryption key, if the object is
      * encrypted by such a key.
      * 
                                            
      *
@@ -9023,7 +9023,7 @@ public com.google.storage.v2.CustomerEncryption getCustomerEncryption() {
      *
      *
      * 
                                            -     * Optional. Metadata of Customer-Supplied Encryption Key, if the object is
+     * Optional. Metadata of customer-supplied encryption key, if the object is
      * encrypted by such a key.
      * 
                                            
      *
@@ -9049,7 +9049,7 @@ public Builder setCustomerEncryption(com.google.storage.v2.CustomerEncryption va
      *
      *
      * 
                                            -     * Optional. Metadata of Customer-Supplied Encryption Key, if the object is
+     * Optional. Metadata of customer-supplied encryption key, if the object is
      * encrypted by such a key.
      * 
                                            
      *
@@ -9073,7 +9073,7 @@ public Builder setCustomerEncryption(
      *
      *
      * 
                                            -     * Optional. Metadata of Customer-Supplied Encryption Key, if the object is
+     * Optional. Metadata of customer-supplied encryption key, if the object is
      * encrypted by such a key.
      * 
                                            
      *
@@ -9105,7 +9105,7 @@ public Builder mergeCustomerEncryption(com.google.storage.v2.CustomerEncryption
      *
      *
      * 
                                            -     * Optional. Metadata of Customer-Supplied Encryption Key, if the object is
+     * Optional. Metadata of customer-supplied encryption key, if the object is
      * encrypted by such a key.
      * 
                                            
      *
@@ -9128,7 +9128,7 @@ public Builder clearCustomerEncryption() {
      *
      *
      * 
                                            -     * Optional. Metadata of Customer-Supplied Encryption Key, if the object is
+     * Optional. Metadata of customer-supplied encryption key, if the object is
      * encrypted by such a key.
      * 
                                            
      *
@@ -9146,7 +9146,7 @@ public com.google.storage.v2.CustomerEncryption.Builder getCustomerEncryptionBui
      *
      *
      * 
                                            -     * Optional. Metadata of Customer-Supplied Encryption Key, if the object is
+     * Optional. Metadata of customer-supplied encryption key, if the object is
      * encrypted by such a key.
      * 
                                            
      *
@@ -9168,7 +9168,7 @@ public com.google.storage.v2.CustomerEncryptionOrBuilder getCustomerEncryptionOr
      *
      *
      * 
                                            -     * Optional. Metadata of Customer-Supplied Encryption Key, if the object is
+     * Optional. Metadata of customer-supplied encryption key, if the object is
      * encrypted by such a key.
      * 
                                            
      *
@@ -9410,7 +9410,7 @@ public com.google.protobuf.TimestampOrBuilder getCustomTimeOrBuilder() {
      * Output only. This is the time when the object became soft-deleted.
      *
      * Soft-deleted objects are only accessible if a soft_delete_policy is
-     * enabled. Also see hard_delete_time.
+     * enabled. Also see `hard_delete_time`.
      * 
                                            
      *
      * 
@@ -9430,7 +9430,7 @@ public boolean hasSoftDeleteTime() {
      * Output only. This is the time when the object became soft-deleted.
      *
      * Soft-deleted objects are only accessible if a soft_delete_policy is
-     * enabled. Also see hard_delete_time.
+     * enabled. Also see `hard_delete_time`.
      * 
                                            
      *
      * 
@@ -9456,7 +9456,7 @@ public com.google.protobuf.Timestamp getSoftDeleteTime() {
      * Output only. This is the time when the object became soft-deleted.
      *
      * Soft-deleted objects are only accessible if a soft_delete_policy is
-     * enabled. Also see hard_delete_time.
+     * enabled. Also see `hard_delete_time`.
      * 
                                            
      *
      * 
@@ -9484,7 +9484,7 @@ public Builder setSoftDeleteTime(com.google.protobuf.Timestamp value) {
      * Output only. This is the time when the object became soft-deleted.
      *
      * Soft-deleted objects are only accessible if a soft_delete_policy is
-     * enabled. Also see hard_delete_time.
+     * enabled. Also see `hard_delete_time`.
      * 
                                            
      *
      * 
@@ -9509,7 +9509,7 @@ public Builder setSoftDeleteTime(com.google.protobuf.Timestamp.Builder builderFo
      * Output only. This is the time when the object became soft-deleted.
      *
      * Soft-deleted objects are only accessible if a soft_delete_policy is
-     * enabled. Also see hard_delete_time.
+     * enabled. Also see `hard_delete_time`.
      * 
                                            
      *
      * 
@@ -9542,7 +9542,7 @@ public Builder mergeSoftDeleteTime(com.google.protobuf.Timestamp value) {
      * Output only. This is the time when the object became soft-deleted.
      *
      * Soft-deleted objects are only accessible if a soft_delete_policy is
-     * enabled. Also see hard_delete_time.
+     * enabled. Also see `hard_delete_time`.
      * 
                                            
      *
      * 
@@ -9567,7 +9567,7 @@ public Builder clearSoftDeleteTime() {
      * Output only. This is the time when the object became soft-deleted.
      *
      * Soft-deleted objects are only accessible if a soft_delete_policy is
-     * enabled. Also see hard_delete_time.
+     * enabled. Also see `hard_delete_time`.
      * 
                                            
      *
      * 
@@ -9587,7 +9587,7 @@ public com.google.protobuf.Timestamp.Builder getSoftDeleteTimeBuilder() {
      * Output only. This is the time when the object became soft-deleted.
      *
      * Soft-deleted objects are only accessible if a soft_delete_policy is
-     * enabled. Also see hard_delete_time.
+     * enabled. Also see `hard_delete_time`.
      * 
                                            
      *
      * 
@@ -9611,7 +9611,7 @@ public com.google.protobuf.TimestampOrBuilder getSoftDeleteTimeOrBuilder() {
      * Output only. This is the time when the object became soft-deleted.
      *
      * Soft-deleted objects are only accessible if a soft_delete_policy is
-     * enabled. Also see hard_delete_time.
+     * enabled. Also see `hard_delete_time`.
      * 
                                            
      *
      * 
@@ -9646,10 +9646,10 @@ public com.google.protobuf.TimestampOrBuilder getSoftDeleteTimeOrBuilder() {
      *
      *
      * 
                                            -     * Output only. The time when the object will be permanently deleted.
+     * Output only. The time when the object is permanently deleted.
      *
-     * Only set when an object becomes soft-deleted with a soft_delete_policy.
-     * Otherwise, the object will not be accessible.
+     * Only set when an object becomes soft-deleted with a `soft_delete_policy`.
+     * Otherwise, the object is not accessible.
      * 
                                            
      *
      * 
@@ -9666,10 +9666,10 @@ public boolean hasHardDeleteTime() {
      *
      *
      * 
                                            -     * Output only. The time when the object will be permanently deleted.
+     * Output only. The time when the object is permanently deleted.
      *
-     * Only set when an object becomes soft-deleted with a soft_delete_policy.
-     * Otherwise, the object will not be accessible.
+     * Only set when an object becomes soft-deleted with a `soft_delete_policy`.
+     * Otherwise, the object is not accessible.
      * 
                                            
      *
      * 
@@ -9692,10 +9692,10 @@ public com.google.protobuf.Timestamp getHardDeleteTime() {
      *
      *
      * 
                                            -     * Output only. The time when the object will be permanently deleted.
+     * Output only. The time when the object is permanently deleted.
      *
-     * Only set when an object becomes soft-deleted with a soft_delete_policy.
-     * Otherwise, the object will not be accessible.
+     * Only set when an object becomes soft-deleted with a `soft_delete_policy`.
+     * Otherwise, the object is not accessible.
      * 
                                            
      *
      * 
@@ -9720,10 +9720,10 @@ public Builder setHardDeleteTime(com.google.protobuf.Timestamp value) {
      *
      *
      * 
                                            -     * Output only. The time when the object will be permanently deleted.
+     * Output only. The time when the object is permanently deleted.
      *
-     * Only set when an object becomes soft-deleted with a soft_delete_policy.
-     * Otherwise, the object will not be accessible.
+     * Only set when an object becomes soft-deleted with a `soft_delete_policy`.
+     * Otherwise, the object is not accessible.
      * 
                                            
      *
      * 
@@ -9745,10 +9745,10 @@ public Builder setHardDeleteTime(com.google.protobuf.Timestamp.Builder builderFo
      *
      *
      * 
                                            -     * Output only. The time when the object will be permanently deleted.
+     * Output only. The time when the object is permanently deleted.
      *
-     * Only set when an object becomes soft-deleted with a soft_delete_policy.
-     * Otherwise, the object will not be accessible.
+     * Only set when an object becomes soft-deleted with a `soft_delete_policy`.
+     * Otherwise, the object is not accessible.
      * 
                                            
      *
      * 
@@ -9778,10 +9778,10 @@ public Builder mergeHardDeleteTime(com.google.protobuf.Timestamp value) {
      *
      *
      * 
                                            -     * Output only. The time when the object will be permanently deleted.
+     * Output only. The time when the object is permanently deleted.
      *
-     * Only set when an object becomes soft-deleted with a soft_delete_policy.
-     * Otherwise, the object will not be accessible.
+     * Only set when an object becomes soft-deleted with a `soft_delete_policy`.
+     * Otherwise, the object is not accessible.
      * 
                                            
      *
      * 
@@ -9803,10 +9803,10 @@ public Builder clearHardDeleteTime() {
      *
      *
      * 
                                            -     * Output only. The time when the object will be permanently deleted.
+     * Output only. The time when the object is permanently deleted.
      *
-     * Only set when an object becomes soft-deleted with a soft_delete_policy.
-     * Otherwise, the object will not be accessible.
+     * Only set when an object becomes soft-deleted with a `soft_delete_policy`.
+     * Otherwise, the object is not accessible.
      * 
                                            
      *
      * 
@@ -9823,10 +9823,10 @@ public com.google.protobuf.Timestamp.Builder getHardDeleteTimeBuilder() {
      *
      *
      * 
                                            -     * Output only. The time when the object will be permanently deleted.
+     * Output only. The time when the object is permanently deleted.
      *
-     * Only set when an object becomes soft-deleted with a soft_delete_policy.
-     * Otherwise, the object will not be accessible.
+     * Only set when an object becomes soft-deleted with a `soft_delete_policy`.
+     * Otherwise, the object is not accessible.
      * 
                                            
      *
      * 
@@ -9847,10 +9847,10 @@ public com.google.protobuf.TimestampOrBuilder getHardDeleteTimeOrBuilder() {
      *
      *
      * 
                                            -     * Output only. The time when the object will be permanently deleted.
+     * Output only. The time when the object is permanently deleted.
      *
-     * Only set when an object becomes soft-deleted with a soft_delete_policy.
-     * Otherwise, the object will not be accessible.
+     * Only set when an object becomes soft-deleted with a `soft_delete_policy`.
+     * Otherwise, the object is not accessible.
      * 
                                            
      *
      * 
@@ -9886,7 +9886,7 @@ public com.google.protobuf.TimestampOrBuilder getHardDeleteTimeOrBuilder() {
      *
      * 
                                                  * Optional. Retention configuration of this object.
-     * May only be configured if the bucket has object retention enabled.
+     * Might only be configured if the bucket has object retention enabled.
      * 
                                            
      *
      * 
@@ -9904,7 +9904,7 @@ public boolean hasRetention() {
      *
      * 
                                                  * Optional. Retention configuration of this object.
-     * May only be configured if the bucket has object retention enabled.
+     * Might only be configured if the bucket has object retention enabled.
      * 
                                            
      *
      * 
@@ -9928,7 +9928,7 @@ public com.google.storage.v2.Object.Retention getRetention() {
      *
      * 
                                                  * Optional. Retention configuration of this object.
-     * May only be configured if the bucket has object retention enabled.
+     * Might only be configured if the bucket has object retention enabled.
      * 
                                            
      *
      * 
@@ -9954,7 +9954,7 @@ public Builder setRetention(com.google.storage.v2.Object.Retention value) {
      *
      * 
                                                  * Optional. Retention configuration of this object.
-     * May only be configured if the bucket has object retention enabled.
+     * Might only be configured if the bucket has object retention enabled.
      * 
                                            
      *
      * 
@@ -9977,7 +9977,7 @@ public Builder setRetention(com.google.storage.v2.Object.Retention.Builder build
      *
      * 
                                                  * Optional. Retention configuration of this object.
-     * May only be configured if the bucket has object retention enabled.
+     * Might only be configured if the bucket has object retention enabled.
      * 
                                            
      *
      * 
@@ -10008,7 +10008,7 @@ public Builder mergeRetention(com.google.storage.v2.Object.Retention value) {
      *
      * 
                                                  * Optional. Retention configuration of this object.
-     * May only be configured if the bucket has object retention enabled.
+     * Might only be configured if the bucket has object retention enabled.
      * 
                                            
      *
      * 
@@ -10031,7 +10031,7 @@ public Builder clearRetention() {
      *
      * 
                                                  * Optional. Retention configuration of this object.
-     * May only be configured if the bucket has object retention enabled.
+     * Might only be configured if the bucket has object retention enabled.
      * 
                                            
      *
      * 
@@ -10049,7 +10049,7 @@ public com.google.storage.v2.Object.Retention.Builder getRetentionBuilder() {
      *
      * 
                                                  * Optional. Retention configuration of this object.
-     * May only be configured if the bucket has object retention enabled.
+     * Might only be configured if the bucket has object retention enabled.
      * 
                                            
      *
      * 
@@ -10071,7 +10071,7 @@ public com.google.storage.v2.Object.RetentionOrBuilder getRetentionOrBuilder() {
      *
      * 
                                                  * Optional. Retention configuration of this object.
-     * May only be configured if the bucket has object retention enabled.
+     * Might only be configured if the bucket has object retention enabled.
      * 
                                            
      *
      * 
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ObjectAccessControl.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ObjectAccessControl.java
index 74dd22cd37..a01cfa93d2 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ObjectAccessControl.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ObjectAccessControl.java
@@ -211,8 +211,8 @@ public com.google.protobuf.ByteString getIdBytes() {
    * `group-example@googlegroups.com`.
    * * All members of the Google Apps for Business domain `example.com` would be
    * `domain-example.com`.
-   * For project entities, `project-{team}-{projectnumber}` format will be
-   * returned on response.
+   * For project entities, `project-{team}-{projectnumber}` format is
+   * returned in the response.
    * 
                                            
    *
    * string entity = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -252,8 +252,8 @@ public java.lang.String getEntity() {
    * `group-example@googlegroups.com`.
    * * All members of the Google Apps for Business domain `example.com` would be
    * `domain-example.com`.
-   * For project entities, `project-{team}-{projectnumber}` format will be
-   * returned on response.
+   * For project entities, `project-{team}-{projectnumber}` format is
+   * returned in the response.
    * 
                                            
    *
    * string entity = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -283,7 +283,7 @@ public com.google.protobuf.ByteString getEntityBytes() {
    *
    * 
                                                * Output only. The alternative entity format, if exists. For project
-   * entities, `project-{team}-{projectid}` format will be returned on response.
+   * entities, `project-{team}-{projectid}` format is returned in the response.
    * 
                                            
    *
    * string entity_alt = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -308,7 +308,7 @@ public java.lang.String getEntityAlt() {
    *
    * 
                                                * Output only. The alternative entity format, if exists. For project
-   * entities, `project-{team}-{projectid}` format will be returned on response.
+   * entities, `project-{team}-{projectid}` format is returned in the response.
    * 
                                            
    *
    * string entity_alt = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -392,7 +392,7 @@ public com.google.protobuf.ByteString getEntityIdBytes() {
    * 
                                                * Optional. The etag of the ObjectAccessControl.
    * If included in the metadata of an update or delete request message, the
-   * operation will only be performed if the etag matches that of the live
+   * operation is only performed if the etag matches that of the live
    * object's ObjectAccessControl.
    * 
                                            
    *
@@ -419,7 +419,7 @@ public java.lang.String getEtag() {
    * 
                                                * Optional. The etag of the ObjectAccessControl.
    * If included in the metadata of an update or delete request message, the
-   * operation will only be performed if the etag matches that of the live
+   * operation is only performed if the etag matches that of the live
    * object's ObjectAccessControl.
    * 
                                            
    *
@@ -1423,8 +1423,8 @@ public Builder setIdBytes(com.google.protobuf.ByteString value) {
      * `group-example@googlegroups.com`.
      * * All members of the Google Apps for Business domain `example.com` would be
      * `domain-example.com`.
-     * For project entities, `project-{team}-{projectnumber}` format will be
-     * returned on response.
+     * For project entities, `project-{team}-{projectnumber}` format is
+     * returned in the response.
      * 
                                            
      *
      * string entity = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -1463,8 +1463,8 @@ public java.lang.String getEntity() {
      * `group-example@googlegroups.com`.
      * * All members of the Google Apps for Business domain `example.com` would be
      * `domain-example.com`.
-     * For project entities, `project-{team}-{projectnumber}` format will be
-     * returned on response.
+     * For project entities, `project-{team}-{projectnumber}` format is
+     * returned in the response.
      * 
                                            
      *
      * string entity = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -1503,8 +1503,8 @@ public com.google.protobuf.ByteString getEntityBytes() {
      * `group-example@googlegroups.com`.
      * * All members of the Google Apps for Business domain `example.com` would be
      * `domain-example.com`.
-     * For project entities, `project-{team}-{projectnumber}` format will be
-     * returned on response.
+     * For project entities, `project-{team}-{projectnumber}` format is
+     * returned in the response.
      * 
                                            
      *
      * string entity = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -1542,8 +1542,8 @@ public Builder setEntity(java.lang.String value) {
      * `group-example@googlegroups.com`.
      * * All members of the Google Apps for Business domain `example.com` would be
      * `domain-example.com`.
-     * For project entities, `project-{team}-{projectnumber}` format will be
-     * returned on response.
+     * For project entities, `project-{team}-{projectnumber}` format is
+     * returned in the response.
      * 
                                            
      *
      * string entity = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -1577,8 +1577,8 @@ public Builder clearEntity() {
      * `group-example@googlegroups.com`.
      * * All members of the Google Apps for Business domain `example.com` would be
      * `domain-example.com`.
-     * For project entities, `project-{team}-{projectnumber}` format will be
-     * returned on response.
+     * For project entities, `project-{team}-{projectnumber}` format is
+     * returned in the response.
      * 
                                            
      *
      * string entity = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -1604,7 +1604,7 @@ public Builder setEntityBytes(com.google.protobuf.ByteString value) {
      *
      * 
                                                  * Output only. The alternative entity format, if exists. For project
-     * entities, `project-{team}-{projectid}` format will be returned on response.
+     * entities, `project-{team}-{projectid}` format is returned in the response.
      * 
                                            
      *
      * string entity_alt = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -1628,7 +1628,7 @@ public java.lang.String getEntityAlt() {
      *
      * 
                                                  * Output only. The alternative entity format, if exists. For project
-     * entities, `project-{team}-{projectid}` format will be returned on response.
+     * entities, `project-{team}-{projectid}` format is returned in the response.
      * 
                                            
      *
      * string entity_alt = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -1652,7 +1652,7 @@ public com.google.protobuf.ByteString getEntityAltBytes() {
      *
      * 
                                                  * Output only. The alternative entity format, if exists. For project
-     * entities, `project-{team}-{projectid}` format will be returned on response.
+     * entities, `project-{team}-{projectid}` format is returned in the response.
      * 
                                            
      *
      * string entity_alt = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -1675,7 +1675,7 @@ public Builder setEntityAlt(java.lang.String value) {
      *
      * 
                                                  * Output only. The alternative entity format, if exists. For project
-     * entities, `project-{team}-{projectid}` format will be returned on response.
+     * entities, `project-{team}-{projectid}` format is returned in the response.
      * 
                                            
      *
      * string entity_alt = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -1694,7 +1694,7 @@ public Builder clearEntityAlt() {
      *
      * 
                                                  * Output only. The alternative entity format, if exists. For project
-     * entities, `project-{team}-{projectid}` format will be returned on response.
+     * entities, `project-{team}-{projectid}` format is returned in the response.
      * 
                                            
      *
      * string entity_alt = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -1832,7 +1832,7 @@ public Builder setEntityIdBytes(com.google.protobuf.ByteString value) {
      * 
                                                  * Optional. The etag of the ObjectAccessControl.
      * If included in the metadata of an update or delete request message, the
-     * operation will only be performed if the etag matches that of the live
+     * operation is only performed if the etag matches that of the live
      * object's ObjectAccessControl.
      * 
                                            
      *
@@ -1858,7 +1858,7 @@ public java.lang.String getEtag() {
      * 
                                                  * Optional. The etag of the ObjectAccessControl.
      * If included in the metadata of an update or delete request message, the
-     * operation will only be performed if the etag matches that of the live
+     * operation is only performed if the etag matches that of the live
      * object's ObjectAccessControl.
      * 
                                            
      *
@@ -1884,7 +1884,7 @@ public com.google.protobuf.ByteString getEtagBytes() {
      * 
                                                  * Optional. The etag of the ObjectAccessControl.
      * If included in the metadata of an update or delete request message, the
-     * operation will only be performed if the etag matches that of the live
+     * operation is only performed if the etag matches that of the live
      * object's ObjectAccessControl.
      * 
                                            
      *
@@ -1909,7 +1909,7 @@ public Builder setEtag(java.lang.String value) {
      * 
                                                  * Optional. The etag of the ObjectAccessControl.
      * If included in the metadata of an update or delete request message, the
-     * operation will only be performed if the etag matches that of the live
+     * operation is only performed if the etag matches that of the live
      * object's ObjectAccessControl.
      * 
                                            
      *
@@ -1930,7 +1930,7 @@ public Builder clearEtag() {
      * 
                                                  * Optional. The etag of the ObjectAccessControl.
      * If included in the metadata of an update or delete request message, the
-     * operation will only be performed if the etag matches that of the live
+     * operation is only performed if the etag matches that of the live
      * object's ObjectAccessControl.
      * 
                                            
      *
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ObjectAccessControlOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ObjectAccessControlOrBuilder.java
index 6092103830..bc893f63c4 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ObjectAccessControlOrBuilder.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ObjectAccessControlOrBuilder.java
@@ -104,8 +104,8 @@ public interface ObjectAccessControlOrBuilder
    * `group-example@googlegroups.com`.
    * * All members of the Google Apps for Business domain `example.com` would be
    * `domain-example.com`.
-   * For project entities, `project-{team}-{projectnumber}` format will be
-   * returned on response.
+   * For project entities, `project-{team}-{projectnumber}` format is
+   * returned in the response.
    * 
                                            
    *
    * string entity = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -134,8 +134,8 @@ public interface ObjectAccessControlOrBuilder
    * `group-example@googlegroups.com`.
    * * All members of the Google Apps for Business domain `example.com` would be
    * `domain-example.com`.
-   * For project entities, `project-{team}-{projectnumber}` format will be
-   * returned on response.
+   * For project entities, `project-{team}-{projectnumber}` format is
+   * returned in the response.
    *
                                            * * string entity = 3 [(.google.api.field_behavior) = OPTIONAL]; @@ -149,7 +149,7 @@ public interface ObjectAccessControlOrBuilder * * 
                                                * Output only. The alternative entity format, if exists. For project
-   * entities, `project-{team}-{projectid}` format will be returned on response.
+   * entities, `project-{team}-{projectid}` format is returned in the response.
    *
                                            * * string entity_alt = 9 [(.google.api.field_behavior) = OUTPUT_ONLY]; @@ -163,7 +163,7 @@ public interface ObjectAccessControlOrBuilder * * 
                                                * Output only. The alternative entity format, if exists. For project
-   * entities, `project-{team}-{projectid}` format will be returned on response.
+   * entities, `project-{team}-{projectid}` format is returned in the response.
    *
                                            * * string entity_alt = 9 [(.google.api.field_behavior) = OUTPUT_ONLY]; @@ -204,7 +204,7 @@ public interface ObjectAccessControlOrBuilder * 
                                                * Optional. The etag of the ObjectAccessControl.
    * If included in the metadata of an update or delete request message, the
-   * operation will only be performed if the etag matches that of the live
+   * operation is only performed if the etag matches that of the live
    * object's ObjectAccessControl.
    *
                                            * @@ -220,7 +220,7 @@ public interface ObjectAccessControlOrBuilder * 
                                                * Optional. The etag of the ObjectAccessControl.
    * If included in the metadata of an update or delete request message, the
-   * operation will only be performed if the etag matches that of the live
+   * operation is only performed if the etag matches that of the live
    * object's ObjectAccessControl.
    *
                                            * diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ObjectChecksums.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ObjectChecksums.java index f64015ce14..4a49f72e38 100644 --- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ObjectChecksums.java +++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ObjectChecksums.java @@ -74,7 +74,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() { * 
                                                * CRC32C digest of the object data. Computed by the Cloud Storage service for
    * all written objects.
-   * If set in a WriteObjectRequest, service will validate that the stored
+   * If set in a WriteObjectRequest, service validates that the stored
    * object matches this checksum.
    *
                                            * @@ -93,7 +93,7 @@ public boolean hasCrc32C() { * 
                                                * CRC32C digest of the object data. Computed by the Cloud Storage service for
    * all written objects.
-   * If set in a WriteObjectRequest, service will validate that the stored
+   * If set in a WriteObjectRequest, service validates that the stored
    * object matches this checksum.
    *
                                            * @@ -113,13 +113,12 @@ public int getCrc32C() { * * * 
                                            -   * Optional. 128 bit MD5 hash of the object data.
-   * For more information about using the MD5 hash, see
-   * [https://cloud.google.com/storage/docs/hashes-etags#json-api][Hashes and
-   * ETags: Best Practices].
-   * Not all objects will provide an MD5 hash. For example, composite objects
-   * provide only crc32c hashes. This value is equivalent to running `cat
-   * object.txt | openssl md5 -binary`
+   * Optional. 128 bit MD5 hash of the object data. For more information about
+   * using the MD5 hash, see [Data validation and change
+   * detection](https://cloud.google.com/storage/docs/data-validation). Not all
+   * objects provide an MD5 hash. For example, composite objects provide only
+   * crc32c hashes. This value is equivalent to running `cat object.txt |
+   * openssl md5 -binary`
    *
                                            * * bytes md5_hash = 2 [(.google.api.field_behavior) = OPTIONAL]; @@ -507,7 +506,7 @@ public Builder mergeFrom( * 
                                                  * CRC32C digest of the object data. Computed by the Cloud Storage service for
      * all written objects.
-     * If set in a WriteObjectRequest, service will validate that the stored
+     * If set in a WriteObjectRequest, service validates that the stored
      * object matches this checksum.
      *
                                            * @@ -526,7 +525,7 @@ public boolean hasCrc32C() { * 
                                                  * CRC32C digest of the object data. Computed by the Cloud Storage service for
      * all written objects.
-     * If set in a WriteObjectRequest, service will validate that the stored
+     * If set in a WriteObjectRequest, service validates that the stored
      * object matches this checksum.
      *
                                            * @@ -545,7 +544,7 @@ public int getCrc32C() { * 
                                                  * CRC32C digest of the object data. Computed by the Cloud Storage service for
      * all written objects.
-     * If set in a WriteObjectRequest, service will validate that the stored
+     * If set in a WriteObjectRequest, service validates that the stored
      * object matches this checksum.
      *
                                            * @@ -568,7 +567,7 @@ public Builder setCrc32C(int value) { * 
                                                  * CRC32C digest of the object data. Computed by the Cloud Storage service for
      * all written objects.
-     * If set in a WriteObjectRequest, service will validate that the stored
+     * If set in a WriteObjectRequest, service validates that the stored
      * object matches this checksum.
      *
                                            * @@ -589,13 +588,12 @@ public Builder clearCrc32C() { * * * 
                                            -     * Optional. 128 bit MD5 hash of the object data.
-     * For more information about using the MD5 hash, see
-     * [https://cloud.google.com/storage/docs/hashes-etags#json-api][Hashes and
-     * ETags: Best Practices].
-     * Not all objects will provide an MD5 hash. For example, composite objects
-     * provide only crc32c hashes. This value is equivalent to running `cat
-     * object.txt | openssl md5 -binary`
+     * Optional. 128 bit MD5 hash of the object data. For more information about
+     * using the MD5 hash, see [Data validation and change
+     * detection](https://cloud.google.com/storage/docs/data-validation). Not all
+     * objects provide an MD5 hash. For example, composite objects provide only
+     * crc32c hashes. This value is equivalent to running `cat object.txt |
+     * openssl md5 -binary`
      *
                                            * * bytes md5_hash = 2 [(.google.api.field_behavior) = OPTIONAL]; @@ -611,13 +609,12 @@ public com.google.protobuf.ByteString getMd5Hash() { * * * 
                                            -     * Optional. 128 bit MD5 hash of the object data.
-     * For more information about using the MD5 hash, see
-     * [https://cloud.google.com/storage/docs/hashes-etags#json-api][Hashes and
-     * ETags: Best Practices].
-     * Not all objects will provide an MD5 hash. For example, composite objects
-     * provide only crc32c hashes. This value is equivalent to running `cat
-     * object.txt | openssl md5 -binary`
+     * Optional. 128 bit MD5 hash of the object data. For more information about
+     * using the MD5 hash, see [Data validation and change
+     * detection](https://cloud.google.com/storage/docs/data-validation). Not all
+     * objects provide an MD5 hash. For example, composite objects provide only
+     * crc32c hashes. This value is equivalent to running `cat object.txt |
+     * openssl md5 -binary`
      *
                                            * * bytes md5_hash = 2 [(.google.api.field_behavior) = OPTIONAL]; @@ -639,13 +636,12 @@ public Builder setMd5Hash(com.google.protobuf.ByteString value) { * * * 
                                            -     * Optional. 128 bit MD5 hash of the object data.
-     * For more information about using the MD5 hash, see
-     * [https://cloud.google.com/storage/docs/hashes-etags#json-api][Hashes and
-     * ETags: Best Practices].
-     * Not all objects will provide an MD5 hash. For example, composite objects
-     * provide only crc32c hashes. This value is equivalent to running `cat
-     * object.txt | openssl md5 -binary`
+     * Optional. 128 bit MD5 hash of the object data. For more information about
+     * using the MD5 hash, see [Data validation and change
+     * detection](https://cloud.google.com/storage/docs/data-validation). Not all
+     * objects provide an MD5 hash. For example, composite objects provide only
+     * crc32c hashes. This value is equivalent to running `cat object.txt |
+     * openssl md5 -binary`
      *
                                            * * bytes md5_hash = 2 [(.google.api.field_behavior) = OPTIONAL]; diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ObjectChecksumsOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ObjectChecksumsOrBuilder.java index 2553efad78..df677480d5 100644 --- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ObjectChecksumsOrBuilder.java +++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ObjectChecksumsOrBuilder.java @@ -30,7 +30,7 @@ public interface ObjectChecksumsOrBuilder * 
                                                * CRC32C digest of the object data. Computed by the Cloud Storage service for
    * all written objects.
-   * If set in a WriteObjectRequest, service will validate that the stored
+   * If set in a WriteObjectRequest, service validates that the stored
    * object matches this checksum.
    *
                                            * @@ -46,7 +46,7 @@ public interface ObjectChecksumsOrBuilder * 
                                                * CRC32C digest of the object data. Computed by the Cloud Storage service for
    * all written objects.
-   * If set in a WriteObjectRequest, service will validate that the stored
+   * If set in a WriteObjectRequest, service validates that the stored
    * object matches this checksum.
    *
                                            * @@ -60,13 +60,12 @@ public interface ObjectChecksumsOrBuilder * * * 
                                            -   * Optional. 128 bit MD5 hash of the object data.
-   * For more information about using the MD5 hash, see
-   * [https://cloud.google.com/storage/docs/hashes-etags#json-api][Hashes and
-   * ETags: Best Practices].
-   * Not all objects will provide an MD5 hash. For example, composite objects
-   * provide only crc32c hashes. This value is equivalent to running `cat
-   * object.txt | openssl md5 -binary`
+   * Optional. 128 bit MD5 hash of the object data. For more information about
+   * using the MD5 hash, see [Data validation and change
+   * detection](https://cloud.google.com/storage/docs/data-validation). Not all
+   * objects provide an MD5 hash. For example, composite objects provide only
+   * crc32c hashes. This value is equivalent to running `cat object.txt |
+   * openssl md5 -binary`
    *
                                            * * bytes md5_hash = 2 [(.google.api.field_behavior) = OPTIONAL]; diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ObjectOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ObjectOrBuilder.java index 9c0b359da1..cdf0880618 100644 --- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ObjectOrBuilder.java +++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ObjectOrBuilder.java @@ -96,9 +96,9 @@ public interface ObjectOrBuilder * * * 
                                            -   * Optional. The etag of the object.
+   * Optional. The `etag` of an object.
    * If included in the metadata of an update or delete request message, the
-   * operation will only be performed if the etag matches that of the live
+   * operation is only performed if the etag matches that of the live
    * object.
    *
                                            * @@ -112,9 +112,9 @@ public interface ObjectOrBuilder * * * 
                                            -   * Optional. The etag of the object.
+   * Optional. The `etag` of an object.
    * If included in the metadata of an update or delete request message, the
-   * operation will only be performed if the etag matches that of the live
+   * operation is only performed if the etag matches that of the live
    * object.
    *
                                            * @@ -230,7 +230,7 @@ public interface ObjectOrBuilder * * 
                                                * Output only. Content-Length of the object data in bytes, matching
-   * [https://tools.ietf.org/html/rfc7230#section-3.3.2][RFC 7230 §3.3.2].
+   * [RFC 7230 §3.3.2](https://tools.ietf.org/html/rfc7230#section-3.3.2]).
    *
                                            * * int64 size = 6 [(.google.api.field_behavior) = OUTPUT_ONLY]; @@ -244,7 +244,7 @@ public interface ObjectOrBuilder * * 
                                                * Optional. Content-Encoding of the object data, matching
-   * [https://tools.ietf.org/html/rfc7231#section-3.1.2.2][RFC 7231 §3.1.2.2]
+   * [RFC 7231 §3.1.2.2](https://tools.ietf.org/html/rfc7231#section-3.1.2.2)
    *
                                            * * string content_encoding = 7 [(.google.api.field_behavior) = OPTIONAL]; @@ -258,7 +258,7 @@ public interface ObjectOrBuilder * * 
                                                * Optional. Content-Encoding of the object data, matching
-   * [https://tools.ietf.org/html/rfc7231#section-3.1.2.2][RFC 7231 §3.1.2.2]
+   * [RFC 7231 §3.1.2.2](https://tools.ietf.org/html/rfc7231#section-3.1.2.2)
    *
                                            * * string content_encoding = 7 [(.google.api.field_behavior) = OPTIONAL]; @@ -272,7 +272,7 @@ public interface ObjectOrBuilder * * 
                                                * Optional. Content-Disposition of the object data, matching
-   * [https://tools.ietf.org/html/rfc6266][RFC 6266].
+   * [RFC 6266](https://tools.ietf.org/html/rfc6266).
    *
                                            * * string content_disposition = 8 [(.google.api.field_behavior) = OPTIONAL]; @@ -286,7 +286,7 @@ public interface ObjectOrBuilder * * 
                                                * Optional. Content-Disposition of the object data, matching
-   * [https://tools.ietf.org/html/rfc6266][RFC 6266].
+   * [RFC 6266](https://tools.ietf.org/html/rfc6266).
    *
                                            * * string content_disposition = 8 [(.google.api.field_behavior) = OPTIONAL]; @@ -300,9 +300,9 @@ public interface ObjectOrBuilder * * 
                                                * Optional. Cache-Control directive for the object data, matching
-   * [https://tools.ietf.org/html/rfc7234#section-5.2"][RFC 7234 §5.2].
+   * [RFC 7234 §5.2](https://tools.ietf.org/html/rfc7234#section-5.2).
    * If omitted, and the object is accessible to all anonymous users, the
-   * default will be `public, max-age=3600`.
+   * default is `public, max-age=3600`.
    *
                                            * * string cache_control = 9 [(.google.api.field_behavior) = OPTIONAL]; @@ -316,9 +316,9 @@ public interface ObjectOrBuilder * * 
                                                * Optional. Cache-Control directive for the object data, matching
-   * [https://tools.ietf.org/html/rfc7234#section-5.2"][RFC 7234 §5.2].
+   * [RFC 7234 §5.2](https://tools.ietf.org/html/rfc7234#section-5.2).
    * If omitted, and the object is accessible to all anonymous users, the
-   * default will be `public, max-age=3600`.
+   * default is `public, max-age=3600`.
    *
                                            * * string cache_control = 9 [(.google.api.field_behavior) = OPTIONAL]; @@ -332,7 +332,7 @@ public interface ObjectOrBuilder * * 
                                                * Optional. Access controls on the object.
-   * If iam_config.uniform_bucket_level_access is enabled on the parent
+   * If `iam_config.uniform_bucket_level_access` is enabled on the parent
    * bucket, requests to set, read, or modify acl is an error.
    *
                                            * @@ -347,7 +347,7 @@ public interface ObjectOrBuilder * * 
                                                * Optional. Access controls on the object.
-   * If iam_config.uniform_bucket_level_access is enabled on the parent
+   * If `iam_config.uniform_bucket_level_access` is enabled on the parent
    * bucket, requests to set, read, or modify acl is an error.
    *
                                            * @@ -362,7 +362,7 @@ public interface ObjectOrBuilder * * 
                                                * Optional. Access controls on the object.
-   * If iam_config.uniform_bucket_level_access is enabled on the parent
+   * If `iam_config.uniform_bucket_level_access` is enabled on the parent
    * bucket, requests to set, read, or modify acl is an error.
    *
                                            * @@ -377,7 +377,7 @@ public interface ObjectOrBuilder * * 
                                                * Optional. Access controls on the object.
-   * If iam_config.uniform_bucket_level_access is enabled on the parent
+   * If `iam_config.uniform_bucket_level_access` is enabled on the parent
    * bucket, requests to set, read, or modify acl is an error.
    *
                                            * @@ -393,7 +393,7 @@ public interface ObjectOrBuilder * * 
                                                * Optional. Access controls on the object.
-   * If iam_config.uniform_bucket_level_access is enabled on the parent
+   * If `iam_config.uniform_bucket_level_access` is enabled on the parent
    * bucket, requests to set, read, or modify acl is an error.
    *
                                            * @@ -408,7 +408,7 @@ public interface ObjectOrBuilder * * 
                                                * Optional. Content-Language of the object data, matching
-   * [https://tools.ietf.org/html/rfc7231#section-3.1.3.2][RFC 7231 §3.1.3.2].
+   * [RFC 7231 §3.1.3.2](https://tools.ietf.org/html/rfc7231#section-3.1.3.2).
    *
                                            * * string content_language = 11 [(.google.api.field_behavior) = OPTIONAL]; @@ -422,7 +422,7 @@ public interface ObjectOrBuilder * * 
                                                * Optional. Content-Language of the object data, matching
-   * [https://tools.ietf.org/html/rfc7231#section-3.1.3.2][RFC 7231 §3.1.3.2].
+   * [RFC 7231 §3.1.3.2](https://tools.ietf.org/html/rfc7231#section-3.1.3.2).
    *
                                            * * string content_language = 11 [(.google.api.field_behavior) = OPTIONAL]; @@ -522,7 +522,7 @@ public interface ObjectOrBuilder * * 
                                                * Optional. Content-Type of the object data, matching
-   * [https://tools.ietf.org/html/rfc7231#section-3.1.1.5][RFC 7231 §3.1.1.5].
+   * [RFC 7231 §3.1.1.5](https://tools.ietf.org/html/rfc7231#section-3.1.1.5).
    * If an object is stored without a Content-Type, it is served as
    * `application/octet-stream`.
    *
                                            @@ -538,7 +538,7 @@ public interface ObjectOrBuilder * * 
                                                * Optional. Content-Type of the object data, matching
-   * [https://tools.ietf.org/html/rfc7231#section-3.1.1.5][RFC 7231 §3.1.1.5].
+   * [RFC 7231 §3.1.1.5](https://tools.ietf.org/html/rfc7231#section-3.1.1.5).
    * If an object is stored without a Content-Type, it is served as
    * `application/octet-stream`.
    *
                                            @@ -608,7 +608,7 @@ public interface ObjectOrBuilder * * 
                                                * Output only. Hashes for the data part of this object. This field is used
-   * for output only and will be silently ignored if provided in requests. The
+   * for output only and is silently ignored if provided in requests. The
    * checksums of the complete object regardless of data range. If the object is
    * downloaded in full, the client should compute one of these checksums over
    * the downloaded object and compare it against the value provided here.
@@ -627,7 +627,7 @@ public interface ObjectOrBuilder
    *
    * 
                                                * Output only. Hashes for the data part of this object. This field is used
-   * for output only and will be silently ignored if provided in requests. The
+   * for output only and is silently ignored if provided in requests. The
    * checksums of the complete object regardless of data range. If the object is
    * downloaded in full, the client should compute one of these checksums over
    * the downloaded object and compare it against the value provided here.
@@ -646,7 +646,7 @@ public interface ObjectOrBuilder
    *
    * 
                                                * Output only. Hashes for the data part of this object. This field is used
-   * for output only and will be silently ignored if provided in requests. The
+   * for output only and is silently ignored if provided in requests. The
    * checksums of the complete object regardless of data range. If the object is
    * downloaded in full, the client should compute one of these checksums over
    * the downloaded object and compare it against the value provided here.
@@ -750,7 +750,7 @@ public interface ObjectOrBuilder
    *
    * 
                                                * Output only. The time at which the object's storage class was last changed.
-   * When the object is initially created, it will be set to time_created.
+   * When the object is initially created, it is set to `time_created`.
    * 
                                            
    *
    * 
@@ -766,7 +766,7 @@ public interface ObjectOrBuilder
    *
    * 
                                                * Output only. The time at which the object's storage class was last changed.
-   * When the object is initially created, it will be set to time_created.
+   * When the object is initially created, it is set to `time_created`.
    * 
                                            
    *
    * 
@@ -782,7 +782,7 @@ public interface ObjectOrBuilder
    *
    * 
                                                * Output only. The time at which the object's storage class was last changed.
-   * When the object is initially created, it will be set to time_created.
+   * When the object is initially created, it is set to `time_created`.
    * 
                                            
    *
    * 
@@ -986,14 +986,14 @@ java.lang.String getMetadataOrDefault(
    * 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
-   * this field to false, the object will become subject to any bucket-level
-   * retention policy, except that the retention duration will be calculated
+   * this field to `false`, the object becomes subject to any bucket-level
+   * retention policy, except that the retention duration is calculated
    * from the time the event based hold was lifted, rather than the time the
    * object was created.
    *
-   * In a WriteObject request, not setting this field implies that the value
-   * should be taken from the parent bucket's "default_event_based_hold" field.
-   * In a response, this field will always be set to true or false.
+   * In a `WriteObject` request, not setting this field implies that the value
+   * should be taken from the parent bucket's `default_event_based_hold` field.
+   * In a response, this field is always set to `true` or `false`.
    * 
                                            
    *
    * optional bool event_based_hold = 23;
@@ -1009,14 +1009,14 @@ java.lang.String getMetadataOrDefault(
    * 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
-   * this field to false, the object will become subject to any bucket-level
-   * retention policy, except that the retention duration will be calculated
+   * this field to `false`, the object becomes subject to any bucket-level
+   * retention policy, except that the retention duration is calculated
    * from the time the event based hold was lifted, rather than the time the
    * object was created.
    *
-   * In a WriteObject request, not setting this field implies that the value
-   * should be taken from the parent bucket's "default_event_based_hold" field.
-   * In a response, this field will always be set to true or false.
+   * In a `WriteObject` request, not setting this field implies that the value
+   * should be taken from the parent bucket's `default_event_based_hold` field.
+   * In a response, this field is always set to `true` or `false`.
    * 
                                            
    *
    * optional bool event_based_hold = 23;
@@ -1029,8 +1029,8 @@ java.lang.String getMetadataOrDefault(
    *
    *
    * 
                                            -   * Output only. The owner of the object. This will always be the uploader of
-   * the object.
+   * Output only. The owner of the object. This is always the uploader of the
+   * object.
    * 
                                            
    *
    * .google.storage.v2.Owner owner = 24 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -1043,8 +1043,8 @@ java.lang.String getMetadataOrDefault(
    *
    *
    * 
                                            -   * Output only. The owner of the object. This will always be the uploader of
-   * the object.
+   * Output only. The owner of the object. This is always the uploader of the
+   * object.
    * 
                                            
    *
    * .google.storage.v2.Owner owner = 24 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -1057,8 +1057,8 @@ java.lang.String getMetadataOrDefault(
    *
    *
    * 
                                            -   * Output only. The owner of the object. This will always be the uploader of
-   * the object.
+   * Output only. The owner of the object. This is always the uploader of the
+   * object.
    * 
                                            
    *
    * .google.storage.v2.Owner owner = 24 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -1069,7 +1069,7 @@ java.lang.String getMetadataOrDefault(
    *
    *
    * 
                                            -   * Optional. Metadata of Customer-Supplied Encryption Key, if the object is
+   * Optional. Metadata of customer-supplied encryption key, if the object is
    * encrypted by such a key.
    * 
                                            
    *
@@ -1085,7 +1085,7 @@ java.lang.String getMetadataOrDefault(
    *
    *
    * 
                                            -   * Optional. Metadata of Customer-Supplied Encryption Key, if the object is
+   * Optional. Metadata of customer-supplied encryption key, if the object is
    * encrypted by such a key.
    * 
                                            
    *
@@ -1101,7 +1101,7 @@ java.lang.String getMetadataOrDefault(
    *
    *
    * 
                                            -   * Optional. Metadata of Customer-Supplied Encryption Key, if the object is
+   * Optional. Metadata of customer-supplied encryption key, if the object is
    * encrypted by such a key.
    * 
                                            
    *
@@ -1158,7 +1158,7 @@ java.lang.String getMetadataOrDefault(
    * Output only. This is the time when the object became soft-deleted.
    *
    * Soft-deleted objects are only accessible if a soft_delete_policy is
-   * enabled. Also see hard_delete_time.
+   * enabled. Also see `hard_delete_time`.
    *
                                            * * @@ -1176,7 +1176,7 @@ java.lang.String getMetadataOrDefault( * Output only. This is the time when the object became soft-deleted. * * Soft-deleted objects are only accessible if a soft_delete_policy is - * enabled. Also see hard_delete_time. + * enabled. Also see `hard_delete_time`. * * * @@ -1194,7 +1194,7 @@ java.lang.String getMetadataOrDefault( * Output only. This is the time when the object became soft-deleted. * * Soft-deleted objects are only accessible if a soft_delete_policy is - * enabled. Also see hard_delete_time. + * enabled. Also see `hard_delete_time`. * * * @@ -1207,10 +1207,10 @@ java.lang.String getMetadataOrDefault( * * * 
                                            -   * Output only. The time when the object will be permanently deleted.
+   * Output only. The time when the object is permanently deleted.
    *
-   * Only set when an object becomes soft-deleted with a soft_delete_policy.
-   * Otherwise, the object will not be accessible.
+   * Only set when an object becomes soft-deleted with a `soft_delete_policy`.
+   * Otherwise, the object is not accessible.
    *
                                            * * @@ -1225,10 +1225,10 @@ java.lang.String getMetadataOrDefault( * * * 
                                            -   * Output only. The time when the object will be permanently deleted.
+   * Output only. The time when the object is permanently deleted.
    *
-   * Only set when an object becomes soft-deleted with a soft_delete_policy.
-   * Otherwise, the object will not be accessible.
+   * Only set when an object becomes soft-deleted with a `soft_delete_policy`.
+   * Otherwise, the object is not accessible.
    *
                                            * * @@ -1243,10 +1243,10 @@ java.lang.String getMetadataOrDefault( * * * 
                                            -   * Output only. The time when the object will be permanently deleted.
+   * Output only. The time when the object is permanently deleted.
    *
-   * Only set when an object becomes soft-deleted with a soft_delete_policy.
-   * Otherwise, the object will not be accessible.
+   * Only set when an object becomes soft-deleted with a `soft_delete_policy`.
+   * Otherwise, the object is not accessible.
    *
                                            * * @@ -1260,7 +1260,7 @@ java.lang.String getMetadataOrDefault( * * 
                                                * Optional. Retention configuration of this object.
-   * May only be configured if the bucket has object retention enabled.
+   * Might only be configured if the bucket has object retention enabled.
    *
                                            * * @@ -1276,7 +1276,7 @@ java.lang.String getMetadataOrDefault( * * 
                                                * Optional. Retention configuration of this object.
-   * May only be configured if the bucket has object retention enabled.
+   * Might only be configured if the bucket has object retention enabled.
    *
                                            * * @@ -1292,7 +1292,7 @@ java.lang.String getMetadataOrDefault( * * 
                                                * Optional. Retention configuration of this object.
-   * May only be configured if the bucket has object retention enabled.
+   * Might only be configured if the bucket has object retention enabled.
    *
                                            * * diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ObjectRangeData.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ObjectRangeData.java index bb752cab98..e1c937f1ff 100644 --- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ObjectRangeData.java +++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ObjectRangeData.java @@ -123,11 +123,11 @@ public com.google.storage.v2.ChecksummedDataOrBuilder getChecksummedDataOrBuilde * * * 
                                            -   * The ReadRange describes the content being returned with read_id set to the
-   * corresponding ReadObjectRequest in the stream. Multiple ObjectRangeData
-   * messages may have the same read_id but increasing offsets.
-   * ReadObjectResponse messages with the same read_id are guaranteed to be
-   * delivered in increasing offset order.
+   * The `ReadRange` describes the content being returned with `read_id` set to
+   * the corresponding `ReadObjectRequest` in the stream. Multiple
+   * `ObjectRangeData` messages might have the same read_id but increasing
+   * offsets. `ReadObjectResponse` messages with the same `read_id` are
+   * guaranteed to be delivered in increasing offset order.
    *
                                            * * .google.storage.v2.ReadRange read_range = 2; @@ -143,11 +143,11 @@ public boolean hasReadRange() { * * * 
                                            -   * The ReadRange describes the content being returned with read_id set to the
-   * corresponding ReadObjectRequest in the stream. Multiple ObjectRangeData
-   * messages may have the same read_id but increasing offsets.
-   * ReadObjectResponse messages with the same read_id are guaranteed to be
-   * delivered in increasing offset order.
+   * The `ReadRange` describes the content being returned with `read_id` set to
+   * the corresponding `ReadObjectRequest` in the stream. Multiple
+   * `ObjectRangeData` messages might have the same read_id but increasing
+   * offsets. `ReadObjectResponse` messages with the same `read_id` are
+   * guaranteed to be delivered in increasing offset order.
    *
                                            * * .google.storage.v2.ReadRange read_range = 2; @@ -163,11 +163,11 @@ public com.google.storage.v2.ReadRange getReadRange() { * * * 
                                            -   * The ReadRange describes the content being returned with read_id set to the
-   * corresponding ReadObjectRequest in the stream. Multiple ObjectRangeData
-   * messages may have the same read_id but increasing offsets.
-   * ReadObjectResponse messages with the same read_id are guaranteed to be
-   * delivered in increasing offset order.
+   * The `ReadRange` describes the content being returned with `read_id` set to
+   * the corresponding `ReadObjectRequest` in the stream. Multiple
+   * `ObjectRangeData` messages might have the same read_id but increasing
+   * offsets. `ReadObjectResponse` messages with the same `read_id` are
+   * guaranteed to be delivered in increasing offset order.
    *
                                            * * .google.storage.v2.ReadRange read_range = 2; @@ -817,11 +817,11 @@ public com.google.storage.v2.ChecksummedDataOrBuilder getChecksummedDataOrBuilde * * * 
                                            -     * The ReadRange describes the content being returned with read_id set to the
-     * corresponding ReadObjectRequest in the stream. Multiple ObjectRangeData
-     * messages may have the same read_id but increasing offsets.
-     * ReadObjectResponse messages with the same read_id are guaranteed to be
-     * delivered in increasing offset order.
+     * The `ReadRange` describes the content being returned with `read_id` set to
+     * the corresponding `ReadObjectRequest` in the stream. Multiple
+     * `ObjectRangeData` messages might have the same read_id but increasing
+     * offsets. `ReadObjectResponse` messages with the same `read_id` are
+     * guaranteed to be delivered in increasing offset order.
      *
                                            * * .google.storage.v2.ReadRange read_range = 2; @@ -836,11 +836,11 @@ public boolean hasReadRange() { * * * 
                                            -     * The ReadRange describes the content being returned with read_id set to the
-     * corresponding ReadObjectRequest in the stream. Multiple ObjectRangeData
-     * messages may have the same read_id but increasing offsets.
-     * ReadObjectResponse messages with the same read_id are guaranteed to be
-     * delivered in increasing offset order.
+     * The `ReadRange` describes the content being returned with `read_id` set to
+     * the corresponding `ReadObjectRequest` in the stream. Multiple
+     * `ObjectRangeData` messages might have the same read_id but increasing
+     * offsets. `ReadObjectResponse` messages with the same `read_id` are
+     * guaranteed to be delivered in increasing offset order.
      *
                                            * * .google.storage.v2.ReadRange read_range = 2; @@ -861,11 +861,11 @@ public com.google.storage.v2.ReadRange getReadRange() { * * * 
                                            -     * The ReadRange describes the content being returned with read_id set to the
-     * corresponding ReadObjectRequest in the stream. Multiple ObjectRangeData
-     * messages may have the same read_id but increasing offsets.
-     * ReadObjectResponse messages with the same read_id are guaranteed to be
-     * delivered in increasing offset order.
+     * The `ReadRange` describes the content being returned with `read_id` set to
+     * the corresponding `ReadObjectRequest` in the stream. Multiple
+     * `ObjectRangeData` messages might have the same read_id but increasing
+     * offsets. `ReadObjectResponse` messages with the same `read_id` are
+     * guaranteed to be delivered in increasing offset order.
      *
                                            * * .google.storage.v2.ReadRange read_range = 2; @@ -888,11 +888,11 @@ public Builder setReadRange(com.google.storage.v2.ReadRange value) { * * * 
                                            -     * The ReadRange describes the content being returned with read_id set to the
-     * corresponding ReadObjectRequest in the stream. Multiple ObjectRangeData
-     * messages may have the same read_id but increasing offsets.
-     * ReadObjectResponse messages with the same read_id are guaranteed to be
-     * delivered in increasing offset order.
+     * The `ReadRange` describes the content being returned with `read_id` set to
+     * the corresponding `ReadObjectRequest` in the stream. Multiple
+     * `ObjectRangeData` messages might have the same read_id but increasing
+     * offsets. `ReadObjectResponse` messages with the same `read_id` are
+     * guaranteed to be delivered in increasing offset order.
      *
                                            * * .google.storage.v2.ReadRange read_range = 2; @@ -912,11 +912,11 @@ public Builder setReadRange(com.google.storage.v2.ReadRange.Builder builderForVa * * * 
                                            -     * The ReadRange describes the content being returned with read_id set to the
-     * corresponding ReadObjectRequest in the stream. Multiple ObjectRangeData
-     * messages may have the same read_id but increasing offsets.
-     * ReadObjectResponse messages with the same read_id are guaranteed to be
-     * delivered in increasing offset order.
+     * The `ReadRange` describes the content being returned with `read_id` set to
+     * the corresponding `ReadObjectRequest` in the stream. Multiple
+     * `ObjectRangeData` messages might have the same read_id but increasing
+     * offsets. `ReadObjectResponse` messages with the same `read_id` are
+     * guaranteed to be delivered in increasing offset order.
      *
                                            * * .google.storage.v2.ReadRange read_range = 2; @@ -944,11 +944,11 @@ public Builder mergeReadRange(com.google.storage.v2.ReadRange value) { * * * 
                                            -     * The ReadRange describes the content being returned with read_id set to the
-     * corresponding ReadObjectRequest in the stream. Multiple ObjectRangeData
-     * messages may have the same read_id but increasing offsets.
-     * ReadObjectResponse messages with the same read_id are guaranteed to be
-     * delivered in increasing offset order.
+     * The `ReadRange` describes the content being returned with `read_id` set to
+     * the corresponding `ReadObjectRequest` in the stream. Multiple
+     * `ObjectRangeData` messages might have the same read_id but increasing
+     * offsets. `ReadObjectResponse` messages with the same `read_id` are
+     * guaranteed to be delivered in increasing offset order.
      *
                                            * * .google.storage.v2.ReadRange read_range = 2; @@ -968,11 +968,11 @@ public Builder clearReadRange() { * * * 
                                            -     * The ReadRange describes the content being returned with read_id set to the
-     * corresponding ReadObjectRequest in the stream. Multiple ObjectRangeData
-     * messages may have the same read_id but increasing offsets.
-     * ReadObjectResponse messages with the same read_id are guaranteed to be
-     * delivered in increasing offset order.
+     * The `ReadRange` describes the content being returned with `read_id` set to
+     * the corresponding `ReadObjectRequest` in the stream. Multiple
+     * `ObjectRangeData` messages might have the same read_id but increasing
+     * offsets. `ReadObjectResponse` messages with the same `read_id` are
+     * guaranteed to be delivered in increasing offset order.
      *
                                            * * .google.storage.v2.ReadRange read_range = 2; @@ -987,11 +987,11 @@ public com.google.storage.v2.ReadRange.Builder getReadRangeBuilder() { * * * 
                                            -     * The ReadRange describes the content being returned with read_id set to the
-     * corresponding ReadObjectRequest in the stream. Multiple ObjectRangeData
-     * messages may have the same read_id but increasing offsets.
-     * ReadObjectResponse messages with the same read_id are guaranteed to be
-     * delivered in increasing offset order.
+     * The `ReadRange` describes the content being returned with `read_id` set to
+     * the corresponding `ReadObjectRequest` in the stream. Multiple
+     * `ObjectRangeData` messages might have the same read_id but increasing
+     * offsets. `ReadObjectResponse` messages with the same `read_id` are
+     * guaranteed to be delivered in increasing offset order.
      *
                                            * * .google.storage.v2.ReadRange read_range = 2; @@ -1010,11 +1010,11 @@ public com.google.storage.v2.ReadRangeOrBuilder getReadRangeOrBuilder() { * * * 
                                            -     * The ReadRange describes the content being returned with read_id set to the
-     * corresponding ReadObjectRequest in the stream. Multiple ObjectRangeData
-     * messages may have the same read_id but increasing offsets.
-     * ReadObjectResponse messages with the same read_id are guaranteed to be
-     * delivered in increasing offset order.
+     * The `ReadRange` describes the content being returned with `read_id` set to
+     * the corresponding `ReadObjectRequest` in the stream. Multiple
+     * `ObjectRangeData` messages might have the same read_id but increasing
+     * offsets. `ReadObjectResponse` messages with the same `read_id` are
+     * guaranteed to be delivered in increasing offset order.
      *
                                            * * .google.storage.v2.ReadRange read_range = 2; diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ObjectRangeDataOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ObjectRangeDataOrBuilder.java index 4ca846b2bf..d36df6ba98 100644 --- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ObjectRangeDataOrBuilder.java +++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ObjectRangeDataOrBuilder.java @@ -65,11 +65,11 @@ public interface ObjectRangeDataOrBuilder * * * 
                                            -   * The ReadRange describes the content being returned with read_id set to the
-   * corresponding ReadObjectRequest in the stream. Multiple ObjectRangeData
-   * messages may have the same read_id but increasing offsets.
-   * ReadObjectResponse messages with the same read_id are guaranteed to be
-   * delivered in increasing offset order.
+   * The `ReadRange` describes the content being returned with `read_id` set to
+   * the corresponding `ReadObjectRequest` in the stream. Multiple
+   * `ObjectRangeData` messages might have the same read_id but increasing
+   * offsets. `ReadObjectResponse` messages with the same `read_id` are
+   * guaranteed to be delivered in increasing offset order.
    *
                                            * * .google.storage.v2.ReadRange read_range = 2; @@ -82,11 +82,11 @@ public interface ObjectRangeDataOrBuilder * * * 
                                            -   * The ReadRange describes the content being returned with read_id set to the
-   * corresponding ReadObjectRequest in the stream. Multiple ObjectRangeData
-   * messages may have the same read_id but increasing offsets.
-   * ReadObjectResponse messages with the same read_id are guaranteed to be
-   * delivered in increasing offset order.
+   * The `ReadRange` describes the content being returned with `read_id` set to
+   * the corresponding `ReadObjectRequest` in the stream. Multiple
+   * `ObjectRangeData` messages might have the same read_id but increasing
+   * offsets. `ReadObjectResponse` messages with the same `read_id` are
+   * guaranteed to be delivered in increasing offset order.
    *
                                            * * .google.storage.v2.ReadRange read_range = 2; @@ -99,11 +99,11 @@ public interface ObjectRangeDataOrBuilder * * * 
                                            -   * The ReadRange describes the content being returned with read_id set to the
-   * corresponding ReadObjectRequest in the stream. Multiple ObjectRangeData
-   * messages may have the same read_id but increasing offsets.
-   * ReadObjectResponse messages with the same read_id are guaranteed to be
-   * delivered in increasing offset order.
+   * The `ReadRange` describes the content being returned with `read_id` set to
+   * the corresponding `ReadObjectRequest` in the stream. Multiple
+   * `ObjectRangeData` messages might have the same read_id but increasing
+   * offsets. `ReadObjectResponse` messages with the same `read_id` are
+   * guaranteed to be delivered in increasing offset order.
    *
                                            * * .google.storage.v2.ReadRange read_range = 2; diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/QueryWriteStatusRequest.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/QueryWriteStatusRequest.java index d205885761..a26e62dfbb 100644 --- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/QueryWriteStatusRequest.java +++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/QueryWriteStatusRequest.java @@ -23,7 +23,8 @@ * * * 
                                            - * Request object for `QueryWriteStatus`.
+ * Request object for
+ * [QueryWriteStatus][google.storage.v2.Storage.QueryWriteStatus].
  *
                                            * * Protobuf type {@code google.storage.v2.QueryWriteStatusRequest} @@ -364,7 +365,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build * * * 
                                            -   * Request object for `QueryWriteStatus`.
+   * Request object for
+   * [QueryWriteStatus][google.storage.v2.Storage.QueryWriteStatus].
    *
                                            * * Protobuf type {@code google.storage.v2.QueryWriteStatusRequest} diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/QueryWriteStatusResponse.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/QueryWriteStatusResponse.java index a3648a25da..53c8ab8774 100644 --- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/QueryWriteStatusResponse.java +++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/QueryWriteStatusResponse.java @@ -23,7 +23,8 @@ * * * 
                                            - * Response object for `QueryWriteStatus`.
+ * Response object for
+ * [QueryWriteStatus][google.storage.v2.Storage.QueryWriteStatus].
  *
                                            * * Protobuf type {@code google.storage.v2.QueryWriteStatusResponse} @@ -406,7 +407,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build * * * 
                                            -   * Response object for `QueryWriteStatus`.
+   * Response object for
+   * [QueryWriteStatus][google.storage.v2.Storage.QueryWriteStatus].
    *
                                            * * Protobuf type {@code google.storage.v2.QueryWriteStatusResponse} diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ReadObjectRequest.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ReadObjectRequest.java index 2034dececc..1a3db73f7c 100644 --- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ReadObjectRequest.java +++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ReadObjectRequest.java @@ -23,7 +23,7 @@ * * * 
                                            - * Request message for ReadObject.
+ * Request message for [ReadObject][google.storage.v2.Storage.ReadObject].
  *
                                            * * Protobuf type {@code google.storage.v2.ReadObjectRequest} @@ -206,12 +206,12 @@ public long getGeneration() { * Optional. The offset for the first byte to return in the read, relative to * the start of the object. * - * A negative `read_offset` value will be interpreted as the number of bytes + * A negative `read_offset` value is interpreted as the number of bytes * back from the end of the object to be returned. For example, if an object's - * length is 15 bytes, a ReadObjectRequest with `read_offset` = -5 and - * `read_limit` = 3 would return bytes 10 through 12 of the object. Requesting - * a negative offset with magnitude larger than the size of the object will - * return the entire object. + * length is `15` bytes, a `ReadObjectRequest` with `read_offset` = `-5` and + * `read_limit` = `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. * * * int64 read_offset = 4 [(.google.api.field_behavior) = OPTIONAL]; @@ -232,7 +232,7 @@ public long getReadOffset() { * 
                                                * Optional. The maximum number of `data` bytes the server is allowed to
    * return in the sum of all `Object` messages. A `read_limit` of zero
-   * indicates that there is no limit, and a negative `read_limit` will cause an
+   * indicates that there is no limit, and a negative `read_limit` causes an
    * error.
    *
    * If the stream returns fewer bytes than allowed by the `read_limit` and no
@@ -474,10 +474,10 @@ public com.google.storage.v2.CommonObjectRequestParams getCommonObjectRequestPar
    *
    * 
                                                * Mask specifying which fields to read.
-   * The checksummed_data field and its children will always be present.
-   * If no mask is specified, will default to all fields except metadata.owner
-   * and metadata.acl.
-   * * may be used to mean "all fields".
+   * The `checksummed_data` field and its children are always present.
+   * If no mask is specified, it defaults to all fields except `metadata.
+   * owner` and `metadata.acl`.
+   * `*` might be used to mean "all fields".
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 12;
@@ -494,10 +494,10 @@ public boolean hasReadMask() {
    *
    * 
                                                * Mask specifying which fields to read.
-   * The checksummed_data field and its children will always be present.
-   * If no mask is specified, will default to all fields except metadata.owner
-   * and metadata.acl.
-   * * may be used to mean "all fields".
+   * The `checksummed_data` field and its children are always present.
+   * If no mask is specified, it defaults to all fields except `metadata.
+   * owner` and `metadata.acl`.
+   * `*` might be used to mean "all fields".
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 12;
@@ -514,10 +514,10 @@ public com.google.protobuf.FieldMask getReadMask() {
    *
    * 
                                                * Mask specifying which fields to read.
-   * The checksummed_data field and its children will always be present.
-   * If no mask is specified, will default to all fields except metadata.owner
-   * and metadata.acl.
-   * * may be used to mean "all fields".
+   * The `checksummed_data` field and its children are always present.
+   * If no mask is specified, it defaults to all fields except `metadata.
+   * owner` and `metadata.acl`.
+   * `*` might be used to mean "all fields".
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 12;
@@ -813,7 +813,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
                                            -   * Request message for ReadObject.
+   * Request message for [ReadObject][google.storage.v2.Storage.ReadObject].
    * 
                                            
    *
    * Protobuf type {@code google.storage.v2.ReadObjectRequest}
@@ -1453,12 +1453,12 @@ public Builder clearGeneration() {
      * Optional. The offset for the first byte to return in the read, relative to
      * the start of the object.
      *
-     * A negative `read_offset` value will be interpreted as the number of bytes
+     * A negative `read_offset` value is interpreted as the number of bytes
      * back from the end of the object to be returned. For example, if an object's
-     * length is 15 bytes, a ReadObjectRequest with `read_offset` = -5 and
-     * `read_limit` = 3 would return bytes 10 through 12 of the object. Requesting
-     * a negative offset with magnitude larger than the size of the object will
-     * return the entire object.
+     * length is `15` bytes, a `ReadObjectRequest` with `read_offset` = `-5` and
+     * `read_limit` = `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.
      *
                                            * * int64 read_offset = 4 [(.google.api.field_behavior) = OPTIONAL]; @@ -1477,12 +1477,12 @@ public long getReadOffset() { * Optional. The offset for the first byte to return in the read, relative to * the start of the object. * - * A negative `read_offset` value will be interpreted as the number of bytes + * A negative `read_offset` value is interpreted as the number of bytes * back from the end of the object to be returned. For example, if an object's - * length is 15 bytes, a ReadObjectRequest with `read_offset` = -5 and - * `read_limit` = 3 would return bytes 10 through 12 of the object. Requesting - * a negative offset with magnitude larger than the size of the object will - * return the entire object. + * length is `15` bytes, a `ReadObjectRequest` with `read_offset` = `-5` and + * `read_limit` = `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. * * * int64 read_offset = 4 [(.google.api.field_behavior) = OPTIONAL]; @@ -1505,12 +1505,12 @@ public Builder setReadOffset(long value) { * Optional. The offset for the first byte to return in the read, relative to * the start of the object. * - * A negative `read_offset` value will be interpreted as the number of bytes + * A negative `read_offset` value is interpreted as the number of bytes * back from the end of the object to be returned. For example, if an object's - * length is 15 bytes, a ReadObjectRequest with `read_offset` = -5 and - * `read_limit` = 3 would return bytes 10 through 12 of the object. Requesting - * a negative offset with magnitude larger than the size of the object will - * return the entire object. + * length is `15` bytes, a `ReadObjectRequest` with `read_offset` = `-5` and + * `read_limit` = `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. * * * int64 read_offset = 4 [(.google.api.field_behavior) = OPTIONAL]; @@ -1532,7 +1532,7 @@ public Builder clearReadOffset() { * 
                                                  * Optional. The maximum number of `data` bytes the server is allowed to
      * return in the sum of all `Object` messages. A `read_limit` of zero
-     * indicates that there is no limit, and a negative `read_limit` will cause an
+     * indicates that there is no limit, and a negative `read_limit` causes an
      * error.
      *
      * If the stream returns fewer bytes than allowed by the `read_limit` and no
@@ -1555,7 +1555,7 @@ public long getReadLimit() {
      * 
                                                  * Optional. The maximum number of `data` bytes the server is allowed to
      * return in the sum of all `Object` messages. A `read_limit` of zero
-     * indicates that there is no limit, and a negative `read_limit` will cause an
+     * indicates that there is no limit, and a negative `read_limit` causes an
      * error.
      *
      * If the stream returns fewer bytes than allowed by the `read_limit` and no
@@ -1582,7 +1582,7 @@ public Builder setReadLimit(long value) {
      * 
                                                  * Optional. The maximum number of `data` bytes the server is allowed to
      * return in the sum of all `Object` messages. A `read_limit` of zero
-     * indicates that there is no limit, and a negative `read_limit` will cause an
+     * indicates that there is no limit, and a negative `read_limit` causes an
      * error.
      *
      * If the stream returns fewer bytes than allowed by the `read_limit` and no
@@ -2156,10 +2156,10 @@ public Builder clearCommonObjectRequestParams() {
      *
      * 
                                                  * Mask specifying which fields to read.
-     * The checksummed_data field and its children will always be present.
-     * If no mask is specified, will default to all fields except metadata.owner
-     * and metadata.acl.
-     * * may be used to mean "all fields".
+     * The `checksummed_data` field and its children are always present.
+     * If no mask is specified, it defaults to all fields except `metadata.
+     * owner` and `metadata.acl`.
+     * `*` might be used to mean "all fields".
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 12;
@@ -2175,10 +2175,10 @@ public boolean hasReadMask() {
      *
      * 
                                                  * Mask specifying which fields to read.
-     * The checksummed_data field and its children will always be present.
-     * If no mask is specified, will default to all fields except metadata.owner
-     * and metadata.acl.
-     * * may be used to mean "all fields".
+     * The `checksummed_data` field and its children are always present.
+     * If no mask is specified, it defaults to all fields except `metadata.
+     * owner` and `metadata.acl`.
+     * `*` might be used to mean "all fields".
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 12;
@@ -2198,10 +2198,10 @@ public com.google.protobuf.FieldMask getReadMask() {
      *
      * 
                                                  * Mask specifying which fields to read.
-     * The checksummed_data field and its children will always be present.
-     * If no mask is specified, will default to all fields except metadata.owner
-     * and metadata.acl.
-     * * may be used to mean "all fields".
+     * The `checksummed_data` field and its children are always present.
+     * If no mask is specified, it defaults to all fields except `metadata.
+     * owner` and `metadata.acl`.
+     * `*` might be used to mean "all fields".
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 12;
@@ -2225,10 +2225,10 @@ public Builder setReadMask(com.google.protobuf.FieldMask value) {
      *
      * 
                                                  * Mask specifying which fields to read.
-     * The checksummed_data field and its children will always be present.
-     * If no mask is specified, will default to all fields except metadata.owner
-     * and metadata.acl.
-     * * may be used to mean "all fields".
+     * The `checksummed_data` field and its children are always present.
+     * If no mask is specified, it defaults to all fields except `metadata.
+     * owner` and `metadata.acl`.
+     * `*` might be used to mean "all fields".
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 12;
@@ -2249,10 +2249,10 @@ public Builder setReadMask(com.google.protobuf.FieldMask.Builder builderForValue
      *
      * 
                                                  * Mask specifying which fields to read.
-     * The checksummed_data field and its children will always be present.
-     * If no mask is specified, will default to all fields except metadata.owner
-     * and metadata.acl.
-     * * may be used to mean "all fields".
+     * The `checksummed_data` field and its children are always present.
+     * If no mask is specified, it defaults to all fields except `metadata.
+     * owner` and `metadata.acl`.
+     * `*` might be used to mean "all fields".
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 12;
@@ -2281,10 +2281,10 @@ public Builder mergeReadMask(com.google.protobuf.FieldMask value) {
      *
      * 
                                                  * Mask specifying which fields to read.
-     * The checksummed_data field and its children will always be present.
-     * If no mask is specified, will default to all fields except metadata.owner
-     * and metadata.acl.
-     * * may be used to mean "all fields".
+     * The `checksummed_data` field and its children are always present.
+     * If no mask is specified, it defaults to all fields except `metadata.
+     * owner` and `metadata.acl`.
+     * `*` might be used to mean "all fields".
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 12;
@@ -2305,10 +2305,10 @@ public Builder clearReadMask() {
      *
      * 
                                                  * Mask specifying which fields to read.
-     * The checksummed_data field and its children will always be present.
-     * If no mask is specified, will default to all fields except metadata.owner
-     * and metadata.acl.
-     * * may be used to mean "all fields".
+     * The `checksummed_data` field and its children are always present.
+     * If no mask is specified, it defaults to all fields except `metadata.
+     * owner` and `metadata.acl`.
+     * `*` might be used to mean "all fields".
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 12;
@@ -2324,10 +2324,10 @@ public com.google.protobuf.FieldMask.Builder getReadMaskBuilder() {
      *
      * 
                                                  * Mask specifying which fields to read.
-     * The checksummed_data field and its children will always be present.
-     * If no mask is specified, will default to all fields except metadata.owner
-     * and metadata.acl.
-     * * may be used to mean "all fields".
+     * The `checksummed_data` field and its children are always present.
+     * If no mask is specified, it defaults to all fields except `metadata.
+     * owner` and `metadata.acl`.
+     * `*` might be used to mean "all fields".
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 12;
@@ -2345,10 +2345,10 @@ public com.google.protobuf.FieldMaskOrBuilder getReadMaskOrBuilder() {
      *
      * 
                                                  * Mask specifying which fields to read.
-     * The checksummed_data field and its children will always be present.
-     * If no mask is specified, will default to all fields except metadata.owner
-     * and metadata.acl.
-     * * may be used to mean "all fields".
+     * The `checksummed_data` field and its children are always present.
+     * If no mask is specified, it defaults to all fields except `metadata.
+     * owner` and `metadata.acl`.
+     * `*` might be used to mean "all fields".
      * 
                                            
      *
      * optional .google.protobuf.FieldMask read_mask = 12;
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ReadObjectRequestOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ReadObjectRequestOrBuilder.java
index b9216e35b8..2c703e5659 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ReadObjectRequestOrBuilder.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ReadObjectRequestOrBuilder.java
@@ -101,12 +101,12 @@ public interface ReadObjectRequestOrBuilder
    * Optional. The offset for the first byte to return in the read, relative to
    * the start of the object.
    *
-   * A negative `read_offset` value will be interpreted as the number of bytes
+   * A negative `read_offset` value is interpreted as the number of bytes
    * back from the end of the object to be returned. For example, if an object's
-   * length is 15 bytes, a ReadObjectRequest with `read_offset` = -5 and
-   * `read_limit` = 3 would return bytes 10 through 12 of the object. Requesting
-   * a negative offset with magnitude larger than the size of the object will
-   * return the entire object.
+   * length is `15` bytes, a `ReadObjectRequest` with `read_offset` = `-5` and
+   * `read_limit` = `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.
    * 
                                            
    *
    * int64 read_offset = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -121,7 +121,7 @@ public interface ReadObjectRequestOrBuilder
    * 
                                                * Optional. The maximum number of `data` bytes the server is allowed to
    * return in the sum of all `Object` messages. A `read_limit` of zero
-   * indicates that there is no limit, and a negative `read_limit` will cause an
+   * indicates that there is no limit, and a negative `read_limit` causes an
    * error.
    *
    * If the stream returns fewer bytes than allowed by the `read_limit` and no
@@ -304,10 +304,10 @@ public interface ReadObjectRequestOrBuilder
    *
    * 
                                                * Mask specifying which fields to read.
-   * The checksummed_data field and its children will always be present.
-   * If no mask is specified, will default to all fields except metadata.owner
-   * and metadata.acl.
-   * * may be used to mean "all fields".
+   * The `checksummed_data` field and its children are always present.
+   * If no mask is specified, it defaults to all fields except `metadata.
+   * owner` and `metadata.acl`.
+   * `*` might be used to mean "all fields".
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 12;
@@ -321,10 +321,10 @@ public interface ReadObjectRequestOrBuilder
    *
    * 
                                                * Mask specifying which fields to read.
-   * The checksummed_data field and its children will always be present.
-   * If no mask is specified, will default to all fields except metadata.owner
-   * and metadata.acl.
-   * * may be used to mean "all fields".
+   * The `checksummed_data` field and its children are always present.
+   * If no mask is specified, it defaults to all fields except `metadata.
+   * owner` and `metadata.acl`.
+   * `*` might be used to mean "all fields".
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 12;
@@ -338,10 +338,10 @@ public interface ReadObjectRequestOrBuilder
    *
    * 
                                                * Mask specifying which fields to read.
-   * The checksummed_data field and its children will always be present.
-   * If no mask is specified, will default to all fields except metadata.owner
-   * and metadata.acl.
-   * * may be used to mean "all fields".
+   * The `checksummed_data` field and its children are always present.
+   * If no mask is specified, it defaults to all fields except `metadata.
+   * owner` and `metadata.acl`.
+   * `*` might be used to mean "all fields".
    * 
                                            
    *
    * optional .google.protobuf.FieldMask read_mask = 12;
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ReadObjectResponse.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ReadObjectResponse.java
index 73e000292b..9b2742318b 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ReadObjectResponse.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ReadObjectResponse.java
@@ -23,7 +23,7 @@
  *
  *
  * 
                                            - * Response message for ReadObject.
+ * Response message for [ReadObject][google.storage.v2.Storage.ReadObject].
  * 
                                            
  *
  * Protobuf type {@code google.storage.v2.ReadObjectResponse}
@@ -70,7 +70,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * 
                                            -   * A portion of the data for the object. The service **may** leave `data`
+   * A portion of the data for the object. The service might leave `data`
    * empty for any given `ReadResponse`. This enables the service to inform the
    * client that the request is still live while it is running an operation to
    * generate more data.
@@ -89,7 +89,7 @@ public boolean hasChecksummedData() {
    *
    *
    * 
                                            -   * A portion of the data for the object. The service **may** leave `data`
+   * A portion of the data for the object. The service might leave `data`
    * empty for any given `ReadResponse`. This enables the service to inform the
    * client that the request is still live while it is running an operation to
    * generate more data.
@@ -110,7 +110,7 @@ public com.google.storage.v2.ChecksummedData getChecksummedData() {
    *
    *
    * 
                                            -   * A portion of the data for the object. The service **may** leave `data`
+   * A portion of the data for the object. The service might leave `data`
    * empty for any given `ReadResponse`. This enables the service to inform the
    * client that the request is still live while it is running an operation to
    * generate more data.
@@ -191,9 +191,9 @@ public com.google.storage.v2.ObjectChecksumsOrBuilder getObjectChecksumsOrBuilde
    *
    *
    * 
                                            -   * If read_offset and or read_limit was specified on the
-   * ReadObjectRequest, ContentRange will be populated on the first
-   * ReadObjectResponse message of the read stream.
+   * If `read_offset` and or `read_limit` is specified on the
+   * `ReadObjectRequest`, `ContentRange` is populated on the first
+   * `ReadObjectResponse` message of the read stream.
    * 
                                            
    *
    * .google.storage.v2.ContentRange content_range = 3;
@@ -209,9 +209,9 @@ public boolean hasContentRange() {
    *
    *
    * 
                                            -   * If read_offset and or read_limit was specified on the
-   * ReadObjectRequest, ContentRange will be populated on the first
-   * ReadObjectResponse message of the read stream.
+   * If `read_offset` and or `read_limit` is specified on the
+   * `ReadObjectRequest`, `ContentRange` is populated on the first
+   * `ReadObjectResponse` message of the read stream.
    * 
                                            
    *
    * .google.storage.v2.ContentRange content_range = 3;
@@ -229,9 +229,9 @@ public com.google.storage.v2.ContentRange getContentRange() {
    *
    *
    * 
                                            -   * If read_offset and or read_limit was specified on the
-   * ReadObjectRequest, ContentRange will be populated on the first
-   * ReadObjectResponse message of the read stream.
+   * If `read_offset` and or `read_limit` is specified on the
+   * `ReadObjectRequest`, `ContentRange` is populated on the first
+   * `ReadObjectResponse` message of the read stream.
    * 
                                            
    *
    * .google.storage.v2.ContentRange content_range = 3;
@@ -505,7 +505,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
                                            -   * Response message for ReadObject.
+   * Response message for [ReadObject][google.storage.v2.Storage.ReadObject].
    * 
                                            
    *
    * Protobuf type {@code google.storage.v2.ReadObjectResponse}
@@ -768,7 +768,7 @@ public Builder mergeFrom(
      *
      *
      * 
                                            -     * A portion of the data for the object. The service **may** leave `data`
+     * A portion of the data for the object. The service might leave `data`
      * empty for any given `ReadResponse`. This enables the service to inform the
      * client that the request is still live while it is running an operation to
      * generate more data.
@@ -786,7 +786,7 @@ public boolean hasChecksummedData() {
      *
      *
      * 
                                            -     * A portion of the data for the object. The service **may** leave `data`
+     * A portion of the data for the object. The service might leave `data`
      * empty for any given `ReadResponse`. This enables the service to inform the
      * client that the request is still live while it is running an operation to
      * generate more data.
@@ -810,7 +810,7 @@ public com.google.storage.v2.ChecksummedData getChecksummedData() {
      *
      *
      * 
                                            -     * A portion of the data for the object. The service **may** leave `data`
+     * A portion of the data for the object. The service might leave `data`
      * empty for any given `ReadResponse`. This enables the service to inform the
      * client that the request is still live while it is running an operation to
      * generate more data.
@@ -836,7 +836,7 @@ public Builder setChecksummedData(com.google.storage.v2.ChecksummedData value) {
      *
      *
      * 
                                            -     * A portion of the data for the object. The service **may** leave `data`
+     * A portion of the data for the object. The service might leave `data`
      * empty for any given `ReadResponse`. This enables the service to inform the
      * client that the request is still live while it is running an operation to
      * generate more data.
@@ -860,7 +860,7 @@ public Builder setChecksummedData(
      *
      *
      * 
                                            -     * A portion of the data for the object. The service **may** leave `data`
+     * A portion of the data for the object. The service might leave `data`
      * empty for any given `ReadResponse`. This enables the service to inform the
      * client that the request is still live while it is running an operation to
      * generate more data.
@@ -891,7 +891,7 @@ public Builder mergeChecksummedData(com.google.storage.v2.ChecksummedData value)
      *
      *
      * 
                                            -     * A portion of the data for the object. The service **may** leave `data`
+     * A portion of the data for the object. The service might leave `data`
      * empty for any given `ReadResponse`. This enables the service to inform the
      * client that the request is still live while it is running an operation to
      * generate more data.
@@ -914,7 +914,7 @@ public Builder clearChecksummedData() {
      *
      *
      * 
                                            -     * A portion of the data for the object. The service **may** leave `data`
+     * A portion of the data for the object. The service might leave `data`
      * empty for any given `ReadResponse`. This enables the service to inform the
      * client that the request is still live while it is running an operation to
      * generate more data.
@@ -932,7 +932,7 @@ public com.google.storage.v2.ChecksummedData.Builder getChecksummedDataBuilder()
      *
      *
      * 
                                            -     * A portion of the data for the object. The service **may** leave `data`
+     * A portion of the data for the object. The service might leave `data`
      * empty for any given `ReadResponse`. This enables the service to inform the
      * client that the request is still live while it is running an operation to
      * generate more data.
@@ -954,7 +954,7 @@ public com.google.storage.v2.ChecksummedDataOrBuilder getChecksummedDataOrBuilde
      *
      *
      * 
                                            -     * A portion of the data for the object. The service **may** leave `data`
+     * A portion of the data for the object. The service might leave `data`
      * empty for any given `ReadResponse`. This enables the service to inform the
      * client that the request is still live while it is running an operation to
      * generate more data.
@@ -1203,9 +1203,9 @@ public com.google.storage.v2.ObjectChecksumsOrBuilder getObjectChecksumsOrBuilde
      *
      *
      * 
                                            -     * If read_offset and or read_limit was specified on the
-     * ReadObjectRequest, ContentRange will be populated on the first
-     * ReadObjectResponse message of the read stream.
+     * If `read_offset` and or `read_limit` is specified on the
+     * `ReadObjectRequest`, `ContentRange` is populated on the first
+     * `ReadObjectResponse` message of the read stream.
      * 
                                            
      *
      * .google.storage.v2.ContentRange content_range = 3;
@@ -1220,9 +1220,9 @@ public boolean hasContentRange() {
      *
      *
      * 
                                            -     * If read_offset and or read_limit was specified on the
-     * ReadObjectRequest, ContentRange will be populated on the first
-     * ReadObjectResponse message of the read stream.
+     * If `read_offset` and or `read_limit` is specified on the
+     * `ReadObjectRequest`, `ContentRange` is populated on the first
+     * `ReadObjectResponse` message of the read stream.
      * 
                                            
      *
      * .google.storage.v2.ContentRange content_range = 3;
@@ -1243,9 +1243,9 @@ public com.google.storage.v2.ContentRange getContentRange() {
      *
      *
      * 
                                            -     * If read_offset and or read_limit was specified on the
-     * ReadObjectRequest, ContentRange will be populated on the first
-     * ReadObjectResponse message of the read stream.
+     * If `read_offset` and or `read_limit` is specified on the
+     * `ReadObjectRequest`, `ContentRange` is populated on the first
+     * `ReadObjectResponse` message of the read stream.
      * 
                                            
      *
      * .google.storage.v2.ContentRange content_range = 3;
@@ -1268,9 +1268,9 @@ public Builder setContentRange(com.google.storage.v2.ContentRange value) {
      *
      *
      * 
                                            -     * If read_offset and or read_limit was specified on the
-     * ReadObjectRequest, ContentRange will be populated on the first
-     * ReadObjectResponse message of the read stream.
+     * If `read_offset` and or `read_limit` is specified on the
+     * `ReadObjectRequest`, `ContentRange` is populated on the first
+     * `ReadObjectResponse` message of the read stream.
      * 
                                            
      *
      * .google.storage.v2.ContentRange content_range = 3;
@@ -1290,9 +1290,9 @@ public Builder setContentRange(com.google.storage.v2.ContentRange.Builder builde
      *
      *
      * 
                                            -     * If read_offset and or read_limit was specified on the
-     * ReadObjectRequest, ContentRange will be populated on the first
-     * ReadObjectResponse message of the read stream.
+     * If `read_offset` and or `read_limit` is specified on the
+     * `ReadObjectRequest`, `ContentRange` is populated on the first
+     * `ReadObjectResponse` message of the read stream.
      * 
                                            
      *
      * .google.storage.v2.ContentRange content_range = 3;
@@ -1320,9 +1320,9 @@ public Builder mergeContentRange(com.google.storage.v2.ContentRange value) {
      *
      *
      * 
                                            -     * If read_offset and or read_limit was specified on the
-     * ReadObjectRequest, ContentRange will be populated on the first
-     * ReadObjectResponse message of the read stream.
+     * If `read_offset` and or `read_limit` is specified on the
+     * `ReadObjectRequest`, `ContentRange` is populated on the first
+     * `ReadObjectResponse` message of the read stream.
      * 
                                            
      *
      * .google.storage.v2.ContentRange content_range = 3;
@@ -1342,9 +1342,9 @@ public Builder clearContentRange() {
      *
      *
      * 
                                            -     * If read_offset and or read_limit was specified on the
-     * ReadObjectRequest, ContentRange will be populated on the first
-     * ReadObjectResponse message of the read stream.
+     * If `read_offset` and or `read_limit` is specified on the
+     * `ReadObjectRequest`, `ContentRange` is populated on the first
+     * `ReadObjectResponse` message of the read stream.
      * 
                                            
      *
      * .google.storage.v2.ContentRange content_range = 3;
@@ -1359,9 +1359,9 @@ public com.google.storage.v2.ContentRange.Builder getContentRangeBuilder() {
      *
      *
      * 
                                            -     * If read_offset and or read_limit was specified on the
-     * ReadObjectRequest, ContentRange will be populated on the first
-     * ReadObjectResponse message of the read stream.
+     * If `read_offset` and or `read_limit` is specified on the
+     * `ReadObjectRequest`, `ContentRange` is populated on the first
+     * `ReadObjectResponse` message of the read stream.
      * 
                                            
      *
      * .google.storage.v2.ContentRange content_range = 3;
@@ -1380,9 +1380,9 @@ public com.google.storage.v2.ContentRangeOrBuilder getContentRangeOrBuilder() {
      *
      *
      * 
                                            -     * If read_offset and or read_limit was specified on the
-     * ReadObjectRequest, ContentRange will be populated on the first
-     * ReadObjectResponse message of the read stream.
+     * If `read_offset` and or `read_limit` is specified on the
+     * `ReadObjectRequest`, `ContentRange` is populated on the first
+     * `ReadObjectResponse` message of the read stream.
      * 
                                            
      *
      * .google.storage.v2.ContentRange content_range = 3;
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ReadObjectResponseOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ReadObjectResponseOrBuilder.java
index 18f944baee..2756d85676 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ReadObjectResponseOrBuilder.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ReadObjectResponseOrBuilder.java
@@ -28,7 +28,7 @@ public interface ReadObjectResponseOrBuilder
    *
    *
    * 
                                            -   * A portion of the data for the object. The service **may** leave `data`
+   * A portion of the data for the object. The service might leave `data`
    * empty for any given `ReadResponse`. This enables the service to inform the
    * client that the request is still live while it is running an operation to
    * generate more data.
@@ -44,7 +44,7 @@ public interface ReadObjectResponseOrBuilder
    *
    *
    * 
                                            -   * A portion of the data for the object. The service **may** leave `data`
+   * A portion of the data for the object. The service might leave `data`
    * empty for any given `ReadResponse`. This enables the service to inform the
    * client that the request is still live while it is running an operation to
    * generate more data.
@@ -60,7 +60,7 @@ public interface ReadObjectResponseOrBuilder
    *
    *
    * 
                                            -   * A portion of the data for the object. The service **may** leave `data`
+   * A portion of the data for the object. The service might leave `data`
    * empty for any given `ReadResponse`. This enables the service to inform the
    * client that the request is still live while it is running an operation to
    * generate more data.
@@ -117,9 +117,9 @@ public interface ReadObjectResponseOrBuilder
    *
    *
    * 
                                            -   * If read_offset and or read_limit was specified on the
-   * ReadObjectRequest, ContentRange will be populated on the first
-   * ReadObjectResponse message of the read stream.
+   * If `read_offset` and or `read_limit` is specified on the
+   * `ReadObjectRequest`, `ContentRange` is populated on the first
+   * `ReadObjectResponse` message of the read stream.
    * 
                                            
    *
    * .google.storage.v2.ContentRange content_range = 3;
@@ -132,9 +132,9 @@ public interface ReadObjectResponseOrBuilder
    *
    *
    * 
                                            -   * If read_offset and or read_limit was specified on the
-   * ReadObjectRequest, ContentRange will be populated on the first
-   * ReadObjectResponse message of the read stream.
+   * If `read_offset` and or `read_limit` is specified on the
+   * `ReadObjectRequest`, `ContentRange` is populated on the first
+   * `ReadObjectResponse` message of the read stream.
    * 
                                            
    *
    * .google.storage.v2.ContentRange content_range = 3;
@@ -147,9 +147,9 @@ public interface ReadObjectResponseOrBuilder
    *
    *
    * 
                                            -   * If read_offset and or read_limit was specified on the
-   * ReadObjectRequest, ContentRange will be populated on the first
-   * ReadObjectResponse message of the read stream.
+   * If `read_offset` and or `read_limit` is specified on the
+   * `ReadObjectRequest`, `ContentRange` is populated on the first
+   * `ReadObjectResponse` message of the read stream.
    * 
                                            
    *
    * .google.storage.v2.ContentRange content_range = 3;
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ReadRange.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ReadRange.java
index dda55f6dd7..f8d909bf20 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ReadRange.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ReadRange.java
@@ -23,7 +23,7 @@
  *
  *
  * 
                                            - * Describes a range of bytes to read in a BidiReadObjectRanges request.
+ * Describes a range of bytes to read in a `BidiReadObjectRanges` request.
  * 
                                            
  *
  * Protobuf type {@code google.storage.v2.ReadRange}
@@ -71,13 +71,13 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    * Required. The offset for the first byte to return in the read, relative to
    * the start of the object.
    *
-   * A negative read_offset value will be interpreted as the number of bytes
+   * A negative read_offset value is interpreted as the number of bytes
    * back from the end of the object to be returned. For example, if an object's
-   * 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 will
-   * return the entire object. A read_offset larger than the size of the object
-   * will result in an OutOfRange error.
+   * 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.
    * 
                                            
    *
    * int64 read_offset = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -97,11 +97,11 @@ public long getReadOffset() {
    *
    * 
                                                * 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 will
-   * cause 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.
+   * 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.
    * 
                                            
    *
    * int64 read_length = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -121,10 +121,10 @@ public long getReadLength() {
    *
    * 
                                                * Required. Read identifier provided by the client. When the client issues
-   * more than one outstanding ReadRange on the same stream, responses can be
+   * more than one outstanding `ReadRange` on the same stream, responses can be
    * mapped back to their corresponding requests using this value. Clients must
    * ensure that all outstanding requests have different read_id values. The
-   * server may close the stream with an error if this condition is not met.
+   * server might close the stream with an error if this condition is not met.
    * 
                                            
    *
    * int64 read_id = 3 [(.google.api.field_behavior) = REQUIRED];
@@ -316,7 +316,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
                                            -   * Describes a range of bytes to read in a BidiReadObjectRanges request.
+   * Describes a range of bytes to read in a `BidiReadObjectRanges` request.
    * 
                                            
    *
    * Protobuf type {@code google.storage.v2.ReadRange}
@@ -525,13 +525,13 @@ public Builder mergeFrom(
      * Required. The offset for the first byte to return in the read, relative to
      * the start of the object.
      *
-     * A negative read_offset value will be interpreted as the number of bytes
+     * A negative read_offset value is interpreted as the number of bytes
      * back from the end of the object to be returned. For example, if an object's
-     * 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 will
-     * return the entire object. A read_offset larger than the size of the object
-     * will result in an OutOfRange error.
+     * 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.
      * 
                                            
      *
      * int64 read_offset = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -550,13 +550,13 @@ public long getReadOffset() {
      * Required. The offset for the first byte to return in the read, relative to
      * the start of the object.
      *
-     * A negative read_offset value will be interpreted as the number of bytes
+     * A negative read_offset value is interpreted as the number of bytes
      * back from the end of the object to be returned. For example, if an object's
-     * 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 will
-     * return the entire object. A read_offset larger than the size of the object
-     * will result in an OutOfRange error.
+     * 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.
      * 
                                            
      *
      * int64 read_offset = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -579,13 +579,13 @@ public Builder setReadOffset(long value) {
      * Required. The offset for the first byte to return in the read, relative to
      * the start of the object.
      *
-     * A negative read_offset value will be interpreted as the number of bytes
+     * A negative read_offset value is interpreted as the number of bytes
      * back from the end of the object to be returned. For example, if an object's
-     * 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 will
-     * return the entire object. A read_offset larger than the size of the object
-     * will result in an OutOfRange error.
+     * 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.
      * 
                                            
      *
      * int64 read_offset = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -606,11 +606,11 @@ public Builder clearReadOffset() {
      *
      * 
                                                  * 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 will
-     * cause 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.
+     * 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.
      * 
                                            
      *
      * int64 read_length = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -627,11 +627,11 @@ public long getReadLength() {
      *
      * 
                                                  * 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 will
-     * cause 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.
+     * 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.
      * 
                                            
      *
      * int64 read_length = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -652,11 +652,11 @@ public Builder setReadLength(long value) {
      *
      * 
                                                  * 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 will
-     * cause 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.
+     * 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.
      * 
                                            
      *
      * int64 read_length = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -677,10 +677,10 @@ public Builder clearReadLength() {
      *
      * 
                                                  * Required. Read identifier provided by the client. When the client issues
-     * more than one outstanding ReadRange on the same stream, responses can be
+     * more than one outstanding `ReadRange` on the same stream, responses can be
      * mapped back to their corresponding requests using this value. Clients must
      * ensure that all outstanding requests have different read_id values. The
-     * server may close the stream with an error if this condition is not met.
+     * server might close the stream with an error if this condition is not met.
      * 
                                            
      *
      * int64 read_id = 3 [(.google.api.field_behavior) = REQUIRED];
@@ -697,10 +697,10 @@ public long getReadId() {
      *
      * 
                                                  * Required. Read identifier provided by the client. When the client issues
-     * more than one outstanding ReadRange on the same stream, responses can be
+     * more than one outstanding `ReadRange` on the same stream, responses can be
      * mapped back to their corresponding requests using this value. Clients must
      * ensure that all outstanding requests have different read_id values. The
-     * server may close the stream with an error if this condition is not met.
+     * server might close the stream with an error if this condition is not met.
      * 
                                            
      *
      * int64 read_id = 3 [(.google.api.field_behavior) = REQUIRED];
@@ -721,10 +721,10 @@ public Builder setReadId(long value) {
      *
      * 
                                                  * Required. Read identifier provided by the client. When the client issues
-     * more than one outstanding ReadRange on the same stream, responses can be
+     * more than one outstanding `ReadRange` on the same stream, responses can be
      * mapped back to their corresponding requests using this value. Clients must
      * ensure that all outstanding requests have different read_id values. The
-     * server may close the stream with an error if this condition is not met.
+     * server might close the stream with an error if this condition is not met.
      * 
                                            
      *
      * int64 read_id = 3 [(.google.api.field_behavior) = REQUIRED];
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ReadRangeOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ReadRangeOrBuilder.java
index 40056c80bd..d005aa9ec1 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ReadRangeOrBuilder.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ReadRangeOrBuilder.java
@@ -31,13 +31,13 @@ public interface ReadRangeOrBuilder
    * Required. The offset for the first byte to return in the read, relative to
    * the start of the object.
    *
-   * A negative read_offset value will be interpreted as the number of bytes
+   * A negative read_offset value is interpreted as the number of bytes
    * back from the end of the object to be returned. For example, if an object's
-   * 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 will
-   * return the entire object. A read_offset larger than the size of the object
-   * will result in an OutOfRange error.
+   * 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.
    * 
                                            
    *
    * int64 read_offset = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -51,11 +51,11 @@ public interface ReadRangeOrBuilder
    *
    * 
                                                * 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 will
-   * cause 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.
+   * 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.
    * 
                                            
    *
    * int64 read_length = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -69,10 +69,10 @@ public interface ReadRangeOrBuilder
    *
    * 
                                                * Required. Read identifier provided by the client. When the client issues
-   * more than one outstanding ReadRange on the same stream, responses can be
+   * more than one outstanding `ReadRange` on the same stream, responses can be
    * mapped back to their corresponding requests using this value. Clients must
    * ensure that all outstanding requests have different read_id values. The
-   * server may close the stream with an error if this condition is not met.
+   * server might close the stream with an error if this condition is not met.
    * 
                                            
    *
    * int64 read_id = 3 [(.google.api.field_behavior) = REQUIRED];
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/RestoreObjectRequest.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/RestoreObjectRequest.java
index f2f8ebca28..4d769d6cae 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/RestoreObjectRequest.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/RestoreObjectRequest.java
@@ -23,7 +23,8 @@
  *
  *
  * 
                                            - * Message for restoring an object.
+ * Request message for
+ * [RestoreObject][google.storage.v2.Storage.RestoreObject].
  * `bucket`, `object`, and `generation` **must** be set.
  * 
                                            
  *
@@ -419,7 +420,7 @@ public long getIfMetagenerationNotMatch() {
    *
    *
    * 
                                            -   * If false or unset, the bucket's default object ACL will be used.
+   * If false or unset, the bucket's default object ACL is used.
    * If true, copy the source object's access controls.
    * Return an error if bucket has UBLA enabled.
    * 
                                            
@@ -437,7 +438,7 @@ public boolean hasCopySourceAcl() {
    *
    *
    * 
                                            -   * If false or unset, the bucket's default object ACL will be used.
+   * If false or unset, the bucket's default object ACL is used.
    * If true, copy the source object's access controls.
    * Return an error if bucket has UBLA enabled.
    * 
                                            
@@ -792,7 +793,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
                                            -   * Message for restoring an object.
+   * Request message for
+   * [RestoreObject][google.storage.v2.Storage.RestoreObject].
    * `bucket`, `object`, and `generation` **must** be set.
    * 
                                            
    *
@@ -1858,7 +1860,7 @@ public Builder clearIfMetagenerationNotMatch() {
      *
      *
      * 
                                            -     * If false or unset, the bucket's default object ACL will be used.
+     * If false or unset, the bucket's default object ACL is used.
      * If true, copy the source object's access controls.
      * Return an error if bucket has UBLA enabled.
      * 
                                            
@@ -1876,7 +1878,7 @@ public boolean hasCopySourceAcl() {
      *
      *
      * 
                                            -     * If false or unset, the bucket's default object ACL will be used.
+     * If false or unset, the bucket's default object ACL is used.
      * If true, copy the source object's access controls.
      * Return an error if bucket has UBLA enabled.
      * 
                                            
@@ -1894,7 +1896,7 @@ public boolean getCopySourceAcl() {
      *
      *
      * 
                                            -     * If false or unset, the bucket's default object ACL will be used.
+     * If false or unset, the bucket's default object ACL is used.
      * If true, copy the source object's access controls.
      * Return an error if bucket has UBLA enabled.
      * 
                                            
@@ -1916,7 +1918,7 @@ public Builder setCopySourceAcl(boolean value) {
      *
      *
      * 
                                            -     * If false or unset, the bucket's default object ACL will be used.
+     * If false or unset, the bucket's default object ACL is used.
      * If true, copy the source object's access controls.
      * Return an error if bucket has UBLA enabled.
      * 
                                            
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/RestoreObjectRequestOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/RestoreObjectRequestOrBuilder.java
index db495cbe8c..63f0e5e515 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/RestoreObjectRequestOrBuilder.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/RestoreObjectRequestOrBuilder.java
@@ -249,7 +249,7 @@ public interface RestoreObjectRequestOrBuilder
    *
    *
    * 
                                            -   * If false or unset, the bucket's default object ACL will be used.
+   * If false or unset, the bucket's default object ACL is used.
    * If true, copy the source object's access controls.
    * Return an error if bucket has UBLA enabled.
    * 
                                            
@@ -264,7 +264,7 @@ public interface RestoreObjectRequestOrBuilder
    *
    *
    * 
                                            -   * If false or unset, the bucket's default object ACL will be used.
+   * If false or unset, the bucket's default object ACL is used.
    * If true, copy the source object's access controls.
    * Return an error if bucket has UBLA enabled.
    * 
                                            
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/RewriteObjectRequest.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/RewriteObjectRequest.java
index c74fc7ecaa..c444ea33c5 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/RewriteObjectRequest.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/RewriteObjectRequest.java
@@ -23,14 +23,15 @@
  *
  *
  * 
                                            - * Request message for RewriteObject.
+ * Request message for [RewriteObject][google.storage.v2.Storage.RewriteObject].
  * If the source object is encrypted using a Customer-Supplied Encryption Key
- * the key information must be provided in the copy_source_encryption_algorithm,
- * copy_source_encryption_key_bytes, and copy_source_encryption_key_sha256_bytes
- * fields. If the destination object should be encrypted the keying information
- * should be provided in the encryption_algorithm, encryption_key_bytes, and
- * encryption_key_sha256_bytes fields of the
- * common_object_request_params.customer_encryption field.
+ * the key information must be provided in the
+ * `copy_source_encryption_algorithm`, `copy_source_encryption_key_bytes`, and
+ * `copy_source_encryption_key_sha256_bytes` fields. If the destination object
+ * should be encrypted the keying information should be provided in the
+ * `encryption_algorithm`, `encryption_key_bytes`, and
+ * `encryption_key_sha256_bytes` fields of the
+ * `common_object_request_params.customer_encryption` field.
  * 
                                            
  *
  * Protobuf type {@code google.storage.v2.RewriteObjectRequest}
@@ -218,7 +219,7 @@ public com.google.protobuf.ByteString getDestinationBucketBytes() {
    *
    *
    * 
                                            -   * Optional. The name of the Cloud KMS key that will be used to encrypt the
+   * Optional. The name of the Cloud KMS key that is used to encrypt the
    * destination object. The Cloud KMS key must be located in same location as
    * the object. If the parameter is not specified, the request uses the
    * destination bucket's default encryption key, if any, or else the
@@ -248,7 +249,7 @@ public java.lang.String getDestinationKmsKey() {
    *
    *
    * 
                                            -   * Optional. The name of the Cloud KMS key that will be used to encrypt the
+   * Optional. The name of the Cloud KMS key that is used to encrypt the
    * destination object. The Cloud KMS key must be located in same location as
    * the object. If the parameter is not specified, the request uses the
    * destination bucket's default encryption key, if any, or else the
@@ -285,8 +286,8 @@ public com.google.protobuf.ByteString getDestinationKmsKeyBytes() {
    * The `name`, `bucket` and `kms_key` fields must not be populated (these
    * values are specified in the `destination_name`, `destination_bucket`, and
    * `destination_kms_key` fields).
-   * If `destination` is present it will be used to construct the destination
-   * object's metadata; otherwise the destination object's metadata will be
+   * If `destination` is present it is used to construct the destination
+   * object's metadata; otherwise the destination object's metadata is
    * copied from the source object.
    * 
                                            
    *
@@ -308,8 +309,8 @@ public boolean hasDestination() {
    * The `name`, `bucket` and `kms_key` fields must not be populated (these
    * values are specified in the `destination_name`, `destination_bucket`, and
    * `destination_kms_key` fields).
-   * If `destination` is present it will be used to construct the destination
-   * object's metadata; otherwise the destination object's metadata will be
+   * If `destination` is present it is used to construct the destination
+   * object's metadata; otherwise the destination object's metadata is
    * copied from the source object.
    * 
                                            
    *
@@ -331,8 +332,8 @@ public com.google.storage.v2.Object getDestination() {
    * The `name`, `bucket` and `kms_key` fields must not be populated (these
    * values are specified in the `destination_name`, `destination_bucket`, and
    * `destination_kms_key` fields).
-   * If `destination` is present it will be used to construct the destination
-   * object's metadata; otherwise the destination object's metadata will be
+   * If `destination` is present it is used to construct the destination
+   * object's metadata; otherwise the destination object's metadata is
    * copied from the source object.
    * 
                                            
    *
@@ -545,8 +546,8 @@ public com.google.protobuf.ByteString getRewriteTokenBytes() {
    *
    * 
                                                * Optional. Apply a predefined set of access controls to the destination
-   * object. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-   * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+   * object. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+   * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
    * 
                                            
    *
    * string destination_predefined_acl = 28 [(.google.api.field_behavior) = OPTIONAL];
@@ -571,8 +572,8 @@ public java.lang.String getDestinationPredefinedAcl() {
    *
    * 
                                                * Optional. Apply a predefined set of access controls to the destination
-   * object. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-   * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+   * object. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+   * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
    * 
                                            
    *
    * string destination_predefined_acl = 28 [(.google.api.field_behavior) = OPTIONAL];
@@ -901,7 +902,7 @@ public long getIfSourceMetagenerationNotMatch() {
    *
    *
    * 
                                            -   * Optional. The maximum number of bytes that will be rewritten per rewrite
+   * Optional. The maximum number of bytes that are rewritten per rewrite
    * request. Most callers shouldn't need to specify this parameter - it is
    * primarily in place to support testing. If specified the value must be an
    * integral multiple of 1 MiB (1048576). Also, this only applies to requests
@@ -1093,8 +1094,8 @@ public com.google.storage.v2.CommonObjectRequestParams getCommonObjectRequestPar
    *
    *
    * 
                                            -   * Optional. The checksums of the complete object. This will be used to
-   * validate the destination object after rewriting.
+   * Optional. The checksums of the complete object. This is used to validate
+   * the destination object after rewriting.
    * 
                                            
    *
    * 
@@ -1112,8 +1113,8 @@ public boolean hasObjectChecksums() {
    *
    *
    * 
                                            -   * Optional. The checksums of the complete object. This will be used to
-   * validate the destination object after rewriting.
+   * Optional. The checksums of the complete object. This is used to validate
+   * the destination object after rewriting.
    * 
                                            
    *
    * 
@@ -1133,8 +1134,8 @@ public com.google.storage.v2.ObjectChecksums getObjectChecksums() {
    *
    *
    * 
                                            -   * Optional. The checksums of the complete object. This will be used to
-   * validate the destination object after rewriting.
+   * Optional. The checksums of the complete object. This is used to validate
+   * the destination object after rewriting.
    * 
                                            
    *
    * 
@@ -1585,14 +1586,15 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
                                            -   * Request message for RewriteObject.
+   * Request message for [RewriteObject][google.storage.v2.Storage.RewriteObject].
    * If the source object is encrypted using a Customer-Supplied Encryption Key
-   * the key information must be provided in the copy_source_encryption_algorithm,
-   * copy_source_encryption_key_bytes, and copy_source_encryption_key_sha256_bytes
-   * fields. If the destination object should be encrypted the keying information
-   * should be provided in the encryption_algorithm, encryption_key_bytes, and
-   * encryption_key_sha256_bytes fields of the
-   * common_object_request_params.customer_encryption field.
+   * the key information must be provided in the
+   * `copy_source_encryption_algorithm`, `copy_source_encryption_key_bytes`, and
+   * `copy_source_encryption_key_sha256_bytes` fields. If the destination object
+   * should be encrypted the keying information should be provided in the
+   * `encryption_algorithm`, `encryption_key_bytes`, and
+   * `encryption_key_sha256_bytes` fields of the
+   * `common_object_request_params.customer_encryption` field.
    * 
                                            
    *
    * Protobuf type {@code google.storage.v2.RewriteObjectRequest}
@@ -2395,7 +2397,7 @@ public Builder setDestinationBucketBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
                                            -     * Optional. The name of the Cloud KMS key that will be used to encrypt the
+     * Optional. The name of the Cloud KMS key that is used to encrypt the
      * destination object. The Cloud KMS key must be located in same location as
      * the object. If the parameter is not specified, the request uses the
      * destination bucket's default encryption key, if any, or else the
@@ -2424,7 +2426,7 @@ public java.lang.String getDestinationKmsKey() {
      *
      *
      * 
                                            -     * Optional. The name of the Cloud KMS key that will be used to encrypt the
+     * Optional. The name of the Cloud KMS key that is used to encrypt the
      * destination object. The Cloud KMS key must be located in same location as
      * the object. If the parameter is not specified, the request uses the
      * destination bucket's default encryption key, if any, or else the
@@ -2453,7 +2455,7 @@ public com.google.protobuf.ByteString getDestinationKmsKeyBytes() {
      *
      *
      * 
                                            -     * Optional. The name of the Cloud KMS key that will be used to encrypt the
+     * Optional. The name of the Cloud KMS key that is used to encrypt the
      * destination object. The Cloud KMS key must be located in same location as
      * the object. If the parameter is not specified, the request uses the
      * destination bucket's default encryption key, if any, or else the
@@ -2481,7 +2483,7 @@ public Builder setDestinationKmsKey(java.lang.String value) {
      *
      *
      * 
                                            -     * Optional. The name of the Cloud KMS key that will be used to encrypt the
+     * Optional. The name of the Cloud KMS key that is used to encrypt the
      * destination object. The Cloud KMS key must be located in same location as
      * the object. If the parameter is not specified, the request uses the
      * destination bucket's default encryption key, if any, or else the
@@ -2505,7 +2507,7 @@ public Builder clearDestinationKmsKey() {
      *
      *
      * 
                                            -     * Optional. The name of the Cloud KMS key that will be used to encrypt the
+     * Optional. The name of the Cloud KMS key that is used to encrypt the
      * destination object. The Cloud KMS key must be located in same location as
      * the object. If the parameter is not specified, the request uses the
      * destination bucket's default encryption key, if any, or else the
@@ -2545,8 +2547,8 @@ public Builder setDestinationKmsKeyBytes(com.google.protobuf.ByteString value) {
      * The `name`, `bucket` and `kms_key` fields must not be populated (these
      * values are specified in the `destination_name`, `destination_bucket`, and
      * `destination_kms_key` fields).
-     * If `destination` is present it will be used to construct the destination
-     * object's metadata; otherwise the destination object's metadata will be
+     * If `destination` is present it is used to construct the destination
+     * object's metadata; otherwise the destination object's metadata is
      * copied from the source object.
      * 
                                            
      *
@@ -2567,8 +2569,8 @@ public boolean hasDestination() {
      * The `name`, `bucket` and `kms_key` fields must not be populated (these
      * values are specified in the `destination_name`, `destination_bucket`, and
      * `destination_kms_key` fields).
-     * If `destination` is present it will be used to construct the destination
-     * object's metadata; otherwise the destination object's metadata will be
+     * If `destination` is present it is used to construct the destination
+     * object's metadata; otherwise the destination object's metadata is
      * copied from the source object.
      * 
                                            
      *
@@ -2595,8 +2597,8 @@ public com.google.storage.v2.Object getDestination() {
      * The `name`, `bucket` and `kms_key` fields must not be populated (these
      * values are specified in the `destination_name`, `destination_bucket`, and
      * `destination_kms_key` fields).
-     * If `destination` is present it will be used to construct the destination
-     * object's metadata; otherwise the destination object's metadata will be
+     * If `destination` is present it is used to construct the destination
+     * object's metadata; otherwise the destination object's metadata is
      * copied from the source object.
      * 
                                            
      *
@@ -2625,8 +2627,8 @@ public Builder setDestination(com.google.storage.v2.Object value) {
      * The `name`, `bucket` and `kms_key` fields must not be populated (these
      * values are specified in the `destination_name`, `destination_bucket`, and
      * `destination_kms_key` fields).
-     * If `destination` is present it will be used to construct the destination
-     * object's metadata; otherwise the destination object's metadata will be
+     * If `destination` is present it is used to construct the destination
+     * object's metadata; otherwise the destination object's metadata is
      * copied from the source object.
      * 
                                            
      *
@@ -2652,8 +2654,8 @@ public Builder setDestination(com.google.storage.v2.Object.Builder builderForVal
      * The `name`, `bucket` and `kms_key` fields must not be populated (these
      * values are specified in the `destination_name`, `destination_bucket`, and
      * `destination_kms_key` fields).
-     * If `destination` is present it will be used to construct the destination
-     * object's metadata; otherwise the destination object's metadata will be
+     * If `destination` is present it is used to construct the destination
+     * object's metadata; otherwise the destination object's metadata is
      * copied from the source object.
      * 
                                            
      *
@@ -2687,8 +2689,8 @@ public Builder mergeDestination(com.google.storage.v2.Object value) {
      * The `name`, `bucket` and `kms_key` fields must not be populated (these
      * values are specified in the `destination_name`, `destination_bucket`, and
      * `destination_kms_key` fields).
-     * If `destination` is present it will be used to construct the destination
-     * object's metadata; otherwise the destination object's metadata will be
+     * If `destination` is present it is used to construct the destination
+     * object's metadata; otherwise the destination object's metadata is
      * copied from the source object.
      * 
                                            
      *
@@ -2714,8 +2716,8 @@ public Builder clearDestination() {
      * The `name`, `bucket` and `kms_key` fields must not be populated (these
      * values are specified in the `destination_name`, `destination_bucket`, and
      * `destination_kms_key` fields).
-     * If `destination` is present it will be used to construct the destination
-     * object's metadata; otherwise the destination object's metadata will be
+     * If `destination` is present it is used to construct the destination
+     * object's metadata; otherwise the destination object's metadata is
      * copied from the source object.
      * 
                                            
      *
@@ -2736,8 +2738,8 @@ public com.google.storage.v2.Object.Builder getDestinationBuilder() {
      * The `name`, `bucket` and `kms_key` fields must not be populated (these
      * values are specified in the `destination_name`, `destination_bucket`, and
      * `destination_kms_key` fields).
-     * If `destination` is present it will be used to construct the destination
-     * object's metadata; otherwise the destination object's metadata will be
+     * If `destination` is present it is used to construct the destination
+     * object's metadata; otherwise the destination object's metadata is
      * copied from the source object.
      * 
                                            
      *
@@ -2762,8 +2764,8 @@ public com.google.storage.v2.ObjectOrBuilder getDestinationOrBuilder() {
      * The `name`, `bucket` and `kms_key` fields must not be populated (these
      * values are specified in the `destination_name`, `destination_bucket`, and
      * `destination_kms_key` fields).
-     * If `destination` is present it will be used to construct the destination
-     * object's metadata; otherwise the destination object's metadata will be
+     * If `destination` is present it is used to construct the destination
+     * object's metadata; otherwise the destination object's metadata is
      * copied from the source object.
      * 
                                            
      *
@@ -3216,8 +3218,8 @@ public Builder setRewriteTokenBytes(com.google.protobuf.ByteString value) {
      *
      * 
                                                  * Optional. Apply a predefined set of access controls to the destination
-     * object. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-     * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+     * object. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+     * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
      * 
                                            
      *
      * string destination_predefined_acl = 28 [(.google.api.field_behavior) = OPTIONAL];
@@ -3242,8 +3244,8 @@ public java.lang.String getDestinationPredefinedAcl() {
      *
      * 
                                                  * Optional. Apply a predefined set of access controls to the destination
-     * object. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-     * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+     * object. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+     * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
      * 
                                            
      *
      * string destination_predefined_acl = 28 [(.google.api.field_behavior) = OPTIONAL];
@@ -3268,8 +3270,8 @@ public com.google.protobuf.ByteString getDestinationPredefinedAclBytes() {
      *
      * 
                                                  * Optional. Apply a predefined set of access controls to the destination
-     * object. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-     * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+     * object. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+     * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
      * 
                                            
      *
      * string destination_predefined_acl = 28 [(.google.api.field_behavior) = OPTIONAL];
@@ -3293,8 +3295,8 @@ public Builder setDestinationPredefinedAcl(java.lang.String value) {
      *
      * 
                                                  * Optional. Apply a predefined set of access controls to the destination
-     * object. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-     * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+     * object. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+     * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
      * 
                                            
      *
      * string destination_predefined_acl = 28 [(.google.api.field_behavior) = OPTIONAL];
@@ -3314,8 +3316,8 @@ public Builder clearDestinationPredefinedAcl() {
      *
      * 
                                                  * Optional. Apply a predefined set of access controls to the destination
-     * object. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-     * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+     * object. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+     * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
      * 
                                            
      *
      * string destination_predefined_acl = 28 [(.google.api.field_behavior) = OPTIONAL];
@@ -3961,7 +3963,7 @@ public Builder clearIfSourceMetagenerationNotMatch() {
      *
      *
      * 
                                            -     * Optional. The maximum number of bytes that will be rewritten per rewrite
+     * Optional. The maximum number of bytes that are rewritten per rewrite
      * request. Most callers shouldn't need to specify this parameter - it is
      * primarily in place to support testing. If specified the value must be an
      * integral multiple of 1 MiB (1048576). Also, this only applies to requests
@@ -3984,7 +3986,7 @@ public long getMaxBytesRewrittenPerCall() {
      *
      *
      * 
                                            -     * Optional. The maximum number of bytes that will be rewritten per rewrite
+     * Optional. The maximum number of bytes that are rewritten per rewrite
      * request. Most callers shouldn't need to specify this parameter - it is
      * primarily in place to support testing. If specified the value must be an
      * integral multiple of 1 MiB (1048576). Also, this only applies to requests
@@ -4011,7 +4013,7 @@ public Builder setMaxBytesRewrittenPerCall(long value) {
      *
      *
      * 
                                            -     * Optional. The maximum number of bytes that will be rewritten per rewrite
+     * Optional. The maximum number of bytes that are rewritten per rewrite
      * request. Most callers shouldn't need to specify this parameter - it is
      * primarily in place to support testing. If specified the value must be an
      * integral multiple of 1 MiB (1048576). Also, this only applies to requests
@@ -4531,8 +4533,8 @@ public Builder clearCommonObjectRequestParams() {
      *
      *
      * 
                                            -     * Optional. The checksums of the complete object. This will be used to
-     * validate the destination object after rewriting.
+     * Optional. The checksums of the complete object. This is used to validate
+     * the destination object after rewriting.
      * 
                                            
      *
      * 
@@ -4549,8 +4551,8 @@ public boolean hasObjectChecksums() {
      *
      *
      * 
                                            -     * Optional. The checksums of the complete object. This will be used to
-     * validate the destination object after rewriting.
+     * Optional. The checksums of the complete object. This is used to validate
+     * the destination object after rewriting.
      * 
                                            
      *
      * 
@@ -4573,8 +4575,8 @@ public com.google.storage.v2.ObjectChecksums getObjectChecksums() {
      *
      *
      * 
                                            -     * Optional. The checksums of the complete object. This will be used to
-     * validate the destination object after rewriting.
+     * Optional. The checksums of the complete object. This is used to validate
+     * the destination object after rewriting.
      * 
                                            
      *
      * 
@@ -4599,8 +4601,8 @@ public Builder setObjectChecksums(com.google.storage.v2.ObjectChecksums value) {
      *
      *
      * 
                                            -     * Optional. The checksums of the complete object. This will be used to
-     * validate the destination object after rewriting.
+     * Optional. The checksums of the complete object. This is used to validate
+     * the destination object after rewriting.
      * 
                                            
      *
      * 
@@ -4623,8 +4625,8 @@ public Builder setObjectChecksums(
      *
      *
      * 
                                            -     * Optional. The checksums of the complete object. This will be used to
-     * validate the destination object after rewriting.
+     * Optional. The checksums of the complete object. This is used to validate
+     * the destination object after rewriting.
      * 
                                            
      *
      * 
@@ -4654,8 +4656,8 @@ public Builder mergeObjectChecksums(com.google.storage.v2.ObjectChecksums value)
      *
      *
      * 
                                            -     * Optional. The checksums of the complete object. This will be used to
-     * validate the destination object after rewriting.
+     * Optional. The checksums of the complete object. This is used to validate
+     * the destination object after rewriting.
      * 
                                            
      *
      * 
@@ -4677,8 +4679,8 @@ public Builder clearObjectChecksums() {
      *
      *
      * 
                                            -     * Optional. The checksums of the complete object. This will be used to
-     * validate the destination object after rewriting.
+     * Optional. The checksums of the complete object. This is used to validate
+     * the destination object after rewriting.
      * 
                                            
      *
      * 
@@ -4695,8 +4697,8 @@ public com.google.storage.v2.ObjectChecksums.Builder getObjectChecksumsBuilder()
      *
      *
      * 
                                            -     * Optional. The checksums of the complete object. This will be used to
-     * validate the destination object after rewriting.
+     * Optional. The checksums of the complete object. This is used to validate
+     * the destination object after rewriting.
      * 
                                            
      *
      * 
@@ -4717,8 +4719,8 @@ public com.google.storage.v2.ObjectChecksumsOrBuilder getObjectChecksumsOrBuilde
      *
      *
      * 
                                            -     * Optional. The checksums of the complete object. This will be used to
-     * validate the destination object after rewriting.
+     * Optional. The checksums of the complete object. This is used to validate
+     * the destination object after rewriting.
      * 
                                            
      *
      * 
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/RewriteObjectRequestOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/RewriteObjectRequestOrBuilder.java
index 1093a2fd3c..159a8db66d 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/RewriteObjectRequestOrBuilder.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/RewriteObjectRequestOrBuilder.java
@@ -102,7 +102,7 @@ public interface RewriteObjectRequestOrBuilder
    *
    *
    * 
                                            -   * Optional. The name of the Cloud KMS key that will be used to encrypt the
+   * Optional. The name of the Cloud KMS key that is used to encrypt the
    * destination object. The Cloud KMS key must be located in same location as
    * the object. If the parameter is not specified, the request uses the
    * destination bucket's default encryption key, if any, or else the
@@ -121,7 +121,7 @@ public interface RewriteObjectRequestOrBuilder
    *
    *
    * 
                                            -   * Optional. The name of the Cloud KMS key that will be used to encrypt the
+   * Optional. The name of the Cloud KMS key that is used to encrypt the
    * destination object. The Cloud KMS key must be located in same location as
    * the object. If the parameter is not specified, the request uses the
    * destination bucket's default encryption key, if any, or else the
@@ -144,8 +144,8 @@ public interface RewriteObjectRequestOrBuilder
    * The `name`, `bucket` and `kms_key` fields must not be populated (these
    * values are specified in the `destination_name`, `destination_bucket`, and
    * `destination_kms_key` fields).
-   * If `destination` is present it will be used to construct the destination
-   * object's metadata; otherwise the destination object's metadata will be
+   * If `destination` is present it is used to construct the destination
+   * object's metadata; otherwise the destination object's metadata is
    * copied from the source object.
    * 
                                            
    *
@@ -164,8 +164,8 @@ public interface RewriteObjectRequestOrBuilder
    * The `name`, `bucket` and `kms_key` fields must not be populated (these
    * values are specified in the `destination_name`, `destination_bucket`, and
    * `destination_kms_key` fields).
-   * If `destination` is present it will be used to construct the destination
-   * object's metadata; otherwise the destination object's metadata will be
+   * If `destination` is present it is used to construct the destination
+   * object's metadata; otherwise the destination object's metadata is
    * copied from the source object.
    * 
                                            
    *
@@ -184,8 +184,8 @@ public interface RewriteObjectRequestOrBuilder
    * The `name`, `bucket` and `kms_key` fields must not be populated (these
    * values are specified in the `destination_name`, `destination_bucket`, and
    * `destination_kms_key` fields).
-   * If `destination` is present it will be used to construct the destination
-   * object's metadata; otherwise the destination object's metadata will be
+   * If `destination` is present it is used to construct the destination
+   * object's metadata; otherwise the destination object's metadata is
    * copied from the source object.
    * 
                                            
    *
@@ -303,8 +303,8 @@ public interface RewriteObjectRequestOrBuilder
    *
    * 
                                                * Optional. Apply a predefined set of access controls to the destination
-   * object. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-   * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+   * object. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+   * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
    * 
                                            
    *
    * string destination_predefined_acl = 28 [(.google.api.field_behavior) = OPTIONAL];
@@ -318,8 +318,8 @@ public interface RewriteObjectRequestOrBuilder
    *
    * 
                                                * Optional. Apply a predefined set of access controls to the destination
-   * object. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-   * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+   * object. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+   * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
    * 
                                            
    *
    * string destination_predefined_acl = 28 [(.google.api.field_behavior) = OPTIONAL];
@@ -562,7 +562,7 @@ public interface RewriteObjectRequestOrBuilder
    *
    *
    * 
                                            -   * Optional. The maximum number of bytes that will be rewritten per rewrite
+   * Optional. The maximum number of bytes that are rewritten per rewrite
    * request. Most callers shouldn't need to specify this parameter - it is
    * primarily in place to support testing. If specified the value must be an
    * integral multiple of 1 MiB (1048576). Also, this only applies to requests
@@ -690,8 +690,8 @@ public interface RewriteObjectRequestOrBuilder
    *
    *
    * 
                                            -   * Optional. The checksums of the complete object. This will be used to
-   * validate the destination object after rewriting.
+   * Optional. The checksums of the complete object. This is used to validate
+   * the destination object after rewriting.
    * 
                                            
    *
    * 
@@ -706,8 +706,8 @@ public interface RewriteObjectRequestOrBuilder
    *
    *
    * 
                                            -   * Optional. The checksums of the complete object. This will be used to
-   * validate the destination object after rewriting.
+   * Optional. The checksums of the complete object. This is used to validate
+   * the destination object after rewriting.
    * 
                                            
    *
    * 
@@ -722,8 +722,8 @@ public interface RewriteObjectRequestOrBuilder
    *
    *
    * 
                                            -   * Optional. The checksums of the complete object. This will be used to
-   * validate the destination object after rewriting.
+   * Optional. The checksums of the complete object. This is used to validate
+   * the destination object after rewriting.
    * 
                                            
    *
    * 
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ServiceConstants.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ServiceConstants.java
index e13983e936..a5513bdb7d 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ServiceConstants.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ServiceConstants.java
@@ -86,8 +86,8 @@ public enum Values implements com.google.protobuf.ProtocolMessageEnum {
      *
      *
      * 
                                            -     * The maximum size chunk that can will be returned in a single
-     * ReadRequest.
+     * The maximum size chunk that can be returned in a single
+     * `ReadRequest`.
      * 2 MiB.
      * 
                                            
      *
@@ -295,8 +295,8 @@ public enum Values implements com.google.protobuf.ProtocolMessageEnum {
      *
      *
      * 
                                            -     * The maximum size chunk that can will be returned in a single
-     * ReadRequest.
+     * The maximum size chunk that can be returned in a single
+     * `ReadRequest`.
      * 2 MiB.
      * 
                                            
      *
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/StartResumableWriteRequest.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/StartResumableWriteRequest.java
index 78c222f6bc..e897c28d93 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/StartResumableWriteRequest.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/StartResumableWriteRequest.java
@@ -23,7 +23,8 @@
  *
  *
  * 
                                            - * Request message StartResumableWrite.
+ * Request message for
+ * [StartResumableWrite][google.storage.v2.Storage.StartResumableWrite].
  * 
                                            
  *
  * Protobuf type {@code google.storage.v2.StartResumableWriteRequest}
@@ -456,7 +457,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
                                            -   * Request message StartResumableWrite.
+   * Request message for
+   * [StartResumableWrite][google.storage.v2.Storage.StartResumableWrite].
    * 
                                            
    *
    * Protobuf type {@code google.storage.v2.StartResumableWriteRequest}
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/StartResumableWriteResponse.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/StartResumableWriteResponse.java
index 90c469445f..0e26c2ac5a 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/StartResumableWriteResponse.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/StartResumableWriteResponse.java
@@ -23,7 +23,8 @@
  *
  *
  * 
                                            - * Response object for `StartResumableWrite`.
+ * Response object for
+ * [StartResumableWrite][google.storage.v2.Storage.StartResumableWrite].
  * 
                                            
  *
  * Protobuf type {@code google.storage.v2.StartResumableWriteResponse}
@@ -289,7 +290,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
                                            -   * Response object for `StartResumableWrite`.
+   * Response object for
+   * [StartResumableWrite][google.storage.v2.Storage.StartResumableWrite].
    * 
                                            
    *
    * Protobuf type {@code google.storage.v2.StartResumableWriteResponse}
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/StorageProto.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/StorageProto.java
index 36d6c8d9e5..382d615118 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/StorageProto.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/StorageProto.java
@@ -415,18 +415,20 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "\tbucket_id\030\003 \001(\tB\003\340A\002\022\033\n"
           + "\016predefined_acl\030\006 \001(\tB\003\340A\001\022*\n"
           + "\035predefined_default_object_acl\030\007 \001(\tB\003\340A\001\022$\n"
-          + "\027enable_object_retention\030\t \001(\010B\003\340A\001\"\323\001\n"
+          + "\027enable_object_retention\030\t \001(\010B\003\340A\001\"\370\001\n"
           + "\022ListBucketsRequest\0225\n"
           + "\006parent\030\001 \001("
           + "\tB%\340A\002\372A\037\022\035storage.googleapis.com/Bucket\022\026\n"
           + "\tpage_size\030\002 \001(\005B\003\340A\001\022\027\n\n"
           + "page_token\030\003 \001(\tB\003\340A\001\022\023\n"
           + "\006prefix\030\004 \001(\tB\003\340A\001\0222\n"
-          + "\tread_mask\030\005 \001(\0132\032.google.protobuf.FieldMaskH\000\210\001\001B\014\n\n"
-          + "_read_mask\"Z\n"
+          + "\tread_mask\030\005 \001(\0132\032.google.protobuf.FieldMaskH\000\210\001\001\022#\n"
+          + "\026return_partial_success\030\t \001(\010B\003\340A\001B\014\n\n"
+          + "_read_mask\"o\n"
           + "\023ListBucketsResponse\022*\n"
           + "\007buckets\030\001 \003(\0132\031.google.storage.v2.Bucket\022\027\n"
-          + "\017next_page_token\030\002 \001(\t\"\177\n"
+          + "\017next_page_token\030\002 \001(\t\022\023\n"
+          + "\013unreachable\030\003 \003(\t\"\177\n"
           + " LockBucketRetentionPolicyRequest\0225\n"
           + "\006bucket\030\001 \001(\tB%\340A\002\372A\037\n"
           + "\035storage.googleapis.com/Bucket\022$\n"
@@ -442,22 +444,23 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "\034_if_metageneration_not_match\"\226\006\n"
           + "\024ComposeObjectRequest\0223\n"
           + "\013destination\030\001 \001(\0132\031.google.storage.v2.ObjectB\003\340A\002\022Q\n"
-          + "\016source_objects\030\002 \003(\01324.go"
-          + "ogle.storage.v2.ComposeObjectRequest.SourceObjectB\003\340A\001\022\'\n"
+          + "\016source_objects\030\002"
+          + " \003(\01324.google.storage.v2.ComposeObjectRequest.SourceObjectB\003\340A\001\022\'\n"
           + "\032destination_predefined_acl\030\t \001(\tB\003\340A\001\022 \n"
           + "\023if_generation_match\030\004 \001(\003H\000\210\001\001\022$\n"
           + "\027if_metageneration_match\030\005 \001(\003H\001\210\001\001\022:\n"
           + "\007kms_key\030\006 \001(\tB)\340A\001\372A#\n"
           + "!cloudkms.googleapis.com/CryptoKey\022W\n"
-          + "\034common_object_request_params\030\007"
-          + " \001(\0132,.google.storage.v2.CommonObjectRequestParamsB\003\340A\001\022A\n"
+          + "\034common_object_request_params\030\007 "
+          + "\001(\0132,.google.storage.v2.CommonObjectRequestParamsB\003\340A\001\022A\n"
           + "\020object_checksums\030\n"
           + " \001(\0132\".google.storage.v2.ObjectChecksumsB\003\340A\001\032\370\001\n"
           + "\014SourceObject\022\021\n"
-          + "\004name\030\001 \001(\tB\003\340A\002\022\027\n\n"
+          + "\004name\030\001 \001(\tB\003\340A\002\022\027\n"
+          + "\n"
           + "generation\030\002 \001(\003B\003\340A\001\022k\n"
-          + "\024object_preconditions\030\003 \001(\0132H.goo"
-          + "gle.storage.v2.ComposeObjectRequest.SourceObject.ObjectPreconditionsB\003\340A\001\032O\n"
+          + "\024object_preconditions\030\003 \001(\0132H.google.storage.v2.Compose"
+          + "ObjectRequest.SourceObject.ObjectPreconditionsB\003\340A\001\032O\n"
           + "\023ObjectPreconditions\022 \n"
           + "\023if_generation_match\030\001 \001(\003H\000\210\001\001B\026\n"
           + "\024_if_generation_matchB\026\n"
@@ -489,8 +492,8 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "\027if_metageneration_match\030\006 \001(\003H\002\210\001\001\022(\n"
           + "\033if_metageneration_not_match\030\007 \001(\003H\003\210\001\001\022\034\n"
           + "\017copy_source_acl\030\t \001(\010H\004\210\001\001\022W\n"
-          + "\034common_object_request_params\030\010"
-          + " \001(\0132,.google.storage.v2.CommonObjectRequestParamsB\003\340A\001B\026\n"
+          + "\034common_object_request_params\030\010 \001(\0132,.g"
+          + "oogle.storage.v2.CommonObjectRequestParamsB\003\340A\001B\026\n"
           + "\024_if_generation_matchB\032\n"
           + "\030_if_generation_not_matchB\032\n"
           + "\030_if_metageneration_matchB\036\n"
@@ -504,8 +507,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "\035storage.googleapis.com/Bucket\022\023\n"
           + "\006object\030\002 \001(\tB\003\340A\002\022\027\n\n"
           + "generation\030\003 \001(\003B\003\340A\001\022\030\n"
-          + "\013read_offset\030\004 \001(\003B\003\340A\001\022\027\n"
-          + "\n"
+          + "\013read_offset\030\004 \001(\003B\003\340A\001\022\027\n\n"
           + "read_limit\030\005 \001(\003B\003\340A\001\022 \n"
           + "\023if_generation_match\030\006 \001(\003H\000\210\001\001\022$\n"
           + "\027if_generation_not_match\030\007 \001(\003H\001\210\001\001\022$\n"
@@ -529,8 +531,8 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "\027if_generation_not_match\030\005 \001(\003H\002\210\001\001\022$\n"
           + "\027if_metageneration_match\030\006 \001(\003H\003\210\001\001\022(\n"
           + "\033if_metageneration_not_match\030\007 \001(\003H\004\210\001\001\022W\n"
-          + "\034common_object_request_params\030\010"
-          + " \001(\0132,.google.storage.v2.CommonObjectRequestParamsB\003\340A\001\0222\n"
+          + "\034common_object_request_params\030\010 \001(\0132,"
+          + ".google.storage.v2.CommonObjectRequestParamsB\003\340A\001\0222\n"
           + "\tread_mask\030\n"
           + " \001(\0132\032.google.protobuf.FieldMaskH\005\210\001\001\022\032\n\r"
           + "restore_token\030\014 \001(\tB\003\340A\001B\017\n\r"
@@ -554,8 +556,8 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "\027if_generation_not_match\030\005 \001(\003H\001\210\001\001\022$\n"
           + "\027if_metageneration_match\030\006 \001(\003H\002\210\001\001\022(\n"
           + "\033if_metageneration_not_match\030\007 \001(\003H\003\210\001\001\022W\n"
-          + "\034common_object_request_params\030\010"
-          + " \001(\0132,.google.storage.v2.CommonObjectRequestParamsB\003\340A\001\0226\n"
+          + "\034common_object_request_params\030\010 \001(\0132,.goo"
+          + "gle.storage.v2.CommonObjectRequestParamsB\003\340A\001\0226\n"
           + "\tread_mask\030\014"
           + " \001(\0132\032.google.protobuf.FieldMaskB\002\030\001H\004\210\001\001\022;\n"
           + "\013read_handle\030\r"
@@ -569,8 +571,8 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "\014_read_handleB\020\n"
           + "\016_routing_token\"\225\001\n"
           + "\025BidiReadObjectRequest\022D\n"
-          + "\020read_object_spec\030\001"
-          + " \001(\0132%.google.storage.v2.BidiReadObjectSpecB\003\340A\001\0226\n"
+          + "\020read_object_spec\030\001 \001"
+          + "(\0132%.google.storage.v2.BidiReadObjectSpecB\003\340A\001\0226\n"
           + "\013read_ranges\030\010"
           + " \003(\0132\034.google.storage.v2.ReadRangeB\003\340A\001\"\275\001\n"
           + "\026BidiReadObjectResponse\022>\n"
@@ -587,8 +589,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + " \001(\0132\".google.storage.v2.BidiWriteHandleH\001\210\001\001\022\027\n\n"
           + "generation\030\003 \001(\003H\002\210\001\001B\020\n"
           + "\016_routing_tokenB\017\n\r"
-          + "_write_handleB\r"
-          + "\n"
+          + "_write_handleB\r\n"
           + "\013_generation\"S\n"
           + "\023BidiReadObjectError\022<\n"
           + "\021read_range_errors\030\001 \003(\0132!.google.storage.v2.ReadRangeError\"E\n"
@@ -624,16 +625,16 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "\013_appendable\"\225\003\n"
           + "\022WriteObjectRequest\022\023\n"
           + "\tupload_id\030\001 \001(\tH\000\022?\n"
-          + "\021write_object_spec\030\002 \001"
-          + "(\0132\".google.storage.v2.WriteObjectSpecH\000\022\031\n"
+          + "\021write_object_spec\030\002"
+          + " \001(\0132\".google.storage.v2.WriteObjectSpecH\000\022\031\n"
           + "\014write_offset\030\003 \001(\003B\003\340A\002\022>\n"
           + "\020checksummed_data\030\004"
           + " \001(\0132\".google.storage.v2.ChecksummedDataH\001\022A\n"
-          + "\020object_checksums\030\006 \001(\0132\"."
-          + "google.storage.v2.ObjectChecksumsB\003\340A\001\022\031\n"
+          + "\020object_checksums\030\006"
+          + " \001(\0132\".google.storage.v2.ObjectChecksumsB\003\340A\001\022\031\n"
           + "\014finish_write\030\007 \001(\010B\003\340A\001\022W\n"
-          + "\034common_object_request_params\030\010"
-          + " \001(\0132,.google.storage.v2.CommonObjectRequestParamsB\003\340A\001B\017\n\r"
+          + "\034common_object_request_params\030\010 \001("
+          + "\0132,.google.storage.v2.CommonObjectRequestParamsB\003\340A\001B\017\n\r"
           + "first_messageB\006\n"
           + "\004data\"n\n"
           + "\023WriteObjectResponse\022\030\n"
@@ -648,8 +649,8 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "\027if_metageneration_match\030\004 \001(\003H\000\210\001\001\022(\n"
           + "\033if_metageneration_not_match\030\005 \001(\003H\001\210\001\001\022\032\n\r"
           + "routing_token\030\006 \001(\tH\002\210\001\001\022=\n"
-          + "\014write_handle\030\007"
-          + " \001(\0132\".google.storage.v2.BidiWriteHandleH\003\210\001\001B\032\n"
+          + "\014write_handle\030\007 \001("
+          + "\0132\".google.storage.v2.BidiWriteHandleH\003\210\001\001B\032\n"
           + "\030_if_metageneration_matchB\036\n"
           + "\034_if_metageneration_not_matchB\020\n"
           + "\016_routing_tokenB\017\n\r"
@@ -700,8 +701,8 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "_read_mask\"\212\001\n"
           + "\027QueryWriteStatusRequest\022\026\n"
           + "\tupload_id\030\001 \001(\tB\003\340A\002\022W\n"
-          + "\034common_object_request_params\030\002"
-          + " \001(\0132,.google.storage.v2.CommonObjectRequestParamsB\003\340A\001\"s\n"
+          + "\034common_object_request_params\030\002 \001(\0132,.goog"
+          + "le.storage.v2.CommonObjectRequestParamsB\003\340A\001\"s\n"
           + "\030QueryWriteStatusResponse\022\030\n"
           + "\016persisted_size\030\001 \001(\003H\000\022-\n"
           + "\010resource\030\002 \001(\0132\031.google.storage.v2.ObjectH\000B\016\n"
@@ -712,10 +713,10 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "\035storage.googleapis.com/Bucket\022F\n"
           + "\023destination_kms_key\030\033 \001(\tB)\340A\001\372A#\n"
           + "!cloudkms.googleapis.com/CryptoKey\0223\n"
-          + "\013destination\030\001 \001(\0132\031.google.storage.v2.ObjectB\003\340A\001\022<\n"
-          + "\r"
+          + "\013destination\030\001 \001(\0132\031.google.storage.v2.ObjectB\003\340A\001\022<\n\r"
           + "source_bucket\030\002 \001(\tB%\340A\002\372A\037\n"
-          + "\035storage.googleapis.com/Bucket\022\032\n\r"
+          + "\035storage.googleapis.com/Bucket\022\032\n"
+          + "\r"
           + "source_object\030\003 \001(\tB\003\340A\002\022\036\n"
           + "\021source_generation\030\004 \001(\003B\003\340A\001\022\032\n\r"
           + "rewrite_token\030\005 \001(\tB\003\340A\001\022\'\n"
@@ -734,8 +735,8 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + " copy_source_encryption_algorithm\030\020 \001(\tB\003\340A\001\022-\n"
           + " copy_source_encryption_key_bytes\030\025 \001(\014B\003\340A\001\0224\n"
           + "\'copy_source_encryption_key_sha256_bytes\030\026 \001(\014B\003\340A\001\022W\n"
-          + "\034common_object_request_params\030\023 \001(\0132,.google.s"
-          + "torage.v2.CommonObjectRequestParamsB\003\340A\001\022A\n"
+          + "\034common_object_request_params\030\023"
+          + " \001(\0132,.google.storage.v2.CommonObjectRequestParamsB\003\340A\001\022A\n"
           + "\020object_checksums\030\035"
           + " \001(\0132\".google.storage.v2.ObjectChecksumsB\003\340A\001B\026\n"
           + "\024_if_generation_matchB\032\n"
@@ -781,8 +782,8 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "\032StartResumableWriteRequest\022B\n"
           + "\021write_object_spec\030\001"
           + " \001(\0132\".google.storage.v2.WriteObjectSpecB\003\340A\002\022W\n"
-          + "\034common_object_request_params\030\003"
-          + " \001(\0132,.google.storage.v2.CommonObjectRequestParamsB\003\340A\001\022A\n"
+          + "\034common_object_request_params\030\003 \001(\0132,.google."
+          + "storage.v2.CommonObjectRequestParamsB\003\340A\001\022A\n"
           + "\020object_checksums\030\005"
           + " \001(\0132\".google.storage.v2.ObjectChecksumsB\003\340A\001\"0\n"
           + "\033StartResumableWriteResponse\022\021\n"
@@ -834,13 +835,14 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "\007project\030\003 \001(\tB3\340A\005\372A-\n"
           + "+cloudresourcemanager.googleapis.com/Project\022\033\n"
           + "\016metageneration\030\004 \001(\003B\003\340A\003\022\025\n"
-          + "\010location\030\005 \001(\tB\003\340A\005\022\032\n\r"
+          + "\010location\030\005 \001(\tB\003\340A\005\022\032\n"
+          + "\r"
           + "location_type\030\006 \001(\tB\003\340A\003\022\032\n\r"
           + "storage_class\030\007 \001(\tB\003\340A\001\022\020\n"
           + "\003rpo\030\033 \001(\tB\003\340A\001\0228\n"
           + "\003acl\030\010 \003(\0132&.google.storage.v2.BucketAccessControlB\003\340A\001\022G\n"
-          + "\022default_object_acl\030\t"
-          + " \003(\0132&.google.storage.v2.ObjectAccessControlB\003\340A\001\022;\n"
+          + "\022default_object_acl\030\t \003(\0132&."
+          + "google.storage.v2.ObjectAccessControlB\003\340A\001\022;\n"
           + "\tlifecycle\030\n"
           + " \001(\0132#.google.storage.v2.Bucket.LifecycleB\003\340A\001\0224\n"
           + "\013create_time\030\013 \001(\0132\032.google.protobuf.TimestampB\003\340A\003\0221\n"
@@ -848,34 +850,34 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "\013update_time\030\r"
           + " \001(\0132\032.google.protobuf.TimestampB\003\340A\003\022%\n"
           + "\030default_event_based_hold\030\016 \001(\010B\003\340A\001\022:\n"
-          + "\006labels\030\017"
-          + " \003(\0132%.google.storage.v2.Bucket.LabelsEntryB\003\340A\001\0227\n"
-          + "\007website\030\020 \001(\013"
-          + "2!.google.storage.v2.Bucket.WebsiteB\003\340A\001\022=\n\n"
-          + "versioning\030\021"
-          + " \001(\0132$.google.storage.v2.Bucket.VersioningB\003\340A\001\0227\n"
+          + "\006labels\030\017 \003(\0132%."
+          + "google.storage.v2.Bucket.LabelsEntryB\003\340A\001\0227\n"
+          + "\007website\030\020"
+          + " \001(\0132!.google.storage.v2.Bucket.WebsiteB\003\340A\001\022=\n\n"
+          + "versioning\030\021 \001(\0132$"
+          + ".google.storage.v2.Bucket.VersioningB\003\340A\001\0227\n"
           + "\007logging\030\022 \001(\0132!.google.storage.v2.Bucket.LoggingB\003\340A\001\022,\n"
           + "\005owner\030\023 \001(\0132\030.google.storage.v2.OwnerB\003\340A\003\022=\n\n"
           + "encryption\030\024"
           + " \001(\0132$.google.storage.v2.Bucket.EncryptionB\003\340A\001\0227\n"
           + "\007billing\030\025 \001(\0132!.google.storage.v2.Bucket.BillingB\003\340A\001\022H\n"
-          + "\020retention_policy\030\026 \001(\0132).googl"
-          + "e.storage.v2.Bucket.RetentionPolicyB\003\340A\001\022<\n\n"
-          + "iam_config\030\027"
-          + " \001(\0132#.google.storage.v2.Bucket.IamConfigB\003\340A\001\022\032\n\r"
+          + "\020retention_policy\030\026"
+          + " \001(\0132).google.storage.v2.Bucket.RetentionPolicyB\003\340A\001\022<\n\n"
+          + "iam_config\030\027 \001(\0132#"
+          + ".google.storage.v2.Bucket.IamConfigB\003\340A\001\022\032\n\r"
           + "satisfies_pzs\030\031 \001(\010B\003\340A\001\022U\n"
-          + "\027custom_placement_config\030\032 "
-          + "\001(\0132/.google.storage.v2.Bucket.CustomPlacementConfigB\003\340A\001\022;\n"
-          + "\tautoclass\030\034 \001(\0132#.g"
-          + "oogle.storage.v2.Bucket.AutoclassB\003\340A\001\022T\n"
-          + "\026hierarchical_namespace\030  \001(\0132/.google."
-          + "storage.v2.Bucket.HierarchicalNamespaceB\003\340A\001\022K\n"
-          + "\022soft_delete_policy\030\037 \001(\0132*.googl"
-          + "e.storage.v2.Bucket.SoftDeletePolicyB\003\340A\001\022H\n"
+          + "\027custom_placement_config\030\032"
+          + " \001(\0132/.google.storage.v2.Bucket.CustomPlacementConfigB\003\340A\001\022;\n"
+          + "\tautoclass\030\034"
+          + " \001(\0132#.google.storage.v2.Bucket.AutoclassB\003\340A\001\022T\n"
+          + "\026hierarchical_namespace\030 "
+          + " \001(\0132/.google.storage.v2.Bucket.HierarchicalNamespaceB\003\340A\001\022K\n"
+          + "\022soft_delete_policy\030\037"
+          + " \001(\0132*.google.storage.v2.Bucket.SoftDeletePolicyB\003\340A\001\022H\n"
           + "\020object_retention\030!"
           + " \001(\0132).google.storage.v2.Bucket.ObjectRetentionB\003\340A\001\022?\n"
-          + "\tip_filter\030&"
-          + " \001(\0132\".google.storage.v2.Bucket.IpFilterB\003\340A\001H\000\210\001\001\032&\n"
+          + "\tip_filter\030& \001(\0132\".googl"
+          + "e.storage.v2.Bucket.IpFilterB\003\340A\001H\000\210\001\001\032&\n"
           + "\007Billing\022\033\n"
           + "\016requester_pays\030\001 \001(\010B\003\340A\001\032l\n"
           + "\004Cors\022\023\n"
@@ -886,16 +888,14 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "Encryption\022B\n"
           + "\017default_kms_key\030\001 \001(\tB)\340A\001\372A#\n"
           + "!cloudkms.googleapis.com/CryptoKey\022\215\001\n"
-          + ",google_managed_encryption_enforcement_config\030\002 \001(\0132M.google.st"
-          + "orage.v2.Bucket.Encryption.GoogleManaged"
-          + "EncryptionEnforcementConfigB\003\340A\001H\000\210\001\001\022\221\001",
-      "\n"
-          + ".customer_managed_encryption_enforcement_config\030\003"
-          + " \001(\0132O.google.storage.v2.Bucke"
-          + "t.Encryption.CustomerManagedEncryptionEnforcementConfigB\003\340A\001H\001\210\001\001\022\223\001\n"
-          + "/customer_supplied_encryption_enforcement_config\030\004 "
-          + "\001(\0132P.google.storage.v2.Bucket.Encryptio"
-          + "n.CustomerSuppliedEncryptionEnforcementConfigB\003\340A\001H\002\210\001\001\032\252\001\n"
+          + ",google_managed_encryption_enforcement_config\030\002"
+          + " \001(\0132M.google.storage.v2.Bucket.Encryp",
+      "tion.GoogleManagedEncryptionEnforcementConfigB\003\340A\001H\000\210\001\001\022\221\001\n"
+          + ".customer_managed_encryption_enforcement_config\030\003 \001(\0132O.googl"
+          + "e.storage.v2.Bucket.Encryption.CustomerM"
+          + "anagedEncryptionEnforcementConfigB\003\340A\001H\001\210\001\001\022\223\001\n"
+          + "/customer_supplied_encryption_enforcement_config\030\004 \001(\0132P.google.storage.v"
+          + "2.Bucket.Encryption.CustomerSuppliedEncryptionEnforcementConfigB\003\340A\001H\002\210\001\001\032\252\001\n"
           + "(GoogleManagedEncryptionEnforcementConfig\022\035\n"
           + "\020restriction_mode\030\003 \001(\tH\000\210\001\001\0227\n"
           + "\016effective_time\030\002"
@@ -918,21 +918,21 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "/_customer_managed_encryption_enforcement_configB2\n"
           + "0_customer_supplied_encryption_enforcement_config\032\200\002\n"
           + "\tIamConfig\022f\n"
-          + "\033uniform_bucket_level_access\030\001 \001(\0132<.google.storage."
-          + "v2.Bucket.IamConfig.UniformBucketLevelAccessB\003\340A\001\022%\n"
+          + "\033uniform_bucket_level_access\030\001 \001(\013"
+          + "2<.google.storage.v2.Bucket.IamConfig.UniformBucketLevelAccessB\003\340A\001\022%\n"
           + "\030public_access_prevention\030\003 \001(\tB\003\340A\001\032d\n"
           + "\030UniformBucketLevelAccess\022\024\n"
           + "\007enabled\030\001 \001(\010B\003\340A\001\0222\n"
           + "\tlock_time\030\002"
           + " \001(\0132\032.google.protobuf.TimestampB\003\340A\001\032\252\006\n"
           + "\tLifecycle\022;\n"
-          + "\004rule\030\001"
-          + " \003(\0132(.google.storage.v2.Bucket.Lifecycle.RuleB\003\340A\001\032\337\005\n"
+          + "\004rule\030\001 \003(\0132(.g"
+          + "oogle.storage.v2.Bucket.Lifecycle.RuleB\003\340A\001\032\337\005\n"
           + "\004Rule\022D\n"
-          + "\006action\030\001"
-          + " \001(\0132/.google.storage.v2.Bucket.Lifecycle.Rule.ActionB\003\340A\001\022J\n"
-          + "\tcondition\030\002 "
-          + "\001(\01322.google.storage.v2.Bucket.Lifecycle.Rule.ConditionB\003\340A\001\0327\n"
+          + "\006action\030\001 \001(\0132/.google.st"
+          + "orage.v2.Bucket.Lifecycle.Rule.ActionB\003\340A\001\022J\n"
+          + "\tcondition\030\002 \001(\01322.google.storage.v"
+          + "2.Bucket.Lifecycle.Rule.ConditionB\003\340A\001\0327\n"
           + "\006Action\022\021\n"
           + "\004type\030\001 \001(\tB\003\340A\001\022\032\n\r"
           + "storage_class\030\002 \001(\tB\003\340A\001\032\213\004\n"
@@ -989,10 +989,10 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "#_terminal_storage_class_update_time\032\375\003\n"
           + "\010IpFilter\022\021\n"
           + "\004mode\030\001 \001(\tH\000\210\001\001\022Z\n"
-          + "\025public_network_source\030\002 \001(\01326.go"
-          + "ogle.storage.v2.Bucket.IpFilter.PublicNetworkSourceH\001\210\001\001\022U\n"
-          + "\023vpc_network_sources\030\003"
-          + " \003(\01323.google.storage.v2.Bucket.IpFilter.VpcNetworkSourceB\003\340A\001\022!\n"
+          + "\025public_network_source\030\002"
+          + " \001(\01326.google.storage.v2.Bucket.IpFilter.PublicNetworkSourceH\001\210\001\001\022U\n"
+          + "\023vpc_network_sources\030\003 \003(\01323.google.storage"
+          + ".v2.Bucket.IpFilter.VpcNetworkSourceB\003\340A\001\022!\n"
           + "\024allow_cross_org_vpcs\030\004 \001(\010B\003\340A\001\022+\n"
           + "\036allow_all_service_agent_access\030\005 \001(\010H\002\210\001\001\032:\n"
           + "\023PublicNetworkSource\022#\n"
@@ -1009,8 +1009,8 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "\013LabelsEntry\022\013\n"
           + "\003key\030\001 \001(\t\022\r\n"
           + "\005value\030\002 \001(\t:\0028\001:X\352AU\n"
-          + "\035storage.googlea"
-          + "pis.com/Bucket\022#projects/{project}/buckets/{bucket}*\007buckets2\006bucketB\014\n\n"
+          + "\035storage.googleapis.com/Bucket\022#projec"
+          + "ts/{project}/buckets/{bucket}*\007buckets2\006bucketB\014\n\n"
           + "_ip_filter\"\366\001\n"
           + "\023BucketAccessControl\022\021\n"
           + "\004role\030\001 \001(\tB\003\340A\001\022\017\n"
@@ -1037,12 +1037,12 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "\013update_time\030\003"
           + " \001(\0132\032.google.protobuf.TimestampB\003\340A\003\"\262\001\n"
           + "\016ObjectContexts\022B\n"
-          + "\006custom\030\001 \003(\0132-.goo"
-          + "gle.storage.v2.ObjectContexts.CustomEntryB\003\340A\001\032\\\n"
+          + "\006custom\030\001"
+          + " \003(\0132-.google.storage.v2.ObjectContexts.CustomEntryB\003\340A\001\032\\\n"
           + "\013CustomEntry\022\013\n"
           + "\003key\030\001 \001(\t\022<\n"
-          + "\005value\030\002"
-          + " \001(\0132-.google.storage.v2.ObjectCustomContextPayload:\0028\001\"V\n"
+          + "\005value\030\002 \001(\0132-.google.sto"
+          + "rage.v2.ObjectCustomContextPayload:\0028\001\"V\n"
           + "\022CustomerEncryption\022!\n"
           + "\024encryption_algorithm\030\001 \001(\tB\003\340A\001\022\035\n"
           + "\020key_sha256_bytes\030\003 \001(\014B\003\340A\001\"\221\016\n"
@@ -1051,10 +1051,10 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "\006bucket\030\002 \001(\tB%\340A\005\372A\037\n"
           + "\035storage.googleapis.com/Bucket\022\021\n"
           + "\004etag\030\033 \001(\tB\003\340A\001\022\027\n\n"
-          + "generation\030\003 \001(\003B\003\340A\005\022\037\n"
-          + "\r"
+          + "generation\030\003 \001(\003B\003\340A\005\022\037\n\r"
           + "restore_token\030# \001(\tB\003\340A\003H\000\210\001\001\022\033\n"
-          + "\016metageneration\030\004 \001(\003B\003\340A\003\022\032\n\r"
+          + "\016metageneration\030\004 \001(\003B\003\340A\003\022\032\n"
+          + "\r"
           + "storage_class\030\005 \001(\tB\003\340A\001\022\021\n"
           + "\004size\030\006 \001(\003B\003\340A\003\022\035\n"
           + "\020content_encoding\030\007 \001(\tB\003\340A\001\022 \n"
@@ -1081,8 +1081,8 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "\016temporary_hold\030\024 \001(\010B\003\340A\001\022>\n"
           + "\025retention_expire_time\030\025"
           + " \001(\0132\032.google.protobuf.TimestampB\003\340A\001\022>\n"
-          + "\010metadata\030\026"
-          + " \003(\0132\'.google.storage.v2.Object.MetadataEntryB\003\340A\001\0228\n"
+          + "\010metadata\030\026 \003(\013"
+          + "2\'.google.storage.v2.Object.MetadataEntryB\003\340A\001\0228\n"
           + "\010contexts\030& \001(\0132!.google.storage.v2.ObjectContextsB\003\340A\001\022\035\n"
           + "\020event_based_hold\030\027 \001(\010H\001\210\001\001\022,\n"
           + "\005owner\030\030 \001(\0132\030.google.storage.v2.OwnerB\003\340A\003\022G\n"
@@ -1093,8 +1093,8 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + " \001(\0132\032.google.protobuf.TimestampB\003\340A\003H\002\210\001\001\022>\n"
           + "\020hard_delete_time\030\035"
           + " \001(\0132\032.google.protobuf.TimestampB\003\340A\003H\003\210\001\001\022;\n"
-          + "\tretention\030\036 \001(\0132#."
-          + "google.storage.v2.Object.RetentionB\003\340A\001\032\274\001\n"
+          + "\tretention\030\036"
+          + " \001(\0132#.google.storage.v2.Object.RetentionB\003\340A\001\032\274\001\n"
           + "\tRetention\022;\n"
           + "\004mode\030\001"
           + " \001(\0162(.google.storage.v2.Object.Retention.ModeB\003\340A\001\022:\n"
@@ -1105,7 +1105,8 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "\010UNLOCKED\020\001\022\n\n"
           + "\006LOCKED\020\002\032/\n\r"
           + "MetadataEntry\022\013\n"
-          + "\003key\030\001 \001(\t\022\r\n"
+          + "\003key\030\001 \001(\t\022\r"
+          + "\n"
           + "\005value\030\002 \001(\t:\0028\001B\020\n"
           + "\016_restore_tokenB\023\n"
           + "\021_event_based_holdB\023\n"
@@ -1137,96 +1138,98 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "\003end\030\002 \001(\003\022\027\n"
           + "\017complete_length\030\003 \001(\0032\237\037\n"
           + "\007Storage\022r\n"
-          + "\014DeleteBucket\022&.google.storage.v2.Delete"
-          + "BucketRequest\032\026.google.protobuf.Empty\"\"\332A\004name\212\323\344\223\002\025\022\023\n"
+          + "\014DeleteBucket\022&.google"
+          + ".storage.v2.DeleteBucketRequest\032\026.google.protobuf.Empty\"\"\332A\004name\212\323\344\223\002\025\022\023\n"
           + "\004name\022\013{bucket=**}\022o\n"
-          + "\tGetBucket\022#.google.storage.v2.GetBucketRequ"
-          + "est\032\031.google.storage.v2.Bucket\"\"\332A\004name\212\323\344\223\002\025\022\023\n"
+          + "\tGetBucket\022#.google.storag"
+          + "e.v2.GetBucketRequest\032\031.google.storage.v2.Bucket\"\"\332A\004name\212\323\344\223\002\025\022\023\n"
           + "\004name\022\013{bucket=**}\022\253\001\n"
-          + "\014CreateBucket\022&.google.storage.v2.CreateBucketRequ"
-          + "est\032\031.google.storage.v2.Bucket\"X\332A\027parent,bucket,bucket_id\212\323\344\223\0028\022\026\n"
+          + "\014CreateBucket\022&.google.storage.v2.CreateBucketRequest\032\031.google.storage.v"
+          + "2.Bucket\"X\332A\027parent,bucket,bucket_id\212\323\344\223\0028\022\026\n"
           + "\006parent\022\014{project=**}\022\036\n"
           + "\016bucket.project\022\014{project=**}\022\205\001\n"
-          + "\013ListBuckets\022%.google.storage.v2.Lis"
-          + "tBucketsRequest\032&.google.storage.v2.ListBucketsResponse\"\'\332A\006parent\212\323\344\223\002\030\022\026\n"
+          + "\013ListBuckets\022%.google.storage.v2.ListBucketsRequest\032&.goog"
+          + "le.storage.v2.ListBucketsResponse\"\'\332A\006parent\212\323\344\223\002\030\022\026\n"
           + "\006parent\022\014{project=**}\022\223\001\n"
-          + "\031LockBucketRetentionPolicy\0223.google.storage.v2.LockBucketRet"
-          + "entionPolicyRequest\032\031.google.storage.v2.Bucket\"&\332A\006bucket\212\323\344\223\002\027\022\025\n"
+          + "\031LockBucketRetentionPolicy\0223.google.storag"
+          + "e.v2.LockBucketRetentionPolicyRequest\032\031."
+          + "google.storage.v2.Bucket\"&\332A\006bucket\212\323\344\223\002\027\022\025\n"
           + "\006bucket\022\013{bucket=**}\022\243\001\n"
-          + "\014GetIamPolicy\022\".google.iam.v1."
-          + "GetIamPolicyRequest\032\025.google.iam.v1.Policy\"X\332A\010resource\212\323\344\223\002G\022\027\n"
+          + "\014GetIamPolicy\022\".google.iam.v1.GetIamPolicyRequest\032\025."
+          + "google.iam.v1.Policy\"X\332A\010resource\212\323\344\223\002G\022\027\n"
           + "\010resource\022\013{bucket=**}\022,\n"
           + "\010resource\022 {bucket=projects/*/buckets/*}/**\022\252\001\n"
-          + "\014SetIamPolicy\022\".google.i"
-          + "am.v1.SetIamPolicyRequest\032\025.google.iam.v1.Policy\"_\332A\017resource,policy\212\323\344\223\002G\022\027\n"
+          + "\014SetIamPolicy\022\".google.iam.v1.SetIamPolicyRequ"
+          + "est\032\025.google.iam.v1.Policy\"_\332A\017resource,policy\212\323\344\223\002G\022\027\n"
           + "\010resource\022\013{bucket=**}\022,\n"
           + "\010resource\022 {bucket=projects/*/buckets/*}/**\022\226\002\n"
-          + "\022TestIamPermissions\022(.google.iam.v1.TestIamPermissi"
-          + "onsRequest\032).google.iam.v1.TestIamPermis"
-          + "sionsResponse\"\252\001\332A\024resource,permissions\212\323\344\223\002\214\001\022\027\n"
+          + "\022TestIamPermissions\022(.google.iam.v1.TestIamPermissionsRequest\032).google.ia"
+          + "m.v1.TestIamPermissionsResponse\"\252\001\332A\024resource,permissions\212\323\344\223\002\214\001\022\027\n"
           + "\010resource\022\013{bucket=**}\0224\n"
           + "\010resource\022({bucket=projects/*/buckets/*}/objects/**\022;\n"
           + "\010resource\022/{bucket=projects/*/buckets/*}/managedFolders/**\022\212\001\n"
-          + "\014UpdateBucket\022&.google.storage.v2.UpdateBucketRequ"
-          + "est\032\031.google.storage.v2.Bucket\"7\332A\022bucket,update_mask\212\323\344\223\002\034\022\032\n"
+          + "\014UpdateBucket\022&.google.storage.v"
+          + "2.UpdateBucketRequest\032\031.google.storage.v2.Bucket\"7\332A\022bucket,update_mask\212\323\344\223\002\034\022\032\n"
           + "\013bucket.name\022\013{bucket=**}\022~\n\r"
-          + "ComposeObject\022\'.google.storag"
-          + "e.v2.ComposeObjectRequest\032\031.google.storage.v2.Object\")\212\323\344\223\002#\022!\n"
+          + "ComposeObject\022\'.google.storage.v2.ComposeObjectRequ"
+          + "est\032\031.google.storage.v2.Object\")\212\323\344\223\002#\022!\n"
           + "\022destination.bucket\022\013{bucket=**}\022\230\001\n"
-          + "\014DeleteObject\022&.googl"
-          + "e.storage.v2.DeleteObjectRequest\032\026.google.protobuf.Empty\"H\332A\r"
+          + "\014De"
+          + "leteObject\022&.google.storage.v2.DeleteObjectRequest\032\026.google.protobuf.Empty\"H\332A\r"
           + "bucket,object\332A\030bucket,object,generation\212\323\344\223\002\027\022\025\n"
           + "\006bucket\022\013{bucket=**}\022\215\001\n\r"
-          + "RestoreObject\022\'.google.storage.v2.RestoreObjectRequest\032\031.google.s"
-          + "torage.v2.Object\"8\332A\030bucket,object,generation\212\323\344\223\002\027\022\025\n"
+          + "RestoreObject\022\'.google.storage.v2.RestoreObject"
+          + "Request\032\031.google.storage.v2.Object\"8\332A\030bucket,object,generation\212\323\344\223\002\027\022\025\n"
           + "\006bucket\022\013{bucket=**}\022\272\001\n"
-          + "\024CancelResumableWrite\022..google.storage.v2."
-          + "CancelResumableWriteRequest\032/.google.sto"
-          + "rage.v2.CancelResumableWriteResponse\"A\332A\tupload_id\212\323\344\223\002/\022-\n"
+          + "\024CancelResumableWrite\022..google.storage.v2.CancelResumableWriteRe"
+          + "quest\032/.google.storage.v2.CancelResumableWriteResponse\"A\332A"
+          + "\tupload_id\212\323\344\223\002/\022-\n"
           + "\tupload_id\022 {bucket=projects/*/buckets/*}/**\022\225\001\n"
-          + "\tGetObject\022#."
-          + "google.storage.v2.GetObjectRequest\032\031.google.storage.v2.Object\"H\332A\r"
+          + "\tGetObject\022#.google.storage.v2.GetO"
+          + "bjectRequest\032\031.google.storage.v2.Object\"H\332A\r"
           + "bucket,object\332A\030bucket,object,generation\212\323\344\223\002\027\022\025\n"
           + "\006bucket\022\013{bucket=**}\022\245\001\n\n"
-          + "ReadObject\022$.google."
-          + "storage.v2.ReadObjectRequest\032%.google.storage.v2.ReadObjectResponse\"H\332A\r"
+          + "ReadObject\022$.google.storage.v2.ReadObjectR"
+          + "equest\032%.google.storage.v2.ReadObjectResponse\"H\332A\r"
           + "bucket,object\332A\030bucket,object,generation\212\323\344\223\002\027\022\025\n"
           + "\006bucket\022\013{bucket=**}0\001\022\231\001\n"
-          + "\016BidiReadObject\022(.google.storage.v2.BidiReadObjectReq"
-          + "uest\032).google.storage.v2.BidiReadObjectResponse\".\212\323\344\223\002(\022&\n"
+          + "\016BidiReadObject\022(.google.storage.v2"
+          + ".BidiReadObjectRequest\032).google.storage.v2.BidiReadObjectResponse\".\212\323\344\223\002(\022&\n"
           + "\027read_object_spec.bucket\022\013{bucket=**}(\0010\001\022\214\001\n"
-          + "\014UpdateObject\022&.google.storage.v2.UpdateObjectRequest\032\031.g"
-          + "oogle.storage.v2.Object\"9\332A\022object,update_mask\212\323\344\223\002\036\022\034\n\r"
+          + "\014UpdateObject\022&.google.storage.v2.Updat"
+          + "eObjectRequest\032\031.google.storage.v2.Object\"9\332A\022object,update_mask\212\323\344\223\002\036\022\034\n\r"
           + "object.bucket\022\013{bucket=**}\022`\n"
-          + "\013WriteObject\022%.google.storage.v2.Wr"
-          + "iteObjectRequest\032&.google.storage.v2.WriteObjectResponse\"\000(\001\022n\n"
-          + "\017BidiWriteObject\022).google.storage.v2.BidiWriteObjectReque"
-          + "st\032*.google.storage.v2.BidiWriteObjectResponse\"\000(\0010\001\022\204\001\n"
-          + "\013ListObjects\022%.google.storage.v2.ListObjectsRequest\032&.google.sto"
-          + "rage.v2.ListObjectsResponse\"&\332A\006parent\212\323\344\223\002\027\022\025\n"
+          + "\013WriteObject\022%.google.storage.v2.WriteObjectRequest\032&.goo"
+          + "gle.storage.v2.WriteObjectResponse\"\000(\001\022n\n"
+          + "\017BidiWriteObject\022).google.storage.v2.Bi"
+          + "diWriteObjectRequest\032*.google.storage.v2.BidiWriteObjectResponse\"\000(\0010\001\022\204\001\n"
+          + "\013ListObjects\022%.google.storage.v2.ListObjectsRe"
+          + "quest\032&.google.storage.v2.ListObjectsResponse\"&\332A\006parent\212\323\344\223\002\027\022\025\n"
           + "\006parent\022\013{bucket=**}\022\230\001\n\r"
-          + "RewriteObject\022\'.google.storage.v2.RewriteObjectR"
-          + "equest\032\".google.storage.v2.RewriteResponse\":\212\323\344\223\0024\022\017\n\r"
+          + "RewriteObject\022\'.google.storage"
+          + ".v2.RewriteObjectRequest\032\".google.storage.v2.RewriteResponse\":\212\323\344\223\0024\022\017\n\r"
           + "source_bucket\022!\n"
           + "\022destination_bucket\022\013{bucket=**}\022\256\001\n"
-          + "\023StartResumableWrite\022-.google.storage.v2.StartResumabl"
-          + "eWriteRequest\032..google.storage.v2.StartResumableWriteResponse\"8\212\323\344\223\0022\0220\n"
+          + "\023StartResumableWrite\022-.google.storage.v2.StartResumableWriteRequest\032..google"
+          + ".storage.v2.StartResumableWriteResponse\"8\212\323\344\223\0022\0220\n"
           + "!write_object_spec.resource.bucket\022\013{bucket=**}\022\256\001\n"
-          + "\020QueryWriteStatus\022*.google.storage.v2"
-          + ".QueryWriteStatusRequest\032+.google.storage.v2.QueryWriteStatusResponse\"A\332A"
+          + "\020QueryWriteStatus\022*.google.storage.v2.QueryWriteStatusReque"
+          + "st\032+.google.storage.v2.QueryWriteStatusResponse\"A\332A"
           + "\tupload_id\212\323\344\223\002/\022-\n"
           + "\tupload_id\022 {bucket=projects/*/buckets/*}/**\022\226\001\n\n"
-          + "MoveObject\022$.google.storage.v2.MoveObjectRequest\032\031.google.s"
-          + "torage.v2.Object\"G\332A\'bucket,source_object,destination_object\212\323\344\223\002\027\022\025\n"
-          + "\006bucket\022\013{bucket=**}\032\247\002\312A\026storage.googleapis.com\322A\212"
-          + "\002https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/"
-          + "cloud-platform.read-only,https://www.googleapis.com/auth/devstorage.full_control"
-          + ",https://www.googleapis.com/auth/devstor"
-          + "age.read_only,https://www.googleapis.com/auth/devstorage.read_writeB\342\001\n"
-          + "\025com.google.storage.v2B\014StorageProtoP\001Z>cloud.goo"
-          + "gle.com/go/storage/internal/apiv2/storagepb;storagepb\352Ax\n"
-          + "!cloudkms.googleapis.com/CryptoKey\022Sprojects/{project}/location"
-          + "s/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}b\006proto3"
+          + "MoveObject\022$.google.storage.v2.MoveObject"
+          + "Request\032\031.google.storage.v2.Object\"G\332A\'b"
+          + "ucket,source_object,destination_object\212\323\344\223\002\027\022\025\n"
+          + "\006bucket\022\013{bucket=**}\032\247\002\312A\026storage"
+          + ".googleapis.com\322A\212\002https://www.googleapi"
+          + "s.com/auth/cloud-platform,https://www.googleapis.com/auth/cloud-platform.read-on"
+          + "ly,https://www.googleapis.com/auth/devstorage.full_control,https://www.googleapi"
+          + "s.com/auth/devstorage.read_only,https://"
+          + "www.googleapis.com/auth/devstorage.read_writeB\342\001\n"
+          + "\025com.google.storage.v2B\014Storage"
+          + "ProtoP\001Z>cloud.google.com/go/storage/internal/apiv2/storagepb;storagepb\352Ax\n"
+          + "!cloudkms.googleapis.com/CryptoKey\022Sprojects/"
+          + "{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}b\006proto3"
     };
     descriptor =
         com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom(
@@ -1280,7 +1283,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
         new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
             internal_static_google_storage_v2_ListBucketsRequest_descriptor,
             new java.lang.String[] {
-              "Parent", "PageSize", "PageToken", "Prefix", "ReadMask",
+              "Parent", "PageSize", "PageToken", "Prefix", "ReadMask", "ReturnPartialSuccess",
             });
     internal_static_google_storage_v2_ListBucketsResponse_descriptor =
         getDescriptor().getMessageTypes().get(4);
@@ -1288,7 +1291,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
         new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
             internal_static_google_storage_v2_ListBucketsResponse_descriptor,
             new java.lang.String[] {
-              "Buckets", "NextPageToken",
+              "Buckets", "NextPageToken", "Unreachable",
             });
     internal_static_google_storage_v2_LockBucketRetentionPolicyRequest_descriptor =
         getDescriptor().getMessageTypes().get(5);
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/UpdateBucketRequest.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/UpdateBucketRequest.java
index fa91ddf16a..178cae0c44 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/UpdateBucketRequest.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/UpdateBucketRequest.java
@@ -23,7 +23,7 @@
  *
  *
  * 
                                            - * Request for UpdateBucket method.
+ * Request for [UpdateBucket][google.storage.v2.Storage.UpdateBucket] method.
  * 
                                            
  *
  * Protobuf type {@code google.storage.v2.UpdateBucketRequest}
@@ -74,7 +74,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    * 
                                                * Required. The bucket to update.
-   * The bucket's `name` field will be used to identify the bucket.
+   * The bucket's `name` field is used to identify the bucket.
    * 
                                            
    *
    * .google.storage.v2.Bucket bucket = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -91,7 +91,7 @@ public boolean hasBucket() {
    *
    * 
                                                * Required. The bucket to update.
-   * The bucket's `name` field will be used to identify the bucket.
+   * The bucket's `name` field is used to identify the bucket.
    * 
                                            
    *
    * .google.storage.v2.Bucket bucket = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -108,7 +108,7 @@ public com.google.storage.v2.Bucket getBucket() {
    *
    * 
                                                * Required. The bucket to update.
-   * The bucket's `name` field will be used to identify the bucket.
+   * The bucket's `name` field is used to identify the bucket.
    * 
                                            
    *
    * .google.storage.v2.Bucket bucket = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -125,7 +125,7 @@ public com.google.storage.v2.BucketOrBuilder getBucketOrBuilder() {
    *
    *
    * 
                                            -   * If set, will only modify the bucket if its metageneration matches this
+   * If set, the request modifies the bucket if its metageneration matches this
    * value.
    * 
                                            
    *
@@ -142,7 +142,7 @@ public boolean hasIfMetagenerationMatch() {
    *
    *
    * 
                                            -   * If set, will only modify the bucket if its metageneration matches this
+   * If set, the request modifies the bucket if its metageneration matches this
    * value.
    * 
                                            
    *
@@ -162,8 +162,8 @@ public long getIfMetagenerationMatch() {
    *
    *
    * 
                                            -   * If set, will only modify the bucket if its metageneration does not match
-   * this value.
+   * If set, the request modifies the bucket if its metageneration doesn't
+   * match this value.
    * 
                                            
    *
    * optional int64 if_metageneration_not_match = 3;
@@ -179,8 +179,8 @@ public boolean hasIfMetagenerationNotMatch() {
    *
    *
    * 
                                            -   * If set, will only modify the bucket if its metageneration does not match
-   * this value.
+   * If set, the request modifies the bucket if its metageneration doesn't
+   * match this value.
    * 
                                            
    *
    * optional int64 if_metageneration_not_match = 3;
@@ -202,8 +202,8 @@ public long getIfMetagenerationNotMatch() {
    *
    * 
                                                * Optional. Apply a predefined set of access controls to this bucket.
-   * Valid values are "authenticatedRead", "private", "projectPrivate",
-   * "publicRead", or "publicReadWrite".
+   * Valid values are `authenticatedRead`, `private`, `projectPrivate`,
+   * `publicRead`, or `publicReadWrite`.
    * 
                                            
    *
    * string predefined_acl = 8 [(.google.api.field_behavior) = OPTIONAL];
@@ -228,8 +228,8 @@ public java.lang.String getPredefinedAcl() {
    *
    * 
                                                * Optional. Apply a predefined set of access controls to this bucket.
-   * Valid values are "authenticatedRead", "private", "projectPrivate",
-   * "publicRead", or "publicReadWrite".
+   * Valid values are `authenticatedRead`, `private`, `projectPrivate`,
+   * `publicRead`, or `publicReadWrite`.
    * 
                                            
    *
    * string predefined_acl = 8 [(.google.api.field_behavior) = OPTIONAL];
@@ -259,8 +259,8 @@ public com.google.protobuf.ByteString getPredefinedAclBytes() {
    *
    * 
                                                * Optional. Apply a predefined set of default object access controls to this
-   * bucket. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-   * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+   * bucket. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+   * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
    * 
                                            
    *
    * string predefined_default_object_acl = 9 [(.google.api.field_behavior) = OPTIONAL];
@@ -286,8 +286,8 @@ public java.lang.String getPredefinedDefaultObjectAcl() {
    *
    * 
                                                * Optional. Apply a predefined set of default object access controls to this
-   * bucket. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-   * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+   * bucket. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+   * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
    * 
                                            
    *
    * string predefined_default_object_acl = 9 [(.google.api.field_behavior) = OPTIONAL];
@@ -320,7 +320,7 @@ public com.google.protobuf.ByteString getPredefinedDefaultObjectAclBytes() {
    * To specify ALL fields, equivalent to the JSON API's "update" function,
    * specify a single field with the value `*`. Note: not recommended. If a new
    * field is introduced at a later time, an older client updating with the `*`
-   * may accidentally reset the new field's value.
+   * might accidentally reset the new field's value.
    *
    * Not specifying any fields is an error.
    * 
                                            
@@ -344,7 +344,7 @@ public boolean hasUpdateMask() {
    * To specify ALL fields, equivalent to the JSON API's "update" function,
    * specify a single field with the value `*`. Note: not recommended. If a new
    * field is introduced at a later time, an older client updating with the `*`
-   * may accidentally reset the new field's value.
+   * might accidentally reset the new field's value.
    *
    * Not specifying any fields is an error.
    * 
                                            
@@ -368,7 +368,7 @@ public com.google.protobuf.FieldMask getUpdateMask() {
    * To specify ALL fields, equivalent to the JSON API's "update" function,
    * specify a single field with the value `*`. Note: not recommended. If a new
    * field is introduced at a later time, an older client updating with the `*`
-   * may accidentally reset the new field's value.
+   * might accidentally reset the new field's value.
    *
    * Not specifying any fields is an error.
    * 
                                            
@@ -612,7 +612,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
                                            -   * Request for UpdateBucket method.
+   * Request for [UpdateBucket][google.storage.v2.Storage.UpdateBucket] method.
    * 
                                            
    *
    * Protobuf type {@code google.storage.v2.UpdateBucketRequest}
@@ -893,7 +893,7 @@ public Builder mergeFrom(
      *
      * 
                                                  * Required. The bucket to update.
-     * The bucket's `name` field will be used to identify the bucket.
+     * The bucket's `name` field is used to identify the bucket.
      * 
                                            
      *
      * .google.storage.v2.Bucket bucket = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -909,7 +909,7 @@ public boolean hasBucket() {
      *
      * 
                                                  * Required. The bucket to update.
-     * The bucket's `name` field will be used to identify the bucket.
+     * The bucket's `name` field is used to identify the bucket.
      * 
                                            
      *
      * .google.storage.v2.Bucket bucket = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -929,7 +929,7 @@ public com.google.storage.v2.Bucket getBucket() {
      *
      * 
                                                  * Required. The bucket to update.
-     * The bucket's `name` field will be used to identify the bucket.
+     * The bucket's `name` field is used to identify the bucket.
      * 
                                            
      *
      * .google.storage.v2.Bucket bucket = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -953,7 +953,7 @@ public Builder setBucket(com.google.storage.v2.Bucket value) {
      *
      * 
                                                  * Required. The bucket to update.
-     * The bucket's `name` field will be used to identify the bucket.
+     * The bucket's `name` field is used to identify the bucket.
      * 
                                            
      *
      * .google.storage.v2.Bucket bucket = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -974,7 +974,7 @@ public Builder setBucket(com.google.storage.v2.Bucket.Builder builderForValue) {
      *
      * 
                                                  * Required. The bucket to update.
-     * The bucket's `name` field will be used to identify the bucket.
+     * The bucket's `name` field is used to identify the bucket.
      * 
                                            
      *
      * .google.storage.v2.Bucket bucket = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -1003,7 +1003,7 @@ public Builder mergeBucket(com.google.storage.v2.Bucket value) {
      *
      * 
                                                  * Required. The bucket to update.
-     * The bucket's `name` field will be used to identify the bucket.
+     * The bucket's `name` field is used to identify the bucket.
      * 
                                            
      *
      * .google.storage.v2.Bucket bucket = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -1024,7 +1024,7 @@ public Builder clearBucket() {
      *
      * 
                                                  * Required. The bucket to update.
-     * The bucket's `name` field will be used to identify the bucket.
+     * The bucket's `name` field is used to identify the bucket.
      * 
                                            
      *
      * .google.storage.v2.Bucket bucket = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -1040,7 +1040,7 @@ public com.google.storage.v2.Bucket.Builder getBucketBuilder() {
      *
      * 
                                                  * Required. The bucket to update.
-     * The bucket's `name` field will be used to identify the bucket.
+     * The bucket's `name` field is used to identify the bucket.
      * 
                                            
      *
      * .google.storage.v2.Bucket bucket = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -1058,7 +1058,7 @@ public com.google.storage.v2.BucketOrBuilder getBucketOrBuilder() {
      *
      * 
                                                  * Required. The bucket to update.
-     * The bucket's `name` field will be used to identify the bucket.
+     * The bucket's `name` field is used to identify the bucket.
      * 
                                            
      *
      * .google.storage.v2.Bucket bucket = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -1086,7 +1086,7 @@ public com.google.storage.v2.BucketOrBuilder getBucketOrBuilder() {
      *
      *
      * 
                                            -     * If set, will only modify the bucket if its metageneration matches this
+     * If set, the request modifies the bucket if its metageneration matches this
      * value.
      * 
                                            
      *
@@ -1103,7 +1103,7 @@ public boolean hasIfMetagenerationMatch() {
      *
      *
      * 
                                            -     * If set, will only modify the bucket if its metageneration matches this
+     * If set, the request modifies the bucket if its metageneration matches this
      * value.
      * 
                                            
      *
@@ -1120,7 +1120,7 @@ public long getIfMetagenerationMatch() {
      *
      *
      * 
                                            -     * If set, will only modify the bucket if its metageneration matches this
+     * If set, the request modifies the bucket if its metageneration matches this
      * value.
      * 
                                            
      *
@@ -1141,7 +1141,7 @@ public Builder setIfMetagenerationMatch(long value) {
      *
      *
      * 
                                            -     * If set, will only modify the bucket if its metageneration matches this
+     * If set, the request modifies the bucket if its metageneration matches this
      * value.
      * 
                                            
      *
@@ -1162,8 +1162,8 @@ public Builder clearIfMetagenerationMatch() {
      *
      *
      * 
                                            -     * If set, will only modify the bucket if its metageneration does not match
-     * this value.
+     * If set, the request modifies the bucket if its metageneration doesn't
+     * match this value.
      * 
                                            
      *
      * optional int64 if_metageneration_not_match = 3;
@@ -1179,8 +1179,8 @@ public boolean hasIfMetagenerationNotMatch() {
      *
      *
      * 
                                            -     * If set, will only modify the bucket if its metageneration does not match
-     * this value.
+     * If set, the request modifies the bucket if its metageneration doesn't
+     * match this value.
      * 
                                            
      *
      * optional int64 if_metageneration_not_match = 3;
@@ -1196,8 +1196,8 @@ public long getIfMetagenerationNotMatch() {
      *
      *
      * 
                                            -     * If set, will only modify the bucket if its metageneration does not match
-     * this value.
+     * If set, the request modifies the bucket if its metageneration doesn't
+     * match this value.
      * 
                                            
      *
      * optional int64 if_metageneration_not_match = 3;
@@ -1217,8 +1217,8 @@ public Builder setIfMetagenerationNotMatch(long value) {
      *
      *
      * 
                                            -     * If set, will only modify the bucket if its metageneration does not match
-     * this value.
+     * If set, the request modifies the bucket if its metageneration doesn't
+     * match this value.
      * 
                                            
      *
      * optional int64 if_metageneration_not_match = 3;
@@ -1239,8 +1239,8 @@ public Builder clearIfMetagenerationNotMatch() {
      *
      * 
                                                  * Optional. Apply a predefined set of access controls to this bucket.
-     * Valid values are "authenticatedRead", "private", "projectPrivate",
-     * "publicRead", or "publicReadWrite".
+     * Valid values are `authenticatedRead`, `private`, `projectPrivate`,
+     * `publicRead`, or `publicReadWrite`.
      * 
                                            
      *
      * string predefined_acl = 8 [(.google.api.field_behavior) = OPTIONAL];
@@ -1264,8 +1264,8 @@ public java.lang.String getPredefinedAcl() {
      *
      * 
                                                  * Optional. Apply a predefined set of access controls to this bucket.
-     * Valid values are "authenticatedRead", "private", "projectPrivate",
-     * "publicRead", or "publicReadWrite".
+     * Valid values are `authenticatedRead`, `private`, `projectPrivate`,
+     * `publicRead`, or `publicReadWrite`.
      * 
                                            
      *
      * string predefined_acl = 8 [(.google.api.field_behavior) = OPTIONAL];
@@ -1289,8 +1289,8 @@ public com.google.protobuf.ByteString getPredefinedAclBytes() {
      *
      * 
                                                  * Optional. Apply a predefined set of access controls to this bucket.
-     * Valid values are "authenticatedRead", "private", "projectPrivate",
-     * "publicRead", or "publicReadWrite".
+     * Valid values are `authenticatedRead`, `private`, `projectPrivate`,
+     * `publicRead`, or `publicReadWrite`.
      * 
                                            
      *
      * string predefined_acl = 8 [(.google.api.field_behavior) = OPTIONAL];
@@ -1313,8 +1313,8 @@ public Builder setPredefinedAcl(java.lang.String value) {
      *
      * 
                                                  * Optional. Apply a predefined set of access controls to this bucket.
-     * Valid values are "authenticatedRead", "private", "projectPrivate",
-     * "publicRead", or "publicReadWrite".
+     * Valid values are `authenticatedRead`, `private`, `projectPrivate`,
+     * `publicRead`, or `publicReadWrite`.
      * 
                                            
      *
      * string predefined_acl = 8 [(.google.api.field_behavior) = OPTIONAL];
@@ -1333,8 +1333,8 @@ public Builder clearPredefinedAcl() {
      *
      * 
                                                  * Optional. Apply a predefined set of access controls to this bucket.
-     * Valid values are "authenticatedRead", "private", "projectPrivate",
-     * "publicRead", or "publicReadWrite".
+     * Valid values are `authenticatedRead`, `private`, `projectPrivate`,
+     * `publicRead`, or `publicReadWrite`.
      * 
                                            
      *
      * string predefined_acl = 8 [(.google.api.field_behavior) = OPTIONAL];
@@ -1360,8 +1360,8 @@ public Builder setPredefinedAclBytes(com.google.protobuf.ByteString value) {
      *
      * 
                                                  * Optional. Apply a predefined set of default object access controls to this
-     * bucket. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-     * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+     * bucket. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+     * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
      * 
                                            
      *
      * string predefined_default_object_acl = 9 [(.google.api.field_behavior) = OPTIONAL];
@@ -1386,8 +1386,8 @@ public java.lang.String getPredefinedDefaultObjectAcl() {
      *
      * 
                                                  * Optional. Apply a predefined set of default object access controls to this
-     * bucket. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-     * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+     * bucket. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+     * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
      * 
                                            
      *
      * string predefined_default_object_acl = 9 [(.google.api.field_behavior) = OPTIONAL];
@@ -1412,8 +1412,8 @@ public com.google.protobuf.ByteString getPredefinedDefaultObjectAclBytes() {
      *
      * 
                                                  * Optional. Apply a predefined set of default object access controls to this
-     * bucket. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-     * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+     * bucket. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+     * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
      * 
                                            
      *
      * string predefined_default_object_acl = 9 [(.google.api.field_behavior) = OPTIONAL];
@@ -1437,8 +1437,8 @@ public Builder setPredefinedDefaultObjectAcl(java.lang.String value) {
      *
      * 
                                                  * Optional. Apply a predefined set of default object access controls to this
-     * bucket. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-     * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+     * bucket. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+     * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
      * 
                                            
      *
      * string predefined_default_object_acl = 9 [(.google.api.field_behavior) = OPTIONAL];
@@ -1458,8 +1458,8 @@ public Builder clearPredefinedDefaultObjectAcl() {
      *
      * 
                                                  * Optional. Apply a predefined set of default object access controls to this
-     * bucket. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-     * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+     * bucket. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+     * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
      * 
                                            
      *
      * string predefined_default_object_acl = 9 [(.google.api.field_behavior) = OPTIONAL];
@@ -1495,7 +1495,7 @@ public Builder setPredefinedDefaultObjectAclBytes(com.google.protobuf.ByteString
      * To specify ALL fields, equivalent to the JSON API's "update" function,
      * specify a single field with the value `*`. Note: not recommended. If a new
      * field is introduced at a later time, an older client updating with the `*`
-     * may accidentally reset the new field's value.
+     * might accidentally reset the new field's value.
      *
      * Not specifying any fields is an error.
      * 
                                            
@@ -1518,7 +1518,7 @@ public boolean hasUpdateMask() {
      * To specify ALL fields, equivalent to the JSON API's "update" function,
      * specify a single field with the value `*`. Note: not recommended. If a new
      * field is introduced at a later time, an older client updating with the `*`
-     * may accidentally reset the new field's value.
+     * might accidentally reset the new field's value.
      *
      * Not specifying any fields is an error.
      * 
                                            
@@ -1547,7 +1547,7 @@ public com.google.protobuf.FieldMask getUpdateMask() {
      * To specify ALL fields, equivalent to the JSON API's "update" function,
      * specify a single field with the value `*`. Note: not recommended. If a new
      * field is introduced at a later time, an older client updating with the `*`
-     * may accidentally reset the new field's value.
+     * might accidentally reset the new field's value.
      *
      * Not specifying any fields is an error.
      * 
                                            
@@ -1578,7 +1578,7 @@ public Builder setUpdateMask(com.google.protobuf.FieldMask value) {
      * To specify ALL fields, equivalent to the JSON API's "update" function,
      * specify a single field with the value `*`. Note: not recommended. If a new
      * field is introduced at a later time, an older client updating with the `*`
-     * may accidentally reset the new field's value.
+     * might accidentally reset the new field's value.
      *
      * Not specifying any fields is an error.
      * 
                                            
@@ -1606,7 +1606,7 @@ public Builder setUpdateMask(com.google.protobuf.FieldMask.Builder builderForVal
      * To specify ALL fields, equivalent to the JSON API's "update" function,
      * specify a single field with the value `*`. Note: not recommended. If a new
      * field is introduced at a later time, an older client updating with the `*`
-     * may accidentally reset the new field's value.
+     * might accidentally reset the new field's value.
      *
      * Not specifying any fields is an error.
      * 
                                            
@@ -1642,7 +1642,7 @@ public Builder mergeUpdateMask(com.google.protobuf.FieldMask value) {
      * To specify ALL fields, equivalent to the JSON API's "update" function,
      * specify a single field with the value `*`. Note: not recommended. If a new
      * field is introduced at a later time, an older client updating with the `*`
-     * may accidentally reset the new field's value.
+     * might accidentally reset the new field's value.
      *
      * Not specifying any fields is an error.
      * 
                                            
@@ -1670,7 +1670,7 @@ public Builder clearUpdateMask() {
      * To specify ALL fields, equivalent to the JSON API's "update" function,
      * specify a single field with the value `*`. Note: not recommended. If a new
      * field is introduced at a later time, an older client updating with the `*`
-     * may accidentally reset the new field's value.
+     * might accidentally reset the new field's value.
      *
      * Not specifying any fields is an error.
      * 
                                            
@@ -1693,7 +1693,7 @@ public com.google.protobuf.FieldMask.Builder getUpdateMaskBuilder() {
      * To specify ALL fields, equivalent to the JSON API's "update" function,
      * specify a single field with the value `*`. Note: not recommended. If a new
      * field is introduced at a later time, an older client updating with the `*`
-     * may accidentally reset the new field's value.
+     * might accidentally reset the new field's value.
      *
      * Not specifying any fields is an error.
      * 
                                            
@@ -1720,7 +1720,7 @@ public com.google.protobuf.FieldMaskOrBuilder getUpdateMaskOrBuilder() {
      * To specify ALL fields, equivalent to the JSON API's "update" function,
      * specify a single field with the value `*`. Note: not recommended. If a new
      * field is introduced at a later time, an older client updating with the `*`
-     * may accidentally reset the new field's value.
+     * might accidentally reset the new field's value.
      *
      * Not specifying any fields is an error.
      *
                                            diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/UpdateBucketRequestOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/UpdateBucketRequestOrBuilder.java index 602130478b..93fd23008f 100644 --- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/UpdateBucketRequestOrBuilder.java +++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/UpdateBucketRequestOrBuilder.java @@ -29,7 +29,7 @@ public interface UpdateBucketRequestOrBuilder * * 
                                                * Required. The bucket to update.
-   * The bucket's `name` field will be used to identify the bucket.
+   * The bucket's `name` field is used to identify the bucket.
    *
                                            * * .google.storage.v2.Bucket bucket = 1 [(.google.api.field_behavior) = REQUIRED]; @@ -43,7 +43,7 @@ public interface UpdateBucketRequestOrBuilder * * 
                                                * Required. The bucket to update.
-   * The bucket's `name` field will be used to identify the bucket.
+   * The bucket's `name` field is used to identify the bucket.
    *
                                            * * .google.storage.v2.Bucket bucket = 1 [(.google.api.field_behavior) = REQUIRED]; @@ -57,7 +57,7 @@ public interface UpdateBucketRequestOrBuilder * * 
                                                * Required. The bucket to update.
-   * The bucket's `name` field will be used to identify the bucket.
+   * The bucket's `name` field is used to identify the bucket.
    *
                                            * * .google.storage.v2.Bucket bucket = 1 [(.google.api.field_behavior) = REQUIRED]; @@ -68,7 +68,7 @@ public interface UpdateBucketRequestOrBuilder * * * 
                                            -   * If set, will only modify the bucket if its metageneration matches this
+   * If set, the request modifies the bucket if its metageneration matches this
    * value.
    *
                                            * @@ -82,7 +82,7 @@ public interface UpdateBucketRequestOrBuilder * * * 
                                            -   * If set, will only modify the bucket if its metageneration matches this
+   * If set, the request modifies the bucket if its metageneration matches this
    * value.
    *
                                            * @@ -96,8 +96,8 @@ public interface UpdateBucketRequestOrBuilder * * * 
                                            -   * If set, will only modify the bucket if its metageneration does not match
-   * this value.
+   * If set, the request modifies the bucket if its metageneration doesn't
+   * match this value.
    *
                                            * * optional int64 if_metageneration_not_match = 3; @@ -110,8 +110,8 @@ public interface UpdateBucketRequestOrBuilder * * * 
                                            -   * If set, will only modify the bucket if its metageneration does not match
-   * this value.
+   * If set, the request modifies the bucket if its metageneration doesn't
+   * match this value.
    *
                                            * * optional int64 if_metageneration_not_match = 3; @@ -125,8 +125,8 @@ public interface UpdateBucketRequestOrBuilder * * 
                                                * Optional. Apply a predefined set of access controls to this bucket.
-   * Valid values are "authenticatedRead", "private", "projectPrivate",
-   * "publicRead", or "publicReadWrite".
+   * Valid values are `authenticatedRead`, `private`, `projectPrivate`,
+   * `publicRead`, or `publicReadWrite`.
    *
                                            * * string predefined_acl = 8 [(.google.api.field_behavior) = OPTIONAL]; @@ -140,8 +140,8 @@ public interface UpdateBucketRequestOrBuilder * * 
                                                * Optional. Apply a predefined set of access controls to this bucket.
-   * Valid values are "authenticatedRead", "private", "projectPrivate",
-   * "publicRead", or "publicReadWrite".
+   * Valid values are `authenticatedRead`, `private`, `projectPrivate`,
+   * `publicRead`, or `publicReadWrite`.
    *
                                            * * string predefined_acl = 8 [(.google.api.field_behavior) = OPTIONAL]; @@ -155,8 +155,8 @@ public interface UpdateBucketRequestOrBuilder * * 
                                                * Optional. Apply a predefined set of default object access controls to this
-   * bucket. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-   * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+   * bucket. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+   * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
    *
                                            * * string predefined_default_object_acl = 9 [(.google.api.field_behavior) = OPTIONAL]; @@ -171,8 +171,8 @@ public interface UpdateBucketRequestOrBuilder * * 
                                                * Optional. Apply a predefined set of default object access controls to this
-   * bucket. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-   * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+   * bucket. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+   * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
    *
                                            * * string predefined_default_object_acl = 9 [(.google.api.field_behavior) = OPTIONAL]; @@ -191,7 +191,7 @@ public interface UpdateBucketRequestOrBuilder * To specify ALL fields, equivalent to the JSON API's "update" function, * specify a single field with the value `*`. Note: not recommended. If a new * field is introduced at a later time, an older client updating with the `*` - * may accidentally reset the new field's value. + * might accidentally reset the new field's value. * * Not specifying any fields is an error. * @@ -212,7 +212,7 @@ public interface UpdateBucketRequestOrBuilder * To specify ALL fields, equivalent to the JSON API's "update" function, * specify a single field with the value `*`. Note: not recommended. If a new * field is introduced at a later time, an older client updating with the `*` - * may accidentally reset the new field's value. + * might accidentally reset the new field's value. * * Not specifying any fields is an error. * @@ -233,7 +233,7 @@ public interface UpdateBucketRequestOrBuilder * To specify ALL fields, equivalent to the JSON API's "update" function, * specify a single field with the value `*`. Note: not recommended. If a new * field is introduced at a later time, an older client updating with the `*` - * may accidentally reset the new field's value. + * might accidentally reset the new field's value. * * Not specifying any fields is an error. * diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/UpdateObjectRequest.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/UpdateObjectRequest.java index 1f53e8690c..4d13e6ade9 100644 --- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/UpdateObjectRequest.java +++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/UpdateObjectRequest.java @@ -23,7 +23,7 @@ * * * 
                                            - * Request message for UpdateObject.
+ * Request message for [UpdateObject][google.storage.v2.Storage.UpdateObject].
  *
                                            * * Protobuf type {@code google.storage.v2.UpdateObjectRequest} @@ -349,7 +349,7 @@ public com.google.protobuf.ByteString getPredefinedAclBytes() { * To specify ALL fields, equivalent to the JSON API's "update" function, * specify a single field with the value `*`. Note: not recommended. If a new * field is introduced at a later time, an older client updating with the `*` - * may accidentally reset the new field's value. + * might accidentally reset the new field's value. * * Not specifying any fields is an error. * @@ -373,7 +373,7 @@ public boolean hasUpdateMask() { * To specify ALL fields, equivalent to the JSON API's "update" function, * specify a single field with the value `*`. Note: not recommended. If a new * field is introduced at a later time, an older client updating with the `*` - * may accidentally reset the new field's value. + * might accidentally reset the new field's value. * * Not specifying any fields is an error. * @@ -397,7 +397,7 @@ public com.google.protobuf.FieldMask getUpdateMask() { * To specify ALL fields, equivalent to the JSON API's "update" function, * specify a single field with the value `*`. Note: not recommended. If a new * field is introduced at a later time, an older client updating with the `*` - * may accidentally reset the new field's value. + * might accidentally reset the new field's value. * * Not specifying any fields is an error. * @@ -766,7 +766,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build * * * 
                                            -   * Request message for UpdateObject.
+   * Request message for [UpdateObject][google.storage.v2.Storage.UpdateObject].
    *
                                            * * Protobuf type {@code google.storage.v2.UpdateObjectRequest} @@ -1763,7 +1763,7 @@ public Builder setPredefinedAclBytes(com.google.protobuf.ByteString value) { * To specify ALL fields, equivalent to the JSON API's "update" function, * specify a single field with the value `*`. Note: not recommended. If a new * field is introduced at a later time, an older client updating with the `*` - * may accidentally reset the new field's value. + * might accidentally reset the new field's value. * * Not specifying any fields is an error. * @@ -1786,7 +1786,7 @@ public boolean hasUpdateMask() { * To specify ALL fields, equivalent to the JSON API's "update" function, * specify a single field with the value `*`. Note: not recommended. If a new * field is introduced at a later time, an older client updating with the `*` - * may accidentally reset the new field's value. + * might accidentally reset the new field's value. * * Not specifying any fields is an error. * @@ -1815,7 +1815,7 @@ public com.google.protobuf.FieldMask getUpdateMask() { * To specify ALL fields, equivalent to the JSON API's "update" function, * specify a single field with the value `*`. Note: not recommended. If a new * field is introduced at a later time, an older client updating with the `*` - * may accidentally reset the new field's value. + * might accidentally reset the new field's value. * * Not specifying any fields is an error. * @@ -1846,7 +1846,7 @@ public Builder setUpdateMask(com.google.protobuf.FieldMask value) { * To specify ALL fields, equivalent to the JSON API's "update" function, * specify a single field with the value `*`. Note: not recommended. If a new * field is introduced at a later time, an older client updating with the `*` - * may accidentally reset the new field's value. + * might accidentally reset the new field's value. * * Not specifying any fields is an error. * @@ -1874,7 +1874,7 @@ public Builder setUpdateMask(com.google.protobuf.FieldMask.Builder builderForVal * To specify ALL fields, equivalent to the JSON API's "update" function, * specify a single field with the value `*`. Note: not recommended. If a new * field is introduced at a later time, an older client updating with the `*` - * may accidentally reset the new field's value. + * might accidentally reset the new field's value. * * Not specifying any fields is an error. * @@ -1910,7 +1910,7 @@ public Builder mergeUpdateMask(com.google.protobuf.FieldMask value) { * To specify ALL fields, equivalent to the JSON API's "update" function, * specify a single field with the value `*`. Note: not recommended. If a new * field is introduced at a later time, an older client updating with the `*` - * may accidentally reset the new field's value. + * might accidentally reset the new field's value. * * Not specifying any fields is an error. * @@ -1938,7 +1938,7 @@ public Builder clearUpdateMask() { * To specify ALL fields, equivalent to the JSON API's "update" function, * specify a single field with the value `*`. Note: not recommended. If a new * field is introduced at a later time, an older client updating with the `*` - * may accidentally reset the new field's value. + * might accidentally reset the new field's value. * * Not specifying any fields is an error. * @@ -1961,7 +1961,7 @@ public com.google.protobuf.FieldMask.Builder getUpdateMaskBuilder() { * To specify ALL fields, equivalent to the JSON API's "update" function, * specify a single field with the value `*`. Note: not recommended. If a new * field is introduced at a later time, an older client updating with the `*` - * may accidentally reset the new field's value. + * might accidentally reset the new field's value. * * Not specifying any fields is an error. * @@ -1988,7 +1988,7 @@ public com.google.protobuf.FieldMaskOrBuilder getUpdateMaskOrBuilder() { * To specify ALL fields, equivalent to the JSON API's "update" function, * specify a single field with the value `*`. Note: not recommended. If a new * field is introduced at a later time, an older client updating with the `*` - * may accidentally reset the new field's value. + * might accidentally reset the new field's value. * * Not specifying any fields is an error. * diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/UpdateObjectRequestOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/UpdateObjectRequestOrBuilder.java index 9a78998a09..ef65cfc7a3 100644 --- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/UpdateObjectRequestOrBuilder.java +++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/UpdateObjectRequestOrBuilder.java @@ -230,7 +230,7 @@ public interface UpdateObjectRequestOrBuilder * To specify ALL fields, equivalent to the JSON API's "update" function, * specify a single field with the value `*`. Note: not recommended. If a new * field is introduced at a later time, an older client updating with the `*` - * may accidentally reset the new field's value. + * might accidentally reset the new field's value. * * Not specifying any fields is an error. * @@ -251,7 +251,7 @@ public interface UpdateObjectRequestOrBuilder * To specify ALL fields, equivalent to the JSON API's "update" function, * specify a single field with the value `*`. Note: not recommended. If a new * field is introduced at a later time, an older client updating with the `*` - * may accidentally reset the new field's value. + * might accidentally reset the new field's value. * * Not specifying any fields is an error. * @@ -272,7 +272,7 @@ public interface UpdateObjectRequestOrBuilder * To specify ALL fields, equivalent to the JSON API's "update" function, * specify a single field with the value `*`. Note: not recommended. If a new * field is introduced at a later time, an older client updating with the `*` - * may accidentally reset the new field's value. + * might accidentally reset the new field's value. * * Not specifying any fields is an error. * diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/WriteObjectRequest.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/WriteObjectRequest.java index 8e6c29b413..d0309716cf 100644 --- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/WriteObjectRequest.java +++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/WriteObjectRequest.java @@ -23,7 +23,7 @@ * * * 
                                            - * Request message for WriteObject.
+ * Request message for [WriteObject][google.storage.v2.Storage.WriteObject].
  *
                                            * * Protobuf type {@code google.storage.v2.WriteObjectRequest} @@ -312,7 +312,7 @@ public com.google.storage.v2.WriteObjectSpecOrBuilder getWriteObjectSpecOrBuilde * first `write_offset` and the sizes of all `data` chunks sent previously on * this stream. * - * An incorrect value will cause an error. + * An incorrect value causes an error. * * * int64 write_offset = 3 [(.google.api.field_behavior) = REQUIRED]; @@ -331,7 +331,7 @@ public long getWriteOffset() { * * 
                                                * The data to insert. If a crc32c checksum is provided that doesn't match
-   * the checksum computed by the service, the request will fail.
+   * the checksum computed by the service, the request fails.
    *
                                            * * .google.storage.v2.ChecksummedData checksummed_data = 4; @@ -348,7 +348,7 @@ public boolean hasChecksummedData() { * * 
                                                * The data to insert. If a crc32c checksum is provided that doesn't match
-   * the checksum computed by the service, the request will fail.
+   * the checksum computed by the service, the request fails.
    *
                                            * * .google.storage.v2.ChecksummedData checksummed_data = 4; @@ -368,7 +368,7 @@ public com.google.storage.v2.ChecksummedData getChecksummedData() { * * 
                                                * The data to insert. If a crc32c checksum is provided that doesn't match
-   * the checksum computed by the service, the request will fail.
+   * the checksum computed by the service, the request fails.
    *
                                            * * .google.storage.v2.ChecksummedData checksummed_data = 4; @@ -389,9 +389,9 @@ public com.google.storage.v2.ChecksummedDataOrBuilder getChecksummedDataOrBuilde * * 
                                                * Optional. Checksums for the complete object. If the checksums computed by
-   * the service don't match the specified checksums the call will fail. May
-   * only be provided in the first or last request (either with first_message,
-   * or finish_write set).
+   * the service don't match the specified checksums the call fails. This field
+   * might only be provided in the first or last request (either with
+   * `first_message`, or `finish_write` set).
    *
                                            * * @@ -410,9 +410,9 @@ public boolean hasObjectChecksums() { * * 
                                                * Optional. Checksums for the complete object. If the checksums computed by
-   * the service don't match the specified checksums the call will fail. May
-   * only be provided in the first or last request (either with first_message,
-   * or finish_write set).
+   * the service don't match the specified checksums the call fails. This field
+   * might only be provided in the first or last request (either with
+   * `first_message`, or `finish_write` set).
    *
                                            * * @@ -433,9 +433,9 @@ public com.google.storage.v2.ObjectChecksums getObjectChecksums() { * * 
                                                * Optional. Checksums for the complete object. If the checksums computed by
-   * the service don't match the specified checksums the call will fail. May
-   * only be provided in the first or last request (either with first_message,
-   * or finish_write set).
+   * the service don't match the specified checksums the call fails. This field
+   * might only be provided in the first or last request (either with
+   * `first_message`, or `finish_write` set).
    *
                                            * * @@ -458,8 +458,8 @@ public com.google.storage.v2.ObjectChecksumsOrBuilder getObjectChecksumsOrBuilde * 
                                                * Optional. If `true`, this indicates that the write is complete. Sending any
    * `WriteObjectRequest`s subsequent to one in which `finish_write` is `true`
-   * will cause an error.
-   * For a non-resumable write (where the upload_id was not set in the first
+   * causes an error.
+   * For a non-resumable write (where the `upload_id` was not set in the first
    * message), it is an error not to set this field in the final message of the
    * stream.
    *
                                            @@ -480,8 +480,8 @@ public boolean getFinishWrite() { * * * 
                                            -   * Optional. A set of parameters common to Storage API requests concerning an
-   * object.
+   * Optional. A set of parameters common to Cloud Storage API requests
+   * concerning an object.
    *
                                            * * @@ -499,8 +499,8 @@ public boolean hasCommonObjectRequestParams() { * * * 
                                            -   * Optional. A set of parameters common to Storage API requests concerning an
-   * object.
+   * Optional. A set of parameters common to Cloud Storage API requests
+   * concerning an object.
    *
                                            * * @@ -520,8 +520,8 @@ public com.google.storage.v2.CommonObjectRequestParams getCommonObjectRequestPar * * * 
                                            -   * Optional. A set of parameters common to Storage API requests concerning an
-   * object.
+   * Optional. A set of parameters common to Cloud Storage API requests
+   * concerning an object.
    *
                                            * * @@ -800,7 +800,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build * * * 
                                            -   * Request message for WriteObject.
+   * Request message for [WriteObject][google.storage.v2.Storage.WriteObject].
    *
                                            * * Protobuf type {@code google.storage.v2.WriteObjectRequest} @@ -1532,7 +1532,7 @@ public com.google.storage.v2.WriteObjectSpecOrBuilder getWriteObjectSpecOrBuilde * first `write_offset` and the sizes of all `data` chunks sent previously on * this stream. * - * An incorrect value will cause an error. + * An incorrect value causes an error. * * * int64 write_offset = 3 [(.google.api.field_behavior) = REQUIRED]; @@ -1560,7 +1560,7 @@ public long getWriteOffset() { * first `write_offset` and the sizes of all `data` chunks sent previously on * this stream. * - * An incorrect value will cause an error. + * An incorrect value causes an error. * * * int64 write_offset = 3 [(.google.api.field_behavior) = REQUIRED]; @@ -1592,7 +1592,7 @@ public Builder setWriteOffset(long value) { * first `write_offset` and the sizes of all `data` chunks sent previously on * this stream. * - * An incorrect value will cause an error. + * An incorrect value causes an error. * * * int64 write_offset = 3 [(.google.api.field_behavior) = REQUIRED]; @@ -1617,7 +1617,7 @@ public Builder clearWriteOffset() { * * 
                                                  * The data to insert. If a crc32c checksum is provided that doesn't match
-     * the checksum computed by the service, the request will fail.
+     * the checksum computed by the service, the request fails.
      *
                                            * * .google.storage.v2.ChecksummedData checksummed_data = 4; @@ -1634,7 +1634,7 @@ public boolean hasChecksummedData() { * * 
                                                  * The data to insert. If a crc32c checksum is provided that doesn't match
-     * the checksum computed by the service, the request will fail.
+     * the checksum computed by the service, the request fails.
      *
                                            * * .google.storage.v2.ChecksummedData checksummed_data = 4; @@ -1661,7 +1661,7 @@ public com.google.storage.v2.ChecksummedData getChecksummedData() { * * 
                                                  * The data to insert. If a crc32c checksum is provided that doesn't match
-     * the checksum computed by the service, the request will fail.
+     * the checksum computed by the service, the request fails.
      *
                                            * * .google.storage.v2.ChecksummedData checksummed_data = 4; @@ -1685,7 +1685,7 @@ public Builder setChecksummedData(com.google.storage.v2.ChecksummedData value) { * * 
                                                  * The data to insert. If a crc32c checksum is provided that doesn't match
-     * the checksum computed by the service, the request will fail.
+     * the checksum computed by the service, the request fails.
      *
                                            * * .google.storage.v2.ChecksummedData checksummed_data = 4; @@ -1707,7 +1707,7 @@ public Builder setChecksummedData( * * 
                                                  * The data to insert. If a crc32c checksum is provided that doesn't match
-     * the checksum computed by the service, the request will fail.
+     * the checksum computed by the service, the request fails.
      *
                                            * * .google.storage.v2.ChecksummedData checksummed_data = 4; @@ -1740,7 +1740,7 @@ public Builder mergeChecksummedData(com.google.storage.v2.ChecksummedData value) * * 
                                                  * The data to insert. If a crc32c checksum is provided that doesn't match
-     * the checksum computed by the service, the request will fail.
+     * the checksum computed by the service, the request fails.
      *
                                            * * .google.storage.v2.ChecksummedData checksummed_data = 4; @@ -1767,7 +1767,7 @@ public Builder clearChecksummedData() { * * 
                                                  * The data to insert. If a crc32c checksum is provided that doesn't match
-     * the checksum computed by the service, the request will fail.
+     * the checksum computed by the service, the request fails.
      *
                                            * * .google.storage.v2.ChecksummedData checksummed_data = 4; @@ -1781,7 +1781,7 @@ public com.google.storage.v2.ChecksummedData.Builder getChecksummedDataBuilder() * * 
                                                  * The data to insert. If a crc32c checksum is provided that doesn't match
-     * the checksum computed by the service, the request will fail.
+     * the checksum computed by the service, the request fails.
      *
                                            * * .google.storage.v2.ChecksummedData checksummed_data = 4; @@ -1803,7 +1803,7 @@ public com.google.storage.v2.ChecksummedDataOrBuilder getChecksummedDataOrBuilde * * 
                                                  * The data to insert. If a crc32c checksum is provided that doesn't match
-     * the checksum computed by the service, the request will fail.
+     * the checksum computed by the service, the request fails.
      *
                                            * * .google.storage.v2.ChecksummedData checksummed_data = 4; @@ -1842,9 +1842,9 @@ public com.google.storage.v2.ChecksummedDataOrBuilder getChecksummedDataOrBuilde * * 
                                                  * Optional. Checksums for the complete object. If the checksums computed by
-     * the service don't match the specified checksums the call will fail. May
-     * only be provided in the first or last request (either with first_message,
-     * or finish_write set).
+     * the service don't match the specified checksums the call fails. This field
+     * might only be provided in the first or last request (either with
+     * `first_message`, or `finish_write` set).
      *
                                            * * @@ -1862,9 +1862,9 @@ public boolean hasObjectChecksums() { * * 
                                                  * Optional. Checksums for the complete object. If the checksums computed by
-     * the service don't match the specified checksums the call will fail. May
-     * only be provided in the first or last request (either with first_message,
-     * or finish_write set).
+     * the service don't match the specified checksums the call fails. This field
+     * might only be provided in the first or last request (either with
+     * `first_message`, or `finish_write` set).
      *
                                            * * @@ -1888,9 +1888,9 @@ public com.google.storage.v2.ObjectChecksums getObjectChecksums() { * * 
                                                  * Optional. Checksums for the complete object. If the checksums computed by
-     * the service don't match the specified checksums the call will fail. May
-     * only be provided in the first or last request (either with first_message,
-     * or finish_write set).
+     * the service don't match the specified checksums the call fails. This field
+     * might only be provided in the first or last request (either with
+     * `first_message`, or `finish_write` set).
      *
                                            * * @@ -1916,9 +1916,9 @@ public Builder setObjectChecksums(com.google.storage.v2.ObjectChecksums value) { * * 
                                                  * Optional. Checksums for the complete object. If the checksums computed by
-     * the service don't match the specified checksums the call will fail. May
-     * only be provided in the first or last request (either with first_message,
-     * or finish_write set).
+     * the service don't match the specified checksums the call fails. This field
+     * might only be provided in the first or last request (either with
+     * `first_message`, or `finish_write` set).
      *
                                            * * @@ -1942,9 +1942,9 @@ public Builder setObjectChecksums( * * 
                                                  * Optional. Checksums for the complete object. If the checksums computed by
-     * the service don't match the specified checksums the call will fail. May
-     * only be provided in the first or last request (either with first_message,
-     * or finish_write set).
+     * the service don't match the specified checksums the call fails. This field
+     * might only be provided in the first or last request (either with
+     * `first_message`, or `finish_write` set).
      *
                                            * * @@ -1975,9 +1975,9 @@ public Builder mergeObjectChecksums(com.google.storage.v2.ObjectChecksums value) * * 
                                                  * Optional. Checksums for the complete object. If the checksums computed by
-     * the service don't match the specified checksums the call will fail. May
-     * only be provided in the first or last request (either with first_message,
-     * or finish_write set).
+     * the service don't match the specified checksums the call fails. This field
+     * might only be provided in the first or last request (either with
+     * `first_message`, or `finish_write` set).
      *
                                            * * @@ -2000,9 +2000,9 @@ public Builder clearObjectChecksums() { * * 
                                                  * Optional. Checksums for the complete object. If the checksums computed by
-     * the service don't match the specified checksums the call will fail. May
-     * only be provided in the first or last request (either with first_message,
-     * or finish_write set).
+     * the service don't match the specified checksums the call fails. This field
+     * might only be provided in the first or last request (either with
+     * `first_message`, or `finish_write` set).
      *
                                            * * @@ -2020,9 +2020,9 @@ public com.google.storage.v2.ObjectChecksums.Builder getObjectChecksumsBuilder() * * 
                                                  * Optional. Checksums for the complete object. If the checksums computed by
-     * the service don't match the specified checksums the call will fail. May
-     * only be provided in the first or last request (either with first_message,
-     * or finish_write set).
+     * the service don't match the specified checksums the call fails. This field
+     * might only be provided in the first or last request (either with
+     * `first_message`, or `finish_write` set).
      *
                                            * * @@ -2044,9 +2044,9 @@ public com.google.storage.v2.ObjectChecksumsOrBuilder getObjectChecksumsOrBuilde * * 
                                                  * Optional. Checksums for the complete object. If the checksums computed by
-     * the service don't match the specified checksums the call will fail. May
-     * only be provided in the first or last request (either with first_message,
-     * or finish_write set).
+     * the service don't match the specified checksums the call fails. This field
+     * might only be provided in the first or last request (either with
+     * `first_message`, or `finish_write` set).
      *
                                            * * @@ -2078,8 +2078,8 @@ public com.google.storage.v2.ObjectChecksumsOrBuilder getObjectChecksumsOrBuilde * 
                                                  * Optional. If `true`, this indicates that the write is complete. Sending any
      * `WriteObjectRequest`s subsequent to one in which `finish_write` is `true`
-     * will cause an error.
-     * For a non-resumable write (where the upload_id was not set in the first
+     * causes an error.
+     * For a non-resumable write (where the `upload_id` was not set in the first
      * message), it is an error not to set this field in the final message of the
      * stream.
      *
                                            @@ -2099,8 +2099,8 @@ public boolean getFinishWrite() { * 
                                                  * Optional. If `true`, this indicates that the write is complete. Sending any
      * `WriteObjectRequest`s subsequent to one in which `finish_write` is `true`
-     * will cause an error.
-     * For a non-resumable write (where the upload_id was not set in the first
+     * causes an error.
+     * For a non-resumable write (where the `upload_id` was not set in the first
      * message), it is an error not to set this field in the final message of the
      * stream.
      *
                                            @@ -2124,8 +2124,8 @@ public Builder setFinishWrite(boolean value) { * 
                                                  * Optional. If `true`, this indicates that the write is complete. Sending any
      * `WriteObjectRequest`s subsequent to one in which `finish_write` is `true`
-     * will cause an error.
-     * For a non-resumable write (where the upload_id was not set in the first
+     * causes an error.
+     * For a non-resumable write (where the `upload_id` was not set in the first
      * message), it is an error not to set this field in the final message of the
      * stream.
      *
                                            @@ -2152,8 +2152,8 @@ public Builder clearFinishWrite() { * * * 
                                            -     * Optional. A set of parameters common to Storage API requests concerning an
-     * object.
+     * Optional. A set of parameters common to Cloud Storage API requests
+     * concerning an object.
      *
                                            * * @@ -2170,8 +2170,8 @@ public boolean hasCommonObjectRequestParams() { * * * 
                                            -     * Optional. A set of parameters common to Storage API requests concerning an
-     * object.
+     * Optional. A set of parameters common to Cloud Storage API requests
+     * concerning an object.
      *
                                            * * @@ -2194,8 +2194,8 @@ public com.google.storage.v2.CommonObjectRequestParams getCommonObjectRequestPar * * * 
                                            -     * Optional. A set of parameters common to Storage API requests concerning an
-     * object.
+     * Optional. A set of parameters common to Cloud Storage API requests
+     * concerning an object.
      *
                                            * * @@ -2221,8 +2221,8 @@ public Builder setCommonObjectRequestParams( * * * 
                                            -     * Optional. A set of parameters common to Storage API requests concerning an
-     * object.
+     * Optional. A set of parameters common to Cloud Storage API requests
+     * concerning an object.
      *
                                            * * @@ -2245,8 +2245,8 @@ public Builder setCommonObjectRequestParams( * * * 
                                            -     * Optional. A set of parameters common to Storage API requests concerning an
-     * object.
+     * Optional. A set of parameters common to Cloud Storage API requests
+     * concerning an object.
      *
                                            * * @@ -2278,8 +2278,8 @@ public Builder mergeCommonObjectRequestParams( * * * 
                                            -     * Optional. A set of parameters common to Storage API requests concerning an
-     * object.
+     * Optional. A set of parameters common to Cloud Storage API requests
+     * concerning an object.
      *
                                            * * @@ -2301,8 +2301,8 @@ public Builder clearCommonObjectRequestParams() { * * * 
                                            -     * Optional. A set of parameters common to Storage API requests concerning an
-     * object.
+     * Optional. A set of parameters common to Cloud Storage API requests
+     * concerning an object.
      *
                                            * * @@ -2320,8 +2320,8 @@ public Builder clearCommonObjectRequestParams() { * * * 
                                            -     * Optional. A set of parameters common to Storage API requests concerning an
-     * object.
+     * Optional. A set of parameters common to Cloud Storage API requests
+     * concerning an object.
      *
                                            * * @@ -2343,8 +2343,8 @@ public Builder clearCommonObjectRequestParams() { * * * 
                                            -     * Optional. A set of parameters common to Storage API requests concerning an
-     * object.
+     * Optional. A set of parameters common to Cloud Storage API requests
+     * concerning an object.
      *
                                            * * diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/WriteObjectRequestOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/WriteObjectRequestOrBuilder.java index 08203ad7eb..0446b25e5c 100644 --- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/WriteObjectRequestOrBuilder.java +++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/WriteObjectRequestOrBuilder.java @@ -122,7 +122,7 @@ public interface WriteObjectRequestOrBuilder * first `write_offset` and the sizes of all `data` chunks sent previously on * this stream. * - * An incorrect value will cause an error. + * An incorrect value causes an error. * * * int64 write_offset = 3 [(.google.api.field_behavior) = REQUIRED]; @@ -136,7 +136,7 @@ public interface WriteObjectRequestOrBuilder * * 
                                                * The data to insert. If a crc32c checksum is provided that doesn't match
-   * the checksum computed by the service, the request will fail.
+   * the checksum computed by the service, the request fails.
    *
                                            * * .google.storage.v2.ChecksummedData checksummed_data = 4; @@ -150,7 +150,7 @@ public interface WriteObjectRequestOrBuilder * * 
                                                * The data to insert. If a crc32c checksum is provided that doesn't match
-   * the checksum computed by the service, the request will fail.
+   * the checksum computed by the service, the request fails.
    *
                                            * * .google.storage.v2.ChecksummedData checksummed_data = 4; @@ -164,7 +164,7 @@ public interface WriteObjectRequestOrBuilder * * 
                                                * The data to insert. If a crc32c checksum is provided that doesn't match
-   * the checksum computed by the service, the request will fail.
+   * the checksum computed by the service, the request fails.
    *
                                            * * .google.storage.v2.ChecksummedData checksummed_data = 4; @@ -176,9 +176,9 @@ public interface WriteObjectRequestOrBuilder * * 
                                                * Optional. Checksums for the complete object. If the checksums computed by
-   * the service don't match the specified checksums the call will fail. May
-   * only be provided in the first or last request (either with first_message,
-   * or finish_write set).
+   * the service don't match the specified checksums the call fails. This field
+   * might only be provided in the first or last request (either with
+   * `first_message`, or `finish_write` set).
    *
                                            * * @@ -194,9 +194,9 @@ public interface WriteObjectRequestOrBuilder * * 
                                                * Optional. Checksums for the complete object. If the checksums computed by
-   * the service don't match the specified checksums the call will fail. May
-   * only be provided in the first or last request (either with first_message,
-   * or finish_write set).
+   * the service don't match the specified checksums the call fails. This field
+   * might only be provided in the first or last request (either with
+   * `first_message`, or `finish_write` set).
    *
                                            * * @@ -212,9 +212,9 @@ public interface WriteObjectRequestOrBuilder * * 
                                                * Optional. Checksums for the complete object. If the checksums computed by
-   * the service don't match the specified checksums the call will fail. May
-   * only be provided in the first or last request (either with first_message,
-   * or finish_write set).
+   * the service don't match the specified checksums the call fails. This field
+   * might only be provided in the first or last request (either with
+   * `first_message`, or `finish_write` set).
    *
                                            * * @@ -229,8 +229,8 @@ public interface WriteObjectRequestOrBuilder * 
                                                * Optional. If `true`, this indicates that the write is complete. Sending any
    * `WriteObjectRequest`s subsequent to one in which `finish_write` is `true`
-   * will cause an error.
-   * For a non-resumable write (where the upload_id was not set in the first
+   * causes an error.
+   * For a non-resumable write (where the `upload_id` was not set in the first
    * message), it is an error not to set this field in the final message of the
    * stream.
    *
                                            @@ -245,8 +245,8 @@ public interface WriteObjectRequestOrBuilder * * * 
                                            -   * Optional. A set of parameters common to Storage API requests concerning an
-   * object.
+   * Optional. A set of parameters common to Cloud Storage API requests
+   * concerning an object.
    *
                                            * * @@ -261,8 +261,8 @@ public interface WriteObjectRequestOrBuilder * * * 
                                            -   * Optional. A set of parameters common to Storage API requests concerning an
-   * object.
+   * Optional. A set of parameters common to Cloud Storage API requests
+   * concerning an object.
    *
                                            * * @@ -277,8 +277,8 @@ public interface WriteObjectRequestOrBuilder * * * 
                                            -   * Optional. A set of parameters common to Storage API requests concerning an
-   * object.
+   * Optional. A set of parameters common to Cloud Storage API requests
+   * concerning an object.
    *
                                            * * diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/WriteObjectResponse.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/WriteObjectResponse.java index 416e19649c..31143cc8f3 100644 --- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/WriteObjectResponse.java +++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/WriteObjectResponse.java @@ -23,7 +23,8 @@ * * * 
                                            - * Response message for WriteObject.
+ * Response message for
+ * [WriteObject][google.storage.v2.Storage.WriteObject].
  *
                                            * * Protobuf type {@code google.storage.v2.WriteObjectResponse} @@ -402,7 +403,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build * * * 
                                            -   * Response message for WriteObject.
+   * Response message for
+   * [WriteObject][google.storage.v2.Storage.WriteObject].
    *
                                            * * Protobuf type {@code google.storage.v2.WriteObjectResponse} diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/WriteObjectSpec.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/WriteObjectSpec.java index eec27356f2..1bbf0baa85 100644 --- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/WriteObjectSpec.java +++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/WriteObjectSpec.java @@ -124,8 +124,8 @@ public com.google.storage.v2.ObjectOrBuilder getResourceOrBuilder() { * * 
                                                * Optional. Apply a predefined set of access controls to this object.
-   * Valid values are "authenticatedRead", "bucketOwnerFullControl",
-   * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+   * Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+   * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
    *
                                            * * string predefined_acl = 7 [(.google.api.field_behavior) = OPTIONAL]; @@ -150,8 +150,8 @@ public java.lang.String getPredefinedAcl() { * * 
                                                * Optional. Apply a predefined set of access controls to this object.
-   * Valid values are "authenticatedRead", "bucketOwnerFullControl",
-   * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+   * Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+   * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
    *
                                            * * string predefined_acl = 7 [(.google.api.field_behavior) = OPTIONAL]; @@ -179,7 +179,7 @@ public com.google.protobuf.ByteString getPredefinedAclBytes() { * * 
                                                * Makes the operation conditional on whether the object's current
-   * generation matches the given value. Setting to 0 makes the operation
+   * generation matches the given value. Setting to `0` makes the operation
    * succeed only if there are no live versions of the object.
    *
                                            * @@ -197,7 +197,7 @@ public boolean hasIfGenerationMatch() { * * 
                                                * Makes the operation conditional on whether the object's current
-   * generation matches the given value. Setting to 0 makes the operation
+   * generation matches the given value. Setting to `0` makes the operation
    * succeed only if there are no live versions of the object.
    *
                                            * @@ -219,7 +219,7 @@ public long getIfGenerationMatch() { * 
                                                * Makes the operation conditional on whether the object's live
    * generation does not match the given value. If no live object exists, the
-   * precondition fails. Setting to 0 makes the operation succeed only if
+   * precondition fails. Setting to `0` makes the operation succeed only if
    * there is a live version of the object.
    *
                                            * @@ -238,7 +238,7 @@ public boolean hasIfGenerationNotMatch() { * 
                                                * Makes the operation conditional on whether the object's live
    * generation does not match the given value. If no live object exists, the
-   * precondition fails. Setting to 0 makes the operation succeed only if
+   * precondition fails. Setting to `0` makes the operation succeed only if
    * there is a live version of the object.
    *
                                            * @@ -334,7 +334,7 @@ public long getIfMetagenerationNotMatch() { * 
                                                * The expected final object size being uploaded.
    * If this value is set, closing the stream after writing fewer or more than
-   * `object_size` bytes will result in an OUT_OF_RANGE error.
+   * `object_size` bytes results in an `OUT_OF_RANGE` error.
    *
    * This situation is considered a client error, and if such an error occurs
    * you must start the upload over from scratch, this time sending the correct
@@ -356,7 +356,7 @@ public boolean hasObjectSize() {
    * 
                                                * The expected final object size being uploaded.
    * If this value is set, closing the stream after writing fewer or more than
-   * `object_size` bytes will result in an OUT_OF_RANGE error.
+   * `object_size` bytes results in an `OUT_OF_RANGE` error.
    *
    * This situation is considered a client error, and if such an error occurs
    * you must start the upload over from scratch, this time sending the correct
@@ -379,8 +379,8 @@ public long getObjectSize() {
    *
    *
    * 
                                            -   * If true, the object will be created in appendable mode.
-   * This field may only be set when using BidiWriteObject.
+   * If `true`, the object is created in appendable mode.
+   * This field might only be set when using `BidiWriteObject`.
    * 
                                            
    *
    * optional bool appendable = 9;
@@ -396,8 +396,8 @@ public boolean hasAppendable() {
    *
    *
    * 
                                            -   * If true, the object will be created in appendable mode.
-   * This field may only be set when using BidiWriteObject.
+   * If `true`, the object is created in appendable mode.
+   * This field might only be set when using `BidiWriteObject`.
    * 
                                            
    *
    * optional bool appendable = 9;
@@ -1166,8 +1166,8 @@ public com.google.storage.v2.ObjectOrBuilder getResourceOrBuilder() {
      *
      * 
                                                  * Optional. Apply a predefined set of access controls to this object.
-     * Valid values are "authenticatedRead", "bucketOwnerFullControl",
-     * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+     * Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+     * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
      * 
                                            
      *
      * string predefined_acl = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -1191,8 +1191,8 @@ public java.lang.String getPredefinedAcl() {
      *
      * 
                                                  * Optional. Apply a predefined set of access controls to this object.
-     * Valid values are "authenticatedRead", "bucketOwnerFullControl",
-     * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+     * Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+     * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
      * 
                                            
      *
      * string predefined_acl = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -1216,8 +1216,8 @@ public com.google.protobuf.ByteString getPredefinedAclBytes() {
      *
      * 
                                                  * Optional. Apply a predefined set of access controls to this object.
-     * Valid values are "authenticatedRead", "bucketOwnerFullControl",
-     * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+     * Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+     * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
      * 
                                            
      *
      * string predefined_acl = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -1240,8 +1240,8 @@ public Builder setPredefinedAcl(java.lang.String value) {
      *
      * 
                                                  * Optional. Apply a predefined set of access controls to this object.
-     * Valid values are "authenticatedRead", "bucketOwnerFullControl",
-     * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+     * Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+     * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
      * 
                                            
      *
      * string predefined_acl = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -1260,8 +1260,8 @@ public Builder clearPredefinedAcl() {
      *
      * 
                                                  * Optional. Apply a predefined set of access controls to this object.
-     * Valid values are "authenticatedRead", "bucketOwnerFullControl",
-     * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+     * Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+     * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
      * 
                                            
      *
      * string predefined_acl = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -1287,7 +1287,7 @@ public Builder setPredefinedAclBytes(com.google.protobuf.ByteString value) {
      *
      * 
                                                  * Makes the operation conditional on whether the object's current
-     * generation matches the given value. Setting to 0 makes the operation
+     * generation matches the given value. Setting to `0` makes the operation
      * succeed only if there are no live versions of the object.
      * 
                                            
      *
@@ -1305,7 +1305,7 @@ public boolean hasIfGenerationMatch() {
      *
      * 
                                                  * Makes the operation conditional on whether the object's current
-     * generation matches the given value. Setting to 0 makes the operation
+     * generation matches the given value. Setting to `0` makes the operation
      * succeed only if there are no live versions of the object.
      * 
                                            
      *
@@ -1323,7 +1323,7 @@ public long getIfGenerationMatch() {
      *
      * 
                                                  * Makes the operation conditional on whether the object's current
-     * generation matches the given value. Setting to 0 makes the operation
+     * generation matches the given value. Setting to `0` makes the operation
      * succeed only if there are no live versions of the object.
      * 
                                            
      *
@@ -1345,7 +1345,7 @@ public Builder setIfGenerationMatch(long value) {
      *
      * 
                                                  * Makes the operation conditional on whether the object's current
-     * generation matches the given value. Setting to 0 makes the operation
+     * generation matches the given value. Setting to `0` makes the operation
      * succeed only if there are no live versions of the object.
      * 
                                            
      *
@@ -1368,7 +1368,7 @@ public Builder clearIfGenerationMatch() {
      * 
                                                  * Makes the operation conditional on whether the object's live
      * generation does not match the given value. If no live object exists, the
-     * precondition fails. Setting to 0 makes the operation succeed only if
+     * precondition fails. Setting to `0` makes the operation succeed only if
      * there is a live version of the object.
      * 
                                            
      *
@@ -1387,7 +1387,7 @@ public boolean hasIfGenerationNotMatch() {
      * 
                                                  * Makes the operation conditional on whether the object's live
      * generation does not match the given value. If no live object exists, the
-     * precondition fails. Setting to 0 makes the operation succeed only if
+     * precondition fails. Setting to `0` makes the operation succeed only if
      * there is a live version of the object.
      * 
                                            
      *
@@ -1406,7 +1406,7 @@ public long getIfGenerationNotMatch() {
      * 
                                                  * Makes the operation conditional on whether the object's live
      * generation does not match the given value. If no live object exists, the
-     * precondition fails. Setting to 0 makes the operation succeed only if
+     * precondition fails. Setting to `0` makes the operation succeed only if
      * there is a live version of the object.
      * 
                                            
      *
@@ -1429,7 +1429,7 @@ public Builder setIfGenerationNotMatch(long value) {
      * 
                                                  * Makes the operation conditional on whether the object's live
      * generation does not match the given value. If no live object exists, the
-     * precondition fails. Setting to 0 makes the operation succeed only if
+     * precondition fails. Setting to `0` makes the operation succeed only if
      * there is a live version of the object.
      * 
                                            
      *
@@ -1604,7 +1604,7 @@ public Builder clearIfMetagenerationNotMatch() {
      * 
                                                  * The expected final object size being uploaded.
      * If this value is set, closing the stream after writing fewer or more than
-     * `object_size` bytes will result in an OUT_OF_RANGE error.
+     * `object_size` bytes results in an `OUT_OF_RANGE` error.
      *
      * This situation is considered a client error, and if such an error occurs
      * you must start the upload over from scratch, this time sending the correct
@@ -1626,7 +1626,7 @@ public boolean hasObjectSize() {
      * 
                                                  * The expected final object size being uploaded.
      * If this value is set, closing the stream after writing fewer or more than
-     * `object_size` bytes will result in an OUT_OF_RANGE error.
+     * `object_size` bytes results in an `OUT_OF_RANGE` error.
      *
      * This situation is considered a client error, and if such an error occurs
      * you must start the upload over from scratch, this time sending the correct
@@ -1648,7 +1648,7 @@ public long getObjectSize() {
      * 
                                                  * The expected final object size being uploaded.
      * If this value is set, closing the stream after writing fewer or more than
-     * `object_size` bytes will result in an OUT_OF_RANGE error.
+     * `object_size` bytes results in an `OUT_OF_RANGE` error.
      *
      * This situation is considered a client error, and if such an error occurs
      * you must start the upload over from scratch, this time sending the correct
@@ -1674,7 +1674,7 @@ public Builder setObjectSize(long value) {
      * 
                                                  * The expected final object size being uploaded.
      * If this value is set, closing the stream after writing fewer or more than
-     * `object_size` bytes will result in an OUT_OF_RANGE error.
+     * `object_size` bytes results in an `OUT_OF_RANGE` error.
      *
      * This situation is considered a client error, and if such an error occurs
      * you must start the upload over from scratch, this time sending the correct
@@ -1698,8 +1698,8 @@ public Builder clearObjectSize() {
      *
      *
      * 
                                            -     * If true, the object will be created in appendable mode.
-     * This field may only be set when using BidiWriteObject.
+     * If `true`, the object is created in appendable mode.
+     * This field might only be set when using `BidiWriteObject`.
      * 
                                            
      *
      * optional bool appendable = 9;
@@ -1715,8 +1715,8 @@ public boolean hasAppendable() {
      *
      *
      * 
                                            -     * If true, the object will be created in appendable mode.
-     * This field may only be set when using BidiWriteObject.
+     * If `true`, the object is created in appendable mode.
+     * This field might only be set when using `BidiWriteObject`.
      * 
                                            
      *
      * optional bool appendable = 9;
@@ -1732,8 +1732,8 @@ public boolean getAppendable() {
      *
      *
      * 
                                            -     * If true, the object will be created in appendable mode.
-     * This field may only be set when using BidiWriteObject.
+     * If `true`, the object is created in appendable mode.
+     * This field might only be set when using `BidiWriteObject`.
      * 
                                            
      *
      * optional bool appendable = 9;
@@ -1753,8 +1753,8 @@ public Builder setAppendable(boolean value) {
      *
      *
      * 
                                            -     * If true, the object will be created in appendable mode.
-     * This field may only be set when using BidiWriteObject.
+     * If `true`, the object is created in appendable mode.
+     * This field might only be set when using `BidiWriteObject`.
      * 
                                            
      *
      * optional bool appendable = 9;
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/WriteObjectSpecOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/WriteObjectSpecOrBuilder.java
index edc6a42180..3cdb5ee71a 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/WriteObjectSpecOrBuilder.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/WriteObjectSpecOrBuilder.java
@@ -66,8 +66,8 @@ public interface WriteObjectSpecOrBuilder
    *
    * 
                                                * Optional. Apply a predefined set of access controls to this object.
-   * Valid values are "authenticatedRead", "bucketOwnerFullControl",
-   * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+   * Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+   * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
    * 
                                            
    *
    * string predefined_acl = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -81,8 +81,8 @@ public interface WriteObjectSpecOrBuilder
    *
    * 
                                                * Optional. Apply a predefined set of access controls to this object.
-   * Valid values are "authenticatedRead", "bucketOwnerFullControl",
-   * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+   * Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+   * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
    * 
                                            
    *
    * string predefined_acl = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -96,7 +96,7 @@ public interface WriteObjectSpecOrBuilder
    *
    * 
                                                * Makes the operation conditional on whether the object's current
-   * generation matches the given value. Setting to 0 makes the operation
+   * generation matches the given value. Setting to `0` makes the operation
    * succeed only if there are no live versions of the object.
    * 
                                            
    *
@@ -111,7 +111,7 @@ public interface WriteObjectSpecOrBuilder
    *
    * 
                                                * Makes the operation conditional on whether the object's current
-   * generation matches the given value. Setting to 0 makes the operation
+   * generation matches the given value. Setting to `0` makes the operation
    * succeed only if there are no live versions of the object.
    * 
                                            
    *
@@ -127,7 +127,7 @@ public interface WriteObjectSpecOrBuilder
    * 
                                                * Makes the operation conditional on whether the object's live
    * generation does not match the given value. If no live object exists, the
-   * precondition fails. Setting to 0 makes the operation succeed only if
+   * precondition fails. Setting to `0` makes the operation succeed only if
    * there is a live version of the object.
    * 
                                            
    *
@@ -143,7 +143,7 @@ public interface WriteObjectSpecOrBuilder
    * 
                                                * Makes the operation conditional on whether the object's live
    * generation does not match the given value. If no live object exists, the
-   * precondition fails. Setting to 0 makes the operation succeed only if
+   * precondition fails. Setting to `0` makes the operation succeed only if
    * there is a live version of the object.
    * 
                                            
    *
@@ -215,7 +215,7 @@ public interface WriteObjectSpecOrBuilder
    * 
                                                * The expected final object size being uploaded.
    * If this value is set, closing the stream after writing fewer or more than
-   * `object_size` bytes will result in an OUT_OF_RANGE error.
+   * `object_size` bytes results in an `OUT_OF_RANGE` error.
    *
    * This situation is considered a client error, and if such an error occurs
    * you must start the upload over from scratch, this time sending the correct
@@ -234,7 +234,7 @@ public interface WriteObjectSpecOrBuilder
    * 
                                                * The expected final object size being uploaded.
    * If this value is set, closing the stream after writing fewer or more than
-   * `object_size` bytes will result in an OUT_OF_RANGE error.
+   * `object_size` bytes results in an `OUT_OF_RANGE` error.
    *
    * This situation is considered a client error, and if such an error occurs
    * you must start the upload over from scratch, this time sending the correct
@@ -251,8 +251,8 @@ public interface WriteObjectSpecOrBuilder
    *
    *
    * 
                                            -   * If true, the object will be created in appendable mode.
-   * This field may only be set when using BidiWriteObject.
+   * If `true`, the object is created in appendable mode.
+   * This field might only be set when using `BidiWriteObject`.
    * 
                                            
    *
    * optional bool appendable = 9;
@@ -265,8 +265,8 @@ public interface WriteObjectSpecOrBuilder
    *
    *
    * 
                                            -   * If true, the object will be created in appendable mode.
-   * This field may only be set when using BidiWriteObject.
+   * If `true`, the object is created in appendable mode.
+   * This field might only be set when using `BidiWriteObject`.
    * 
                                            
    *
    * optional bool appendable = 9;
diff --git a/proto-google-cloud-storage-v2/src/main/proto/google/storage/v2/storage.proto b/proto-google-cloud-storage-v2/src/main/proto/google/storage/v2/storage.proto
index cb677d47df..95eb2832d3 100644
--- a/proto-google-cloud-storage-v2/src/main/proto/google/storage/v2/storage.proto
+++ b/proto-google-cloud-storage-v2/src/main/proto/google/storage/v2/storage.proto
@@ -42,23 +42,28 @@ option (google.api.resource_definition) = {
 //
 // The Cloud Storage gRPC API allows applications to read and write data through
 // the abstractions of buckets and objects. For a description of these
-// abstractions please see https://cloud.google.com/storage/docs.
+// abstractions please see [Cloud Storage
+// documentation](https://cloud.google.com/storage/docs).
 //
 // Resources are named as follows:
+//
 //   - Projects are referred to as they are defined by the Resource Manager API,
 //     using strings like `projects/123456` or `projects/my-string-id`.
 //   - Buckets are named using string names of the form:
-//     `projects/{project}/buckets/{bucket}`
-//     For globally unique buckets, `_` may be substituted for the project.
+//     `projects/{project}/buckets/{bucket}`.
+//     For globally unique buckets, `_` might be substituted for the project.
 //   - Objects are uniquely identified by their name along with the name of the
 //     bucket they belong to, as separate strings in this API. For example:
 //
-//       ReadObjectRequest {
+//         ```
+//         ReadObjectRequest {
 //         bucket: 'projects/_/buckets/my-bucket'
 //         object: 'my-object'
-//       }
-//     Note that object names can contain `/` characters, which are treated as
-//     any other character (no special directory semantics).
+//         }
+//         ```
+//
+// Note that object names can contain `/` characters, which are treated as
+// any other character (no special directory semantics).
 service Storage {
   option (google.api.default_host) = "storage.googleapis.com";
   option (google.api.oauth_scopes) =
@@ -69,6 +74,29 @@ service Storage {
       "https://www.googleapis.com/auth/devstorage.read_write";
 
   // Permanently deletes an empty bucket.
+  // The request fails if there are any live or
+  // noncurrent objects in the bucket, but the request succeeds if the
+  // bucket only contains soft-deleted objects or incomplete uploads, such
+  // as ongoing XML API multipart uploads. Does not permanently delete
+  // soft-deleted objects.
+  //
+  // When this API is used to delete a bucket containing an object that has a
+  // soft delete policy
+  // enabled, the object becomes soft deleted, and the
+  // `softDeleteTime` and `hardDeleteTime` properties are set on the
+  // object.
+  //
+  // Objects and multipart uploads that were in the bucket at the time of
+  // deletion are also retained for the specified retention duration. When
+  // a soft-deleted bucket reaches the end of its retention duration, it
+  // is permanently deleted. The `hardDeleteTime` of the bucket always
+  // equals
+  // or exceeds the expiration time of the last soft-deleted object in the
+  // bucket.
+  //
+  // **IAM Permissions**:
+  //
+  // Requires `storage.buckets.delete` IAM permission on the bucket.
   rpc DeleteBucket(DeleteBucketRequest) returns (google.protobuf.Empty) {
     option (google.api.routing) = {
       routing_parameters { field: "name" path_template: "{bucket=**}" }
@@ -77,6 +105,16 @@ service Storage {
   }
 
   // Returns metadata for the specified bucket.
+  //
+  // **IAM Permissions**:
+  //
+  // Requires `storage.buckets.get`
+  // IAM permission on
+  // the bucket. Additionally, to return specific bucket metadata, the
+  // authenticated user must have the following permissions:
+  //
+  // - To return the IAM policies: `storage.buckets.getIamPolicy`
+  // - To return the bucket IP filtering rules: `storage.buckets.getIpFilter`
   rpc GetBucket(GetBucketRequest) returns (Bucket) {
     option (google.api.routing) = {
       routing_parameters { field: "name" path_template: "{bucket=**}" }
@@ -85,6 +123,16 @@ service Storage {
   }
 
   // Creates a new bucket.
+  //
+  // **IAM Permissions**:
+  //
+  // Requires `storage.buckets.create` IAM permission on the bucket.
+  // Additionally, to enable specific bucket features, the authenticated user
+  // must have the following permissions:
+  //
+  // - To enable object retention using the `enableObjectRetention` query
+  // parameter: `storage.buckets.enableObjectRetention`
+  // - To set the bucket IP filtering rules: `storage.buckets.setIpFilter`
   rpc CreateBucket(CreateBucketRequest) returns (Bucket) {
     option (google.api.routing) = {
       routing_parameters { field: "parent" path_template: "{project=**}" }
@@ -96,7 +144,17 @@ service Storage {
     option (google.api.method_signature) = "parent,bucket,bucket_id";
   }
 
-  // Retrieves a list of buckets for a given project.
+  // Retrieves a list of buckets for a given project, ordered
+  // lexicographically by name.
+  //
+  // **IAM Permissions**:
+  //
+  // Requires `storage.buckets.list` IAM permission on the bucket.
+  // Additionally, to enable specific bucket features, the authenticated
+  // user must have the following permissions:
+  //
+  // - To list the IAM policies: `storage.buckets.getIamPolicy`
+  // - To list the bucket IP filtering rules: `storage.buckets.getIpFilter`
   rpc ListBuckets(ListBucketsRequest) returns (ListBucketsResponse) {
     option (google.api.routing) = {
       routing_parameters { field: "parent" path_template: "{project=**}" }
@@ -104,7 +162,25 @@ service Storage {
     option (google.api.method_signature) = "parent";
   }
 
-  // Locks retention policy on a bucket.
+  // Permanently locks the retention
+  // policy that is
+  // currently applied to the specified bucket.
+  //
+  // Caution: Locking a bucket is an
+  // irreversible action. Once you lock a bucket:
+  //
+  // - You cannot remove the retention policy from the bucket.
+  // - You cannot decrease the retention period for the policy.
+  //
+  // Once locked, you must delete the entire bucket in order to remove the
+  // bucket's retention policy. However, before you can delete the bucket, you
+  // must delete all the objects in the bucket, which is only
+  // possible if all the objects have reached the retention period set by the
+  // retention policy.
+  //
+  // **IAM Permissions**:
+  //
+  // Requires `storage.buckets.update` IAM permission on the bucket.
   rpc LockBucketRetentionPolicy(LockBucketRetentionPolicyRequest)
       returns (Bucket) {
     option (google.api.routing) = {
@@ -113,11 +189,17 @@ service Storage {
     option (google.api.method_signature) = "bucket";
   }
 
-  // Gets the IAM policy for a specified bucket.
+  // Gets the IAM policy for a specified bucket or managed folder.
   // The `resource` field in the request should be
   // `projects/_/buckets/{bucket}` for a bucket, or
   // `projects/_/buckets/{bucket}/managedFolders/{managedFolder}`
   // for a managed folder.
+  //
+  // **IAM Permissions**:
+  //
+  // Requires `storage.buckets.getIamPolicy` on the bucket or
+  // `storage.managedFolders.getIamPolicy` IAM permission on the
+  // managed folder.
   rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest)
       returns (google.iam.v1.Policy) {
     option (google.api.routing) = {
@@ -130,7 +212,7 @@ service Storage {
     option (google.api.method_signature) = "resource";
   }
 
-  // Updates an IAM policy for the specified bucket.
+  // Updates an IAM policy for the specified bucket or managed folder.
   // The `resource` field in the request should be
   // `projects/_/buckets/{bucket}` for a bucket, or
   // `projects/_/buckets/{bucket}/managedFolders/{managedFolder}`
@@ -148,9 +230,8 @@ service Storage {
   }
 
   // Tests a set of permissions on the given bucket, object, or managed folder
-  // to see which, if any, are held by the caller.
-  // The `resource` field in the request should be
-  // `projects/_/buckets/{bucket}` for a bucket,
+  // to see which, if any, are held by the caller. The `resource` field in the
+  // request should be `projects/_/buckets/{bucket}` for a bucket,
   // `projects/_/buckets/{bucket}/objects/{object}` for an object, or
   // `projects/_/buckets/{bucket}/managedFolders/{managedFolder}`
   // for a managed folder.
@@ -170,7 +251,19 @@ service Storage {
     option (google.api.method_signature) = "resource,permissions";
   }
 
-  // Updates a bucket. Equivalent to JSON API's storage.buckets.patch method.
+  // Updates a bucket. Changes to the bucket are readable immediately after
+  // writing, but configuration changes might take time to propagate. This
+  // method supports `patch` semantics.
+  //
+  // **IAM Permissions**:
+  //
+  // Requires `storage.buckets.update` IAM permission on the bucket.
+  // Additionally, to enable specific bucket features, the authenticated user
+  // must have the following permissions:
+  //
+  // - To set bucket IP filtering rules: `storage.buckets.setIpFilter`
+  // - To update public access prevention policies or access control lists
+  // (ACLs): `storage.buckets.setIamPolicy`
   rpc UpdateBucket(UpdateBucketRequest) returns (Bucket) {
     option (google.api.routing) = {
       routing_parameters { field: "bucket.name" path_template: "{bucket=**}" }
@@ -179,7 +272,16 @@ service Storage {
   }
 
   // Concatenates a list of existing objects into a new object in the same
-  // bucket.
+  // bucket. The existing source objects are unaffected by this operation.
+  //
+  // **IAM Permissions**:
+  //
+  // Requires the `storage.objects.create` and `storage.objects.get` IAM
+  // permissions to use this method. If the new composite object
+  // overwrites an existing object, the authenticated user must also have
+  // the `storage.objects.delete` permission. If the request body includes
+  // the retention property, the authenticated user must also have the
+  // `storage.objects.setRetention` IAM permission.
   rpc ComposeObject(ComposeObjectRequest) returns (Object) {
     option (google.api.routing) = {
       routing_parameters {
@@ -191,7 +293,7 @@ service Storage {
 
   // Deletes an object and its metadata. Deletions are permanent if versioning
   // is not enabled for the bucket, or if the generation parameter is used, or
-  // if [soft delete](https://cloud.google.com/storage/docs/soft-delete) is not
+  // if soft delete is not
   // enabled for the bucket.
   // When this API is used to delete an object from a bucket that has soft
   // delete policy enabled, the object becomes soft deleted, and the
@@ -206,9 +308,7 @@ service Storage {
   //
   // **IAM Permissions**:
   //
-  // Requires `storage.objects.delete`
-  // [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
-  // the bucket.
+  // Requires `storage.objects.delete` IAM permission on the bucket.
   rpc DeleteObject(DeleteObjectRequest) returns (google.protobuf.Empty) {
     option (google.api.routing) = {
       routing_parameters { field: "bucket" path_template: "{bucket=**}" }
@@ -217,7 +317,43 @@ service Storage {
     option (google.api.method_signature) = "bucket,object,generation";
   }
 
-  // Restores a soft-deleted object.
+  // Restores a
+  // soft-deleted object.
+  // When a soft-deleted object is restored, a new copy of that object is
+  // created in the same bucket and inherits the same metadata as the
+  // soft-deleted object. The inherited metadata is the metadata that existed
+  // when the original object became soft deleted, with the following
+  // exceptions:
+  //
+  //   - The `createTime` of the new object is set to the time at which the
+  //   soft-deleted object was restored.
+  //   - The `softDeleteTime` and `hardDeleteTime` values are cleared.
+  //   - A new generation is assigned and the metageneration is reset to 1.
+  //   - If the soft-deleted object was in a bucket that had Autoclass enabled,
+  //   the new object is
+  //     restored to Standard storage.
+  //   - The restored object inherits the bucket's default object ACL, unless
+  //   `copySourceAcl` is `true`.
+  //
+  // If a live object using the same name already exists in the bucket and
+  // becomes overwritten, the live object becomes a noncurrent object if Object
+  // Versioning is enabled on the bucket. If Object Versioning is not enabled,
+  // the live object becomes soft deleted.
+  //
+  // **IAM Permissions**:
+  //
+  // Requires the following IAM permissions to use this method:
+  //
+  //   - `storage.objects.restore`
+  //   - `storage.objects.create`
+  //   - `storage.objects.delete` (only required if overwriting an existing
+  //   object)
+  //   - `storage.objects.getIamPolicy` (only required if `projection` is `full`
+  //   and the relevant bucket
+  //     has uniform bucket-level access disabled)
+  //   - `storage.objects.setIamPolicy` (only required if `copySourceAcl` is
+  //   `true` and the relevant
+  //     bucket has uniform bucket-level access disabled)
   rpc RestoreObject(RestoreObjectRequest) returns (Object) {
     option (google.api.routing) = {
       routing_parameters { field: "bucket" path_template: "{bucket=**}" }
@@ -228,9 +364,9 @@ service Storage {
   // Cancels an in-progress resumable upload.
   //
   // Any attempts to write to the resumable upload after cancelling the upload
-  // will fail.
+  // fail.
   //
-  // The behavior for currently in progress write operations is not guaranteed -
+  // The behavior for any in-progress write operations is not guaranteed;
   // they could either complete before the cancellation or fail if the
   // cancellation completes first.
   rpc CancelResumableWrite(CancelResumableWriteRequest)
@@ -248,9 +384,8 @@ service Storage {
   //
   // **IAM Permissions**:
   //
-  // Requires `storage.objects.get`
-  // [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
-  // the bucket. To return object ACLs, the authenticated user must also have
+  // Requires `storage.objects.get` IAM permission on the bucket.
+  // To return object ACLs, the authenticated user must also have
   // the `storage.objects.getIamPolicy` permission.
   rpc GetObject(GetObjectRequest) returns (Object) {
     option (google.api.routing) = {
@@ -264,9 +399,7 @@ service Storage {
   //
   // **IAM Permissions**:
   //
-  // Requires `storage.objects.get`
-  // [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
-  // the bucket.
+  // Requires `storage.objects.get` IAM permission on the bucket.
   rpc ReadObject(ReadObjectRequest) returns (stream ReadObjectResponse) {
     option (google.api.routing) = {
       routing_parameters { field: "bucket" path_template: "{bucket=**}" }
@@ -277,23 +410,18 @@ service Storage {
 
   // Reads an object's data.
   //
-  // This is a bi-directional API with the added support for reading multiple
-  // ranges within one stream both within and across multiple messages.
-  // If the server encountered an error for any of the inputs, the stream will
-  // be closed with the relevant error code.
-  // Because the API allows for multiple outstanding requests, when the stream
-  // is closed the error response will contain a BidiReadObjectRangesError proto
-  // in the error extension describing the error for each outstanding 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
+  // `BidiReadObjectRangesError` field detailing the specific error for
+  // each pending `read_id`.
   //
   // **IAM Permissions**:
   //
-  // Requires `storage.objects.get`
+  // Requires `storage.objects.get` IAM permission on the bucket.
   //
-  // [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
-  // the bucket.
-  //
-  // This API is currently in preview and is not yet available for general
-  // use.
   rpc BidiReadObject(stream BidiReadObjectRequest)
       returns (stream BidiReadObjectResponse) {
     option (google.api.routing) = {
@@ -305,7 +433,11 @@ service Storage {
   }
 
   // Updates an object's metadata.
-  // Equivalent to JSON API's storage.objects.patch.
+  // Equivalent to JSON API's `storage.objects.patch` method.
+  //
+  // **IAM Permissions**:
+  //
+  // Requires `storage.objects.update` IAM permission on the bucket.
   rpc UpdateObject(UpdateObjectRequest) returns (Object) {
     option (google.api.routing) = {
       routing_parameters { field: "object.bucket" path_template: "{bucket=**}" }
@@ -329,72 +461,73 @@ service Storage {
   // finishing the upload (either explicitly by the client or due to a network
   // error or an error response from the server), the client should do as
   // follows:
+  //
   //   - Check the result Status of the stream, to determine if writing can be
   //     resumed on this stream or must be restarted from scratch (by calling
-  //     `StartResumableWrite()`). The resumable errors are DEADLINE_EXCEEDED,
-  //     INTERNAL, and UNAVAILABLE. For each case, the client should use binary
-  //     exponential backoff before retrying.  Additionally, writes can be
-  //     resumed after RESOURCE_EXHAUSTED errors, but only after taking
-  //     appropriate measures, which may include reducing aggregate send rate
+  //     `StartResumableWrite()`). The resumable errors are `DEADLINE_EXCEEDED`,
+  //     `INTERNAL`, and `UNAVAILABLE`. For each case, the client should use
+  //     binary exponential backoff before retrying.  Additionally, writes can
+  //     be resumed after `RESOURCE_EXHAUSTED` errors, but only after taking
+  //     appropriate measures, which might include reducing aggregate send rate
   //     across clients and/or requesting a quota increase for your project.
   //   - If the call to `WriteObject` returns `ABORTED`, that indicates
   //     concurrent attempts to update the resumable write, caused either by
   //     multiple racing clients or by a single client where the previous
   //     request was timed out on the client side but nonetheless reached the
   //     server. In this case the client should take steps to prevent further
-  //     concurrent writes (e.g., increase the timeouts, stop using more than
-  //     one process to perform the upload, etc.), and then should follow the
-  //     steps below for resuming the upload.
+  //     concurrent writes. For example, increase the timeouts and stop using
+  //     more than one process to perform the upload. Follow the steps below for
+  //     resuming the upload.
   //   - For resumable errors, the client should call `QueryWriteStatus()` and
-  //     then continue writing from the returned `persisted_size`. This may be
+  //     then continue writing from the returned `persisted_size`. This might be
   //     less than the amount of data the client previously sent. Note also that
   //     it is acceptable to send data starting at an offset earlier than the
-  //     returned `persisted_size`; in this case, the service will skip data at
+  //     returned `persisted_size`; in this case, the service skips data at
   //     offsets that were already persisted (without checking that it matches
   //     the previously written data), and write only the data starting from the
-  //     persisted offset. Even though the data isn't written, it may still
+  //     persisted offset. Even though the data isn't written, it might still
   //     incur a performance cost over resuming at the correct write offset.
   //     This behavior can make client-side handling simpler in some cases.
   //   - Clients must only send data that is a multiple of 256 KiB per message,
   //     unless the object is being finished with `finish_write` set to `true`.
   //
-  // The service will not view the object as complete until the client has
+  // The service does not view the object as complete until the client has
   // sent a `WriteObjectRequest` with `finish_write` set to `true`. Sending any
   // requests on a stream after sending a request with `finish_write` set to
-  // `true` will cause an error. The client **should** check the response it
-  // receives to determine how much data the service was able to commit and
+  // `true` causes an error. The client must check the response it
+  // receives to determine how much data the service is able to commit and
   // whether the service views the object as complete.
   //
-  // Attempting to resume an already finalized object will result in an OK
+  // Attempting to resume an already finalized object results in an `OK`
   // status, with a `WriteObjectResponse` containing the finalized object's
   // metadata.
   //
-  // Alternatively, the BidiWriteObject operation may be used to write an
+  // Alternatively, you can use the `BidiWriteObject` operation to write an
   // object with controls over flushing and the ability to fetch the ability to
   // determine the current persisted size.
   //
   // **IAM Permissions**:
   //
   // Requires `storage.objects.create`
-  // [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
+  // IAM permission on
   // the bucket.
   rpc WriteObject(stream WriteObjectRequest) returns (WriteObjectResponse) {}
 
   // Stores a new object and metadata.
   //
-  // This is similar to the WriteObject call with the added support for
+  // This is similar to the `WriteObject` call with the added support for
   // manual flushing of persisted state, and the ability to determine current
   // persisted size without closing the stream.
   //
-  // The client may specify one or both of the `state_lookup` and `flush` fields
-  // in each BidiWriteObjectRequest. If `flush` is specified, the data written
-  // so far will be persisted to storage. If `state_lookup` is specified, the
-  // service will respond with a BidiWriteObjectResponse that contains the
+  // The client might specify one or both of the `state_lookup` and `flush`
+  // fields in each `BidiWriteObjectRequest`. If `flush` is specified, the data
+  // written so far is persisted to storage. If `state_lookup` is specified, the
+  // service responds with a `BidiWriteObjectResponse` that contains the
   // persisted size. If both `flush` and `state_lookup` are specified, the flush
-  // will always occur before a `state_lookup`, so that both may be set in the
-  // same request and the returned state will be the state of the object
-  // post-flush. When the stream is closed, a BidiWriteObjectResponse will
-  // always be sent to the client, regardless of the value of `state_lookup`.
+  // always occurs before a `state_lookup`, so that both might be set in the
+  // same request and the returned state is the state of the object
+  // post-flush. When the stream is closed, a `BidiWriteObjectResponse`
+  // is always sent to the client, regardless of the value of `state_lookup`.
   rpc BidiWriteObject(stream BidiWriteObjectRequest)
       returns (stream BidiWriteObjectResponse) {}
 
@@ -403,8 +536,8 @@ service Storage {
   // **IAM Permissions**:
   //
   // The authenticated user requires `storage.objects.list`
-  // [IAM permission](https://cloud.google.com/iam/docs/overview#permissions)
-  // to use this method. To return object ACLs, the authenticated user must also
+  // IAM permission to use this method. To return object ACLs, the
+  // authenticated user must also
   // have the `storage.objects.getIamPolicy` permission.
   rpc ListObjects(ListObjectsRequest) returns (ListObjectsResponse) {
     option (google.api.routing) = {
@@ -426,8 +559,8 @@ service Storage {
   }
 
   // Starts a resumable write operation. This
-  // method is part of the [Resumable
-  // upload](https://cloud.google.com/storage/docs/resumable-uploads) feature.
+  // method is part of the Resumable
+  // upload feature.
   // This allows you to upload large objects in multiple chunks, which is more
   // resilient to network interruptions than a single upload. The validity
   // duration of the write operation, and the consequences of it becoming
@@ -435,9 +568,7 @@ service Storage {
   //
   // **IAM Permissions**:
   //
-  // Requires `storage.objects.create`
-  // [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
-  // the bucket.
+  // Requires `storage.objects.create` IAM permission on the bucket.
   rpc StartResumableWrite(StartResumableWriteRequest)
       returns (StartResumableWriteResponse) {
     option (google.api.routing) = {
@@ -449,8 +580,8 @@ service Storage {
   }
 
   // Determines the `persisted_size` of an object that is being written. This
-  // method is part of the [resumable
-  // upload](https://cloud.google.com/storage/docs/resumable-uploads) feature.
+  // method is part of the resumable
+  // upload feature.
   // The returned value is the size of the object that has been persisted so
   // far. The value can be used as the `write_offset` for the next `Write()`
   // call.
@@ -477,6 +608,19 @@ service Storage {
   }
 
   // Moves the source object to the destination object in the same bucket.
+  // This operation moves a source object to a destination object in the
+  // same bucket by renaming the object. The move itself is an atomic
+  // transaction, ensuring all steps either complete successfully or no
+  // changes are made.
+  //
+  // **IAM Permissions**:
+  //
+  // Requires the following IAM permissions to use this method:
+  //
+  //   - `storage.objects.move`
+  //   - `storage.objects.create`
+  //   - `storage.objects.delete` (only required if overwriting an existing
+  //   object)
   rpc MoveObject(MoveObjectRequest) returns (Object) {
     option (google.api.routing) = {
       routing_parameters { field: "bucket" path_template: "{bucket=**}" }
@@ -486,7 +630,7 @@ service Storage {
   }
 }
 
-// Request message for DeleteBucket.
+// Request message for [DeleteBucket][google.storage.v2.Storage.DeleteBucket].
 message DeleteBucketRequest {
   // Required. Name of a bucket to delete.
   string name = 1 [
@@ -502,7 +646,7 @@ message DeleteBucketRequest {
   optional int64 if_metageneration_not_match = 3;
 }
 
-// Request message for GetBucket.
+// Request message for [GetBucket][google.storage.v2.Storage.GetBucket].
 message GetBucketRequest {
   // Required. Name of a bucket.
   string name = 1 [
@@ -510,25 +654,25 @@ message GetBucketRequest {
     (google.api.resource_reference) = { type: "storage.googleapis.com/Bucket" }
   ];
 
-  // If set, and if the bucket's current metageneration does not match the
-  // specified value, the request will return an error.
+  // If set, only gets the bucket metadata if its metageneration matches this
+  // value.
   optional int64 if_metageneration_match = 2;
 
   // If set, and if the bucket's current metageneration matches the specified
-  // value, the request will return an error.
+  // value, the request returns an error.
   optional int64 if_metageneration_not_match = 3;
 
   // Mask specifying which fields to read.
-  // A "*" field may be used to indicate all fields.
-  // If no mask is specified, will default to all fields.
+  // A `*` field might be used to indicate all fields.
+  // If no mask is specified, it defaults to all fields.
   optional google.protobuf.FieldMask read_mask = 5;
 }
 
-// Request message for CreateBucket.
+// Request message for [CreateBucket][google.storage.v2.Storage.CreateBucket].
 message CreateBucketRequest {
-  // Required. The project to which this bucket will belong. This field must
-  // either be empty or `projects/_`. The project ID that owns this bucket
-  // should be specified in the `bucket.project` field.
+  // Required. The project to which this bucket belongs. This field must either
+  // be empty or `projects/_`. The project ID that owns this bucket should be
+  // specified in the `bucket.project` field.
   string parent = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -538,26 +682,26 @@ message CreateBucketRequest {
 
   // Optional. Properties of the new bucket being inserted.
   // The name of the bucket is specified in the `bucket_id` field. Populating
-  // `bucket.name` field will result in an error.
+  // `bucket.name` field results in an error.
   // The project of the bucket must be specified in the `bucket.project` field.
   // This field must be in `projects/{projectIdentifier}` format,
   // {projectIdentifier} can be the project ID or project number. The `parent`
   // field must be either empty or `projects/_`.
   Bucket bucket = 2 [(google.api.field_behavior) = OPTIONAL];
 
-  // Required. The ID to use for this bucket, which will become the final
-  // component of the bucket's resource name. For example, the value `foo` might
-  // result in a bucket with the name `projects/123456/buckets/foo`.
+  // Required. The ID to use for this bucket, which becomes the final component
+  // of the bucket's resource name. For example, the value `foo` might result in
+  // a bucket with the name `projects/123456/buckets/foo`.
   string bucket_id = 3 [(google.api.field_behavior) = REQUIRED];
 
   // Optional. Apply a predefined set of access controls to this bucket.
-  // Valid values are "authenticatedRead", "private", "projectPrivate",
-  // "publicRead", or "publicReadWrite".
+  // Valid values are `authenticatedRead`, `private`, `projectPrivate`,
+  // `publicRead`, or `publicReadWrite`.
   string predefined_acl = 6 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Apply a predefined set of default object access controls to this
-  // bucket. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-  // "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+  // bucket. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+  // `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
   string predefined_default_object_acl = 7
       [(google.api.field_behavior) = OPTIONAL];
 
@@ -565,7 +709,7 @@ message CreateBucketRequest {
   bool enable_object_retention = 9 [(google.api.field_behavior) = OPTIONAL];
 }
 
-// Request message for ListBuckets.
+// Request message for [ListBuckets][google.storage.v2.Storage.ListBuckets].
 message ListBucketsRequest {
   // Required. The project whose buckets we are listing.
   string parent = 1 [
@@ -576,9 +720,9 @@ message ListBucketsRequest {
   ];
 
   // Optional. Maximum number of buckets to return in a single response. The
-  // service will use this parameter or 1,000 items, whichever is smaller. If
-  // "acl" is present in the read_mask, the service will use this parameter of
-  // 200 items, whichever is smaller.
+  // service uses this parameter or `1,000` items, whichever is smaller. If
+  // `acl` is present in the `read_mask`, the service uses this parameter of
+  // `200` items, whichever is smaller.
   int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. A previously-returned page token representing part of the larger
@@ -589,13 +733,17 @@ message ListBucketsRequest {
   string prefix = 4 [(google.api.field_behavior) = OPTIONAL];
 
   // Mask specifying which fields to read from each result.
-  // If no mask is specified, will default to all fields except items.owner,
-  // items.acl, and items.default_object_acl.
-  // * may be used to mean "all fields".
+  // If no mask is specified, it defaults to all fields except `items.
+  // owner`, `items.acl`, and `items.default_object_acl`.
+  // `*` might be used to mean "all fields".
   optional google.protobuf.FieldMask read_mask = 5;
+
+  // Optional. Allows listing of buckets, even if there are buckets that are
+  // unreachable.
+  bool return_partial_success = 9 [(google.api.field_behavior) = OPTIONAL];
 }
 
-// The result of a call to Buckets.ListBuckets
+// Response message for [ListBuckets][google.storage.v2.Storage.ListBuckets].
 message ListBucketsResponse {
   // The list of items.
   repeated Bucket buckets = 1;
@@ -603,9 +751,22 @@ message ListBucketsResponse {
   // The continuation token, used to page through large result sets. Provide
   // this value in a subsequent request to return the next page of results.
   string next_page_token = 2;
+
+  // Unreachable resources.
+  // This field can only be present if the caller specified
+  // return_partial_success to be true in the request to receive indications
+  // of temporarily missing resources.
+  // unreachable might be:
+  // unreachable = [
+  //  "projects/_/buckets/bucket1",
+  //  "projects/_/buckets/bucket2",
+  //  "projects/_/buckets/bucket3",
+  // ]
+  repeated string unreachable = 3;
 }
 
-// Request message for LockBucketRetentionPolicyRequest.
+// Request message for
+// [LockBucketRetentionPolicy][google.storage.v2.Storage.LockBucketRetentionPolicy].
 message LockBucketRetentionPolicyRequest {
   // Required. Name of a bucket.
   string bucket = 1 [
@@ -618,28 +779,28 @@ message LockBucketRetentionPolicyRequest {
   int64 if_metageneration_match = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
-// Request for UpdateBucket method.
+// Request for [UpdateBucket][google.storage.v2.Storage.UpdateBucket] method.
 message UpdateBucketRequest {
   // Required. The bucket to update.
-  // The bucket's `name` field will be used to identify the bucket.
+  // The bucket's `name` field is used to identify the bucket.
   Bucket bucket = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // If set, will only modify the bucket if its metageneration matches this
+  // If set, the request modifies the bucket if its metageneration matches this
   // value.
   optional int64 if_metageneration_match = 2;
 
-  // If set, will only modify the bucket if its metageneration does not match
-  // this value.
+  // If set, the request modifies the bucket if its metageneration doesn't
+  // match this value.
   optional int64 if_metageneration_not_match = 3;
 
   // Optional. Apply a predefined set of access controls to this bucket.
-  // Valid values are "authenticatedRead", "private", "projectPrivate",
-  // "publicRead", or "publicReadWrite".
+  // Valid values are `authenticatedRead`, `private`, `projectPrivate`,
+  // `publicRead`, or `publicReadWrite`.
   string predefined_acl = 8 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Apply a predefined set of default object access controls to this
-  // bucket. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-  // "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+  // bucket. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+  // `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
   string predefined_default_object_acl = 9
       [(google.api.field_behavior) = OPTIONAL];
 
@@ -648,14 +809,14 @@ message UpdateBucketRequest {
   // To specify ALL fields, equivalent to the JSON API's "update" function,
   // specify a single field with the value `*`. Note: not recommended. If a new
   // field is introduced at a later time, an older client updating with the `*`
-  // may accidentally reset the new field's value.
+  // might accidentally reset the new field's value.
   //
   // Not specifying any fields is an error.
   google.protobuf.FieldMask update_mask = 6
       [(google.api.field_behavior) = REQUIRED];
 }
 
-// Request message for ComposeObject.
+// Request message for [ComposeObject][google.storage.v2.Storage.ComposeObject].
 message ComposeObjectRequest {
   // Description of a source object for a composition request.
   message SourceObject {
@@ -663,7 +824,7 @@ message ComposeObjectRequest {
     message ObjectPreconditions {
       // Only perform the composition if the generation of the source object
       // that would be used matches this value.  If this value and a generation
-      // are both specified, they must be the same value or the call will fail.
+      // are both specified, they must be the same value or the call fails.
       optional int64 if_generation_match = 1;
     }
 
@@ -682,14 +843,14 @@ message ComposeObjectRequest {
   // Required. Properties of the resulting object.
   Object destination = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // Optional. The list of source objects that will be concatenated into a
-  // single object.
+  // Optional. The list of source objects that is concatenated into a single
+  // object.
   repeated SourceObject source_objects = 2
       [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Apply a predefined set of access controls to the destination
-  // object. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-  // "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+  // object. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+  // `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
   string destination_predefined_acl = 9
       [(google.api.field_behavior) = OPTIONAL];
 
@@ -704,7 +865,7 @@ message ComposeObjectRequest {
 
   // Optional. Resource name of the Cloud KMS key, of the form
   // `projects/my-project/locations/my-location/keyRings/my-kr/cryptoKeys/my-key`,
-  // that will be used to encrypt the object. Overrides the object
+  // that is used to encrypt the object. Overrides the object
   // metadata's `kms_key_name` value, if any.
   string kms_key = 6 [
     (google.api.field_behavior) = OPTIONAL,
@@ -718,14 +879,13 @@ message ComposeObjectRequest {
   CommonObjectRequestParams common_object_request_params = 7
       [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. The checksums of the complete object. This will be validated
-  // against the combined checksums of the component objects.
+  // Optional. The checksums of the complete object. This is validated against
+  // the combined checksums of the component objects.
   ObjectChecksums object_checksums = 10
       [(google.api.field_behavior) = OPTIONAL];
 }
 
-// Message for deleting an object.
-// `bucket` and `object` **must** be set.
+// Request message for deleting an object.
 message DeleteObjectRequest {
   // Required. Name of the bucket in which the object resides.
   string bucket = 1 [
@@ -767,7 +927,8 @@ message DeleteObjectRequest {
       [(google.api.field_behavior) = OPTIONAL];
 }
 
-// Message for restoring an object.
+// Request message for
+// [RestoreObject][google.storage.v2.Storage.RestoreObject].
 // `bucket`, `object`, and `generation` **must** be set.
 message RestoreObjectRequest {
   // Required. Name of the bucket in which the object resides.
@@ -808,7 +969,7 @@ message RestoreObjectRequest {
   // metageneration does not match the given value.
   optional int64 if_metageneration_not_match = 7;
 
-  // If false or unset, the bucket's default object ACL will be used.
+  // If false or unset, the bucket's default object ACL is used.
   // If true, copy the source object's access controls.
   // Return an error if bucket has UBLA enabled.
   optional bool copy_source_acl = 9;
@@ -819,19 +980,19 @@ message RestoreObjectRequest {
       [(google.api.field_behavior) = OPTIONAL];
 }
 
-// Message for canceling an in-progress resumable upload.
-// `upload_id` **must** be set.
+// Request message for
+// [CancelResumableWrite][google.storage.v2.Storage.CancelResumableWrite].
 message CancelResumableWriteRequest {
   // Required. The upload_id of the resumable upload to cancel. This should be
   // copied from the `upload_id` field of `StartResumableWriteResponse`.
   string upload_id = 1 [(google.api.field_behavior) = REQUIRED];
 }
 
-// Empty response message for canceling an in-progress resumable upload, will be
+// Empty response message for canceling an in-progress resumable upload, is
 // extended as needed.
 message CancelResumableWriteResponse {}
 
-// Request message for ReadObject.
+// Request message for [ReadObject][google.storage.v2.Storage.ReadObject].
 message ReadObjectRequest {
   // Required. The name of the bucket containing the object to read.
   string bucket = 1 [
@@ -849,17 +1010,17 @@ message ReadObjectRequest {
   // Optional. The offset for the first byte to return in the read, relative to
   // the start of the object.
   //
-  // A negative `read_offset` value will be interpreted as the number of bytes
+  // A negative `read_offset` value is interpreted as the number of bytes
   // back from the end of the object to be returned. For example, if an object's
-  // length is 15 bytes, a ReadObjectRequest with `read_offset` = -5 and
-  // `read_limit` = 3 would return bytes 10 through 12 of the object. Requesting
-  // a negative offset with magnitude larger than the size of the object will
-  // return the entire object.
+  // length is `15` bytes, a `ReadObjectRequest` with `read_offset` = `-5` and
+  // `read_limit` = `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.
   int64 read_offset = 4 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. The maximum number of `data` bytes the server is allowed to
   // return in the sum of all `Object` messages. A `read_limit` of zero
-  // indicates that there is no limit, and a negative `read_limit` will cause an
+  // indicates that there is no limit, and a negative `read_limit` causes an
   // error.
   //
   // If the stream returns fewer bytes than allowed by the `read_limit` and no
@@ -892,14 +1053,14 @@ message ReadObjectRequest {
       [(google.api.field_behavior) = OPTIONAL];
 
   // Mask specifying which fields to read.
-  // The checksummed_data field and its children will always be present.
-  // If no mask is specified, will default to all fields except metadata.owner
-  // and metadata.acl.
-  // * may be used to mean "all fields".
+  // The `checksummed_data` field and its children are always present.
+  // If no mask is specified, it defaults to all fields except `metadata.
+  // owner` and `metadata.acl`.
+  // `*` might be used to mean "all fields".
   optional google.protobuf.FieldMask read_mask = 12;
 }
 
-// Request message for GetObject.
+// Request message for [GetObject][google.storage.v2.Storage.GetObject].
 message GetObjectRequest {
   // Required. Name of the bucket in which the object resides.
   string bucket = 1 [
@@ -942,22 +1103,22 @@ message GetObjectRequest {
       [(google.api.field_behavior) = OPTIONAL];
 
   // Mask specifying which fields to read.
-  // If no mask is specified, will default to all fields except metadata.acl and
-  // metadata.owner.
-  // * may be used to mean "all fields".
+  // If no mask is specified, it defaults to all fields except `metadata.
+  // acl` and `metadata.owner`.
+  // `*` might be used to mean "all fields".
   optional google.protobuf.FieldMask read_mask = 10;
 
   // Optional. Restore token used to differentiate soft-deleted objects with the
   // same name and generation. Only applicable for hierarchical namespace
-  // buckets and if soft_deleted is set to true. This parameter is optional, and
-  // is only required in the rare case when there are multiple soft-deleted
-  // objects with the same name and generation.
+  // buckets and if `soft_deleted` is set to `true`. This parameter is optional,
+  // and is only required in the rare case when there are multiple soft-deleted
+  // objects with the same `name` and `generation`.
   string restore_token = 12 [(google.api.field_behavior) = OPTIONAL];
 }
 
-// Response message for ReadObject.
+// Response message for [ReadObject][google.storage.v2.Storage.ReadObject].
 message ReadObjectResponse {
-  // A portion of the data for the object. The service **may** leave `data`
+  // A portion of the data for the object. The service might leave `data`
   // empty for any given `ReadResponse`. This enables the service to inform the
   // client that the request is still live while it is running an operation to
   // generate more data.
@@ -968,9 +1129,9 @@ message ReadObjectResponse {
   // and compare it against the value provided here.
   ObjectChecksums object_checksums = 2;
 
-  // If read_offset and or read_limit was specified on the
-  // ReadObjectRequest, ContentRange will be populated on the first
-  // ReadObjectResponse message of the read stream.
+  // If `read_offset` and or `read_limit` is specified on the
+  // `ReadObjectRequest`, `ContentRange` is populated on the first
+  // `ReadObjectResponse` message of the read stream.
   ContentRange content_range = 3;
 
   // Metadata of the object whose media is being returned.
@@ -1018,13 +1179,12 @@ message BidiReadObjectSpec {
       [(google.api.field_behavior) = OPTIONAL];
 
   // Mask specifying which fields to read.
-  // The checksummed_data field and its children will always be present.
-  // If no mask is specified, will default to all fields except metadata.owner
-  // and metadata.acl.
-  // * may be used to mean "all fields".
+  // The `checksummed_data` field and its children are always present.
+  // If no mask is specified, it defaults to all fields except `metadata.
+  // owner` and `metadata.acl`.
+  // `*` might be used to mean "all fields".
   // As per https://google.aip.dev/161, this field is deprecated.
-  // As an alternative, grpc metadata can be used:
-  // https://cloud.google.com/apis/docs/system-parameters#definitions
+  // As an alternative, `grpc metadata` can be used:
   optional google.protobuf.FieldMask read_mask = 12 [deprecated = true];
 
   // The client can optionally set this field. The read handle is an optimized
@@ -1037,32 +1197,34 @@ message BidiReadObjectSpec {
   optional string routing_token = 14;
 }
 
-// Request message for BidiReadObject.
+// Request message for
+// [BidiReadObject][google.storage.v2.Storage.BidiReadObject].
 message BidiReadObjectRequest {
   // Optional. The first message of each stream should set this field. If this
-  // is not the first message, an error will be returned. Describes the object
-  // to read.
+  // is not the first message, an error is returned. Describes the object to
+  // read.
   BidiReadObjectSpec read_object_spec = 1
       [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
   // single range is large enough to require multiple responses, they are
-  // guaranteed to be delivered in increasing offset order. There are no
-  // ordering guarantees across ranges. When no ranges are provided, the
-  // response message will not include ObjectRangeData. For full object
-  // downloads, the offset and size can be set to 0.
+  // delivered in increasing offset order. There are no ordering guarantees
+  // across ranges. When no ranges are provided, the response message
+  // doesn't  include `ObjectRangeData`. For full object downloads, the
+  // offset and size can be set to `0`.
   repeated ReadRange read_ranges = 8 [(google.api.field_behavior) = OPTIONAL];
 }
 
-// Response message for BidiReadObject.
+// Response message for
+// [BidiReadObject][google.storage.v2.Storage.BidiReadObject].
 message BidiReadObjectResponse {
-  // A portion of the object's data. The service **may** leave data
-  // empty for any given ReadResponse. This enables the service to inform the
+  // A portion of the object's data. The service might leave data
+  // empty for any given `ReadResponse`. This enables the service to inform the
   // client that the request is still live while it is running an operation to
   // generate more data.
-  // The service **may** pipeline multiple responses belonging to different read
-  // requests. Each ObjectRangeData entry will have a read_id
-  // set to the same value as the corresponding source read request.
+  // The service might pipeline multiple responses belonging to different read
+  // requests. Each `ObjectRangeData` entry has a `read_id` that is set
+  // to the same value as the corresponding source read request.
   repeated ObjectRangeData object_data_ranges = 6;
 
   // Metadata of the object whose media is being returned.
@@ -1070,17 +1232,17 @@ message BidiReadObjectResponse {
   // the stream is opened with a read handle.
   Object metadata = 4;
 
-  // This field will be periodically refreshed, however it may not be set in
+  // This field is periodically refreshed, however it might not be set in
   // every response. It allows the client to more efficiently open subsequent
   // bidirectional streams to the same object.
   BidiReadHandle read_handle = 7;
 }
 
-// Error proto containing details for a redirected read. This error may be
+// Error proto containing details for a redirected read. This error might be
 // attached as details for an ABORTED response to BidiReadObject.
 message BidiReadObjectRedirectedError {
-  // The read handle for the redirected read. If set, the client may use this in
-  // the BidiReadObjectSpec when retrying the read stream.
+  // The read handle for the redirected read. If set, the client might use this
+  // in the BidiReadObjectSpec when retrying the read stream.
   BidiReadHandle read_handle = 1;
 
   // The routing token the client must use when retrying the read stream.
@@ -1089,7 +1251,7 @@ message BidiReadObjectRedirectedError {
   optional string routing_token = 2;
 }
 
-// Error proto containing details for a redirected write. This error may be
+// Error proto containing details for a redirected write. This error might be
 // attached as details for an ABORTED response to BidiWriteObject.
 message BidiWriteObjectRedirectedError {
   // The routing token the client must use when retrying the write stream.
@@ -1099,12 +1261,12 @@ message BidiWriteObjectRedirectedError {
 
   // Opaque value describing a previous write. If set, the client must use this
   // in an AppendObjectSpec first_message when retrying the write stream. If not
-  // set, clients may retry the original request.
+  // set, clients might retry the original request.
   optional BidiWriteHandle write_handle = 2;
 
-  // The generation of the object that triggered the redirect. This will be set
-  // iff write_handle is set. If set, the client must use this in an
-  // AppendObjectSpec first_message when retrying the write stream.
+  // The generation of the object that triggered the redirect. This is set
+  // iff `write_handle` is set. If set, the client must use this in an
+  // `AppendObjectSpec` first_message when retrying the write stream.
   optional int64 generation = 3;
 }
 
@@ -1124,33 +1286,33 @@ message ReadRangeError {
   google.rpc.Status status = 2;
 }
 
-// Describes a range of bytes to read in a BidiReadObjectRanges request.
+// Describes a range of bytes to read in a `BidiReadObjectRanges` request.
 message ReadRange {
   // Required. The offset for the first byte to return in the read, relative to
   // the start of the object.
   //
-  // A negative read_offset value will be interpreted as the number of bytes
+  // A negative read_offset value is interpreted as the number of bytes
   // back from the end of the object to be returned. For example, if an object's
-  // 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 will
-  // return the entire object. A read_offset larger than the size of the object
-  // will result in an OutOfRange error.
+  // 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.
   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 will
-  // cause 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.
+  // 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.
   int64 read_length = 2 [(google.api.field_behavior) = OPTIONAL];
 
   // Required. Read identifier provided by the client. When the client issues
-  // more than one outstanding ReadRange on the same stream, responses can be
+  // more than one outstanding `ReadRange` on the same stream, responses can be
   // mapped back to their corresponding requests using this value. Clients must
   // ensure that all outstanding requests have different read_id values. The
-  // server may close the stream with an error if this condition is not met.
+  // server might close the stream with an error if this condition is not met.
   int64 read_id = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
@@ -1159,28 +1321,28 @@ message ObjectRangeData {
   // A portion of the data for the object.
   ChecksummedData checksummed_data = 1;
 
-  // The ReadRange describes the content being returned with read_id set to the
-  // corresponding ReadObjectRequest in the stream. Multiple ObjectRangeData
-  // messages may have the same read_id but increasing offsets.
-  // ReadObjectResponse messages with the same read_id are guaranteed to be
-  // delivered in increasing offset order.
+  // The `ReadRange` describes the content being returned with `read_id` set to
+  // the corresponding `ReadObjectRequest` in the stream. Multiple
+  // `ObjectRangeData` messages might have the same read_id but increasing
+  // offsets. `ReadObjectResponse` messages with the same `read_id` are
+  // guaranteed to be delivered in increasing offset order.
   ReadRange read_range = 2;
 
   // If set, indicates there are no more bytes to read for the given ReadRange.
   bool range_end = 3;
 }
 
-// BidiReadHandle contains a handle from a previous BiDiReadObject
-// invocation. The client can use this instead of BidiReadObjectSpec as an
+// `BidiReadHandle` contains a handle from a previous `BiDiReadObject`
+// invocation. The client can use this instead of `BidiReadObjectSpec` as an
 // optimized way of opening subsequent bidirectional streams to the same object.
 message BidiReadHandle {
   // Required. Opaque value describing a previous read.
   bytes handle = 1 [(google.api.field_behavior) = REQUIRED];
 }
 
-// BidiWriteHandle contains a handle from a previous BidiWriteObject
-// invocation. The client can use this as an optimized way of opening subsequent
-// bidirectional streams to the same object.
+// `BidiWriteHandle` contains a handle from a previous `BidiWriteObject`
+// invocation. The client can use this instead of `BidiReadObjectSpec` as an
+// optimized way of opening subsequent bidirectional streams to the same object.
 message BidiWriteHandle {
   // Required. Opaque value describing a previous write.
   bytes handle = 1 [(google.api.field_behavior) = REQUIRED];
@@ -1192,18 +1354,18 @@ message WriteObjectSpec {
   Object resource = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Optional. Apply a predefined set of access controls to this object.
-  // Valid values are "authenticatedRead", "bucketOwnerFullControl",
-  // "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+  // Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+  // `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
   string predefined_acl = 7 [(google.api.field_behavior) = OPTIONAL];
 
   // Makes the operation conditional on whether the object's current
-  // generation matches the given value. Setting to 0 makes the operation
+  // generation matches the given value. Setting to `0` makes the operation
   // succeed only if there are no live versions of the object.
   optional int64 if_generation_match = 3;
 
   // Makes the operation conditional on whether the object's live
   // generation does not match the given value. If no live object exists, the
-  // precondition fails. Setting to 0 makes the operation succeed only if
+  // precondition fails. Setting to `0` makes the operation succeed only if
   // there is a live version of the object.
   optional int64 if_generation_not_match = 4;
 
@@ -1217,19 +1379,19 @@ message WriteObjectSpec {
 
   // The expected final object size being uploaded.
   // If this value is set, closing the stream after writing fewer or more than
-  // `object_size` bytes will result in an OUT_OF_RANGE error.
+  // `object_size` bytes results in an `OUT_OF_RANGE` error.
   //
   // This situation is considered a client error, and if such an error occurs
   // you must start the upload over from scratch, this time sending the correct
   // number of bytes.
   optional int64 object_size = 8;
 
-  // If true, the object will be created in appendable mode.
-  // This field may only be set when using BidiWriteObject.
+  // If `true`, the object is created in appendable mode.
+  // This field might only be set when using `BidiWriteObject`.
   optional bool appendable = 9;
 }
 
-// Request message for WriteObject.
+// Request message for [WriteObject][google.storage.v2.Storage.WriteObject].
 message WriteObjectRequest {
   // The first message of each stream should set one of the following.
   oneof first_message {
@@ -1254,39 +1416,40 @@ message WriteObjectRequest {
   // first `write_offset` and the sizes of all `data` chunks sent previously on
   // this stream.
   //
-  // An incorrect value will cause an error.
+  // An incorrect value causes an error.
   int64 write_offset = 3 [(google.api.field_behavior) = REQUIRED];
 
   // A portion of the data for the object.
   oneof data {
     // The data to insert. If a crc32c checksum is provided that doesn't match
-    // the checksum computed by the service, the request will fail.
+    // the checksum computed by the service, the request fails.
     ChecksummedData checksummed_data = 4;
   }
 
   // Optional. Checksums for the complete object. If the checksums computed by
-  // the service don't match the specified checksums the call will fail. May
-  // only be provided in the first or last request (either with first_message,
-  // or finish_write set).
+  // the service don't match the specified checksums the call fails. This field
+  // might only be provided in the first or last request (either with
+  // `first_message`, or `finish_write` set).
   ObjectChecksums object_checksums = 6 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. If `true`, this indicates that the write is complete. Sending any
   // `WriteObjectRequest`s subsequent to one in which `finish_write` is `true`
-  // will cause an error.
-  // For a non-resumable write (where the upload_id was not set in the first
+  // causes an error.
+  // For a non-resumable write (where the `upload_id` was not set in the first
   // message), it is an error not to set this field in the final message of the
   // stream.
   bool finish_write = 7 [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. A set of parameters common to Storage API requests concerning an
-  // object.
+  // Optional. A set of parameters common to Cloud Storage API requests
+  // concerning an object.
   CommonObjectRequestParams common_object_request_params = 8
       [(google.api.field_behavior) = OPTIONAL];
 }
 
-// Response message for WriteObject.
+// Response message for
+// [WriteObject][google.storage.v2.Storage.WriteObject].
 message WriteObjectResponse {
-  // The response will set one of the following.
+  // The response sets one of the following.
   oneof write_status {
     // The total number of bytes that have been processed for the given object
     // from all `WriteObject` calls. Only set if the upload has not finalized.
@@ -1327,7 +1490,7 @@ message AppendObjectSpec {
   optional int64 if_metageneration_not_match = 5;
 
   // An optional routing token that influences request routing for the stream.
-  // Must be provided if a BidiWriteObjectRedirectedError is returned.
+  // Must be provided if a `BidiWriteObjectRedirectedError` is returned.
   optional string routing_token = 6;
 
   // An optional write handle returned from a previous BidiWriteObjectResponse
@@ -1338,7 +1501,8 @@ message AppendObjectSpec {
   optional BidiWriteHandle write_handle = 7;
 }
 
-// Request message for BidiWriteObject.
+// Request message for
+// [BidiWriteObject][google.storage.v2.Storage.BidiWriteObject].
 message BidiWriteObjectRequest {
   // The first message of each stream should set one of the following.
   oneof first_message {
@@ -1358,43 +1522,43 @@ message BidiWriteObjectRequest {
   // should be written.
   //
   // In the first `WriteObjectRequest` of a `WriteObject()` action, it
-  // indicates the initial offset for the `Write()` call. The value **must** be
+  // indicates the initial offset for the `Write()` call. The value must be
   // equal to the `persisted_size` that a call to `QueryWriteStatus()` would
   // return (0 if this is the first write to the object).
   //
-  // On subsequent calls, this value **must** be no larger than the sum of the
+  // On subsequent calls, this value must be no larger than the sum of the
   // first `write_offset` and the sizes of all `data` chunks sent previously on
   // this stream.
   //
-  // An invalid value will cause an error.
+  // An invalid value causes an error.
   int64 write_offset = 3 [(google.api.field_behavior) = REQUIRED];
 
   // A portion of the data for the object.
   oneof data {
     // The data to insert. If a crc32c checksum is provided that doesn't match
-    // the checksum computed by the service, the request will fail.
+    // the checksum computed by the service, the request fails.
     ChecksummedData checksummed_data = 4;
   }
 
   // Optional. Checksums for the complete object. If the checksums computed by
-  // the service don't match the specified checksums the call will fail. May
-  // only be provided in the first request or the last request (with
-  // finish_write set).
+  // the service don't match the specified checksums the call fails. Might only
+  // be provided in the first request or the last request (with finish_write
+  // set).
   ObjectChecksums object_checksums = 6 [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. For each BidiWriteObjectRequest where state_lookup is `true` or
-  // the client closes the stream, the service will send a
-  // BidiWriteObjectResponse containing the current persisted size. The
+  // Optional. For each `BidiWriteObjectRequest` where `state_lookup` is `true`
+  // or the client closes the stream, the service sends a
+  // `BidiWriteObjectResponse` containing the current persisted size. The
   // persisted size sent in responses covers all the bytes the server has
   // persisted thus far and can be used to decide what data is safe for the
   // client to drop. Note that the object's current size reported by the
-  // BidiWriteObjectResponse may lag behind the number of bytes written by the
-  // client. This field is ignored if `finish_write` is set to true.
+  // `BidiWriteObjectResponse` might lag behind the number of bytes written by
+  // the client. This field is ignored if `finish_write` is set to true.
   bool state_lookup = 7 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Persists data written on the stream, up to and including the
   // current message, to permanent storage. This option should be used sparingly
-  // as it may reduce performance. Ongoing writes will periodically be persisted
+  // as it might reduce performance. Ongoing writes are periodically persisted
   // on the server even when `flush` is not set. This field is ignored if
   // `finish_write` is set to true since there's no need to checkpoint or flush
   // if this message completes the write.
@@ -1402,8 +1566,8 @@ message BidiWriteObjectRequest {
 
   // Optional. If `true`, this indicates that the write is complete. Sending any
   // `WriteObjectRequest`s subsequent to one in which `finish_write` is `true`
-  // will cause an error.
-  // For a non-resumable write (where the upload_id was not set in the first
+  // causes an error.
+  // For a non-resumable write (where the `upload_id` was not set in the first
   // message), it is an error not to set this field in the final message of the
   // stream.
   bool finish_write = 9 [(google.api.field_behavior) = OPTIONAL];
@@ -1416,7 +1580,7 @@ message BidiWriteObjectRequest {
 
 // Response message for BidiWriteObject.
 message BidiWriteObjectResponse {
-  // The response will set one of the following.
+  // The response sets one of the following.
   oneof write_status {
     // The total number of bytes that have been processed for the given object
     // from all `WriteObject` calls. Only set if the upload has not finalized.
@@ -1427,13 +1591,13 @@ message BidiWriteObjectResponse {
     Object resource = 2;
   }
 
-  // An optional write handle that will periodically be present in response
+  // An optional write handle that is returned periodically in response
   // messages. Clients should save it for later use in establishing a new stream
   // if a connection is interrupted.
   optional BidiWriteHandle write_handle = 3;
 }
 
-// Request message for ListObjects.
+// Request message for [ListObjects][google.storage.v2.Storage.ListObjects].
 message ListObjectsRequest {
   // Required. Name of the bucket in which to look for objects.
   string parent = 1 [
@@ -1443,23 +1607,23 @@ message ListObjectsRequest {
 
   // Optional. Maximum number of `items` plus `prefixes` to return
   // in a single page of responses. As duplicate `prefixes` are
-  // omitted, fewer total results may be returned than requested. The service
-  // will use this parameter or 1,000 items, whichever is smaller.
+  // omitted, fewer total results might be returned than requested. The service
+  // uses this parameter or 1,000 items, whichever is smaller.
   int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. A previously-returned page token representing part of the larger
   // set of results to view.
   string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. If set, returns results in a directory-like mode. `items` will
-  // contain only objects whose names, aside from the `prefix`, do not contain
+  // Optional. If set, returns results in a directory-like mode. `items`
+  // contains only objects whose names, aside from the `prefix`, do not contain
   // `delimiter`. Objects whose names, aside from the `prefix`, contain
-  // `delimiter` will have their name, truncated after the `delimiter`, returned
-  // in `prefixes`. Duplicate `prefixes` are omitted.
+  // `delimiter` has their name, truncated after the `delimiter`, returned in
+  // `prefixes`. Duplicate `prefixes` are omitted.
   string delimiter = 4 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. If true, objects that end in exactly one instance of `delimiter`
-  // will have their metadata included in `items` in addition to
+  // has their metadata included in `items` in addition to
   // `prefixes`.
   bool include_trailing_delimiter = 5 [(google.api.field_behavior) = OPTIONAL];
 
@@ -1467,51 +1631,51 @@ message ListObjectsRequest {
   string prefix = 6 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. If `true`, lists all versions of an object as distinct results.
-  // For more information, see
-  // [Object
-  // Versioning](https://cloud.google.com/storage/docs/object-versioning).
   bool versions = 7 [(google.api.field_behavior) = OPTIONAL];
 
   // Mask specifying which fields to read from each result.
-  // If no mask is specified, will default to all fields except items.acl and
-  // items.owner.
-  // * may be used to mean "all fields".
+  // If no mask is specified, defaults to all fields except `items.acl` and
+  // `items.owner`.
+  // `*` might be used to mean all fields.
   optional google.protobuf.FieldMask read_mask = 8;
 
   // Optional. Filter results to objects whose names are lexicographically equal
-  // to or after lexicographic_start. If lexicographic_end is also set, the
-  // objects listed have names between lexicographic_start (inclusive) and
-  // lexicographic_end (exclusive).
+  // to or after `lexicographic_start`. If `lexicographic_end` is also set, the
+  // objects listed have names between `lexicographic_start` (inclusive) and
+  // `lexicographic_end` (exclusive).
   string lexicographic_start = 10 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Filter results to objects whose names are lexicographically
-  // before lexicographic_end. If lexicographic_start is also set, the objects
-  // listed have names between lexicographic_start (inclusive) and
-  // lexicographic_end (exclusive).
+  // before `lexicographic_end`. If `lexicographic_start` is also set, the
+  // objects listed have names between `lexicographic_start` (inclusive) and
+  // `lexicographic_end` (exclusive).
   string lexicographic_end = 11 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. If true, only list all soft-deleted versions of the object.
   // Soft delete policy is required to set this option.
   bool soft_deleted = 12 [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. If true, will also include folders and managed folders (besides
-  // objects) in the returned `prefixes`. Requires `delimiter` to be set to '/'.
+  // Optional. If true, includes folders and managed folders (besides objects)
+  // in the returned `prefixes`. Requires `delimiter` to be set to '/'.
   bool include_folders_as_prefixes = 13
       [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Filter results to objects and prefixes that match this glob
-  // pattern. See [List Objects Using
-  // Glob](https://cloud.google.com/storage/docs/json_api/v1/objects/list#list-objects-and-prefixes-using-glob)
+  // pattern. See [List objects using
+  // 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.
+  // Optional. An expression used to filter the returned objects by the
+  // `context` field. For the full syntax, see [Filter objects by contexts
+  // syntax](https://cloud.google.com/storage/docs/listing-objects#filter-by-object-contexts-syntax).
+  // If a `delimiter` is set, the returned `prefixes` are exempt from this
+  // filter.
   string filter = 15 [(google.api.field_behavior) = OPTIONAL];
 }
 
-// Request object for `QueryWriteStatus`.
+// Request object for
+// [QueryWriteStatus][google.storage.v2.Storage.QueryWriteStatus].
 message QueryWriteStatusRequest {
   // Required. The name of the resume token for the object whose write status is
   // being requested.
@@ -1523,9 +1687,10 @@ message QueryWriteStatusRequest {
       [(google.api.field_behavior) = OPTIONAL];
 }
 
-// Response object for `QueryWriteStatus`.
+// Response object for
+// [QueryWriteStatus][google.storage.v2.Storage.QueryWriteStatus].
 message QueryWriteStatusResponse {
-  // The response will set one of the following.
+  // The response sets one of the following.
   oneof write_status {
     // The total number of bytes that have been processed for the given object
     // from all `WriteObject` calls. This is the correct value for the
@@ -1539,14 +1704,15 @@ message QueryWriteStatusResponse {
   }
 }
 
-// Request message for RewriteObject.
+// Request message for [RewriteObject][google.storage.v2.Storage.RewriteObject].
 // If the source object is encrypted using a Customer-Supplied Encryption Key
-// the key information must be provided in the copy_source_encryption_algorithm,
-// copy_source_encryption_key_bytes, and copy_source_encryption_key_sha256_bytes
-// fields. If the destination object should be encrypted the keying information
-// should be provided in the encryption_algorithm, encryption_key_bytes, and
-// encryption_key_sha256_bytes fields of the
-// common_object_request_params.customer_encryption field.
+// the key information must be provided in the
+// `copy_source_encryption_algorithm`, `copy_source_encryption_key_bytes`, and
+// `copy_source_encryption_key_sha256_bytes` fields. If the destination object
+// should be encrypted the keying information should be provided in the
+// `encryption_algorithm`, `encryption_key_bytes`, and
+// `encryption_key_sha256_bytes` fields of the
+// `common_object_request_params.customer_encryption` field.
 message RewriteObjectRequest {
   // Required. Immutable. The name of the destination object.
   // See the
@@ -1568,7 +1734,7 @@ message RewriteObjectRequest {
     (google.api.resource_reference) = { type: "storage.googleapis.com/Bucket" }
   ];
 
-  // Optional. The name of the Cloud KMS key that will be used to encrypt the
+  // Optional. The name of the Cloud KMS key that is used to encrypt the
   // destination object. The Cloud KMS key must be located in same location as
   // the object. If the parameter is not specified, the request uses the
   // destination bucket's default encryption key, if any, or else the
@@ -1584,8 +1750,8 @@ message RewriteObjectRequest {
   // The `name`, `bucket` and `kms_key` fields must not be populated (these
   // values are specified in the `destination_name`, `destination_bucket`, and
   // `destination_kms_key` fields).
-  // If `destination` is present it will be used to construct the destination
-  // object's metadata; otherwise the destination object's metadata will be
+  // If `destination` is present it is used to construct the destination
+  // object's metadata; otherwise the destination object's metadata is
   // copied from the source object.
   Object destination = 1 [(google.api.field_behavior) = OPTIONAL];
 
@@ -1610,8 +1776,8 @@ message RewriteObjectRequest {
   string rewrite_token = 5 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Apply a predefined set of access controls to the destination
-  // object. Valid values are "authenticatedRead", "bucketOwnerFullControl",
-  // "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+  // object. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+  // `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
   string destination_predefined_acl = 28
       [(google.api.field_behavior) = OPTIONAL];
 
@@ -1650,7 +1816,7 @@ message RewriteObjectRequest {
   // metageneration does not match the given value.
   optional int64 if_source_metageneration_not_match = 14;
 
-  // Optional. The maximum number of bytes that will be rewritten per rewrite
+  // Optional. The maximum number of bytes that are rewritten per rewrite
   // request. Most callers shouldn't need to specify this parameter - it is
   // primarily in place to support testing. If specified the value must be an
   // integral multiple of 1 MiB (1048576). Also, this only applies to requests
@@ -1682,8 +1848,8 @@ message RewriteObjectRequest {
   CommonObjectRequestParams common_object_request_params = 19
       [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. The checksums of the complete object. This will be used to
-  // validate the destination object after rewriting.
+  // Optional. The checksums of the complete object. This is used to validate
+  // the destination object after rewriting.
   ObjectChecksums object_checksums = 29
       [(google.api.field_behavior) = OPTIONAL];
 }
@@ -1711,7 +1877,7 @@ message RewriteResponse {
   Object resource = 5;
 }
 
-// Request message for MoveObject.
+// Request message for [MoveObject][google.storage.v2.Storage.MoveObject].
 message MoveObjectRequest {
   // Required. Name of the bucket in which the object resides.
   string bucket = 1 [
@@ -1790,7 +1956,8 @@ message MoveObjectRequest {
       [(google.api.field_behavior) = OPTIONAL];
 }
 
-// Request message StartResumableWrite.
+// Request message for
+// [StartResumableWrite][google.storage.v2.Storage.StartResumableWrite].
 message StartResumableWriteRequest {
   // Required. Contains the information necessary to start a resumable write.
   WriteObjectSpec write_object_spec = 1
@@ -1809,7 +1976,8 @@ message StartResumableWriteRequest {
   ObjectChecksums object_checksums = 5 [(google.api.field_behavior) = OPTIONAL];
 }
 
-// Response object for `StartResumableWrite`.
+// Response object for
+// [StartResumableWrite][google.storage.v2.Storage.StartResumableWrite].
 message StartResumableWriteResponse {
   // A unique identifier for the initiated resumable write operation.
   // As the ID grants write access, you should keep it confidential during
@@ -1819,7 +1987,7 @@ message StartResumableWriteResponse {
   string upload_id = 1;
 }
 
-// Request message for UpdateObject.
+// Request message for [UpdateObject][google.storage.v2.Storage.UpdateObject].
 message UpdateObjectRequest {
   // Required. The object to update.
   // The object's bucket and name fields are used to identify the object to
@@ -1857,7 +2025,7 @@ message UpdateObjectRequest {
   // To specify ALL fields, equivalent to the JSON API's "update" function,
   // specify a single field with the value `*`. Note: not recommended. If a new
   // field is introduced at a later time, an older client updating with the `*`
-  // may accidentally reset the new field's value.
+  // might accidentally reset the new field's value.
   //
   // Not specifying any fields is an error.
   google.protobuf.FieldMask update_mask = 7
@@ -1883,8 +2051,8 @@ message CommonObjectRequestParams {
   // feature. In raw bytes format (not base64-encoded).
   bytes encryption_key_bytes = 4 [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. SHA256 hash of encryption key used with the Customer-Supplied
-  // Encryption Keys feature.
+  // Optional. SHA256 hash of encryption key used with the Customer-supplied
+  // encryption keys feature.
   bytes encryption_key_sha256_bytes = 5
       [(google.api.field_behavior) = OPTIONAL];
 }
@@ -1898,8 +2066,8 @@ message ServiceConstants {
     // Unused. Proto3 requires first enum to be 0.
     VALUES_UNSPECIFIED = 0;
 
-    // The maximum size chunk that can will be returned in a single
-    // ReadRequest.
+    // The maximum size chunk that can be returned in a single
+    // `ReadRequest`.
     // 2 MiB.
     MAX_READ_CHUNK_BYTES = 2097152;
 
@@ -1992,26 +2160,27 @@ message Bucket {
   // https://cloud.google.com/storage/docs/cross-origin.
   // For more on CORS in general, see https://tools.ietf.org/html/rfc6454.
   message Cors {
-    // Optional. The list of Origins eligible to receive CORS response headers.
-    // See [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
-    // Note: "*" is permitted in the list of origins, and means "any Origin".
+    // Optional. The list of origins eligible to receive CORS response headers.
+    // For more information about origins, see [RFC
+    // 6454](https://tools.ietf.org/html/rfc6454). Note: `*` is permitted in the
+    // list of origins, and means `any origin`.
     repeated string origin = 1 [(google.api.field_behavior) = OPTIONAL];
 
     // Optional. The list of HTTP methods on which to include CORS response
     // headers,
-    // (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+    // (`GET`, `OPTIONS`, `POST`, etc) Note: `*` is permitted in the list of
     // methods, and means "any method".
     repeated string method = 2 [(google.api.field_behavior) = OPTIONAL];
 
-    // Optional. The list of HTTP headers other than the
-    // [https://www.w3.org/TR/cors/#simple-response-header][simple response
-    // headers] to give permission for the user-agent to share across domains.
+    // Optional. The list of HTTP headers other than the [simple response
+    // headers](https://www.w3.org/TR/cors/#simple-response-headers) to give
+    // permission for the user-agent to share across domains.
     repeated string response_header = 3
         [(google.api.field_behavior) = OPTIONAL];
 
-    // Optional. The value, in seconds, to return in the
-    // [https://www.w3.org/TR/cors/#access-control-max-age-response-header][Access-Control-Max-Age
-    // header] used in preflight responses.
+    // Optional. The value, in seconds, to return in the [Access-Control-Max-Age
+    // header](https://www.w3.org/TR/cors/#access-control-max-age-response-header)
+    // used in preflight responses.
     int32 max_age_seconds = 4 [(google.api.field_behavior) = OPTIONAL];
   }
 
@@ -2020,7 +2189,7 @@ message Bucket {
     // Google Managed Encryption (GMEK) enforcement config of a bucket.
     message GoogleManagedEncryptionEnforcementConfig {
       // Restriction mode for google-managed encryption for new objects within
-      // the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+      // the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
       // If `NotRestricted` or unset, creation of new objects with
       // google-managed encryption is allowed.
       // If `FullyRestricted`, new objects can't be created using google-managed
@@ -2034,7 +2203,7 @@ message Bucket {
     // Customer Managed Encryption (CMEK) enforcement config of a bucket.
     message CustomerManagedEncryptionEnforcementConfig {
       // Restriction mode for customer-managed encryption for new objects within
-      // the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+      // the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
       // If `NotRestricted` or unset, creation of new objects with
       // customer-managed encryption is allowed.
       // If `FullyRestricted`, new objects can't be created using
@@ -2048,8 +2217,8 @@ message Bucket {
     // Customer Supplied Encryption (CSEK) enforcement config of a bucket.
     message CustomerSuppliedEncryptionEnforcementConfig {
       // Restriction mode for customer-supplied encryption for new objects
-      // within the bucket. Valid values are: "NotRestricted",
-      // "FullyRestricted".
+      // within the bucket. Valid values are: `NotRestricted` and
+      // `FullyRestricted`.
       // If `NotRestricted` or unset, creation of new objects with
       // customer-supplied encryption is allowed.
       // If `FullyRestricted`, new objects can't be created using
@@ -2060,8 +2229,8 @@ message Bucket {
       optional google.protobuf.Timestamp effective_time = 2;
     }
 
-    // Optional. The name of the Cloud KMS key that will be used to encrypt
-    // objects inserted into this bucket, if no encryption method is specified.
+    // Optional. The name of the Cloud KMS key that is used to encrypt objects
+    // inserted into this bucket, if no encryption method is specified.
     string default_kms_key = 1 [
       (google.api.field_behavior) = OPTIONAL,
       (google.api.resource_reference) = {
@@ -2115,17 +2284,18 @@ message Bucket {
     UniformBucketLevelAccess uniform_bucket_level_access = 1
         [(google.api.field_behavior) = OPTIONAL];
 
-    // Optional. Whether IAM will enforce public access prevention. Valid values
-    // are "enforced" or "inherited".
+    // Optional. Whether IAM enforces public access prevention. Valid values are
+    // `enforced` or `inherited`.
     string public_access_prevention = 3
         [(google.api.field_behavior) = OPTIONAL];
   }
 
   // Lifecycle properties of a bucket.
-  // For more information, see https://cloud.google.com/storage/docs/lifecycle.
+  // For more information, see [Object Lifecycle
+  // Management](https://cloud.google.com/storage/docs/lifecycle).
   message Lifecycle {
     // A lifecycle Rule, combining an action to take on an object and a
-    // condition which will trigger that action.
+    // condition which triggers that action.
     message Rule {
       // An action to take on an object.
       message Action {
@@ -2163,8 +2333,8 @@ message Bucket {
         optional int32 num_newer_versions = 4;
 
         // Optional. Objects having any of the storage classes specified by this
-        // condition will be matched. Values include `MULTI_REGIONAL`,
-        // `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and
+        // condition are matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+        // `NEARLINE`, `COLDLINE`, `STANDARD`, and
         // `DURABLE_REDUCED_AVAILABILITY`.
         repeated string matches_storage_class = 5
             [(google.api.field_behavior) = OPTIONAL];
@@ -2182,7 +2352,7 @@ message Bucket {
         // This condition is relevant only for versioned objects. An object
         // version satisfies this condition only if these many days have been
         // passed since it became noncurrent. The value of the field must be a
-        // nonnegative integer. If it's zero, the object version will become
+        // nonnegative integer. If it's zero, the object version becomes
         // eligible for Lifecycle action as soon as it becomes noncurrent.
         optional int32 days_since_noncurrent_time = 9;
 
@@ -2206,12 +2376,12 @@ message Bucket {
       // Optional. The action to take.
       Action action = 1 [(google.api.field_behavior) = OPTIONAL];
 
-      // Optional. The condition(s) under which the action will be taken.
+      // Optional. The condition under which the action is taken.
       Condition condition = 2 [(google.api.field_behavior) = OPTIONAL];
     }
 
     // Optional. A lifecycle management rule, which is made of an action to take
-    // and the condition(s) under which the action will be taken.
+    // and the condition under which the action is taken.
     repeated Rule rule = 1 [(google.api.field_behavior) = OPTIONAL];
   }
 
@@ -2249,7 +2419,7 @@ message Bucket {
     // duration must be greater than zero and less than 100 years. Note that
     // enforcement of retention periods less than a day is not guaranteed. Such
     // periods should only be used for testing purposes. Any `nanos` value
-    // specified will be rounded down to the nearest second.
+    // specified is rounded down to the nearest second.
     google.protobuf.Duration retention_duration = 4
         [(google.api.field_behavior) = OPTIONAL];
   }
@@ -2266,34 +2436,36 @@ message Bucket {
   }
 
   // Properties of a bucket related to versioning.
-  // For more on Cloud Storage versioning, see
-  // https://cloud.google.com/storage/docs/object-versioning.
+  // For more information about Cloud Storage versioning, see [Object
+  // versioning](https://cloud.google.com/storage/docs/object-versioning).
   message Versioning {
     // Optional. While set to true, versioning is fully enabled for this bucket.
     bool enabled = 1 [(google.api.field_behavior) = OPTIONAL];
   }
 
   // Properties of a bucket related to accessing the contents as a static
-  // website. For more on hosting a static website via Cloud Storage, see
-  // https://cloud.google.com/storage/docs/hosting-static-website.
+  // website. For details, see [hosting a static website using Cloud
+  // Storage](https://cloud.google.com/storage/docs/hosting-static-website).
   message Website {
-    // Optional. If the requested object path is missing, the service will
-    // ensure the path has a trailing '/', append this suffix, and attempt to
-    // retrieve the resulting object. This allows the creation of `index.html`
-    // objects to represent directory pages.
+    // Optional. If the requested object path is missing, the service ensures
+    // the path has a trailing '/', append this suffix, and attempt to retrieve
+    // the resulting object. This allows the creation of `index.html` objects to
+    // represent directory pages.
     string main_page_suffix = 1 [(google.api.field_behavior) = OPTIONAL];
 
     // Optional. If the requested object path is missing, and any
     // `mainPageSuffix` object is missing, if applicable, the service
-    // will return the named object from this bucket as the content for a
-    // [https://tools.ietf.org/html/rfc7231#section-6.5.4][404 Not Found]
+    // returns the named object from this bucket as the content for a
+    // [404 Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)
     // result.
     string not_found_page = 2 [(google.api.field_behavior) = OPTIONAL];
   }
 
-  // Configuration for Custom Dual Regions.  It should specify precisely two
-  // eligible regions within the same Multiregion. More information on regions
-  // may be found [here](https://cloud.google.com/storage/docs/locations).
+  // Configuration for [configurable dual-
+  // regions](https://cloud.google.com/storage/docs/locations#configurable). It
+  // should specify precisely two eligible regions within the same multi-region.
+  // For details, see
+  // [locations](https://cloud.google.com/storage/docs/locations).
   message CustomPlacementConfig {
     // Optional. List of locations to use for data placement.
     repeated string data_locations = 1 [(google.api.field_behavior) = OPTIONAL];
@@ -2306,12 +2478,12 @@ message Bucket {
 
     // Output only. Latest instant at which the `enabled` field was set to true
     // after being disabled/unconfigured or set to false after being enabled. If
-    // Autoclass is enabled when the bucket is created, the toggle_time is set
-    // to the bucket creation time.
+    // Autoclass is enabled when the bucket is created, the value of the
+    // `toggle_time` field is set to the bucket `create_time`.
     google.protobuf.Timestamp toggle_time = 2
         [(google.api.field_behavior) = OUTPUT_ONLY];
 
-    // An object in an Autoclass bucket will eventually cool down to the
+    // An object in an Autoclass bucket eventually cools down to the
     // terminal storage class if there is no access to the object.
     // The only valid values are NEARLINE and ARCHIVE.
     optional string terminal_storage_class = 3;
@@ -2357,7 +2529,7 @@ message Bucket {
     // `Disabled`. When set to `Enabled`, IP filtering rules are applied to a
     // bucket and all incoming requests to the bucket are evaluated against
     // these rules. When set to `Disabled`, IP filtering rules are not applied
-    // to a bucket.".
+    // to a bucket.
     optional string mode = 1;
 
     // Public IPs allowed to operate or access the bucket.
@@ -2371,12 +2543,12 @@ message Bucket {
     // Optional. Whether or not to allow VPCs from orgs different than the
     // bucket's parent org to access the bucket. When set to true, validations
     // on the existence of the VPCs won't be performed. If set to false, each
-    // VPC network source will be checked to belong to the same org as the
-    // bucket as well as validated for existence.
+    // VPC network source is checked to belong to the same org as the bucket as
+    // well as validated for existence.
     bool allow_cross_org_vpcs = 4 [(google.api.field_behavior) = OPTIONAL];
 
     // Whether or not to allow all P4SA access to the bucket. When set to true,
-    // IP filter config validation will not apply.
+    // IP filter config validation doesn't apply.
     optional bool allow_all_service_agent_access = 5;
   }
 
@@ -2392,18 +2564,18 @@ message Bucket {
 
   // Output only. The user-chosen part of the bucket name. The `{bucket}`
   // portion of the `name` field. For globally unique buckets, this is equal to
-  // the "bucket name" of other Cloud Storage APIs. Example: "pub".
+  // the `bucket name` of other Cloud Storage APIs. Example: `pub`.
   string bucket_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // The etag of the bucket.
-  // If included in the metadata of an UpdateBucketRequest, the operation will
-  // only be performed if the etag matches that of the bucket.
+  // If included in the metadata of an `UpdateBucketRequest`, the operation is
+  // only performed if the `etag` matches that of the bucket.
   string etag = 29;
 
   // Immutable. The project which owns this bucket, in the format of
-  // "projects/{projectIdentifier}".
-  // {projectIdentifier} can be the project ID or project number.
-  // Output values will always be in project number format.
+  // `projects/{projectIdentifier}`.
+  // `{projectIdentifier}` can be the project ID or project number.
+  // Output values are always in the project number format.
   string project = 3 [
     (google.api.field_behavior) = IMMUTABLE,
     (google.api.resource_reference) = {
@@ -2416,10 +2588,8 @@ message Bucket {
 
   // Immutable. The location of the bucket. Object data for objects in the
   // bucket resides in physical storage within this region.  Defaults to `US`.
-  // See the
-  // [https://developers.google.com/storage/docs/concepts-techniques#specifyinglocations"][developer's
-  // guide] for the authoritative list. Attempting to update this field after
-  // the bucket is created will result in an error.
+  // Attempting to update this field after the bucket is created results in an
+  // error.
   string location = 5 [(google.api.field_behavior) = IMMUTABLE];
 
   // Output only. The location type of the bucket (region, dual-region,
@@ -2429,41 +2599,41 @@ message Bucket {
   // Optional. The bucket's default storage class, used whenever no storageClass
   // is specified for a newly-created object. This defines how objects in the
   // bucket are stored and determines the SLA and the cost of storage.
-  // If this value is not specified when the bucket is created, it will default
-  // to `STANDARD`. For more information, see
-  // https://developers.google.com/storage/docs/storage-classes.
+  // If this value is not specified when the bucket is created, it defaults
+  // to `STANDARD`. For more information, see [Storage
+  // classes](https://developers.google.com/storage/docs/storage-classes).
   string storage_class = 7 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. The recovery point objective for cross-region replication of the
-  // bucket. Applicable only for dual- and multi-region buckets. "DEFAULT" uses
-  // default replication. "ASYNC_TURBO" enables turbo replication, valid for
+  // bucket. Applicable only for dual- and multi-region buckets. `DEFAULT` uses
+  // default replication. `ASYNC_TURBO` enables turbo replication, valid for
   // dual-region buckets only. If rpo is not specified when the bucket is
-  // created, it defaults to "DEFAULT". For more information, see
-  // https://cloud.google.com/storage/docs/availability-durability#turbo-replication.
+  // created, it defaults to `DEFAULT`. For more information, see [Turbo
+  // replication](https://cloud.google.com/storage/docs/availability-durability#turbo-replication).
   string rpo = 27 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Access controls on the bucket.
-  // If iam_config.uniform_bucket_level_access is enabled on this bucket,
+  // If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
   // requests to set, read, or modify acl is an error.
   repeated BucketAccessControl acl = 8 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Default access controls to apply to new objects when no ACL is
-  // provided. If iam_config.uniform_bucket_level_access is enabled on this
+  // provided. If `iam_config.uniform_bucket_level_access` is enabled on this
   // bucket, requests to set, read, or modify acl is an error.
   repeated ObjectAccessControl default_object_acl = 9
       [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. The bucket's lifecycle config. See
-  // [https://developers.google.com/storage/docs/lifecycle]Lifecycle Management]
-  // for more information.
+  // Optional. The bucket's lifecycle configuration. See [Lifecycle
+  // Management](https://developers.google.com/storage/docs/lifecycle) for more
+  // information.
   Lifecycle lifecycle = 10 [(google.api.field_behavior) = OPTIONAL];
 
   // Output only. The creation time of the bucket.
   google.protobuf.Timestamp create_time = 11
       [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
-  // Sharing] (CORS) config.
+  // Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+  // configuration.
   repeated Cors cors = 12 [(google.api.field_behavior) = OPTIONAL];
 
   // Output only. The modification time of the bucket.
@@ -2473,11 +2643,11 @@ message Bucket {
   // Optional. The default value for event-based hold on newly created objects
   // in this bucket.  Event-based hold is a way to retain objects indefinitely
   // until an event occurs, signified by the hold's release. After being
-  // released, such objects will be subject to bucket-level retention (if any).
-  // One sample use case of this flag is for banks to hold loan documents for at
+  // released, such objects are subject to bucket-level retention (if any).  One
+  // sample use case of this flag is for banks to hold loan documents for at
   // least 3 years after loan is paid in full. Here, bucket-level retention is 3
   // years and the event is loan being paid in full. In this example, these
-  // objects will be held intact for any number of years until the event has
+  // objects are held intact for any number of years until the event has
   // occurred (event-based hold on the object is released) and then 3 more years
   // after that. That means retention duration of the objects begins from the
   // moment event-based hold transitioned from true to false.  Objects under
@@ -2489,12 +2659,12 @@ message Bucket {
   map labels = 15 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. The bucket's website config, controlling how the service behaves
-  // when accessing bucket contents as a web site. See the
-  // [https://cloud.google.com/storage/docs/static-website][Static Website
-  // Examples] for more information.
+  // when accessing bucket contents as a web site. See the [Static website
+  // examples](https://cloud.google.com/storage/docs/static-website) for more
+  // information.
   Website website = 16 [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. The bucket's versioning config.
+  // Optional. The bucket's versioning configuration.
   Versioning versioning = 17 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. The bucket's logging config, which defines the destination bucket
@@ -2508,41 +2678,40 @@ message Bucket {
   // Optional. Encryption config for a bucket.
   Encryption encryption = 20 [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. The bucket's billing config.
+  // Optional. The bucket's billing configuration.
   Billing billing = 21 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. The bucket's retention policy. The retention policy enforces a
   // minimum retention time for all objects contained in the bucket, based on
   // their creation time. Any attempt to overwrite or delete objects younger
-  // than the retention period will result in a PERMISSION_DENIED error.  An
+  // than the retention period results in a `PERMISSION_DENIED` error.  An
   // unlocked retention policy can be modified or removed from the bucket via a
   // storage.buckets.update operation. A locked retention policy cannot be
   // removed or shortened in duration for the lifetime of the bucket.
-  // Attempting to remove or decrease period of a locked retention policy will
-  // result in a PERMISSION_DENIED error.
+  // Attempting to remove or decrease period of a locked retention policy
+  // results in a `PERMISSION_DENIED` error.
   RetentionPolicy retention_policy = 22
       [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. The bucket's IAM config.
+  // Optional. The bucket's IAM configuration.
   IamConfig iam_config = 23 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Reserved for future use.
   bool satisfies_pzs = 25 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Configuration that, if present, specifies the data placement for
-  // a
-  // [https://cloud.google.com/storage/docs/locations#location-dr][configurable
-  // dual-region].
+  // a [configurable
+  // dual-region](https://cloud.google.com/storage/docs/locations#location-dr).
   CustomPlacementConfig custom_placement_config = 26
       [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. The bucket's Autoclass configuration. If there is no
-  // configuration, the Autoclass feature will be disabled and have no effect on
-  // the bucket.
+  // configuration, the Autoclass feature is disabled and has no effect on the
+  // bucket.
   Autoclass autoclass = 28 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. The bucket's hierarchical namespace configuration. If there is no
-  // configuration, the hierarchical namespace feature will be disabled and have
+  // configuration, the hierarchical namespace feature is disabled and has
   // no effect on the bucket.
   HierarchicalNamespace hierarchical_namespace = 32
       [(google.api.field_behavior) = OPTIONAL];
@@ -2553,7 +2722,7 @@ message Bucket {
       [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. The bucket's object retention configuration. Must be enabled
-  // before objects in the bucket may have retention configured.
+  // before objects in the bucket might have retention configured.
   ObjectRetention object_retention = 33
       [(google.api.field_behavior) = OPTIONAL];
 
@@ -2585,21 +2754,21 @@ message BucketAccessControl {
   // `group-example@googlegroups.com`
   // * All members of the Google Apps for Business domain `example.com` would be
   // `domain-example.com`
-  // For project entities, `project-{team}-{projectnumber}` format will be
+  // For project entities, `project-{team}-{projectnumber}` format is
   // returned on response.
   string entity = 3 [(google.api.field_behavior) = OPTIONAL];
 
   // Output only. The alternative entity format, if exists. For project
-  // entities, `project-{team}-{projectid}` format will be returned on response.
+  // entities, `project-{team}-{projectid}` format is returned in the response.
   string entity_alt = 9 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Optional. The ID for the entity, if any.
   string entity_id = 4 [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. The etag of the BucketAccessControl.
+  // Optional. The `etag` of the `BucketAccessControl`.
   // If included in the metadata of an update or delete request message, the
-  // operation operation will only be performed if the etag matches that of the
-  // bucket's BucketAccessControl.
+  // operation operation is only performed if the etag matches that of the
+  // bucket's `BucketAccessControl`.
   string etag = 8 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. The email address associated with the entity, if any.
@@ -2626,17 +2795,16 @@ message ChecksummedData {
 message ObjectChecksums {
   // CRC32C digest of the object data. Computed by the Cloud Storage service for
   // all written objects.
-  // If set in a WriteObjectRequest, service will validate that the stored
+  // If set in a WriteObjectRequest, service validates that the stored
   // object matches this checksum.
   optional fixed32 crc32c = 1;
 
-  // Optional. 128 bit MD5 hash of the object data.
-  // For more information about using the MD5 hash, see
-  // [https://cloud.google.com/storage/docs/hashes-etags#json-api][Hashes and
-  // ETags: Best Practices].
-  // Not all objects will provide an MD5 hash. For example, composite objects
-  // provide only crc32c hashes. This value is equivalent to running `cat
-  // object.txt | openssl md5 -binary`
+  // Optional. 128 bit MD5 hash of the object data. For more information about
+  // using the MD5 hash, see [Data validation and change
+  // detection](https://cloud.google.com/storage/docs/data-validation). Not all
+  // objects provide an MD5 hash. For example, composite objects provide only
+  // crc32c hashes. This value is equivalent to running `cat object.txt |
+  // openssl md5 -binary`
   bytes md5_hash = 2 [(google.api.field_behavior) = OPTIONAL];
 }
 
@@ -2661,8 +2829,8 @@ message ObjectContexts {
       [(google.api.field_behavior) = OPTIONAL];
 }
 
-// Describes the Customer-Supplied Encryption Key mechanism used to store an
-// Object's data at rest.
+// Describes the customer-supplied encryption key mechanism used to store an
+// object's data at rest.
 message CustomerEncryption {
   // Optional. The encryption algorithm.
   string encryption_algorithm = 1 [(google.api.field_behavior) = OPTIONAL];
@@ -2682,12 +2850,12 @@ message Object {
       // No specified mode. Object is not under retention.
       MODE_UNSPECIFIED = 0;
 
-      // Retention period may be decreased or increased.
-      // The Retention configuration may be removed.
-      // The mode may be changed to locked.
+      // Retention period might be decreased or increased.
+      // The Retention configuration might be removed.
+      // The mode might be changed to locked.
       UNLOCKED = 1;
 
-      // Retention period may be increased.
+      // Retention period might be increased.
       // The Retention configuration cannot be removed.
       // The mode cannot be changed.
       LOCKED = 2;
@@ -2717,9 +2885,9 @@ message Object {
     (google.api.resource_reference) = { type: "storage.googleapis.com/Bucket" }
   ];
 
-  // Optional. The etag of the object.
+  // Optional. The `etag` of an object.
   // If included in the metadata of an update or delete request message, the
-  // operation will only be performed if the etag matches that of the live
+  // operation is only performed if the etag matches that of the live
   // object.
   string etag = 27 [(google.api.field_behavior) = OPTIONAL];
 
@@ -2743,31 +2911,31 @@ message Object {
   string storage_class = 5 [(google.api.field_behavior) = OPTIONAL];
 
   // Output only. Content-Length of the object data in bytes, matching
-  // [https://tools.ietf.org/html/rfc7230#section-3.3.2][RFC 7230 §3.3.2].
+  // [RFC 7230 §3.3.2](https://tools.ietf.org/html/rfc7230#section-3.3.2]).
   int64 size = 6 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Optional. Content-Encoding of the object data, matching
-  // [https://tools.ietf.org/html/rfc7231#section-3.1.2.2][RFC 7231 §3.1.2.2]
+  // [RFC 7231 §3.1.2.2](https://tools.ietf.org/html/rfc7231#section-3.1.2.2)
   string content_encoding = 7 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Content-Disposition of the object data, matching
-  // [https://tools.ietf.org/html/rfc6266][RFC 6266].
+  // [RFC 6266](https://tools.ietf.org/html/rfc6266).
   string content_disposition = 8 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Cache-Control directive for the object data, matching
-  // [https://tools.ietf.org/html/rfc7234#section-5.2"][RFC 7234 §5.2].
+  // [RFC 7234 §5.2](https://tools.ietf.org/html/rfc7234#section-5.2).
   // If omitted, and the object is accessible to all anonymous users, the
-  // default will be `public, max-age=3600`.
+  // default is `public, max-age=3600`.
   string cache_control = 9 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Access controls on the object.
-  // If iam_config.uniform_bucket_level_access is enabled on the parent
+  // If `iam_config.uniform_bucket_level_access` is enabled on the parent
   // bucket, requests to set, read, or modify acl is an error.
   repeated ObjectAccessControl acl = 10
       [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Content-Language of the object data, matching
-  // [https://tools.ietf.org/html/rfc7231#section-3.1.3.2][RFC 7231 §3.1.3.2].
+  // [RFC 7231 §3.1.3.2](https://tools.ietf.org/html/rfc7231#section-3.1.3.2).
   string content_language = 11 [(google.api.field_behavior) = OPTIONAL];
 
   // Output only. If this object is noncurrent, this is the time when the object
@@ -2780,7 +2948,7 @@ message Object {
       [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Optional. Content-Type of the object data, matching
-  // [https://tools.ietf.org/html/rfc7231#section-3.1.1.5][RFC 7231 §3.1.1.5].
+  // [RFC 7231 §3.1.1.5](https://tools.ietf.org/html/rfc7231#section-3.1.1.5).
   // If an object is stored without a Content-Type, it is served as
   // `application/octet-stream`.
   string content_type = 13 [(google.api.field_behavior) = OPTIONAL];
@@ -2794,7 +2962,7 @@ message Object {
   int32 component_count = 15 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. Hashes for the data part of this object. This field is used
-  // for output only and will be silently ignored if provided in requests. The
+  // for output only and is silently ignored if provided in requests. The
   // checksums of the complete object regardless of data range. If the object is
   // downloaded in full, the client should compute one of these checksums over
   // the downloaded object and compare it against the value provided here.
@@ -2819,7 +2987,7 @@ message Object {
   ];
 
   // Output only. The time at which the object's storage class was last changed.
-  // When the object is initially created, it will be set to time_created.
+  // When the object is initially created, it is set to `time_created`.
   google.protobuf.Timestamp update_storage_class_time = 19
       [(google.api.field_behavior) = OUTPUT_ONLY];
 
@@ -2851,21 +3019,21 @@ message Object {
   // 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
-  // this field to false, the object will become subject to any bucket-level
-  // retention policy, except that the retention duration will be calculated
+  // this field to `false`, the object becomes subject to any bucket-level
+  // retention policy, except that the retention duration is calculated
   // from the time the event based hold was lifted, rather than the time the
   // object was created.
   //
-  // In a WriteObject request, not setting this field implies that the value
-  // should be taken from the parent bucket's "default_event_based_hold" field.
-  // In a response, this field will always be set to true or false.
+  // In a `WriteObject` request, not setting this field implies that the value
+  // should be taken from the parent bucket's `default_event_based_hold` field.
+  // In a response, this field is always set to `true` or `false`.
   optional bool event_based_hold = 23;
 
-  // Output only. The owner of the object. This will always be the uploader of
-  // the object.
+  // Output only. The owner of the object. This is always the uploader of the
+  // object.
   Owner owner = 24 [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // Optional. Metadata of Customer-Supplied Encryption Key, if the object is
+  // Optional. Metadata of customer-supplied encryption key, if the object is
   // encrypted by such a key.
   CustomerEncryption customer_encryption = 25
       [(google.api.field_behavior) = OPTIONAL];
@@ -2877,19 +3045,19 @@ message Object {
   // Output only. This is the time when the object became soft-deleted.
   //
   // Soft-deleted objects are only accessible if a soft_delete_policy is
-  // enabled. Also see hard_delete_time.
+  // enabled. Also see `hard_delete_time`.
   optional google.protobuf.Timestamp soft_delete_time = 28
       [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // Output only. The time when the object will be permanently deleted.
+  // Output only. The time when the object is permanently deleted.
   //
-  // Only set when an object becomes soft-deleted with a soft_delete_policy.
-  // Otherwise, the object will not be accessible.
+  // Only set when an object becomes soft-deleted with a `soft_delete_policy`.
+  // Otherwise, the object is not accessible.
   optional google.protobuf.Timestamp hard_delete_time = 29
       [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Optional. Retention configuration of this object.
-  // May only be configured if the bucket has object retention enabled.
+  // Might only be configured if the bucket has object retention enabled.
   Retention retention = 30 [(google.api.field_behavior) = OPTIONAL];
 }
 
@@ -2921,12 +3089,12 @@ message ObjectAccessControl {
   // `group-example@googlegroups.com`.
   // * All members of the Google Apps for Business domain `example.com` would be
   // `domain-example.com`.
-  // For project entities, `project-{team}-{projectnumber}` format will be
-  // returned on response.
+  // For project entities, `project-{team}-{projectnumber}` format is
+  // returned in the response.
   string entity = 3 [(google.api.field_behavior) = OPTIONAL];
 
   // Output only. The alternative entity format, if exists. For project
-  // entities, `project-{team}-{projectid}` format will be returned on response.
+  // entities, `project-{team}-{projectid}` format is returned in the response.
   string entity_alt = 9 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Optional. The ID for the entity, if any.
@@ -2934,7 +3102,7 @@ message ObjectAccessControl {
 
   // Optional. The etag of the ObjectAccessControl.
   // If included in the metadata of an update or delete request message, the
-  // operation will only be performed if the etag matches that of the live
+  // operation is only performed if the etag matches that of the live
   // object's ObjectAccessControl.
   string etag = 8 [(google.api.field_behavior) = OPTIONAL];
 

From 57a7abd44b498ebbc4732630d517632d8a4dfca1 Mon Sep 17 00:00:00 2001
From: Mend Renovate 
Date: Tue, 11 Nov 2025 17:21:58 +0000
Subject: [PATCH 13/26] chore(deps): update storage release dependencies to
 v2.60.0 (#3366)

---
 samples/install-without-bom/pom.xml | 6 +++---
 samples/snippets/pom.xml            | 4 ++--
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/samples/install-without-bom/pom.xml b/samples/install-without-bom/pom.xml
index 1da04a0133..33b6da2011 100644
--- a/samples/install-without-bom/pom.xml
+++ b/samples/install-without-bom/pom.xml
@@ -30,12 +30,12 @@
     
       com.google.cloud
       google-cloud-storage
-      2.59.0
+      2.60.0
     
     
       com.google.cloud
       google-cloud-storage-control
-      2.59.0
+      2.60.0
     
     
 
@@ -78,7 +78,7 @@
     
       com.google.cloud
       google-cloud-storage
-      2.59.0
+      2.60.0
       tests
       test
     
diff --git a/samples/snippets/pom.xml b/samples/snippets/pom.xml
index bfa3500c1a..4305b1fe9b 100644
--- a/samples/snippets/pom.xml
+++ b/samples/snippets/pom.xml
@@ -31,7 +31,7 @@
       
         com.google.cloud
         libraries-bom
-        26.70.0
+        26.71.0
         pom
         import
       
@@ -99,7 +99,7 @@
       
       com.google.cloud
       google-cloud-storage
-      2.59.0
+      2.60.0
       tests
       test
     

From 73b07fa17b903bc45e90cb531b5a062d38615280 Mon Sep 17 00:00:00 2001
From: cloud-java-bot <122572305+cloud-java-bot@users.noreply.github.com>
Date: Wed, 12 Nov 2025 10:54:24 -0500
Subject: [PATCH 14/26] chore: Update generation configuration at Wed Nov 12
 02:30:01 UTC 2025 (#3393)

---
 README.md              | 6 +++---
 generation_config.yaml | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index c6e229a2f1..c724578705 100644
--- a/README.md
+++ b/README.md
@@ -19,7 +19,7 @@ If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file:
     
       com.google.cloud
       libraries-bom
-      26.70.0
+      26.71.0
       pom
       import
     
@@ -46,12 +46,12 @@ If you are using Maven without the BOM, add this to your dependencies:
 
   com.google.cloud
   google-cloud-storage
-  2.59.0
+  2.60.0
 
 
   com.google.cloud
   google-cloud-storage-control
-  2.59.0
+  2.60.0
 
 
 ```
diff --git a/generation_config.yaml b/generation_config.yaml
index 4cc603a6f5..9b1b477a6f 100644
--- a/generation_config.yaml
+++ b/generation_config.yaml
@@ -1,5 +1,5 @@
 gapic_generator_version: 2.64.1
-googleapis_commitish: 1b5f8632487bce889ce05366647addc6ef5ee36d
+googleapis_commitish: cf0434f4bd20618db60ddd16a1e7db2c0dfb9158
 libraries_bom_version: 26.71.0
 libraries:
   - api_shortname: storage

From 0701c6b4888b142ef243bb674f4bf4ff688dafc8 Mon Sep 17 00:00:00 2001
From: Dhriti07 <56169283+Dhriti07@users.noreply.github.com>
Date: Wed, 12 Nov 2025 23:20:26 +0530
Subject: [PATCH 15/26] feat: add UploadPartRequest.crc32c property and
 requisite plumbing (#3395)

Co-authored-by: Dhriti Chopra 
---
 .../MultipartUploadHttpRequestManager.java    | 14 ++++++-
 .../model/UploadPartRequest.java              | 35 ++++++++++++++++-
 ...MultipartUploadHttpRequestManagerTest.java | 39 +++++++++++++++++++
 3 files changed, 84 insertions(+), 4 deletions(-)

diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java
index 588b8fe74f..d6a92c1807 100644
--- a/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java
+++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java
@@ -205,7 +205,11 @@ UploadPartResponse sendUploadPartRequest(
     HttpRequest httpRequest =
         requestFactory.buildPutRequest(new GenericUrl(uploadUri), rewindableContent);
     httpRequest.getHeaders().putAll(headerProvider.getHeaders());
-    addChecksumHeader(rewindableContent.getCrc32c(), httpRequest.getHeaders());
+    if (request.getCrc32c() != null) {
+      addChecksumHeader(request.getCrc32c(), httpRequest.getHeaders());
+    } else {
+      addChecksumHeader(rewindableContent.getCrc32c(), httpRequest.getHeaders());
+    }
     httpRequest.setThrowExceptionOnExecuteError(true);
     return ChecksumResponseParser.parseUploadResponse(httpRequest.execute());
   }
@@ -234,7 +238,13 @@ static MultipartUploadHttpRequestManager createFrom(HttpStorageOptions options)
 
   private void addChecksumHeader(@Nullable Crc32cLengthKnown crc32c, HttpHeaders headers) {
     if (crc32c != null) {
-      headers.put("x-goog-hash", "crc32c=" + Utils.crc32cCodec.encode(crc32c.getValue()));
+      addChecksumHeader(Utils.crc32cCodec.encode(crc32c.getValue()), headers);
+    }
+  }
+
+  private void addChecksumHeader(@Nullable String crc32c, HttpHeaders headers) {
+    if (crc32c != null) {
+      headers.put("x-goog-hash", "crc32c=" + crc32c);
     }
   }
 
diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/UploadPartRequest.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/UploadPartRequest.java
index 9d07cf7fb0..59af2df211 100644
--- a/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/UploadPartRequest.java
+++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/UploadPartRequest.java
@@ -19,6 +19,7 @@
 import com.google.api.core.BetaApi;
 import com.google.common.base.MoreObjects;
 import java.util.Objects;
+import org.checkerframework.checker.nullness.qual.Nullable;
 
 /**
  * An object to represent an upload part request. An upload part request is used to upload a single
@@ -33,12 +34,14 @@ public final class UploadPartRequest {
   private final String key;
   private final int partNumber;
   private final String uploadId;
+  @Nullable private final String crc32c;
 
   private UploadPartRequest(Builder builder) {
     this.bucket = builder.bucket;
     this.key = builder.key;
     this.partNumber = builder.partNumber;
     this.uploadId = builder.uploadId;
+    this.crc32c = builder.crc32c;
   }
 
   /**
@@ -85,6 +88,18 @@ public String uploadId() {
     return uploadId;
   }
 
+  /**
+   * Returns the CRC32C checksum of the part to upload.
+   *
+   * @return The CRC32C checksum of the part to upload.
+   * @since 2.61.0 This new api is in preview and is subject to breaking changes.
+   */
+  @BetaApi
+  @Nullable
+  public String getCrc32c() {
+    return crc32c;
+  }
+
   @Override
   public boolean equals(Object o) {
     if (this == o) {
@@ -97,12 +112,13 @@ public boolean equals(Object o) {
     return partNumber == that.partNumber
         && Objects.equals(bucket, that.bucket)
         && Objects.equals(key, that.key)
-        && Objects.equals(uploadId, that.uploadId);
+        && Objects.equals(uploadId, that.uploadId)
+        && Objects.equals(crc32c, that.crc32c);
   }
 
   @Override
   public int hashCode() {
-    return Objects.hash(bucket, key, partNumber, uploadId);
+    return Objects.hash(bucket, key, partNumber, uploadId, crc32c);
   }
 
   @Override
@@ -112,6 +128,7 @@ public String toString() {
         .add("key", key)
         .add("partNumber", partNumber)
         .add("uploadId", uploadId)
+        .add("crc32c", crc32c)
         .toString();
   }
 
@@ -137,6 +154,7 @@ public static class Builder {
     private String key;
     private int partNumber;
     private String uploadId;
+    @Nullable private String crc32c;
 
     private Builder() {}
 
@@ -192,6 +210,19 @@ public Builder uploadId(String uploadId) {
       return this;
     }
 
+    /**
+     * Sets the CRC32C checksum of the part to upload.
+     *
+     * @param crc32c The CRC32C checksum of the part to upload.
+     * @return This builder.
+     * @since 2.61.0 This new api is in preview and is subject to breaking changes.
+     */
+    @BetaApi
+    public Builder crc32c(@Nullable String crc32c) {
+      this.crc32c = crc32c;
+      return this;
+    }
+
     /**
      * Builds the {@link UploadPartRequest}.
      *
diff --git a/google-cloud-storage/src/test/java/com/google/cloud/storage/ITMultipartUploadHttpRequestManagerTest.java b/google-cloud-storage/src/test/java/com/google/cloud/storage/ITMultipartUploadHttpRequestManagerTest.java
index 6133a25444..65cf0fe827 100644
--- a/google-cloud-storage/src/test/java/com/google/cloud/storage/ITMultipartUploadHttpRequestManagerTest.java
+++ b/google-cloud-storage/src/test/java/com/google/cloud/storage/ITMultipartUploadHttpRequestManagerTest.java
@@ -26,6 +26,7 @@
 import com.google.api.client.http.HttpResponseException;
 import com.google.cloud.NoCredentials;
 import com.google.cloud.storage.FakeHttpServer.HttpRequestHandler;
+import com.google.cloud.storage.it.ChecksummedTestContent;
 import com.google.cloud.storage.it.runner.StorageITRunner;
 import com.google.cloud.storage.it.runner.annotations.Backend;
 import com.google.cloud.storage.it.runner.annotations.ParallelFriendly;
@@ -816,6 +817,44 @@ public void sendUploadPartRequest_withChecksums() throws Exception {
     }
   }
 
+  @Test
+  public void sendUploadPartRequest_withCustomChecksum() throws Exception {
+    String etag = "\"af1ed31420542285653c803a34aa839a\"";
+    ChecksummedTestContent content =
+        ChecksummedTestContent.of("hello world".getBytes(StandardCharsets.UTF_8));
+
+    HttpRequestHandler handler =
+        req -> {
+          assertThat(req.headers().get("x-goog-hash"))
+              .isEqualTo("crc32c=" + content.getCrc32cBase64());
+          FullHttpRequest fullReq = (FullHttpRequest) req;
+          ByteBuf requestContent = fullReq.content();
+          byte[] receivedBytes = new byte[requestContent.readableBytes()];
+          requestContent.readBytes(receivedBytes);
+          assertThat(receivedBytes).isEqualTo(content.getBytes());
+          DefaultFullHttpResponse resp = new DefaultFullHttpResponse(req.protocolVersion(), OK);
+          resp.headers().set("ETag", etag);
+          return resp;
+        };
+
+    try (FakeHttpServer fakeHttpServer = FakeHttpServer.of(handler)) {
+      URI endpoint = URI.create(fakeHttpServer.getEndpoint() + "/");
+      UploadPartRequest request =
+          UploadPartRequest.builder()
+              .bucket("test-bucket")
+              .key("test-key")
+              .uploadId("test-upload-id")
+              .partNumber(1)
+              .crc32c(content.getCrc32cBase64())
+              .build();
+      UploadPartResponse response =
+          multipartUploadHttpRequestManager.sendUploadPartRequest(
+              endpoint, request, RewindableContent.of(content.asByteBuffer()));
+      assertThat(response).isNotNull();
+      assertThat(response.eTag()).isEqualTo(etag);
+    }
+  }
+
   @Test
   public void sendUploadPartRequest_error() throws Exception {
     HttpRequestHandler handler =

From a33268c256e751250d846c80f8bc09e0bb3d4401 Mon Sep 17 00:00:00 2001
From: Dhriti Chopra 
Date: Thu, 13 Nov 2025 17:00:13 +0530
Subject: [PATCH 16/26] fix: Adding & to request uri builder

---
 .../google/cloud/storage/MultipartUploadHttpRequestManager.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java
index d6a92c1807..09278a6026 100644
--- a/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java
+++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java
@@ -139,7 +139,7 @@ ListMultipartUploadsResponse sendListMultipartUploadsRequest(
     String listUri =
         UriTemplate.expand(
             uri.toString()
-                + "{bucket}?uploads{delimiter,encoding-type,key-marker,max-uploads,prefix,upload-id-marker}",
+                + "{bucket}?uploads{&delimiter,encoding-type,key-marker,max-uploads,prefix,upload-id-marker}",
             params.build(),
             false);
     System.out.println(listUri);

From e14725e279a5753a83d3232eaabaf3018df06406 Mon Sep 17 00:00:00 2001
From: Dhriti Chopra 
Date: Thu, 13 Nov 2025 17:19:42 +0530
Subject: [PATCH 17/26] fix: using String Builder

---
 .../model/MultipartUpload.java                | 25 ++++++++++---------
 1 file changed, 13 insertions(+), 12 deletions(-)

diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/MultipartUpload.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/MultipartUpload.java
index 992f5f99c8..e5ba1b1504 100644
--- a/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/MultipartUpload.java
+++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/MultipartUpload.java
@@ -118,18 +118,19 @@ public int hashCode() {
 
   @Override
   public String toString() {
-    return "MultipartUpload{"
-        + "key='"
-        + key
-        + '\''
-        + ", uploadId='"
-        + uploadId
-        + '\''
-        + ", storageClass="
-        + storageClass
-        + ", initiated="
-        + initiated
-        + "}";
+    return new StringBuilder("MultipartUpload{")
+        .append("key='")
+        .append(key)
+        .append('\'')
+        .append(", uploadId='")
+        .append(uploadId)
+        .append('\'')
+        .append(", storageClass=")
+        .append(storageClass)
+        .append(", initiated=")
+        .append(initiated)
+        .append('}')
+        .toString();
   }
 
   /**

From 310754dc3ecd766f0a25aca599111dd08b11d2df Mon Sep 17 00:00:00 2001
From: Dhriti Chopra 
Date: Fri, 14 Nov 2025 10:17:04 +0530
Subject: [PATCH 18/26] fix: using MoreObjects helper

---
 .../MultipartUploadHttpRequestManager.java    |  1 -
 .../model/ListMultipartUploadsRequest.java    | 20 ++++----
 .../model/ListMultipartUploadsResponse.java   | 49 ++++++-------------
 .../model/MultipartUpload.java                | 18 +++----
 4 files changed, 31 insertions(+), 57 deletions(-)

diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java
index 6c4034912a..3d62a494c7 100644
--- a/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java
+++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java
@@ -142,7 +142,6 @@ ListMultipartUploadsResponse sendListMultipartUploadsRequest(
                 + "{bucket}?uploads{&delimiter,encoding-type,key-marker,max-uploads,prefix,upload-id-marker}",
             params.build(),
             false);
-    System.out.println(listUri);
     HttpRequest httpRequest = requestFactory.buildGetRequest(new GenericUrl(listUri));
     httpRequest.getHeaders().putAll(headerProvider.getHeaders());
     httpRequest.setParser(objectParser);
diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsRequest.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsRequest.java
index 9c0504cbdd..9a8c4a6d47 100644
--- a/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsRequest.java
+++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsRequest.java
@@ -17,6 +17,7 @@
 package com.google.cloud.storage.multipartupload.model;
 
 import com.google.api.core.BetaApi;
+import com.google.common.base.MoreObjects;
 import java.util.Objects;
 
 /**
@@ -159,16 +160,15 @@ public int hashCode() {
 
   @Override
   public String toString() {
-    StringBuilder sb = new StringBuilder("ListMultipartUploadsRequest{");
-    sb.append("bucket='").append(bucket).append("'");
-    sb.append(", delimiter='").append(delimiter).append("'");
-    sb.append(", encodingType='").append(encodingType).append(",");
-    sb.append(", keyMarker='").append(keyMarker).append(",");
-    sb.append(", maxUploads=").append(maxUploads);
-    sb.append(", prefix='").append(prefix).append(",");
-    sb.append(", uploadIdMarker='").append(uploadIdMarker).append(",");
-    sb.append('}');
-    return sb.toString();
+    return MoreObjects.toStringHelper(this)
+        .add("bucket", bucket)
+        .add("delimiter", delimiter)
+        .add("encodingType", encodingType)
+        .add("keyMarker", keyMarker)
+        .add("maxUploads", maxUploads)
+        .add("prefix", prefix)
+        .add("uploadIdMarker", uploadIdMarker)
+        .toString();
   }
 
   /**
diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsResponse.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsResponse.java
index 3192262b8c..6461121300 100644
--- a/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsResponse.java
+++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsResponse.java
@@ -20,6 +20,7 @@
 import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlElementWrapper;
 import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlProperty;
 import com.google.api.core.BetaApi;
+import com.google.common.base.MoreObjects;
 import com.google.common.collect.ImmutableList;
 import java.util.ArrayList;
 import java.util.List;
@@ -288,40 +289,20 @@ public int hashCode() {
 
   @Override
   public String toString() {
-    return "ListMultipartUploadsResponse{"
-        + "uploads="
-        + getUploads()
-        + ", bucket='"
-        + bucket
-        + "'"
-        + ", delimiter='"
-        + delimiter
-        + "'"
-        + ", encodingType='"
-        + encodingType
-        + "'"
-        + ", keyMarker='"
-        + keyMarker
-        + "'"
-        + ", uploadIdMarker='"
-        + uploadIdMarker
-        + "'"
-        + ", nextKeyMarker='"
-        + nextKeyMarker
-        + "'"
-        + ", nextUploadIdMarker='"
-        + nextUploadIdMarker
-        + "'"
-        + ", maxUploads="
-        + maxUploads
-        + ", prefix='"
-        + prefix
-        + "'"
-        + ", isTruncated="
-        + isTruncated
-        + ", commonPrefixes="
-        + getCommonPrefixes()
-        + '}';
+    return MoreObjects.toStringHelper(this)
+        .add("uploads", getUploads())
+        .add("bucket", bucket)
+        .add("delimiter", delimiter)
+        .add("encodingType", encodingType)
+        .add("keyMarker", keyMarker)
+        .add("uploadIdMarker", uploadIdMarker)
+        .add("nextKeyMarker", nextKeyMarker)
+        .add("nextUploadIdMarker", nextUploadIdMarker)
+        .add("maxUploads", maxUploads)
+        .add("prefix", prefix)
+        .add("isTruncated", isTruncated)
+        .add("commonPrefixes", getCommonPrefixes())
+        .toString();
   }
 
   /**
diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/MultipartUpload.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/MultipartUpload.java
index e5ba1b1504..207fc77b04 100644
--- a/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/MultipartUpload.java
+++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/MultipartUpload.java
@@ -19,6 +19,7 @@
 import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlProperty;
 import com.google.api.core.BetaApi;
 import com.google.cloud.storage.StorageClass;
+import com.google.common.base.MoreObjects;
 import java.time.OffsetDateTime;
 import java.util.Objects;
 
@@ -118,18 +119,11 @@ public int hashCode() {
 
   @Override
   public String toString() {
-    return new StringBuilder("MultipartUpload{")
-        .append("key='")
-        .append(key)
-        .append('\'')
-        .append(", uploadId='")
-        .append(uploadId)
-        .append('\'')
-        .append(", storageClass=")
-        .append(storageClass)
-        .append(", initiated=")
-        .append(initiated)
-        .append('}')
+    return MoreObjects.toStringHelper(this)
+        .add("key", key)
+        .add("uploadId", uploadId)
+        .add("storageClass", storageClass)
+        .add("initiated", initiated)
         .toString();
   }
 

From d53c735b4303c685f31c094fd1a7e02788ca3967 Mon Sep 17 00:00:00 2001
From: Dhriti Chopra 
Date: Fri, 14 Nov 2025 10:41:38 +0530
Subject: [PATCH 19/26] Revert "chore: added crc to upload part"

This reverts commit 21fb8fe8c47dd57d2780a3659251444bcb53ed36.
---
 .../cloud/storage/ChecksumResponseParser.java | 34 ++++++----------
 .../model/UploadPartResponse.java             | 39 ++-----------------
 2 files changed, 15 insertions(+), 58 deletions(-)

diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/ChecksumResponseParser.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/ChecksumResponseParser.java
index 2c44565682..4d32cb42e8 100644
--- a/google-cloud-storage/src/main/java/com/google/cloud/storage/ChecksumResponseParser.java
+++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/ChecksumResponseParser.java
@@ -22,25 +22,19 @@
 import java.io.IOException;
 import java.util.Arrays;
 import java.util.Collections;
-import java.util.List;
 import java.util.Map;
+import java.util.Optional;
 import java.util.stream.Collectors;
 
-/** A utility class to parse checksums from an {@link HttpResponse}. */
+/** A utility class to parse {@link HttpResponse} and create a {@link UploadPartResponse}. */
 final class ChecksumResponseParser {
 
-  private static final String X_GOOG_HASH = "x-goog-hash";
-
   private ChecksumResponseParser() {}
 
   static UploadPartResponse parseUploadResponse(HttpResponse response) {
     String eTag = response.getHeaders().getETag();
     Map hashes = extractHashesFromHeader(response);
-    return UploadPartResponse.builder()
-        .eTag(eTag)
-        .md5(hashes.get("md5"))
-        .crc32c(hashes.get("crc32c"))
-        .build();
+    return UploadPartResponse.builder().eTag(eTag).md5(hashes.get("md5")).build();
   }
 
   static CompleteMultipartUploadResponse parseCompleteResponse(HttpResponse response)
@@ -58,18 +52,14 @@ static CompleteMultipartUploadResponse parseCompleteResponse(HttpResponse respon
   }
 
   static Map extractHashesFromHeader(HttpResponse response) {
-    List hashHeaders = response.getHeaders().getHeaderStringValues(X_GOOG_HASH);
-    if (hashHeaders == null || hashHeaders.isEmpty()) {
-      return Collections.emptyMap();
-    }
-
-    return hashHeaders.stream()
-        .flatMap(h -> Arrays.stream(h.split(",")))
-        .map(String::trim)
-        .filter(s -> !s.isEmpty())
-        .map(s -> s.split("=", 2))
-        .filter(a -> a.length == 2)
-        .filter(a -> "crc32c".equalsIgnoreCase(a[0]) || "md5".equalsIgnoreCase(a[0]))
-        .collect(Collectors.toMap(a -> a[0].toLowerCase(), a -> a[1], (v1, v2) -> v1));
+    return Optional.ofNullable(response.getHeaders().getFirstHeaderStringValue("x-goog-hash"))
+        .map(
+            h ->
+                Arrays.stream(h.split(","))
+                    .map(s -> s.trim().split("=", 2))
+                    .filter(a -> a.length == 2)
+                    .filter(a -> "crc32c".equalsIgnoreCase(a[0]) || "md5".equalsIgnoreCase(a[0]))
+                    .collect(Collectors.toMap(a -> a[0].toLowerCase(), a -> a[1], (v1, v2) -> v1)))
+        .orElse(Collections.emptyMap());
   }
 }
diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/UploadPartResponse.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/UploadPartResponse.java
index 3ea9c0d855..30dc72b0f7 100644
--- a/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/UploadPartResponse.java
+++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/UploadPartResponse.java
@@ -31,12 +31,10 @@ public final class UploadPartResponse {
 
   private final String eTag;
   private final String md5;
-  private final String crc32c;
 
   private UploadPartResponse(Builder builder) {
     this.eTag = builder.etag;
     this.md5 = builder.md5;
-    this.crc32c = builder.crc32c;
   }
 
   /**
@@ -61,17 +59,6 @@ public String md5() {
     return md5;
   }
 
-  /**
-   * Returns the CRC32C checksum of the uploaded part.
-   *
-   * @return The CRC32C checksum.
-   * @since 2.60.0 This new api is in preview and is subject to breaking changes.
-   */
-  @BetaApi
-  public String crc32c() {
-    return crc32c;
-  }
-
   @Override
   public boolean equals(Object o) {
     if (this == o) {
@@ -81,23 +68,17 @@ public boolean equals(Object o) {
       return false;
     }
     UploadPartResponse that = (UploadPartResponse) o;
-    return Objects.equals(eTag, that.eTag)
-        && Objects.equals(md5, that.md5)
-        && Objects.equals(crc32c, that.crc32c);
+    return Objects.equals(eTag, that.eTag) && Objects.equals(md5, that.md5);
   }
 
   @Override
   public int hashCode() {
-    return Objects.hash(eTag, md5, crc32c);
+    return Objects.hash(eTag, md5);
   }
 
   @Override
   public String toString() {
-    return MoreObjects.toStringHelper(this)
-        .add("etag", eTag)
-        .add("md5", md5)
-        .add("crc32c", crc32c)
-        .toString();
+    return MoreObjects.toStringHelper(this).add("etag", eTag).add("md5", md5).toString();
   }
 
   /**
@@ -120,7 +101,6 @@ public static Builder builder() {
   public static class Builder {
     private String etag;
     private String md5;
-    private String crc32c;
 
     private Builder() {}
 
@@ -150,19 +130,6 @@ public Builder md5(String md5) {
       return this;
     }
 
-    /**
-     * Sets the CRC32C checksum for the uploaded part.
-     *
-     * @param crc32c The CRC32C checksum.
-     * @return This builder.
-     * @since 2.60.0 This new api is in preview and is subject to breaking changes.
-     */
-    @BetaApi
-    public Builder crc32c(String crc32c) {
-      this.crc32c = crc32c;
-      return this;
-    }
-
     /**
      * Builds the {@code UploadPartResponse} object.
      *

From 0ed2945dae2d96c43ca94f0833d2b8e23f53c0e7 Mon Sep 17 00:00:00 2001
From: Dhriti Chopra 
Date: Fri, 14 Nov 2025 16:12:55 +0530
Subject: [PATCH 20/26] fix: Making function package private

---
 .../multipartupload/model/ListMultipartUploadsResponse.java     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsResponse.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsResponse.java
index 6461121300..461cd03aef 100644
--- a/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsResponse.java
+++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsResponse.java
@@ -316,7 +316,7 @@ public static Builder builder() {
     return new Builder();
   }
 
-  public static class CommonPrefixHelper {
+  static class CommonPrefixHelper {
     @JacksonXmlProperty(localName = "Prefix")
     public String prefix;
   }

From 002fd8bb3b1c873fa6b90f413c0335531d5f78f4 Mon Sep 17 00:00:00 2001
From: Dhriti Chopra 
Date: Tue, 2 Dec 2025 15:11:40 +0530
Subject: [PATCH 21/26] Resolving comments

---
 google-cloud-storage/clirr-ignored-differences.xml        | 8 ++++++++
 .../com/google/cloud/storage/MultipartUploadClient.java   | 6 +++---
 2 files changed, 11 insertions(+), 3 deletions(-)

diff --git a/google-cloud-storage/clirr-ignored-differences.xml b/google-cloud-storage/clirr-ignored-differences.xml
index 7a61b49855..d17b3bbb1c 100644
--- a/google-cloud-storage/clirr-ignored-differences.xml
+++ b/google-cloud-storage/clirr-ignored-differences.xml
@@ -197,5 +197,13 @@
     void flush()
   
 
+  
+  
+    
+    7013
+    com/google/cloud/storage/MultipartUploadClient
+    * *(*)
+  
+
 
 
diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadClient.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadClient.java
index 5c62b74ee0..a12aa4aa90 100644
--- a/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadClient.java
+++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadClient.java
@@ -109,9 +109,9 @@ public abstract CompleteMultipartUploadResponse completeMultipartUpload(
    * @since 2.61.0 This new api is in preview and is subject to breaking changes.
    */
   @BetaApi
-  public ListMultipartUploadsResponse listMultipartUploads(ListMultipartUploadsRequest request) {
-    throw new UnsupportedOperationException("This operation is not yet implemented.");
-  }
+  public abstract ListMultipartUploadsResponse listMultipartUploads(
+      ListMultipartUploadsRequest request);
+
 
   /**
    * Creates a new instance of {@link MultipartUploadClient}.

From 2b2fe9a83300ce3c5e531fa31d2c6f6297d543d9 Mon Sep 17 00:00:00 2001
From: Dhriti Chopra 
Date: Tue, 2 Dec 2025 15:23:31 +0530
Subject: [PATCH 22/26] fix faliures

---
 .../google/cloud/storage/MultipartUploadHttpRequestManager.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java
index b176a51fd5..d2b4049801 100644
--- a/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java
+++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java
@@ -156,7 +156,7 @@ ListMultipartUploadsResponse sendListMultipartUploadsRequest(
     return httpRequest.execute().parseAs(ListMultipartUploadsResponse.class);
   }
 
-  AbortMultipartUploadResponse sendAbortMultipartUploadRequest(AbortMultipartUploadRequest request)
+  AbortMultipartUploadResponse sendAbortMultipartUploadRequest(URI uri, AbortMultipartUploadRequest request)
       throws IOException {
 
     String abortUri =

From 1e162b94d7402a0a98d70ad11ebee86466825b11 Mon Sep 17 00:00:00 2001
From: Dhriti Chopra 
Date: Wed, 3 Dec 2025 02:03:46 +0530
Subject: [PATCH 23/26] Fixes

---
 .../cloud/storage/MultipartUploadClientImpl.java    |  2 +-
 .../storage/MultipartUploadHttpRequestManager.java  |  5 ++---
 .../ITMultipartUploadHttpRequestManagerTest.java    | 13 +++++++++----
 3 files changed, 12 insertions(+), 8 deletions(-)

diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadClientImpl.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadClientImpl.java
index c11e4a80e8..2aecba6232 100644
--- a/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadClientImpl.java
+++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadClientImpl.java
@@ -103,7 +103,7 @@ public UploadPartResponse uploadPart(UploadPartRequest request, RequestBody requ
   public ListMultipartUploadsResponse listMultipartUploads(ListMultipartUploadsRequest request) {
     return retrier.run(
         retryAlgorithmManager.idempotent(),
-        () -> httpRequestManager.sendListMultipartUploadsRequest(uri, request),
+        () -> httpRequestManager.sendListMultipartUploadsRequest(request),
         Decoder.identity());
   }
 }
diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java
index d2b4049801..c1b2852145 100644
--- a/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java
+++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java
@@ -120,8 +120,7 @@ ListPartsResponse sendListPartsRequest(ListPartsRequest request) throws IOExcept
     return httpRequest.execute().parseAs(ListPartsResponse.class);
   }
 
-  ListMultipartUploadsResponse sendListMultipartUploadsRequest(
-      URI uri, ListMultipartUploadsRequest request) throws IOException {
+  ListMultipartUploadsResponse sendListMultipartUploadsRequest(ListMultipartUploadsRequest request) throws IOException {
 
     ImmutableMap.Builder params =
         ImmutableMap.builder().put("bucket", request.bucket());
@@ -156,7 +155,7 @@ ListMultipartUploadsResponse sendListMultipartUploadsRequest(
     return httpRequest.execute().parseAs(ListMultipartUploadsResponse.class);
   }
 
-  AbortMultipartUploadResponse sendAbortMultipartUploadRequest(URI uri, AbortMultipartUploadRequest request)
+  AbortMultipartUploadResponse sendAbortMultipartUploadRequest(AbortMultipartUploadRequest request)
       throws IOException {
 
     String abortUri =
diff --git a/google-cloud-storage/src/test/java/com/google/cloud/storage/ITMultipartUploadHttpRequestManagerTest.java b/google-cloud-storage/src/test/java/com/google/cloud/storage/ITMultipartUploadHttpRequestManagerTest.java
index efc33203c9..51fa700691 100644
--- a/google-cloud-storage/src/test/java/com/google/cloud/storage/ITMultipartUploadHttpRequestManagerTest.java
+++ b/google-cloud-storage/src/test/java/com/google/cloud/storage/ITMultipartUploadHttpRequestManagerTest.java
@@ -21,6 +21,7 @@
 import static io.grpc.netty.shaded.io.netty.handler.codec.http.HttpResponseStatus.OK;
 import static org.junit.Assert.assertThrows;
 
+
 import com.fasterxml.jackson.dataformat.xml.XmlMapper;
 import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule;
 import com.google.api.client.http.HttpResponseException;
@@ -56,6 +57,7 @@
 import io.grpc.netty.shaded.io.netty.handler.codec.http.FullHttpRequest;
 import io.grpc.netty.shaded.io.netty.handler.codec.http.FullHttpResponse;
 import io.grpc.netty.shaded.io.netty.handler.codec.http.HttpResponseStatus;
+import java.net.URI;
 import java.nio.ByteBuffer;
 import java.nio.charset.StandardCharsets;
 import java.time.OffsetDateTime;
@@ -1089,7 +1091,8 @@ public void sendListMultipartUploadsRequest_success() throws Exception {
         };
 
     try (FakeHttpServer fakeHttpServer = FakeHttpServer.of(handler)) {
-      URI endpoint = URI.create(fakeHttpServer.getEndpoint() + "/");
+      MultipartUploadHttpRequestManager multipartUploadHttpRequestManager =
+          MultipartUploadHttpRequestManager.createFrom(fakeHttpServer.getHttpStorageOptions());
 
       ListMultipartUploadsRequest request =
           ListMultipartUploadsRequest.builder()
@@ -1100,7 +1103,7 @@ public void sendListMultipartUploadsRequest_success() throws Exception {
               .build();
 
       ListMultipartUploadsResponse response =
-          multipartUploadHttpRequestManager.sendListMultipartUploadsRequest(endpoint, request);
+          multipartUploadHttpRequestManager.sendListMultipartUploadsRequest(request);
 
       assertThat(response).isNotNull();
       assertThat(response.getBucket()).isEqualTo("test-bucket");
@@ -1125,14 +1128,16 @@ public void sendListMultipartUploadsRequest_error() throws Exception {
         };
 
     try (FakeHttpServer fakeHttpServer = FakeHttpServer.of(handler)) {
-      URI endpoint = URI.create(fakeHttpServer.getEndpoint() + "/");
+      MultipartUploadHttpRequestManager multipartUploadHttpRequestManager =
+          MultipartUploadHttpRequestManager.createFrom(fakeHttpServer.getHttpStorageOptions());
       ListMultipartUploadsRequest request =
           ListMultipartUploadsRequest.builder().bucket("test-bucket").build();
 
       assertThrows(
           HttpResponseException.class,
           () ->
-              multipartUploadHttpRequestManager.sendListMultipartUploadsRequest(endpoint, request));
+              multipartUploadHttpRequestManager.sendListMultipartUploadsRequest(request));
     }
   }
 }
+

From e3305209e0dd9b1af2b8dd8728932a8922ef90c9 Mon Sep 17 00:00:00 2001
From: cloud-java-bot 
Date: Tue, 2 Dec 2025 20:37:28 +0000
Subject: [PATCH 24/26] chore: generate libraries at Tue Dec  2 20:34:14 UTC
 2025

---
 .../com/google/cloud/storage/MultipartUploadClient.java     | 1 -
 .../cloud/storage/MultipartUploadHttpRequestManager.java    | 3 ++-
 .../storage/ITMultipartUploadHttpRequestManagerTest.java    | 6 +-----
 3 files changed, 3 insertions(+), 7 deletions(-)

diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadClient.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadClient.java
index a12aa4aa90..4f80a7083d 100644
--- a/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadClient.java
+++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadClient.java
@@ -112,7 +112,6 @@ public abstract CompleteMultipartUploadResponse completeMultipartUpload(
   public abstract ListMultipartUploadsResponse listMultipartUploads(
       ListMultipartUploadsRequest request);
 
-
   /**
    * Creates a new instance of {@link MultipartUploadClient}.
    *
diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java
index c1b2852145..dcf6d19311 100644
--- a/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java
+++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java
@@ -120,7 +120,8 @@ ListPartsResponse sendListPartsRequest(ListPartsRequest request) throws IOExcept
     return httpRequest.execute().parseAs(ListPartsResponse.class);
   }
 
-  ListMultipartUploadsResponse sendListMultipartUploadsRequest(ListMultipartUploadsRequest request) throws IOException {
+  ListMultipartUploadsResponse sendListMultipartUploadsRequest(ListMultipartUploadsRequest request)
+      throws IOException {
 
     ImmutableMap.Builder params =
         ImmutableMap.builder().put("bucket", request.bucket());
diff --git a/google-cloud-storage/src/test/java/com/google/cloud/storage/ITMultipartUploadHttpRequestManagerTest.java b/google-cloud-storage/src/test/java/com/google/cloud/storage/ITMultipartUploadHttpRequestManagerTest.java
index 51fa700691..673340628a 100644
--- a/google-cloud-storage/src/test/java/com/google/cloud/storage/ITMultipartUploadHttpRequestManagerTest.java
+++ b/google-cloud-storage/src/test/java/com/google/cloud/storage/ITMultipartUploadHttpRequestManagerTest.java
@@ -21,7 +21,6 @@
 import static io.grpc.netty.shaded.io.netty.handler.codec.http.HttpResponseStatus.OK;
 import static org.junit.Assert.assertThrows;
 
-
 import com.fasterxml.jackson.dataformat.xml.XmlMapper;
 import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule;
 import com.google.api.client.http.HttpResponseException;
@@ -57,7 +56,6 @@
 import io.grpc.netty.shaded.io.netty.handler.codec.http.FullHttpRequest;
 import io.grpc.netty.shaded.io.netty.handler.codec.http.FullHttpResponse;
 import io.grpc.netty.shaded.io.netty.handler.codec.http.HttpResponseStatus;
-import java.net.URI;
 import java.nio.ByteBuffer;
 import java.nio.charset.StandardCharsets;
 import java.time.OffsetDateTime;
@@ -1135,9 +1133,7 @@ public void sendListMultipartUploadsRequest_error() throws Exception {
 
       assertThrows(
           HttpResponseException.class,
-          () ->
-              multipartUploadHttpRequestManager.sendListMultipartUploadsRequest(request));
+          () -> multipartUploadHttpRequestManager.sendListMultipartUploadsRequest(request));
     }
   }
 }
-

From a1b125d63ec26e9a16965afd278149efa201b299 Mon Sep 17 00:00:00 2001
From: Dhriti Chopra 
Date: Wed, 3 Dec 2025 18:08:32 +0530
Subject: [PATCH 25/26] Resolving comments

---
 .../model/ListMultipartUploadsResponse.java   | 60 ++++++------
 ...MultipartUploadHttpRequestManagerTest.java | 94 +++++++++++++------
 2 files changed, 96 insertions(+), 58 deletions(-)

diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsResponse.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsResponse.java
index 461cd03aef..d43184bc15 100644
--- a/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsResponse.java
+++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/multipartupload/model/ListMultipartUploadsResponse.java
@@ -119,7 +119,7 @@ private ListMultipartUploadsResponse(
    * @since 2.61.0 This new api is in preview and is subject to breaking changes.
    */
   @BetaApi
-  public ImmutableList getUploads() {
+  public ImmutableList uploads() {
     return uploads == null ? ImmutableList.of() : ImmutableList.copyOf(uploads);
   }
 
@@ -130,7 +130,7 @@ public ImmutableList getUploads() {
    * @since 2.61.0 This new api is in preview and is subject to breaking changes.
    */
   @BetaApi
-  public String getBucket() {
+  public String bucket() {
     return bucket;
   }
 
@@ -141,7 +141,7 @@ public String getBucket() {
    * @since 2.61.0 This new api is in preview and is subject to breaking changes.
    */
   @BetaApi
-  public String getDelimiter() {
+  public String delimiter() {
     return delimiter;
   }
 
@@ -152,7 +152,7 @@ public String getDelimiter() {
    * @since 2.61.0 This new api is in preview and is subject to breaking changes.
    */
   @BetaApi
-  public String getEncodingType() {
+  public String encodingType() {
     return encodingType;
   }
 
@@ -163,7 +163,7 @@ public String getEncodingType() {
    * @since 2.61.0 This new api is in preview and is subject to breaking changes.
    */
   @BetaApi
-  public String getKeyMarker() {
+  public String keyMarker() {
     return keyMarker;
   }
 
@@ -174,7 +174,7 @@ public String getKeyMarker() {
    * @since 2.61.0 This new api is in preview and is subject to breaking changes.
    */
   @BetaApi
-  public String getUploadIdMarker() {
+  public String uploadIdMarker() {
     return uploadIdMarker;
   }
 
@@ -185,7 +185,7 @@ public String getUploadIdMarker() {
    * @since 2.61.0 This new api is in preview and is subject to breaking changes.
    */
   @BetaApi
-  public String getNextKeyMarker() {
+  public String nextKeyMarker() {
     return nextKeyMarker;
   }
 
@@ -196,7 +196,7 @@ public String getNextKeyMarker() {
    * @since 2.61.0 This new api is in preview and is subject to breaking changes.
    */
   @BetaApi
-  public String getNextUploadIdMarker() {
+  public String nextUploadIdMarker() {
     return nextUploadIdMarker;
   }
 
@@ -207,7 +207,7 @@ public String getNextUploadIdMarker() {
    * @since 2.61.0 This new api is in preview and is subject to breaking changes.
    */
   @BetaApi
-  public int getMaxUploads() {
+  public int maxUploads() {
     return maxUploads;
   }
 
@@ -218,7 +218,7 @@ public int getMaxUploads() {
    * @since 2.61.0 This new api is in preview and is subject to breaking changes.
    */
   @BetaApi
-  public String getPrefix() {
+  public String prefix() {
     return prefix;
   }
 
@@ -229,7 +229,7 @@ public String getPrefix() {
    * @since 2.61.0 This new api is in preview and is subject to breaking changes.
    */
   @BetaApi
-  public boolean isTruncated() {
+  public boolean truncated() {
     return isTruncated;
   }
 
@@ -240,7 +240,7 @@ public boolean isTruncated() {
    * @since 2.61.0 This new api is in preview and is subject to breaking changes.
    */
   @BetaApi
-  public ImmutableList getCommonPrefixes() {
+  public ImmutableList commonPrefixes() {
     if (commonPrefixes == null) {
       return ImmutableList.of();
     }
@@ -258,7 +258,7 @@ public boolean equals(Object o) {
     ListMultipartUploadsResponse that = (ListMultipartUploadsResponse) o;
     return isTruncated == that.isTruncated
         && maxUploads == that.maxUploads
-        && Objects.equals(getUploads(), that.getUploads())
+        && Objects.equals(uploads(), that.uploads())
         && Objects.equals(bucket, that.bucket)
         && Objects.equals(delimiter, that.delimiter)
         && Objects.equals(encodingType, that.encodingType)
@@ -267,13 +267,13 @@ public boolean equals(Object o) {
         && Objects.equals(nextKeyMarker, that.nextKeyMarker)
         && Objects.equals(nextUploadIdMarker, that.nextUploadIdMarker)
         && Objects.equals(prefix, that.prefix)
-        && Objects.equals(getCommonPrefixes(), that.getCommonPrefixes());
+        && Objects.equals(commonPrefixes(), that.commonPrefixes());
   }
 
   @Override
   public int hashCode() {
     return Objects.hash(
-        getUploads(),
+        uploads(),
         bucket,
         delimiter,
         encodingType,
@@ -284,13 +284,13 @@ public int hashCode() {
         maxUploads,
         prefix,
         isTruncated,
-        getCommonPrefixes());
+        commonPrefixes());
   }
 
   @Override
   public String toString() {
     return MoreObjects.toStringHelper(this)
-        .add("uploads", getUploads())
+        .add("uploads", uploads())
         .add("bucket", bucket)
         .add("delimiter", delimiter)
         .add("encodingType", encodingType)
@@ -301,7 +301,7 @@ public String toString() {
         .add("maxUploads", maxUploads)
         .add("prefix", prefix)
         .add("isTruncated", isTruncated)
-        .add("commonPrefixes", getCommonPrefixes())
+        .add("commonPrefixes", commonPrefixes())
         .toString();
   }
 
@@ -351,7 +351,7 @@ private Builder() {}
      * @since 2.61.0 This new api is in preview.
      */
     @BetaApi
-    public Builder setUploads(ImmutableList uploads) {
+    public Builder uploads(ImmutableList uploads) {
       this.uploads = uploads;
       return this;
     }
@@ -364,7 +364,7 @@ public Builder setUploads(ImmutableList uploads) {
      * @since 2.61.0 This new api is in preview.
      */
     @BetaApi
-    public Builder setBucket(String bucket) {
+    public Builder bucket(String bucket) {
       this.bucket = bucket;
       return this;
     }
@@ -377,7 +377,7 @@ public Builder setBucket(String bucket) {
      * @since 2.61.0 This new api is in preview.
      */
     @BetaApi
-    public Builder setDelimiter(String delimiter) {
+    public Builder delimiter(String delimiter) {
       this.delimiter = delimiter;
       return this;
     }
@@ -390,7 +390,7 @@ public Builder setDelimiter(String delimiter) {
      * @since 2.61.0 This new api is in preview.
      */
     @BetaApi
-    public Builder setEncodingType(String encodingType) {
+    public Builder encodingType(String encodingType) {
       this.encodingType = encodingType;
       return this;
     }
@@ -403,7 +403,7 @@ public Builder setEncodingType(String encodingType) {
      * @since 2.61.0 This new api is in preview.
      */
     @BetaApi
-    public Builder setKeyMarker(String keyMarker) {
+    public Builder keyMarker(String keyMarker) {
       this.keyMarker = keyMarker;
       return this;
     }
@@ -416,7 +416,7 @@ public Builder setKeyMarker(String keyMarker) {
      * @since 2.61.0 This new api is in preview.
      */
     @BetaApi
-    public Builder setUploadIdMarker(String uploadIdMarker) {
+    public Builder uploadIdMarker(String uploadIdMarker) {
       this.uploadIdMarker = uploadIdMarker;
       return this;
     }
@@ -429,7 +429,7 @@ public Builder setUploadIdMarker(String uploadIdMarker) {
      * @since 2.61.0 This new api is in preview.
      */
     @BetaApi
-    public Builder setNextKeyMarker(String nextKeyMarker) {
+    public Builder nextKeyMarker(String nextKeyMarker) {
       this.nextKeyMarker = nextKeyMarker;
       return this;
     }
@@ -442,7 +442,7 @@ public Builder setNextKeyMarker(String nextKeyMarker) {
      * @since 2.61.0 This new api is in preview.
      */
     @BetaApi
-    public Builder setNextUploadIdMarker(String nextUploadIdMarker) {
+    public Builder nextUploadIdMarker(String nextUploadIdMarker) {
       this.nextUploadIdMarker = nextUploadIdMarker;
       return this;
     }
@@ -455,7 +455,7 @@ public Builder setNextUploadIdMarker(String nextUploadIdMarker) {
      * @since 2.61.0 This new api is in preview.
      */
     @BetaApi
-    public Builder setMaxUploads(int maxUploads) {
+    public Builder maxUploads(int maxUploads) {
       this.maxUploads = maxUploads;
       return this;
     }
@@ -468,7 +468,7 @@ public Builder setMaxUploads(int maxUploads) {
      * @since 2.61.0 This new api is in preview.
      */
     @BetaApi
-    public Builder setPrefix(String prefix) {
+    public Builder prefix(String prefix) {
       this.prefix = prefix;
       return this;
     }
@@ -481,7 +481,7 @@ public Builder setPrefix(String prefix) {
      * @since 2.61.0 This new api is in preview.
      */
     @BetaApi
-    public Builder setTruncated(boolean isTruncated) {
+    public Builder truncated(boolean isTruncated) {
       this.isTruncated = isTruncated;
       return this;
     }
@@ -494,7 +494,7 @@ public Builder setTruncated(boolean isTruncated) {
      * @since 2.61.0 This new api is in preview.
      */
     @BetaApi
-    public Builder setCommonPrefixes(ImmutableList commonPrefixes) {
+    public Builder commonPrefixes(ImmutableList commonPrefixes) {
       this.commonPrefixes = commonPrefixes;
       return this;
     }
diff --git a/google-cloud-storage/src/test/java/com/google/cloud/storage/ITMultipartUploadHttpRequestManagerTest.java b/google-cloud-storage/src/test/java/com/google/cloud/storage/ITMultipartUploadHttpRequestManagerTest.java
index 673340628a..a8f9ba35c8 100644
--- a/google-cloud-storage/src/test/java/com/google/cloud/storage/ITMultipartUploadHttpRequestManagerTest.java
+++ b/google-cloud-storage/src/test/java/com/google/cloud/storage/ITMultipartUploadHttpRequestManagerTest.java
@@ -21,6 +21,12 @@
 import static io.grpc.netty.shaded.io.netty.handler.codec.http.HttpResponseStatus.OK;
 import static org.junit.Assert.assertThrows;
 
+import com.fasterxml.jackson.annotation.JsonAutoDetect;
+import com.fasterxml.jackson.annotation.PropertyAccessor;
+import com.fasterxml.jackson.core.JsonGenerator;
+import com.fasterxml.jackson.databind.JsonSerializer;
+import com.fasterxml.jackson.databind.SerializerProvider;
+import com.fasterxml.jackson.databind.module.SimpleModule;
 import com.fasterxml.jackson.dataformat.xml.XmlMapper;
 import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule;
 import com.google.api.client.http.HttpResponseException;
@@ -75,6 +81,19 @@ public final class ITMultipartUploadHttpRequestManagerTest {
   static {
     xmlMapper = new XmlMapper();
     xmlMapper.registerModule(new JavaTimeModule());
+    xmlMapper.setVisibility(PropertyAccessor.FIELD, JsonAutoDetect.Visibility.ANY);
+    SimpleModule module = new SimpleModule();
+    module.addSerializer(
+        StorageClass.class,
+        new JsonSerializer() {
+          @Override
+          public void serialize(
+              StorageClass value, JsonGenerator gen, SerializerProvider serializers)
+              throws java.io.IOException {
+            gen.writeString(value.toString());
+          }
+        });
+    xmlMapper.registerModule(module);
   }
 
   @Rule public final TemporaryFolder temp = new TemporaryFolder();
@@ -1059,33 +1078,40 @@ public void sendUploadPartRequest_error() throws Exception {
 
   @Test
   public void sendListMultipartUploadsRequest_success() throws Exception {
-    String mockXmlResponse =
-        ""
-            + "  test-bucket"
-            + "  key-marker"
-            + "  upload-id-marker"
-            + "  next-key-marker"
-            + "  next-upload-id-marker"
-            + "  1"
-            + "  false"
-            + "  "
-            + "    test-key"
-            + "    test-upload-id"
-            + "    STANDARD"
-            + "    2025-11-11T00:00:00Z"
-            + "  "
-            + "";
-
     HttpRequestHandler handler =
         req -> {
-          ByteBuf buf = Unpooled.wrappedBuffer(mockXmlResponse.getBytes(StandardCharsets.UTF_8));
-
-          DefaultFullHttpResponse resp =
-              new DefaultFullHttpResponse(req.protocolVersion(), OK, buf);
-
-          resp.headers().set("Content-Type", "application/xml; charset=utf-8");
-          resp.headers().set("Content-Length", resp.content().readableBytes());
-          return resp;
+            ListMultipartUploadsResponse listMultipartUploadsResponse =
+                ListMultipartUploadsResponse.builder()
+                    .bucket("test-bucket")
+                    .keyMarker("key-marker")
+                    .uploadIdMarker("upload-id-marker")
+                    .nextKeyMarker("next-key-marker")
+                    .nextUploadIdMarker("next-upload-id-marker")
+                    .maxUploads(1)
+                    .truncated(false)
+                    .uploads(
+                        ImmutableList.of(
+                            MultipartUpload.newBuilder()
+                                .setKey("test-key")
+                                .setUploadId("test-upload-id")
+                                .setStorageClass(StorageClass.STANDARD)
+                                .setInitiated(
+                                    OffsetDateTime.of(2025, 11, 11, 0, 0, 0, 0, ZoneOffset.UTC))
+                                .build()))
+                    .build();
+            // Jackson fails to serialize ImmutableList without GuavaModule.
+            // We use reflection to replace it with ArrayList for the test.
+            forceSetUploads(listMultipartUploadsResponse, listMultipartUploadsResponse.uploads());
+
+            ByteBuf buf =
+                Unpooled.wrappedBuffer(xmlMapper.writeValueAsBytes(listMultipartUploadsResponse));
+
+            DefaultFullHttpResponse resp =
+                new DefaultFullHttpResponse(req.protocolVersion(), OK, buf);
+
+            resp.headers().set("Content-Type", "application/xml; charset=utf-8");
+            resp.headers().set("Content-Length", resp.content().readableBytes());
+            return resp;
         };
 
     try (FakeHttpServer fakeHttpServer = FakeHttpServer.of(handler)) {
@@ -1104,10 +1130,10 @@ public void sendListMultipartUploadsRequest_success() throws Exception {
           multipartUploadHttpRequestManager.sendListMultipartUploadsRequest(request);
 
       assertThat(response).isNotNull();
-      assertThat(response.getBucket()).isEqualTo("test-bucket");
-      assertThat(response.getUploads()).hasSize(1);
+      assertThat(response.bucket()).isEqualTo("test-bucket");
+      assertThat(response.uploads()).hasSize(1);
 
-      MultipartUpload upload = response.getUploads().get(0);
+      MultipartUpload upload = response.uploads().get(0);
       assertThat(upload.getKey()).isEqualTo("test-key");
       assertThat(upload.getStorageClass()).isEqualTo(StorageClass.STANDARD);
       assertThat(upload.getInitiated())
@@ -1136,4 +1162,16 @@ public void sendListMultipartUploadsRequest_error() throws Exception {
           () -> multipartUploadHttpRequestManager.sendListMultipartUploadsRequest(request));
     }
   }
+
+  private void forceSetUploads(
+      ListMultipartUploadsResponse response, java.util.List uploads) {
+    try {
+      java.lang.reflect.Field uploadsField =
+          ListMultipartUploadsResponse.class.getDeclaredField("uploads");
+      uploadsField.setAccessible(true);
+      uploadsField.set(response, new java.util.ArrayList<>(uploads));
+    } catch (Exception e) {
+      throw new RuntimeException(e);
+    }
+  }
 }

From dcb23d5c5ecb012b39df433784259889713ade3c Mon Sep 17 00:00:00 2001
From: cloud-java-bot 
Date: Wed, 3 Dec 2025 12:45:09 +0000
Subject: [PATCH 26/26] chore: generate libraries at Wed Dec  3 12:42:52 UTC
 2025

---
 ...MultipartUploadHttpRequestManagerTest.java | 64 +++++++++----------
 1 file changed, 32 insertions(+), 32 deletions(-)

diff --git a/google-cloud-storage/src/test/java/com/google/cloud/storage/ITMultipartUploadHttpRequestManagerTest.java b/google-cloud-storage/src/test/java/com/google/cloud/storage/ITMultipartUploadHttpRequestManagerTest.java
index a8f9ba35c8..ae8934fd6e 100644
--- a/google-cloud-storage/src/test/java/com/google/cloud/storage/ITMultipartUploadHttpRequestManagerTest.java
+++ b/google-cloud-storage/src/test/java/com/google/cloud/storage/ITMultipartUploadHttpRequestManagerTest.java
@@ -1080,38 +1080,38 @@ public void sendUploadPartRequest_error() throws Exception {
   public void sendListMultipartUploadsRequest_success() throws Exception {
     HttpRequestHandler handler =
         req -> {
-            ListMultipartUploadsResponse listMultipartUploadsResponse =
-                ListMultipartUploadsResponse.builder()
-                    .bucket("test-bucket")
-                    .keyMarker("key-marker")
-                    .uploadIdMarker("upload-id-marker")
-                    .nextKeyMarker("next-key-marker")
-                    .nextUploadIdMarker("next-upload-id-marker")
-                    .maxUploads(1)
-                    .truncated(false)
-                    .uploads(
-                        ImmutableList.of(
-                            MultipartUpload.newBuilder()
-                                .setKey("test-key")
-                                .setUploadId("test-upload-id")
-                                .setStorageClass(StorageClass.STANDARD)
-                                .setInitiated(
-                                    OffsetDateTime.of(2025, 11, 11, 0, 0, 0, 0, ZoneOffset.UTC))
-                                .build()))
-                    .build();
-            // Jackson fails to serialize ImmutableList without GuavaModule.
-            // We use reflection to replace it with ArrayList for the test.
-            forceSetUploads(listMultipartUploadsResponse, listMultipartUploadsResponse.uploads());
-
-            ByteBuf buf =
-                Unpooled.wrappedBuffer(xmlMapper.writeValueAsBytes(listMultipartUploadsResponse));
-
-            DefaultFullHttpResponse resp =
-                new DefaultFullHttpResponse(req.protocolVersion(), OK, buf);
-
-            resp.headers().set("Content-Type", "application/xml; charset=utf-8");
-            resp.headers().set("Content-Length", resp.content().readableBytes());
-            return resp;
+          ListMultipartUploadsResponse listMultipartUploadsResponse =
+              ListMultipartUploadsResponse.builder()
+                  .bucket("test-bucket")
+                  .keyMarker("key-marker")
+                  .uploadIdMarker("upload-id-marker")
+                  .nextKeyMarker("next-key-marker")
+                  .nextUploadIdMarker("next-upload-id-marker")
+                  .maxUploads(1)
+                  .truncated(false)
+                  .uploads(
+                      ImmutableList.of(
+                          MultipartUpload.newBuilder()
+                              .setKey("test-key")
+                              .setUploadId("test-upload-id")
+                              .setStorageClass(StorageClass.STANDARD)
+                              .setInitiated(
+                                  OffsetDateTime.of(2025, 11, 11, 0, 0, 0, 0, ZoneOffset.UTC))
+                              .build()))
+                  .build();
+          // Jackson fails to serialize ImmutableList without GuavaModule.
+          // We use reflection to replace it with ArrayList for the test.
+          forceSetUploads(listMultipartUploadsResponse, listMultipartUploadsResponse.uploads());
+
+          ByteBuf buf =
+              Unpooled.wrappedBuffer(xmlMapper.writeValueAsBytes(listMultipartUploadsResponse));
+
+          DefaultFullHttpResponse resp =
+              new DefaultFullHttpResponse(req.protocolVersion(), OK, buf);
+
+          resp.headers().set("Content-Type", "application/xml; charset=utf-8");
+          resp.headers().set("Content-Length", resp.content().readableBytes());
+          return resp;
         };
 
     try (FakeHttpServer fakeHttpServer = FakeHttpServer.of(handler)) {