google-cloud-service_directory-v1 0.7.0 → 0.8.0

data/proto_docs/google/cloud/servicedirectory/v1/endpoint.rb

@@ -30,39 +30,54 @@ module Google
         #     `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.
         # @!attribute [rw] address
         #   @return [::String]
-        #     Optional. An IPv4 or IPv6 address. Service Directory will reject bad
-        #     addresses like:
-        #       "8.8.8"
-        #       "8.8.8.8:53"
-        #       "test:bad:address"
-        #       "[::1]"
-        #       "[::1]:8080"
+        #     Optional. An IPv4 or IPv6 address. Service Directory rejects bad addresses
+        #     like:
+        #
+        #     *   `8.8.8`
+        #     *   `8.8.8.8:53`
+        #     *   `test:bad:address`
+        #     *   `[::1]`
+        #     *   `[::1]:8080`
+        #
         #     Limited to 45 characters.
         # @!attribute [rw] port
         #   @return [::Integer]
-        #     Optional. Service Directory will reject values outside of [0, 65535].
+        #     Optional. Service Directory rejects values outside of `[0, 65535]`.
         # @!attribute [rw] annotations
         #   @return [::Google::Protobuf::Map{::String => ::String}]
         #     Optional. Annotations for the endpoint. This data can be consumed by
-        #     service clients. Restrictions:
-        #      - The entire annotations dictionary may contain up to 512 characters,
-        #        spread accoss all key-value pairs. Annotations that goes beyond any
-        #        these limits will be rejected.
-        #      - Valid annotation keys have two segments: an optional prefix and name,
-        #        separated by a slash (/). The name segment is required and must be 63
-        #        characters or less, beginning and ending with an alphanumeric character
-        #        ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and
-        #        alphanumerics between. The prefix is optional. If specified, the prefix
-        #        must be a DNS subdomain: a series of DNS labels separated by dots (.),
-        #        not longer than 253 characters in total, followed by a slash (/).
-        #        Annotations that fails to meet these requirements will be rejected.
-        #      - The '(*.)google.com/' and '(*.)googleapis.com/' prefixes are reserved
-        #        for system annotations managed by Service Directory. If the user tries
-        #        to write to these keyspaces, those entries will be silently ignored by
-        #        the system.
-        #     Note: This field is equivalent to the 'metadata' field in the v1beta1 API.
+        #     service clients.
+        #
+        #     Restrictions:
+        #
+        #     *   The entire annotations dictionary may contain up to 512 characters,
+        #         spread accoss all key-value pairs. Annotations that go beyond this
+        #         limit are rejected
+        #     *   Valid annotation keys have two segments: an optional prefix and name,
+        #         separated by a slash (/). The name segment is required and must be 63
+        #         characters or less, beginning and ending with an alphanumeric character
+        #         ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and
+        #         alphanumerics between. The prefix is optional. If specified, the prefix
+        #         must be a DNS subdomain: a series of DNS labels separated by dots (.),
+        #         not longer than 253 characters in total, followed by a slash (/)
+        #         Annotations that fails to meet these requirements are rejected.
+        #
+        #     Note: This field is equivalent to the `metadata` field in the v1beta1 API.
         #     They have the same syntax and read/write to the same location in Service
         #     Directory.
+        # @!attribute [rw] network
+        #   @return [::String]
+        #     Immutable. The Google Compute Engine network (VPC) of the endpoint in the
+        #     format `projects/<project number>/locations/global/networks/*`.
+        #
+        #     The project must be specified by project number (project id is rejected).
+        #     Incorrectly formatted networks are rejected, we also check to make sure
+        #     that you have the servicedirectory.networks.attach permission on the
+        #     project specified.
+        # @!attribute [r] uid
+        #   @return [::String]
+        #     Output only. The globally unique identifier of the endpoint in the UUID4
+        #     format.
         class Endpoint
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/servicedirectory/v1/lookup_service.rb

@@ -36,22 +36,40 @@ module Google
         #   @return [::String]
         #     Optional. The filter applied to the endpoints of the resolved service.
         #
