google-cloud-pubsub-v1 0.1.2 → 0.4.1

data/lib/google/pubsub/v1/pubsub_pb.rb

@@ -11,16 +11,23 @@ require 'google/protobuf/duration_pb'
 require 'google/protobuf/empty_pb'
 require 'google/protobuf/field_mask_pb'
 require 'google/protobuf/timestamp_pb'
+require 'google/pubsub/v1/schema_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/pubsub/v1/pubsub.proto", :syntax => :proto3) do
     add_message "google.pubsub.v1.MessageStoragePolicy" do
       repeated :allowed_persistence_regions, :string, 1
     end
+    add_message "google.pubsub.v1.SchemaSettings" do
+      optional :schema, :string, 1
+      optional :encoding, :enum, 2, "google.pubsub.v1.Encoding"
+    end
     add_message "google.pubsub.v1.Topic" do
       optional :name, :string, 1
       map :labels, :string, :string, 2
       optional :message_storage_policy, :message, 3, "google.pubsub.v1.MessageStoragePolicy"
       optional :kms_key_name, :string, 5
+      optional :schema_settings, :message, 6, "google.pubsub.v1.SchemaSettings"
+      optional :satisfies_pzs, :bool, 7
     end
     add_message "google.pubsub.v1.PubsubMessage" do
       optional :data, :bytes, 1
@@ -220,6 +227,7 @@ module Google
     module PubSub
       module V1
         MessageStoragePolicy = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.MessageStoragePolicy").msgclass
+        SchemaSettings = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.SchemaSettings").msgclass
         Topic = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.Topic").msgclass
         PubsubMessage = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.PubsubMessage").msgclass
         GetTopicRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.GetTopicRequest").msgclass

data/lib/google/pubsub/v1/pubsub_services_pb.rb

@@ -28,44 +28,44 @@ module Google
           # messages to a topic.
           class Service
 
-            include GRPC::GenericService
+            include ::GRPC::GenericService
 
             self.marshal_class_method = :encode
             self.unmarshal_class_method = :decode
             self.service_name = 'google.pubsub.v1.Publisher'
 
-            # Creates the given topic with the given name. See the [resource name rules](
-            # https://cloud.google.com/pubsub/docs/admin#resource_names).
-            rpc :CreateTopic, Google::Cloud::PubSub::V1::Topic, Google::Cloud::PubSub::V1::Topic
+            # Creates the given topic with the given name. See the [resource name rules]
+            # (https://cloud.google.com/pubsub/docs/admin#resource_names).
+            rpc :CreateTopic, ::Google::Cloud::PubSub::V1::Topic, ::Google::Cloud::PubSub::V1::Topic
             # Updates an existing topic. Note that certain properties of a
             # topic are not modifiable.
-            rpc :UpdateTopic, Google::Cloud::PubSub::V1::UpdateTopicRequest, Google::Cloud::PubSub::V1::Topic
+            rpc :UpdateTopic, ::Google::Cloud::PubSub::V1::UpdateTopicRequest, ::Google::Cloud::PubSub::V1::Topic
             # Adds one or more messages to the topic. Returns `NOT_FOUND` if the topic
             # does not exist.
-            rpc :Publish, Google::Cloud::PubSub::V1::PublishRequest, Google::Cloud::PubSub::V1::PublishResponse
+            rpc :Publish, ::Google::Cloud::PubSub::V1::PublishRequest, ::Google::Cloud::PubSub::V1::PublishResponse
             # Gets the configuration of a topic.
-            rpc :GetTopic, Google::Cloud::PubSub::V1::GetTopicRequest, Google::Cloud::PubSub::V1::Topic
+            rpc :GetTopic, ::Google::Cloud::PubSub::V1::GetTopicRequest, ::Google::Cloud::PubSub::V1::Topic
             # Lists matching topics.
-            rpc :ListTopics, Google::Cloud::PubSub::V1::ListTopicsRequest, Google::Cloud::PubSub::V1::ListTopicsResponse
+            rpc :ListTopics, ::Google::Cloud::PubSub::V1::ListTopicsRequest, ::Google::Cloud::PubSub::V1::ListTopicsResponse
             # Lists the names of the attached subscriptions on this topic.
