google-cloud-service_usage-v1 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '018f6980a30a2b6eab63c409408de4c22f66ba9bbf31517a28457207b637e7b6'
-  data.tar.gz: e58bf640dfb360d9c0a2222871f38e65889d026b82455683319f51e541850e30
+  metadata.gz: 52dc04b0b74528282d0c51a85e641cc334bd4d14bab456722e7c2e4aee168529
+  data.tar.gz: b76b5a4e3cfad48e4f002e1484846d89e0a66daf0a9d540cb0976ac72dfb0580
 SHA512:
-  metadata.gz: eca80a4188fbcba9b3ec0ebe00d035c1c191a8f1cae04b22bbc17288112c59962f7a6343db27f884c01ac2e5a239d100a5af8e8cbdbedc3231afeb6a897d6ec9
-  data.tar.gz: f9792857c43f3a28340aba99d4ad3fd2b66954289a5c62ab278bb0d7b62bee2073a231066980fc2d5a8e16b96b45210d48f95274993dd1ab0c3ecbcb6b3def21
+  metadata.gz: 3b464eb2fdfc9c9c528900d52535e43e2f273165a511ed561d504fa207738449861a3d2a1e309e70779e8559c40b7201596ee0eb63fa9ab8febc0a648b22a00c
+  data.tar.gz: 7baebd35c2f1dc8f0db653446c6725c564b5a73d02e5d87fe6fdb631527078d41a68d253c4ec0b1a4565858c64d8513ef81411631f4a70724435c38443b6323a

data/AUTHENTICATION.md

@@ -114,7 +114,7 @@ credentials are discovered.
 To configure your system for this, simply:
 
 1. [Download and install the Cloud SDK](https://cloud.google.com/sdk)
-2. Authenticate using OAuth 2.0 `$ gcloud auth login`
+2. Authenticate using OAuth 2.0 `$ gcloud auth application-default login`
 3. Write code as if already authenticated.
 
 **NOTE:** This is _not_ recommended for running in production. The Cloud SDK

data/README.md

@@ -1,6 +1,6 @@
 # Ruby Client for the Service Usage V1 API
 
-API Client library for the Service Usage V1 API
+Enables services that service consumers want to use on Google Cloud Platform, lists the available or enabled services, or disables services that service consumers no longer use.
 
 Service Usage is an infrastructure service of Google Cloud that lets you list and manage other APIs and services in your Cloud projects. You can list and manage Google Cloud services and their APIs, as well as services created using Cloud Endpoints.
 
@@ -46,7 +46,7 @@ for general usage information.
 ## Enabling Logging
 
 To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
-The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib/libdoc/logger/rdoc/Logger.html) as shown below,
+The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
 or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
 that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
 and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.

data/lib/google/api/serviceusage/v1/resources_pb.rb

@@ -11,7 +11,6 @@ require 'google/api/monitoring_pb'
 require 'google/api/quota_pb'
 require 'google/api/usage_pb'
 require 'google/protobuf/api_pb'
-require 'google/api/annotations_pb'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/api/serviceusage/v1/resources.proto", :syntax => :proto3) do

data/lib/google/cloud/service_usage/v1/service_usage/client.rb

@@ -212,14 +212,14 @@ module Google
             #   # Call the enable_service method.
             #   result = client.enable_service request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def enable_service request, options = nil
@@ -325,14 +325,14 @@ module Google
             #   # Call the disable_service method.
             #   result = client.disable_service request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def disable_service request, options = nil
@@ -532,13 +532,11 @@ module Google
             #   # Call the list_services method.
             #   result = client.list_services request
             #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can
-            #   # iterate over all elements by calling #each, and the enumerable
-            #   # will lazily make API calls to fetch subsequent pages. Other
-            #   # methods are also available for managing paging directly.
-            #   result.each do |response|
+            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+            #   # over elements, and API calls will be issued to fetch pages as needed.
+            #   result.each do |item|
             #     # Each element is of type ::Google::Cloud::ServiceUsage::V1::Service.
-            #     p response
+            #     p item
             #   end
             #
             def list_services request, options = nil
@@ -643,14 +641,14 @@ module Google
             #   # Call the batch_enable_services method.
             #   result = client.batch_enable_services request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def batch_enable_services request, options = nil

