google-cloud-dialogflow-v2 0.8.1 → 0.11.0

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

@@ -67,10 +67,7 @@ module Google
 
                 default_config.timeout = 60.0
                 default_config.retry_policy = {
-                  initial_delay: 0.1,
-                  max_delay: 60.0,
-                  multiplier: 1.3,
-                  retry_codes: [14]
+                  initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
                 }
 
                 default_config
@@ -141,7 +138,7 @@ module Google
                                        !@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)
+              if credentials.is_a?(::String) || credentials.is_a?(::Hash)
                 credentials = Credentials.new credentials, scope: @config.scope
               end
               @quota_project_id = @config.quota_project
@@ -325,6 +322,10 @@ module Google
             ##
             # Creates an entity type in the specified agent.
             #
+            # Note: You should always train an agent prior to sending it queries. See the
+            # [training
+            # documentation](https://cloud.google.com/dialogflow/es/docs/training).
+            #
             # @overload create_entity_type(request, options = nil)
             #   Pass arguments to `create_entity_type` via a request object, either of type
             #   {::Google::Cloud::Dialogflow::V2::CreateEntityTypeRequest} or an equivalent Hash.
@@ -400,6 +401,10 @@ module Google
             ##
             # Updates the specified entity type.
             #
+            # Note: You should always train an agent prior to sending it queries. See the
+            # [training
+            # documentation](https://cloud.google.com/dialogflow/es/docs/training).
+            #
             # @overload update_entity_type(request, options = nil)
             #   Pass arguments to `update_entity_type` via a request object, either of type
             #   {::Google::Cloud::Dialogflow::V2::UpdateEntityTypeRequest} or an equivalent Hash.
@@ -474,6 +479,10 @@ module Google
             ##
             # Deletes the specified entity type.
             #
+            # Note: You should always train an agent prior to sending it queries. See the
+            # [training
+            # documentation](https://cloud.google.com/dialogflow/es/docs/training).
+            #
             # @overload delete_entity_type(request, options = nil)
             #   Pass arguments to `delete_entity_type` via a request object, either of type
             #   {::Google::Cloud::Dialogflow::V2::DeleteEntityTypeRequest} or an equivalent Hash.
@@ -541,7 +550,10 @@ module Google
             ##
             # Updates/Creates multiple entity types in the specified agent.
             #
-            # Operation <response: {::Google::Cloud::Dialogflow::V2::BatchUpdateEntityTypesResponse BatchUpdateEntityTypesResponse}>
+            #
+            # Note: You should always train an agent prior to sending it queries. See the
+            # [training
+            # documentation](https://cloud.google.com/dialogflow/es/docs/training).
             #
             # @overload batch_update_entity_types(request, options = nil)
             #   Pass arguments to `batch_update_entity_types` via a request object, either of type
@@ -626,7 +638,9 @@ module Google
             ##
             # Deletes entity types in the specified agent.
             #
-            # Operation <response: {::Google::Protobuf::Empty google.protobuf.Empty}>
+            # Note: You should always train an agent prior to sending it queries. See the
+            # [training
+            # documentation](https://cloud.google.com/dialogflow/es/docs/training).
             #
             # @overload batch_delete_entity_types(request, options = nil)
             #   Pass arguments to `batch_delete_entity_types` via a request object, either of type
@@ -699,7 +713,9 @@ module Google
             ##
             # Creates multiple new entities in the specified entity type.
             #
-            # Operation <response: {::Google::Protobuf::Empty google.protobuf.Empty}>
+            # Note: You should always train an agent prior to sending it queries. See the
+            # [training
+            # documentation](https://cloud.google.com/dialogflow/es/docs/training).
             #
             # @overload batch_create_entities(request, options = nil)
             #   Pass arguments to `batch_create_entities` via a request object, either of type
@@ -779,8 +795,9 @@ module Google
             # method does not affect entities in the entity type that aren't explicitly
             # specified in the request.
             #
