google-analytics-data-v1alpha 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1f35e825d5c952314987ebc573bc42c593da6d4fcef5d92f214bbd1b38c072e3
-  data.tar.gz: 3ea3956052db10fd5f8847df581c4c608eb004094c8c7e4937d34b08e09a0247
+  metadata.gz: 5e13b1aba1492a99bdbca9844b8ac1e2b199afb970711e06fcdc7ca70fe2def1
+  data.tar.gz: fb9df83e9d524a47d1995bc22b7c0813713ac44f1adecb7169b045a489b8ac92
 SHA512:
-  metadata.gz: e8af6266cc1c1d6c60eb17d8ca1655b19bf4c83f86fe4c44943cc9c97ad42baa7fa1db868400851ef8cac6b5c479fc2f6449a06ed4dc70a6c7f81590313e9199
-  data.tar.gz: 6a9229c5a63f5307d31dfaa92991c498b2a9ce45d93ef383e1711cfcbd208c3b642811c653dc514b69e65957f038eae4e33cea31d1bc8fce335be97c27e0f00c
+  metadata.gz: cff0bfd6011cb6a3e8df55833e882f9d0653eb4ee61657b734ce3e90ede76169428f38c9af8ead57c6c42a87668c4c61deaa9bf87efe1989f98974000583db38
+  data.tar.gz: 27beadc602765008f63f2bcd4b8d5f3abf49c4846d8c02d4b4f16c3820b087be276aed162dcd73ed5acb108196d8f5dee97cd2cd8d6e76f3f2c68d3bf7d5b194

data/lib/google/analytics/data/v1alpha/analytics_data.rb

@@ -23,7 +23,6 @@ require "gapic/config/method"
 require "google/analytics/data/v1alpha/version"
 
 require "google/analytics/data/v1alpha/analytics_data/credentials"
-require "google/analytics/data/v1alpha/analytics_data/paths"
 require "google/analytics/data/v1alpha/analytics_data/client"
 
 module Google

data/lib/google/analytics/data/v1alpha/analytics_data/client.rb

@@ -30,8 +30,6 @@ module Google
           # Google Analytics reporting data service.
           #
           class Client
-            include Paths
-
             # @private
             attr_reader :analytics_data_stub
 
@@ -507,45 +505,37 @@ module Google
             # Used to explore the dimensions and metrics. Dimensions and metrics will be
             # mostly added over time, but renames and deletions may occur.
             #
-            # @overload get_metadata(request, options = nil)
-            #   Pass arguments to `get_metadata` via a request object, either of type
-            #   {::Google::Analytics::Data::V1alpha::GetMetadataRequest} or an equivalent Hash.
+            # This method returns Universal Metadata. Universal Metadata are dimensions
+            # and metrics applicable to any property such as `country` and `totalUsers`.
+            #
+            # @overload get_universal_metadata(request, options = nil)
+            #   Pass arguments to `get_universal_metadata` via a request object, either of type
+            #   {::Google::Analytics::Data::V1alpha::GetUniversalMetadataRequest} or an equivalent Hash.
             #
-            #   @param request [::Google::Analytics::Data::V1alpha::GetMetadataRequest, ::Hash]
+            #   @param request [::Google::Analytics::Data::V1alpha::GetUniversalMetadataRequest, ::Hash]
             #     A request object representing the call parameters. Required. To specify no
             #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload get_metadata(name: nil)
-            #   Pass arguments to `get_metadata` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param name [::String]
-            #     Required. The name of the metadata to retrieve. Either has the form
-            #     'metadata' or 'properties/\\{property}/metadata'. This name field is
-            #     specified in the URL path and not URL parameters. Property is a numeric
-            #     Google Analytics App + Web Property Id.
-            #
             # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Google::Analytics::Data::V1alpha::Metadata]
+            # @yieldparam response [::Google::Analytics::Data::V1alpha::UniversalMetadata]
             # @yieldparam operation [::GRPC::ActiveCall::Operation]
             #
-            # @return [::Google::Analytics::Data::V1alpha::Metadata]
+            # @return [::Google::Analytics::Data::V1alpha::UniversalMetadata]
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
-            def get_metadata request, options = nil
+            def get_universal_metadata request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Analytics::Data::V1alpha::GetMetadataRequest
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Analytics::Data::V1alpha::GetUniversalMetadataRequest
 
               # Converts hash and nil to an options object
               options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
 
               # Customize the options with defaults
-              metadata = @config.rpcs.get_metadata.metadata.to_h
+              metadata = @config.rpcs.get_universal_metadata.metadata.to_h
 
               # Set x-goog-api-client and x-goog-user-project headers
               metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
