diff --git a/java-common-protos/proto-google-common-protos/src/main/java/com/google/api/ClientProto.java b/java-common-protos/proto-google-common-protos/src/main/java/com/google/api/ClientProto.java
index 4680c28e0d..d1402599d5 100644
--- a/java-common-protos/proto-google-common-protos/src/main/java/com/google/api/ClientProto.java
+++ b/java-common-protos/proto-google-common-protos/src/main/java/com/google/api/ClientProto.java
@@ -193,69 +193,69 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
"\n\027google/api/client.proto\022\ngoogle.api\032\035g"
+ "oogle/api/launch_stage.proto\032 google/pro"
+ "tobuf/descriptor.proto\032\036google/protobuf/"
- + "duration.proto\"p\n\026CommonLanguageSettings"
- + "\022\032\n\022reference_docs_uri\030\001 \001(\t\022:\n\014destinat"
- + "ions\030\002 \003(\0162$.google.api.ClientLibraryDes"
- + "tination\"\373\003\n\025ClientLibrarySettings\022\017\n\007ve"
- + "rsion\030\001 \001(\t\022-\n\014launch_stage\030\002 \001(\0162\027.goog"
- + "le.api.LaunchStage\022\032\n\022rest_numeric_enums"
- + "\030\003 \001(\010\022/\n\rjava_settings\030\025 \001(\0132\030.google.a"
- + "pi.JavaSettings\022-\n\014cpp_settings\030\026 \001(\0132\027."
- + "google.api.CppSettings\022-\n\014php_settings\030\027"
- + " \001(\0132\027.google.api.PhpSettings\0223\n\017python_"
- + "settings\030\030 \001(\0132\032.google.api.PythonSettin"
- + "gs\022/\n\rnode_settings\030\031 \001(\0132\030.google.api.N"
- + "odeSettings\0223\n\017dotnet_settings\030\032 \001(\0132\032.g"
- + "oogle.api.DotnetSettings\022/\n\rruby_setting"
- + "s\030\033 \001(\0132\030.google.api.RubySettings\022+\n\013go_"
- + "settings\030\034 \001(\0132\026.google.api.GoSettings\"\323"
- + "\002\n\nPublishing\0223\n\017method_settings\030\002 \003(\0132\032"
- + ".google.api.MethodSettings\022\025\n\rnew_issue_"
- + "uri\030e \001(\t\022\031\n\021documentation_uri\030f \001(\t\022\026\n\016"
- + "api_short_name\030g \001(\t\022\024\n\014github_label\030h \001"
- + "(\t\022\036\n\026codeowner_github_teams\030i \003(\t\022\026\n\016do"
- + "c_tag_prefix\030j \001(\t\022;\n\014organization\030k \001(\016"
- + "2%.google.api.ClientLibraryOrganization\022"
- + ";\n\020library_settings\030m \003(\0132!.google.api.C"
- + "lientLibrarySettings\"\343\001\n\014JavaSettings\022\027\n"
- + "\017library_package\030\001 \001(\t\022L\n\023service_class_"
- + "names\030\002 \003(\0132/.google.api.JavaSettings.Se"
- + "rviceClassNamesEntry\0222\n\006common\030\003 \001(\0132\".g"
- + "oogle.api.CommonLanguageSettings\0328\n\026Serv"
- + "iceClassNamesEntry\022\013\n\003key\030\001 \001(\t\022\r\n\005value"
- + "\030\002 \001(\t:\0028\001\"A\n\013CppSettings\0222\n\006common\030\001 \001("
- + "\0132\".google.api.CommonLanguageSettings\"A\n"
- + "\013PhpSettings\0222\n\006common\030\001 \001(\0132\".google.ap"
- + "i.CommonLanguageSettings\"D\n\016PythonSettin"
- + "gs\0222\n\006common\030\001 \001(\0132\".google.api.CommonLa"
- + "nguageSettings\"B\n\014NodeSettings\0222\n\006common"
- + "\030\001 \001(\0132\".google.api.CommonLanguageSettin"
- + "gs\"D\n\016DotnetSettings\0222\n\006common\030\001 \001(\0132\".g"
- + "oogle.api.CommonLanguageSettings\"B\n\014Ruby"
- + "Settings\0222\n\006common\030\001 \001(\0132\".google.api.Co"
- + "mmonLanguageSettings\"@\n\nGoSettings\0222\n\006co"
+ + "duration.proto\"t\n\026CommonLanguageSettings"
+ + "\022\036\n\022reference_docs_uri\030\001 \001(\tB\002\030\001\022:\n\014dest"
+ + "inations\030\002 \003(\0162$.google.api.ClientLibrar"
+ + "yDestination\"\373\003\n\025ClientLibrarySettings\022\017"
+ + "\n\007version\030\001 \001(\t\022-\n\014launch_stage\030\002 \001(\0162\027."
+ + "google.api.LaunchStage\022\032\n\022rest_numeric_e"
+ + "nums\030\003 \001(\010\022/\n\rjava_settings\030\025 \001(\0132\030.goog"
+ + "le.api.JavaSettings\022-\n\014cpp_settings\030\026 \001("
+ + "\0132\027.google.api.CppSettings\022-\n\014php_settin"
+ + "gs\030\027 \001(\0132\027.google.api.PhpSettings\0223\n\017pyt"
+ + "hon_settings\030\030 \001(\0132\032.google.api.PythonSe"
+ + "ttings\022/\n\rnode_settings\030\031 \001(\0132\030.google.a"
+ + "pi.NodeSettings\0223\n\017dotnet_settings\030\032 \001(\013"
+ + "2\032.google.api.DotnetSettings\022/\n\rruby_set"
+ + "tings\030\033 \001(\0132\030.google.api.RubySettings\022+\n"
+ + "\013go_settings\030\034 \001(\0132\026.google.api.GoSettin"
+ + "gs\"\323\002\n\nPublishing\0223\n\017method_settings\030\002 \003"
+ + "(\0132\032.google.api.MethodSettings\022\025\n\rnew_is"
+ + "sue_uri\030e \001(\t\022\031\n\021documentation_uri\030f \001(\t"
+ + "\022\026\n\016api_short_name\030g \001(\t\022\024\n\014github_label"
+ + "\030h \001(\t\022\036\n\026codeowner_github_teams\030i \003(\t\022\026"
+ + "\n\016doc_tag_prefix\030j \001(\t\022;\n\014organization\030k"
+ + " \001(\0162%.google.api.ClientLibraryOrganizat"
+ + "ion\022;\n\020library_settings\030m \003(\0132!.google.a"
+ + "pi.ClientLibrarySettings\"\343\001\n\014JavaSetting"
+ + "s\022\027\n\017library_package\030\001 \001(\t\022L\n\023service_cl"
+ + "ass_names\030\002 \003(\0132/.google.api.JavaSetting"
+ + "s.ServiceClassNamesEntry\0222\n\006common\030\003 \001(\013"
+ + "2\".google.api.CommonLanguageSettings\0328\n\026"
+ + "ServiceClassNamesEntry\022\013\n\003key\030\001 \001(\t\022\r\n\005v"
+ + "alue\030\002 \001(\t:\0028\001\"A\n\013CppSettings\0222\n\006common\030"
+ + "\001 \001(\0132\".google.api.CommonLanguageSetting"
+ + "s\"A\n\013PhpSettings\0222\n\006common\030\001 \001(\0132\".googl"
+ + "e.api.CommonLanguageSettings\"D\n\016PythonSe"
+ + "ttings\0222\n\006common\030\001 \001(\0132\".google.api.Comm"
+ + "onLanguageSettings\"B\n\014NodeSettings\0222\n\006co"
+ "mmon\030\001 \001(\0132\".google.api.CommonLanguageSe"
- + "ttings\"\260\002\n\016MethodSettings\022\020\n\010selector\030\001 "
- + "\001(\t\022<\n\014long_running\030\002 \001(\0132&.google.api.M"
- + "ethodSettings.LongRunning\032\315\001\n\013LongRunnin"
- + "g\0225\n\022initial_poll_delay\030\001 \001(\0132\031.google.p"
- + "rotobuf.Duration\022\035\n\025poll_delay_multiplie"
- + "r\030\002 \001(\002\0221\n\016max_poll_delay\030\003 \001(\0132\031.google"
- + ".protobuf.Duration\0225\n\022total_poll_timeout"
- + "\030\004 \001(\0132\031.google.protobuf.Duration*y\n\031Cli"
- + "entLibraryOrganization\022+\n\'CLIENT_LIBRARY"
- + "_ORGANIZATION_UNSPECIFIED\020\000\022\t\n\005CLOUD\020\001\022\007"
- + "\n\003ADS\020\002\022\n\n\006PHOTOS\020\003\022\017\n\013STREET_VIEW\020\004*g\n\030"
- + "ClientLibraryDestination\022*\n&CLIENT_LIBRA"
- + "RY_DESTINATION_UNSPECIFIED\020\000\022\n\n\006GITHUB\020\n"
- + "\022\023\n\017PACKAGE_MANAGER\020\024:9\n\020method_signatur"
- + "e\022\036.google.protobuf.MethodOptions\030\233\010 \003(\t"
- + ":6\n\014default_host\022\037.google.protobuf.Servi"
- + "ceOptions\030\231\010 \001(\t:6\n\014oauth_scopes\022\037.googl"
- + "e.protobuf.ServiceOptions\030\232\010 \001(\tBi\n\016com."
- + "google.apiB\013ClientProtoP\001ZAgoogle.golang"
- + ".org/genproto/googleapis/api/annotations"
- + ";annotations\242\002\004GAPIb\006proto3"
+ + "ttings\"D\n\016DotnetSettings\0222\n\006common\030\001 \001(\013"
+ + "2\".google.api.CommonLanguageSettings\"B\n\014"
+ + "RubySettings\0222\n\006common\030\001 \001(\0132\".google.ap"
+ + "i.CommonLanguageSettings\"@\n\nGoSettings\0222"
+ + "\n\006common\030\001 \001(\0132\".google.api.CommonLangua"
+ + "geSettings\"\260\002\n\016MethodSettings\022\020\n\010selecto"
+ + "r\030\001 \001(\t\022<\n\014long_running\030\002 \001(\0132&.google.a"
+ + "pi.MethodSettings.LongRunning\032\315\001\n\013LongRu"
+ + "nning\0225\n\022initial_poll_delay\030\001 \001(\0132\031.goog"
+ + "le.protobuf.Duration\022\035\n\025poll_delay_multi"
+ + "plier\030\002 \001(\002\0221\n\016max_poll_delay\030\003 \001(\0132\031.go"
+ + "ogle.protobuf.Duration\0225\n\022total_poll_tim"
+ + "eout\030\004 \001(\0132\031.google.protobuf.Duration*y\n"
+ + "\031ClientLibraryOrganization\022+\n\'CLIENT_LIB"
+ + "RARY_ORGANIZATION_UNSPECIFIED\020\000\022\t\n\005CLOUD"
+ + "\020\001\022\007\n\003ADS\020\002\022\n\n\006PHOTOS\020\003\022\017\n\013STREET_VIEW\020\004"
+ + "*g\n\030ClientLibraryDestination\022*\n&CLIENT_L"
+ + "IBRARY_DESTINATION_UNSPECIFIED\020\000\022\n\n\006GITH"
+ + "UB\020\n\022\023\n\017PACKAGE_MANAGER\020\024:9\n\020method_sign"
+ + "ature\022\036.google.protobuf.MethodOptions\030\233\010"
+ + " \003(\t:6\n\014default_host\022\037.google.protobuf.S"
+ + "erviceOptions\030\231\010 \001(\t:6\n\014oauth_scopes\022\037.g"
+ + "oogle.protobuf.ServiceOptions\030\232\010 \001(\tBi\n\016"
+ + "com.google.apiB\013ClientProtoP\001ZAgoogle.go"
+ + "lang.org/genproto/googleapis/api/annotat"
+ + "ions;annotations\242\002\004GAPIb\006proto3"
};
descriptor =
com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom(
diff --git a/java-common-protos/proto-google-common-protos/src/main/java/com/google/api/CommonLanguageSettings.java b/java-common-protos/proto-google-common-protos/src/main/java/com/google/api/CommonLanguageSettings.java
index b15e50ffb9..e2c34f8219 100644
--- a/java-common-protos/proto-google-common-protos/src/main/java/com/google/api/CommonLanguageSettings.java
+++ b/java-common-protos/proto-google-common-protos/src/main/java/com/google/api/CommonLanguageSettings.java
@@ -77,11 +77,14 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
* https://cloud.google.com/nodejs/docs/reference/asset/latest
*
*
- * string reference_docs_uri = 1;
+ * string reference_docs_uri = 1 [deprecated = true];
*
+ * @deprecated google.api.CommonLanguageSettings.reference_docs_uri is deprecated. See
+ * google/api/client.proto;l=106
* @return The referenceDocsUri.
*/
@java.lang.Override
+ @java.lang.Deprecated
public java.lang.String getReferenceDocsUri() {
java.lang.Object ref = referenceDocsUri_;
if (ref instanceof java.lang.String) {
@@ -101,11 +104,14 @@ public java.lang.String getReferenceDocsUri() {
* https://cloud.google.com/nodejs/docs/reference/asset/latest
*
*
- * string reference_docs_uri = 1;
+ * string reference_docs_uri = 1 [deprecated = true];
*
+ * @deprecated google.api.CommonLanguageSettings.reference_docs_uri is deprecated. See
+ * google/api/client.proto;l=106
* @return The bytes for referenceDocsUri.
*/
@java.lang.Override
+ @java.lang.Deprecated
public com.google.protobuf.ByteString getReferenceDocsUriBytes() {
java.lang.Object ref = referenceDocsUri_;
if (ref instanceof java.lang.String) {
@@ -615,10 +621,13 @@ public Builder mergeFrom(
* https://cloud.google.com/nodejs/docs/reference/asset/latest
*
*
- * string reference_docs_uri = 1;
+ * string reference_docs_uri = 1 [deprecated = true];
*
+ * @deprecated google.api.CommonLanguageSettings.reference_docs_uri is deprecated. See
+ * google/api/client.proto;l=106
* @return The referenceDocsUri.
*/
+ @java.lang.Deprecated
public java.lang.String getReferenceDocsUri() {
java.lang.Object ref = referenceDocsUri_;
if (!(ref instanceof java.lang.String)) {
@@ -638,10 +647,13 @@ public java.lang.String getReferenceDocsUri() {
* https://cloud.google.com/nodejs/docs/reference/asset/latest
*
*
- * string reference_docs_uri = 1;
+ * string reference_docs_uri = 1 [deprecated = true];
*
+ * @deprecated google.api.CommonLanguageSettings.reference_docs_uri is deprecated. See
+ * google/api/client.proto;l=106
* @return The bytes for referenceDocsUri.
*/
+ @java.lang.Deprecated
public com.google.protobuf.ByteString getReferenceDocsUriBytes() {
java.lang.Object ref = referenceDocsUri_;
if (ref instanceof String) {
@@ -661,11 +673,14 @@ public com.google.protobuf.ByteString getReferenceDocsUriBytes() {
* https://cloud.google.com/nodejs/docs/reference/asset/latest
*
*
- * string reference_docs_uri = 1;
+ * string reference_docs_uri = 1 [deprecated = true];
*
+ * @deprecated google.api.CommonLanguageSettings.reference_docs_uri is deprecated. See
+ * google/api/client.proto;l=106
* @param value The referenceDocsUri to set.
* @return This builder for chaining.
*/
+ @java.lang.Deprecated
public Builder setReferenceDocsUri(java.lang.String value) {
if (value == null) {
throw new NullPointerException();
@@ -683,10 +698,13 @@ public Builder setReferenceDocsUri(java.lang.String value) {
* https://cloud.google.com/nodejs/docs/reference/asset/latest
*
*
- * string reference_docs_uri = 1;
+ * string reference_docs_uri = 1 [deprecated = true];
*
+ * @deprecated google.api.CommonLanguageSettings.reference_docs_uri is deprecated. See
+ * google/api/client.proto;l=106
* @return This builder for chaining.
*/
+ @java.lang.Deprecated
public Builder clearReferenceDocsUri() {
referenceDocsUri_ = getDefaultInstance().getReferenceDocsUri();
@@ -701,11 +719,14 @@ public Builder clearReferenceDocsUri() {
* https://cloud.google.com/nodejs/docs/reference/asset/latest
*
*
- * string reference_docs_uri = 1;
+ * string reference_docs_uri = 1 [deprecated = true];
*
+ * @deprecated google.api.CommonLanguageSettings.reference_docs_uri is deprecated. See
+ * google/api/client.proto;l=106
* @param value The bytes for referenceDocsUri to set.
* @return This builder for chaining.
*/
+ @java.lang.Deprecated
public Builder setReferenceDocsUriBytes(com.google.protobuf.ByteString value) {
if (value == null) {
throw new NullPointerException();
diff --git a/java-common-protos/proto-google-common-protos/src/main/java/com/google/api/CommonLanguageSettingsOrBuilder.java b/java-common-protos/proto-google-common-protos/src/main/java/com/google/api/CommonLanguageSettingsOrBuilder.java
index 98256fa82b..1dbffe6651 100644
--- a/java-common-protos/proto-google-common-protos/src/main/java/com/google/api/CommonLanguageSettingsOrBuilder.java
+++ b/java-common-protos/proto-google-common-protos/src/main/java/com/google/api/CommonLanguageSettingsOrBuilder.java
@@ -31,10 +31,13 @@ public interface CommonLanguageSettingsOrBuilder
* https://cloud.google.com/nodejs/docs/reference/asset/latest
*
*
- * string reference_docs_uri = 1;
+ * string reference_docs_uri = 1 [deprecated = true];
*
+ * @deprecated google.api.CommonLanguageSettings.reference_docs_uri is deprecated. See
+ * google/api/client.proto;l=106
* @return The referenceDocsUri.
*/
+ @java.lang.Deprecated
java.lang.String getReferenceDocsUri();
/**
*
@@ -44,10 +47,13 @@ public interface CommonLanguageSettingsOrBuilder
* https://cloud.google.com/nodejs/docs/reference/asset/latest
*
*
- * string reference_docs_uri = 1;
+ * string reference_docs_uri = 1 [deprecated = true];
*
+ * @deprecated google.api.CommonLanguageSettings.reference_docs_uri is deprecated. See
+ * google/api/client.proto;l=106
* @return The bytes for referenceDocsUri.
*/
+ @java.lang.Deprecated
com.google.protobuf.ByteString getReferenceDocsUriBytes();
/**
diff --git a/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/BadRequest.java b/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/BadRequest.java
index d0e4ee071c..fb2a0c008d 100644
--- a/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/BadRequest.java
+++ b/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/BadRequest.java
@@ -74,9 +74,35 @@ public interface FieldViolationOrBuilder
*
*
*
- * A path leading to a field in the request body. The value will be a
+ * A path that leads to a field in the request body. The value will be a
* sequence of dot-separated identifiers that identify a protocol buffer
- * field. E.g., "field_violations.field" would identify this field.
+ * field.
+ * Consider the following:
+ * message CreateContactRequest {
+ * message EmailAddress {
+ * enum Type {
+ * TYPE_UNSPECIFIED = 0;
+ * HOME = 1;
+ * WORK = 2;
+ * }
+ * optional string email = 1;
+ * repeated EmailType type = 2;
+ * }
+ * string full_name = 1;
+ * repeated EmailAddress email_addresses = 2;
+ * }
+ * In this example, in proto `field` could take one of the following values:
+ * * `full_name` for a violation in the `full_name` value
+ * * `email_addresses[1].email` for a violation in the `email` field of the
+ * first `email_addresses` message
+ * * `email_addresses[3].type[2]` for a violation in the second `type`
+ * value in the third `email_addresses` message.
+ * In JSON, the same values are represented as:
+ * * `fullName` for a violation in the `fullName` value
+ * * `emailAddresses[1].email` for a violation in the `email` field of the
+ * first `emailAddresses` message
+ * * `emailAddresses[3].type[2]` for a violation in the second `type`
+ * value in the third `emailAddresses` message.
*
*
* string field = 1;
@@ -88,9 +114,35 @@ public interface FieldViolationOrBuilder
*
*
*
- * A path leading to a field in the request body. The value will be a
+ * A path that leads to a field in the request body. The value will be a
* sequence of dot-separated identifiers that identify a protocol buffer
- * field. E.g., "field_violations.field" would identify this field.
+ * field.
+ * Consider the following:
+ * message CreateContactRequest {
+ * message EmailAddress {
+ * enum Type {
+ * TYPE_UNSPECIFIED = 0;
+ * HOME = 1;
+ * WORK = 2;
+ * }
+ * optional string email = 1;
+ * repeated EmailType type = 2;
+ * }
+ * string full_name = 1;
+ * repeated EmailAddress email_addresses = 2;
+ * }
+ * In this example, in proto `field` could take one of the following values:
+ * * `full_name` for a violation in the `full_name` value
+ * * `email_addresses[1].email` for a violation in the `email` field of the
+ * first `email_addresses` message
+ * * `email_addresses[3].type[2]` for a violation in the second `type`
+ * value in the third `email_addresses` message.
+ * In JSON, the same values are represented as:
+ * * `fullName` for a violation in the `fullName` value
+ * * `emailAddresses[1].email` for a violation in the `email` field of the
+ * first `emailAddresses` message
+ * * `emailAddresses[3].type[2]` for a violation in the second `type`
+ * value in the third `emailAddresses` message.
*
*
* string field = 1;
@@ -180,9 +232,35 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
*
*
*
- * A path leading to a field in the request body. The value will be a
+ * A path that leads to a field in the request body. The value will be a
* sequence of dot-separated identifiers that identify a protocol buffer
- * field. E.g., "field_violations.field" would identify this field.
+ * field.
+ * Consider the following:
+ * message CreateContactRequest {
+ * message EmailAddress {
+ * enum Type {
+ * TYPE_UNSPECIFIED = 0;
+ * HOME = 1;
+ * WORK = 2;
+ * }
+ * optional string email = 1;
+ * repeated EmailType type = 2;
+ * }
+ * string full_name = 1;
+ * repeated EmailAddress email_addresses = 2;
+ * }
+ * In this example, in proto `field` could take one of the following values:
+ * * `full_name` for a violation in the `full_name` value
+ * * `email_addresses[1].email` for a violation in the `email` field of the
+ * first `email_addresses` message
+ * * `email_addresses[3].type[2]` for a violation in the second `type`
+ * value in the third `email_addresses` message.
+ * In JSON, the same values are represented as:
+ * * `fullName` for a violation in the `fullName` value
+ * * `emailAddresses[1].email` for a violation in the `email` field of the
+ * first `emailAddresses` message
+ * * `emailAddresses[3].type[2]` for a violation in the second `type`
+ * value in the third `emailAddresses` message.
*
*
* string field = 1;
@@ -205,9 +283,35 @@ public java.lang.String getField() {
*
*
*
- * A path leading to a field in the request body. The value will be a
+ * A path that leads to a field in the request body. The value will be a
* sequence of dot-separated identifiers that identify a protocol buffer
- * field. E.g., "field_violations.field" would identify this field.
+ * field.
+ * Consider the following:
+ * message CreateContactRequest {
+ * message EmailAddress {
+ * enum Type {
+ * TYPE_UNSPECIFIED = 0;
+ * HOME = 1;
+ * WORK = 2;
+ * }
+ * optional string email = 1;
+ * repeated EmailType type = 2;
+ * }
+ * string full_name = 1;
+ * repeated EmailAddress email_addresses = 2;
+ * }
+ * In this example, in proto `field` could take one of the following values:
+ * * `full_name` for a violation in the `full_name` value
+ * * `email_addresses[1].email` for a violation in the `email` field of the
+ * first `email_addresses` message
+ * * `email_addresses[3].type[2]` for a violation in the second `type`
+ * value in the third `email_addresses` message.
+ * In JSON, the same values are represented as:
+ * * `fullName` for a violation in the `fullName` value
+ * * `emailAddresses[1].email` for a violation in the `email` field of the
+ * first `emailAddresses` message
+ * * `emailAddresses[3].type[2]` for a violation in the second `type`
+ * value in the third `emailAddresses` message.
*
*
* string field = 1;
@@ -636,9 +740,35 @@ public Builder mergeFrom(
*
*
*
- * A path leading to a field in the request body. The value will be a
+ * A path that leads to a field in the request body. The value will be a
* sequence of dot-separated identifiers that identify a protocol buffer
- * field. E.g., "field_violations.field" would identify this field.
+ * field.
+ * Consider the following:
+ * message CreateContactRequest {
+ * message EmailAddress {
+ * enum Type {
+ * TYPE_UNSPECIFIED = 0;
+ * HOME = 1;
+ * WORK = 2;
+ * }
+ * optional string email = 1;
+ * repeated EmailType type = 2;
+ * }
+ * string full_name = 1;
+ * repeated EmailAddress email_addresses = 2;
+ * }
+ * In this example, in proto `field` could take one of the following values:
+ * * `full_name` for a violation in the `full_name` value
+ * * `email_addresses[1].email` for a violation in the `email` field of the
+ * first `email_addresses` message
+ * * `email_addresses[3].type[2]` for a violation in the second `type`
+ * value in the third `email_addresses` message.
+ * In JSON, the same values are represented as:
+ * * `fullName` for a violation in the `fullName` value
+ * * `emailAddresses[1].email` for a violation in the `email` field of the
+ * first `emailAddresses` message
+ * * `emailAddresses[3].type[2]` for a violation in the second `type`
+ * value in the third `emailAddresses` message.
*
*
* string field = 1;
@@ -660,9 +790,35 @@ public java.lang.String getField() {
*
*
*
- * A path leading to a field in the request body. The value will be a
+ * A path that leads to a field in the request body. The value will be a
* sequence of dot-separated identifiers that identify a protocol buffer
- * field. E.g., "field_violations.field" would identify this field.
+ * field.
+ * Consider the following:
+ * message CreateContactRequest {
+ * message EmailAddress {
+ * enum Type {
+ * TYPE_UNSPECIFIED = 0;
+ * HOME = 1;
+ * WORK = 2;
+ * }
+ * optional string email = 1;
+ * repeated EmailType type = 2;
+ * }
+ * string full_name = 1;
+ * repeated EmailAddress email_addresses = 2;
+ * }
+ * In this example, in proto `field` could take one of the following values:
+ * * `full_name` for a violation in the `full_name` value
+ * * `email_addresses[1].email` for a violation in the `email` field of the
+ * first `email_addresses` message
+ * * `email_addresses[3].type[2]` for a violation in the second `type`
+ * value in the third `email_addresses` message.
+ * In JSON, the same values are represented as:
+ * * `fullName` for a violation in the `fullName` value
+ * * `emailAddresses[1].email` for a violation in the `email` field of the
+ * first `emailAddresses` message
+ * * `emailAddresses[3].type[2]` for a violation in the second `type`
+ * value in the third `emailAddresses` message.
*
*
* string field = 1;
@@ -684,9 +840,35 @@ public com.google.protobuf.ByteString getFieldBytes() {
*
*
*
- * A path leading to a field in the request body. The value will be a
+ * A path that leads to a field in the request body. The value will be a
* sequence of dot-separated identifiers that identify a protocol buffer
- * field. E.g., "field_violations.field" would identify this field.
+ * field.
+ * Consider the following:
+ * message CreateContactRequest {
+ * message EmailAddress {
+ * enum Type {
+ * TYPE_UNSPECIFIED = 0;
+ * HOME = 1;
+ * WORK = 2;
+ * }
+ * optional string email = 1;
+ * repeated EmailType type = 2;
+ * }
+ * string full_name = 1;
+ * repeated EmailAddress email_addresses = 2;
+ * }
+ * In this example, in proto `field` could take one of the following values:
+ * * `full_name` for a violation in the `full_name` value
+ * * `email_addresses[1].email` for a violation in the `email` field of the
+ * first `email_addresses` message
+ * * `email_addresses[3].type[2]` for a violation in the second `type`
+ * value in the third `email_addresses` message.
+ * In JSON, the same values are represented as:
+ * * `fullName` for a violation in the `fullName` value
+ * * `emailAddresses[1].email` for a violation in the `email` field of the
+ * first `emailAddresses` message
+ * * `emailAddresses[3].type[2]` for a violation in the second `type`
+ * value in the third `emailAddresses` message.
*
*
* string field = 1;
@@ -707,9 +889,35 @@ public Builder setField(java.lang.String value) {
*
*
*
- * A path leading to a field in the request body. The value will be a
+ * A path that leads to a field in the request body. The value will be a
* sequence of dot-separated identifiers that identify a protocol buffer
- * field. E.g., "field_violations.field" would identify this field.
+ * field.
+ * Consider the following:
+ * message CreateContactRequest {
+ * message EmailAddress {
+ * enum Type {
+ * TYPE_UNSPECIFIED = 0;
+ * HOME = 1;
+ * WORK = 2;
+ * }
+ * optional string email = 1;
+ * repeated EmailType type = 2;
+ * }
+ * string full_name = 1;
+ * repeated EmailAddress email_addresses = 2;
+ * }
+ * In this example, in proto `field` could take one of the following values:
+ * * `full_name` for a violation in the `full_name` value
+ * * `email_addresses[1].email` for a violation in the `email` field of the
+ * first `email_addresses` message
+ * * `email_addresses[3].type[2]` for a violation in the second `type`
+ * value in the third `email_addresses` message.
+ * In JSON, the same values are represented as:
+ * * `fullName` for a violation in the `fullName` value
+ * * `emailAddresses[1].email` for a violation in the `email` field of the
+ * first `emailAddresses` message
+ * * `emailAddresses[3].type[2]` for a violation in the second `type`
+ * value in the third `emailAddresses` message.
*
*
* string field = 1;
@@ -726,9 +934,35 @@ public Builder clearField() {
*
*
*
- * A path leading to a field in the request body. The value will be a
+ * A path that leads to a field in the request body. The value will be a
* sequence of dot-separated identifiers that identify a protocol buffer
- * field. E.g., "field_violations.field" would identify this field.
+ * field.
+ * Consider the following:
+ * message CreateContactRequest {
+ * message EmailAddress {
+ * enum Type {
+ * TYPE_UNSPECIFIED = 0;
+ * HOME = 1;
+ * WORK = 2;
+ * }
+ * optional string email = 1;
+ * repeated EmailType type = 2;
+ * }
+ * string full_name = 1;
+ * repeated EmailAddress email_addresses = 2;
+ * }
+ * In this example, in proto `field` could take one of the following values:
+ * * `full_name` for a violation in the `full_name` value
+ * * `email_addresses[1].email` for a violation in the `email` field of the
+ * first `email_addresses` message
+ * * `email_addresses[3].type[2]` for a violation in the second `type`
+ * value in the third `email_addresses` message.
+ * In JSON, the same values are represented as:
+ * * `fullName` for a violation in the `fullName` value
+ * * `emailAddresses[1].email` for a violation in the `email` field of the
+ * first `emailAddresses` message
+ * * `emailAddresses[3].type[2]` for a violation in the second `type`
+ * value in the third `emailAddresses` message.
*
*
* string field = 1;
diff --git a/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/Code.java b/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/Code.java
index e1c5d2e81d..4e9024417f 100644
--- a/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/Code.java
+++ b/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/Code.java
@@ -36,7 +36,7 @@ public enum Code implements com.google.protobuf.ProtocolMessageEnum {
*
*
*
- * Not an error; returned on success
+ * Not an error; returned on success.
* HTTP Mapping: 200 OK
*
*
@@ -104,7 +104,7 @@ public enum Code implements com.google.protobuf.ProtocolMessageEnum {
*
* Some requested entity (e.g., file or directory) was not found.
* Note to server developers: if a request is denied for an entire class
- * of users, such as gradual feature rollout or undocumented whitelist,
+ * of users, such as gradual feature rollout or undocumented allowlist,
* `NOT_FOUND` may be used. If a request is denied for some users within
* a class of users, such as user-based access control, `PERMISSION_DENIED`
* must be used.
@@ -179,11 +179,11 @@ public enum Code implements com.google.protobuf.ProtocolMessageEnum {
* Service implementors can use the following guidelines to decide
* between `FAILED_PRECONDITION`, `ABORTED`, and `UNAVAILABLE`:
* (a) Use `UNAVAILABLE` if the client can retry just the failing call.
- * (b) Use `ABORTED` if the client should retry at a higher level
- * (e.g., when a client-specified test-and-set fails, indicating the
- * client should restart a read-modify-write sequence).
+ * (b) Use `ABORTED` if the client should retry at a higher level. For
+ * example, when a client-specified test-and-set fails, indicating the
+ * client should restart a read-modify-write sequence.
* (c) Use `FAILED_PRECONDITION` if the client should not retry until
- * the system state has been explicitly fixed. E.g., if an "rmdir"
+ * the system state has been explicitly fixed. For example, if an "rmdir"
* fails because the directory is non-empty, `FAILED_PRECONDITION`
* should be returned since the client should not retry unless
* the files are deleted from the directory.
@@ -289,7 +289,7 @@ public enum Code implements com.google.protobuf.ProtocolMessageEnum {
*
*
*
- * Not an error; returned on success
+ * Not an error; returned on success.
* HTTP Mapping: 200 OK
*
*
@@ -357,7 +357,7 @@ public enum Code implements com.google.protobuf.ProtocolMessageEnum {
*
* Some requested entity (e.g., file or directory) was not found.
* Note to server developers: if a request is denied for an entire class
- * of users, such as gradual feature rollout or undocumented whitelist,
+ * of users, such as gradual feature rollout or undocumented allowlist,
* `NOT_FOUND` may be used. If a request is denied for some users within
* a class of users, such as user-based access control, `PERMISSION_DENIED`
* must be used.
@@ -432,11 +432,11 @@ public enum Code implements com.google.protobuf.ProtocolMessageEnum {
* Service implementors can use the following guidelines to decide
* between `FAILED_PRECONDITION`, `ABORTED`, and `UNAVAILABLE`:
* (a) Use `UNAVAILABLE` if the client can retry just the failing call.
- * (b) Use `ABORTED` if the client should retry at a higher level
- * (e.g., when a client-specified test-and-set fails, indicating the
- * client should restart a read-modify-write sequence).
+ * (b) Use `ABORTED` if the client should retry at a higher level. For
+ * example, when a client-specified test-and-set fails, indicating the
+ * client should restart a read-modify-write sequence.
* (c) Use `FAILED_PRECONDITION` if the client should not retry until
- * the system state has been explicitly fixed. E.g., if an "rmdir"
+ * the system state has been explicitly fixed. For example, if an "rmdir"
* fails because the directory is non-empty, `FAILED_PRECONDITION`
* should be returned since the client should not retry unless
* the files are deleted from the directory.
diff --git a/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/ErrorDetailsProto.java b/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/ErrorDetailsProto.java
index 7dcca5d020..a62002a69f 100644
--- a/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/ErrorDetailsProto.java
+++ b/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/ErrorDetailsProto.java
@@ -27,6 +27,14 @@ public static void registerAllExtensions(com.google.protobuf.ExtensionRegistry r
registerAllExtensions((com.google.protobuf.ExtensionRegistryLite) registry);
}
+ static final com.google.protobuf.Descriptors.Descriptor
+ internal_static_google_rpc_ErrorInfo_descriptor;
+ static final com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
+ internal_static_google_rpc_ErrorInfo_fieldAccessorTable;
+ static final com.google.protobuf.Descriptors.Descriptor
+ internal_static_google_rpc_ErrorInfo_MetadataEntry_descriptor;
+ static final com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
+ internal_static_google_rpc_ErrorInfo_MetadataEntry_fieldAccessorTable;
static final com.google.protobuf.Descriptors.Descriptor
internal_static_google_rpc_RetryInfo_descriptor;
static final com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
@@ -43,14 +51,6 @@ public static void registerAllExtensions(com.google.protobuf.ExtensionRegistry r
internal_static_google_rpc_QuotaFailure_Violation_descriptor;
static final com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
internal_static_google_rpc_QuotaFailure_Violation_fieldAccessorTable;
- static final com.google.protobuf.Descriptors.Descriptor
- internal_static_google_rpc_ErrorInfo_descriptor;
- static final com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
- internal_static_google_rpc_ErrorInfo_fieldAccessorTable;
- static final com.google.protobuf.Descriptors.Descriptor
- internal_static_google_rpc_ErrorInfo_MetadataEntry_descriptor;
- static final com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
- internal_static_google_rpc_ErrorInfo_MetadataEntry_fieldAccessorTable;
static final com.google.protobuf.Descriptors.Descriptor
internal_static_google_rpc_PreconditionFailure_descriptor;
static final com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
@@ -97,17 +97,17 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
static {
java.lang.String[] descriptorData = {
"\n\036google/rpc/error_details.proto\022\ngoogle"
- + ".rpc\032\036google/protobuf/duration.proto\";\n\t"
- + "RetryInfo\022.\n\013retry_delay\030\001 \001(\0132\031.google."
- + "protobuf.Duration\"2\n\tDebugInfo\022\025\n\rstack_"
- + "entries\030\001 \003(\t\022\016\n\006detail\030\002 \001(\t\"y\n\014QuotaFa"
- + "ilure\0226\n\nviolations\030\001 \003(\0132\".google.rpc.Q"
- + "uotaFailure.Violation\0321\n\tViolation\022\017\n\007su"
- + "bject\030\001 \001(\t\022\023\n\013description\030\002 \001(\t\"\223\001\n\tErr"
- + "orInfo\022\016\n\006reason\030\001 \001(\t\022\016\n\006domain\030\002 \001(\t\0225"
- + "\n\010metadata\030\003 \003(\0132#.google.rpc.ErrorInfo."
- + "MetadataEntry\032/\n\rMetadataEntry\022\013\n\003key\030\001 "
- + "\001(\t\022\r\n\005value\030\002 \001(\t:\0028\001\"\225\001\n\023PreconditionF"
+ + ".rpc\032\036google/protobuf/duration.proto\"\223\001\n"
+ + "\tErrorInfo\022\016\n\006reason\030\001 \001(\t\022\016\n\006domain\030\002 \001"
+ + "(\t\0225\n\010metadata\030\003 \003(\0132#.google.rpc.ErrorI"
+ + "nfo.MetadataEntry\032/\n\rMetadataEntry\022\013\n\003ke"
+ + "y\030\001 \001(\t\022\r\n\005value\030\002 \001(\t:\0028\001\";\n\tRetryInfo\022"
+ + ".\n\013retry_delay\030\001 \001(\0132\031.google.protobuf.D"
+ + "uration\"2\n\tDebugInfo\022\025\n\rstack_entries\030\001 "
+ + "\003(\t\022\016\n\006detail\030\002 \001(\t\"y\n\014QuotaFailure\0226\n\nv"
+ + "iolations\030\001 \003(\0132\".google.rpc.QuotaFailur"
+ + "e.Violation\0321\n\tViolation\022\017\n\007subject\030\001 \001("
+ + "\t\022\023\n\013description\030\002 \001(\t\"\225\001\n\023PreconditionF"
+ "ailure\022=\n\nviolations\030\001 \003(\0132).google.rpc."
+ "PreconditionFailure.Violation\032?\n\tViolati"
+ "on\022\014\n\004type\030\001 \001(\t\022\017\n\007subject\030\002 \001(\t\022\023\n\013des"
@@ -133,21 +133,36 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
new com.google.protobuf.Descriptors.FileDescriptor[] {
com.google.protobuf.DurationProto.getDescriptor(),
});
- internal_static_google_rpc_RetryInfo_descriptor = getDescriptor().getMessageTypes().get(0);
+ internal_static_google_rpc_ErrorInfo_descriptor = getDescriptor().getMessageTypes().get(0);
+ internal_static_google_rpc_ErrorInfo_fieldAccessorTable =
+ new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
+ internal_static_google_rpc_ErrorInfo_descriptor,
+ new java.lang.String[] {
+ "Reason", "Domain", "Metadata",
+ });
+ internal_static_google_rpc_ErrorInfo_MetadataEntry_descriptor =
+ internal_static_google_rpc_ErrorInfo_descriptor.getNestedTypes().get(0);
+ internal_static_google_rpc_ErrorInfo_MetadataEntry_fieldAccessorTable =
+ new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
+ internal_static_google_rpc_ErrorInfo_MetadataEntry_descriptor,
+ new java.lang.String[] {
+ "Key", "Value",
+ });
+ internal_static_google_rpc_RetryInfo_descriptor = getDescriptor().getMessageTypes().get(1);
internal_static_google_rpc_RetryInfo_fieldAccessorTable =
new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
internal_static_google_rpc_RetryInfo_descriptor,
new java.lang.String[] {
"RetryDelay",
});
- internal_static_google_rpc_DebugInfo_descriptor = getDescriptor().getMessageTypes().get(1);
+ internal_static_google_rpc_DebugInfo_descriptor = getDescriptor().getMessageTypes().get(2);
internal_static_google_rpc_DebugInfo_fieldAccessorTable =
new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
internal_static_google_rpc_DebugInfo_descriptor,
new java.lang.String[] {
"StackEntries", "Detail",
});
- internal_static_google_rpc_QuotaFailure_descriptor = getDescriptor().getMessageTypes().get(2);
+ internal_static_google_rpc_QuotaFailure_descriptor = getDescriptor().getMessageTypes().get(3);
internal_static_google_rpc_QuotaFailure_fieldAccessorTable =
new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
internal_static_google_rpc_QuotaFailure_descriptor,
@@ -162,21 +177,6 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
new java.lang.String[] {
"Subject", "Description",
});
- internal_static_google_rpc_ErrorInfo_descriptor = getDescriptor().getMessageTypes().get(3);
- internal_static_google_rpc_ErrorInfo_fieldAccessorTable =
- new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
- internal_static_google_rpc_ErrorInfo_descriptor,
- new java.lang.String[] {
- "Reason", "Domain", "Metadata",
- });
- internal_static_google_rpc_ErrorInfo_MetadataEntry_descriptor =
- internal_static_google_rpc_ErrorInfo_descriptor.getNestedTypes().get(0);
- internal_static_google_rpc_ErrorInfo_MetadataEntry_fieldAccessorTable =
- new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
- internal_static_google_rpc_ErrorInfo_MetadataEntry_descriptor,
- new java.lang.String[] {
- "Key", "Value",
- });
internal_static_google_rpc_PreconditionFailure_descriptor =
getDescriptor().getMessageTypes().get(4);
internal_static_google_rpc_PreconditionFailure_fieldAccessorTable =
diff --git a/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/ErrorInfo.java b/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/ErrorInfo.java
index a05d2dc69f..b0cc214936 100644
--- a/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/ErrorInfo.java
+++ b/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/ErrorInfo.java
@@ -102,8 +102,9 @@ protected com.google.protobuf.MapField internalGetMapField(int number) {
*
* The reason of the error. This is a constant value that identifies the
* proximate cause of the error. Error reasons are unique within a particular
- * domain of errors. This should be at most 63 characters and match
- * /[A-Z0-9_]+/.
+ * domain of errors. This should be at most 63 characters and match a
+ * regular expression of `[A-Z][A-Z0-9_]+[A-Z0-9]`, which represents
+ * UPPER_SNAKE_CASE.
*
*
* string reason = 1;
@@ -128,8 +129,9 @@ public java.lang.String getReason() {
*
* The reason of the error. This is a constant value that identifies the
* proximate cause of the error. Error reasons are unique within a particular
- * domain of errors. This should be at most 63 characters and match
- * /[A-Z0-9_]+/.
+ * domain of errors. This should be at most 63 characters and match a
+ * regular expression of `[A-Z][A-Z0-9_]+[A-Z0-9]`, which represents
+ * UPPER_SNAKE_CASE.
*
*
* string reason = 1;
@@ -756,8 +758,9 @@ public Builder mergeFrom(
*
* The reason of the error. This is a constant value that identifies the
* proximate cause of the error. Error reasons are unique within a particular
- * domain of errors. This should be at most 63 characters and match
- * /[A-Z0-9_]+/.
+ * domain of errors. This should be at most 63 characters and match a
+ * regular expression of `[A-Z][A-Z0-9_]+[A-Z0-9]`, which represents
+ * UPPER_SNAKE_CASE.
*
*
* string reason = 1;
@@ -781,8 +784,9 @@ public java.lang.String getReason() {
*
* The reason of the error. This is a constant value that identifies the
* proximate cause of the error. Error reasons are unique within a particular
- * domain of errors. This should be at most 63 characters and match
- * /[A-Z0-9_]+/.
+ * domain of errors. This should be at most 63 characters and match a
+ * regular expression of `[A-Z][A-Z0-9_]+[A-Z0-9]`, which represents
+ * UPPER_SNAKE_CASE.
*
*
* string reason = 1;
@@ -806,8 +810,9 @@ public com.google.protobuf.ByteString getReasonBytes() {
*
* The reason of the error. This is a constant value that identifies the
* proximate cause of the error. Error reasons are unique within a particular
- * domain of errors. This should be at most 63 characters and match
- * /[A-Z0-9_]+/.
+ * domain of errors. This should be at most 63 characters and match a
+ * regular expression of `[A-Z][A-Z0-9_]+[A-Z0-9]`, which represents
+ * UPPER_SNAKE_CASE.
*
*
* string reason = 1;
@@ -830,8 +835,9 @@ public Builder setReason(java.lang.String value) {
*
* The reason of the error. This is a constant value that identifies the
* proximate cause of the error. Error reasons are unique within a particular
- * domain of errors. This should be at most 63 characters and match
- * /[A-Z0-9_]+/.
+ * domain of errors. This should be at most 63 characters and match a
+ * regular expression of `[A-Z][A-Z0-9_]+[A-Z0-9]`, which represents
+ * UPPER_SNAKE_CASE.
*
*
* string reason = 1;
@@ -850,8 +856,9 @@ public Builder clearReason() {
*
* The reason of the error. This is a constant value that identifies the
* proximate cause of the error. Error reasons are unique within a particular
- * domain of errors. This should be at most 63 characters and match
- * /[A-Z0-9_]+/.
+ * domain of errors. This should be at most 63 characters and match a
+ * regular expression of `[A-Z][A-Z0-9_]+[A-Z0-9]`, which represents
+ * UPPER_SNAKE_CASE.
*
*
* string reason = 1;
diff --git a/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/ErrorInfoOrBuilder.java b/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/ErrorInfoOrBuilder.java
index 17a27407b2..8b413bb402 100644
--- a/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/ErrorInfoOrBuilder.java
+++ b/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/ErrorInfoOrBuilder.java
@@ -29,8 +29,9 @@ public interface ErrorInfoOrBuilder
*
* The reason of the error. This is a constant value that identifies the
* proximate cause of the error. Error reasons are unique within a particular
- * domain of errors. This should be at most 63 characters and match
- * /[A-Z0-9_]+/.
+ * domain of errors. This should be at most 63 characters and match a
+ * regular expression of `[A-Z][A-Z0-9_]+[A-Z0-9]`, which represents
+ * UPPER_SNAKE_CASE.
*
*
* string reason = 1;
@@ -44,8 +45,9 @@ public interface ErrorInfoOrBuilder
*
* The reason of the error. This is a constant value that identifies the
* proximate cause of the error. Error reasons are unique within a particular
- * domain of errors. This should be at most 63 characters and match
- * /[A-Z0-9_]+/.
+ * domain of errors. This should be at most 63 characters and match a
+ * regular expression of `[A-Z][A-Z0-9_]+[A-Z0-9]`, which represents
+ * UPPER_SNAKE_CASE.
*
*
* string reason = 1;
diff --git a/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/LocalizedMessage.java b/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/LocalizedMessage.java
index ee374c5480..6770dc7c0f 100644
--- a/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/LocalizedMessage.java
+++ b/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/LocalizedMessage.java
@@ -74,7 +74,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
*
*
* The locale used following the specification defined at
- * http://www.rfc-editor.org/rfc/bcp/bcp47.txt.
+ * https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
* Examples are: "en-US", "fr-CH", "es-MX"
*
*
@@ -99,7 +99,7 @@ public java.lang.String getLocale() {
*
*
* The locale used following the specification defined at
- * http://www.rfc-editor.org/rfc/bcp/bcp47.txt.
+ * https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
* Examples are: "en-US", "fr-CH", "es-MX"
*
*
@@ -523,7 +523,7 @@ public Builder mergeFrom(
*
*
* The locale used following the specification defined at
- * http://www.rfc-editor.org/rfc/bcp/bcp47.txt.
+ * https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
* Examples are: "en-US", "fr-CH", "es-MX"
*
*
@@ -547,7 +547,7 @@ public java.lang.String getLocale() {
*
*
* The locale used following the specification defined at
- * http://www.rfc-editor.org/rfc/bcp/bcp47.txt.
+ * https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
* Examples are: "en-US", "fr-CH", "es-MX"
*
*
@@ -571,7 +571,7 @@ public com.google.protobuf.ByteString getLocaleBytes() {
*
*
* The locale used following the specification defined at
- * http://www.rfc-editor.org/rfc/bcp/bcp47.txt.
+ * https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
* Examples are: "en-US", "fr-CH", "es-MX"
*
*
@@ -594,7 +594,7 @@ public Builder setLocale(java.lang.String value) {
*
*
* The locale used following the specification defined at
- * http://www.rfc-editor.org/rfc/bcp/bcp47.txt.
+ * https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
* Examples are: "en-US", "fr-CH", "es-MX"
*
*
@@ -613,7 +613,7 @@ public Builder clearLocale() {
*
*
* The locale used following the specification defined at
- * http://www.rfc-editor.org/rfc/bcp/bcp47.txt.
+ * https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
* Examples are: "en-US", "fr-CH", "es-MX"
*
*
diff --git a/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/LocalizedMessageOrBuilder.java b/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/LocalizedMessageOrBuilder.java
index 218162863b..307ab6887f 100644
--- a/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/LocalizedMessageOrBuilder.java
+++ b/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/LocalizedMessageOrBuilder.java
@@ -28,7 +28,7 @@ public interface LocalizedMessageOrBuilder
*
*
* The locale used following the specification defined at
- * http://www.rfc-editor.org/rfc/bcp/bcp47.txt.
+ * https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
* Examples are: "en-US", "fr-CH", "es-MX"
*
*
@@ -42,7 +42,7 @@ public interface LocalizedMessageOrBuilder
*
*
* The locale used following the specification defined at
- * http://www.rfc-editor.org/rfc/bcp/bcp47.txt.
+ * https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
* Examples are: "en-US", "fr-CH", "es-MX"
*
*
diff --git a/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/ResourceInfo.java b/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/ResourceInfo.java
index f8e113819e..ae45776f6c 100644
--- a/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/ResourceInfo.java
+++ b/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/ResourceInfo.java
@@ -129,7 +129,8 @@ public com.google.protobuf.ByteString getResourceTypeBytes() {
*
* The name of the resource being accessed. For example, a shared calendar
* name: "example.com_4fghdhgsrgh@group.calendar.google.com", if the current
- * error is [google.rpc.Code.PERMISSION_DENIED][google.rpc.Code.PERMISSION_DENIED].
+ * error is
+ * [google.rpc.Code.PERMISSION_DENIED][google.rpc.Code.PERMISSION_DENIED].
*
*
* string resource_name = 2;
@@ -154,7 +155,8 @@ public java.lang.String getResourceName() {
*
* The name of the resource being accessed. For example, a shared calendar
* name: "example.com_4fghdhgsrgh@group.calendar.google.com", if the current
- * error is [google.rpc.Code.PERMISSION_DENIED][google.rpc.Code.PERMISSION_DENIED].
+ * error is
+ * [google.rpc.Code.PERMISSION_DENIED][google.rpc.Code.PERMISSION_DENIED].
*
*
* string resource_name = 2;
@@ -792,7 +794,8 @@ public Builder setResourceTypeBytes(com.google.protobuf.ByteString value) {
*
* The name of the resource being accessed. For example, a shared calendar
* name: "example.com_4fghdhgsrgh@group.calendar.google.com", if the current
- * error is [google.rpc.Code.PERMISSION_DENIED][google.rpc.Code.PERMISSION_DENIED].
+ * error is
+ * [google.rpc.Code.PERMISSION_DENIED][google.rpc.Code.PERMISSION_DENIED].
*
*
* string resource_name = 2;
@@ -816,7 +819,8 @@ public java.lang.String getResourceName() {
*
* The name of the resource being accessed. For example, a shared calendar
* name: "example.com_4fghdhgsrgh@group.calendar.google.com", if the current
- * error is [google.rpc.Code.PERMISSION_DENIED][google.rpc.Code.PERMISSION_DENIED].
+ * error is
+ * [google.rpc.Code.PERMISSION_DENIED][google.rpc.Code.PERMISSION_DENIED].
*
*
* string resource_name = 2;
@@ -840,7 +844,8 @@ public com.google.protobuf.ByteString getResourceNameBytes() {
*
* The name of the resource being accessed. For example, a shared calendar
* name: "example.com_4fghdhgsrgh@group.calendar.google.com", if the current
- * error is [google.rpc.Code.PERMISSION_DENIED][google.rpc.Code.PERMISSION_DENIED].
+ * error is
+ * [google.rpc.Code.PERMISSION_DENIED][google.rpc.Code.PERMISSION_DENIED].
*
*
* string resource_name = 2;
@@ -863,7 +868,8 @@ public Builder setResourceName(java.lang.String value) {
*
* The name of the resource being accessed. For example, a shared calendar
* name: "example.com_4fghdhgsrgh@group.calendar.google.com", if the current
- * error is [google.rpc.Code.PERMISSION_DENIED][google.rpc.Code.PERMISSION_DENIED].
+ * error is
+ * [google.rpc.Code.PERMISSION_DENIED][google.rpc.Code.PERMISSION_DENIED].
*
*
* string resource_name = 2;
@@ -882,7 +888,8 @@ public Builder clearResourceName() {
*
* The name of the resource being accessed. For example, a shared calendar
* name: "example.com_4fghdhgsrgh@group.calendar.google.com", if the current
- * error is [google.rpc.Code.PERMISSION_DENIED][google.rpc.Code.PERMISSION_DENIED].
+ * error is
+ * [google.rpc.Code.PERMISSION_DENIED][google.rpc.Code.PERMISSION_DENIED].
*
*
* string resource_name = 2;
diff --git a/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/ResourceInfoOrBuilder.java b/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/ResourceInfoOrBuilder.java
index 3038fb4506..17307c44c5 100644
--- a/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/ResourceInfoOrBuilder.java
+++ b/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/ResourceInfoOrBuilder.java
@@ -58,7 +58,8 @@ public interface ResourceInfoOrBuilder
*
* The name of the resource being accessed. For example, a shared calendar
* name: "example.com_4fghdhgsrgh@group.calendar.google.com", if the current
- * error is [google.rpc.Code.PERMISSION_DENIED][google.rpc.Code.PERMISSION_DENIED].
+ * error is
+ * [google.rpc.Code.PERMISSION_DENIED][google.rpc.Code.PERMISSION_DENIED].
*
*
* string resource_name = 2;
@@ -72,7 +73,8 @@ public interface ResourceInfoOrBuilder
*
* The name of the resource being accessed. For example, a shared calendar
* name: "example.com_4fghdhgsrgh@group.calendar.google.com", if the current
- * error is [google.rpc.Code.PERMISSION_DENIED][google.rpc.Code.PERMISSION_DENIED].
+ * error is
+ * [google.rpc.Code.PERMISSION_DENIED][google.rpc.Code.PERMISSION_DENIED].
*
*
* string resource_name = 2;
diff --git a/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/Status.java b/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/Status.java
index 1ffd404dd6..b390b57f09 100644
--- a/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/Status.java
+++ b/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/Status.java
@@ -76,7 +76,8 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
*
*
*
- * The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
+ * The status code, which should be an enum value of
+ * [google.rpc.Code][google.rpc.Code].
*
*
* int32 code = 1;
@@ -96,7 +97,8 @@ public int getCode() {
*
* A developer-facing error message, which should be in English. Any
* user-facing error message should be localized and sent in the
- * [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
+ * [google.rpc.Status.details][google.rpc.Status.details] field, or localized
+ * by the client.
*
*
* string message = 2;
@@ -121,7 +123,8 @@ public java.lang.String getMessage() {
*
* A developer-facing error message, which should be in English. Any
* user-facing error message should be localized and sent in the
- * [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
+ * [google.rpc.Status.details][google.rpc.Status.details] field, or localized
+ * by the client.
*
*
* string message = 2;
@@ -636,7 +639,8 @@ public Builder mergeFrom(
*
*
*
- * The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
+ * The status code, which should be an enum value of
+ * [google.rpc.Code][google.rpc.Code].
*
*
* int32 code = 1;
@@ -651,7 +655,8 @@ public int getCode() {
*
*
*
- * The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
+ * The status code, which should be an enum value of
+ * [google.rpc.Code][google.rpc.Code].
*
*
* int32 code = 1;
@@ -669,7 +674,8 @@ public Builder setCode(int value) {
*
*
*
- * The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
+ * The status code, which should be an enum value of
+ * [google.rpc.Code][google.rpc.Code].
*
*
* int32 code = 1;
@@ -690,7 +696,8 @@ public Builder clearCode() {
*
* A developer-facing error message, which should be in English. Any
* user-facing error message should be localized and sent in the
- * [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
+ * [google.rpc.Status.details][google.rpc.Status.details] field, or localized
+ * by the client.
*
*
* string message = 2;
@@ -714,7 +721,8 @@ public java.lang.String getMessage() {
*
* A developer-facing error message, which should be in English. Any
* user-facing error message should be localized and sent in the
- * [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
+ * [google.rpc.Status.details][google.rpc.Status.details] field, or localized
+ * by the client.
*
*
* string message = 2;
@@ -738,7 +746,8 @@ public com.google.protobuf.ByteString getMessageBytes() {
*
* A developer-facing error message, which should be in English. Any
* user-facing error message should be localized and sent in the
- * [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
+ * [google.rpc.Status.details][google.rpc.Status.details] field, or localized
+ * by the client.
*
*
* string message = 2;
@@ -761,7 +770,8 @@ public Builder setMessage(java.lang.String value) {
*
* A developer-facing error message, which should be in English. Any
* user-facing error message should be localized and sent in the
- * [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
+ * [google.rpc.Status.details][google.rpc.Status.details] field, or localized
+ * by the client.
*
*
* string message = 2;
@@ -780,7 +790,8 @@ public Builder clearMessage() {
*
* A developer-facing error message, which should be in English. Any
* user-facing error message should be localized and sent in the
- * [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
+ * [google.rpc.Status.details][google.rpc.Status.details] field, or localized
+ * by the client.
*
*
* string message = 2;
diff --git a/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/StatusOrBuilder.java b/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/StatusOrBuilder.java
index c4b026ede7..1b4159c6c2 100644
--- a/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/StatusOrBuilder.java
+++ b/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/StatusOrBuilder.java
@@ -27,7 +27,8 @@ public interface StatusOrBuilder
*
*
*
- * The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
+ * The status code, which should be an enum value of
+ * [google.rpc.Code][google.rpc.Code].
*
*
* int32 code = 1;
@@ -42,7 +43,8 @@ public interface StatusOrBuilder
*
* A developer-facing error message, which should be in English. Any
* user-facing error message should be localized and sent in the
- * [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
+ * [google.rpc.Status.details][google.rpc.Status.details] field, or localized
+ * by the client.
*
*
* string message = 2;
@@ -56,7 +58,8 @@ public interface StatusOrBuilder
*
* A developer-facing error message, which should be in English. Any
* user-facing error message should be localized and sent in the
- * [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
+ * [google.rpc.Status.details][google.rpc.Status.details] field, or localized
+ * by the client.
*
*
* string message = 2;
diff --git a/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/context/AttributeContext.java b/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/context/AttributeContext.java
index d2bdf934e5..d2908189b9 100644
--- a/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/context/AttributeContext.java
+++ b/java-common-protos/proto-google-common-protos/src/main/java/com/google/rpc/context/AttributeContext.java
@@ -187,7 +187,7 @@ java.lang.String getLabelsOrDefault(
*
* The identity of this peer. Similar to `Request.auth.principal`, but
* relative to the peer instead of the request. For example, the
- * idenity associated with a load balancer that forwared the request.
+ * identity associated with a load balancer that forwarded the request.
*
*
* string principal = 7;
@@ -201,7 +201,7 @@ java.lang.String getLabelsOrDefault(
*
* The identity of this peer. Similar to `Request.auth.principal`, but
* relative to the peer instead of the request. For example, the
- * idenity associated with a load balancer that forwared the request.
+ * identity associated with a load balancer that forwarded the request.
*
*
* string principal = 7;
@@ -478,7 +478,7 @@ public java.lang.String getLabelsOrThrow(java.lang.String key) {
*
* The identity of this peer. Similar to `Request.auth.principal`, but
* relative to the peer instead of the request. For example, the
- * idenity associated with a load balancer that forwared the request.
+ * identity associated with a load balancer that forwarded the request.
*
*
* string principal = 7;
@@ -503,7 +503,7 @@ public java.lang.String getPrincipal() {
*
* The identity of this peer. Similar to `Request.auth.principal`, but
* relative to the peer instead of the request. For example, the
- * idenity associated with a load balancer that forwared the request.
+ * identity associated with a load balancer that forwarded the request.
*
*
* string principal = 7;
@@ -1355,7 +1355,7 @@ public Builder putAllLabels(java.util.Map va
*
* The identity of this peer. Similar to `Request.auth.principal`, but
* relative to the peer instead of the request. For example, the
- * idenity associated with a load balancer that forwared the request.
+ * identity associated with a load balancer that forwarded the request.
*
*
* string principal = 7;
@@ -1379,7 +1379,7 @@ public java.lang.String getPrincipal() {
*
* The identity of this peer. Similar to `Request.auth.principal`, but
* relative to the peer instead of the request. For example, the
- * idenity associated with a load balancer that forwared the request.
+ * identity associated with a load balancer that forwarded the request.
*
*
* string principal = 7;
@@ -1403,7 +1403,7 @@ public com.google.protobuf.ByteString getPrincipalBytes() {
*
* The identity of this peer. Similar to `Request.auth.principal`, but
* relative to the peer instead of the request. For example, the
- * idenity associated with a load balancer that forwared the request.
+ * identity associated with a load balancer that forwarded the request.
*
*
* string principal = 7;
@@ -1426,7 +1426,7 @@ public Builder setPrincipal(java.lang.String value) {
*
* The identity of this peer. Similar to `Request.auth.principal`, but
* relative to the peer instead of the request. For example, the
- * idenity associated with a load balancer that forwared the request.
+ * identity associated with a load balancer that forwarded the request.
*
*
* string principal = 7;
@@ -1445,7 +1445,7 @@ public Builder clearPrincipal() {
*
* The identity of this peer. Similar to `Request.auth.principal`, but
* relative to the peer instead of the request. For example, the
- * idenity associated with a load balancer that forwared the request.
+ * identity associated with a load balancer that forwarded the request.
*
*
* string principal = 7;
@@ -5366,7 +5366,7 @@ java.lang.String getHeadersOrDefault(
*
*
*
- * The HTTP URL path.
+ * The HTTP URL path, excluding the query parameters.
*
*
* string path = 4;
@@ -5378,7 +5378,7 @@ java.lang.String getHeadersOrDefault(
*
*
*
- * The HTTP URL path.
+ * The HTTP URL path, excluding the query parameters.
*
*
* string path = 4;
@@ -5895,7 +5895,7 @@ public java.lang.String getHeadersOrThrow(java.lang.String key) {
*
*
*
- * The HTTP URL path.
+ * The HTTP URL path, excluding the query parameters.
*
*
* string path = 4;
@@ -5918,7 +5918,7 @@ public java.lang.String getPath() {
*
*
*
- * The HTTP URL path.
+ * The HTTP URL path, excluding the query parameters.
*
*
* string path = 4;
@@ -7346,7 +7346,7 @@ public Builder putAllHeaders(java.util.Map v
*
*
*
- * The HTTP URL path.
+ * The HTTP URL path, excluding the query parameters.
*
*
* string path = 4;
@@ -7368,7 +7368,7 @@ public java.lang.String getPath() {
*
*
*
- * The HTTP URL path.
+ * The HTTP URL path, excluding the query parameters.
*
*
* string path = 4;
@@ -7390,7 +7390,7 @@ public com.google.protobuf.ByteString getPathBytes() {
*
*
*
- * The HTTP URL path.
+ * The HTTP URL path, excluding the query parameters.
*
*
* string path = 4;
@@ -7411,7 +7411,7 @@ public Builder setPath(java.lang.String value) {
*
*
*
- * The HTTP URL path.
+ * The HTTP URL path, excluding the query parameters.
*
*
* string path = 4;
@@ -7428,7 +7428,7 @@ public Builder clearPath() {
*
*
*
- * The HTTP URL path.
+ * The HTTP URL path, excluding the query parameters.
*
*
* string path = 4;
@@ -8641,7 +8641,7 @@ java.lang.String getHeadersOrDefault(
*
*
*
- * The length of time it takes the backend service to fully respond to a
+ * The amount of time it takes the backend service to fully respond to a
* request. Measured from when the destination service starts to send the
* request to the backend until when the destination service receives the
* complete response from the backend.
@@ -8656,7 +8656,7 @@ java.lang.String getHeadersOrDefault(
*
*
*
- * The length of time it takes the backend service to fully respond to a
+ * The amount of time it takes the backend service to fully respond to a
* request. Measured from when the destination service starts to send the
* request to the backend until when the destination service receives the
* complete response from the backend.
@@ -8671,7 +8671,7 @@ java.lang.String getHeadersOrDefault(
*
*
*
- * The length of time it takes the backend service to fully respond to a
+ * The amount of time it takes the backend service to fully respond to a
* request. Measured from when the destination service starts to send the
* request to the backend until when the destination service receives the
* complete response from the backend.
@@ -8938,7 +8938,7 @@ public com.google.protobuf.TimestampOrBuilder getTimeOrBuilder() {
*
*
*
- * The length of time it takes the backend service to fully respond to a
+ * The amount of time it takes the backend service to fully respond to a
* request. Measured from when the destination service starts to send the
* request to the backend until when the destination service receives the
* complete response from the backend.
@@ -8956,7 +8956,7 @@ public boolean hasBackendLatency() {
*
*
*
- * The length of time it takes the backend service to fully respond to a
+ * The amount of time it takes the backend service to fully respond to a
* request. Measured from when the destination service starts to send the
* request to the backend until when the destination service receives the
* complete response from the backend.
@@ -8976,7 +8976,7 @@ public com.google.protobuf.Duration getBackendLatency() {
*
*
*
- * The length of time it takes the backend service to fully respond to a
+ * The amount of time it takes the backend service to fully respond to a
* request. Measured from when the destination service starts to send the
* request to the backend until when the destination service receives the
* complete response from the backend.
@@ -9943,7 +9943,7 @@ public com.google.protobuf.TimestampOrBuilder getTimeOrBuilder() {
*
*
*
- * The length of time it takes the backend service to fully respond to a
+ * The amount of time it takes the backend service to fully respond to a
* request. Measured from when the destination service starts to send the
* request to the backend until when the destination service receives the
* complete response from the backend.
@@ -9960,7 +9960,7 @@ public boolean hasBackendLatency() {
*
*
*
- * The length of time it takes the backend service to fully respond to a
+ * The amount of time it takes the backend service to fully respond to a
* request. Measured from when the destination service starts to send the
* request to the backend until when the destination service receives the
* complete response from the backend.
@@ -9983,7 +9983,7 @@ public com.google.protobuf.Duration getBackendLatency() {
*
*
*
- * The length of time it takes the backend service to fully respond to a
+ * The amount of time it takes the backend service to fully respond to a
* request. Measured from when the destination service starts to send the
* request to the backend until when the destination service receives the
* complete response from the backend.
@@ -10008,7 +10008,7 @@ public Builder setBackendLatency(com.google.protobuf.Duration value) {
*
*
*
- * The length of time it takes the backend service to fully respond to a
+ * The amount of time it takes the backend service to fully respond to a
* request. Measured from when the destination service starts to send the
* request to the backend until when the destination service receives the
* complete response from the backend.
@@ -10030,7 +10030,7 @@ public Builder setBackendLatency(com.google.protobuf.Duration.Builder builderFor
*
*
*
- * The length of time it takes the backend service to fully respond to a
+ * The amount of time it takes the backend service to fully respond to a
* request. Measured from when the destination service starts to send the
* request to the backend until when the destination service receives the
* complete response from the backend.
@@ -10059,7 +10059,7 @@ public Builder mergeBackendLatency(com.google.protobuf.Duration value) {
*
*
*
- * The length of time it takes the backend service to fully respond to a
+ * The amount of time it takes the backend service to fully respond to a
* request. Measured from when the destination service starts to send the
* request to the backend until when the destination service receives the
* complete response from the backend.
@@ -10082,7 +10082,7 @@ public Builder clearBackendLatency() {
*
*
*
- * The length of time it takes the backend service to fully respond to a
+ * The amount of time it takes the backend service to fully respond to a
* request. Measured from when the destination service starts to send the
* request to the backend until when the destination service receives the
* complete response from the backend.
@@ -10099,7 +10099,7 @@ public com.google.protobuf.Duration.Builder getBackendLatencyBuilder() {
*
*
*
- * The length of time it takes the backend service to fully respond to a
+ * The amount of time it takes the backend service to fully respond to a
* request. Measured from when the destination service starts to send the
* request to the backend until when the destination service receives the
* complete response from the backend.
@@ -10120,7 +10120,7 @@ public com.google.protobuf.DurationOrBuilder getBackendLatencyOrBuilder() {
*
*
*
- * The length of time it takes the backend service to fully respond to a
+ * The amount of time it takes the backend service to fully respond to a
* request. Measured from when the destination service starts to send the
* request to the backend until when the destination service receives the
* complete response from the backend.
@@ -10292,7 +10292,8 @@ public interface ResourceOrBuilder
*
* The type of the resource. The syntax is platform-specific because
* different platforms define their resources differently.
- * For Google APIs, the type format must be "{service}/{kind}".
+ * For Google APIs, the type format must be "{service}/{kind}", such as
+ * "pubsub.googleapis.com/Topic".
*
*
* string type = 3;
@@ -10306,7 +10307,8 @@ public interface ResourceOrBuilder
*
* The type of the resource. The syntax is platform-specific because
* different platforms define their resources differently.
- * For Google APIs, the type format must be "{service}/{kind}".
+ * For Google APIs, the type format must be "{service}/{kind}", such as
+ * "pubsub.googleapis.com/Topic".
*
*
* string type = 3;
@@ -10892,7 +10894,8 @@ public com.google.protobuf.ByteString getNameBytes() {
*
* The type of the resource. The syntax is platform-specific because
* different platforms define their resources differently.
- * For Google APIs, the type format must be "{service}/{kind}".
+ * For Google APIs, the type format must be "{service}/{kind}", such as
+ * "pubsub.googleapis.com/Topic".
*
*
* string type = 3;
@@ -10917,7 +10920,8 @@ public java.lang.String getType() {
*
* The type of the resource. The syntax is platform-specific because
* different platforms define their resources differently.
- * For Google APIs, the type format must be "{service}/{kind}".
+ * For Google APIs, the type format must be "{service}/{kind}", such as
+ * "pubsub.googleapis.com/Topic".
*
*
* string type = 3;
@@ -12458,7 +12462,8 @@ public Builder setNameBytes(com.google.protobuf.ByteString value) {
*
* The type of the resource. The syntax is platform-specific because
* different platforms define their resources differently.
- * For Google APIs, the type format must be "{service}/{kind}".
+ * For Google APIs, the type format must be "{service}/{kind}", such as
+ * "pubsub.googleapis.com/Topic".
*
*
* string type = 3;
@@ -12482,7 +12487,8 @@ public java.lang.String getType() {
*
* The type of the resource. The syntax is platform-specific because
* different platforms define their resources differently.
- * For Google APIs, the type format must be "{service}/{kind}".
+ * For Google APIs, the type format must be "{service}/{kind}", such as
+ * "pubsub.googleapis.com/Topic".
*
*
* string type = 3;
@@ -12506,7 +12512,8 @@ public com.google.protobuf.ByteString getTypeBytes() {
*
* The type of the resource. The syntax is platform-specific because
* different platforms define their resources differently.
- * For Google APIs, the type format must be "{service}/{kind}".
+ * For Google APIs, the type format must be "{service}/{kind}", such as
+ * "pubsub.googleapis.com/Topic".
*
*
* string type = 3;
@@ -12529,7 +12536,8 @@ public Builder setType(java.lang.String value) {
*
* The type of the resource. The syntax is platform-specific because
* different platforms define their resources differently.
- * For Google APIs, the type format must be "{service}/{kind}".
+ * For Google APIs, the type format must be "{service}/{kind}", such as
+ * "pubsub.googleapis.com/Topic".
*
*
* string type = 3;
@@ -12548,7 +12556,8 @@ public Builder clearType() {
*
* The type of the resource. The syntax is platform-specific because
* different platforms define their resources differently.
- * For Google APIs, the type format must be "{service}/{kind}".
+ * For Google APIs, the type format must be "{service}/{kind}", such as
+ * "pubsub.googleapis.com/Topic".
*
*
* string type = 3;
diff --git a/java-common-protos/proto-google-common-protos/src/main/proto/google/api/client.proto b/java-common-protos/proto-google-common-protos/src/main/proto/google/api/client.proto
index 323846f44d..227ccf3a53 100644
--- a/java-common-protos/proto-google-common-protos/src/main/proto/google/api/client.proto
+++ b/java-common-protos/proto-google-common-protos/src/main/proto/google/api/client.proto
@@ -104,7 +104,7 @@ extend google.protobuf.ServiceOptions {
message CommonLanguageSettings {
// Link to automatically generated reference documentation. Example:
// https://cloud.google.com/nodejs/docs/reference/asset/latest
- string reference_docs_uri = 1;
+ string reference_docs_uri = 1 [deprecated = true];
// The destination where API teams want this client library to be published.
repeated ClientLibraryDestination destinations = 2;
diff --git a/java-common-protos/proto-google-common-protos/src/main/proto/google/rpc/code.proto b/java-common-protos/proto-google-common-protos/src/main/proto/google/rpc/code.proto
index 98ae0ac18f..7c810af40f 100644
--- a/java-common-protos/proto-google-common-protos/src/main/proto/google/rpc/code.proto
+++ b/java-common-protos/proto-google-common-protos/src/main/proto/google/rpc/code.proto
@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// Copyright 2022 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
@@ -30,7 +30,7 @@ option objc_class_prefix = "RPC";
// `OUT_OF_RANGE` over `FAILED_PRECONDITION` if both codes apply.
// Similarly prefer `NOT_FOUND` or `ALREADY_EXISTS` over `FAILED_PRECONDITION`.
enum Code {
- // Not an error; returned on success
+ // Not an error; returned on success.
//
// HTTP Mapping: 200 OK
OK = 0;
@@ -69,7 +69,7 @@ enum Code {
// Some requested entity (e.g., file or directory) was not found.
//
// Note to server developers: if a request is denied for an entire class
- // of users, such as gradual feature rollout or undocumented whitelist,
+ // of users, such as gradual feature rollout or undocumented allowlist,
// `NOT_FOUND` may be used. If a request is denied for some users within
// a class of users, such as user-based access control, `PERMISSION_DENIED`
// must be used.
@@ -115,11 +115,11 @@ enum Code {
// Service implementors can use the following guidelines to decide
// between `FAILED_PRECONDITION`, `ABORTED`, and `UNAVAILABLE`:
// (a) Use `UNAVAILABLE` if the client can retry just the failing call.
- // (b) Use `ABORTED` if the client should retry at a higher level
- // (e.g., when a client-specified test-and-set fails, indicating the
- // client should restart a read-modify-write sequence).
+ // (b) Use `ABORTED` if the client should retry at a higher level. For
+ // example, when a client-specified test-and-set fails, indicating the
+ // client should restart a read-modify-write sequence.
// (c) Use `FAILED_PRECONDITION` if the client should not retry until
- // the system state has been explicitly fixed. E.g., if an "rmdir"
+ // the system state has been explicitly fixed. For example, if an "rmdir"
// fails because the directory is non-empty, `FAILED_PRECONDITION`
// should be returned since the client should not retry unless
// the files are deleted from the directory.
diff --git a/java-common-protos/proto-google-common-protos/src/main/proto/google/rpc/context/attribute_context.proto b/java-common-protos/proto-google-common-protos/src/main/proto/google/rpc/context/attribute_context.proto
index 30fe6f25ab..ef9242e400 100644
--- a/java-common-protos/proto-google-common-protos/src/main/proto/google/rpc/context/attribute_context.proto
+++ b/java-common-protos/proto-google-common-protos/src/main/proto/google/rpc/context/attribute_context.proto
@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// Copyright 2022 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
@@ -61,7 +61,7 @@ message AttributeContext {
// The identity of this peer. Similar to `Request.auth.principal`, but
// relative to the peer instead of the request. For example, the
- // idenity associated with a load balancer that forwared the request.
+ // identity associated with a load balancer that forwarded the request.
string principal = 7;
// The CLDR country/region code associated with the above IP address.
@@ -170,7 +170,7 @@ message AttributeContext {
// lowercased, because HTTP header keys are case-insensitive.
map headers = 3;
- // The HTTP URL path.
+ // The HTTP URL path, excluding the query parameters.
string path = 4;
// The HTTP request `Host` header value.
@@ -223,7 +223,7 @@ message AttributeContext {
// the response.
google.protobuf.Timestamp time = 4;
- // The length of time it takes the backend service to fully respond to a
+ // The amount of time it takes the backend service to fully respond to a
// request. Measured from when the destination service starts to send the
// request to the backend until when the destination service receives the
// complete response from the backend.
@@ -256,7 +256,8 @@ message AttributeContext {
// The type of the resource. The syntax is platform-specific because
// different platforms define their resources differently.
//
- // For Google APIs, the type format must be "{service}/{kind}".
+ // For Google APIs, the type format must be "{service}/{kind}", such as
+ // "pubsub.googleapis.com/Topic".
string type = 3;
// The labels or tags on the resource, such as AWS resource tags and
diff --git a/java-common-protos/proto-google-common-protos/src/main/proto/google/rpc/error_details.proto b/java-common-protos/proto-google-common-protos/src/main/proto/google/rpc/error_details.proto
index c4d6c4b78c..c489e83142 100644
--- a/java-common-protos/proto-google-common-protos/src/main/proto/google/rpc/error_details.proto
+++ b/java-common-protos/proto-google-common-protos/src/main/proto/google/rpc/error_details.proto
@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// Copyright 2022 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
@@ -24,6 +24,57 @@ option java_outer_classname = "ErrorDetailsProto";
option java_package = "com.google.rpc";
option objc_class_prefix = "RPC";
+// Describes the cause of the error with structured details.
+//
+// Example of an error when contacting the "pubsub.googleapis.com" API when it
+// is not enabled:
+//
+// { "reason": "API_DISABLED"
+// "domain": "googleapis.com"
+// "metadata": {
+// "resource": "projects/123",
+// "service": "pubsub.googleapis.com"
+// }
+// }
+//
+// This response indicates that the pubsub.googleapis.com API is not enabled.
+//
+// Example of an error that is returned when attempting to create a Spanner
+// instance in a region that is out of stock:
+//
+// { "reason": "STOCKOUT"
+// "domain": "spanner.googleapis.com",
+// "metadata": {
+// "availableRegions": "us-central1,us-east2"
+// }
+// }
+message ErrorInfo {
+ // The reason of the error. This is a constant value that identifies the
+ // proximate cause of the error. Error reasons are unique within a particular
+ // domain of errors. This should be at most 63 characters and match a
+ // regular expression of `[A-Z][A-Z0-9_]+[A-Z0-9]`, which represents
+ // UPPER_SNAKE_CASE.
+ string reason = 1;
+
+ // The logical grouping to which the "reason" belongs. The error domain
+ // is typically the registered service name of the tool or product that
+ // generates the error. Example: "pubsub.googleapis.com". If the error is
+ // generated by some common infrastructure, the error domain must be a
+ // globally unique value that identifies the infrastructure. For Google API
+ // infrastructure, the error domain is "googleapis.com".
+ string domain = 2;
+
+ // Additional structured details about this error.
+ //
+ // Keys should match /[a-zA-Z0-9-_]/ and be limited to 64 characters in
+ // length. When identifying the current value of an exceeded limit, the units
+ // should be contained in the key, not the value. For example, rather than
+ // {"instanceLimit": "100/request"}, should be returned as,
+ // {"instanceLimitPerRequest": "100"}, if the client exceeds the number of
+ // instances that can be created in a single (batch) request.
+ map metadata = 3;
+}
+
// Describes when the clients can retry a failed request. Clients could ignore
// the recommendation here or retry when this information is missing from error
// responses.
@@ -85,56 +136,6 @@ message QuotaFailure {
repeated Violation violations = 1;
}
-// Describes the cause of the error with structured details.
-//
-// Example of an error when contacting the "pubsub.googleapis.com" API when it
-// is not enabled:
-//
-// { "reason": "API_DISABLED"
-// "domain": "googleapis.com"
-// "metadata": {
-// "resource": "projects/123",
-// "service": "pubsub.googleapis.com"
-// }
-// }
-//
-// This response indicates that the pubsub.googleapis.com API is not enabled.
-//
-// Example of an error that is returned when attempting to create a Spanner
-// instance in a region that is out of stock:
-//
-// { "reason": "STOCKOUT"
-// "domain": "spanner.googleapis.com",
-// "metadata": {
-// "availableRegions": "us-central1,us-east2"
-// }
-// }
-message ErrorInfo {
- // The reason of the error. This is a constant value that identifies the
- // proximate cause of the error. Error reasons are unique within a particular
- // domain of errors. This should be at most 63 characters and match
- // /[A-Z0-9_]+/.
- string reason = 1;
-
- // The logical grouping to which the "reason" belongs. The error domain
- // is typically the registered service name of the tool or product that
- // generates the error. Example: "pubsub.googleapis.com". If the error is
- // generated by some common infrastructure, the error domain must be a
- // globally unique value that identifies the infrastructure. For Google API
- // infrastructure, the error domain is "googleapis.com".
- string domain = 2;
-
- // Additional structured details about this error.
- //
- // Keys should match /[a-zA-Z0-9-_]/ and be limited to 64 characters in
- // length. When identifying the current value of an exceeded limit, the units
- // should be contained in the key, not the value. For example, rather than
- // {"instanceLimit": "100/request"}, should be returned as,
- // {"instanceLimitPerRequest": "100"}, if the client exceeds the number of
- // instances that can be created in a single (batch) request.
- map metadata = 3;
-}
-
// Describes what preconditions have failed.
//
// For example, if an RPC failed because it required the Terms of Service to be
@@ -169,9 +170,43 @@ message PreconditionFailure {
message BadRequest {
// A message type used to describe a single bad request field.
message FieldViolation {
- // A path leading to a field in the request body. The value will be a
+ // A path that leads to a field in the request body. The value will be a
// sequence of dot-separated identifiers that identify a protocol buffer
- // field. E.g., "field_violations.field" would identify this field.
+ // field.
+ //
+ // Consider the following:
+ //
+ // message CreateContactRequest {
+ // message EmailAddress {
+ // enum Type {
+ // TYPE_UNSPECIFIED = 0;
+ // HOME = 1;
+ // WORK = 2;
+ // }
+ //
+ // optional string email = 1;
+ // repeated EmailType type = 2;
+ // }
+ //
+ // string full_name = 1;
+ // repeated EmailAddress email_addresses = 2;
+ // }
+ //
+ // In this example, in proto `field` could take one of the following values:
+ //
+ // * `full_name` for a violation in the `full_name` value
+ // * `email_addresses[1].email` for a violation in the `email` field of the
+ // first `email_addresses` message
+ // * `email_addresses[3].type[2]` for a violation in the second `type`
+ // value in the third `email_addresses` message.
+ //
+ // In JSON, the same values are represented as:
+ //
+ // * `fullName` for a violation in the `fullName` value
+ // * `emailAddresses[1].email` for a violation in the `email` field of the
+ // first `emailAddresses` message
+ // * `emailAddresses[3].type[2]` for a violation in the second `type`
+ // value in the third `emailAddresses` message.
string field = 1;
// A description of why the request element is bad.
@@ -203,7 +238,8 @@ message ResourceInfo {
// The name of the resource being accessed. For example, a shared calendar
// name: "example.com_4fghdhgsrgh@group.calendar.google.com", if the current
- // error is [google.rpc.Code.PERMISSION_DENIED][google.rpc.Code.PERMISSION_DENIED].
+ // error is
+ // [google.rpc.Code.PERMISSION_DENIED][google.rpc.Code.PERMISSION_DENIED].
string resource_name = 2;
// The owner of the resource (optional).
@@ -240,7 +276,7 @@ message Help {
// which can be attached to an RPC error.
message LocalizedMessage {
// The locale used following the specification defined at
- // http://www.rfc-editor.org/rfc/bcp/bcp47.txt.
+ // https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
// Examples are: "en-US", "fr-CH", "es-MX"
string locale = 1;
diff --git a/java-common-protos/proto-google-common-protos/src/main/proto/google/rpc/status.proto b/java-common-protos/proto-google-common-protos/src/main/proto/google/rpc/status.proto
index 3b1f7a932f..923e169381 100644
--- a/java-common-protos/proto-google-common-protos/src/main/proto/google/rpc/status.proto
+++ b/java-common-protos/proto-google-common-protos/src/main/proto/google/rpc/status.proto
@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// Copyright 2022 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
@@ -33,12 +33,14 @@ option objc_class_prefix = "RPC";
// You can find out more about this error model and how to work with it in the
// [API Design Guide](https://cloud.google.com/apis/design/errors).
message Status {
- // The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
+ // The status code, which should be an enum value of
+ // [google.rpc.Code][google.rpc.Code].
int32 code = 1;
// A developer-facing error message, which should be in English. Any
// user-facing error message should be localized and sent in the
- // [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
+ // [google.rpc.Status.details][google.rpc.Status.details] field, or localized
+ // by the client.
string message = 2;
// A list of messages that carry the error details. There is a common set of