-            #
-            # Operation <response: {::Google::Protobuf::Empty google.protobuf.Empty}>
+            # Note: You should always train an agent prior to sending it queries. See the
+            # [training
+            # documentation](https://cloud.google.com/dialogflow/es/docs/training).
             #
             # @overload batch_update_entities(request, options = nil)
             #   Pass arguments to `batch_update_entities` via a request object, either of type
@@ -860,8 +877,9 @@ module Google
             ##
             # Deletes entities in the specified entity type.
             #
-            #
-            # Operation <response: {::Google::Protobuf::Empty google.protobuf.Empty}>
+            # Note: You should always train an agent prior to sending it queries. See the
+            # [training
+            # documentation](https://cloud.google.com/dialogflow/es/docs/training).
             #
             # @overload batch_delete_entities(request, options = nil)
             #   Pass arguments to `batch_delete_entities` via a request object, either of type

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

@@ -82,7 +82,7 @@ module Google
               # Create credentials
               credentials = @config.credentials
               credentials ||= Credentials.default scope: @config.scope
-              if credentials.is_a?(String) || credentials.is_a?(Hash)
+              if credentials.is_a?(::String) || credentials.is_a?(::Hash)
                 credentials = Credentials.new credentials, scope: @config.scope
               end
               @quota_project_id = @config.quota_project
@@ -396,9 +396,9 @@ module Google
             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
+            # Waits until the specified long-running operation 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`.

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

@@ -27,13 +27,13 @@ module Google
           # 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.
+            # Returns the list of all non-default environments of the specified agent.
             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
@@ -44,13 +44,13 @@ module Google
             # 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
+            # `LOADING` state. During that time, the environment continues 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.
+            # You can use "-" as Environment ID in environment name to update an agent
+            # version in the default environment. WARNING: this will negate all recent
+            # changes to the draft agent and can't be undone. You may want to save the
+            # draft agent to a version before calling this method.
             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

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

@@ -67,10 +67,7 @@ module Google
 
                 default_config.timeout = 60.0
                 default_config.retry_policy = {
-                  initial_delay: 0.1,
-                  max_delay: 60.0,
-                  multiplier: 1.3,
-                  retry_codes: [14]
+                  initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
                 }
 
                 default_config
@@ -141,7 +138,7 @@ module Google
                                        !@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)
+              if credentials.is_a?(::String) || credentials.is_a?(::Hash)
                 credentials = Credentials.new credentials, scope: @config.scope
               end
               @quota_project_id = @config.quota_project
@@ -159,7 +156,7 @@ module Google
             # Service calls
 
             ##
-            # Returns the list of all non-draft environments of the specified agent.
+            # Returns the list of all non-default environments of the specified agent.
             #
             # @overload list_environments(request, options = nil)
             #   Pass arguments to `list_environments` via a request object, either of type
@@ -179,6 +176,7 @@ module Google
             #   @param parent [::String]
             #     Required. The agent to list all environments from.
             #     Format:
+            #
             #     - `projects/<Project ID>/agent`
             #     - `projects/<Project ID>/locations/<Location ID>/agent`
             #   @param page_size [::Integer]
@@ -254,10 +252,13 @@ module Google
             #   @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>`
             #
+            #     The environment ID for the default environment is `-`.
+            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Dialogflow::V2::Environment]
             # @yieldparam operation [::GRPC::ActiveCall::Operation]
@@ -324,6 +325,7 @@ module Google
             #   @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]
@@ -382,13 +384,13 @@ module Google
             # 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
+            # `LOADING` state. During that time, the environment continues 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.
+            # You can use "-" as Environment ID in environment name to update an agent
+            # version in the default environment. WARNING: this will negate all recent
+            # changes to the draft agent and can't be undone. You may want to save the
+            # draft agent to a version before calling this method.
             #
             # @overload update_environment(request, options = nil)
             #   Pass arguments to `update_environment` via a request object, either of type
@@ -410,10 +412,10 @@ module Google
             #   @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