@@ -553,19 +543,13 @@ module Google
                 gapic_version: ::Google::Analytics::Data::V1alpha::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.get_metadata.timeout,
+              options.apply_defaults timeout:      @config.rpcs.get_universal_metadata.timeout,
                                      metadata:     metadata,
-                                     retry_policy: @config.rpcs.get_metadata.retry_policy
+                                     retry_policy: @config.rpcs.get_universal_metadata.retry_policy
               options.apply_defaults metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
-              @analytics_data_stub.call_rpc :get_metadata, request, options: options do |response, operation|
+              @analytics_data_stub.call_rpc :get_universal_metadata, request, options: options do |response, operation|
                 yield response, operation if block_given?
                 return response
               end
@@ -730,10 +714,10 @@ module Google
                 #
                 attr_reader :batch_run_pivot_reports
                 ##
-                # RPC-specific configuration for `get_metadata`
+                # RPC-specific configuration for `get_universal_metadata`
                 # @return [::Gapic::Config::Method]
                 #
-                attr_reader :get_metadata
+                attr_reader :get_universal_metadata
 
                 # @private
                 def initialize parent_rpcs = nil
@@ -745,8 +729,8 @@ module Google
                   @batch_run_reports = ::Gapic::Config::Method.new batch_run_reports_config
                   batch_run_pivot_reports_config = parent_rpcs&.batch_run_pivot_reports if parent_rpcs&.respond_to? :batch_run_pivot_reports
                   @batch_run_pivot_reports = ::Gapic::Config::Method.new batch_run_pivot_reports_config
-                  get_metadata_config = parent_rpcs&.get_metadata if parent_rpcs&.respond_to? :get_metadata
-                  @get_metadata = ::Gapic::Config::Method.new get_metadata_config
+                  get_universal_metadata_config = parent_rpcs&.get_universal_metadata if parent_rpcs&.respond_to? :get_universal_metadata
+                  @get_universal_metadata = ::Gapic::Config::Method.new get_universal_metadata_config
 
                   yield self if block_given?
                 end

data/lib/google/analytics/data/v1alpha/analytics_data_api_pb.rb

@@ -7,14 +7,8 @@ require 'google/analytics/data/v1alpha/data_pb'
 require 'google/api/annotations_pb'
 require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
-require 'google/api/resource_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/analytics/data/v1alpha/analytics_data_api.proto", :syntax => :proto3) do
-    add_message "google.analytics.data.v1alpha.Metadata" do
-      optional :name, :string, 3
-      repeated :dimensions, :message, 1, "google.analytics.data.v1alpha.DimensionMetadata"
-      repeated :metrics, :message, 2, "google.analytics.data.v1alpha.MetricMetadata"
-    end
     add_message "google.analytics.data.v1alpha.RunReportRequest" do
       optional :entity, :message, 1, "google.analytics.data.v1alpha.Entity"
       repeated :dimensions, :message, 2, "google.analytics.data.v1alpha.Dimension"
@@ -38,6 +32,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :totals, :message, 8, "google.analytics.data.v1alpha.Row"
       repeated :maximums, :message, 9, "google.analytics.data.v1alpha.Row"
       repeated :minimums, :message, 10, "google.analytics.data.v1alpha.Row"
+      optional :row_count, :int32, 12
       optional :metadata, :message, 6, "google.analytics.data.v1alpha.ResponseMetaData"
       optional :property_quota, :message, 7, "google.analytics.data.v1alpha.PropertyQuota"
     end
@@ -77,8 +72,11 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.analytics.data.v1alpha.BatchRunPivotReportsResponse" do
       repeated :pivot_reports, :message, 1, "google.analytics.data.v1alpha.RunPivotReportResponse"
     end
-    add_message "google.analytics.data.v1alpha.GetMetadataRequest" do
-      optional :name, :string, 1
+    add_message "google.analytics.data.v1alpha.GetUniversalMetadataRequest" do
+    end
+    add_message "google.analytics.data.v1alpha.UniversalMetadata" do
+      repeated :dimensions, :message, 1, "google.analytics.data.v1alpha.DimensionMetadata"
+      repeated :metrics, :message, 2, "google.analytics.data.v1alpha.MetricMetadata"
     end
   end
 end
@@ -87,7 +85,6 @@ module Google
   module Analytics
     module Data
       module V1alpha
-        Metadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.analytics.data.v1alpha.Metadata").msgclass
         RunReportRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.analytics.data.v1alpha.RunReportRequest").msgclass
         RunReportResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.analytics.data.v1alpha.RunReportResponse").msgclass
         RunPivotReportRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.analytics.data.v1alpha.RunPivotReportRequest").msgclass