-            rpc :ListTopicSubscriptions, Google::Cloud::PubSub::V1::ListTopicSubscriptionsRequest, Google::Cloud::PubSub::V1::ListTopicSubscriptionsResponse
+            rpc :ListTopicSubscriptions, ::Google::Cloud::PubSub::V1::ListTopicSubscriptionsRequest, ::Google::Cloud::PubSub::V1::ListTopicSubscriptionsResponse
             # Lists the names of the snapshots on this topic. Snapshots are used in
             # [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
             # which allow you to manage message acknowledgments in bulk. That is, you can
             # set the acknowledgment state of messages in an existing subscription to the
             # state captured by a snapshot.
-            rpc :ListTopicSnapshots, Google::Cloud::PubSub::V1::ListTopicSnapshotsRequest, Google::Cloud::PubSub::V1::ListTopicSnapshotsResponse
+            rpc :ListTopicSnapshots, ::Google::Cloud::PubSub::V1::ListTopicSnapshotsRequest, ::Google::Cloud::PubSub::V1::ListTopicSnapshotsResponse
             # Deletes the topic with the given name. Returns `NOT_FOUND` if the topic
             # does not exist. After a topic is deleted, a new topic may be created with
             # the same name; this is an entirely new topic with none of the old
             # configuration or subscriptions. Existing subscriptions to this topic are
             # not deleted, but their `topic` field is set to `_deleted-topic_`.
-            rpc :DeleteTopic, Google::Cloud::PubSub::V1::DeleteTopicRequest, Google::Protobuf::Empty
+            rpc :DeleteTopic, ::Google::Cloud::PubSub::V1::DeleteTopicRequest, ::Google::Protobuf::Empty
             # Detaches a subscription from this topic. All messages retained in the
             # subscription are dropped. Subsequent `Pull` and `StreamingPull` requests
             # will return FAILED_PRECONDITION. If the subscription is a push
             # subscription, pushes to the endpoint will stop.
-            rpc :DetachSubscription, Google::Cloud::PubSub::V1::DetachSubscriptionRequest, Google::Cloud::PubSub::V1::DetachSubscriptionResponse
+            rpc :DetachSubscription, ::Google::Cloud::PubSub::V1::DetachSubscriptionRequest, ::Google::Cloud::PubSub::V1::DetachSubscriptionResponse
           end
 
           Stub = Service.rpc_stub_class
@@ -76,7 +76,7 @@ module Google
           # establishing a bi-directional stream using the `StreamingPull` method.
           class Service
 
-            include GRPC::GenericService
+            include ::GRPC::GenericService
 
             self.marshal_class_method = :encode
             self.unmarshal_class_method = :decode
@@ -93,26 +93,26 @@ module Google
             # (https://cloud.google.com/pubsub/docs/admin#resource_names). The generated
             # name is populated in the returned Subscription object. Note that for REST
             # API requests, you must specify a name in the request.
-            rpc :CreateSubscription, Google::Cloud::PubSub::V1::Subscription, Google::Cloud::PubSub::V1::Subscription
+            rpc :CreateSubscription, ::Google::Cloud::PubSub::V1::Subscription, ::Google::Cloud::PubSub::V1::Subscription
             # Gets the configuration details of a subscription.
-            rpc :GetSubscription, Google::Cloud::PubSub::V1::GetSubscriptionRequest, Google::Cloud::PubSub::V1::Subscription
+            rpc :GetSubscription, ::Google::Cloud::PubSub::V1::GetSubscriptionRequest, ::Google::Cloud::PubSub::V1::Subscription
             # Updates an existing subscription. Note that certain properties of a
             # subscription, such as its topic, are not modifiable.
-            rpc :UpdateSubscription, Google::Cloud::PubSub::V1::UpdateSubscriptionRequest, Google::Cloud::PubSub::V1::Subscription
+            rpc :UpdateSubscription, ::Google::Cloud::PubSub::V1::UpdateSubscriptionRequest, ::Google::Cloud::PubSub::V1::Subscription
             # Lists matching subscriptions.
-            rpc :ListSubscriptions, Google::Cloud::PubSub::V1::ListSubscriptionsRequest, Google::Cloud::PubSub::V1::ListSubscriptionsResponse
+            rpc :ListSubscriptions, ::Google::Cloud::PubSub::V1::ListSubscriptionsRequest, ::Google::Cloud::PubSub::V1::ListSubscriptionsResponse
             # Deletes an existing subscription. All messages retained in the subscription
             # are immediately dropped. Calls to `Pull` after deletion will return
             # `NOT_FOUND`. After a subscription is deleted, a new one may be created with
             # the same name, but the new one has no association with the old
             # subscription or its topic unless the same topic is specified.