-        #     General filter string syntax:
-        #     <field> <operator> <value> (<logical connector>)
-        #     <field> can be "name" or "metadata.<key>" for map field.
-        #     <operator> can be "<, >, <=, >=, !=, =, :". Of which ":" means HAS and is
-        #     roughly the same as "=".
-        #     <value> must be the same data type as the field.
-        #     <logical connector> can be "AND, OR, NOT".
+        #     General `filter` string syntax:
+        #     `<field> <operator> <value> (<logical connector>)`
+        #
+        #     *   `<field>` can be `name`, `address`, `port`, or `annotations.<key>` for
+        #         map field
+        #     *   `<operator>` can be `<`, `>`, `<=`, `>=`, `!=`, `=`, `:`. Of which `:`
+        #         means `HAS`, and is roughly the same as `=`
+        #     *   `<value>` must be the same data type as field
+        #     *   `<logical connector>` can be `AND`, `OR`, `NOT`
         #
         #     Examples of valid filters:
-        #     * "metadata.owner" returns Endpoints that have a label with the
-        #       key "owner", this is the same as "metadata:owner"
-        #     * "metadata.protocol=gRPC" returns Endpoints that have key/value
-        #       "protocol=gRPC"
-        #     * "metadata.owner!=sd AND metadata.foo=bar" returns
-        #       Endpoints that have "owner" field in metadata with a value that is not
-        #       "sd" AND have the key/value foo=bar.
+        #
+        #     *   `annotations.owner` returns endpoints that have a annotation with the
+        #         key `owner`, this is the same as `annotations:owner`
+        #     *   `annotations.protocol=gRPC` returns endpoints that have key/value
+        #         `protocol=gRPC`
+        #     *   `address=192.108.1.105` returns endpoints that have this address
+        #     *   `port>8080` returns endpoints that have port number larger than 8080
+        #     *
+        #     `name>projects/my-project/locations/us-east1/namespaces/my-namespace/services/my-service/endpoints/endpoint-c`
+        #         returns endpoints that have name that is alphabetically later than the
+        #         string, so "endpoint-e" is returned but "endpoint-a" is not
+        #     *
+        #     `name=projects/my-project/locations/us-central1/namespaces/my-namespace/services/my-service/endpoints/ep-1`
+        #          returns the endpoint that has an endpoint_id equal to `ep-1`
+        #     *   `annotations.owner!=sd AND annotations.foo=bar` returns endpoints that
+        #         have `owner` in annotation key but value is not `sd` AND have
+        #         key/value `foo=bar`
+        #     *   `doesnotexist.foo=bar` returns an empty list. Note that endpoint
+        #         doesn't have a field called "doesnotexist". Since the filter does not
+        #         match any endpoint, it returns no results
+        #
+        #     For more information about filtering, see
+        #     [API Filtering](https://aip.dev/160).
         class ResolveServiceRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/servicedirectory/v1/namespace.rb

@@ -30,9 +30,13 @@ module Google
         #     `projects/*/locations/*/namespaces/*`.
         # @!attribute [rw] labels
         #   @return [::Google::Protobuf::Map{::String => ::String}]
-        #     Optional. Resource labels associated with this Namespace.
-        #     No more than 64 user labels can be associated with a given resource.  Label
+        #     Optional. Resource labels associated with this namespace.
+        #     No more than 64 user labels can be associated with a given resource. Label
         #     keys and values can be no longer than 63 characters.
+        # @!attribute [r] uid
+        #   @return [::String]
+        #     Output only. The globally unique identifier of the namespace in the UUID4
+        #     format.
         class Namespace
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/servicedirectory/v1/registration_service.rb

@@ -49,7 +49,7 @@ module Google
         # @!attribute [rw] parent
         #   @return [::String]
         #     Required. The resource name of the project and location whose namespaces
-        #     we'd like to list.
+        #     you'd like to list.
         # @!attribute [rw] page_size
         #   @return [::Integer]
         #     Optional. The maximum number of items to return.