@@ -96,7 +93,8 @@ module Google
         BatchRunReportsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.analytics.data.v1alpha.BatchRunReportsResponse").msgclass
         BatchRunPivotReportsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.analytics.data.v1alpha.BatchRunPivotReportsRequest").msgclass
         BatchRunPivotReportsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.analytics.data.v1alpha.BatchRunPivotReportsResponse").msgclass
-        GetMetadataRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.analytics.data.v1alpha.GetMetadataRequest").msgclass
+        GetUniversalMetadataRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.analytics.data.v1alpha.GetUniversalMetadataRequest").msgclass
+        UniversalMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.analytics.data.v1alpha.UniversalMetadata").msgclass
       end
     end
   end

data/lib/google/analytics/data/v1alpha/analytics_data_api_services_pb.rb

@@ -56,7 +56,10 @@ module Google
             # Returns metadata for dimensions and metrics available in reporting methods.
             # Used to explore the dimensions and metrics. Dimensions and metrics will be
             # mostly added over time, but renames and deletions may occur.
-            rpc :GetMetadata, ::Google::Analytics::Data::V1alpha::GetMetadataRequest, ::Google::Analytics::Data::V1alpha::Metadata
+            #
+            # This method returns Universal Metadata. Universal Metadata are dimensions
+            # and metrics applicable to any property such as `country` and `totalUsers`.
+            rpc :GetUniversalMetadata, ::Google::Analytics::Data::V1alpha::GetUniversalMetadataRequest, ::Google::Analytics::Data::V1alpha::UniversalMetadata
           end
 
           Stub = Service.rpc_stub_class

data/lib/google/analytics/data/v1alpha/version.rb

@@ -21,7 +21,7 @@ module Google
   module Analytics
     module Data
       module V1alpha
-        VERSION = "0.1.0"
+        VERSION = "0.2.0"
       end
     end
   end

data/proto_docs/google/analytics/data/v1alpha/analytics_data_api.rb

@@ -21,21 +21,6 @@ module Google
   module Analytics
     module Data
       module V1alpha
-        # The dimensions and metrics currently accepted in reporting methods.
-        # @!attribute [rw] name
-        #   @return [::String]
-        #     Resource name of this metadata.
-        # @!attribute [rw] dimensions
-        #   @return [::Array<::Google::Analytics::Data::V1alpha::DimensionMetadata>]
-        #     The dimensions descriptions.
-        # @!attribute [rw] metrics
-        #   @return [::Array<::Google::Analytics::Data::V1alpha::MetricMetadata>]
-        #     The metric descriptions.
-        class Metadata
-          include ::Google::Protobuf::MessageExts
-          extend ::Google::Protobuf::MessageExts::ClassMethods
-        end
-
         # The request to generate a report.
         # @!attribute [rw] entity
         #   @return [::Google::Analytics::Data::V1alpha::Entity]
@@ -120,6 +105,12 @@ module Google
         # @!attribute [rw] minimums
         #   @return [::Array<::Google::Analytics::Data::V1alpha::Row>]
         #     If requested, the minimum values of metrics.
+        # @!attribute [rw] row_count
+        #   @return [::Integer]
+        #     The total number of rows in the query result, regardless of the number of
+        #     rows returned in the response. For example if a query returns 175 rows and
+        #     includes limit = 50 in the API request, the response will contain row_count
+        #     = 175 but only 50 rows.
         # @!attribute [rw] metadata
         #   @return [::Google::Analytics::Data::V1alpha::ResponseMetaData]
         #     Metadata for the report.
@@ -304,14 +295,20 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Request for dimension and metric metadata.
-        # @!attribute [rw] name
-        #   @return [::String]
-        #     Required. The name of the metadata to retrieve. Either has the form
-        #     'metadata' or 'properties/\\{property}/metadata'. This name field is
-        #     specified in the URL path and not URL parameters. Property is a numeric
-        #     Google Analytics App + Web Property Id.
-        class GetMetadataRequest
+        # Request for the universal dimension and metric metadata.
+        class GetUniversalMetadataRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The dimensions and metrics currently accepted in reporting methods.
+        # @!attribute [rw] dimensions
+        #   @return [::Array<::Google::Analytics::Data::V1alpha::DimensionMetadata>]
+        #     The dimensions descriptions.
+        # @!attribute [rw] metrics
+        #   @return [::Array<::Google::Analytics::Data::V1alpha::MetricMetadata>]
+        #     The metric descriptions.
+        class UniversalMetadata
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end

data/proto_docs/google/analytics/data/v1alpha/data.rb

