google-cloud-dialogflow-v2 0.5.0 → 0.6.3

data/lib/google/cloud/dialogflow/v2/sessions/credentials.rb

@@ -24,7 +24,7 @@ module Google
       module V2
         module Sessions
           # Credentials for the Sessions API.
-          class Credentials < Google::Auth::Credentials
+          class Credentials < ::Google::Auth::Credentials
             self.scope = [
               "https://www.googleapis.com/auth/cloud-platform",
               "https://www.googleapis.com/auth/dialogflow"

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

@@ -47,27 +47,27 @@ module Google
             #   @param session [String]
             #   @param context [String]
             #
-            # @return [String]
+            # @return [::String]
             def context_path **args
               resources = {
                 "context:project:session"                  => (proc do |project:, session:, context:|
-                  raise ArgumentError, "project cannot contain /" if project.to_s.include? "/"
-                  raise ArgumentError, "session cannot contain /" if session.to_s.include? "/"
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                  raise ::ArgumentError, "session cannot contain /" if session.to_s.include? "/"
 
                   "projects/#{project}/agent/sessions/#{session}/contexts/#{context}"
                 end),
                 "context:environment:project:session:user" => (proc do |project:, environment:, user:, session:, context:|
-                  raise ArgumentError, "project cannot contain /" if project.to_s.include? "/"
-                  raise ArgumentError, "environment cannot contain /" if environment.to_s.include? "/"
-                  raise ArgumentError, "user cannot contain /" if user.to_s.include? "/"
-                  raise ArgumentError, "session cannot contain /" if session.to_s.include? "/"
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                  raise ::ArgumentError, "environment cannot contain /" if environment.to_s.include? "/"
+                  raise ::ArgumentError, "user cannot contain /" if user.to_s.include? "/"
+                  raise ::ArgumentError, "session cannot contain /" if session.to_s.include? "/"
 
                   "projects/#{project}/agent/environments/#{environment}/users/#{user}/sessions/#{session}/contexts/#{context}"
                 end)
               }
 
               resource = resources[args.keys.sort.join(":")]
-              raise ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
+              raise ::ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
               resource.call(**args)
             end
 
@@ -92,25 +92,25 @@ module Google
             #   @param user [String]
             #   @param session [String]
             #
-            # @return [String]
+            # @return [::String]
             def session_path **args
               resources = {
                 "project:session"                  => (proc do |project:, session:|
-                  raise ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
 
                   "projects/#{project}/agent/sessions/#{session}"
                 end),
                 "environment:project:session:user" => (proc do |project:, environment:, user:, session:|
-                  raise ArgumentError, "project cannot contain /" if project.to_s.include? "/"
-                  raise ArgumentError, "environment cannot contain /" if environment.to_s.include? "/"
-                  raise ArgumentError, "user cannot contain /" if user.to_s.include? "/"
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                  raise ::ArgumentError, "environment cannot contain /" if environment.to_s.include? "/"
+                  raise ::ArgumentError, "user cannot contain /" if user.to_s.include? "/"
 
                   "projects/#{project}/agent/environments/#{environment}/users/#{user}/sessions/#{session}"
                 end)
               }
 
               resource = resources[args.keys.sort.join(":")]
-              raise ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
+              raise ::ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
               resource.call(**args)
             end
 
@@ -137,27 +137,27 @@ module Google
             #   @param session [String]
             #   @param entity_type [String]
             #
-            # @return [String]
+            # @return [::String]
             def session_entity_type_path **args
               resources = {
                 "entity_type:project:session"                  => (proc do |project:, session:, entity_type:|
-                  raise ArgumentError, "project cannot contain /" if project.to_s.include? "/"
-                  raise ArgumentError, "session cannot contain /" if session.to_s.include? "/"
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                  raise ::ArgumentError, "session cannot contain /" if session.to_s.include? "/"
 
                   "projects/#{project}/agent/sessions/#{session}/entityTypes/#{entity_type}"
                 end),
                 "entity_type:environment:project:session:user" => (proc do |project:, environment:, user:, session:, entity_type:|
-                  raise ArgumentError, "project cannot contain /" if project.to_s.include? "/"
-                  raise ArgumentError, "environment cannot contain /" if environment.to_s.include? "/"
-                  raise ArgumentError, "user cannot contain /" if user.to_s.include? "/"
-                  raise ArgumentError, "session cannot contain /" if session.to_s.include? "/"
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                  raise ::ArgumentError, "environment cannot contain /" if environment.to_s.include? "/"
+                  raise ::ArgumentError, "user cannot contain /" if user.to_s.include? "/"
+                  raise ::ArgumentError, "session cannot contain /" if session.to_s.include? "/"
 
                   "projects/#{project}/agent/environments/#{environment}/users/#{user}/sessions/#{session}/entityTypes/#{entity_type}"
                 end)
               }
 
               resource = resources[args.keys.sort.join(":")]
-              raise ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
+              raise ::ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
               resource.call(**args)
             end
 

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Dialogflow
       module V2
-        VERSION = "0.5.0"
+        VERSION = "0.6.3"
       end
     end
   end

data/proto_docs/google/api/resource.rb

@@ -128,7 +128,7 @@ module Google
     #         - pattern: "shelves/{shelf}"
     #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
     # @!attribute [rw] type
-    #   @return [String]
+    #   @return [::String]
     #     The resource type. It must be in the format of
     #     \\{service_name}/\\{resource_type_kind}. The `resource_type_kind` must be
     #     singular and must not include version numbers.
@@ -140,7 +140,7 @@ module Google
     #     should use PascalCase (UpperCamelCase). The maximum number of
     #     characters allowed for the `resource_type_kind` is 100.
     # @!attribute [rw] pattern
-    #   @return [Array<String>]
+    #   @return [::Array<::String>]
     #     Optional. The relative resource name pattern associated with this resource
     #     type. The DNS prefix of the full resource name shouldn't be specified here.
     #
@@ -161,11 +161,11 @@ module Google
     #     the same component name (e.g. "project") refers to IDs of the same
     #     type of resource.
     # @!attribute [rw] name_field
-    #   @return [String]
+    #   @return [::String]
     #     Optional. The field on the resource that designates the resource name
     #     field. If omitted, this is assumed to be "name".
     # @!attribute [rw] history
-    #   @return [Google::Api::ResourceDescriptor::History]
+    #   @return [::Google::Api::ResourceDescriptor::History]
     #     Optional. The historical or future-looking state of the resource pattern.
     #
     #     Example:
@@ -182,19 +182,19 @@ module Google
     #           };
     #         }
     # @!attribute [rw] plural
-    #   @return [String]
+    #   @return [::String]
     #     The plural name used in the resource name, such as 'projects' for
     #     the name of 'projects/\\{project}'. It is the same concept of the `plural`
     #     field in k8s CRD spec
     #     https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
     # @!attribute [rw] singular
-    #   @return [String]
+    #   @return [::String]
     #     The same concept of the `singular` field in k8s CRD spec
     #     https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
     #     Such as "project" for the `resourcemanager.googleapis.com/Project` type.
     class ResourceDescriptor
-      include Google::Protobuf::MessageExts
-      extend Google::Protobuf::MessageExts::ClassMethods
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
 
       # A description of the historical or future-looking state of the
       # resource pattern.
@@ -216,7 +216,7 @@ module Google
     # Defines a proto annotation that describes a string field that refers to
     # an API resource.
     # @!attribute [rw] type
-    #   @return [String]
+    #   @return [::String]
     #     The resource type that the annotated field references.
     #
     #     Example:
@@ -227,7 +227,7 @@ module Google
     #           }];
     #         }
     # @!attribute [rw] child_type
-    #   @return [String]
+    #   @return [::String]
     #     The resource type of a child collection that the annotated field
     #     references. This is useful for annotating the `parent` field that
     #     doesn't have a fixed resource type.
@@ -240,8 +240,8 @@ module Google
     #         };
     #       }
     class ResourceReference
-      include Google::Protobuf::MessageExts
-      extend Google::Protobuf::MessageExts::ClassMethods
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
     end
   end
 end

data/proto_docs/google/cloud/dialogflow/v2/agent.rb

@@ -21,49 +21,58 @@ module Google
   module Cloud
     module Dialogflow
       module V2
-        # Represents a conversational agent.
+        # A Dialogflow agent is a virtual agent that handles conversations with your
+        # end-users. It is a natural language understanding module that understands the
+        # nuances of human language. Dialogflow translates end-user text or audio
+        # during a conversation to structured data that your apps and services can
+        # understand. You design and build a Dialogflow agent to handle the types of
+        # conversations required for your system.
+        #
+        # For more information about agents, see the
+        # [Agents
+        # documentation](https://cloud.google.com/dialogflow/docs/agents-overview).
         # @!attribute [rw] parent
-        #   @return [String]
+        #   @return [::String]
         #     Required. The project of this agent.
         #     Format: `projects/<Project ID>`.
         # @!attribute [rw] display_name
-        #   @return [String]
+        #   @return [::String]
         #     Required. The name of this agent.
         # @!attribute [rw] default_language_code
-        #   @return [String]
+        #   @return [::String]
         #     Required. The default language of the agent as a language tag. See
         #     [Language
         #     Support](https://cloud.google.com/dialogflow/docs/reference/language)
         #     for a list of the currently supported language codes. This field cannot be
         #     set by the `Update` method.
         # @!attribute [rw] supported_language_codes
-        #   @return [Array<String>]
+        #   @return [::Array<::String>]
         #     Optional. The list of all languages supported by this agent (except for the
         #     `default_language_code`).
         # @!attribute [rw] time_zone
-        #   @return [String]
+        #   @return [::String]
         #     Required. The time zone of this agent from the
         #     [time zone database](https://www.iana.org/time-zones), e.g.,
         #     America/New_York, Europe/Paris.
         # @!attribute [rw] description
-        #   @return [String]
+        #   @return [::String]
         #     Optional. The description of this agent.
         #     The maximum length is 500 characters. If exceeded, the request is rejected.
         # @!attribute [rw] avatar_uri
-        #   @return [String]
+        #   @return [::String]
         #     Optional. The URI of the agent's avatar.
         #     Avatars are used throughout the Dialogflow console and in the self-hosted
         #     [Web
         #     Demo](https://cloud.google.com/dialogflow/docs/integrations/web-demo)
         #     integration.
         # @!attribute [rw] enable_logging
-        #   @return [Boolean]
+        #   @return [::Boolean]
         #     Optional. Determines whether this agent should log conversation queries.
         # @!attribute [rw] match_mode
-        #   @return [Google::Cloud::Dialogflow::V2::Agent::MatchMode]
+        #   @return [::Google::Cloud::Dialogflow::V2::Agent::MatchMode]
         #     Optional. Determines how intents are detected from user queries.
         # @!attribute [rw] classification_threshold
-        #   @return [Float]
+        #   @return [::Float]
         #     Optional. To filter out false positive results and still get variety in
         #     matched natural language inputs for your agent, you can tune the machine
         #     learning classification threshold. If the returned score value is less than
@@ -72,17 +81,17 @@ module Google
         #     values range from 0.0 (completely uncertain) to 1.0 (completely certain).
         #     If set to 0.0, the default of 0.3 is used.
         # @!attribute [rw] api_version
-        #   @return [Google::Cloud::Dialogflow::V2::Agent::ApiVersion]
+        #   @return [::Google::Cloud::Dialogflow::V2::Agent::ApiVersion]
         #     Optional. API version displayed in Dialogflow console. If not specified,
         #     V2 API is assumed. Clients are free to query different service endpoints
         #     for different API versions. However, bots connectors and webhook calls will
         #     follow the specified API version.
         # @!attribute [rw] tier
-        #   @return [Google::Cloud::Dialogflow::V2::Agent::Tier]
+        #   @return [::Google::Cloud::Dialogflow::V2::Agent::Tier]
         #     Optional. The agent tier. If not specified, TIER_STANDARD is assumed.
         class Agent
-          include Google::Protobuf::MessageExts
-          extend Google::Protobuf::MessageExts::ClassMethods
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
 
           # Match mode determines how intents are detected from user queries.
           module MatchMode
@@ -129,157 +138,157 @@ module Google
           end
         end
 
-        # The request message for {Google::Cloud::Dialogflow::V2::Agents::Client#get_agent Agents.GetAgent}.
+        # The request message for {::Google::Cloud::Dialogflow::V2::Agents::Client#get_agent Agents.GetAgent}.
         # @!attribute [rw] parent
-        #   @return [String]
+        #   @return [::String]
         #     Required. The project that the agent to fetch is associated with.
         #     Format: `projects/<Project ID>`.
         class GetAgentRequest
-          include Google::Protobuf::MessageExts
-          extend Google::Protobuf::MessageExts::ClassMethods
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # The request message for {Google::Cloud::Dialogflow::V2::Agents::Client#set_agent Agents.SetAgent}.
+        # The request message for {::Google::Cloud::Dialogflow::V2::Agents::Client#set_agent Agents.SetAgent}.
         # @!attribute [rw] agent
-        #   @return [Google::Cloud::Dialogflow::V2::Agent]
+        #   @return [::Google::Cloud::Dialogflow::V2::Agent]
         #     Required. The agent to update.
         # @!attribute [rw] update_mask
-        #   @return [Google::Protobuf::FieldMask]
+        #   @return [::Google::Protobuf::FieldMask]
         #     Optional. The mask to control which fields get updated.
         class SetAgentRequest
-          include Google::Protobuf::MessageExts
-          extend Google::Protobuf::MessageExts::ClassMethods
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # The request message for {Google::Cloud::Dialogflow::V2::Agents::Client#delete_agent Agents.DeleteAgent}.
+        # The request message for {::Google::Cloud::Dialogflow::V2::Agents::Client#delete_agent Agents.DeleteAgent}.
         # @!attribute [rw] parent
-        #   @return [String]
+        #   @return [::String]
         #     Required. The project that the agent to delete is associated with.
         #     Format: `projects/<Project ID>`.
         class DeleteAgentRequest
-          include Google::Protobuf::MessageExts
-          extend Google::Protobuf::MessageExts::ClassMethods
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # The request message for {Google::Cloud::Dialogflow::V2::Agents::Client#search_agents Agents.SearchAgents}.
+        # The request message for {::Google::Cloud::Dialogflow::V2::Agents::Client#search_agents Agents.SearchAgents}.
         # @!attribute [rw] parent
-        #   @return [String]
+        #   @return [::String]
         #     Required. The project to list agents from.
         #     Format: `projects/<Project ID or '-'>`.
         # @!attribute [rw] page_size
-        #   @return [Integer]
+        #   @return [::Integer]
         #     Optional. The maximum number of items to return in a single page. By
         #     default 100 and at most 1000.
         # @!attribute [rw] page_token
-        #   @return [String]
+        #   @return [::String]
         #     The next_page_token value returned from a previous list request.
         class SearchAgentsRequest
-          include Google::Protobuf::MessageExts
-          extend Google::Protobuf::MessageExts::ClassMethods
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # The response message for {Google::Cloud::Dialogflow::V2::Agents::Client#search_agents Agents.SearchAgents}.
+        # The response message for {::Google::Cloud::Dialogflow::V2::Agents::Client#search_agents Agents.SearchAgents}.
         # @!attribute [rw] agents
-        #   @return [Array<Google::Cloud::Dialogflow::V2::Agent>]
+        #   @return [::Array<::Google::Cloud::Dialogflow::V2::Agent>]
         #     The list of agents. There will be a maximum number of items returned based
         #     on the page_size field in the request.
         # @!attribute [rw] next_page_token
-        #   @return [String]
+        #   @return [::String]
         #     Token to retrieve the next page of results, or empty if there are no
         #     more results in the list.
         class SearchAgentsResponse
-          include Google::Protobuf::MessageExts
-          extend Google::Protobuf::MessageExts::ClassMethods
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # The request message for {Google::Cloud::Dialogflow::V2::Agents::Client#train_agent Agents.TrainAgent}.
+        # The request message for {::Google::Cloud::Dialogflow::V2::Agents::Client#train_agent Agents.TrainAgent}.
         # @!attribute [rw] parent
-        #   @return [String]
+        #   @return [::String]
         #     Required. The project that the agent to train is associated with.
         #     Format: `projects/<Project ID>`.
         class TrainAgentRequest
-          include Google::Protobuf::MessageExts
-          extend Google::Protobuf::MessageExts::ClassMethods
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # The request message for {Google::Cloud::Dialogflow::V2::Agents::Client#export_agent Agents.ExportAgent}.
+        # The request message for {::Google::Cloud::Dialogflow::V2::Agents::Client#export_agent Agents.ExportAgent}.
         # @!attribute [rw] parent
-        #   @return [String]
+        #   @return [::String]
         #     Required. The project that the agent to export is associated with.
         #     Format: `projects/<Project ID>`.
         # @!attribute [rw] agent_uri
-        #   @return [String]
+        #   @return [::String]
         #     Required. The [Google Cloud Storage](https://cloud.google.com/storage/docs/)
         #     URI to export the agent to.
         #     The format of this URI must be `gs://<bucket-name>/<object-name>`.
         #     If left unspecified, the serialized agent is returned inline.
         class ExportAgentRequest
-          include Google::Protobuf::MessageExts
-          extend Google::Protobuf::MessageExts::ClassMethods
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # The response message for {Google::Cloud::Dialogflow::V2::Agents::Client#export_agent Agents.ExportAgent}.
+        # The response message for {::Google::Cloud::Dialogflow::V2::Agents::Client#export_agent Agents.ExportAgent}.
         # @!attribute [rw] agent_uri
-        #   @return [String]
+        #   @return [::String]
         #     The URI to a file containing the exported agent. This field is populated
         #     only if `agent_uri` is specified in `ExportAgentRequest`.
         # @!attribute [rw] agent_content
-        #   @return [String]
+        #   @return [::String]
         #     Zip compressed raw byte content for agent.
         class ExportAgentResponse
-          include Google::Protobuf::MessageExts
-          extend Google::Protobuf::MessageExts::ClassMethods
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # The request message for {Google::Cloud::Dialogflow::V2::Agents::Client#import_agent Agents.ImportAgent}.
+        # The request message for {::Google::Cloud::Dialogflow::V2::Agents::Client#import_agent Agents.ImportAgent}.
         # @!attribute [rw] parent
-        #   @return [String]
+        #   @return [::String]
         #     Required. The project that the agent to import is associated with.
         #     Format: `projects/<Project ID>`.
         # @!attribute [rw] agent_uri
-        #   @return [String]
+        #   @return [::String]
         #     The URI to a Google Cloud Storage file containing the agent to import.
         #     Note: The URI must start with "gs://".
         # @!attribute [rw] agent_content
-        #   @return [String]
+        #   @return [::String]
         #     Zip compressed raw byte content for agent.
         class ImportAgentRequest
-          include Google::Protobuf::MessageExts
-          extend Google::Protobuf::MessageExts::ClassMethods
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # The request message for {Google::Cloud::Dialogflow::V2::Agents::Client#restore_agent Agents.RestoreAgent}.
+        # The request message for {::Google::Cloud::Dialogflow::V2::Agents::Client#restore_agent Agents.RestoreAgent}.
         # @!attribute [rw] parent
-        #   @return [String]
+        #   @return [::String]
         #     Required. The project that the agent to restore is associated with.
         #     Format: `projects/<Project ID>`.
         # @!attribute [rw] agent_uri
-        #   @return [String]
+        #   @return [::String]
         #     The URI to a Google Cloud Storage file containing the agent to restore.
         #     Note: The URI must start with "gs://".
         # @!attribute [rw] agent_content
-        #   @return [String]
+        #   @return [::String]
         #     Zip compressed raw byte content for agent.
         class RestoreAgentRequest
-          include Google::Protobuf::MessageExts
-          extend Google::Protobuf::MessageExts::ClassMethods
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # The request message for {Google::Cloud::Dialogflow::V2::Agents::Client#get_validation_result Agents.GetValidationResult}.
+        # The request message for {::Google::Cloud::Dialogflow::V2::Agents::Client#get_validation_result Agents.GetValidationResult}.
         # @!attribute [rw] parent
-        #   @return [String]
+        #   @return [::String]
         #     Required. The project that the agent is associated with.
         #     Format: `projects/<Project ID>`.
         # @!attribute [rw] language_code
-        #   @return [String]
+        #   @return [::String]
         #     Optional. The language for which you want a validation result. If not
         #     specified, the agent's default language is used. [Many
         #     languages](https://cloud.google.com/dialogflow/docs/reference/language)
         #     are supported. Note: languages must be enabled in the agent before they can
         #     be used.
         class GetValidationResultRequest
-          include Google::Protobuf::MessageExts
-          extend Google::Protobuf::MessageExts::ClassMethods
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
         end
       end
     end