google-cloud-gke_connect-gateway-v1beta1 0.7.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f01218fa494d18af7b7a63f36d9fbf41055f6d036d217b078ab68112f420581c
-  data.tar.gz: ed395e61b6609b237bcdd920217509a39f95dda894ef129a242164e18661d3a8
+  metadata.gz: 61fd219044484c18460e697186a9fb3a0332e92db6eaa128725802b01affde55
+  data.tar.gz: de45a787fb82f4538ce9f083b3a7d5b3abf4ecb07c70bbd6337f5fc9e412c7df
 SHA512:
-  metadata.gz: b8d55438b833bcee1d0461e0b1e25fc8d3c442d80593a0f527355972da70ef9fce543535786b29b0ff8348273d61035eb7836c096587e008d3eb08765f9e50f9
-  data.tar.gz: 4d9db949b0a220b1754ae744ad56dad7ba1708083e7d40a699f454f948bbdfb2b446ad2c095156feea9e6ff1decc01988c2232063844567ac63155f14eabe65d
+  metadata.gz: 466f35b8100a235ed69fe2ffaaaf28c162cf153c77ab6ae9d60f10229c723eb7bd162cf2e5f024d4fc243e5de66f34b86f33276ea3510bed17a8647586f22cf6
+  data.tar.gz: fd83abd2708cf52c9f46eab64b4932432258e29728b97d3cd14a598b48214e329cdc17170a794d44eb189f08c6881109cc7b57b6cd602ea77a192bc180561aa4

data/AUTHENTICATION.md

@@ -56,7 +56,7 @@ To configure a credentials file for an individual client initialization:
 ```ruby
 require "google/cloud/gke_connect/gateway/v1beta1"
 
-client = ::Google::Cloud::GkeConnect::Gateway::V1beta1::GatewayControl::Client.new do |config|
+client = ::Google::Cloud::GkeConnect::Gateway::V1beta1::GatewayControl::Rest::Client.new do |config|
   config.credentials = "path/to/credentialfile.json"
 end
 ```
@@ -66,11 +66,11 @@ To configure a credentials file globally for all clients:
 ```ruby
 require "google/cloud/gke_connect/gateway/v1beta1"
 
-::Google::Cloud::GkeConnect::Gateway::V1beta1::GatewayControl::Client.configure do |config|
+::Google::Cloud::GkeConnect::Gateway::V1beta1::GatewayControl::Rest::Client.configure do |config|
   config.credentials = "path/to/credentialfile.json"
 end
 
-client = ::Google::Cloud::GkeConnect::Gateway::V1beta1::GatewayControl::Client.new
+client = ::Google::Cloud::GkeConnect::Gateway::V1beta1::GatewayControl::Rest::Client.new
 ```
 
 ### Environment Variables
@@ -100,7 +100,7 @@ require "google/cloud/gke_connect/gateway/v1beta1"
 
 ENV["GOOGLE_APPLICATION_CREDENTIALS"] = "path/to/credentialfile.json"
 
-client = ::Google::Cloud::GkeConnect::Gateway::V1beta1::GatewayControl::Client.new
+client = ::Google::Cloud::GkeConnect::Gateway::V1beta1::GatewayControl::Rest::Client.new
 ```
 
 ### Local ADC file

data/README.md

@@ -32,7 +32,7 @@ In order to use this library, you first need to go through the following steps:
 ```ruby
 require "google/cloud/gke_connect/gateway/v1beta1"
 
