google-cloud-dialogflow 0.2.3 → 0.3.0

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

@@ -5,8 +5,10 @@
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'
+require 'google/api/resource_pb'
 require 'google/cloud/dialogflow/v2/context_pb'
 require 'google/longrunning/operations_pb'
+require 'google/protobuf/duration_pb'
 require 'google/protobuf/empty_pb'
 require 'google/protobuf/field_mask_pb'
 require 'google/protobuf/struct_pb'

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

@@ -1,7 +1,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # Source: google/cloud/dialogflow/v2/intent.proto for package 'google.cloud.dialogflow.v2'
 # Original file comments:
-# Copyright 2018 Google Inc.
+# Copyright 2019 Google LLC.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -15,6 +15,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
+#
 
 
 require 'grpc'
@@ -39,7 +40,7 @@ module Google
           # *   **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
+          #     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".
@@ -55,7 +56,8 @@ module Google
           #     Dialogflow API agent to better match intents.
           #
           # For more information about intents, see the
-          # [Dialogflow documentation](https://dialogflow.com/docs/intents).
+          # [Dialogflow
+          # documentation](https://cloud.google.com/dialogflow-enterprise/docs/intents-overview).
           class Service
 
             include GRPC::GenericService
@@ -72,7 +74,7 @@ module Google
             rpc :CreateIntent, CreateIntentRequest, Intent
             # Updates the specified intent.
             rpc :UpdateIntent, UpdateIntentRequest, Intent
-            # Deletes the specified intent.
+            # Deletes the specified intent and its direct or indirect followup intents.
             rpc :DeleteIntent, DeleteIntentRequest, Google::Protobuf::Empty
             # Updates/Creates multiple intents in the specified agent.
             #

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

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -48,7 +48,7 @@ module Google
         # * **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
+        #   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".
@@ -64,7 +64,8 @@ module Google
         #   Dialogflow API agent to better match intents.
         #
         # For more information about intents, see the
-        # [Dialogflow documentation](https://dialogflow.com/docs/intents).
+        # [Dialogflow
+        # documentation](https://cloud.google.com/dialogflow-enterprise/docs/intents-overview).
         #
         # @!attribute [r] intents_stub
         #   @return [Google::Cloud::Dialogflow::V2::Intents::Stub]
@@ -95,7 +96,8 @@ module Google
           # The scopes needed to make gRPC calls to all of the methods defined in
           # this service.
           ALL_SCOPES = [
-            "https://www.googleapis.com/auth/cloud-platform"
+            "https://www.googleapis.com/auth/cloud-platform",
+            "https://www.googleapis.com/auth/dialogflow"
           ].freeze
 
           # @private
@@ -104,11 +106,11 @@ module Google
             self::GRPC_INTERCEPTORS = IntentsClient::GRPC_INTERCEPTORS
           end
 
-          PROJECT_AGENT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
-            "projects/{project}/agent"
+          AGENT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
+            "projects/{project}/agents/{agent}"
           )
 
-          private_constant :PROJECT_AGENT_PATH_TEMPLATE
+          private_constant :AGENT_PATH_TEMPLATE
 
           INTENT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
             "projects/{project}/agent/intents/{intent}"
@@ -116,18 +118,20 @@ module Google
 
           private_constant :INTENT_PATH_TEMPLATE
 
-          AGENT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
-            "projects/{project}/agents/{agent}"
+          PROJECT_AGENT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
+            "projects/{project}/agent"
           )
 
-          private_constant :AGENT_PATH_TEMPLATE
+          private_constant :PROJECT_AGENT_PATH_TEMPLATE
 
-          # Returns a fully-qualified project_agent resource name string.
+          # Returns a fully-qualified agent resource name string.
           # @param project [String]
+          # @param agent [String]
           # @return [String]
-          def self.project_agent_path project
-            PROJECT_AGENT_PATH_TEMPLATE.render(
-              :"project" => project
+          def self.agent_path project, agent
+            AGENT_PATH_TEMPLATE.render(
+              :"project" => project,
+              :"agent" => agent
             )
           end
 
@@ -142,14 +146,12 @@ module Google
             )
           end
 
-          # Returns a fully-qualified agent resource name string.
+          # Returns a fully-qualified project_agent resource name string.
           # @param project [String]
-          # @param agent [String]
           # @return [String]