-            rpc :DeleteSubscription, Google::Cloud::PubSub::V1::DeleteSubscriptionRequest, Google::Protobuf::Empty
+            rpc :DeleteSubscription, ::Google::Cloud::PubSub::V1::DeleteSubscriptionRequest, ::Google::Protobuf::Empty
             # Modifies the ack deadline for a specific message. This method is useful
             # to indicate that more time is needed to process a message by the
             # subscriber, or to make the message available for redelivery if the
             # processing was interrupted. Note that this does not modify the
             # subscription-level `ackDeadlineSeconds` used for subsequent messages.
-            rpc :ModifyAckDeadline, Google::Cloud::PubSub::V1::ModifyAckDeadlineRequest, Google::Protobuf::Empty
+            rpc :ModifyAckDeadline, ::Google::Cloud::PubSub::V1::ModifyAckDeadlineRequest, ::Google::Protobuf::Empty
             # Acknowledges the messages associated with the `ack_ids` in the
             # `AcknowledgeRequest`. The Pub/Sub system can remove the relevant messages
             # from the subscription.
@@ -120,11 +120,11 @@ module Google
             # Acknowledging a message whose ack deadline has expired may succeed,
             # but such a message may be redelivered later. Acknowledging a message more
             # than once will not result in an error.
-            rpc :Acknowledge, Google::Cloud::PubSub::V1::AcknowledgeRequest, Google::Protobuf::Empty
+            rpc :Acknowledge, ::Google::Cloud::PubSub::V1::AcknowledgeRequest, ::Google::Protobuf::Empty
             # Pulls messages from the server. The server may return `UNAVAILABLE` if
             # there are too many concurrent pull requests pending for the given
             # subscription.
-            rpc :Pull, Google::Cloud::PubSub::V1::PullRequest, Google::Cloud::PubSub::V1::PullResponse
+            rpc :Pull, ::Google::Cloud::PubSub::V1::PullRequest, ::Google::Cloud::PubSub::V1::PullResponse
             # Establishes a stream with the server, which sends messages down to the
             # client. The client streams acknowledgements and ack deadline modifications
             # back to the server. The server will close the stream and return the status
@@ -132,26 +132,26 @@ module Google
             # reassign server-side resources, in which case, the client should
             # re-establish the stream. Flow control can be achieved by configuring the
             # underlying RPC channel.
-            rpc :StreamingPull, stream(Google::Cloud::PubSub::V1::StreamingPullRequest), stream(Google::Cloud::PubSub::V1::StreamingPullResponse)
+            rpc :StreamingPull, stream(::Google::Cloud::PubSub::V1::StreamingPullRequest), stream(::Google::Cloud::PubSub::V1::StreamingPullResponse)
             # Modifies the `PushConfig` for a specified subscription.
             #
             # This may be used to change a push subscription to a pull one (signified by
             # an empty `PushConfig`) or vice versa, or change the endpoint URL and other
             # attributes of a push subscription. Messages will accumulate for delivery
             # continuously through the call regardless of changes to the `PushConfig`.
-            rpc :ModifyPushConfig, Google::Cloud::PubSub::V1::ModifyPushConfigRequest, Google::Protobuf::Empty
+            rpc :ModifyPushConfig, ::Google::Cloud::PubSub::V1::ModifyPushConfigRequest, ::Google::Protobuf::Empty
             # Gets the configuration details of a snapshot. Snapshots are used in
             # <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
             # operations, which allow you to manage message acknowledgments in bulk. That
             # is, you can set the acknowledgment state of messages in an existing
             # subscription to the state captured by a snapshot.
-            rpc :GetSnapshot, Google::Cloud::PubSub::V1::GetSnapshotRequest, Google::Cloud::PubSub::V1::Snapshot
+            rpc :GetSnapshot, ::Google::Cloud::PubSub::V1::GetSnapshotRequest, ::Google::Cloud::PubSub::V1::Snapshot
             # Lists the existing snapshots. Snapshots are used in [Seek](
             # https://cloud.google.com/pubsub/docs/replay-overview) operations, which
             # allow you to manage message acknowledgments in bulk. That is, you can set
             # the acknowledgment state of messages in an existing subscription to the
             # state captured by a snapshot.