data/lib/google/cloud/service_usage/v1/service_usage/operations.rb

@@ -158,13 +158,11 @@ module Google
             #   # Call the list_operations method.
             #   result = client.list_operations request
             #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can
-            #   # iterate over all elements by calling #each, and the enumerable
-            #   # will lazily make API calls to fetch subsequent pages. Other
-            #   # methods are also available for managing paging directly.
-            #   result.each do |response|
+            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+            #   # over elements, and API calls will be issued to fetch pages as needed.
+            #   result.each do |item|
             #     # Each element is of type ::Google::Longrunning::Operation.
-            #     p response
+            #     p item
             #   end
             #
             def list_operations request, options = nil
@@ -184,14 +182,6 @@ module Google
                 gapic_version: ::Google::Cloud::ServiceUsage::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {}
-              if request.name
-                header_params["name"] = request.name
-              end
-
-              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.list_operations.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.list_operations.retry_policy
@@ -253,14 +243,14 @@ module Google
             #   # Call the get_operation method.
             #   result = client.get_operation request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def get_operation request, options = nil
@@ -540,14 +530,14 @@ module Google
             #   # Call the wait_operation method.
             #   result = client.wait_operation request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def wait_operation request, options = nil

data/lib/google/cloud/service_usage/v1/service_usage.rb

@@ -37,7 +37,7 @@ module Google
         #
         # See [Service Usage API](https://cloud.google.com/service-usage/docs/overview)
         #
-        # To load this service and instantiate a client:
+        # @example Load this service and instantiate a gRPC client
         #
         #     require "google/cloud/service_usage/v1/service_usage"
         #     client = ::Google::Cloud::ServiceUsage::V1::ServiceUsage::Client.new

data/lib/google/cloud/service_usage/v1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module ServiceUsage
       module V1
-        VERSION = "0.2.0"
+        VERSION = "0.2.1"
       end
     end
   end

data/lib/google/cloud/service_usage/v1.rb

@@ -23,9 +23,9 @@ module Google
   module Cloud
     module ServiceUsage
       ##
-      # To load this package, including all its services, and instantiate a client:
+      # API client module.
       #
-      # @example
+      # @example Load this package, including all its services, and instantiate a gRPC client
       #
       #     require "google/cloud/service_usage/v1"
       #     client = ::Google::Cloud::ServiceUsage::V1::ServiceUsage::Client.new

data/proto_docs/google/api/auth.rb

@@ -86,6 +86,9 @@ module Google
     # @!attribute [rw] query
     #   @return [::String]
     #     Specifies URL query parameter name to extract JWT token.
+    # @!attribute [rw] cookie
+    #   @return [::String]
+    #     Specifies cookie name to extract JWT token.
     # @!attribute [rw] value_prefix
     #   @return [::String]
     #     The value prefix. The value format is "value_prefix\\{token}"
@@ -157,11 +160,12 @@ module Google
     #     Implement authorizationUrl of securityDefinitions in OpenAPI spec.
     # @!attribute [rw] jwt_locations
     #   @return [::Array<::Google::Api::JwtLocation>]
-    #     Defines the locations to extract the JWT.
+    #     Defines the locations to extract the JWT.  For now it is only used by the
+    #     Cloud Endpoints to store the OpenAPI extension [x-google-jwt-locations]
+    #     (https://cloud.google.com/endpoints/docs/openapi/openapi-extensions#x-google-jwt-locations)
     #
-    #     JWT locations can be either from HTTP headers or URL query parameters.
-    #     The rule is that the first match wins. The checking order is: checking
-    #     all headers first, then URL query parameters.
+    #     JWT locations can be one of HTTP headers, URL query parameters or
+    #     cookies. The rule is that the first match wins.
     #
     #     If not specified,  default to use following 3 locations:
     #        1) Authorization: Bearer

data/proto_docs/google/api/client.rb

