google-cloud-dialogflow-v2 0.11.4 → 0.14.0

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

@@ -162,7 +162,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload list_knowledge_bases(parent: nil, page_size: nil, page_token: nil)
+            # @overload list_knowledge_bases(parent: nil, page_size: nil, page_token: nil, filter: nil)
             #   Pass arguments to `list_knowledge_bases` via keyword arguments. Note that at
             #   least one keyword argument is required. To specify no parameters, or to keep all
             #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -175,6 +175,33 @@ module Google
             #     default 10 and at most 100.
             #   @param page_token [::String]
             #     The next_page_token value returned from a previous list request.
+            #   @param filter [::String]
+            #     The filter expression used to filter knowledge bases returned by the list
+            #     method. The expression has the following syntax:
+            #
+            #       <field> <operator> <value> [AND <field> <operator> <value>] ...
+            #
+            #     The following fields and operators are supported:
+            #
+            #     * display_name with has(:) operator
+            #     * language_code with equals(=) operator
+            #
+            #     Examples:
+            #
+            #     * 'language_code=en-us' matches knowledge bases with en-us language code.
+            #     * 'display_name:articles' matches knowledge bases whose display name
+            #       contains "articles".
+            #     * 'display_name:"Best Articles"' matches knowledge bases whose display
+            #       name contains "Best Articles".
+            #     * 'language_code=en-gb AND display_name=articles' matches all knowledge
+            #       bases whose display name contains "articles" and whose language code is
+            #       "en-gb".
+            #
+            #     Note: An empty filter string (i.e. "") is a no-op and will result in no
+            #     filtering.
+            #
+            #     For more information about filtering, see
+            #     [API Filtering](https://aip.dev/160).
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Dialogflow::V2::KnowledgeBase>]
@@ -184,6 +211,27 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dialogflow/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dialogflow::V2::KnowledgeBases::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dialogflow::V2::ListKnowledgeBasesRequest.new
+            #
+            #   # Call the list_knowledge_bases method.
+            #   result = client.list_knowledge_bases request
+            #
+            #   # The returned object is of type Gapic::PagedEnumerable. You can
+            #   # iterate over all elements by calling #each, and the enumerable
+            #   # will lazily make API calls to fetch subsequent pages. Other
+            #   # methods are also available for managing paging directly.
+            #   result.each do |response|
+            #     # Each element is of type ::Google::Cloud::Dialogflow::V2::KnowledgeBase.
+            #     p response
+            #   end
+            #
             def list_knowledge_bases request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -201,9 +249,11 @@ module Google
                 gapic_version: ::Google::Cloud::Dialogflow::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -255,6 +305,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dialogflow/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dialogflow::V2::KnowledgeBases::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dialogflow::V2::GetKnowledgeBaseRequest.new
+            #
+            #   # Call the get_knowledge_base method.
+            #   result = client.get_knowledge_base request
+            #
+            #   # The returned object is of type Google::Cloud::Dialogflow::V2::KnowledgeBase.
+            #   p result
+            #
             def get_knowledge_base request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -272,9 +337,11 @@ module Google
                 gapic_version: ::Google::Cloud::Dialogflow::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -326,6 +393,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dialogflow/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dialogflow::V2::KnowledgeBases::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dialogflow::V2::CreateKnowledgeBaseRequest.new
+            #
+            #   # Call the create_knowledge_base method.
+            #   result = client.create_knowledge_base request
+            #
+            #   # The returned object is of type Google::Cloud::Dialogflow::V2::KnowledgeBase.
+            #   p result
+            #
             def create_knowledge_base request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -343,9 +425,11 @@ module Google
                 gapic_version: ::Google::Cloud::Dialogflow::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -399,6 +483,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dialogflow/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dialogflow::V2::KnowledgeBases::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dialogflow::V2::DeleteKnowledgeBaseRequest.new