@@ -556,7 +556,9 @@ module Google
         #     combinations.
         # @!attribute [rw] row_count
         #   @return [::Integer]
-        #     The cardinality of the pivot as if offset = 0 and limit = -1.
+        #     The cardinality of the pivot as if offset = 0 and limit = -1. The total
+        #     number of rows for this pivot's fields regardless of how the parameters
+        #     offset and limit are specified in the request.
         class PivotHeader
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-analytics-data-v1alpha
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-09-18 00:00:00.000000000 Z
+date: 2020-10-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -169,7 +169,6 @@ files:
 - lib/google/analytics/data/v1alpha/analytics_data.rb
 - lib/google/analytics/data/v1alpha/analytics_data/client.rb
 - lib/google/analytics/data/v1alpha/analytics_data/credentials.rb
-- lib/google/analytics/data/v1alpha/analytics_data/paths.rb
 - lib/google/analytics/data/v1alpha/analytics_data_api_pb.rb
 - lib/google/analytics/data/v1alpha/analytics_data_api_services_pb.rb
 - lib/google/analytics/data/v1alpha/data_pb.rb
@@ -178,7 +177,6 @@ files:
 - proto_docs/google/analytics/data/v1alpha/analytics_data_api.rb
 - proto_docs/google/analytics/data/v1alpha/data.rb
 - proto_docs/google/api/field_behavior.rb
-- proto_docs/google/api/resource.rb
 homepage: https://github.com/googleapis/google-cloud-ruby
 licenses:
 - Apache-2.0

data/lib/google/analytics/data/v1alpha/analytics_data/paths.rb

@@ -1,64 +0,0 @@
-# frozen_string_literal: true
-
-# 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
-#
-#     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 Analytics
-    module Data
-      module V1alpha
-        module AnalyticsData
-          # Path helper methods for the AnalyticsData API.
-          module Paths
-            ##
-            # Create a fully-qualified Metadata resource string.
-            #
-            # @overload metadata_path()
-            #   The resource will be in the following format:
-            #
-            #   `metadata`
-            #
-            # @overload metadata_path(property:)
-            #   The resource will be in the following format:
-            #
-            #   `properties/{property}/metadata`
-            #
-            #   @param property [String]
-            #
-            # @return [::String]
-            def metadata_path **args
-              resources = {
-                ""         => (proc do
-                  "metadata"
-                end),
-                "property" => (proc do |property:|
-                  "properties/#{property}/metadata"
-                end)
-              }
-
-              resource = resources[args.keys.sort.join(":")]
-              raise ::ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
-              resource.call(**args)
-            end
-
-            extend self
-          end
-        end
-      end
-    end
-  end
-end

data/proto_docs/google/api/resource.rb

