From 383315c333a1814a5d2c34cc1064c6649805454b Mon Sep 17 00:00:00 2001 From: cloud-java-bot Date: Thu, 30 Oct 2025 02:31:42 +0000 Subject: [PATCH 01/11] chore: Update generation configuration at Thu Oct 30 02:31:36 UTC 2025 --- generation_config.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/generation_config.yaml b/generation_config.yaml index 80b763025..af71e0b32 100644 --- a/generation_config.yaml +++ b/generation_config.yaml @@ -1,5 +1,5 @@ gapic_generator_version: 2.63.0 -googleapis_commitish: 72e7439c8e7e9986cf1865e337fc7c64ca5bda1f +googleapis_commitish: d0ccd99fb95c25c20355550dafb850e45da99b19 libraries_bom_version: 26.71.0 libraries: - api_shortname: storage From af0aa96d47381e32284dab353d416c8fd9360cff Mon Sep 17 00:00:00 2001 From: cloud-java-bot Date: Fri, 31 Oct 2025 02:30:54 +0000 Subject: [PATCH 02/11] chore: Update generation configuration at Fri Oct 31 02:30:46 UTC 2025 --- generation_config.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/generation_config.yaml b/generation_config.yaml index af71e0b32..8d08a1652 100644 --- a/generation_config.yaml +++ b/generation_config.yaml @@ -1,5 +1,5 @@ gapic_generator_version: 2.63.0 -googleapis_commitish: d0ccd99fb95c25c20355550dafb850e45da99b19 +googleapis_commitish: b6bb60733a7314d0c45e294b12d563fd6194b8f5 libraries_bom_version: 26.71.0 libraries: - api_shortname: storage From 27737f82cfa1bc1f79f7df5a666b75c561d8cd45 Mon Sep 17 00:00:00 2001 From: cloud-java-bot Date: Sat, 1 Nov 2025 02:30:07 +0000 Subject: [PATCH 03/11] chore: Update generation configuration at Sat Nov 1 02:29:58 UTC 2025 --- generation_config.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/generation_config.yaml b/generation_config.yaml index 8d08a1652..bc88276c8 100644 --- a/generation_config.yaml +++ b/generation_config.yaml @@ -1,5 +1,5 @@ gapic_generator_version: 2.63.0 -googleapis_commitish: b6bb60733a7314d0c45e294b12d563fd6194b8f5 +googleapis_commitish: 97763d6efb2d35474e0363c254ee6994837a08fa libraries_bom_version: 26.71.0 libraries: - api_shortname: storage From 55da42c2d0c8a919b46a6597766d69516d3fc110 Mon Sep 17 00:00:00 2001 From: cloud-java-bot Date: Tue, 4 Nov 2025 02:31:33 +0000 Subject: [PATCH 04/11] chore: Update generation configuration at Tue Nov 4 02:31:26 UTC 2025 --- .github/workflows/hermetic_library_generation.yaml | 2 +- generation_config.yaml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/hermetic_library_generation.yaml b/.github/workflows/hermetic_library_generation.yaml index 76c6ec9ee..9872c6848 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.63.0 if: env.SHOULD_RUN == 'true' with: base_ref: ${{ github.base_ref }} diff --git a/generation_config.yaml b/generation_config.yaml index bc88276c8..3f17fe8e8 100644 --- a/generation_config.yaml +++ b/generation_config.yaml @@ -1,5 +1,5 @@ gapic_generator_version: 2.63.0 -googleapis_commitish: 97763d6efb2d35474e0363c254ee6994837a08fa +googleapis_commitish: faa7932e61d781ccb0647d4b25c2b452cb206af4 libraries_bom_version: 26.71.0 libraries: - api_shortname: storage From 2eb4d312a7784718f3104892d30342dd2e2660f3 Mon Sep 17 00:00:00 2001 From: cloud-java-bot Date: Wed, 5 Nov 2025 02:30:16 +0000 Subject: [PATCH 05/11] chore: Update generation configuration at Wed Nov 5 02:30:10 UTC 2025 --- .github/workflows/hermetic_library_generation.yaml | 2 +- generation_config.yaml | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/.github/workflows/hermetic_library_generation.yaml b/.github/workflows/hermetic_library_generation.yaml index 9872c6848..76c6ec9ee 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.63.0 + - uses: googleapis/sdk-platform-java/.github/scripts@v2.64.0 if: env.SHOULD_RUN == 'true' with: base_ref: ${{ github.base_ref }} diff --git a/generation_config.yaml b/generation_config.yaml index 3f17fe8e8..9b32ac242 100644 --- a/generation_config.yaml +++ b/generation_config.yaml @@ -1,5 +1,5 @@ -gapic_generator_version: 2.63.0 -googleapis_commitish: faa7932e61d781ccb0647d4b25c2b452cb206af4 +gapic_generator_version: 2.64.0 +googleapis_commitish: baf777503d79555219eed1acebe01838ca448bb5 libraries_bom_version: 26.71.0 libraries: - api_shortname: storage From 0f72eb6977818a1725fe4e81ceadcfd2706aa421 Mon Sep 17 00:00:00 2001 From: cloud-java-bot Date: Wed, 5 Nov 2025 02:33:00 +0000 Subject: [PATCH 06/11] chore: generate libraries at Wed Nov 5 02:30:40 UTC 2025 --- .kokoro/presubmit/graalvm-native-a.cfg | 2 +- .kokoro/presubmit/graalvm-native-b.cfg | 2 +- .kokoro/presubmit/graalvm-native-c.cfg | 2 +- .../control/v2/StorageControlGrpc.java | 127 ++++++++++-------- .../com/google/storage/v2/StorageGrpc.java | 94 ++++++------- 5 files changed, 123 insertions(+), 104 deletions(-) diff --git a/.kokoro/presubmit/graalvm-native-a.cfg b/.kokoro/presubmit/graalvm-native-a.cfg index 55c5543e2..208f3d56d 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.0" # {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 5c981b984..9a9821ef4 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.0" # {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 f2032499d..479c9b90f 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.0" # {x-version-update:google-cloud-shared-dependencies:current} } env_vars: { 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 a96d0106b..ca0f2beb4 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 b68ebe129..4fc851181 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 @@ -41,9 +41,6 @@ * 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 { @@ -2259,9 +2256,9 @@ protected StorageBlockingV2Stub build( * Permanently deletes an empty 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); } @@ -2272,8 +2269,9 @@ public com.google.protobuf.Empty deleteBucket( * Returns metadata for the specified bucket. * */ - 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); } @@ -2285,8 +2283,8 @@ public com.google.storage.v2.Bucket getBucket(com.google.storage.v2.GetBucketReq * */ 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); } @@ -2298,8 +2296,8 @@ public com.google.storage.v2.Bucket createBucket( * */ 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); } @@ -2311,8 +2309,9 @@ public com.google.storage.v2.ListBucketsResponse listBuckets( * */ 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); } @@ -2327,8 +2326,9 @@ public com.google.storage.v2.Bucket lockBucketRetentionPolicy( * 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); } @@ -2343,8 +2343,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); } @@ -2362,8 +2363,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); } @@ -2375,8 +2376,8 @@ public com.google.iam.v1.TestIamPermissionsResponse testIamPermissions( * */ 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); } @@ -2389,8 +2390,8 @@ public com.google.storage.v2.Bucket updateBucket( * */ 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); } @@ -2417,9 +2418,9 @@ public com.google.storage.v2.Object composeObject( * 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); } @@ -2431,8 +2432,8 @@ public com.google.protobuf.Empty deleteObject( * */ 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); } @@ -2449,8 +2450,8 @@ public com.google.storage.v2.Object restoreObject( * */ 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); } @@ -2466,8 +2467,9 @@ public com.google.storage.v2.CancelResumableWriteResponse cancelResumableWrite( * 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); } @@ -2527,8 +2529,8 @@ public io.grpc.stub.BlockingClientCall */ 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); } @@ -2645,8 +2647,8 @@ public com.google.storage.v2.Object updateObject( * */ 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 +2661,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); } @@ -2682,8 +2684,8 @@ public com.google.storage.v2.RewriteResponse rewriteObject( * */ 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); } @@ -2709,8 +2711,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); } @@ -2721,9 +2723,9 @@ public com.google.storage.v2.QueryWriteStatusResponse queryWriteStatus( * Moves the source object to the destination object in the same bucket. * */ - 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); } } From f9a76498a6e46d314a9aa5d7ff443801c05dff20 Mon Sep 17 00:00:00 2001 From: cloud-java-bot Date: Thu, 6 Nov 2025 02:31:37 +0000 Subject: [PATCH 07/11] chore: Update generation configuration at Thu Nov 6 02:31:32 UTC 2025 --- generation_config.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/generation_config.yaml b/generation_config.yaml index 9b32ac242..b85fbe7bb 100644 --- a/generation_config.yaml +++ b/generation_config.yaml @@ -1,5 +1,5 @@ gapic_generator_version: 2.64.0 -googleapis_commitish: baf777503d79555219eed1acebe01838ca448bb5 +googleapis_commitish: e030b932b009475306781259763ca7fde8eb5eb2 libraries_bom_version: 26.71.0 libraries: - api_shortname: storage From a587c2d0cfc2b0040c3e0e6ff7ad17a753207464 Mon Sep 17 00:00:00 2001 From: cloud-java-bot Date: Thu, 6 Nov 2025 02:34:19 +0000 Subject: [PATCH 08/11] chore: generate libraries at Thu Nov 6 02:32:10 UTC 2025 --- .../com/google/storage/v2/StorageClient.java | 981 ++++++--- .../com/google/storage/v2/package-info.java | 27 +- .../com/google/storage/v2/StorageGrpc.java | 1197 ++++++++--- .../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 ++++++---- 82 files changed, 6423 insertions(+), 4658 deletions(-) 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 f2a8178d2..1c0887d4e 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 c250e90f8..cd43b211c 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/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 4fc851181..bdccd24c9 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,21 +24,24 @@
  * ## 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).
  * 
                                            
  */
 @io.grpc.stub.annotations.GrpcGenerated