+            #
+            #   # Call the delete_knowledge_base method.
+            #   result = client.delete_knowledge_base request
+            #
+            #   # The returned object is of type Google::Protobuf::Empty.
+            #   p result
+            #
             def delete_knowledge_base request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -416,9 +515,11 @@ module Google
                 gapic_version: ::Google::Cloud::Dialogflow::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -471,6 +572,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dialogflow/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dialogflow::V2::KnowledgeBases::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dialogflow::V2::UpdateKnowledgeBaseRequest.new
+            #
+            #   # Call the update_knowledge_base method.
+            #   result = client.update_knowledge_base request
+            #
+            #   # The returned object is of type Google::Cloud::Dialogflow::V2::KnowledgeBase.
+            #   p result
+            #
             def update_knowledge_base request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -488,9 +604,11 @@ module Google
                 gapic_version: ::Google::Cloud::Dialogflow::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "knowledge_base.name" => request.knowledge_base.name
-              }
+              header_params = {}
+              if request.knowledge_base&.name
+                header_params["knowledge_base.name"] = request.knowledge_base.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 

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

@@ -6,6 +6,7 @@ require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
 require 'google/cloud/dialogflow/v2/audio_config_pb'
+require 'google/cloud/dialogflow/v2/gcs_pb'
 require 'google/cloud/dialogflow/v2/session_pb'
 require 'google/protobuf/any_pb'
 require 'google/protobuf/duration_pb'
@@ -21,6 +22,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :name, :string, 1
       optional :role, :enum, 2, "google.cloud.dialogflow.v2.Participant.Role"
       optional :sip_recording_media_label, :string, 6
+      map :documents_metadata_filters, :string, :string, 8
     end
     add_enum "google.cloud.dialogflow.v2.Participant.Role" do
       value :ROLE_UNSPECIFIED, 0
@@ -35,7 +37,9 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :participant, :string, 4
       optional :participant_role, :enum, 5, "google.cloud.dialogflow.v2.Participant.Role"
       optional :create_time, :message, 6, "google.protobuf.Timestamp"
+      optional :send_time, :message, 9, "google.protobuf.Timestamp"
       optional :message_annotation, :message, 7, "google.cloud.dialogflow.v2.MessageAnnotation"
+      optional :sentiment_analysis, :message, 8, "google.cloud.dialogflow.v2.SentimentAnalysisResult"
     end
     add_message "google.cloud.dialogflow.v2.CreateParticipantRequest" do
       optional :parent, :string, 1
@@ -61,6 +65,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :participant, :string, 1
       optional :reply_audio_config, :message, 5, "google.cloud.dialogflow.v2.OutputAudioConfig"
       optional :query_params, :message, 9, "google.cloud.dialogflow.v2.QueryParameters"
+      optional :assist_query_params, :message, 14, "google.cloud.dialogflow.v2.AssistQueryParameters"
       optional :request_id, :string, 11
       oneof :input do
         optional :text_input, :message, 6, "google.cloud.dialogflow.v2.TextInput"
@@ -83,6 +88,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :parent, :string, 1
       optional :latest_message, :string, 2
       optional :context_size, :int32, 3
+      optional :assist_query_params, :message, 4, "google.cloud.dialogflow.v2.AssistQueryParameters"
     end
     add_message "google.cloud.dialogflow.v2.SuggestArticlesResponse" do
       repeated :article_answers, :message, 1, "google.cloud.dialogflow.v2.ArticleAnswer"
@@ -93,12 +99,24 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :parent, :string, 1
       optional :latest_message, :string, 2
       optional :context_size, :int32, 3
+      optional :assist_query_params, :message, 4, "google.cloud.dialogflow.v2.AssistQueryParameters"
     end
     add_message "google.cloud.dialogflow.v2.SuggestFaqAnswersResponse" do
       repeated :faq_answers, :message, 1, "google.cloud.dialogflow.v2.FaqAnswer"
       optional :latest_message, :string, 2
       optional :context_size, :int32, 3
     end
