google-cloud-dialogflow-v2 0.6.4 → 0.10.0

data/lib/google/cloud/dialogflow/v2/entity_types/operations.rb

@@ -103,8 +103,13 @@ module Google
             # Lists operations that match the specified filter in the request. If the
             # server doesn't support this method, it returns `UNIMPLEMENTED`.
             #
-            # NOTE: the `name` binding below allows API services to override the binding
-            # to use different resource name schemes, such as `users/*/operations`.
+            # NOTE: the `name` binding allows API services to override the binding
+            # to use different resource name schemes, such as `users/*/operations`. To
+            # override the binding, API services can add a binding such as
+            # `"/v1/{name=users/*}/operations"` to their service configuration.
+            # For backwards compatibility, the default name includes the operations
+            # collection id, however overriding users must ensure the name binding
+            # is the parent resource, without the operations collection id.
             #
             # @overload list_operations(request, options = nil)
             #   Pass arguments to `list_operations` via a request object, either of type
@@ -122,7 +127,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     The name of the operation collection.
+            #     The name of the operation's parent resource.
             #   @param filter [::String]
             #     The standard list filter.
             #   @param page_size [::Integer]
@@ -390,6 +395,79 @@ module Google
               raise ::Google::Cloud::Error.from_error(e)
             end
 
+            ##
+            # Waits for the specified long-running operation until it is done or reaches
+            # at most a specified timeout, returning the latest state.  If the operation
+            # is already done, the latest state is immediately returned.  If the timeout
+            # specified is greater than the default HTTP/RPC timeout, the HTTP/RPC
+            # timeout is used.  If the server does not support this method, it returns
+            # `google.rpc.Code.UNIMPLEMENTED`.
+            # Note that this method is on a best-effort basis.  It may return the latest
+            # state before the specified timeout (including immediately), meaning even an
+            # immediate response is no guarantee that the operation is done.
+            #
+            # @overload wait_operation(request, options = nil)
+            #   Pass arguments to `wait_operation` via a request object, either of type
+            #   {::Google::Longrunning::WaitOperationRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Longrunning::WaitOperationRequest, ::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 wait_operation(name: nil, timeout: nil)
+            #   Pass arguments to `wait_operation` 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]
+            #     The name of the operation resource to wait on.
+            #   @param timeout [::Google::Protobuf::Duration, ::Hash]
+            #     The maximum duration to wait before timing out. If left blank, the wait
+            #     will be at most the time permitted by the underlying HTTP/RPC protocol.
+            #     If RPC context deadline is also specified, the shorter one will be used.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Gapic::Operation]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Gapic::Operation]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            def wait_operation request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Longrunning::WaitOperationRequest
+
+              # 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.wait_operation.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 \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::Dialogflow::V2::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              options.apply_defaults timeout:      @config.rpcs.wait_operation.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.wait_operation.retry_policy
+              options.apply_defaults metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @operations_stub.call_rpc :wait_operation, request, options: options do |response, operation|
+                response = ::Gapic::Operation.new response, @operations_client, options: options
+                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 Operations API.
             #
@@ -475,14 +553,14 @@ module Google
 
               config_attr :endpoint,      "dialogflow.googleapis.com", ::String
               config_attr :credentials,   nil do |value|