@@ -59,40 +59,46 @@ module Google
         #     if any.
         # @!attribute [rw] filter
         #   @return [::String]
-        #     Optional. The filter to list result by.
+        #     Optional. The filter to list results by.
         #
-        #     General filter string syntax:
-        #     <field> <operator> <value> (<logical connector>)
-        #     <field> can be "name", or "labels.<key>" for map field.
-        #     <operator> can be "<, >, <=, >=, !=, =, :". Of which ":" means HAS, and
-        #     is roughly the same as "=".
-        #     <value> must be the same data type as field.
-        #     <logical connector> can be "AND, OR, NOT".
+        #     General `filter` string syntax:
+        #     `<field> <operator> <value> (<logical connector>)`
+        #
+        #     *   `<field>` can be `name` or `labels.<key>` for map field
+        #     *   `<operator>` can be `<`, `>`, `<=`, `>=`, `!=`, `=`, `:`. Of which `:`
+        #         means `HAS`, and is roughly the same as `=`
+        #     *   `<value>` must be the same data type as field
+        #     *   `<logical connector>` can be `AND`, `OR`, `NOT`
         #
         #     Examples of valid filters:
-        #     * "labels.owner" returns Namespaces that have a label with the key "owner"
-        #       this is the same as "labels:owner".
-        #     * "labels.protocol=gRPC" returns Namespaces that have key/value
-        #       "protocol=gRPC".
-        #     * "name>projects/my-project/locations/us-east/namespaces/namespace-c"
-        #       returns Namespaces that have name that is alphabetically later than the
-        #       string, so "namespace-e" will be returned but "namespace-a" will not be.
-        #     * "labels.owner!=sd AND labels.foo=bar" returns Namespaces that have
-        #       "owner" in label key but value is not "sd" AND have key/value foo=bar.
-        #     * "doesnotexist.foo=bar" returns an empty list. Note that Namespace doesn't
-        #       have a field called "doesnotexist". Since the filter does not match any
-        #       Namespaces, it returns no results.
+        #
+        #     *   `labels.owner` returns namespaces that have a label with the key
+        #         `owner`, this is the same as `labels:owner`
+        #     *   `labels.owner=sd` returns namespaces that have key/value
+        #         `owner=sd`
+        #     *   `name>projects/my-project/locations/us-east1/namespaces/namespace-c`
+        #         returns namespaces that have name that is alphabetically later than the
+        #         string, so "namespace-e" is returned but "namespace-a" is not
+        #     *   `labels.owner!=sd AND labels.foo=bar` returns namespaces that have
+        #         `owner` in label key but value is not `sd` AND have key/value `foo=bar`
+        #     *   `doesnotexist.foo=bar` returns an empty list. Note that namespace
+        #         doesn't have a field called "doesnotexist". Since the filter does not
+        #         match any namespaces, it returns no results
+        #
+        #     For more information about filtering, see
+        #     [API Filtering](https://aip.dev/160).
         # @!attribute [rw] order_by
         #   @return [::String]
-        #     Optional. The order to list result by.
+        #     Optional. The order to list results by.
+        #
+        #     General `order_by` string syntax: `<field> (<asc|desc>) (,)`
+        #
+        #     *   `<field>` allows value: `name`
+        #     *   `<asc|desc>` ascending or descending order by `<field>`. If this is
+        #         left blank, `asc` is used
         #
-        #     General order by string syntax:
-        #     <field> (<asc|desc>) (,)
-        #     <field> allows values \\{"name"}
-        #     <asc/desc> ascending or descending order by <field>. If this is left
-        #     blank, "asc" is used.
-        #     Note that an empty order_by string result in default order, which is order
-        #     by name in ascending order.
+        #     Note that an empty `order_by` string results in default order, which is
+        #     order by `name` in ascending order.
         class ListNamespacesRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -171,7 +177,7 @@ module Google
         # {::Google::Cloud::ServiceDirectory::V1::RegistrationService::Client#list_services RegistrationService.ListServices}.
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. The resource name of the namespace whose services we'd
+        #     Required. The resource name of the namespace whose services you'd
         #     like to list.
         # @!attribute [rw] page_size
         #   @return [::Integer]