+            #     Optional. This field is used to prevent accidental overwrite of the default
             #     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 = `-`).
+            #     true when updating the default environment (environment ID = `-`).
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Dialogflow::V2::Environment]
@@ -481,9 +483,12 @@ module Google
             #   @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>`
+            #       ID>/agent/environments/<Environment ID>`
+            #
+            #     The environment ID for the default environment is `-`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Protobuf::Empty]
@@ -551,9 +556,12 @@ module Google
             #   @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>`
+            #
+            #     The environment ID for the default environment is `-`.
             #   @param page_size [::Integer]
             #     Optional. The maximum number of items to return in a single page. By default 100 and
             #     at most 1000.

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

@@ -137,6 +137,47 @@ module Google
               resource.call(**args)
             end
 
+            ##
+            # Create a fully-qualified Version resource string.
+            #
+            # @overload version_path(project:, version:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/agent/versions/{version}`
+            #
+            #   @param project [String]
+            #   @param version [String]
+            #
+            # @overload version_path(project:, location:, version:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/locations/{location}/agent/versions/{version}`
+            #
+            #   @param project [String]
+            #   @param location [String]
+            #   @param version [String]
+            #
+            # @return [::String]
+            def version_path **args
+              resources = {
+                "project:version" => (proc do |project:, version:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+
+                  "projects/#{project}/agent/versions/#{version}"
+                end),
+                "location:project:version" => (proc do |project:, location:, version:|
+                  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/versions/#{version}"
+                end)
+              }
+
+              resource = resources[args.keys.sort.join(":")]
+              raise ::ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
+              resource.call(**args)
+            end
+
             extend self
           end
         end

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

@@ -27,7 +27,7 @@ module Google
           # Service for managing [Fulfillments][google.cloud.dialogflow.v2.Fulfillment].
           class Service
 
-            include ::GRPC::GenericService
+            include GRPC::GenericService
 
             self.marshal_class_method = :encode
             self.unmarshal_class_method = :decode

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

@@ -67,10 +67,7 @@ module Google
 
                 default_config.timeout = 60.0
                 default_config.retry_policy = {
-                  initial_delay: 0.1,
-                  max_delay: 60.0,
-                  multiplier: 1.3,
-                  retry_codes: [14]
+                  initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
                 }
 
                 default_config
@@ -141,7 +138,7 @@ module Google
                                        !@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)
+              if credentials.is_a?(::String) || credentials.is_a?(::Hash)
                 credentials = Credentials.new credentials, scope: @config.scope
               end
               @quota_project_id = @config.quota_project

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

@@ -27,7 +27,7 @@ module Google
           # Service for managing [Intents][google.cloud.dialogflow.v2.Intent].
           class Service
 
-            include ::GRPC::GenericService
+            include GRPC::GenericService
 
             self.marshal_class_method = :encode
             self.unmarshal_class_method = :decode
@@ -38,18 +38,36 @@ module Google
             # Retrieves the specified intent.
             rpc :GetIntent, ::Google::Cloud::Dialogflow::V2::GetIntentRequest, ::Google::Cloud::Dialogflow::V2::Intent
             # Creates an intent in the specified agent.
+            #
+            # Note: You should always train an agent prior to sending it queries. See the
+            # [training
+            # documentation](https://cloud.google.com/dialogflow/es/docs/training).
             rpc :CreateIntent, ::Google::Cloud::Dialogflow::V2::CreateIntentRequest, ::Google::Cloud::Dialogflow::V2::Intent
             # Updates the specified intent.
+            #
+            # Note: You should always train an agent prior to sending it queries. See the
+            # [training
+            # documentation](https://cloud.google.com/dialogflow/es/docs/training).
             rpc :UpdateIntent, ::Google::Cloud::Dialogflow::V2::UpdateIntentRequest, ::Google::Cloud::Dialogflow::V2::Intent
             # Deletes the specified intent and its direct or indirect followup intents.
+            #
+            # Note: You should always train an agent prior to sending it queries. See the
+            # [training
+            # documentation](https://cloud.google.com/dialogflow/es/docs/training).
             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]>