-                allowed = [::String, ::Hash, ::Proc, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
+                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(: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
@@ -503,7 +581,7 @@ module Google
               def rpcs
                 @rpcs ||= begin
                   parent_rpcs = nil
-                  parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config&.respond_to?(:rpcs)
+                  parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
                   Rpcs.new parent_rpcs
                 end
               end
@@ -515,7 +593,7 @@ module Google
               # Each configuration object is of type `Gapic::Config::Method` and includes
               # the following configuration fields:
               #
-              #  *  `timeout` (*type:* `Numeric`) - The call timeout in milliseconds
+              #  *  `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:
@@ -546,17 +624,24 @@ module Google
                 # @return [::Gapic::Config::Method]
                 #
                 attr_reader :cancel_operation
+                ##
+                # RPC-specific configuration for `wait_operation`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :wait_operation
 
                 # @private
                 def initialize parent_rpcs = nil
-                  list_operations_config = parent_rpcs&.list_operations if parent_rpcs&.respond_to? :list_operations
+                  list_operations_config = parent_rpcs.list_operations if parent_rpcs.respond_to? :list_operations
                   @list_operations = ::Gapic::Config::Method.new list_operations_config
-                  get_operation_config = parent_rpcs&.get_operation if parent_rpcs&.respond_to? :get_operation
+                  get_operation_config = parent_rpcs.get_operation if parent_rpcs.respond_to? :get_operation
                   @get_operation = ::Gapic::Config::Method.new get_operation_config
-                  delete_operation_config = parent_rpcs&.delete_operation if parent_rpcs&.respond_to? :delete_operation
+                  delete_operation_config = parent_rpcs.delete_operation if parent_rpcs.respond_to? :delete_operation
                   @delete_operation = ::Gapic::Config::Method.new delete_operation_config
-                  cancel_operation_config = parent_rpcs&.cancel_operation if parent_rpcs&.respond_to? :cancel_operation
+                  cancel_operation_config = parent_rpcs.cancel_operation if parent_rpcs.respond_to? :cancel_operation
                   @cancel_operation = ::Gapic::Config::Method.new cancel_operation_config
+                  wait_operation_config = parent_rpcs.wait_operation if parent_rpcs.respond_to? :wait_operation
+                  @wait_operation = ::Gapic::Config::Method.new wait_operation_config
 
                   yield self if block_given?
                 end

data/lib/google/cloud/dialogflow/v2/entity_types/paths.rb

@@ -27,32 +27,78 @@ module Google
             ##
             # Create a fully-qualified Agent resource string.
             #
-            # The resource will be in the following format:
+            # @overload agent_path(project:)
+            #   The resource will be in the following format:
             #
-            # `projects/{project}/agent`
+            #   `projects/{project}/agent`
             #
-            # @param project [String]
+            #   @param project [String]
+            #
+            # @overload agent_path(project:, location:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/locations/{location}/agent`
+            #
+            #   @param project [String]
+            #   @param location [String]
             #
             # @return [::String]
-            def agent_path project:
-              "projects/#{project}/agent"
+            def agent_path **args
+              resources = {
+                "project" => (proc do |project:|
+                  "projects/#{project}/agent"
+                end),
+                "location:project" => (proc do |project:, location:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+
+                  "projects/#{project}/locations/#{location}/agent"
+                end)
+              }
+
+              resource = resources[args.keys.sort.join(":")]
+              raise ::ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
+              resource.call(**args)
             end
 
             ##
             # Create a fully-qualified EntityType resource string.
             #
-            # The resource will be in the following format:
+            # @overload entity_type_path(project:, entity_type:)
+            #   The resource will be in the following format:
             #
-            # `projects/{project}/agent/entityTypes/{entity_type}`
+            #   `projects/{project}/agent/entityTypes/{entity_type}`
             #
-            # @param project [String]
-            # @param entity_type [String]
+            #   @param project [String]
+            #   @param entity_type [String]
+            #
+            # @overload entity_type_path(project:, location:, entity_type:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/locations/{location}/agent/entityTypes/{entity_type}`
+            #
+            #   @param project [String]
+            #   @param location [String]
+            #   @param entity_type [String]
             #
             # @return [::String]
-            def entity_type_path project:, entity_type:
-              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+            def entity_type_path **args
+              resources = {
+                "entity_type:project" => (proc do |project:, entity_type:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+
+                  "projects/#{project}/agent/entityTypes/#{entity_type}"
+                end),
+                "entity_type:location:project" => (proc do |project:, location:, entity_type:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                  raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+
+                  "projects/#{project}/locations/#{location}/agent/entityTypes/#{entity_type}"
+                end)
+              }
 
-              "projects/#{project}/agent/entityTypes/#{entity_type}"
+              resource = resources[args.keys.sort.join(":")]
+              raise ::ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
+              resource.call(**args)
             end
 
             extend self

data/lib/google/cloud/dialogflow/v2/environment_pb.rb

@@ -4,12 +4,14 @@
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'
+require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
+require 'google/cloud/dialogflow/v2/audio_config_pb'
+require 'google/cloud/dialogflow/v2/fulfillment_pb'
 require 'google/protobuf/empty_pb'
 require 'google/protobuf/field_mask_pb'
 require 'google/protobuf/timestamp_pb'
-require 'google/api/client_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/dialogflow/v2/environment.proto", :syntax => :proto3) do
     add_message "google.cloud.dialogflow.v2.Environment" do
@@ -18,6 +20,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :agent_version, :string, 3
       optional :state, :enum, 4, "google.cloud.dialogflow.v2.Environment.State"
       optional :update_time, :message, 5, "google.protobuf.Timestamp"
+      optional :text_to_speech_settings, :message, 7, "google.cloud.dialogflow.v2.TextToSpeechSettings"
+      optional :fulfillment, :message, 8, "google.cloud.dialogflow.v2.Fulfillment"
     end
     add_enum "google.cloud.dialogflow.v2.Environment.State" do
       value :STATE_UNSPECIFIED, 0
@@ -25,6 +29,12 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :LOADING, 2
       value :RUNNING, 3
     end
+    add_message "google.cloud.dialogflow.v2.TextToSpeechSettings" do
+      optional :enable_text_to_speech, :bool, 1
+      optional :output_audio_encoding, :enum, 2, "google.cloud.dialogflow.v2.OutputAudioEncoding"
+      optional :sample_rate_hertz, :int32, 3
+      map :synthesize_speech_configs, :string, :message, 4, "google.cloud.dialogflow.v2.SynthesizeSpeechConfig"
+    end
     add_message "google.cloud.dialogflow.v2.ListEnvironmentsRequest" do
       optional :parent, :string, 1
       optional :page_size, :int32, 2
@@ -34,6 +44,37 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :environments, :message, 1, "google.cloud.dialogflow.v2.Environment"
       optional :next_page_token, :string, 2
     end
+    add_message "google.cloud.dialogflow.v2.GetEnvironmentRequest" do
+      optional :name, :string, 1
+    end
+    add_message "google.cloud.dialogflow.v2.CreateEnvironmentRequest" do
+      optional :parent, :string, 1
+      optional :environment, :message, 2, "google.cloud.dialogflow.v2.Environment"
+      optional :environment_id, :string, 3
+    end
+    add_message "google.cloud.dialogflow.v2.UpdateEnvironmentRequest" do
+      optional :environment, :message, 1, "google.cloud.dialogflow.v2.Environment"
+      optional :update_mask, :message, 2, "google.protobuf.FieldMask"
+      optional :allow_load_to_draft_and_discard_changes, :bool, 3
+    end
+    add_message "google.cloud.dialogflow.v2.DeleteEnvironmentRequest" do
+      optional :name, :string, 1
+    end
+    add_message "google.cloud.dialogflow.v2.GetEnvironmentHistoryRequest" do
+      optional :parent, :string, 1
+      optional :page_size, :int32, 2
+      optional :page_token, :string, 3
+    end
+    add_message "google.cloud.dialogflow.v2.EnvironmentHistory" do
+      optional :parent, :string, 1
+      repeated :entries, :message, 2, "google.cloud.dialogflow.v2.EnvironmentHistory.Entry"
+      optional :next_page_token, :string, 3
+    end
+    add_message "google.cloud.dialogflow.v2.EnvironmentHistory.Entry" do
+      optional :agent_version, :string, 1
+      optional :description, :string, 2
+      optional :create_time, :message, 3, "google.protobuf.Timestamp"
+    end
   end
 end
 
@@ -43,8 +84,16 @@ module Google
       module V2
         Environment = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.Environment").msgclass
         Environment::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.Environment.State").enummodule
+        TextToSpeechSettings = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.TextToSpeechSettings").msgclass
         ListEnvironmentsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.ListEnvironmentsRequest").msgclass
         ListEnvironmentsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.ListEnvironmentsResponse").msgclass
+        GetEnvironmentRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.GetEnvironmentRequest").msgclass
+        CreateEnvironmentRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.CreateEnvironmentRequest").msgclass
+        UpdateEnvironmentRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.UpdateEnvironmentRequest").msgclass
+        DeleteEnvironmentRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.DeleteEnvironmentRequest").msgclass
+        GetEnvironmentHistoryRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.GetEnvironmentHistoryRequest").msgclass
+        EnvironmentHistory = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.EnvironmentHistory").msgclass
+        EnvironmentHistory::Entry = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.EnvironmentHistory.Entry").msgclass
       end
     end
   end

data/lib/google/cloud/dialogflow/v2/environment_services_pb.rb

@@ -24,17 +24,38 @@ module Google
     module Dialogflow
       module V2
         module Environments
-          # Manages agent environments.
+          # Service for managing [Environments][google.cloud.dialogflow.v2.Environment].
           class Service
 
-            include GRPC::GenericService
+            include ::GRPC::GenericService
 
             self.marshal_class_method = :encode
             self.unmarshal_class_method = :decode
             self.service_name = 'google.cloud.dialogflow.v2.Environments'
 
             # Returns the list of all non-draft environments of the specified agent.
-            rpc :ListEnvironments, ListEnvironmentsRequest, ListEnvironmentsResponse
+            rpc :ListEnvironments, ::Google::Cloud::Dialogflow::V2::ListEnvironmentsRequest, ::Google::Cloud::Dialogflow::V2::ListEnvironmentsResponse
+            # Retrieves the specified agent environment.
+            rpc :GetEnvironment, ::Google::Cloud::Dialogflow::V2::GetEnvironmentRequest, ::Google::Cloud::Dialogflow::V2::Environment
+            # Creates an agent environment.
+            rpc :CreateEnvironment, ::Google::Cloud::Dialogflow::V2::CreateEnvironmentRequest, ::Google::Cloud::Dialogflow::V2::Environment
+            # Updates the specified agent environment.
+            #
+            # This method allows you to deploy new agent versions into the environment.
+            # When an environment is pointed to a new agent version by setting
+            # `environment.agent_version`, the environment is temporarily set to the
+            # `LOADING` state. During that time, the environment keeps on serving the
+            # previous version of the agent. After the new agent version is done loading,
+            # the environment is set back to the `RUNNING` state.
+            # You can use "-" as Environment ID in environment name to update version
+            # in "draft" environment. WARNING: this will negate all recent changes to
+            # draft and can't be undone. You may want to save the draft to a version
+            # before calling this function.
+            rpc :UpdateEnvironment, ::Google::Cloud::Dialogflow::V2::UpdateEnvironmentRequest, ::Google::Cloud::Dialogflow::V2::Environment
+            # Deletes the specified agent environment.
+            rpc :DeleteEnvironment, ::Google::Cloud::Dialogflow::V2::DeleteEnvironmentRequest, ::Google::Protobuf::Empty
+            # Gets the history of the specified environment.
+            rpc :GetEnvironmentHistory, ::Google::Cloud::Dialogflow::V2::GetEnvironmentHistoryRequest, ::Google::Cloud::Dialogflow::V2::EnvironmentHistory
           end
 
           Stub = Service.rpc_stub_class

data/lib/google/cloud/dialogflow/v2/environments.rb

@@ -31,7 +31,7 @@ module Google
     module Dialogflow
       module V2
         ##
-        # Manages agent environments.
+        # Service for managing {::Google::Cloud::Dialogflow::V2::Environment Environments}.
         #
         # To load this service and instantiate a client:
         #

data/lib/google/cloud/dialogflow/v2/environments/client.rb

@@ -27,7 +27,7 @@ module Google
           ##
           # Client for the Environments service.
           #
-          # Manages agent environments.
+          # Service for managing {::Google::Cloud::Dialogflow::V2::Environment Environments}.
           #
           class Client
             include Paths
@@ -60,7 +60,7 @@ module Google
                 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
+                                  break parent_const.configure if parent_const.respond_to? :configure
                                   namespace.pop
                                 end
                 default_config = Client::Configuration.new parent_config
@@ -68,9 +68,9 @@ module Google
                 default_config.timeout = 60.0
                 default_config.retry_policy = {
                   initial_delay: 0.1,
-                  max_delay:     60.0,
-                  multiplier:    1.3,
-                  retry_codes:   ["UNAVAILABLE"]
+                max_delay: 60.0,
+                multiplier: 1.3,
+                retry_codes: [14]
                 }
 
                 default_config
@@ -134,7 +134,13 @@ module Google
 
               # Create credentials
               credentials = @config.credentials
-              credentials ||= Credentials.default scope: @config.scope
+              # Use self-signed JWT if the scope and endpoint are unchanged from default,
+              # but only if the default endpoint does not have a region prefix.
+              enable_self_signed_jwt = @config.scope == Client.configure.scope &&
+                                       @config.endpoint == Client.configure.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
@@ -172,7 +178,9 @@ module Google
             #
             #   @param parent [::String]
             #     Required. The agent to list all environments from.
-            #     Format: `projects/<Project ID>/agent`.
+            #     Format:
+            #     - `projects/<Project ID>/agent`
+            #     - `projects/<Project ID>/locations/<Location ID>/agent`
             #   @param page_size [::Integer]
             #     Optional. The maximum number of items to return in a single page. By default 100 and
             #     at most 1000.
@@ -225,6 +233,379 @@ module Google
               raise ::Google::Cloud::Error.from_error(e)
             end
 
+            ##
+            # Retrieves the specified agent environment.
+            #
+            # @overload get_environment(request, options = nil)
+            #   Pass arguments to `get_environment` via a request object, either of type
+            #   {::Google::Cloud::Dialogflow::V2::GetEnvironmentRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Dialogflow::V2::GetEnvironmentRequest, ::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_environment(name: nil)
+            #   Pass arguments to `get_environment` 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 environment.
+            #     Supported formats:
+            #     - `projects/<Project ID>/agent/environments/<Environment ID>`
+            #     - `projects/<Project ID>/locations/<Location
+            #       ID>/agent/environments/<Environment ID>`
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Google::Cloud::Dialogflow::V2::Environment]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Google::Cloud::Dialogflow::V2::Environment]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            def get_environment request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Dialogflow::V2::GetEnvironmentRequest
+
+              # 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_environment.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 \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::Dialogflow::V2::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_environment.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.get_environment.retry_policy
+              options.apply_defaults metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @environments_stub.call_rpc :get_environment, 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
+
+            ##
+            # Creates an agent environment.
+            #
+            # @overload create_environment(request, options = nil)
+            #   Pass arguments to `create_environment` via a request object, either of type
+            #   {::Google::Cloud::Dialogflow::V2::CreateEnvironmentRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Dialogflow::V2::CreateEnvironmentRequest, ::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 create_environment(parent: nil, environment: nil, environment_id: nil)
+            #   Pass arguments to `create_environment` 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 parent [::String]
+            #     Required. The agent to create an environment for.
+            #     Supported formats:
+            #     - `projects/<Project ID>/agent`
+            #     - `projects/<Project ID>/locations/<Location ID>/agent`
+            #   @param environment [::Google::Cloud::Dialogflow::V2::Environment, ::Hash]
+            #     Required. The environment to create.
+            #   @param environment_id [::String]
+            #     Required. The unique id of the new environment.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Google::Cloud::Dialogflow::V2::Environment]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Google::Cloud::Dialogflow::V2::Environment]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            def create_environment request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Dialogflow::V2::CreateEnvironmentRequest
+
+              # 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.create_environment.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 \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::Dialogflow::V2::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {
+                "parent" => request.parent
+              }
+              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.create_environment.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.create_environment.retry_policy
+              options.apply_defaults metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @environments_stub.call_rpc :create_environment, 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
+
+            ##
+            # Updates the specified agent environment.
+            #
+            # This method allows you to deploy new agent versions into the environment.
+            # When an environment is pointed to a new agent version by setting
+            # `environment.agent_version`, the environment is temporarily set to the
+            # `LOADING` state. During that time, the environment keeps on serving the
+            # previous version of the agent. After the new agent version is done loading,
+            # the environment is set back to the `RUNNING` state.
+            # You can use "-" as Environment ID in environment name to update version
+            # in "draft" environment. WARNING: this will negate all recent changes to
+            # draft and can't be undone. You may want to save the draft to a version
+            # before calling this function.
+            #
+            # @overload update_environment(request, options = nil)
+            #   Pass arguments to `update_environment` via a request object, either of type
+            #   {::Google::Cloud::Dialogflow::V2::UpdateEnvironmentRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Dialogflow::V2::UpdateEnvironmentRequest, ::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 update_environment(environment: nil, update_mask: nil, allow_load_to_draft_and_discard_changes: nil)
+            #   Pass arguments to `update_environment` 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 environment [::Google::Cloud::Dialogflow::V2::Environment, ::Hash]
+            #     Required. The environment to update.
+            #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
+            #     Required. The mask to control which fields get updated.
+            #   @param allow_load_to_draft_and_discard_changes [::Boolean]
+            #     Optional. This field is used to prevent accidental overwrite of the draft
+            #     environment, which is an operation that cannot be undone. To confirm that
+            #     the caller desires this overwrite, this field must be explicitly set to
+            #     true when updating the draft environment (environment ID = `-`).
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Google::Cloud::Dialogflow::V2::Environment]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Google::Cloud::Dialogflow::V2::Environment]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            def update_environment request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Dialogflow::V2::UpdateEnvironmentRequest
+
+              # 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.update_environment.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 \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::Dialogflow::V2::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {
+                "environment.name" => request.environment.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.update_environment.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.update_environment.retry_policy
+              options.apply_defaults metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @environments_stub.call_rpc :update_environment, 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
+
+            ##
+            # Deletes the specified agent environment.
+            #
+            # @overload delete_environment(request, options = nil)
+            #   Pass arguments to `delete_environment` via a request object, either of type
+            #   {::Google::Cloud::Dialogflow::V2::DeleteEnvironmentRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Dialogflow::V2::DeleteEnvironmentRequest, ::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 delete_environment(name: nil)
+            #   Pass arguments to `delete_environment` 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 environment to delete.
+            #     / Format:
+            #     - `projects/<Project ID>/agent/environments/<Environment ID>`
+            #     - `projects/<Project ID>/locations/<Location
+            #     ID>/agent/environments/<Environment ID>`
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Google::Protobuf::Empty]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Google::Protobuf::Empty]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            def delete_environment request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Dialogflow::V2::DeleteEnvironmentRequest
+
+              # 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.delete_environment.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 \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::Dialogflow::V2::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.delete_environment.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.delete_environment.retry_policy
+              options.apply_defaults metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @environments_stub.call_rpc :delete_environment, 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
+
+            ##
+            # Gets the history of the specified environment.
+            #
+            # @overload get_environment_history(request, options = nil)
+            #   Pass arguments to `get_environment_history` via a request object, either of type
+            #   {::Google::Cloud::Dialogflow::V2::GetEnvironmentHistoryRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Dialogflow::V2::GetEnvironmentHistoryRequest, ::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_environment_history(parent: nil, page_size: nil, page_token: nil)
+            #   Pass arguments to `get_environment_history` 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 parent [::String]
+            #     Required. The name of the environment to retrieve history for.
+            #     Supported formats:
+            #     - `projects/<Project ID>/agent/environments/<Environment ID>`
+            #     - `projects/<Project ID>/locations/<Location
+            #       ID>/agent/environments/<Environment ID>`
+            #   @param page_size [::Integer]
+            #     Optional. The maximum number of items to return in a single page. By default 100 and
+            #     at most 1000.
+            #   @param page_token [::String]
+            #     Optional. The next_page_token value returned from a previous list request.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Dialogflow::V2::EnvironmentHistory::Entry>]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Gapic::PagedEnumerable<::Google::Cloud::Dialogflow::V2::EnvironmentHistory::Entry>]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            def get_environment_history request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Dialogflow::V2::GetEnvironmentHistoryRequest
+
+              # 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_environment_history.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 \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::Dialogflow::V2::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {
+                "parent" => request.parent
+              }
+              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_environment_history.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.get_environment_history.retry_policy
+              options.apply_defaults metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @environments_stub.call_rpc :get_environment_history, request, options: options do |response, operation|
+                response = ::Gapic::PagedEnumerable.new @environments_stub, :get_environment_history, request, response, operation, options
+                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 Environments API.
             #
