google-cloud-dialogflow 0.4.0 → 0.5.0

data/lib/google/cloud/dialogflow/v2/doc/google/cloud/dialogflow/v2/intent.rb

@@ -217,7 +217,7 @@ module Google
           # @!attribute [rw] prompts
           #   @return [Array<String>]
           #     Optional. The collection of prompts that the agent can present to the
-          #     user in order to collect value for the parameter.
+          #     user in order to collect a value for the parameter.
           # @!attribute [rw] is_list
           #   @return [true, false]
           #     Optional. Indicates whether the parameter represents a list of values.
@@ -580,7 +580,7 @@ module Google
         #     Optional. The language to list training phrases, parameters and rich
         #     messages for. If not specified, the agent's default language is used.
         #     [Many
-        #     languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+        #     languages](https://cloud.google.com/dialogflow/docs/reference/language)
         #     are supported. Note: languages must be enabled in the agent before they can
         #     be used.
         # @!attribute [rw] intent_view
@@ -616,7 +616,7 @@ module Google
         #     Optional. The language to retrieve training phrases, parameters and rich
         #     messages for. If not specified, the agent's default language is used.
         #     [Many
-        #     languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+        #     languages](https://cloud.google.com/dialogflow/docs/reference/language)
         #     are supported. Note: languages must be enabled in the agent before they can
         #     be used.
         # @!attribute [rw] intent_view
@@ -637,7 +637,7 @@ module Google
         #     Optional. The language of training phrases, parameters and rich messages
         #     defined in `intent`. If not specified, the agent's default language is
         #     used. [Many
-        #     languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+        #     languages](https://cloud.google.com/dialogflow/docs/reference/language)
         #     are supported. Note: languages must be enabled in the agent before they can
         #     be used.
         # @!attribute [rw] intent_view
@@ -654,7 +654,7 @@ module Google
         #     Optional. The language of training phrases, parameters and rich messages
         #     defined in `intent`. If not specified, the agent's default language is
         #     used. [Many
-        #     languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+        #     languages](https://cloud.google.com/dialogflow/docs/reference/language)
         #     are supported. Note: languages must be enabled in the agent before they can
         #     be used.
         # @!attribute [rw] update_mask
@@ -691,7 +691,7 @@ module Google
         #     Optional. The language of training phrases, parameters and rich messages
         #     defined in `intents`. If not specified, the agent's default language is
         #     used. [Many
-        #     languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+        #     languages](https://cloud.google.com/dialogflow/docs/reference/language)
         #     are supported. Note: languages must be enabled in the agent before they can
         #     be used.
         # @!attribute [rw] update_mask

data/lib/google/cloud/dialogflow/v2/doc/google/cloud/dialogflow/v2/session.rb

@@ -143,7 +143,7 @@ module Google
         #   @return [String]
         #     The language that was triggered during intent detection.
         #     See [Language
-        #     Support](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+        #     Support](https://cloud.google.com/dialogflow/docs/reference/language)
         #     for a list of the currently supported language codes.
         # @!attribute [rw] speech_recognition_confidence
         #   @return [Float]
@@ -228,7 +228,7 @@ module Google
         #   @return [String]
         #     Required. The name of the session the query is sent to.
         #     Format of the session name:
-        #     `projects/<Project ID>/agent/sessions/<Session ID>`. It’s up to the API
+        #     `projects/<Project ID>/agent/sessions/<Session ID>`. It's up to the API
         #     caller to choose an appropriate `Session ID`. It can be a random number or
         #     some type of user identifier (preferably hashed). The length of the session
         #     ID must not exceed 36 characters.
@@ -295,11 +295,14 @@ module Google
         # @!attribute [rw] output_audio
         #   @return [String]
         #     The audio data bytes encoded as specified in the request.
+        #     Note: The output audio is generated based on the values of default platform
+        #     text responses found in the `query_result.fulfillment_messages` field. If
+        #     multiple default text responses exist, they will be concatenated when
+        #     generating audio. If no default platform text responses exist, the
+        #     generated audio content will be empty.
         # @!attribute [rw] output_audio_config
         #   @return [Google::Cloud::Dialogflow::V2::OutputAudioConfig]
-        #     Instructs the speech synthesizer how to generate the output audio. This
-        #     field is populated from the agent-level speech synthesizer configuration,
-        #     if enabled.
+        #     The config used by the speech synthesizer to generate the output audio.
         class StreamingDetectIntentResponse; end
 
         # Contains a speech recognition result corresponding to a portion of the audio
@@ -367,12 +370,12 @@ module Google
             TRANSCRIPT = 1
 
             # Event indicates that the server has detected the end of the user's speech