-client = ::Google::Cloud::GkeConnect::Gateway::V1beta1::GatewayControl::Client.new
+client = ::Google::Cloud::GkeConnect::Gateway::V1beta1::GatewayControl::Rest::Client.new
 request = ::Google::Cloud::GkeConnect::Gateway::V1beta1::GenerateCredentialsRequest.new # (request fields as keyword arguments...)
 response = client.generate_credentials request
 ```
@@ -43,33 +43,43 @@ for class and method documentation.
 See also the [Product Documentation](https://cloud.google.com/anthos/multicluster-management/gateway/)
 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/current/stdlibs/logger/Logger.html) as shown below,
-or a [`Google::Cloud::Logging::Logger`](https://cloud.google.com/ruby/docs/reference/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.
-
-Configuring a Ruby stdlib logger:
+## Debug Logging
+
+This library comes with opt-in Debug Logging that can help you troubleshoot
+your application's integration with the API. When logging is activated, key
+events such as requests and responses, along with data payloads and metadata
+such as headers and client configuration, are logged to the standard error
+stream.
+
+**WARNING:** Client Library Debug Logging includes your data payloads in
+plaintext, which could include sensitive data such as PII for yourself or your
+customers, private keys, or other security data that could be compromising if
+leaked. Always practice good data hygiene with your application logs, and follow
+the principle of least access. Google also recommends that Client Library Debug
+Logging be enabled only temporarily during active debugging, and not used
+permanently in production.
+
+To enable logging, set the environment variable `GOOGLE_SDK_RUBY_LOGGING_GEMS`
+to the value `all`. Alternatively, you can set the value to a comma-delimited
+list of client library gem names. This will select the default logging behavior,
+which writes logs to the standard error stream. On a local workstation, this may
+result in logs appearing on the console. When running on a Google Cloud hosting
+service such as [Google Cloud Run](https://cloud.google.com/run), this generally
+results in logs appearing alongside your application logs in the
+[Google Cloud Logging](https://cloud.google.com/logging/) service.
+
+You can customize logging by modifying the `logger` configuration when
+constructing a client object. For example:
 
 ```ruby
+require "google/cloud/gke_connect/gateway/v1beta1"
 require "logger"
 