@@ -310,14 +691,14 @@ module Google
 
               config_attr :endpoint,      "dialogflow.googleapis.com", ::String
               config_attr :credentials,   nil do |value|
-                allowed = [::String, ::Hash, ::Proc, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
+                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(: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
@@ -338,7 +719,7 @@ module Google
               def rpcs
                 @rpcs ||= begin
                   parent_rpcs = nil
-                  parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config&.respond_to?(:rpcs)
+                  parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
                   Rpcs.new parent_rpcs
                 end
               end
@@ -350,7 +731,7 @@ module Google
               # Each configuration object is of type `Gapic::Config::Method` and includes
               # the following configuration fields:
               #
-              #  *  `timeout` (*type:* `Numeric`) - The call timeout in milliseconds
+              #  *  `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:
@@ -366,11 +747,46 @@ module Google
                 # @return [::Gapic::Config::Method]
                 #
                 attr_reader :list_environments
+                ##
+                # RPC-specific configuration for `get_environment`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :get_environment
+                ##
+                # RPC-specific configuration for `create_environment`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :create_environment
+                ##
+                # RPC-specific configuration for `update_environment`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :update_environment
+                ##
+                # RPC-specific configuration for `delete_environment`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :delete_environment
+                ##
+                # RPC-specific configuration for `get_environment_history`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :get_environment_history
 
                 # @private
                 def initialize parent_rpcs = nil
-                  list_environments_config = parent_rpcs&.list_environments if parent_rpcs&.respond_to? :list_environments
+                  list_environments_config = parent_rpcs.list_environments if parent_rpcs.respond_to? :list_environments
                   @list_environments = ::Gapic::Config::Method.new list_environments_config
+                  get_environment_config = parent_rpcs.get_environment if parent_rpcs.respond_to? :get_environment
+                  @get_environment = ::Gapic::Config::Method.new get_environment_config
+                  create_environment_config = parent_rpcs.create_environment if parent_rpcs.respond_to? :create_environment
+                  @create_environment = ::Gapic::Config::Method.new create_environment_config
+                  update_environment_config = parent_rpcs.update_environment if parent_rpcs.respond_to? :update_environment
+                  @update_environment = ::Gapic::Config::Method.new update_environment_config
+                  delete_environment_config = parent_rpcs.delete_environment if parent_rpcs.respond_to? :delete_environment
+                  @delete_environment = ::Gapic::Config::Method.new delete_environment_config
+                  get_environment_history_config = parent_rpcs.get_environment_history if parent_rpcs.respond_to? :get_environment_history
+                  @get_environment_history = ::Gapic::Config::Method.new get_environment_history_config
 
                   yield self if block_given?
                 end