+    add_message "google.cloud.dialogflow.v2.SuggestSmartRepliesRequest" do
+      optional :parent, :string, 1
+      optional :current_text_input, :message, 4, "google.cloud.dialogflow.v2.TextInput"
+      optional :latest_message, :string, 2
+      optional :context_size, :int32, 3
+    end
+    add_message "google.cloud.dialogflow.v2.SuggestSmartRepliesResponse" do
+      repeated :smart_reply_answers, :message, 1, "google.cloud.dialogflow.v2.SmartReplyAnswer"
+      optional :latest_message, :string, 2
+      optional :context_size, :int32, 3
+    end
     add_message "google.cloud.dialogflow.v2.OutputAudio" do
       optional :config, :message, 1, "google.cloud.dialogflow.v2.OutputAudioConfig"
       optional :audio, :bytes, 2
@@ -129,11 +147,17 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       map :metadata, :string, :string, 5
       optional :answer_record, :string, 6
     end
+    add_message "google.cloud.dialogflow.v2.SmartReplyAnswer" do
+      optional :reply, :string, 1
+      optional :confidence, :float, 2
+      optional :answer_record, :string, 3
+    end
     add_message "google.cloud.dialogflow.v2.SuggestionResult" do
       oneof :suggestion_response do
         optional :error, :message, 1, "google.rpc.Status"
         optional :suggest_articles_response, :message, 2, "google.cloud.dialogflow.v2.SuggestArticlesResponse"
         optional :suggest_faq_answers_response, :message, 3, "google.cloud.dialogflow.v2.SuggestFaqAnswersResponse"
+        optional :suggest_smart_replies_response, :message, 4, "google.cloud.dialogflow.v2.SuggestSmartRepliesResponse"
       end
     end
     add_message "google.cloud.dialogflow.v2.AnnotatedMessagePart" do
@@ -145,6 +169,9 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :parts, :message, 1, "google.cloud.dialogflow.v2.AnnotatedMessagePart"
       optional :contain_entities, :bool, 2
     end
+    add_message "google.cloud.dialogflow.v2.AssistQueryParameters" do
+      map :documents_metadata_filters, :string, :string, 1
+    end
   end
 end
 
@@ -167,14 +194,18 @@ module Google
         SuggestArticlesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.SuggestArticlesResponse").msgclass
         SuggestFaqAnswersRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.SuggestFaqAnswersRequest").msgclass
         SuggestFaqAnswersResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.SuggestFaqAnswersResponse").msgclass
+        SuggestSmartRepliesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.SuggestSmartRepliesRequest").msgclass
+        SuggestSmartRepliesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.SuggestSmartRepliesResponse").msgclass
         OutputAudio = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.OutputAudio").msgclass
         AutomatedAgentReply = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.AutomatedAgentReply").msgclass
         AutomatedAgentReply::AutomatedAgentReplyType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.AutomatedAgentReply.AutomatedAgentReplyType").enummodule
         ArticleAnswer = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.ArticleAnswer").msgclass
         FaqAnswer = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.FaqAnswer").msgclass
+        SmartReplyAnswer = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.SmartReplyAnswer").msgclass
         SuggestionResult = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.SuggestionResult").msgclass
         AnnotatedMessagePart = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.AnnotatedMessagePart").msgclass
         MessageAnnotation = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.MessageAnnotation").msgclass
+        AssistQueryParameters = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.AssistQueryParameters").msgclass
       end
     end
   end

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

@@ -54,6 +54,9 @@ module Google
             # Gets suggested faq answers for a participant based on specific historical
             # messages.
             rpc :SuggestFaqAnswers, ::Google::Cloud::Dialogflow::V2::SuggestFaqAnswersRequest, ::Google::Cloud::Dialogflow::V2::SuggestFaqAnswersResponse
+            # Gets smart replies for a participant based on specific historical
+            # messages.
+            rpc :SuggestSmartReplies, ::Google::Cloud::Dialogflow::V2::SuggestSmartRepliesRequest, ::Google::Cloud::Dialogflow::V2::SuggestSmartRepliesResponse
           end
 
           Stub = Service.rpc_stub_class