+            #
+            # Note: You should always train an agent prior to sending it queries. See the
+            # [training
+            # documentation](https://cloud.google.com/dialogflow/es/docs/training).
             rpc :BatchUpdateIntents, ::Google::Cloud::Dialogflow::V2::BatchUpdateIntentsRequest, ::Google::Longrunning::Operation
             # Deletes intents in the specified agent.
             #
-            # Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+            #
+            # Note: You should always train an agent prior to sending it queries. See the
+            # [training
+            # documentation](https://cloud.google.com/dialogflow/es/docs/training).
             rpc :BatchDeleteIntents, ::Google::Cloud::Dialogflow::V2::BatchDeleteIntentsRequest, ::Google::Longrunning::Operation
           end
 

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

@@ -67,10 +67,7 @@ module Google
 
                 default_config.timeout = 60.0
                 default_config.retry_policy = {
-                  initial_delay: 0.1,
-                  max_delay: 60.0,
-                  multiplier: 1.3,
-                  retry_codes: [14]
+                  initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
                 }
 
                 default_config
@@ -141,7 +138,7 @@ module Google
                                        !@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)
+              if credentials.is_a?(::String) || credentials.is_a?(::Hash)
                 credentials = Credentials.new credentials, scope: @config.scope
               end
               @quota_project_id = @config.quota_project
@@ -337,6 +334,10 @@ module Google
             ##
             # Creates an intent in the specified agent.
             #
+            # Note: You should always train an agent prior to sending it queries. See the
+            # [training
+            # documentation](https://cloud.google.com/dialogflow/es/docs/training).
+            #
             # @overload create_intent(request, options = nil)
             #   Pass arguments to `create_intent` via a request object, either of type
             #   {::Google::Cloud::Dialogflow::V2::CreateIntentRequest} or an equivalent Hash.
@@ -414,6 +415,10 @@ module Google
             ##
             # Updates the specified intent.
             #
+            # Note: You should always train an agent prior to sending it queries. See the
+            # [training
+            # documentation](https://cloud.google.com/dialogflow/es/docs/training).
+            #
             # @overload update_intent(request, options = nil)
             #   Pass arguments to `update_intent` via a request object, either of type
             #   {::Google::Cloud::Dialogflow::V2::UpdateIntentRequest} or an equivalent Hash.
@@ -490,6 +495,10 @@ module Google
             ##
             # Deletes the specified intent and its direct or indirect followup intents.
             #
+            # Note: You should always train an agent prior to sending it queries. See the
+            # [training
+            # documentation](https://cloud.google.com/dialogflow/es/docs/training).
+            #
             # @overload delete_intent(request, options = nil)
             #   Pass arguments to `delete_intent` via a request object, either of type
             #   {::Google::Cloud::Dialogflow::V2::DeleteIntentRequest} or an equivalent Hash.
@@ -558,7 +567,10 @@ module Google
             ##
             # Updates/Creates multiple intents in the specified agent.
             #
-            # Operation <response: {::Google::Cloud::Dialogflow::V2::BatchUpdateIntentsResponse BatchUpdateIntentsResponse}>
+            #
+            # Note: You should always train an agent prior to sending it queries. See the
+            # [training
+            # documentation](https://cloud.google.com/dialogflow/es/docs/training).
             #
             # @overload batch_update_intents(request, options = nil)
             #   Pass arguments to `batch_update_intents` via a request object, either of type
@@ -644,7 +656,10 @@ module Google
             ##
             # Deletes intents in the specified agent.
             #
-            # Operation <response: {::Google::Protobuf::Empty google.protobuf.Empty}>
+            #
+            # Note: You should always train an agent prior to sending it queries. See the
+            # [training
+            # documentation](https://cloud.google.com/dialogflow/es/docs/training).
             #
             # @overload batch_delete_intents(request, options = nil)
             #   Pass arguments to `batch_delete_intents` via a request object, either of type