@@ -0,0 +1,318 @@
+# frozen_string_literal: true
+
+# Copyright 2022 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# 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
+    # Required information for every language.
+    # @!attribute [rw] reference_docs_uri
+    #   @return [::String]
+    #     Link to automatically generated reference documentation.  Example:
+    #     https://cloud.google.com/nodejs/docs/reference/asset/latest
+    # @!attribute [rw] destinations
+    #   @return [::Array<::Google::Api::ClientLibraryDestination>]
+    #     The destination where API teams want this client library to be published.
+    class CommonLanguageSettings
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # Details about how and where to publish client libraries.
+    # @!attribute [rw] version
+    #   @return [::String]
+    #     Version of the API to apply these settings to.
+    # @!attribute [rw] launch_stage
+    #   @return [::Google::Api::LaunchStage]
+    #     Launch stage of this version of the API.
+    # @!attribute [rw] rest_numeric_enums
+    #   @return [::Boolean]
+    #     When using transport=rest, the client request will encode enums as
+    #     numbers rather than strings.
+    # @!attribute [rw] java_settings
+    #   @return [::Google::Api::JavaSettings]
+    #     Settings for legacy Java features, supported in the Service YAML.
+    # @!attribute [rw] cpp_settings
+    #   @return [::Google::Api::CppSettings]
+    #     Settings for C++ client libraries.
+    # @!attribute [rw] php_settings
+    #   @return [::Google::Api::PhpSettings]
+    #     Settings for PHP client libraries.
+    # @!attribute [rw] python_settings
+    #   @return [::Google::Api::PythonSettings]
+    #     Settings for Python client libraries.
+    # @!attribute [rw] node_settings
+    #   @return [::Google::Api::NodeSettings]
+    #     Settings for Node client libraries.
+    # @!attribute [rw] dotnet_settings
+    #   @return [::Google::Api::DotnetSettings]
+    #     Settings for .NET client libraries.
+    # @!attribute [rw] ruby_settings
+    #   @return [::Google::Api::RubySettings]
+    #     Settings for Ruby client libraries.
+    # @!attribute [rw] go_settings
+    #   @return [::Google::Api::GoSettings]
+    #     Settings for Go client libraries.
+    class ClientLibrarySettings
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # This message configures the settings for publishing [Google Cloud Client
+    # libraries](https://cloud.google.com/apis/docs/cloud-client-libraries)
+    # generated from the service config.
+    # @!attribute [rw] method_settings
+    #   @return [::Array<::Google::Api::MethodSettings>]
+    #     A list of API method settings, e.g. the behavior for methods that use the
+    #     long-running operation pattern.
+    # @!attribute [rw] new_issue_uri
+    #   @return [::String]
+    #     Link to a place that API users can report issues.  Example:
+    #     https://issuetracker.google.com/issues/new?component=190865&template=1161103
+    # @!attribute [rw] documentation_uri
+    #   @return [::String]
+    #     Link to product home page.  Example:
+    #     https://cloud.google.com/asset-inventory/docs/overview
+    # @!attribute [rw] api_short_name
+    #   @return [::String]
+    #     Used as a tracking tag when collecting data about the APIs developer
+    #     relations artifacts like docs, packages delivered to package managers,
+    #     etc.  Example: "speech".
+    # @!attribute [rw] github_label
+    #   @return [::String]
+    #     GitHub label to apply to issues and pull requests opened for this API.
+    # @!attribute [rw] codeowner_github_teams
+    #   @return [::Array<::String>]
+    #     GitHub teams to be added to CODEOWNERS in the directory in GitHub
+    #     containing source code for the client libraries for this API.
+    # @!attribute [rw] doc_tag_prefix
+    #   @return [::String]
+    #     A prefix used in sample code when demarking regions to be included in
+    #     documentation.
+    # @!attribute [rw] organization
+    #   @return [::Google::Api::ClientLibraryOrganization]
+    #     For whom the client library is being published.
+    # @!attribute [rw] library_settings
+    #   @return [::Array<::Google::Api::ClientLibrarySettings>]
+    #     Client library settings.  If the same version string appears multiple
+    #     times in this list, then the last one wins.  Settings from earlier
+    #     settings with the same version string are discarded.
+    class Publishing
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # Settings for Java client libraries.
+    # @!attribute [rw] library_package
+    #   @return [::String]
+    #     The package name to use in Java. Clobbers the java_package option
+    #     set in the protobuf. This should be used **only** by APIs
+    #     who have already set the language_settings.java.package_name" field
+    #     in gapic.yaml. API teams should use the protobuf java_package option
+    #     where possible.
+    #
+    #     Example of a YAML configuration::
+    #
+    #      publishing:
+    #        java_settings:
+    #          library_package: com.google.cloud.pubsub.v1
+    # @!attribute [rw] service_class_names
+    #   @return [::Google::Protobuf::Map{::String => ::String}]
+    #     Configure the Java class name to use instead of the service's for its
+    #     corresponding generated GAPIC client. Keys are fully-qualified
+    #     service names as they appear in the protobuf (including the full
+    #     the language_settings.java.interface_names" field in gapic.yaml. API
+    #     teams should otherwise use the service name as it appears in the
+    #     protobuf.
+    #
+    #     Example of a YAML configuration::
+    #
+    #      publishing:
+    #        java_settings:
+    #          service_class_names:
+    #            - google.pubsub.v1.Publisher: TopicAdmin
+    #            - google.pubsub.v1.Subscriber: SubscriptionAdmin
+    # @!attribute [rw] common
+    #   @return [::Google::Api::CommonLanguageSettings]
+    #     Some settings.
+    class JavaSettings
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+
+      # @!attribute [rw] key
+      #   @return [::String]
+      # @!attribute [rw] value
+      #   @return [::String]
+      class ServiceClassNamesEntry
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
+    end
+
+    # Settings for C++ client libraries.
+    # @!attribute [rw] common
+    #   @return [::Google::Api::CommonLanguageSettings]
+    #     Some settings.
+    class CppSettings
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # Settings for Php client libraries.
+    # @!attribute [rw] common
+    #   @return [::Google::Api::CommonLanguageSettings]
+    #     Some settings.
+    class PhpSettings
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # Settings for Python client libraries.
+    # @!attribute [rw] common
+    #   @return [::Google::Api::CommonLanguageSettings]
+    #     Some settings.
+    class PythonSettings
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # Settings for Node client libraries.
+    # @!attribute [rw] common
+    #   @return [::Google::Api::CommonLanguageSettings]
+    #     Some settings.
+    class NodeSettings
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # Settings for Dotnet client libraries.
+    # @!attribute [rw] common
+    #   @return [::Google::Api::CommonLanguageSettings]
+    #     Some settings.
+    class DotnetSettings
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # Settings for Ruby client libraries.
+    # @!attribute [rw] common
+    #   @return [::Google::Api::CommonLanguageSettings]
+    #     Some settings.
+    class RubySettings
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # Settings for Go client libraries.
+    # @!attribute [rw] common
+    #   @return [::Google::Api::CommonLanguageSettings]
+    #     Some settings.
+    class GoSettings
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # Describes the generator configuration for a method.
+    # @!attribute [rw] selector
+    #   @return [::String]
+    #     The fully qualified name of the method, for which the options below apply.
+    #     This is used to find the method to apply the options.
+    # @!attribute [rw] long_running
+    #   @return [::Google::Api::MethodSettings::LongRunning]
+    #     Describes settings to use for long-running operations when generating
+    #     API methods for RPCs. Complements RPCs that use the annotations in
+    #     google/longrunning/operations.proto.
+    #
+    #     Example of a YAML configuration::
+    #
+    #      publishing:
+    #        method_behavior:
+    #          - selector: CreateAdDomain
+    #            long_running:
+    #              initial_poll_delay:
+    #                seconds: 60 # 1 minute
+    #              poll_delay_multiplier: 1.5
+    #              max_poll_delay:
+    #                seconds: 360 # 6 minutes
+    #              total_poll_timeout:
+    #                 seconds: 54000 # 90 minutes
+    class MethodSettings
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+
+      # Describes settings to use when generating API methods that use the
+      # long-running operation pattern.
+      # All default values below are from those used in the client library
+      # generators (e.g.
+      # [Java](https://github.com/googleapis/gapic-generator-java/blob/04c2faa191a9b5a10b92392fe8482279c4404803/src/main/java/com/google/api/generator/gapic/composer/common/RetrySettingsComposer.java)).
+      # @!attribute [rw] initial_poll_delay
+      #   @return [::Google::Protobuf::Duration]
+      #     Initial delay after which the first poll request will be made.
+      #     Default value: 5 seconds.
+      # @!attribute [rw] poll_delay_multiplier
+      #   @return [::Float]
+      #     Multiplier to gradually increase delay between subsequent polls until it
+      #     reaches max_poll_delay.
+      #     Default value: 1.5.
+      # @!attribute [rw] max_poll_delay
+      #   @return [::Google::Protobuf::Duration]
+      #     Maximum time between two subsequent poll requests.
+      #     Default value: 45 seconds.
+      # @!attribute [rw] total_poll_timeout
+      #   @return [::Google::Protobuf::Duration]
+      #     Total polling timeout.
+      #     Default value: 5 minutes.
+      class LongRunning
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
+    end
+
+    # The organization for which the client libraries are being published.
+    # Affects the url where generated docs are published, etc.
+    module ClientLibraryOrganization
+      # Not useful.
+      CLIENT_LIBRARY_ORGANIZATION_UNSPECIFIED = 0
+
+      # Google Cloud Platform Org.
+      CLOUD = 1
+
+      # Ads (Advertising) Org.
+      ADS = 2
+
+      # Photos Org.
+      PHOTOS = 3
+
+      # Street View Org.
+      STREET_VIEW = 4
+    end
+
+    # To where should client libraries be published?
+    module ClientLibraryDestination
+      # Client libraries will neither be generated nor published to package
+      # managers.
+      CLIENT_LIBRARY_DESTINATION_UNSPECIFIED = 0
+
+      # Generate the client library in a repo under github.com/googleapis,
+      # but don't publish it to package managers.
+      GITHUB = 10
+
+      # Publish the library to package managers like nuget.org and npmjs.com.
+      PACKAGE_MANAGER = 20
+    end
+  end
+end