@@ -182,32 +188,48 @@ module Google
         #     if any.
         # @!attribute [rw] filter
         #   @return [::String]
-        #     Optional. The filter to list result by.
+        #     Optional. The filter to list results by.
         #
-        #     General filter string syntax:
-        #     <field> <operator> <value> (<logical connector>)
-        #     <field> can be "name", or "metadata.<key>" for map field.
-        #     <operator> can be "<, >, <=, >=, !=, =, :". Of which ":" means HAS, and
-        #     is roughly the same as "=".
-        #     <value> must be the same data type as field.
-        #     <logical connector> can be "AND, OR, NOT".
+        #     General `filter` string syntax:
+        #     `<field> <operator> <value> (<logical connector>)`
+        #
+        #     *   `<field>` can be `name` or `annotations.<key>` for map field
+        #     *   `<operator>` can be `<`, `>`, `<=`, `>=`, `!=`, `=`, `:`. Of which `:`
+        #         means `HAS`, and is roughly the same as `=`
+        #     *   `<value>` must be the same data type as field
+        #     *   `<logical connector>` can be `AND`, `OR`, `NOT`
         #
         #     Examples of valid filters:
-        #     * "metadata.owner" returns Services that have a label with the key "owner"
-        #       this is the same as "metadata:owner".
-        #     * "metadata.protocol=gRPC" returns Services that have key/value
-        #       "protocol=gRPC".
-        #     * "name>projects/my-project/locations/us-east/namespaces/my-namespace/services/service-c"
-        #       returns Services that have name that is alphabetically later than the
-        #       string, so "service-e" will be returned but "service-a" will not be.
-        #     * "metadata.owner!=sd AND metadata.foo=bar" returns Services that have
-        #       "owner" in label key but value is not "sd" AND have key/value foo=bar.
-        #     * "doesnotexist.foo=bar" returns an empty list. Note that Service doesn't
-        #       have a field called "doesnotexist". Since the filter does not match any
-        #       Services, it returns no results.
+        #
+        #     *   `annotations.owner` returns services that have a annotation with the
+        #         key `owner`, this is the same as `annotations:owner`
+        #     *   `annotations.protocol=gRPC` returns services that have key/value
+        #         `protocol=gRPC`
+        #     *
+        #     `name>projects/my-project/locations/us-east1/namespaces/my-namespace/services/service-c`
+        #         returns services that have name that is alphabetically later than the
+        #         string, so "service-e" is returned but "service-a" is not
+        #     *   `annotations.owner!=sd AND annotations.foo=bar` returns services that
+        #         have `owner` in annotation key but value is not `sd` AND have
+        #         key/value `foo=bar`
+        #     *   `doesnotexist.foo=bar` returns an empty list. Note that service
+        #         doesn't have a field called "doesnotexist". Since the filter does not
+        #         match any services, it returns no results
+        #
+        #     For more information about filtering, see
+        #     [API Filtering](https://aip.dev/160).
         # @!attribute [rw] order_by
         #   @return [::String]
-        #     Optional. The order to list result by.
+        #     Optional. The order to list results by.
+        #
+        #     General `order_by` string syntax: `<field> (<asc|desc>) (,)`
+        #
+        #     *   `<field>` allows value: `name`
+        #     *   `<asc|desc>` ascending or descending order by `<field>`. If this is
+        #         left blank, `asc` is used
+        #
+        #     Note that an empty `order_by` string results in default order, which is
+        #     order by `name` in ascending order.
         class ListServicesRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -229,8 +251,8 @@ module Google
 
         # The request message for
         # {::Google::Cloud::ServiceDirectory::V1::RegistrationService::Client#get_service RegistrationService.GetService}.
