google-cloud-dialogflow-v2 0.6.0 → 0.7.0

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

@@ -24,7 +24,7 @@ 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
@@ -34,7 +34,7 @@ module Google
             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
           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,17 +60,17 @@ 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
 
-                default_config.rpcs.list_environments.timeout = 60.0
-                default_config.rpcs.list_environments.retry_policy = {
+                default_config.timeout = 60.0
+                default_config.retry_policy = {
                   initial_delay: 0.1,
-                  max_delay:     60.0,
-                  multiplier:    1.3,
-                  retry_codes:   ["UNAVAILABLE", "INTERNAL"]
+                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
@@ -310,14 +316,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 +344,7 @@ module Google
               def rpcs
                 @rpcs ||= begin
                   parent_rpcs = nil
-                  parent_rpcs = @parent_config.rpcs if @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 +356,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:
@@ -369,7 +375,7 @@ module Google
 
                 # @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
 
                   yield self if block_given?

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

@@ -0,0 +1,20 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/dialogflow/v2/gcs.proto
+
+require 'google/protobuf'
+
+require 'google/api/field_behavior_pb'
+require 'google/api/annotations_pb'
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/cloud/dialogflow/v2/gcs.proto", :syntax => :proto3) do
+  end
+end
+
+module Google
+  module Cloud
+    module Dialogflow
+      module V2
+      end
+    end
+  end
+end

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

@@ -0,0 +1,26 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/dialogflow/v2/human_agent_assistant_event.proto
+
+require 'google/protobuf'
+
+require 'google/cloud/dialogflow/v2/participant_pb'
+require 'google/api/annotations_pb'
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/cloud/dialogflow/v2/human_agent_assistant_event.proto", :syntax => :proto3) do
+    add_message "google.cloud.dialogflow.v2.HumanAgentAssistantEvent" do
+      optional :conversation, :string, 1
+      optional :participant, :string, 3
+      repeated :suggestion_results, :message, 5, "google.cloud.dialogflow.v2.SuggestionResult"
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module Dialogflow
+      module V2
+        HumanAgentAssistantEvent = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.HumanAgentAssistantEvent").msgclass
+      end
+    end
+  end
+end

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

@@ -23,6 +23,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :priority, :int32, 3
       optional :is_fallback, :bool, 4
       optional :ml_disabled, :bool, 19
+      optional :live_agent_handoff, :bool, 20
+      optional :end_interaction, :bool, 21
       repeated :input_context_names, :string, 7
       repeated :events, :string, 8
       repeated :training_phrases, :message, 9, "google.cloud.dialogflow.v2.Intent.TrainingPhrase"

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

@@ -24,38 +24,7 @@ module Google
     module Dialogflow
       module V2
         module Intents
-          # An intent represents a mapping between input from a user and an action to
-          # be taken by your application. When you pass user input to the
-          # [DetectIntent][google.cloud.dialogflow.v2.Sessions.DetectIntent] (or
-          # [StreamingDetectIntent][google.cloud.dialogflow.v2.Sessions.StreamingDetectIntent]) method, the
-          # Dialogflow API analyzes the input and searches
-          # for a matching intent. If no match is found, the Dialogflow API returns a
-          # fallback intent (`is_fallback` = true).
-          #
-          # You can provide additional information for the Dialogflow API to use to
-          # match user input to an intent by adding the following to your intent.
-          #
-          # *   **Contexts** - provide additional context for intent analysis. For
-          #     example, if an intent is related to an object in your application that
-          #     plays music, you can provide a context to determine when to match the
-          #     intent if the user input is "turn it off". You can include a context
-          #     that matches the intent when there is previous user input of
-          #     "play music", and not when there is previous user input of
-          #     "turn on the light".
-          #
-          # *   **Events** - allow for matching an intent by using an event name
-          #     instead of user input. Your application can provide an event name and
-          #     related parameters to the Dialogflow API to match an intent. For
-          #     example, when your application starts, you can send a welcome event
-          #     with a user name parameter to the Dialogflow API to match an intent with
-          #     a personalized welcome message for the user.
-          #
-          # *   **Training phrases** - provide examples of user input to train the
-          #     Dialogflow API agent to better match intents.
-          #
-          # For more information about intents, see the
-          # [Dialogflow
-          # documentation](https://cloud.google.com/dialogflow/docs/intents-overview).
+          # Service for managing [Intents][google.cloud.dialogflow.v2.Intent].
           class Service
 
             include GRPC::GenericService
@@ -65,23 +34,23 @@ module Google
             self.service_name = 'google.cloud.dialogflow.v2.Intents'
 
             # Returns the list of all intents in the specified agent.
-            rpc :ListIntents, ListIntentsRequest, ListIntentsResponse
+            rpc :ListIntents, ::Google::Cloud::Dialogflow::V2::ListIntentsRequest, ::Google::Cloud::Dialogflow::V2::ListIntentsResponse
             # Retrieves the specified intent.
-            rpc :GetIntent, GetIntentRequest, Intent
+            rpc :GetIntent, ::Google::Cloud::Dialogflow::V2::GetIntentRequest, ::Google::Cloud::Dialogflow::V2::Intent
             # Creates an intent in the specified agent.
-            rpc :CreateIntent, CreateIntentRequest, Intent
+            rpc :CreateIntent, ::Google::Cloud::Dialogflow::V2::CreateIntentRequest, ::Google::Cloud::Dialogflow::V2::Intent
             # Updates the specified intent.
-            rpc :UpdateIntent, UpdateIntentRequest, Intent
+            rpc :UpdateIntent, ::Google::Cloud::Dialogflow::V2::UpdateIntentRequest, ::Google::Cloud::Dialogflow::V2::Intent
             # Deletes the specified intent and its direct or indirect followup intents.
-            rpc :DeleteIntent, DeleteIntentRequest, Google::Protobuf::Empty
+            rpc :DeleteIntent, ::Google::Cloud::Dialogflow::V2::DeleteIntentRequest, ::Google::Protobuf::Empty
             # Updates/Creates multiple intents in the specified agent.
             #
             # Operation <response: [BatchUpdateIntentsResponse][google.cloud.dialogflow.v2.BatchUpdateIntentsResponse]>
-            rpc :BatchUpdateIntents, BatchUpdateIntentsRequest, Google::Longrunning::Operation
+            rpc :BatchUpdateIntents, ::Google::Cloud::Dialogflow::V2::BatchUpdateIntentsRequest, ::Google::Longrunning::Operation
             # Deletes intents in the specified agent.
             #
             # Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
-            rpc :BatchDeleteIntents, BatchDeleteIntentsRequest, Google::Longrunning::Operation
+            rpc :BatchDeleteIntents, ::Google::Cloud::Dialogflow::V2::BatchDeleteIntentsRequest, ::Google::Longrunning::Operation
           end
 
           Stub = Service.rpc_stub_class

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

@@ -32,38 +32,7 @@ module Google
     module Dialogflow
       module V2
         ##
-        # An intent represents a mapping between input from a user and an action to
-        # be taken by your application. When you pass user input to the
-        # {::Google::Cloud::Dialogflow::V2::Sessions::Client#detect_intent DetectIntent} (or
-        # {::Google::Cloud::Dialogflow::V2::Sessions::Client#streaming_detect_intent StreamingDetectIntent}) method, the
-        # Dialogflow API analyzes the input and searches
-        # for a matching intent. If no match is found, the Dialogflow API returns a
-        # fallback intent (`is_fallback` = true).
-        #
-        # You can provide additional information for the Dialogflow API to use to
-        # match user input to an intent by adding the following to your intent.
-        #
-        # *   **Contexts** - provide additional context for intent analysis. For
-        #     example, if an intent is related to an object in your application that
-        #     plays music, you can provide a context to determine when to match the
-        #     intent if the user input is "turn it off". You can include a context
-        #     that matches the intent when there is previous user input of
-        #     "play music", and not when there is previous user input of
-        #     "turn on the light".
-        #
-        # *   **Events** - allow for matching an intent by using an event name
-        #     instead of user input. Your application can provide an event name and
-        #     related parameters to the Dialogflow API to match an intent. For
-        #     example, when your application starts, you can send a welcome event
-        #     with a user name parameter to the Dialogflow API to match an intent with
-        #     a personalized welcome message for the user.
-        #
-        # *   **Training phrases** - provide examples of user input to train the
-        #     Dialogflow API agent to better match intents.
-        #
-        # For more information about intents, see the
-        # [Dialogflow
-        # documentation](https://cloud.google.com/dialogflow/docs/intents-overview).
+        # Service for managing {::Google::Cloud::Dialogflow::V2::Intent Intents}.
         #
         # To load this service and instantiate a client:
         #

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

@@ -27,38 +27,7 @@ module Google
           ##
           # Client for the Intents service.
           #
-          # An intent represents a mapping between input from a user and an action to
-          # be taken by your application. When you pass user input to the
-          # {::Google::Cloud::Dialogflow::V2::Sessions::Client#detect_intent DetectIntent} (or
-          # {::Google::Cloud::Dialogflow::V2::Sessions::Client#streaming_detect_intent StreamingDetectIntent}) method, the
-          # Dialogflow API analyzes the input and searches
-          # for a matching intent. If no match is found, the Dialogflow API returns a
-          # fallback intent (`is_fallback` = true).
-          #
-          # You can provide additional information for the Dialogflow API to use to
-          # match user input to an intent by adding the following to your intent.
-          #
-          # *   **Contexts** - provide additional context for intent analysis. For
-          #     example, if an intent is related to an object in your application that
-          #     plays music, you can provide a context to determine when to match the
-          #     intent if the user input is "turn it off". You can include a context
-          #     that matches the intent when there is previous user input of
-          #     "play music", and not when there is previous user input of
-          #     "turn on the light".
-          #
-          # *   **Events** - allow for matching an intent by using an event name
-          #     instead of user input. Your application can provide an event name and
-          #     related parameters to the Dialogflow API to match an intent. For
-          #     example, when your application starts, you can send a welcome event
-          #     with a user name parameter to the Dialogflow API to match an intent with
-          #     a personalized welcome message for the user.
-          #
-          # *   **Training phrases** - provide examples of user input to train the
-          #     Dialogflow API agent to better match intents.
-          #
-          # For more information about intents, see the
-          # [Dialogflow
-          # documentation](https://cloud.google.com/dialogflow/docs/intents-overview).
+          # Service for managing {::Google::Cloud::Dialogflow::V2::Intent Intents}.
           #
           class Client
             include Paths
@@ -91,47 +60,17 @@ 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
 
-                default_config.rpcs.list_intents.timeout = 60.0
-                default_config.rpcs.list_intents.retry_policy = {
-                  initial_delay: 0.1,
-                  max_delay:     60.0,
-                  multiplier:    1.3,
-                  retry_codes:   ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
-                }
-
-                default_config.rpcs.get_intent.timeout = 60.0
-                default_config.rpcs.get_intent.retry_policy = {
-                  initial_delay: 0.1,
-                  max_delay:     60.0,
-                  multiplier:    1.3,
-                  retry_codes:   ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
-                }
-
-                default_config.rpcs.create_intent.timeout = 60.0
-
-                default_config.rpcs.update_intent.timeout = 60.0
-
-                default_config.rpcs.delete_intent.timeout = 60.0
-                default_config.rpcs.delete_intent.retry_policy = {
-                  initial_delay: 0.1,
-                  max_delay:     60.0,
-                  multiplier:    1.3,
-                  retry_codes:   ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
-                }
-
-                default_config.rpcs.batch_update_intents.timeout = 60.0
-
-                default_config.rpcs.batch_delete_intents.timeout = 60.0
-                default_config.rpcs.batch_delete_intents.retry_policy = {
+                default_config.timeout = 60.0
+                default_config.retry_policy = {
                   initial_delay: 0.1,
-                  max_delay:     60.0,
-                  multiplier:    1.3,
-                  retry_codes:   ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
+                max_delay: 60.0,
+                multiplier: 1.3,
+                retry_codes: [14]
                 }
 
                 default_config
@@ -195,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
@@ -846,14 +791,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
@@ -874,7 +819,7 @@ module Google
               def rpcs
                 @rpcs ||= begin
                   parent_rpcs = nil
-                  parent_rpcs = @parent_config.rpcs if @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
@@ -886,7 +831,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:
@@ -935,19 +880,19 @@ module Google
 
                 # @private
                 def initialize parent_rpcs = nil
-                  list_intents_config = parent_rpcs&.list_intents if parent_rpcs&.respond_to? :list_intents
+                  list_intents_config = parent_rpcs.list_intents if parent_rpcs.respond_to? :list_intents
                   @list_intents = ::Gapic::Config::Method.new list_intents_config
-                  get_intent_config = parent_rpcs&.get_intent if parent_rpcs&.respond_to? :get_intent
+                  get_intent_config = parent_rpcs.get_intent if parent_rpcs.respond_to? :get_intent
                   @get_intent = ::Gapic::Config::Method.new get_intent_config
-                  create_intent_config = parent_rpcs&.create_intent if parent_rpcs&.respond_to? :create_intent
+                  create_intent_config = parent_rpcs.create_intent if parent_rpcs.respond_to? :create_intent
                   @create_intent = ::Gapic::Config::Method.new create_intent_config
-                  update_intent_config = parent_rpcs&.update_intent if parent_rpcs&.respond_to? :update_intent
+                  update_intent_config = parent_rpcs.update_intent if parent_rpcs.respond_to? :update_intent
                   @update_intent = ::Gapic::Config::Method.new update_intent_config
-                  delete_intent_config = parent_rpcs&.delete_intent if parent_rpcs&.respond_to? :delete_intent
+                  delete_intent_config = parent_rpcs.delete_intent if parent_rpcs.respond_to? :delete_intent
                   @delete_intent = ::Gapic::Config::Method.new delete_intent_config
-                  batch_update_intents_config = parent_rpcs&.batch_update_intents if parent_rpcs&.respond_to? :batch_update_intents
+                  batch_update_intents_config = parent_rpcs.batch_update_intents if parent_rpcs.respond_to? :batch_update_intents
                   @batch_update_intents = ::Gapic::Config::Method.new batch_update_intents_config
-                  batch_delete_intents_config = parent_rpcs&.batch_delete_intents if parent_rpcs&.respond_to? :batch_delete_intents
+                  batch_delete_intents_config = parent_rpcs.batch_delete_intents if parent_rpcs.respond_to? :batch_delete_intents
                   @batch_delete_intents = ::Gapic::Config::Method.new batch_delete_intents_config
 
                   yield self if block_given?