data/proto_docs/google/api/documentation.rb

@@ -76,8 +76,10 @@ module Google
     # and is documented together with service config validation.
     # @!attribute [rw] summary
     #   @return [::String]
-    #     A short summary of what the service does. Can only be provided by
-    #     plain text.
+    #     A short description of what the service does. The summary must be plain
+    #     text. It becomes the overview of the service displayed in Google Cloud
+    #     Console.
+    #     NOTE: This field is equivalent to the standard field `description`.
     # @!attribute [rw] pages
     #   @return [::Array<::Google::Api::Page>]
     #     The top level pages for the documentation set.
@@ -118,15 +120,18 @@ module Google
     # A documentation rule provides information about individual API elements.
     # @!attribute [rw] selector
     #   @return [::String]
-    #     The selector is a comma-separated list of patterns. Each pattern is a
-    #     qualified name of the element which may end in "*", indicating a wildcard.
-    #     Wildcards are only allowed at the end and for a whole component of the
-    #     qualified name, i.e. "foo.*" is ok, but not "foo.b*" or "foo.*.bar". A
-    #     wildcard will match one or more components. To specify a default for all
-    #     applicable elements, the whole pattern "*" is used.
+    #     The selector is a comma-separated list of patterns for any element such as
+    #     a method, a field, an enum value. Each pattern is a qualified name of the
+    #     element which may end in "*", indicating a wildcard. Wildcards are only
+    #     allowed at the end and for a whole component of the qualified name,
+    #     i.e. "foo.*" is ok, but not "foo.b*" or "foo.*.bar". A wildcard will match
+    #     one or more components. To specify a default for all applicable elements,
+    #     the whole pattern "*" is used.
     # @!attribute [rw] description
     #   @return [::String]