-        # This should not be used for looking up a service. Insead, use the `resolve`
-        # method as it will contain all endpoints and associated metadata.
+        # This should not be used for looking up a service. Instead, use the `resolve`
+        # method as it contains all endpoints and associated annotations.
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The name of the service to get.
@@ -288,7 +310,7 @@ module Google
         # {::Google::Cloud::ServiceDirectory::V1::RegistrationService::Client#list_endpoints RegistrationService.ListEndpoints}.
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. The resource name of the service whose endpoints we'd like to
+        #     Required. The resource name of the service whose endpoints you'd like to
         #     list.
         # @!attribute [rw] page_size
         #   @return [::Integer]
@@ -299,34 +321,51 @@ module Google
         #     if any.
         # @!attribute [rw] filter
         #   @return [::String]
-        #     Optional. The filter to list result by.
+        #     Optional. The filter to list results by.
         #
-        #     General filter string syntax:
-        #     <field> <operator> <value> (<logical connector>)
-        #     <field> can be "name", "address", "port" or "metadata.<key>" for map field.
-        #     <operator> can be "<, >, <=, >=, !=, =, :". Of which ":" means HAS, and
-        #     is roughly the same as "=".
-        #     <value> must be the same data type as field.
-        #     <logical connector> can be "AND, OR, NOT".
+        #     General `filter` string syntax:
+        #     `<field> <operator> <value> (<logical connector>)`
+        #
+        #     *   `<field>` can be `name`, `address`, `port`, or `annotations.<key>` for
+        #          map field
+        #     *   `<operator>` can be `<`, `>`, `<=`, `>=`, `!=`, `=`, `:`. Of which `:`
+        #         means `HAS`, and is roughly the same as `=`
+        #     *   `<value>` must be the same data type as field
+        #     *   `<logical connector>` can be `AND`, `OR`, `NOT`
         #
         #     Examples of valid filters:
-        #     * "metadata.owner" returns Endpoints that have a label with the key "owner"
-        #       this is the same as "metadata:owner".
-        #     * "metadata.protocol=gRPC" returns Endpoints that have key/value
-        #       "protocol=gRPC".
-        #     * "address=192.108.1.105" returns Endpoints that have this address.
-        #     * "port>8080" returns Endpoints that have port number larger than 8080.
-        #     * "name>projects/my-project/locations/us-east/namespaces/my-namespace/services/my-service/endpoints/endpoint-c"
-        #       returns Endpoints that have name that is alphabetically later than the
-        #       string, so "endpoint-e" will be returned but "endpoint-a" will not be.
-        #     * "metadata.owner!=sd AND metadata.foo=bar" returns Endpoints that have
-        #       "owner" in label key but value is not "sd" AND have key/value foo=bar.
-        #     * "doesnotexist.foo=bar" returns an empty list. Note that Endpoint doesn't
-        #       have a field called "doesnotexist". Since the filter does not match any
-        #       Endpoints, it returns no results.
+        #
+        #     *   `annotations.owner` returns endpoints that have a annotation with the
+        #         key `owner`, this is the same as `annotations:owner`
+        #     *   `annotations.protocol=gRPC` returns endpoints that have key/value
+        #         `protocol=gRPC`
+        #     *   `address=192.108.1.105` returns endpoints that have this address
+        #     *   `port>8080` returns endpoints that have port number larger than 8080
+        #     *
+        #     `name>projects/my-project/locations/us-east1/namespaces/my-namespace/services/my-service/endpoints/endpoint-c`
+        #         returns endpoints that have name that is alphabetically later than the
+        #         string, so "endpoint-e" is returned but "endpoint-a" is not
+        #     *   `annotations.owner!=sd AND annotations.foo=bar` returns endpoints that
+        #         have `owner` in annotation key but value is not `sd` AND have
+        #         key/value `foo=bar`
+        #     *   `doesnotexist.foo=bar` returns an empty list. Note that endpoint
+        #         doesn't have a field called "doesnotexist". Since the filter does not
+        #         match any endpoints, it returns no results
+        #
+        #     For more information about filtering, see
+        #     [API Filtering](https://aip.dev/160).
         # @!attribute [rw] order_by
         #   @return [::String]