@@ -1100,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 {
@@ -1124,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(
@@ -1138,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(
@@ -1151,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(
@@ -1164,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(
@@ -1178,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(
@@ -1192,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(
@@ -1210,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}`
@@ -1229,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.
@@ -1249,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(
@@ -1264,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(
@@ -1280,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
@@ -1292,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(
@@ -1308,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(
@@ -1324,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.
      * 
                                            
@@ -1344,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.
      * 
                                            
      */
@@ -1362,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(
@@ -1378,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(
@@ -1405,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(
@@ -1435,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.
      * 
                                            
      */
@@ -1490,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
@@ -1519,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.
      * 
                                            
      */
@@ -1551,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(
@@ -1576,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.
@@ -1605,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(
@@ -1621,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 {
@@ -1653,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 {
@@ -1685,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(
@@ -1701,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(
@@ -1715,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(
@@ -1730,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(
@@ -1746,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(
@@ -1762,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(
@@ -1782,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}`
@@ -1803,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.
@@ -1825,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(
@@ -1842,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(
@@ -1860,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
@@ -1872,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(
@@ -1890,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(
@@ -1908,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.
      * 
                                            
@@ -1930,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.
      * 
                                            
      */
@@ -1949,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(
@@ -1966,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(
@@ -1993,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(
@@ -2025,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.
      * 
                                            
      */
@@ -2080,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
@@ -2109,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.
      * 
                                            
      */
@@ -2145,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(
@@ -2172,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.
@@ -2203,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(
@@ -2220,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
@@ -2254,6 +2477,25 @@ 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)
@@ -2267,6 +2509,13 @@ public com.google.protobuf.Empty deleteBucket(com.google.storage.v2.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)
@@ -2280,6 +2529,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(
@@ -2292,7 +2548,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(
@@ -2305,7 +2568,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(
@@ -2319,11 +2595,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)
@@ -2336,7 +2616,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}`
@@ -2354,9 +2634,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.
@@ -2372,7 +2651,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(
@@ -2386,7 +2674,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(
@@ -2401,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
@@ -2413,9 +2708,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(com.google.storage.v2.DeleteObjectRequest request)
@@ -2428,7 +2721,38 @@ public com.google.protobuf.Empty deleteObject(com.google.storage.v2.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(
@@ -2443,8 +2767,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.
      * 
                                            
@@ -2461,9 +2785,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.
      * 
                                            
      */
@@ -2479,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")
@@ -2496,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")
@@ -2525,7 +2842,9 @@ 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(
@@ -2554,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.
      * 
                                            
      */
@@ -2611,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")
@@ -2641,8 +2960,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.
      * 
                                            
      */
@@ -2671,16 +2990,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(
@@ -2694,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.
@@ -2721,6 +3038,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(com.google.storage.v2.MoveObjectRequest request)
@@ -2737,21 +3064,24 @@ public com.google.storage.v2.Object moveObject(com.google.storage.v2.MoveObjectR
    * ## 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
@@ -2770,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(
@@ -2783,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) {
@@ -2795,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(
@@ -2807,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(
@@ -2820,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(
@@ -2833,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) {
@@ -2849,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}`
@@ -2866,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.
@@ -2884,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(
@@ -2898,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(
@@ -2913,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
@@ -2925,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(
@@ -2940,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(
@@ -2955,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.
      * 
                                            
@@ -2973,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.
      * 
                                            
      */
@@ -2990,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(
@@ -3006,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(
@@ -3022,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.
      * 
                                            
      */
@@ -3052,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(
@@ -3075,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.
@@ -3102,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(
@@ -3118,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
@@ -3151,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
@@ -3164,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
@@ -3177,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
@@ -3189,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<
@@ -3203,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
@@ -3216,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
@@ -3233,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}`
@@ -3251,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.
@@ -3270,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
@@ -3284,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
@@ -3299,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
@@ -3311,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
@@ -3326,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
@@ -3341,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.
      * 
                                            
@@ -3360,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.
      * 
                                            
      */
@@ -3377,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
@@ -3393,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.
      * 
                                            
      */
@@ -3424,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<
@@ -3448,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.
@@ -3476,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 f06e35065..7cedc36da 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 1f3642ae3..489924de7 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 3bf53ad54..90c60b537 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 97f2b0ca5..423c663e5 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 fe5c964b9..473c6030a 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 faf2cf996..12da44f00 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 a2153c64a..511010dff 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 e73610a3d..95c96e91f 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 351816bbe..baa53920b 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 9b4e87d91..63ba0c2c8 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 6859b67d6..56673655f 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 65e5149c7..e86ed2a82 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 d785d0a37..9932c5982 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 82f32c15d..beaef65e1 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 87a4ad425..18c12adff 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 adb098818..4224583eb 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 e1f30195f..20f5aac8e 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 34457ee6a..8976401ba 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 617f2d175..207c401c0 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 ad4d5e041..78ba0b195 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 85135aace..43c897e58 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 9f5b93120..a3b2d5d01 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 f04c659c3..87068a617 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 152703df5..46fcde480 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 80c644af5..b48bb51c9 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 f329aea4f..4119c7784 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 f242141cd..0994d8309 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 4063d0640..5eabc026c 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 68ab235b1..256de39c8 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 ec1f60218..7c646f219 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 9fbbb6cb8..44e4d733a 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 048d27d27..65ba3e848 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 4d3966842..2089b35ae 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 ca1a62ceb..86004338e 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 d5c9974e5..fed5323d2 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 a184b3b8a..d63a19fbf 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 884f2cefb..f6255e491 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 167c7ca79..8ecb77cdf 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 85afd4ef4..e6e530df5 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 a18c229eb..f347139e4 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 5746479f0..eed2d224d 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 cec4a76d0..a01df7f8f 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 3a1ac1905..09aefff18 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 b67203a8e..c208a63ed 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 a9e86271f..3db3ee0b5 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 90ccca273..1202cbf6e 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 74dd22cd3..a01cfa93d 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 609210383..bc893f63c 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 f64015ce1..4a49f72e3 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 2553efad7..df677480d 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 9c0b359da..cdf088061 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 bb752cab9..e1c937f1f 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 4ca846b2b..d36df6ba9 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 d20588576..a26e62dfb 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 a3648a25d..53c8ab877 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 2034decec..1a3db73f7 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 b9216e35b..2c703e565 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 73e000292..9b2742318 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 18f944bae..2756d8567 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 dda55f6dd..f8d909bf2 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 40056c80b..d005aa9ec 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 f2f8ebca2..4d769d6ca 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 db495cbe8..63f0e5e51 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 c74fc7eca..c444ea33c 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 1093a2fd3..159a8db66 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 e13983e93..a5513bdb7 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 78c222f6b..e897c28d9 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 90c469445..0e26c2ac5 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 36d6c8d9e..382d61511 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 fa91ddf16..178cae0c4 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 602130478..93fd23008 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 1f53e8690..4d13e6ade 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 9a78998a0..ef65cfc7a 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 8e6c29b41..d0309716c 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 08203ad7e..0446b25e5 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 416e19649..31143cc8f 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 eec27356f..1bbf0baa8 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 edc6a4218..3cdb5ee71 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 cb677d47d..95eb2832d 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 ac55d543b6784b561ae48ecb47c53b9853b6aeb6 Mon Sep 17 00:00:00 2001
From: cloud-java-bot 
Date: Fri, 7 Nov 2025 02:30:55 +0000
Subject: [PATCH 09/11] chore: Update generation configuration at Fri Nov  7
 02:30:48 UTC 2025

---
 generation_config.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/generation_config.yaml b/generation_config.yaml
index b85fbe7bb..42553e328 100644
--- a/generation_config.yaml
+++ b/generation_config.yaml
@@ -1,5 +1,5 @@
 gapic_generator_version: 2.64.0
-googleapis_commitish: e030b932b009475306781259763ca7fde8eb5eb2
+googleapis_commitish: 9fcfbea0aa5b50fa22e190faceb073d74504172b
 libraries_bom_version: 26.71.0
 libraries:
   - api_shortname: storage

From af71bcb46dd6aea192fd4de798f1728b9ff05b7c Mon Sep 17 00:00:00 2001
From: cloud-java-bot 
Date: Sat, 8 Nov 2025 02:27:07 +0000
Subject: [PATCH 10/11] chore: Update generation configuration at Sat Nov  8
 02:26:58 UTC 2025

---
 .github/workflows/hermetic_library_generation.yaml | 2 +-
 generation_config.yaml                             | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/hermetic_library_generation.yaml b/.github/workflows/hermetic_library_generation.yaml
index 76c6ec9ee..005c97c7d 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/generation_config.yaml b/generation_config.yaml
index 42553e328..4cc603a6f 100644
--- a/generation_config.yaml
+++ b/generation_config.yaml
@@ -1,5 +1,5 @@
-gapic_generator_version: 2.64.0
-googleapis_commitish: 9fcfbea0aa5b50fa22e190faceb073d74504172b
+gapic_generator_version: 2.64.1
+googleapis_commitish: 1b5f8632487bce889ce05366647addc6ef5ee36d
 libraries_bom_version: 26.71.0
 libraries:
   - api_shortname: storage

From 5c62ee417cff733fb78dd12346f0a91e3e2e88e5 Mon Sep 17 00:00:00 2001
From: cloud-java-bot 
Date: Sat, 8 Nov 2025 02:29:43 +0000
Subject: [PATCH 11/11] chore: generate libraries at Sat Nov  8 02:27:31 UTC
 2025

---
 .kokoro/presubmit/graalvm-native-a.cfg | 2 +-
 .kokoro/presubmit/graalvm-native-b.cfg | 2 +-
 .kokoro/presubmit/graalvm-native-c.cfg | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/presubmit/graalvm-native-a.cfg b/.kokoro/presubmit/graalvm-native-a.cfg
index 208f3d56d..b772eac66 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.54.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 9a9821ef4..baf136cf8 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.54.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 479c9b90f..2fb2fc87c 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.54.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: {