-            rpc :ListSnapshots, Google::Cloud::PubSub::V1::ListSnapshotsRequest, Google::Cloud::PubSub::V1::ListSnapshotsResponse
+            rpc :ListSnapshots, ::Google::Cloud::PubSub::V1::ListSnapshotsRequest, ::Google::Cloud::PubSub::V1::ListSnapshotsResponse
             # Creates a snapshot from the requested subscription. Snapshots are used in
             # [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
             # which allow you to manage message acknowledgments in bulk. That is, you can
@@ -168,14 +168,14 @@ module Google
             # (https://cloud.google.com/pubsub/docs/admin#resource_names). The
             # generated name is populated in the returned Snapshot object. Note that for
             # REST API requests, you must specify a name in the request.
-            rpc :CreateSnapshot, Google::Cloud::PubSub::V1::CreateSnapshotRequest, Google::Cloud::PubSub::V1::Snapshot
+            rpc :CreateSnapshot, ::Google::Cloud::PubSub::V1::CreateSnapshotRequest, ::Google::Cloud::PubSub::V1::Snapshot
             # Updates an existing snapshot. Snapshots are used in
             # <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
             # operations, which allow
             # you to manage message acknowledgments in bulk. That is, you can set the
             # acknowledgment state of messages in an existing subscription to the state
             # captured by a snapshot.
-            rpc :UpdateSnapshot, Google::Cloud::PubSub::V1::UpdateSnapshotRequest, Google::Cloud::PubSub::V1::Snapshot
+            rpc :UpdateSnapshot, ::Google::Cloud::PubSub::V1::UpdateSnapshotRequest, ::Google::Cloud::PubSub::V1::Snapshot
             # Removes an existing snapshot. Snapshots are used in [Seek]
             # (https://cloud.google.com/pubsub/docs/replay-overview) operations, which
             # allow you to manage message acknowledgments in bulk. That is, you can set
@@ -185,15 +185,15 @@ module Google
             # are immediately dropped. After a snapshot is deleted, a new one may be
             # created with the same name, but the new one has no association with the old
             # snapshot or its subscription, unless the same subscription is specified.
-            rpc :DeleteSnapshot, Google::Cloud::PubSub::V1::DeleteSnapshotRequest, Google::Protobuf::Empty
+            rpc :DeleteSnapshot, ::Google::Cloud::PubSub::V1::DeleteSnapshotRequest, ::Google::Protobuf::Empty
             # Seeks an existing subscription to a point in time or to a given snapshot,
-            # whichever is provided in the request. Snapshots are used in [Seek](
-            # https://cloud.google.com/pubsub/docs/replay-overview) operations, which
+            # whichever is provided in the request. Snapshots are used in [Seek]
+            # (https://cloud.google.com/pubsub/docs/replay-overview) operations, which
             # allow you to manage message acknowledgments in bulk. That is, you can set
             # the acknowledgment state of messages in an existing subscription to the
             # state captured by a snapshot. Note that both the subscription and the
             # snapshot must be on the same topic.
-            rpc :Seek, Google::Cloud::PubSub::V1::SeekRequest, Google::Cloud::PubSub::V1::SeekResponse
+            rpc :Seek, ::Google::Cloud::PubSub::V1::SeekRequest, ::Google::Cloud::PubSub::V1::SeekResponse
           end
 
           Stub = Service.rpc_stub_class

data/lib/google/pubsub/v1/schema_pb.rb