-            # utterance and expects no additional speech. Therefore, the server will
-            # not process additional audio (although it may subsequently return
-            # additional results). The client should stop sending additional audio
-            # data, half-close the gRPC connection, and wait for any additional results
-            # until the server closes the gRPC connection. This message is only sent if
-            # `single_utterance` was set to `true`, and is not used otherwise.
+            # utterance and expects no additional inputs.
+            # Therefore, the server will not process additional audio (although it may subsequently return additional results). The
+            # client should stop sending additional audio data, half-close the gRPC
+            # connection, and wait for any additional results until the server closes
+            # the gRPC connection. This message is only sent if `single_utterance` was
+            # set to `true`, and is not used otherwise.
             END_OF_SINGLE_UTTERANCE = 2
           end
         end
@@ -385,7 +388,7 @@ module Google
         # @!attribute [rw] language_code
         #   @return [String]
         #     Required. The language of this conversational query. See [Language
-        #     Support](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+        #     Support](https://cloud.google.com/dialogflow/docs/reference/language)
         #     for a list of the currently supported language codes. Note that queries in
         #     the same session do not necessarily need to specify the same language.
         class TextInput; end
@@ -404,7 +407,7 @@ module Google
         # @!attribute [rw] language_code
         #   @return [String]
         #     Required. The language of this query. See [Language
-        #     Support](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+        #     Support](https://cloud.google.com/dialogflow/docs/reference/language)
         #     for a list of the currently supported language codes. Note that queries in
         #     the same session do not necessarily need to specify the same language.
         class EventInput; end

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

@@ -8,7 +8,7 @@ require 'google/api/annotations_pb'
 require 'google/longrunning/operations_pb'
 require 'google/protobuf/empty_pb'
 require 'google/protobuf/field_mask_pb'
-require 'google/protobuf/struct_pb'
+require 'google/api/client_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.cloud.dialogflow.v2.EntityType" do
     optional :name, :string, 1

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

@@ -53,7 +53,7 @@ module Google
           #
           # For more information about entity types, see the
           # [Dialogflow
-          # documentation](https://cloud.google.com/dialogflow-enterprise/docs/entities-overview).
+          # documentation](https://cloud.google.com/dialogflow/docs/entities-overview).
           class Service
 
             include GRPC::GenericService

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

@@ -62,7 +62,7 @@ module Google
         #
         # For more information about entity types, see the
         # [Dialogflow
-        # documentation](https://cloud.google.com/dialogflow-enterprise/docs/entities-overview).
+        # documentation](https://cloud.google.com/dialogflow/docs/entities-overview).
         #
         # @!attribute [r] entity_types_stub
         #   @return [Google::Cloud::Dialogflow::V2::EntityTypes::Stub]
@@ -161,6 +161,10 @@ module Google
           #   The default timeout, in seconds, for calls made through this client.
           # @param metadata [Hash]
           #   Default metadata to be sent with each request. This can be overridden on a per call basis.
+          # @param service_address [String]
+          #   Override for the service hostname, or `nil` to leave as the default.
+          # @param service_port [Integer]
+          #   Override for the service port, or `nil` to leave as the default.
           # @param exception_transformer [Proc]
           #   An optional proc that intercepts any exceptions raised during an API call to inject
           #   custom error handling.
@@ -170,6 +174,8 @@ module Google
               client_config: {},
               timeout: DEFAULT_TIMEOUT,
               metadata: nil,
+              service_address: nil,
+              service_port: nil,
               exception_transformer: nil,
               lib_name: nil,
               lib_version: ""
@@ -187,7 +193,10 @@ module Google
               client_config: client_config,
               timeout: timeout,
               lib_name: lib_name,
+              service_address: service_address,
+              service_port: service_port,
               lib_version: lib_version,
+              metadata: metadata,
             )
 
             if credentials.is_a?(String) || credentials.is_a?(Hash)
@@ -233,8 +242,8 @@ module Google
             end
 
             # Allow overriding the service path/port in subclasses.