-module MyLogger
-  LOGGER = Logger.new $stderr, level: Logger::WARN
-  def logger
-    LOGGER
-  end
-end
-
-# Define a gRPC module-level logger method before grpc/logconfig.rb loads.
-module GRPC
-  extend MyLogger
+client = ::Google::Cloud::GkeConnect::Gateway::V1beta1::GatewayControl::Rest::Client.new do |config|
+  config.logger = Logger.new "my-app.log"
 end
 ```
 
-
 ## Google Cloud Samples
 
 To browse ready to use code samples check [Google Cloud Samples](https://cloud.google.com/docs/samples).

data/lib/google/cloud/gke_connect/gateway/v1beta1/gateway_control/rest/client.rb

@@ -154,8 +154,28 @@ module Google
                     endpoint: @config.endpoint,
                     endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
                     universe_domain: @config.universe_domain,
-                    credentials: credentials
+                    credentials: credentials,
+                    logger: @config.logger
                   )
+
+                  @gateway_control_stub.logger(stub: true)&.info do |entry|
+                    entry.set_system_name
+                    entry.set_service
+                    entry.message = "Created client for #{entry.service}"
+                    entry.set_credentials_fields credentials
+                    entry.set "customEndpoint", @config.endpoint if @config.endpoint
+                    entry.set "defaultTimeout", @config.timeout if @config.timeout
+                    entry.set "quotaProject", @quota_project_id if @quota_project_id
+                  end
+                end
+
+                ##
+                # The logger used for request/response debug logging.
+                #
+                # @return [Logger]
+                #
+                def logger
+                  @gateway_control_stub.logger
                 end
 
                 # Service calls
@@ -253,7 +273,6 @@ module Google
 
                   @gateway_control_stub.generate_credentials request, options do |result, operation|
                     yield result, operation if block_given?
-                    return result
                   end
                 rescue ::Gapic::Rest::Error => e
                   raise ::Google::Cloud::Error.from_error(e)
@@ -333,6 +352,11 @@ module Google
                 #   default endpoint URL. The default value of nil uses the environment
                 #   universe (usually the default "googleapis.com" universe).
                 #   @return [::String,nil]
+                # @!attribute [rw] logger
+                #   A custom logger to use for request/response debug logging, or the value
+                #   `:default` (the default) to construct a default logger, or `nil` to
+                #   explicitly disable logging.
+                #   @return [::Logger,:default,nil]
                 #
                 class Configuration
                   extend ::Gapic::Config
@@ -354,6 +378,7 @@ module Google
                   config_attr :retry_policy,  nil, ::Hash, ::Proc, nil
                   config_attr :quota_project, nil, ::String, nil
                   config_attr :universe_domain, nil, ::String, nil
+                  config_attr :logger, :default, ::Logger, nil, :default
 
                   # @private
                   def initialize parent_config = nil

data/lib/google/cloud/gke_connect/gateway/v1beta1/gateway_control/rest/service_stub.rb

@@ -31,7 +31,8 @@ module Google
               # including transcoding, making the REST call, and deserialing the response.
               #
               class ServiceStub
-                def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
+                # @private
+                def initialize endpoint:, endpoint_template:, universe_domain:, credentials:, logger:
                   # These require statements are intentionally placed here to initialize
                   # the REST modules only when it's required.
                   require "gapic/rest"
@@ -41,7 +42,9 @@ module Google
                                                                universe_domain: universe_domain,
                                                                credentials: credentials,
                                                                numeric_enums: false,
-                                                               raise_faraday_errors: false
+                                                               service_name: self.class,
+                                                               raise_faraday_errors: false,
+                                                               logger: logger
                 end
 
                 ##
@@ -62,6 +65,15 @@ module Google
                   @client_stub.endpoint
                 end
 
+                ##
+                # The logger used for request/response debug logging.
+                #
+                # @return [Logger]
+                #
+                def logger stub: false
+                  stub ? @client_stub.stub_logger : @client_stub.logger
+                end
+
                 ##
                 # Baseline implementation for the generate_credentials REST call
                 #
@@ -88,16 +100,18 @@ module Google
 
                   response = @client_stub.make_http_request(
                     verb,
-                    uri:     uri,
-                    body:    body || "",
-                    params:  query_string_params,
+                    uri: uri,
+                    body: body || "",
+                    params: query_string_params,
+                    method_name: "generate_credentials",
                     options: options
                   )
                   operation = ::Gapic::Rest::TransportOperation.new response
                   result = ::Google::Cloud::GkeConnect::Gateway::V1beta1::GenerateCredentialsResponse.decode_json response.body, ignore_unknown_fields: true
-
-                  yield result, operation if block_given?
-                  result
+                  catch :response do
+                    yield result, operation if block_given?
+                    result
+                  end
                 end
 
                 ##

data/lib/google/cloud/gke_connect/gateway/v1beta1/gateway_control.rb

@@ -16,14 +16,12 @@
 
 # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
 
-require "gapic/common"
 require "gapic/config"
 require "gapic/config/method"
 
 require "google/cloud/gke_connect/gateway/v1beta1/version"
 
 require "google/cloud/gke_connect/gateway/v1beta1/gateway_control/credentials"
-require "google/cloud/gke_connect/gateway/v1beta1/gateway_control/client"
 require "google/cloud/gke_connect/gateway/v1beta1/gateway_control/rest"
 
 module Google
@@ -34,11 +32,6 @@ module Google
           ##
           # GatewayControl is the control plane API for Connect Gateway.
           #
-          # @example Load this service and instantiate a gRPC client
-          #
-          #     require "google/cloud/gke_connect/gateway/v1beta1/gateway_control"
-          #     client = ::Google::Cloud::GkeConnect::Gateway::V1beta1::GatewayControl::Client.new
-          #
           # @example Load this service and instantiate a REST client
           #
           #     require "google/cloud/gke_connect/gateway/v1beta1/gateway_control/rest"

data/lib/google/cloud/gke_connect/gateway/v1beta1/version.rb

@@ -22,7 +22,7 @@ module Google
     module GkeConnect
       module Gateway
         module V1beta1
-          VERSION = "0.7.0"
+          VERSION = "0.8.0"
         end
       end
     end

data/lib/google/cloud/gke_connect/gateway/v1beta1.rb

@@ -26,11 +26,6 @@ module Google
         ##
         # API client module.
         #
-        # @example Load this package, including all its services, and instantiate a gRPC client
-        #
-        #     require "google/cloud/gke_connect/gateway/v1beta1"
-        #     client = ::Google::Cloud::GkeConnect::Gateway::V1beta1::GatewayControl::Client.new
-        #
         # @example Load this package, including all its services, and instantiate a REST client
         #
         #     require "google/cloud/gke_connect/gateway/v1beta1"

data/proto_docs/google/api/client.rb

@@ -28,6 +28,9 @@ module Google
     # @!attribute [rw] destinations
     #   @return [::Array<::Google::Api::ClientLibraryDestination>]
     #     The destination where API teams want this client library to be published.
+    # @!attribute [rw] selective_gapic_generation
+    #   @return [::Google::Api::SelectiveGapicGeneration]
+    #     Configuration for which RPCs should be generated in the GAPIC client.
     class CommonLanguageSettings
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -196,9 +199,32 @@ module Google
     # @!attribute [rw] common
     #   @return [::Google::Api::CommonLanguageSettings]
     #     Some settings.
+    # @!attribute [rw] experimental_features
+    #   @return [::Google::Api::PythonSettings::ExperimentalFeatures]
+    #     Experimental features to be included during client library generation.
     class PythonSettings
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
+
+      # Experimental features to be included during client library generation.
+      # These fields will be deprecated once the feature graduates and is enabled
+      # by default.
+      # @!attribute [rw] rest_async_io_enabled
+      #   @return [::Boolean]
+      #     Enables generation of asynchronous REST clients if `rest` transport is
+      #     enabled. By default, asynchronous REST clients will not be generated.
+      #     This feature will be enabled by default 1 month after launching the
+      #     feature in preview packages.
+      # @!attribute [rw] protobuf_pythonic_types_enabled
+      #   @return [::Boolean]
+      #     Enables generation of protobuf code using new types that are more
+      #     Pythonic which are included in `protobuf>=5.29.x`. This feature will be
+      #     enabled by default 1 month after launching the feature in preview
+      #     packages.
+      class ExperimentalFeatures
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
     end
 
     # Settings for Node client libraries.
@@ -280,9 +306,28 @@ module Google
     # @!attribute [rw] common
     #   @return [::Google::Api::CommonLanguageSettings]
     #     Some settings.
+    # @!attribute [rw] renamed_services
+    #   @return [::Google::Protobuf::Map{::String => ::String}]
+    #     Map of service names to renamed services. Keys are the package relative
+    #     service names and values are the name to be used for the service client
+    #     and call options.
+    #
+    #     publishing:
+    #       go_settings:
+    #         renamed_services:
+    #           Publisher: TopicAdmin
     class GoSettings
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
+
+      # @!attribute [rw] key
+      #   @return [::String]
+      # @!attribute [rw] value
+      #   @return [::String]
+      class RenamedServicesEntry
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
     end
 
     # Describes the generator configuration for a method.
@@ -358,6 +403,17 @@ module Google
       end
     end
 
+    # This message is used to configure the generation of a subset of the RPCs in
+    # a service for client libraries.
+    # @!attribute [rw] methods
+    #   @return [::Array<::String>]
+    #     An allowlist of the fully qualified names of RPCs that should be included
+    #     on public client surfaces.
+    class SelectiveGapicGeneration
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
     # The organization for which the client libraries are being published.
     # Affects the url where generated docs are published, etc.
     module ClientLibraryOrganization

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-gke_connect-gateway-v1beta1
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-08-27 00:00:00.000000000 Z
+date: 2024-12-10 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.21.1
+        version: 0.24.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.21.1
+        version: 0.24.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -63,7 +63,6 @@ files:
 - lib/google-cloud-gke_connect-gateway-v1beta1.rb
 - lib/google/cloud/gke_connect/gateway/v1beta1.rb
 - lib/google/cloud/gke_connect/gateway/v1beta1/gateway_control.rb
-- lib/google/cloud/gke_connect/gateway/v1beta1/gateway_control/client.rb
 - lib/google/cloud/gke_connect/gateway/v1beta1/gateway_control/credentials.rb
 - lib/google/cloud/gke_connect/gateway/v1beta1/gateway_control/rest.rb
 - lib/google/cloud/gke_connect/gateway/v1beta1/gateway_control/rest/client.rb
@@ -98,7 +97,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.6
+rubygems_version: 3.5.23
 signing_key: 
 specification_version: 4
 summary: The Connect Gateway service allows connectivity from external parties to

data/lib/google/cloud/gke_connect/gateway/v1beta1/gateway_control/client.rb

@@ -1,450 +0,0 @@
-# frozen_string_literal: true
-
-# Copyright 2024 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!
-
-require "google/cloud/errors"
-require "google/cloud/gkeconnect/gateway/v1beta1/control_pb"
-
-module Google
-  module Cloud
-    module GkeConnect
-      module Gateway
-        module V1beta1
-          module GatewayControl
-            ##
-            # Client for the GatewayControl service.
-            #
-            # GatewayControl is the control plane API for Connect Gateway.
-            #
-            class Client
-              # @private
-              API_VERSION = ""
-
-              # @private
-              DEFAULT_ENDPOINT_TEMPLATE = "connectgateway.$UNIVERSE_DOMAIN$"
-
-              # @private
-              attr_reader :gateway_control_stub
-
-              ##
-              # Configure the GatewayControl Client class.
-              #
-              # See {::Google::Cloud::GkeConnect::Gateway::V1beta1::GatewayControl::Client::Configuration}
-              # for a description of the configuration fields.
-              #
-              # @example
-              #
-              #   # Modify the configuration for all GatewayControl clients
-              #   ::Google::Cloud::GkeConnect::Gateway::V1beta1::GatewayControl::Client.configure do |config|
-              #     config.timeout = 10.0
-              #   end
-              #
-              # @yield [config] Configure the Client client.
-              # @yieldparam config [Client::Configuration]
-              #
-              # @return [Client::Configuration]
-              #
-              def self.configure
-                @configure ||= begin
-                  namespace = ["Google", "Cloud", "GkeConnect", "Gateway", "V1beta1"]
-                  parent_config = while namespace.any?
-                                    parent_name = namespace.join "::"
-                                    parent_const = const_get parent_name
-                                    break parent_const.configure if parent_const.respond_to? :configure
-                                    namespace.pop
-                                  end
-                  default_config = Client::Configuration.new parent_config
-
-                  default_config.rpcs.generate_credentials.timeout = 60.0
-                  default_config.rpcs.generate_credentials.retry_policy = {
-                    initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
-                  }
-
-                  default_config
-                end
-                yield @configure if block_given?
-                @configure
-              end
-
-              ##
-              # Configure the GatewayControl Client instance.
-              #
-              # The configuration is set to the derived mode, meaning that values can be changed,
-              # but structural changes (adding new fields, etc.) are not allowed. Structural changes
-              # should be made on {Client.configure}.
-              #
-              # See {::Google::Cloud::GkeConnect::Gateway::V1beta1::GatewayControl::Client::Configuration}
-              # for a description of the configuration fields.
-              #
-              # @yield [config] Configure the Client client.
-              # @yieldparam config [Client::Configuration]
-              #
-              # @return [Client::Configuration]
-              #
-              def configure
-                yield @config if block_given?
-                @config
-              end
-
-              ##
-              # The effective universe domain
-              #
-              # @return [String]
-              #
-              def universe_domain
-                @gateway_control_stub.universe_domain
-              end
-
-              ##
-              # Create a new GatewayControl client object.
-              #
-              # @example
-              #
-              #   # Create a client using the default configuration
-              #   client = ::Google::Cloud::GkeConnect::Gateway::V1beta1::GatewayControl::Client.new
-              #
-              #   # Create a client using a custom configuration
-              #   client = ::Google::Cloud::GkeConnect::Gateway::V1beta1::GatewayControl::Client.new do |config|
-              #     config.timeout = 10.0
-              #   end
-              #
-              # @yield [config] Configure the GatewayControl client.
-              # @yieldparam config [Client::Configuration]
-              #
-              def initialize
-                # These require statements are intentionally placed here to initialize
-                # the gRPC module only when it's required.
-                # See https://github.com/googleapis/toolkit/issues/446
-                require "gapic/grpc"
-                require "google/cloud/gkeconnect/gateway/v1beta1/control_services_pb"
-
-                # Create the configuration object
-                @config = Configuration.new Client.configure
-
-                # Yield the configuration if needed
-                yield @config if block_given?
-
-                # Create credentials
-                credentials = @config.credentials
-                # Use self-signed JWT if the endpoint is unchanged from default,
-                # but only if the default endpoint does not have a region prefix.
-                enable_self_signed_jwt = @config.endpoint.nil? ||
-                                         (@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
-                                         !@config.endpoint.split(".").first.include?("-"))
-                credentials ||= Credentials.default scope: @config.scope,
-                                                    enable_self_signed_jwt: enable_self_signed_jwt
-                if credentials.is_a?(::String) || credentials.is_a?(::Hash)
-                  credentials = Credentials.new credentials, scope: @config.scope
-                end
-                @quota_project_id = @config.quota_project
-                @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
-
-                @gateway_control_stub = ::Gapic::ServiceStub.new(
-                  ::Google::Cloud::GkeConnect::Gateway::V1beta1::GatewayControl::Stub,
-                  credentials: credentials,
-                  endpoint: @config.endpoint,
-                  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
-                  universe_domain: @config.universe_domain,
-                  channel_args: @config.channel_args,
-                  interceptors: @config.interceptors,
-                  channel_pool_config: @config.channel_pool
-                )
-              end
-
-              # Service calls
-
-              ##
-              # GenerateCredentials provides connection information that allows a user to
-              # access the specified membership using Connect Gateway.
-              #
-              # @overload generate_credentials(request, options = nil)
-              #   Pass arguments to `generate_credentials` via a request object, either of type
-              #   {::Google::Cloud::GkeConnect::Gateway::V1beta1::GenerateCredentialsRequest} or an equivalent Hash.
-              #
-              #   @param request [::Google::Cloud::GkeConnect::Gateway::V1beta1::GenerateCredentialsRequest, ::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 generate_credentials(name: nil, force_use_agent: nil, version: nil, kubernetes_namespace: nil, operating_system: nil)
-              #   Pass arguments to `generate_credentials` 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 Fleet membership resource.
-              #   @param force_use_agent [::Boolean]
-              #     Optional. Whether to force the use of Connect Agent-based transport.
-              #
-              #     This will return a configuration that uses Connect Agent as the underlying
-              #     transport mechanism for cluster types that would otherwise have used a
-              #     different transport. Requires that Connect Agent be installed on the
-              #     cluster. Setting this field to false is equivalent to not setting it.
-              #   @param version [::String]
-              #     Optional. The Connect Gateway version to be used in the resulting
-              #     configuration.
-              #
-              #     Leave this field blank to let the server choose the version (recommended).
-              #   @param kubernetes_namespace [::String]
-              #     Optional. The namespace to use in the kubeconfig context.
-              #
-              #     If this field is specified, the server will set the `namespace` field in
-              #     kubeconfig context. If not specified, the `namespace` field is omitted.
-              #   @param operating_system [::Google::Cloud::GkeConnect::Gateway::V1beta1::GenerateCredentialsRequest::OperatingSystem]
-              #     Optional. The operating system where the kubeconfig will be used.
-              #
-              # @yield [response, operation] Access the result along with the RPC operation
-              # @yieldparam response [::Google::Cloud::GkeConnect::Gateway::V1beta1::GenerateCredentialsResponse]
-              # @yieldparam operation [::GRPC::ActiveCall::Operation]
-              #
-              # @return [::Google::Cloud::GkeConnect::Gateway::V1beta1::GenerateCredentialsResponse]
-              #
-              # @raise [::Google::Cloud::Error] if the RPC is aborted.
-              #
-              # @example Basic example
-              #   require "google/cloud/gke_connect/gateway/v1beta1"
-              #
-              #   # Create a client object. The client can be reused for multiple calls.
-              #   client = Google::Cloud::GkeConnect::Gateway::V1beta1::GatewayControl::Client.new
-              #
-              #   # Create a request. To set request fields, pass in keyword arguments.
-              #   request = Google::Cloud::GkeConnect::Gateway::V1beta1::GenerateCredentialsRequest.new
-              #
-              #   # Call the generate_credentials method.
-              #   result = client.generate_credentials request
-              #
-              #   # The returned object is of type Google::Cloud::GkeConnect::Gateway::V1beta1::GenerateCredentialsResponse.
-              #   p result
-              #
-              def generate_credentials request, options = nil
-                raise ::ArgumentError, "request must be provided" if request.nil?
-
-                request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::GkeConnect::Gateway::V1beta1::GenerateCredentialsRequest
-
-                # 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.generate_credentials.metadata.to_h
-
-                # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-                metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                  lib_name: @config.lib_name, lib_version: @config.lib_version,
-                  gapic_version: ::Google::Cloud::GkeConnect::Gateway::V1beta1::VERSION
-                metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-                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.generate_credentials.timeout,
-                                       metadata:     metadata,
-                                       retry_policy: @config.rpcs.generate_credentials.retry_policy
-
-                options.apply_defaults timeout:      @config.timeout,
-                                       metadata:     @config.metadata,
-                                       retry_policy: @config.retry_policy
-
-                @gateway_control_stub.call_rpc :generate_credentials, request, options: options do |response, operation|
-                  yield response, operation if block_given?
-                  return response
-                end
-              rescue ::GRPC::BadStatus => e
-                raise ::Google::Cloud::Error.from_error(e)
-              end
-
-              ##
-              # Configuration class for the GatewayControl API.
-              #
-              # This class represents the configuration for GatewayControl,
-              # providing control over timeouts, retry behavior, logging, transport
-              # parameters, and other low-level controls. Certain parameters can also be
-              # applied individually to specific RPCs. See
-              # {::Google::Cloud::GkeConnect::Gateway::V1beta1::GatewayControl::Client::Configuration::Rpcs}
-              # for a list of RPCs that can be configured independently.
-              #
-              # Configuration can be applied globally to all clients, or to a single client
-              # on construction.
-              #
-              # @example
-              #
-              #   # Modify the global config, setting the timeout for
-              #   # generate_credentials to 20 seconds,
-              #   # and all remaining timeouts to 10 seconds.
-              #   ::Google::Cloud::GkeConnect::Gateway::V1beta1::GatewayControl::Client.configure do |config|
-              #     config.timeout = 10.0
-              #     config.rpcs.generate_credentials.timeout = 20.0
-              #   end
-              #
-              #   # Apply the above configuration only to a new client.
-              #   client = ::Google::Cloud::GkeConnect::Gateway::V1beta1::GatewayControl::Client.new do |config|
-              #     config.timeout = 10.0
-              #     config.rpcs.generate_credentials.timeout = 20.0
-              #   end
-              #
-              # @!attribute [rw] endpoint
-              #   A custom service endpoint, as a hostname or hostname:port. The default is
-              #   nil, indicating to use the default endpoint in the current universe domain.
-              #   @return [::String,nil]
-              # @!attribute [rw] credentials
-              #   Credentials to send with calls. You may provide any of the following types:
-              #    *  (`String`) The path to a service account key file in JSON format
-              #    *  (`Hash`) A service account key as a Hash
-              #    *  (`Google::Auth::Credentials`) A googleauth credentials object
-              #       (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
-              #    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
-              #       (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
-              #    *  (`GRPC::Core::Channel`) a gRPC channel with included credentials
-              #    *  (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
-              #    *  (`nil`) indicating no credentials
-              #   @return [::Object]
-              # @!attribute [rw] scope
-              #   The OAuth scopes
-              #   @return [::Array<::String>]
-              # @!attribute [rw] lib_name
-              #   The library name as recorded in instrumentation and logging
-              #   @return [::String]
-              # @!attribute [rw] lib_version
-              #   The library version as recorded in instrumentation and logging
-              #   @return [::String]
-              # @!attribute [rw] channel_args
-              #   Extra parameters passed to the gRPC channel. Note: this is ignored if a
-              #   `GRPC::Core::Channel` object is provided as the credential.
-              #   @return [::Hash]
-              # @!attribute [rw] interceptors
-              #   An array of interceptors that are run before calls are executed.
-              #   @return [::Array<::GRPC::ClientInterceptor>]
-              # @!attribute [rw] timeout
-              #   The call timeout in seconds.
-              #   @return [::Numeric]
-              # @!attribute [rw] metadata
-              #   Additional gRPC headers to be sent with the call.
-              #   @return [::Hash{::Symbol=>::String}]
-              # @!attribute [rw] retry_policy
-              #   The retry policy. The value is a hash with the following keys:
-              #    *  `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
-              #    *  `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
-              #    *  `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
-              #    *  `:retry_codes` (*type:* `Array<String>`) - The error codes that should
-              #       trigger a retry.
-              #   @return [::Hash]
-              # @!attribute [rw] quota_project
-              #   A separate project against which to charge quota.
-              #   @return [::String]
-              # @!attribute [rw] universe_domain
-              #   The universe domain within which to make requests. This determines the
-              #   default endpoint URL. The default value of nil uses the environment
-              #   universe (usually the default "googleapis.com" universe).
-              #   @return [::String,nil]
-              #
-              class Configuration
-                extend ::Gapic::Config
-
-                # @private
-                # The endpoint specific to the default "googleapis.com" universe. Deprecated.
-                DEFAULT_ENDPOINT = "connectgateway.googleapis.com"
-
-                config_attr :endpoint,      nil, ::String, nil
-                config_attr :credentials,   nil do |value|
-                  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
-                  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
-                  allowed.any? { |klass| klass === value }
-                end
-                config_attr :scope,         nil, ::String, ::Array, nil
-                config_attr :lib_name,      nil, ::String, nil
-                config_attr :lib_version,   nil, ::String, nil
-                config_attr(:channel_args,  { "grpc.service_config_disable_resolution" => 1 }, ::Hash, nil)
-                config_attr :interceptors,  nil, ::Array, nil
-                config_attr :timeout,       nil, ::Numeric, nil
-                config_attr :metadata,      nil, ::Hash, nil
-                config_attr :retry_policy,  nil, ::Hash, ::Proc, nil
-                config_attr :quota_project, nil, ::String, nil
-                config_attr :universe_domain, nil, ::String, nil
-
-                # @private
-                def initialize parent_config = nil
-                  @parent_config = parent_config unless parent_config.nil?
-
-                  yield self if block_given?
-                end
-
-                ##
-                # Configurations for individual RPCs
-                # @return [Rpcs]
-                #
-                def rpcs
-                  @rpcs ||= begin
-                    parent_rpcs = nil
-                    parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
-                    Rpcs.new parent_rpcs
-                  end
-                end
-
-                ##
-                # Configuration for the channel pool
-                # @return [::Gapic::ServiceStub::ChannelPool::Configuration]
-                #
-                def channel_pool
-                  @channel_pool ||= ::Gapic::ServiceStub::ChannelPool::Configuration.new
-                end
-
-                ##
-                # Configuration RPC class for the GatewayControl API.
-                #
-                # Includes fields providing the configuration for each RPC in this service.
-                # Each configuration object is of type `Gapic::Config::Method` and includes
-                # the following configuration fields:
-                #
-                #  *  `timeout` (*type:* `Numeric`) - The call timeout in seconds
-                #  *  `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
-                #  *  `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
-                #     include the following keys:
-                #      *  `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
-                #      *  `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
-                #      *  `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
-                #      *  `:retry_codes` (*type:* `Array<String>`) - The error codes that should
-                #         trigger a retry.
-                #
-                class Rpcs
-                  ##
-                  # RPC-specific configuration for `generate_credentials`
-                  # @return [::Gapic::Config::Method]
-                  #
-                  attr_reader :generate_credentials
-
-                  # @private
-                  def initialize parent_rpcs = nil
-                    generate_credentials_config = parent_rpcs.generate_credentials if parent_rpcs.respond_to? :generate_credentials
-                    @generate_credentials = ::Gapic::Config::Method.new generate_credentials_config
-
-                    yield self if block_given?
-                  end
-                end
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end