feat: Add the `UNORDERED_LIST` enum value for `google.api.field_behavior`.

Also includes minor documentation changes that seem to have been made
in the interim and never published.

PiperOrigin-RevId: 346664095

google/api/auth.proto

@@ -117,8 +117,8 @@ message AuthProvider {
   // Optional if the key set document:
   //  - can be retrieved from
   //    [OpenID
-  //    Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html of
-  //    the issuer.
+  //    Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html)
+  //    of the issuer.
   //  - can be inferred from the email domain of the issuer (e.g. a Google
   //  service account).
   //

google/api/endpoint.proto

@@ -22,10 +22,10 @@ option java_outer_classname = "EndpointProto";
 option java_package = "com.google.api";
 option objc_class_prefix = "GAPI";
 
-// `Endpoint` describes a network endpoint that serves a set of APIs.
-// A service may expose any number of endpoints, and all endpoints share the
-// same service configuration, such as quota configuration and monitoring
-// configuration.
+// `Endpoint` describes a network endpoint of a service that serves a set of
+// APIs. It is commonly known as a service endpoint. A service may expose
+// any number of service endpoints, and all service endpoints share the same
+// service definition, such as quota limits and monitoring metrics.
 //
 // Example service configuration:
 //

google/api/field_behavior.proto

@@ -75,4 +75,10 @@ enum FieldBehavior {
   // This indicates that the field may be set once in a request to create a
   // resource, but may not be changed thereafter.
   IMMUTABLE = 5;
+
+  // Denotes that a (repeated) field is an unordered list.
+  // This indicates that the service may provide the elements of the list
+  // in any arbitrary order, rather than the order the user originally
+  // provided. Additionally, the list's order may or may not be stable.
+  UNORDERED_LIST = 6;
 }

google/api/service.proto

@@ -70,7 +70,7 @@ option objc_class_prefix = "GAPI";
 //         requirements:
 //           provider_id: google_calendar_auth
 message Service {
-  // This field is obsolete. Its value must be set to `3`.
+  // Deprecated. The service config compiler always sets this field to `3`.
   google.protobuf.UInt32Value config_version = 20;
 
   // The service name, which is a DNS-like logical identifier for the

google/api/serviceconfig.yaml

@@ -1,5 +1,5 @@
 type: google.api.Service
-config_version: 1
+config_version: 3
 name: serviceconfig.googleapis.com
 title: Service Config API