-            service_path = self.class::SERVICE_ADDRESS
-            port = self.class::DEFAULT_SERVICE_PORT
+            service_path = service_address || self.class::SERVICE_ADDRESS
+            port = service_port || self.class::DEFAULT_SERVICE_PORT
             interceptors = self.class::GRPC_INTERCEPTORS
             @entity_types_stub = Google::Gax::Grpc.create_stub(
               service_path,
@@ -340,7 +349,7 @@ module Google
           #   Optional. The language to list entity synonyms for. If not specified,
           #   the agent's default language is used.
           #   [Many
-          #   languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+          #   languages](https://cloud.google.com/dialogflow/docs/reference/language)
           #   are supported. Note: languages must be enabled in the agent before they can
           #   be used.
           # @param page_size [Integer]
@@ -404,7 +413,7 @@ module Google
           #   Optional. The language to retrieve entity synonyms for. If not specified,
           #   the agent's default language is used.
           #   [Many
-          #   languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+          #   languages](https://cloud.google.com/dialogflow/docs/reference/language)
           #   are supported. Note: languages must be enabled in the agent before they can
           #   be used.
           # @param options [Google::Gax::CallOptions]
@@ -448,7 +457,7 @@ module Google
           #   Optional. The language of entity synonyms defined in `entity_type`. If not
           #   specified, the agent's default language is used.
           #   [Many
-          #   languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+          #   languages](https://cloud.google.com/dialogflow/docs/reference/language)
           #   are supported. Note: languages must be enabled in the agent before they can
           #   be used.
           # @param options [Google::Gax::CallOptions]
@@ -494,7 +503,7 @@ module Google
           #   Optional. The language of entity synonyms defined in `entity_type`. If not
           #   specified, the agent's default language is used.
           #   [Many
-          #   languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+          #   languages](https://cloud.google.com/dialogflow/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]
@@ -584,7 +593,7 @@ module Google
           #   Optional. The language of entity synonyms defined in `entity_types`. If not
           #   specified, the agent's default language is used.
           #   [Many
-          #   languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+          #   languages](https://cloud.google.com/dialogflow/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]
@@ -741,7 +750,7 @@ module Google
           #   Optional. The language of entity synonyms defined in `entities`. If not
           #   specified, the agent's default language is used.
           #   [Many
-          #   languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+          #   languages](https://cloud.google.com/dialogflow/docs/reference/language)
           #   are supported. Note: languages must be enabled in the agent before they can
           #   be used.
           # @param options [Google::Gax::CallOptions]
@@ -824,7 +833,7 @@ module Google
           #   Optional. The language of entity synonyms defined in `entities`. If not
           #   specified, the agent's default language is used.
           #   [Many
-          #   languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+          #   languages](https://cloud.google.com/dialogflow/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]
@@ -911,7 +920,7 @@ module Google
           #   Optional. The language of entity synonyms defined in `entities`. If not
           #   specified, the agent's default language is used.
           #   [Many
-          #   languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+          #   languages](https://cloud.google.com/dialogflow/docs/reference/language)
           #   are supported. Note: languages must be enabled in the agent before they can
           #   be used.
           # @param options [Google::Gax::CallOptions]

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

@@ -5,12 +5,14 @@
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'
+require 'google/cloud/dialogflow/v2/audio_config_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'
+require 'google/api/client_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.cloud.dialogflow.v2.Intent" do
     optional :name, :string, 1

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

@@ -57,7 +57,7 @@ module Google
           #
           # For more information about intents, see the
           # [Dialogflow
-          # documentation](https://cloud.google.com/dialogflow-enterprise/docs/intents-overview).
+          # documentation](https://cloud.google.com/dialogflow/docs/intents-overview).
           class Service
 
             include GRPC::GenericService

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

@@ -66,7 +66,7 @@ module Google
         #
         # For more information about intents, see the
         # [Dialogflow
-        # documentation](https://cloud.google.com/dialogflow-enterprise/docs/intents-overview).
+        # documentation](https://cloud.google.com/dialogflow/docs/intents-overview).
         #
         # @!attribute [r] intents_stub
         #   @return [Google::Cloud::Dialogflow::V2::Intents::Stub]
@@ -182,6 +182,10 @@ module Google
           #   The default timeout, in seconds, for calls made through this client.
           # @param metadata [Hash]
           #   Default metadata to be sent with each request. This can be overridden on a per call basis.
+          # @param service_address [String]
+          #   Override for the service hostname, or `nil` to leave as the default.
+          # @param service_port [Integer]
+          #   Override for the service port, or `nil` to leave as the default.
           # @param exception_transformer [Proc]
           #   An optional proc that intercepts any exceptions raised during an API call to inject
           #   custom error handling.
@@ -191,6 +195,8 @@ module Google
               client_config: {},
               timeout: DEFAULT_TIMEOUT,
               metadata: nil,
+              service_address: nil,
+              service_port: nil,
               exception_transformer: nil,
               lib_name: nil,
               lib_version: ""
@@ -208,7 +214,10 @@ module Google
               client_config: client_config,
               timeout: timeout,
               lib_name: lib_name,
+              service_address: service_address,
+              service_port: service_port,
               lib_version: lib_version,
+              metadata: metadata,
             )
 
             if credentials.is_a?(String) || credentials.is_a?(Hash)
@@ -254,8 +263,8 @@ module Google
             end
 
             # Allow overriding the service path/port in subclasses.