-        #     Optional. The order to list result by.
+        #     Optional. The order to list results by.
+        #
+        #     General `order_by` string syntax: `<field> (<asc|desc>) (,)`
+        #
+        #     *   `<field>` allows values: `name`, `address`, `port`
+        #     *   `<asc|desc>` ascending or descending order by `<field>`. If this is
+        #         left blank, `asc` is used
+        #
+        #     Note that an empty `order_by` string results in default order, which is
+        #     order by `name` in ascending order.
         class ListEndpointsRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/servicedirectory/v1/service.rb

@@ -33,30 +33,34 @@ module Google
         #   @return [::Google::Protobuf::Map{::String => ::String}]
         #     Optional. Annotations for the service. This data can be consumed by service
         #     clients.
+        #
         #     Restrictions:
-        #      - The entire annotations dictionary may contain up to 2000 characters,
-        #        spread accoss all key-value pairs. Annotations that goes beyond any
-        #        these limits will be rejected.
-        #      - Valid annotation keys have two segments: an optional prefix and name,
-        #        separated by a slash (/). The name segment is required and must be 63
-        #        characters or less, beginning and ending with an alphanumeric character
-        #        ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and
-        #        alphanumerics between. The prefix is optional. If specified, the prefix
-        #        must be a DNS subdomain: a series of DNS labels separated by dots (.),
-        #        not longer than 253 characters in total, followed by a slash (/).
-        #        Annotations that fails to meet these requirements will be rejected.
-        #      - The '(*.)google.com/' and '(*.)googleapis.com/' prefixes are reserved
-        #        for system annotations managed by Service Directory. If the user tries
-        #        to write to these keyspaces, those entries will be silently ignored by
-        #        the system.
-        #     Note: This field is equivalent to the 'metadata' field in the v1beta1 API.
+        #
+        #     *   The entire annotations dictionary may contain up to 2000 characters,
+        #         spread accoss all key-value pairs. Annotations that go beyond this
+        #         limit are rejected
+        #     *   Valid annotation keys have two segments: an optional prefix and name,
+        #         separated by a slash (/). The name segment is required and must be 63
+        #         characters or less, beginning and ending with an alphanumeric character
+        #         ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and
+        #         alphanumerics between. The prefix is optional. If specified, the prefix
+        #         must be a DNS subdomain: a series of DNS labels separated by dots (.),
+        #         not longer than 253 characters in total, followed by a slash (/).
+        #         Annotations that fails to meet these requirements are rejected
+        #
+        #     Note: This field is equivalent to the `metadata` field in the v1beta1 API.
         #     They have the same syntax and read/write to the same location in Service
         #     Directory.
         # @!attribute [r] endpoints
         #   @return [::Array<::Google::Cloud::ServiceDirectory::V1::Endpoint>]
         #     Output only. Endpoints associated with this service. Returned on
-        #     LookupService.Resolve. Control plane clients should use
-        #     RegistrationService.ListEndpoints.
+        #     {::Google::Cloud::ServiceDirectory::V1::LookupService::Client#resolve_service LookupService.ResolveService}.
+        #     Control plane clients should use
+        #     {::Google::Cloud::ServiceDirectory::V1::RegistrationService::Client#list_endpoints RegistrationService.ListEndpoints}.
+        # @!attribute [r] uid
+        #   @return [::String]
+        #     Output only. The globally unique identifier of the service in the UUID4
+        #     format.
         class Service
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/protobuf/any.rb