@@ -1,283 +0,0 @@
-# frozen_string_literal: true
-
-# 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
-#
-#     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 Api
-    # A simple descriptor of a resource type.
-    #
-    # ResourceDescriptor annotates a resource message (either by means of a
-    # protobuf annotation or use in the service config), and associates the
-    # resource's schema, the resource type, and the pattern of the resource name.
-    #
-    # Example:
-    #
-    #     message Topic {
-    #       // Indicates this message defines a resource schema.
-    #       // Declares the resource type in the format of {service}/{kind}.
-    #       // For Kubernetes resources, the format is {api group}/{kind}.
-    #       option (google.api.resource) = {
-    #         type: "pubsub.googleapis.com/Topic"
-    #         name_descriptor: {
-    #           pattern: "projects/{project}/topics/{topic}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #           parent_name_extractor: "projects/{project}"
-    #         }
-    #       };
-    #     }
-    #
-    # 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}"
-    #
-    # Sometimes, resources have multiple patterns, typically because they can
-    # live under multiple parents.
-    #
-    # Example:
-    #
-    #     message LogEntry {
-    #       option (google.api.resource) = {
-    #         type: "logging.googleapis.com/LogEntry"
-    #         name_descriptor: {
-    #           pattern: "projects/{project}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #           parent_name_extractor: "projects/{project}"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "folders/{folder}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
-    #           parent_name_extractor: "folders/{folder}"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "organizations/{organization}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Organization"
-    #           parent_name_extractor: "organizations/{organization}"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "billingAccounts/{billing_account}/logs/{log}"
-    #           parent_type: "billing.googleapis.com/BillingAccount"
-    #           parent_name_extractor: "billingAccounts/{billing_account}"
-    #         }
-    #       };
-    #     }
-    #
-    # The ResourceDescriptor Yaml config will look like:
-    #
-    #     resources:
-    #     - type: 'logging.googleapis.com/LogEntry'
-    #       name_descriptor:
-    #         - pattern: "projects/{project}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #           parent_name_extractor: "projects/{project}"
-    #         - pattern: "folders/{folder}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
-    #           parent_name_extractor: "folders/{folder}"
-    #         - pattern: "organizations/{organization}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Organization"
-    #           parent_name_extractor: "organizations/{organization}"
-    #         - pattern: "billingAccounts/{billing_account}/logs/{log}"
-    #           parent_type: "billing.googleapis.com/BillingAccount"
-    #           parent_name_extractor: "billingAccounts/{billing_account}"
-    #
-    # For flexible resources, the resource name doesn't contain parent names, but
-    # the resource itself has parents for policy evaluation.
-    #
-    # Example:
-    #
-    #     message Shelf {
-    #       option (google.api.resource) = {
-    #         type: "library.googleapis.com/Shelf"
-    #         name_descriptor: {
-    #           pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
-    #         }
-    #       };
-    #     }
-    #
-    # The ResourceDescriptor Yaml config will look like:
-    #
-    #     resources:
-    #     - type: 'library.googleapis.com/Shelf'
-    #       name_descriptor:
-    #         - pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #         - pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
-    # @!attribute [rw] type
-    #   @return [::String]
-    #     The resource type. It must be in the format of
-    #     \\{service_name}/\\{resource_type_kind}. The `resource_type_kind` must be
-    #     singular and must not include version numbers.
-    #
-    #     Example: `storage.googleapis.com/Bucket`
-    #
-    #     The value of the resource_type_kind must follow the regular expression
-    #     /[A-Za-z][a-zA-Z0-9]+/. It should start with an upper case character and
-    #     should use PascalCase (UpperCamelCase). The maximum number of
-    #     characters allowed for the `resource_type_kind` is 100.
-    # @!attribute [rw] pattern
-    #   @return [::Array<::String>]
-    #     Optional. The relative resource name pattern associated with this resource
-    #     type. The DNS prefix of the full resource name shouldn't be specified here.
-    #
-    #     The path pattern must follow the syntax, which aligns with HTTP binding
-    #     syntax:
-    #
-    #         Template = Segment { "/" Segment } ;
-    #         Segment = LITERAL | Variable ;
-    #         Variable = "{" LITERAL "}" ;
-    #
-    #     Examples:
-    #
-    #         - "projects/\\{project}/topics/\\{topic}"
-    #         - "projects/\\{project}/knowledgeBases/\\{knowledge_base}"
-    #
-    #     The components in braces correspond to the IDs for each resource in the
-    #     hierarchy. It is expected that, if multiple patterns are provided,
-    #     the same component name (e.g. "project") refers to IDs of the same
-    #     type of resource.
-    # @!attribute [rw] name_field
-    #   @return [::String]
-    #     Optional. The field on the resource that designates the resource name
-    #     field. If omitted, this is assumed to be "name".
-    # @!attribute [rw] history
-    #   @return [::Google::Api::ResourceDescriptor::History]
-    #     Optional. The historical or future-looking state of the resource pattern.
-    #
-    #     Example:
-    #
-    #         // The InspectTemplate message originally only supported resource
-    #         // names with organization, and project was added later.
-    #         message InspectTemplate {
-    #           option (google.api.resource) = {
-    #             type: "dlp.googleapis.com/InspectTemplate"
-    #             pattern:
-    #             "organizations/{organization}/inspectTemplates/{inspect_template}"
-    #             pattern: "projects/{project}/inspectTemplates/{inspect_template}"
-    #             history: ORIGINALLY_SINGLE_PATTERN
-    #           };
-    #         }
-    # @!attribute [rw] plural
-    #   @return [::String]
-    #     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
-
-      # A description of the historical or future-looking state of the
-      # resource pattern.
-      module History
-        # The "unset" value.
-        HISTORY_UNSPECIFIED = 0
-
-        # The resource originally had one pattern and launched as such, and
-        # additional patterns were added later.
-        ORIGINALLY_SINGLE_PATTERN = 1
-
-        # The resource has one pattern, but the API owner expects to add more
-        # later. (This is the inverse of ORIGINALLY_SINGLE_PATTERN, and prevents
-        # 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
-    # an API resource.
-    # @!attribute [rw] type
-    #   @return [::String]
-    #     The resource type that the annotated field references.
-    #
-    #     Example:
-    #
-    #         message Subscription {
-    #           string topic = 2 [(google.api.resource_reference) = {
-    #             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
-    #     references. This is useful for annotating the `parent` field that
-    #     doesn't have a fixed resource type.
-    #
-    #     Example:
-    #
-    #         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
-    end
-  end
-end