-            service_path = self.class::SERVICE_ADDRESS
-            port = self.class::DEFAULT_SERVICE_PORT
+            service_path = service_address || self.class::SERVICE_ADDRESS
+            port = service_port || self.class::DEFAULT_SERVICE_PORT
             interceptors = self.class::GRPC_INTERCEPTORS
             @intents_stub = Google::Gax::Grpc.create_stub(
               service_path,
@@ -337,7 +346,7 @@ module Google
           #   Optional. The language to list training phrases, parameters and rich
           #   messages for. If not specified, the agent's default language is used.
           #   [Many
-          #   languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+          #   languages](https://cloud.google.com/dialogflow/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]
@@ -405,7 +414,7 @@ module Google
           #   Optional. The language to retrieve training phrases, parameters and rich
           #   messages for. If not specified, the agent's default language is used.
           #   [Many
-          #   languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+          #   languages](https://cloud.google.com/dialogflow/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]
@@ -453,7 +462,7 @@ module Google
           #   Optional. The language of training phrases, parameters and rich messages
           #   defined in `intent`. If not specified, the agent's default language is
           #   used. [Many
-          #   languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+          #   languages](https://cloud.google.com/dialogflow/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]
@@ -503,7 +512,7 @@ module Google
           #   Optional. The language of training phrases, parameters and rich messages
           #   defined in `intent`. If not specified, the agent's default language is
           #   used. [Many
-          #   languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+          #   languages](https://cloud.google.com/dialogflow/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]
@@ -592,7 +601,7 @@ module Google
           #   Optional. The language of training phrases, parameters and rich messages
           #   defined in `intents`. If not specified, the agent's default language is
           #   used. [Many
-          #   languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+          #   languages](https://cloud.google.com/dialogflow/docs/reference/language)
           #   are supported. Note: languages must be enabled in the agent before they can
           #   be used.
           # @param intent_batch_uri [String]

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

@@ -8,6 +8,7 @@ require 'google/api/annotations_pb'
 require 'google/cloud/dialogflow/v2/entity_type_pb'
 require 'google/protobuf/empty_pb'
 require 'google/protobuf/field_mask_pb'
+require 'google/api/client_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.cloud.dialogflow.v2.SessionEntityType" do
     optional :name, :string, 1

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

@@ -38,7 +38,7 @@ module Google
           #
           # For more information about entity types, see the
           # [Dialogflow
-          # documentation](https://cloud.google.com/dialogflow-enterprise/docs/entities-overview).
+          # documentation](https://cloud.google.com/dialogflow/docs/entities-overview).
           class Service
 
             include GRPC::GenericService

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

@@ -45,7 +45,7 @@ module Google
         #
         # For more information about entity types, see the
         # [Dialogflow
-        # documentation](https://cloud.google.com/dialogflow-enterprise/docs/entities-overview).
+        # documentation](https://cloud.google.com/dialogflow/docs/entities-overview).
         #
         # @!attribute [r] session_entity_types_stub
         #   @return [Google::Cloud::Dialogflow::V2::SessionEntityTypes::Stub]
@@ -143,6 +143,10 @@ module Google
           #   The default timeout, in seconds, for calls made through this client.
           # @param metadata [Hash]
           #   Default metadata to be sent with each request. This can be overridden on a per call basis.
+          # @param service_address [String]
+          #   Override for the service hostname, or `nil` to leave as the default.
+          # @param service_port [Integer]
+          #   Override for the service port, or `nil` to leave as the default.
           # @param exception_transformer [Proc]
           #   An optional proc that intercepts any exceptions raised during an API call to inject
           #   custom error handling.
@@ -152,6 +156,8 @@ module Google
               client_config: {},
               timeout: DEFAULT_TIMEOUT,
               metadata: nil,
+              service_address: nil,
+              service_port: nil,
               exception_transformer: nil,
               lib_name: nil,
               lib_version: ""
@@ -206,8 +212,8 @@ module Google
             end
 
             # Allow overriding the service path/port in subclasses.
-            service_path = self.class::SERVICE_ADDRESS
-            port = self.class::DEFAULT_SERVICE_PORT
+            service_path = service_address || self.class::SERVICE_ADDRESS
+            port = service_port || self.class::DEFAULT_SERVICE_PORT
             interceptors = self.class::GRPC_INTERCEPTORS
             @session_entity_types_stub = Google::Gax::Grpc.create_stub(
               service_path,

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

@@ -9,9 +9,11 @@ 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'
+require 'google/protobuf/duration_pb'
 require 'google/protobuf/struct_pb'
 require 'google/rpc/status_pb'
 require 'google/type/latlng_pb'
+require 'google/api/client_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.cloud.dialogflow.v2.DetectIntentRequest" do
     optional :session, :string, 1