@@ -0,0 +1,95 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/pubsub/v1/schema.proto
+
+require 'google/protobuf'
+
+require 'google/api/annotations_pb'
+require 'google/api/client_pb'
+require 'google/api/field_behavior_pb'
+require 'google/api/resource_pb'
+require 'google/protobuf/empty_pb'
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/pubsub/v1/schema.proto", :syntax => :proto3) do
+    add_message "google.pubsub.v1.Schema" do
+      optional :name, :string, 1
+      optional :type, :enum, 2, "google.pubsub.v1.Schema.Type"
+      optional :definition, :string, 3
+    end
+    add_enum "google.pubsub.v1.Schema.Type" do
+      value :TYPE_UNSPECIFIED, 0
+      value :PROTOCOL_BUFFER, 1
+      value :AVRO, 2
+    end
+    add_message "google.pubsub.v1.CreateSchemaRequest" do
+      optional :parent, :string, 1
+      optional :schema, :message, 2, "google.pubsub.v1.Schema"
+      optional :schema_id, :string, 3
+    end
+    add_message "google.pubsub.v1.GetSchemaRequest" do
+      optional :name, :string, 1
+      optional :view, :enum, 2, "google.pubsub.v1.SchemaView"
+    end
+    add_message "google.pubsub.v1.ListSchemasRequest" do
+      optional :parent, :string, 1
+      optional :view, :enum, 2, "google.pubsub.v1.SchemaView"
+      optional :page_size, :int32, 3
+      optional :page_token, :string, 4
+    end
+    add_message "google.pubsub.v1.ListSchemasResponse" do
+      repeated :schemas, :message, 1, "google.pubsub.v1.Schema"
+      optional :next_page_token, :string, 2
+    end
+    add_message "google.pubsub.v1.DeleteSchemaRequest" do
+      optional :name, :string, 1
+    end
+    add_message "google.pubsub.v1.ValidateSchemaRequest" do
+      optional :parent, :string, 1
+      optional :schema, :message, 2, "google.pubsub.v1.Schema"
+    end
+    add_message "google.pubsub.v1.ValidateSchemaResponse" do
+    end
+    add_message "google.pubsub.v1.ValidateMessageRequest" do
+      optional :parent, :string, 1
+      optional :message, :bytes, 4
+      optional :encoding, :enum, 5, "google.pubsub.v1.Encoding"
+      oneof :schema_spec do
+        optional :name, :string, 2
+        optional :schema, :message, 3, "google.pubsub.v1.Schema"
+      end
+    end
+    add_message "google.pubsub.v1.ValidateMessageResponse" do
+    end
+    add_enum "google.pubsub.v1.SchemaView" do
+      value :SCHEMA_VIEW_UNSPECIFIED, 0
+      value :BASIC, 1
+      value :FULL, 2
+    end
+    add_enum "google.pubsub.v1.Encoding" do
+      value :ENCODING_UNSPECIFIED, 0
+      value :JSON, 1
+      value :BINARY, 2
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module PubSub
+      module V1
+        Schema = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.Schema").msgclass
+        Schema::Type = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.Schema.Type").enummodule
+        CreateSchemaRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.CreateSchemaRequest").msgclass
+        GetSchemaRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.GetSchemaRequest").msgclass
+        ListSchemasRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.ListSchemasRequest").msgclass
+        ListSchemasResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.ListSchemasResponse").msgclass
+        DeleteSchemaRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.DeleteSchemaRequest").msgclass
+        ValidateSchemaRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.ValidateSchemaRequest").msgclass
+        ValidateSchemaResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.ValidateSchemaResponse").msgclass
+        ValidateMessageRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.ValidateMessageRequest").msgclass
+        ValidateMessageResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.ValidateMessageResponse").msgclass
+        SchemaView = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.SchemaView").enummodule
+        Encoding = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.Encoding").enummodule
+      end
+    end
+  end
+end

data/lib/google/pubsub/v1/schema_services_pb.rb

@@ -0,0 +1,55 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: google/pubsub/v1/schema.proto for package 'Google.Cloud.PubSub.V1'
+# Original file comments:
+# Copyright 2020 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+require 'grpc'
+require 'google/pubsub/v1/schema_pb'
+
+module Google
+  module Cloud
+    module PubSub
+      module V1
+        module SchemaService
+          # Service for doing schema-related operations.
+          class Service
+
+            include ::GRPC::GenericService
+
+            self.marshal_class_method = :encode
+            self.unmarshal_class_method = :decode
+            self.service_name = 'google.pubsub.v1.SchemaService'
+
+            # Creates a schema.
+            rpc :CreateSchema, ::Google::Cloud::PubSub::V1::CreateSchemaRequest, ::Google::Cloud::PubSub::V1::Schema
+            # Gets a schema.
+            rpc :GetSchema, ::Google::Cloud::PubSub::V1::GetSchemaRequest, ::Google::Cloud::PubSub::V1::Schema
+            # Lists schemas in a project.
+            rpc :ListSchemas, ::Google::Cloud::PubSub::V1::ListSchemasRequest, ::Google::Cloud::PubSub::V1::ListSchemasResponse
+            # Deletes a schema.
+            rpc :DeleteSchema, ::Google::Cloud::PubSub::V1::DeleteSchemaRequest, ::Google::Protobuf::Empty
+            # Validates a schema.
+            rpc :ValidateSchema, ::Google::Cloud::PubSub::V1::ValidateSchemaRequest, ::Google::Cloud::PubSub::V1::ValidateSchemaResponse
+            # Validates a message against a schema.
+            rpc :ValidateMessage, ::Google::Cloud::PubSub::V1::ValidateMessageRequest, ::Google::Cloud::PubSub::V1::ValidateMessageResponse
+          end
+
+          Stub = Service.rpc_stub_class
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/api/field_behavior.rb