-    #     Description of the selected API(s).
+    #     Description of the selected proto element (e.g. a message, a method, a
+    #     'service' definition, or a field). Defaults to leading & trailing comments
+    #     taken from the proto source definition of the proto element.
     # @!attribute [rw] deprecation_description
     #   @return [::String]
     #     Deprecation description of the selected element(s). It can be provided if
@@ -157,7 +162,8 @@ module Google
     # @!attribute [rw] content
     #   @return [::String]
     #     The Markdown content of the page. You can use <code>&#40;== include \\{path}
-    #     ==&#41;</code> to include content from a Markdown file.
+    #     ==&#41;</code> to include content from a Markdown file. The content can be
+    #     used to produce the documentation page such as HTML format page.
     # @!attribute [rw] subpages
     #   @return [::Array<::Google::Api::Page>]
     #     Subpages of this page. The order of subpages specified here will be

data/proto_docs/google/api/endpoint.rb

@@ -19,21 +19,26 @@
 
 module Google
   module Api
-    # `Endpoint` describes a network endpoint of a service that serves a set of
+    # `Endpoint` describes a network address of a service that serves a set of
     # APIs. It is commonly known as a service endpoint. A service may expose
     # any number of service endpoints, and all service endpoints share the same
     # service definition, such as quota limits and monitoring metrics.
     #