@@ -0,0 +1,144 @@
+# frozen_string_literal: true
+
+# Copyright 2023 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
+#
+#     https://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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Protobuf
+    # `Any` contains an arbitrary serialized protocol buffer message along with a
+    # URL that describes the type of the serialized message.
+    #
+    # Protobuf library provides support to pack/unpack Any values in the form
+    # of utility functions or additional generated methods of the Any type.
+    #
+    # Example 1: Pack and unpack a message in C++.
+    #
+    #     Foo foo = ...;
+    #     Any any;
+    #     any.PackFrom(foo);
+    #     ...
+    #     if (any.UnpackTo(&foo)) {
+    #       ...
+    #     }
+    #
+    # Example 2: Pack and unpack a message in Java.
+    #
+    #     Foo foo = ...;
+    #     Any any = Any.pack(foo);
+    #     ...
+    #     if (any.is(Foo.class)) {
+    #       foo = any.unpack(Foo.class);
+    #     }
+    #     // or ...
+    #     if (any.isSameTypeAs(Foo.getDefaultInstance())) {
+    #       foo = any.unpack(Foo.getDefaultInstance());
+    #     }
+    #
+    #  Example 3: Pack and unpack a message in Python.
+    #
+    #     foo = Foo(...)
+    #     any = Any()
+    #     any.Pack(foo)
+    #     ...
+    #     if any.Is(Foo.DESCRIPTOR):
+    #       any.Unpack(foo)
+    #       ...
+    #
+    #  Example 4: Pack and unpack a message in Go
+    #
+    #      foo := &pb.Foo{...}
+    #      any, err := anypb.New(foo)
+    #      if err != nil {
+    #        ...
+    #      }
+    #      ...
+    #      foo := &pb.Foo{}
+    #      if err := any.UnmarshalTo(foo); err != nil {
+    #        ...
+    #      }
+    #
+    # The pack methods provided by protobuf library will by default use
+    # 'type.googleapis.com/full.type.name' as the type URL and the unpack
+    # methods only use the fully qualified type name after the last '/'
+    # in the type URL, for example "foo.bar.com/x/y.z" will yield type
+    # name "y.z".
+    #
+    # JSON
+    # ====
+    # The JSON representation of an `Any` value uses the regular
+    # representation of the deserialized, embedded message, with an
+    # additional field `@type` which contains the type URL. Example:
+    #
+    #     package google.profile;
+    #     message Person {
+    #       string first_name = 1;
+    #       string last_name = 2;
+    #     }
+    #
+    #     {
+    #       "@type": "type.googleapis.com/google.profile.Person",
+    #       "firstName": <string>,
+    #       "lastName": <string>
+    #     }
+    #
+    # If the embedded message type is well-known and has a custom JSON
+    # representation, that representation will be embedded adding a field
+    # `value` which holds the custom JSON in addition to the `@type`
+    # field. Example (for message [google.protobuf.Duration][]):
+    #
+    #     {
+    #       "@type": "type.googleapis.com/google.protobuf.Duration",
+    #       "value": "1.212s"
+    #     }
+    # @!attribute [rw] type_url
+    #   @return [::String]
+    #     A URL/resource name that uniquely identifies the type of the serialized
+    #     protocol buffer message. This string must contain at least
+    #     one "/" character. The last segment of the URL's path must represent
+    #     the fully qualified name of the type (as in
+    #     `path/google.protobuf.Duration`). The name should be in a canonical form
+    #     (e.g., leading "." is not accepted).
+    #
+    #     In practice, teams usually precompile into the binary all types that they
+    #     expect it to use in the context of Any. However, for URLs which use the
+    #     scheme `http`, `https`, or no scheme, one can optionally set up a type
+    #     server that maps type URLs to message definitions as follows:
+    #
+    #     * If no scheme is provided, `https` is assumed.
+    #     * An HTTP GET on the URL must yield a [google.protobuf.Type][]
+    #       value in binary format, or produce an error.
+    #     * Applications are allowed to cache lookup results based on the
+    #       URL, or have them precompiled into a binary to avoid any
+    #       lookup. Therefore, binary compatibility needs to be preserved
+    #       on changes to types. (Use versioned type names to manage
+    #       breaking changes.)
+    #
+    #     Note: this functionality is not currently available in the official
+    #     protobuf release, and it is not used for type URLs beginning with
+    #     type.googleapis.com.
+    #
+    #     Schemes other than `http`, `https` (or the empty scheme) might be
+    #     used with implementation specific semantics.
+    # @!attribute [rw] value
+    #   @return [::String]
+    #     Must be a valid serialized protocol buffer of the above specified type.
+    class Any
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+  end
+end