@@ -54,6 +54,12 @@ module Google
       # 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
     end
   end
 end

data/proto_docs/google/api/resource.rb

@@ -43,12 +43,12 @@ module Google
     #
     # The ResourceDescriptor Yaml config will look like:
     #
-    #    resources:
-    #    - type: "pubsub.googleapis.com/Topic"
-    #      name_descriptor:
-    #        - pattern: "projects/\\{project}/topics/\\{topic}"
-    #          parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #          parent_name_extractor: "projects/\\{project}"
+    #     resources:
+    #     - type: "pubsub.googleapis.com/Topic"
+    #       name_descriptor:
+    #         - pattern: "projects/{project}/topics/{topic}"
+    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
+    #           parent_name_extractor: "projects/{project}"
     #
     # Sometimes, resources have multiple patterns, typically because they can
     # live under multiple parents.
@@ -183,15 +183,24 @@ module Google
     #         }
     # @!attribute [rw] plural
     #   @return [::String]
-    #     The plural name used in the resource name, such as 'projects' for
-    #     the name of 'projects/\\{project}'. It is the same concept of the `plural`
-    #     field in k8s CRD spec
+    #     The plural name used in the resource name and permission names, such as
+    #     'projects' for the resource name of 'projects/\\{project}' and the permission
+    #     name of 'cloudresourcemanager.googleapis.com/projects.get'. It is the same
+    #     concept of the `plural` field in k8s CRD spec
     #     https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
+    #
+    #     Note: The plural form is required even for singleton resources. See
+    #     https://aip.dev/156
     # @!attribute [rw] singular
     #   @return [::String]
     #     The same concept of the `singular` field in k8s CRD spec
     #     https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
     #     Such as "project" for the `resourcemanager.googleapis.com/Project` type.
+    # @!attribute [rw] style
+    #   @return [::Array<::Google::Api::ResourceDescriptor::Style>]
+    #     Style flag(s) for this resource.
+    #     These indicate that a resource is expected to conform to a given
+    #     style. See the specific style flags for additional information.
     class ResourceDescriptor
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -211,6 +220,22 @@ module Google
         # that from being necessary once there are multiple patterns.)
         FUTURE_MULTI_PATTERN = 2
       end
+
+      # A flag representing a specific style that a resource claims to conform to.
+      module Style
+        # The unspecified value. Do not use.
+        STYLE_UNSPECIFIED = 0
+
+        # This resource is intended to be "declarative-friendly".
+        #
+        # Declarative-friendly resources must be more strictly consistent, and
+        # setting this to true communicates to tools that this resource should
+        # adhere to declarative-friendly expectations.
+        #
+        # Note: This is used by the API linter (linter.aip.dev) to enable
+        # additional checks.
+        DECLARATIVE_FRIENDLY = 1
+      end
     end
 
     # Defines a proto annotation that describes a string field that refers to
@@ -226,6 +251,17 @@ module Google
     #             type: "pubsub.googleapis.com/Topic"
     #           }];
     #         }
+    #
+    #     Occasionally, a field may reference an arbitrary resource. In this case,
+    #     APIs use the special value * in their resource reference.
+    #
+    #     Example:
+    #
+    #         message GetIamPolicyRequest {
+    #           string resource = 2 [(google.api.resource_reference) = {
+    #             type: "*"
+    #           }];
+    #         }
     # @!attribute [rw] child_type
     #   @return [::String]
     #     The resource type of a child collection that the annotated field
@@ -234,11 +270,11 @@ module Google
     #
     #     Example:
     #
-    #       message ListLogEntriesRequest {
-    #         string parent = 1 [(google.api.resource_reference) = {
-    #           child_type: "logging.googleapis.com/LogEntry"
-    #         };
-    #       }
+    #         message ListLogEntriesRequest {
+    #           string parent = 1 [(google.api.resource_reference) = {
+    #             child_type: "logging.googleapis.com/LogEntry"
+    #           };
+    #         }
     class ResourceReference
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods