google-cloud-dialogflow-v2 0.6.0 → 0.7.0

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

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+# Copyright 2021 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+require "googleauth"
+
+module Google
+  module Cloud
+    module Dialogflow
+      module V2
+        module Participants
+          # Credentials for the Participants API.
+          class Credentials < ::Google::Auth::Credentials
+            self.scope = [
+              "https://www.googleapis.com/auth/cloud-platform",
+              "https://www.googleapis.com/auth/dialogflow"
+            ]
+            self.env_vars = [
+              "DIALOGFLOW_CREDENTIALS",
+              "DIALOGFLOW_KEYFILE",
+              "GOOGLE_CLOUD_CREDENTIALS",
+              "GOOGLE_CLOUD_KEYFILE",
+              "GCLOUD_KEYFILE",
+              "DIALOGFLOW_CREDENTIALS_JSON",
+              "DIALOGFLOW_KEYFILE_JSON",
+              "GOOGLE_CLOUD_CREDENTIALS_JSON",
+              "GOOGLE_CLOUD_KEYFILE_JSON",
+              "GCLOUD_KEYFILE_JSON"
+            ]
+            self.paths = [
+              "~/.config/google_cloud/application_default_credentials.json"
+            ]
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,258 @@
+# frozen_string_literal: true
+
+# Copyright 2021 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Dialogflow
+      module V2
+        module Participants
+          # Path helper methods for the Participants API.
+          module Paths
+            ##
+            # Create a fully-qualified Context resource string.
+            #
+            # @overload context_path(project:, session:, context:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/agent/sessions/{session}/contexts/{context}`
+            #
+            #   @param project [String]
+            #   @param session [String]
+            #   @param context [String]
+            #
+            # @overload context_path(project:, environment:, user:, session:, context:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/agent/environments/{environment}/users/{user}/sessions/{session}/contexts/{context}`
+            #
+            #   @param project [String]
+            #   @param environment [String]
+            #   @param user [String]
+            #   @param session [String]
+            #   @param context [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? "/"
+
+                  "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? "/"
+
+                  "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?
+              resource.call(**args)
+            end
+
+            ##
+            # Create a fully-qualified Conversation resource string.
+            #
+            # @overload conversation_path(project:, conversation:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/conversations/{conversation}`
+            #
+            #   @param project [String]
+            #   @param conversation [String]
+            #
+            # @overload conversation_path(project:, location:, conversation:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/locations/{location}/conversations/{conversation}`
+            #
+            #   @param project [String]
+            #   @param location [String]
+            #   @param conversation [String]
+            #
+            # @return [::String]
+            def conversation_path **args
+              resources = {
+                "conversation:project" => (proc do |project:, conversation:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+
+                  "projects/#{project}/conversations/#{conversation}"
+                end),
+                "conversation:location:project" => (proc do |project:, location:, conversation:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                  raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+
+                  "projects/#{project}/locations/#{location}/conversations/#{conversation}"
+                end)
+              }
+
+              resource = resources[args.keys.sort.join(":")]
+              raise ::ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
+              resource.call(**args)
+            end
+
+            ##
+            # Create a fully-qualified Message resource string.
+            #
+            # @overload message_path(project:, conversation:, message:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/conversations/{conversation}/messages/{message}`
+            #
+            #   @param project [String]
+            #   @param conversation [String]
+            #   @param message [String]
+            #
+            # @overload message_path(project:, location:, conversation:, message:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/locations/{location}/conversations/{conversation}/messages/{message}`
+            #
+            #   @param project [String]
+            #   @param location [String]
+            #   @param conversation [String]
+            #   @param message [String]
+            #
+            # @return [::String]
+            def message_path **args
+              resources = {
+                "conversation:message:project" => (proc do |project:, conversation:, message:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                  raise ::ArgumentError, "conversation cannot contain /" if conversation.to_s.include? "/"
+
+                  "projects/#{project}/conversations/#{conversation}/messages/#{message}"
+                end),
+                "conversation:location:message:project" => (proc do |project:, location:, conversation:, message:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                  raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+                  raise ::ArgumentError, "conversation cannot contain /" if conversation.to_s.include? "/"
+
+                  "projects/#{project}/locations/#{location}/conversations/#{conversation}/messages/#{message}"
+                end)
+              }
+
+              resource = resources[args.keys.sort.join(":")]
+              raise ::ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
+              resource.call(**args)
+            end
+
+            ##
+            # Create a fully-qualified Participant resource string.
+            #
+            # @overload participant_path(project:, conversation:, participant:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/conversations/{conversation}/participants/{participant}`
+            #
+            #   @param project [String]
+            #   @param conversation [String]
+            #   @param participant [String]
+            #
+            # @overload participant_path(project:, location:, conversation:, participant:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/locations/{location}/conversations/{conversation}/participants/{participant}`
+            #
+            #   @param project [String]
+            #   @param location [String]
+            #   @param conversation [String]
+            #   @param participant [String]
+            #
+            # @return [::String]
+            def participant_path **args
+              resources = {
+                "conversation:participant:project" => (proc do |project:, conversation:, participant:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                  raise ::ArgumentError, "conversation cannot contain /" if conversation.to_s.include? "/"
+
+                  "projects/#{project}/conversations/#{conversation}/participants/#{participant}"
+                end),
+                "conversation:location:participant:project" => (proc do |project:, location:, conversation:, participant:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                  raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+                  raise ::ArgumentError, "conversation cannot contain /" if conversation.to_s.include? "/"
+
+                  "projects/#{project}/locations/#{location}/conversations/#{conversation}/participants/#{participant}"
+                end)
+              }
+
+              resource = resources[args.keys.sort.join(":")]
+              raise ::ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
+              resource.call(**args)
+            end
+
+            ##
+            # Create a fully-qualified SessionEntityType resource string.
+            #
+            # @overload session_entity_type_path(project:, session:, entity_type:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/agent/sessions/{session}/entityTypes/{entity_type}`
+            #
+            #   @param project [String]
+            #   @param session [String]
+            #   @param entity_type [String]
+            #
+            # @overload session_entity_type_path(project:, environment:, user:, session:, entity_type:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/agent/environments/{environment}/users/{user}/sessions/{session}/entityTypes/{entity_type}`
+            #
+            #   @param project [String]
+            #   @param environment [String]
+            #   @param user [String]
+            #   @param session [String]
+            #   @param entity_type [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? "/"
+
+                  "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? "/"
+
+                  "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?
+              resource.call(**args)
+            end
+
+            extend self
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -24,23 +24,7 @@ module Google
     module Dialogflow
       module V2
         module SessionEntityTypes
-          # Entities are extracted from user input and represent parameters that are
-          # meaningful to your application. For example, a date range, a proper name
-          # such as a geographic location or landmark, and so on. Entities represent
-          # actionable data for your application.
-          #
-          # Session entity types are referred to as **User** entity types and are
-          # entities that are built for an individual user such as
-          # favorites, preferences, playlists, and so on. You can redefine a session
-          # entity type at the session level.
-          #
-          # Session entity methods do not work with Google Assistant integration.
-          # Contact Dialogflow support if you need to use session entities
-          # with Google Assistant integration.
-          #
-          # For more information about entity types, see the
-          # [Dialogflow
-          # documentation](https://cloud.google.com/dialogflow/docs/entities-overview).
+          # Service for managing [SessionEntityTypes][google.cloud.dialogflow.v2.SessionEntityType].
           class Service
 
             include GRPC::GenericService
@@ -54,13 +38,13 @@ module Google
             # This method doesn't work with Google Assistant integration.
             # Contact Dialogflow support if you need to use session entities
             # with Google Assistant integration.
-            rpc :ListSessionEntityTypes, ListSessionEntityTypesRequest, ListSessionEntityTypesResponse
+            rpc :ListSessionEntityTypes, ::Google::Cloud::Dialogflow::V2::ListSessionEntityTypesRequest, ::Google::Cloud::Dialogflow::V2::ListSessionEntityTypesResponse
             # Retrieves the specified session entity type.
             #
             # This method doesn't work with Google Assistant integration.
             # Contact Dialogflow support if you need to use session entities
             # with Google Assistant integration.
-            rpc :GetSessionEntityType, GetSessionEntityTypeRequest, SessionEntityType
+            rpc :GetSessionEntityType, ::Google::Cloud::Dialogflow::V2::GetSessionEntityTypeRequest, ::Google::Cloud::Dialogflow::V2::SessionEntityType
             # Creates a session entity type.
             #
             # If the specified session entity type already exists, overrides the session
@@ -69,19 +53,19 @@ module Google
             # This method doesn't work with Google Assistant integration.
             # Contact Dialogflow support if you need to use session entities
             # with Google Assistant integration.
-            rpc :CreateSessionEntityType, CreateSessionEntityTypeRequest, SessionEntityType
+            rpc :CreateSessionEntityType, ::Google::Cloud::Dialogflow::V2::CreateSessionEntityTypeRequest, ::Google::Cloud::Dialogflow::V2::SessionEntityType
             # Updates the specified session entity type.
             #
             # This method doesn't work with Google Assistant integration.
             # Contact Dialogflow support if you need to use session entities
             # with Google Assistant integration.
-            rpc :UpdateSessionEntityType, UpdateSessionEntityTypeRequest, SessionEntityType
+            rpc :UpdateSessionEntityType, ::Google::Cloud::Dialogflow::V2::UpdateSessionEntityTypeRequest, ::Google::Cloud::Dialogflow::V2::SessionEntityType
             # Deletes the specified session entity type.
             #
             # This method doesn't work with Google Assistant integration.
             # Contact Dialogflow support if you need to use session entities
             # with Google Assistant integration.
-            rpc :DeleteSessionEntityType, DeleteSessionEntityTypeRequest, Google::Protobuf::Empty
+            rpc :DeleteSessionEntityType, ::Google::Cloud::Dialogflow::V2::DeleteSessionEntityTypeRequest, ::Google::Protobuf::Empty
           end
 
           Stub = Service.rpc_stub_class

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

@@ -31,23 +31,7 @@ module Google
     module Dialogflow
       module V2
         ##
-        # Entities are extracted from user input and represent parameters that are
-        # meaningful to your application. For example, a date range, a proper name
-        # such as a geographic location or landmark, and so on. Entities represent
-        # actionable data for your application.
-        #
-        # Session entity types are referred to as **User** entity types and are
-        # entities that are built for an individual user such as
-        # favorites, preferences, playlists, and so on. You can redefine a session
-        # entity type at the session level.
-        #
-        # Session entity methods do not work with Google Assistant integration.
-        # Contact Dialogflow support if you need to use session entities
-        # with Google Assistant integration.
-        #
-        # For more information about entity types, see the
-        # [Dialogflow
-        # documentation](https://cloud.google.com/dialogflow/docs/entities-overview).
+        # Service for managing {::Google::Cloud::Dialogflow::V2::SessionEntityType SessionEntityTypes}.
         #
         # To load this service and instantiate a client:
         #

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

@@ -27,23 +27,7 @@ module Google
           ##
           # Client for the SessionEntityTypes service.
           #
-          # Entities are extracted from user input and represent parameters that are
-          # meaningful to your application. For example, a date range, a proper name
-          # such as a geographic location or landmark, and so on. Entities represent
-          # actionable data for your application.
-          #
-          # Session entity types are referred to as **User** entity types and are
-          # entities that are built for an individual user such as
-          # favorites, preferences, playlists, and so on. You can redefine a session
-          # entity type at the session level.
-          #
-          # Session entity methods do not work with Google Assistant integration.
-          # Contact Dialogflow support if you need to use session entities
-          # with Google Assistant integration.
-          #
-          # For more information about entity types, see the
-          # [Dialogflow
-          # documentation](https://cloud.google.com/dialogflow/docs/entities-overview).
+          # Service for managing {::Google::Cloud::Dialogflow::V2::SessionEntityType SessionEntityTypes}.
           #
           class Client
             include Paths
@@ -76,37 +60,17 @@ module Google
                 parent_config = while namespace.any?
                                   parent_name = namespace.join "::"
                                   parent_const = const_get parent_name
-                                  break parent_const.configure if parent_const&.respond_to? :configure
+                                  break parent_const.configure if parent_const.respond_to? :configure
                                   namespace.pop
                                 end
                 default_config = Client::Configuration.new parent_config
 
-                default_config.rpcs.list_session_entity_types.timeout = 60.0
-                default_config.rpcs.list_session_entity_types.retry_policy = {
-                  initial_delay: 0.1,
-                  max_delay:     60.0,
-                  multiplier:    1.3,
-                  retry_codes:   ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
-                }
-
-                default_config.rpcs.get_session_entity_type.timeout = 60.0
-                default_config.rpcs.get_session_entity_type.retry_policy = {
-                  initial_delay: 0.1,
-                  max_delay:     60.0,
-                  multiplier:    1.3,
-                  retry_codes:   ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
-                }
-
-                default_config.rpcs.create_session_entity_type.timeout = 60.0
-
-                default_config.rpcs.update_session_entity_type.timeout = 60.0
-
-                default_config.rpcs.delete_session_entity_type.timeout = 60.0
-                default_config.rpcs.delete_session_entity_type.retry_policy = {
+                default_config.timeout = 60.0
+                default_config.retry_policy = {
                   initial_delay: 0.1,
-                  max_delay:     60.0,
-                  multiplier:    1.3,
-                  retry_codes:   ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
+                max_delay: 60.0,
+                multiplier: 1.3,
+                retry_codes: [14]
                 }
 
                 default_config
@@ -170,7 +134,13 @@ module Google
 
               # Create credentials
               credentials = @config.credentials
-              credentials ||= Credentials.default scope: @config.scope
+              # Use self-signed JWT if the scope and endpoint are unchanged from default,
+              # but only if the default endpoint does not have a region prefix.
+              enable_self_signed_jwt = @config.scope == Client.configure.scope &&
+                                       @config.endpoint == Client.configure.endpoint &&
+                                       !@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)
                 credentials = Credentials.new credentials, scope: @config.scope
               end