-    # Example service configuration:
+    # Example:
     #
+    #     type: google.api.Service
     #     name: library-example.googleapis.com
     #     endpoints:
-    #       # Below entry makes 'google.example.library.v1.Library'
-    #       # API be served from endpoint address library-example.googleapis.com.
-    #       # It also allows HTTP OPTIONS calls to be passed to the backend, for
-    #       # it to decide whether the subsequent cross-origin request is
-    #       # allowed to proceed.
+    #       # Declares network address `https://library-example.googleapis.com`
+    #       # for service `library-example.googleapis.com`. The `https` scheme
+    #       # is implicit for all service endpoints. Other schemes may be
+    #       # supported in the future.
     #     - name: library-example.googleapis.com
+    #       allow_cors: false
+    #     - name: content-staging-library-example.googleapis.com
+    #       # Allows HTTP OPTIONS calls to be passed to the API frontend, for it
+    #       # to decide whether the subsequent cross-origin request is allowed
+    #       # to proceed.
     #       allow_cors: true
     # @!attribute [rw] name
     #   @return [::String]
@@ -43,8 +48,8 @@ module Google
     #     Unimplemented. Dot not use.
     #
     #     DEPRECATED: This field is no longer supported. Instead of using aliases,
-    #     please specify multiple {::Google::Api::Endpoint google.api.Endpoint} for each of the intended
-    #     aliases.
+    #     please specify multiple {::Google::Api::Endpoint google.api.Endpoint} for each
+    #     of the intended aliases.
     #
     #     Additional names that this endpoint will be hosted on.
     # @!attribute [rw] target

data/proto_docs/google/api/launch_stage.rb

@@ -20,7 +20,7 @@
 module Google
   module Api
     # The launch stage as defined by [Google Cloud Platform
-    # Launch Stages](http://cloud.google.com/terms/launch-stages).
+    # Launch Stages](https://cloud.google.com/terms/launch-stages).
     module LaunchStage
       # Do not use this default value.
       LAUNCH_STAGE_UNSPECIFIED = 0
@@ -42,7 +42,7 @@ module Google
       # for widespread use. By Alpha, all significant design issues are resolved
       # and we are in the process of verifying functionality. Alpha customers
       # need to apply for access, agree to applicable terms, and have their
-      # projects allowlisted. Alpha releases don’t have to be feature complete,
+      # projects allowlisted. Alpha releases don't have to be feature complete,
       # no SLAs are provided, and there are no technical support obligations, but
       # they will be far enough along that customers can actually use them in
       # test environments or for limited-use tests -- just like they would in
@@ -61,7 +61,7 @@ module Google
       GA = 4
 
       # Deprecated features are scheduled to be shut down and removed. For more
-      # information, see the “Deprecation Policy” section of our [Terms of
+      # information, see the "Deprecation Policy" section of our [Terms of
       # Service](https://cloud.google.com/terms/)
       # and the [Google Cloud Platform Subject to the Deprecation
       # Policy](https://cloud.google.com/terms/deprecation) documentation.

data/proto_docs/google/api/monitored_resource.rb

@@ -40,6 +40,10 @@ module Google
     #   @return [::String]
     #     Required. The monitored resource type. For example, the type
     #     `"cloudsql_database"` represents databases in Google Cloud SQL.
+    #      For a list of types, see [Monitoring resource
+    #      types](https://cloud.google.com/monitoring/api/resources)
+    #     and [Logging resource
+    #     types](https://cloud.google.com/logging/docs/api/v2/resource-list).
     # @!attribute [rw] display_name
     #   @return [::String]
     #     Optional. A concise name for the monitored resource type that might be
@@ -71,16 +75,19 @@ module Google
     # its attributes according to the schema. For example, a particular Compute
     # Engine VM instance could be represented by the following object, because the
     # {::Google::Api::MonitoredResourceDescriptor MonitoredResourceDescriptor} for `"gce_instance"` has labels
-    # `"instance_id"` and `"zone"`:
+    # `"project_id"`, `"instance_id"` and `"zone"`:
     #
     #     { "type": "gce_instance",