-          def self.agent_path project, agent
-            AGENT_PATH_TEMPLATE.render(
-              :"project" => project,
-              :"agent" => agent
+          def self.project_agent_path project
+            PROJECT_AGENT_PATH_TEMPLATE.render(
+              :"project" => project
             )
           end
 
@@ -268,37 +270,58 @@ module Google
             @list_intents = Google::Gax.create_api_call(
               @intents_stub.method(:list_intents),
               defaults["list_intents"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
             )
             @get_intent = Google::Gax.create_api_call(
               @intents_stub.method(:get_intent),
               defaults["get_intent"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
             )
             @create_intent = Google::Gax.create_api_call(
               @intents_stub.method(:create_intent),
               defaults["create_intent"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
             )
             @update_intent = Google::Gax.create_api_call(
               @intents_stub.method(:update_intent),
               defaults["update_intent"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'intent.name' => request.intent.name}
+              end
             )
             @delete_intent = Google::Gax.create_api_call(
               @intents_stub.method(:delete_intent),
               defaults["delete_intent"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
             )
             @batch_update_intents = Google::Gax.create_api_call(
               @intents_stub.method(:batch_update_intents),
               defaults["batch_update_intents"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
             )
             @batch_delete_intents = Google::Gax.create_api_call(
               @intents_stub.method(:batch_delete_intents),
               defaults["batch_delete_intents"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
             )
           end
 
@@ -312,9 +335,10 @@ module Google
           # @param language_code [String]
           #   Optional. The language to list training phrases, parameters and rich
           #   messages for. If not specified, the agent's default language is used.
-          #   [More than a dozen
-          #   languages](https://dialogflow.com/docs/reference/language) are supported.
-          #   Note: languages must be enabled in the agent before they can be used.
+          #   [Many
+          #   languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+          #   are supported. Note: languages must be enabled in the agent before they can
+          #   be used.
           # @param intent_view [Google::Cloud::Dialogflow::V2::IntentView]
           #   Optional. The resource view to apply to the returned intent.
           # @param page_size [Integer]
@@ -379,9 +403,10 @@ module Google
           # @param language_code [String]
           #   Optional. The language to retrieve training phrases, parameters and rich
           #   messages for. If not specified, the agent's default language is used.
-          #   [More than a dozen
-          #   languages](https://dialogflow.com/docs/reference/language) are supported.
-          #   Note: languages must be enabled in the agent, before they can be used.
+          #   [Many
+          #   languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+          #   are supported. Note: languages must be enabled in the agent before they can
+          #   be used.
           # @param intent_view [Google::Cloud::Dialogflow::V2::IntentView]
           #   Optional. The resource view to apply to the returned intent.
           # @param options [Google::Gax::CallOptions]
@@ -426,9 +451,10 @@ module Google
           # @param language_code [String]
           #   Optional. The language of training phrases, parameters and rich messages
           #   defined in `intent`. If not specified, the agent's default language is
-          #   used. [More than a dozen
-          #   languages](https://dialogflow.com/docs/reference/language) are supported.
-          #   Note: languages must be enabled in the agent, before they can be used.
+          #   used. [Many
+          #   languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+          #   are supported. Note: languages must be enabled in the agent before they can
+          #   be used.
           # @param intent_view [Google::Cloud::Dialogflow::V2::IntentView]
           #   Optional. The resource view to apply to the returned intent.
           # @param options [Google::Gax::CallOptions]
@@ -470,15 +496,15 @@ module Google
           #
           # @param intent [Google::Cloud::Dialogflow::V2::Intent | Hash]
           #   Required. The intent to update.
-          #   Format: `projects/<Project ID>/agent/intents/<Intent ID>`.
           #   A hash of the same form as `Google::Cloud::Dialogflow::V2::Intent`
           #   can also be provided.
           # @param language_code [String]
           #   Optional. The language of training phrases, parameters and rich messages
           #   defined in `intent`. If not specified, the agent's default language is
-          #   used. [More than a dozen
-          #   languages](https://dialogflow.com/docs/reference/language) are supported.
-          #   Note: languages must be enabled in the agent, before they can be used.
+          #   used. [Many
+          #   languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+          #   are supported. Note: languages must be enabled in the agent before they can
+          #   be used.
           # @param update_mask [Google::Protobuf::FieldMask | Hash]
           #   Optional. The mask to control which fields get updated.
           #   A hash of the same form as `Google::Protobuf::FieldMask`
@@ -522,10 +548,11 @@ module Google
             @update_intent.call(req, options, &block)
           end
 
-          # Deletes the specified intent.
+          # Deletes the specified intent and its direct or indirect followup intents.
           #
           # @param name [String]
-          #   Required. The name of the intent to delete.
+          #   Required. The name of the intent to delete. If this intent has direct or
+          #   indirect followup intents, we also delete them.
           #   Format: `projects/<Project ID>/agent/intents/<Intent ID>`.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
@@ -563,9 +590,10 @@ module Google
           # @param language_code [String]
           #   Optional. The language of training phrases, parameters and rich messages
           #   defined in `intents`. If not specified, the agent's default language is
-          #   used. [More than a dozen
-          #   languages](https://dialogflow.com/docs/reference/language) are supported.
-          #   Note: languages must be enabled in the agent, before they can be used.
+          #   used. [Many
+          #   languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+          #   are supported. Note: languages must be enabled in the agent before they can
+          #   be used.
           # @param intent_batch_uri [String]
           #   The URI to a Google Cloud Storage file containing intents to update or
           #   create. The file format can either be a serialized proto (of IntentBatch

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

@@ -5,6 +5,7 @@
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'
+require 'google/api/resource_pb'
 require 'google/cloud/dialogflow/v2/entity_type_pb'
 require 'google/protobuf/empty_pb'
 require 'google/protobuf/field_mask_pb'

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

@@ -1,7 +1,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # Source: google/cloud/dialogflow/v2/session_entity_type.proto for package 'google.cloud.dialogflow.v2'
 # Original file comments:
-# Copyright 2018 Google Inc.
+# Copyright 2019 Google LLC.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -15,6 +15,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
+#
 
 
 require 'grpc'
@@ -36,7 +37,8 @@ module Google
           # entity type at the session level.
           #
           # For more information about entity types, see the
-          # [Dialogflow documentation](https://dialogflow.com/docs/entities).
+          # [Dialogflow
+          # documentation](https://cloud.google.com/dialogflow-enterprise/docs/entities-overview).
           class Service
 
             include GRPC::GenericService
@@ -50,6 +52,9 @@ module Google
             # Retrieves the specified session entity type.
             rpc :GetSessionEntityType, GetSessionEntityTypeRequest, SessionEntityType
             # Creates a session entity type.
+            #
+            # If the specified session entity type already exists, overrides the session
+            # entity type.
             rpc :CreateSessionEntityType, CreateSessionEntityTypeRequest, SessionEntityType
             # Updates the specified session entity type.
             rpc :UpdateSessionEntityType, UpdateSessionEntityTypeRequest, SessionEntityType

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

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -43,7 +43,8 @@ module Google
         # entity type at the session level.
         #
         # For more information about entity types, see the
-        # [Dialogflow documentation](https://dialogflow.com/docs/entities).
+        # [Dialogflow
+        # documentation](https://cloud.google.com/dialogflow-enterprise/docs/entities-overview).
         #
         # @!attribute [r] session_entity_types_stub
         #   @return [Google::Cloud::Dialogflow::V2::SessionEntityTypes::Stub]
@@ -74,7 +75,8 @@ module Google
           # The scopes needed to make gRPC calls to all of the methods defined in
           # this service.
           ALL_SCOPES = [
-            "https://www.googleapis.com/auth/cloud-platform"
+            "https://www.googleapis.com/auth/cloud-platform",
+            "https://www.googleapis.com/auth/dialogflow"
           ].freeze
 
 
@@ -220,27 +222,42 @@ module Google
             @list_session_entity_types = Google::Gax.create_api_call(
               @session_entity_types_stub.method(:list_session_entity_types),
               defaults["list_session_entity_types"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
             )
             @get_session_entity_type = Google::Gax.create_api_call(
               @session_entity_types_stub.method(:get_session_entity_type),
               defaults["get_session_entity_type"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
             )
             @create_session_entity_type = Google::Gax.create_api_call(
               @session_entity_types_stub.method(:create_session_entity_type),
               defaults["create_session_entity_type"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
             )
             @update_session_entity_type = Google::Gax.create_api_call(
               @session_entity_types_stub.method(:update_session_entity_type),
               defaults["update_session_entity_type"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'session_entity_type.name' => request.session_entity_type.name}
+              end
             )
             @delete_session_entity_type = Google::Gax.create_api_call(
               @session_entity_types_stub.method(:delete_session_entity_type),
               defaults["delete_session_entity_type"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
             )
           end
 
@@ -335,6 +352,9 @@ module Google
 
           # Creates a session entity type.
           #
+          # If the specified session entity type already exists, overrides the session
+          # entity type.
+          #
           # @param parent [String]
           #   Required. The session to create a session entity type for.
           #   Format: `projects/<Project ID>/agent/sessions/<Session ID>`.

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

@@ -5,6 +5,8 @@
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'
+require 'google/api/resource_pb'
+require 'google/cloud/dialogflow/v2/audio_config_pb'
 require 'google/cloud/dialogflow/v2/context_pb'
 require 'google/cloud/dialogflow/v2/intent_pb'
 require 'google/cloud/dialogflow/v2/session_entity_type_pb'
@@ -16,12 +18,15 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :session, :string, 1
     optional :query_params, :message, 2, "google.cloud.dialogflow.v2.QueryParameters"
     optional :query_input, :message, 3, "google.cloud.dialogflow.v2.QueryInput"
+    optional :output_audio_config, :message, 4, "google.cloud.dialogflow.v2.OutputAudioConfig"
     optional :input_audio, :bytes, 5
   end
   add_message "google.cloud.dialogflow.v2.DetectIntentResponse" do
     optional :response_id, :string, 1
     optional :query_result, :message, 2, "google.cloud.dialogflow.v2.QueryResult"
     optional :webhook_status, :message, 3, "google.rpc.Status"
+    optional :output_audio, :bytes, 4
+    optional :output_audio_config, :message, 6, "google.cloud.dialogflow.v2.OutputAudioConfig"
   end
   add_message "google.cloud.dialogflow.v2.QueryParameters" do
     optional :time_zone, :string, 1
@@ -30,6 +35,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :reset_contexts, :bool, 4
     repeated :session_entity_types, :message, 5, "google.cloud.dialogflow.v2.SessionEntityType"
     optional :payload, :message, 6, "google.protobuf.Struct"
+    optional :sentiment_analysis_request_config, :message, 10, "google.cloud.dialogflow.v2.SentimentAnalysisRequestConfig"
   end
   add_message "google.cloud.dialogflow.v2.QueryInput" do
     oneof :input do
@@ -53,12 +59,14 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :intent, :message, 11, "google.cloud.dialogflow.v2.Intent"
     optional :intent_detection_confidence, :float, 12
     optional :diagnostic_info, :message, 14, "google.protobuf.Struct"
+    optional :sentiment_analysis_result, :message, 17, "google.cloud.dialogflow.v2.SentimentAnalysisResult"
   end
   add_message "google.cloud.dialogflow.v2.StreamingDetectIntentRequest" do
     optional :session, :string, 1
     optional :query_params, :message, 2, "google.cloud.dialogflow.v2.QueryParameters"
     optional :query_input, :message, 3, "google.cloud.dialogflow.v2.QueryInput"
     optional :single_utterance, :bool, 4
+    optional :output_audio_config, :message, 5, "google.cloud.dialogflow.v2.OutputAudioConfig"
     optional :input_audio, :bytes, 6
   end
   add_message "google.cloud.dialogflow.v2.StreamingDetectIntentResponse" do
@@ -66,6 +74,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :recognition_result, :message, 2, "google.cloud.dialogflow.v2.StreamingRecognitionResult"
     optional :query_result, :message, 3, "google.cloud.dialogflow.v2.QueryResult"
     optional :webhook_status, :message, 4, "google.rpc.Status"
+    optional :output_audio, :bytes, 5
+    optional :output_audio_config, :message, 6, "google.cloud.dialogflow.v2.OutputAudioConfig"
   end
   add_message "google.cloud.dialogflow.v2.StreamingRecognitionResult" do
     optional :message_type, :enum, 1, "google.cloud.dialogflow.v2.StreamingRecognitionResult.MessageType"
@@ -93,6 +103,16 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :parameters, :message, 2, "google.protobuf.Struct"
     optional :language_code, :string, 3
   end
+  add_message "google.cloud.dialogflow.v2.SentimentAnalysisRequestConfig" do
+    optional :analyze_query_text_sentiment, :bool, 1
+  end
+  add_message "google.cloud.dialogflow.v2.SentimentAnalysisResult" do
+    optional :query_text_sentiment, :message, 1, "google.cloud.dialogflow.v2.Sentiment"
+  end
+  add_message "google.cloud.dialogflow.v2.Sentiment" do
+    optional :score, :float, 1
+    optional :magnitude, :float, 2
+  end
   add_enum "google.cloud.dialogflow.v2.AudioEncoding" do
     value :AUDIO_ENCODING_UNSPECIFIED, 0
     value :AUDIO_ENCODING_LINEAR_16, 1
@@ -121,6 +141,9 @@ module Google
         InputAudioConfig = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.InputAudioConfig").msgclass
         TextInput = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.TextInput").msgclass
         EventInput = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.EventInput").msgclass
+        SentimentAnalysisRequestConfig = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.SentimentAnalysisRequestConfig").msgclass
+        SentimentAnalysisResult = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.SentimentAnalysisResult").msgclass
+        Sentiment = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.Sentiment").msgclass
         AudioEncoding = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.AudioEncoding").enummodule
       end
     end