@@ -658,14 +628,14 @@ module Google
 
               config_attr :endpoint,      "dialogflow.googleapis.com", ::String
               config_attr :credentials,   nil do |value|
-                allowed = [::String, ::Hash, ::Proc, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
+                allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
                 allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
                 allowed.any? { |klass| klass === value }
               end
               config_attr :scope,         nil, ::String, ::Array, nil
               config_attr :lib_name,      nil, ::String, nil
               config_attr :lib_version,   nil, ::String, nil
-              config_attr(:channel_args,  { "grpc.service_config_disable_resolution"=>1 }, ::Hash, nil)
+              config_attr(:channel_args,  { "grpc.service_config_disable_resolution" => 1 }, ::Hash, nil)
               config_attr :interceptors,  nil, ::Array, nil
               config_attr :timeout,       nil, ::Numeric, nil
               config_attr :metadata,      nil, ::Hash, nil
@@ -686,7 +656,7 @@ module Google
               def rpcs
                 @rpcs ||= begin
                   parent_rpcs = nil
-                  parent_rpcs = @parent_config.rpcs if @parent_config&.respond_to? :rpcs
+                  parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
                   Rpcs.new parent_rpcs
                 end
               end
@@ -698,7 +668,7 @@ module Google
               # Each configuration object is of type `Gapic::Config::Method` and includes
               # the following configuration fields:
               #
-              #  *  `timeout` (*type:* `Numeric`) - The call timeout in milliseconds
+              #  *  `timeout` (*type:* `Numeric`) - The call timeout in seconds
               #  *  `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
               #  *  `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
               #     include the following keys:
@@ -737,15 +707,15 @@ module Google
 
                 # @private
                 def initialize parent_rpcs = nil
-                  list_session_entity_types_config = parent_rpcs&.list_session_entity_types if parent_rpcs&.respond_to? :list_session_entity_types
+                  list_session_entity_types_config = parent_rpcs.list_session_entity_types if parent_rpcs.respond_to? :list_session_entity_types
                   @list_session_entity_types = ::Gapic::Config::Method.new list_session_entity_types_config
-                  get_session_entity_type_config = parent_rpcs&.get_session_entity_type if parent_rpcs&.respond_to? :get_session_entity_type
+                  get_session_entity_type_config = parent_rpcs.get_session_entity_type if parent_rpcs.respond_to? :get_session_entity_type
                   @get_session_entity_type = ::Gapic::Config::Method.new get_session_entity_type_config
-                  create_session_entity_type_config = parent_rpcs&.create_session_entity_type if parent_rpcs&.respond_to? :create_session_entity_type
+                  create_session_entity_type_config = parent_rpcs.create_session_entity_type if parent_rpcs.respond_to? :create_session_entity_type
                   @create_session_entity_type = ::Gapic::Config::Method.new create_session_entity_type_config
-                  update_session_entity_type_config = parent_rpcs&.update_session_entity_type if parent_rpcs&.respond_to? :update_session_entity_type
+                  update_session_entity_type_config = parent_rpcs.update_session_entity_type if parent_rpcs.respond_to? :update_session_entity_type
                   @update_session_entity_type = ::Gapic::Config::Method.new update_session_entity_type_config
-                  delete_session_entity_type_config = parent_rpcs&.delete_session_entity_type if parent_rpcs&.respond_to? :delete_session_entity_type
+                  delete_session_entity_type_config = parent_rpcs.delete_session_entity_type if parent_rpcs.respond_to? :delete_session_entity_type
                   @delete_session_entity_type = ::Gapic::Config::Method.new delete_session_entity_type_config
 
                   yield self if block_given?