-    #       "labels": { "instance_id": "12345678901234",
+    #       "labels": { "project_id": "my-project",
+    #                   "instance_id": "12345678901234",
     #                   "zone": "us-central1-a" }}
     # @!attribute [rw] type
     #   @return [::String]
     #     Required. The monitored resource type. This field must match
     #     the `type` field of a {::Google::Api::MonitoredResourceDescriptor MonitoredResourceDescriptor} object. For
     #     example, the type of a Compute Engine VM instance is `gce_instance`.
+    #     Some descriptors include the service name in the type; for example,
+    #     the type of a Datastream stream is `datastream.googleapis.com/Stream`.
     # @!attribute [rw] labels
     #   @return [::Google::Protobuf::Map{::String => ::String}]
     #     Required. Values for all of the labels listed in the associated monitored

data/proto_docs/google/api/quota.rb

@@ -41,10 +41,10 @@ module Google
     #          STANDARD: 10000
     #
     #
-    #      # The metric rules bind all methods to the read_calls metric,
-    #      # except for the UpdateBook and DeleteBook methods. These two methods
-    #      # are mapped to the write_calls metric, with the UpdateBook method
-    #      # consuming at twice rate as the DeleteBook method.
+    #      (The metric rules bind all methods to the read_calls metric,
+    #       except for the UpdateBook and DeleteBook methods. These two methods
+    #       are mapped to the write_calls metric, with the UpdateBook method
+    #       consuming at twice rate as the DeleteBook method.)
     #      metric_rules:
     #      - selector: "*"
     #        metric_costs:
@@ -70,10 +70,10 @@ module Google
     #        value_type: INT64
     # @!attribute [rw] limits
     #   @return [::Array<::Google::Api::QuotaLimit>]
-    #     List of `QuotaLimit` definitions for the service.
+    #     List of QuotaLimit definitions for the service.
     # @!attribute [rw] metric_rules
     #   @return [::Array<::Google::Api::MetricRule>]
-    #     List of `MetricRule` definitions, each one mapping a selected method to one
+    #     List of MetricRule definitions, each one mapping a selected method to one
     #     or more metrics.
     class Quota
       include ::Google::Protobuf::MessageExts

data/proto_docs/google/protobuf/empty.rb

@@ -26,8 +26,6 @@ module Google
     #     service Foo {
     #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
     #     }
-    #
-    # The JSON representation for `Empty` is empty JSON object `{}`.
     class Empty
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/rpc/status.rb

@@ -28,12 +28,14 @@ module Google
     # [API Design Guide](https://cloud.google.com/apis/design/errors).
     # @!attribute [rw] code
     #   @return [::Integer]
-    #     The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
+    #     The status code, which should be an enum value of
+    #     [google.rpc.Code][google.rpc.Code].
     # @!attribute [rw] message
     #   @return [::String]
     #     A developer-facing error message, which should be in English. Any
     #     user-facing error message should be localized and sent in the
-    #     {::Google::Rpc::Status#details google.rpc.Status.details} field, or localized by the client.
+    #     {::Google::Rpc::Status#details google.rpc.Status.details} field, or localized
+    #     by the client.
     # @!attribute [rw] details
     #   @return [::Array<::Google::Protobuf::Any>]
     #     A list of messages that carry the error details.  There is a common set of

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-service_usage-v1
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-07-08 00:00:00.000000000 Z
+date: 2023-03-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.10'
+        version: 0.18.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.10'
+        version: 0.18.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -50,14 +50,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.26.1
+        version: 1.26.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.26.1
+        version: 1.26.3
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -183,6 +183,7 @@ files:
 - lib/google/cloud/service_usage/v1/version.rb
 - proto_docs/README.md
 - proto_docs/google/api/auth.rb
+- proto_docs/google/api/client.rb
 - proto_docs/google/api/documentation.rb
 - proto_docs/google/api/endpoint.rb
 - proto_docs/google/api/label.rb
@@ -222,8 +223,10 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.14
+rubygems_version: 3.4.2
 signing_key: 
 specification_version: 4
-summary: API Client library for the Service Usage V1 API
+summary: Enables services that service consumers want to use on Google Cloud Platform,
+  lists the available or enabled services, or disables services that service consumers
+  no longer use.
 test_files: []