google-api-client 0.24.3 → 0.25.0

data/generated/google/apis/dialogflow_v2/classes.rb

@@ -384,7 +384,7 @@ module Google
       
         # Optional. The number of conversational query requests after which the
         # context expires. If set to `0` (the default) the context expires
-        # immediately. Contexts expire automatically after 10 minutes even if there
+        # immediately. Contexts expire automatically after 20 minutes even if there
         # are no matching queries.
         # Corresponds to the JSON property `lifespanCount`
         # @return [Fixnum]
@@ -535,7 +535,7 @@ module Google
         # @return [String]
         attr_accessor :auto_expansion_mode
       
-        # Required. The name of the entity.
+        # Required. The name of the entity type.
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
@@ -1981,9 +1981,9 @@ module Google
         attr_accessor :reset_contexts
         alias_method :reset_contexts?, :reset_contexts
       
-        # Optional. The collection of session entity types to replace or extend
-        # developer entities with for this query only. The entity synonyms apply
-        # to all languages.
+        # Optional. Additional session entity types to replace or extend developer
+        # entity types with. The entity synonyms apply to all languages and persist
+        # for the session of this query.
         # Corresponds to the JSON property `sessionEntityTypes`
         # @return [Array<Google::Apis::DialogflowV2::GoogleCloudDialogflowV2SessionEntityType>]
         attr_accessor :session_entity_types
@@ -2229,6 +2229,8 @@ module Google
         # Required. The unique identifier of this session entity type. Format:
         # `projects/<Project ID>/agent/sessions/<Session ID>/entityTypes/<Entity Type
         # Display Name>`.
+        # `<Entity Type Display Name>` must be the display name of an existing entity
+        # type in the same agent that will be overridden or supplemented.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -2310,7 +2312,9 @@ module Google
       
         # The unique identifier of detectIntent request session.
         # Can be used to identify end-user inside webhook implementation.
-        # Format: `projects/<Project ID>/agent/sessions/<Session ID>`.
+        # Format: `projects/<Project ID>/agent/sessions/<Session ID>`, or
+        # `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
+        # ID>/sessions/<Session ID>`.
         # Corresponds to the JSON property `session`
         # @return [String]
         attr_accessor :session
@@ -2485,6 +2489,77 @@ module Google
         end
       end
       
+      # Represents a notification sent to Cloud Pub/Sub subscribers for conversation
+      # lifecycle events.
+      class GoogleCloudDialogflowV2beta1ConversationEvent
+        include Google::Apis::Core::Hashable
+      
+        # Required. The unique identifier of the conversation this notification
+        # refers to. Format: `projects/<Project ID>/conversations/<Conversation ID>`.
+        # Corresponds to the JSON property `conversation`
+        # @return [String]
+        attr_accessor :conversation
+      
+        # The `Status` type defines a logical error model that is suitable for different
+        # programming environments, including REST APIs and RPC APIs. It is used by
+        # [gRPC](https://github.com/grpc). The error model is designed to be:
+        # - Simple to use and understand for most users
+        # - Flexible enough to meet unexpected needs
+        # # Overview
+        # The `Status` message contains three pieces of data: error code, error message,
+        # and error details. The error code should be an enum value of
+        # google.rpc.Code, but it may accept additional error codes if needed.  The
+        # error message should be a developer-facing English message that helps
+        # developers *understand* and *resolve* the error. If a localized user-facing
+        # error message is needed, put the localized message in the error details or
+        # localize it in the client. The optional error details may contain arbitrary
+        # information about the error. There is a predefined set of error detail types
+        # in the package `google.rpc` that can be used for common error conditions.
+        # # Language mapping
+        # The `Status` message is the logical representation of the error model, but it
+        # is not necessarily the actual wire format. When the `Status` message is
+        # exposed in different client libraries and different wire protocols, it can be
+        # mapped differently. For example, it will likely be mapped to some exceptions
+        # in Java, but more likely mapped to some error codes in C.
+        # # Other uses
+        # The error model and the `Status` message can be used in a variety of
+        # environments, either with or without APIs, to provide a
+        # consistent developer experience across different environments.
+        # Example uses of this error model include:
+        # - Partial errors. If a service needs to return partial errors to the client,
+        # it may embed the `Status` in the normal response to indicate the partial
+        # errors.
+        # - Workflow errors. A typical workflow has multiple steps. Each step may
+        # have a `Status` message for error reporting.
+        # - Batch operations. If a client uses batch request and batch response, the
+        # `Status` message should be used directly inside batch response, one for
+        # each error sub-response.
+        # - Asynchronous operations. If an API call embeds asynchronous operation
+        # results in its response, the status of those operations should be
+        # represented directly using the `Status` message.
+        # - Logging. If some API errors are stored in logs, the message `Status` could
+        # be used directly after any stripping needed for security/privacy reasons.
+        # Corresponds to the JSON property `errorStatus`
+        # @return [Google::Apis::DialogflowV2::GoogleRpcStatus]
+        attr_accessor :error_status
+      
+        # Required. The type of the event that this notification refers to.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @conversation = args[:conversation] if args.key?(:conversation)
+          @error_status = args[:error_status] if args.key?(:error_status)
+          @type = args[:type] if args.key?(:type)
+        end
+      end
+      
       # Represents an entity type.
       # Entity types serve as a tool for extracting parameter values from natural
       # language queries.
@@ -2497,7 +2572,7 @@ module Google
         # @return [String]
         attr_accessor :auto_expansion_mode
       
-        # Required. The name of the entity.
+        # Required. The name of the entity type.
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
@@ -2643,6 +2718,33 @@ module Google
         end
       end
       
+      # Represents a notification sent to Cloud Pub/Sub subscribers for
+      # agent assistant events in a specific conversation.
+      class GoogleCloudDialogflowV2beta1HumanAgentAssistantEvent
+        include Google::Apis::Core::Hashable
+      
+        # Required. The conversation this notification refers to.
+        # Format: `projects/<Project ID>/conversations/<Conversation ID>`.
+        # Corresponds to the JSON property `conversation`
+        # @return [String]
+        attr_accessor :conversation
+      
+        # Required. The type of the event that this notification refers to.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @conversation = args[:conversation] if args.key?(:conversation)
+          @type = args[:type] if args.key?(:type)
+        end
+      end
+      
       # Represents an intent.
       # Intents convert a number of user expressions or patterns into an action. An
       # action is an extraction of a user command or sentence semantics.
@@ -4055,7 +4157,9 @@ module Google
       
         # The unique identifier of detectIntent request session.
         # Can be used to identify end-user inside webhook implementation.
-        # Format: `projects/<Project ID>/agent/sessions/<Session ID>`.
+        # Format: `projects/<Project ID>/agent/sessions/<Session ID>`, or
+        # `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
+        # ID>/sessions/<Session ID>`.
         # Corresponds to the JSON property `session`
         # @return [String]
         attr_accessor :session

data/generated/google/apis/dialogflow_v2/representations.rb

@@ -406,6 +406,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudDialogflowV2beta1ConversationEvent
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudDialogflowV2beta1EntityType
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -430,6 +436,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudDialogflowV2beta1HumanAgentAssistantEvent
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudDialogflowV2beta1Intent
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1324,6 +1336,16 @@ module Google
         end
       end
       
+      class GoogleCloudDialogflowV2beta1ConversationEvent
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :conversation, as: 'conversation'
+          property :error_status, as: 'errorStatus', class: Google::Apis::DialogflowV2::GoogleRpcStatus, decorator: Google::Apis::DialogflowV2::GoogleRpcStatus::Representation
+      
+          property :type, as: 'type'
+        end
+      end
+      
       class GoogleCloudDialogflowV2beta1EntityType
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1361,6 +1383,14 @@ module Google
         end
       end
       
+      class GoogleCloudDialogflowV2beta1HumanAgentAssistantEvent
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :conversation, as: 'conversation'
+          property :type, as: 'type'
+        end
+      end
+      
       class GoogleCloudDialogflowV2beta1Intent
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/generated/google/apis/dialogflow_v2/service.rb

@@ -22,8 +22,8 @@ module Google
     module DialogflowV2
       # Dialogflow API
       #
-      # An end-to-end development suite for conversational interfaces (e.g., chatbots,
-      #  voice-powered apps and devices).
+      # Builds conversational interfaces (for example, chatbots, and voice-powered
+      #  apps and devices).
       #
       # @example
       #    require 'google/apis/dialogflow_v2'
@@ -1010,6 +1010,7 @@ module Google
         end
         
         # Creates a context.
+        # If the specified context already exists, overrides the context.
         # @param [String] parent
         #   Required. The session to create a context for.
         #   Format: `projects/<Project ID>/agent/sessions/<Session ID>`.
@@ -1181,6 +1182,8 @@ module Google
         end
         
         # Creates a session entity type.
+        # If the specified session entity type already exists, overrides the session
+        # entity type.
         # @param [String] parent
         #   Required. The session to create a session entity type for.
         #   Format: `projects/<Project ID>/agent/sessions/<Session ID>`.
@@ -1321,6 +1324,8 @@ module Google
         #   Required. The unique identifier of this session entity type. Format:
         #   `projects/<Project ID>/agent/sessions/<Session ID>/entityTypes/<Entity Type
         #   Display Name>`.
+        #   `<Entity Type Display Name>` must be the display name of an existing entity
+        #   type in the same agent that will be overridden or supplemented.
         # @param [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2SessionEntityType] google_cloud_dialogflow_v2_session_entity_type_object
         # @param [String] update_mask
         #   Optional. The mask to control which fields get updated.

data/generated/google/apis/dialogflow_v2beta1.rb

@@ -20,16 +20,19 @@ module Google
   module Apis
     # Dialogflow API
     #
-    # An end-to-end development suite for conversational interfaces (e.g., chatbots,
-    # voice-powered apps and devices).
+    # Builds conversational interfaces (for example, chatbots, and voice-powered
+    # apps and devices).
     #
     # @see https://cloud.google.com/dialogflow-enterprise/
     module DialogflowV2beta1
       VERSION = 'V2beta1'
-      REVISION = '20180920'
+      REVISION = '20181022'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
+
+      # View, manage and query your Dialogflow agents
+      AUTH_DIALOGFLOW = 'https://www.googleapis.com/auth/dialogflow'
     end
   end
 end

data/generated/google/apis/dialogflow_v2beta1/classes.rb

@@ -66,7 +66,7 @@ module Google
       
         # Optional. The number of conversational query requests after which the
         # context expires. If set to `0` (the default) the context expires
-        # immediately. Contexts expire automatically after 10 minutes even if there
+        # immediately. Contexts expire automatically after 20 minutes even if there
         # are no matching queries.
         # Corresponds to the JSON property `lifespanCount`
         # @return [Fixnum]
@@ -109,7 +109,7 @@ module Google
         # @return [String]
         attr_accessor :auto_expansion_mode
       
-        # Required. The name of the entity.
+        # Required. The name of the entity type.
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
@@ -1375,7 +1375,9 @@ module Google
       
         # The unique identifier of detectIntent request session.
         # Can be used to identify end-user inside webhook implementation.
-        # Format: `projects/<Project ID>/agent/sessions/<Session ID>`.
+        # Format: `projects/<Project ID>/agent/sessions/<Session ID>`, or
+        # `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
+        # ID>/sessions/<Session ID>`.
         # Corresponds to the JSON property `session`
         # @return [String]
         attr_accessor :session
@@ -1868,6 +1870,77 @@ module Google
         end
       end
       
+      # Represents a notification sent to Cloud Pub/Sub subscribers for conversation
+      # lifecycle events.
+      class GoogleCloudDialogflowV2beta1ConversationEvent
+        include Google::Apis::Core::Hashable
+      
+        # Required. The unique identifier of the conversation this notification
+        # refers to. Format: `projects/<Project ID>/conversations/<Conversation ID>`.
+        # Corresponds to the JSON property `conversation`
+        # @return [String]
+        attr_accessor :conversation
+      
+        # The `Status` type defines a logical error model that is suitable for different
+        # programming environments, including REST APIs and RPC APIs. It is used by
+        # [gRPC](https://github.com/grpc). The error model is designed to be:
+        # - Simple to use and understand for most users
+        # - Flexible enough to meet unexpected needs
+        # # Overview
+        # The `Status` message contains three pieces of data: error code, error message,
+        # and error details. The error code should be an enum value of
+        # google.rpc.Code, but it may accept additional error codes if needed.  The
+        # error message should be a developer-facing English message that helps
+        # developers *understand* and *resolve* the error. If a localized user-facing
+        # error message is needed, put the localized message in the error details or
+        # localize it in the client. The optional error details may contain arbitrary
+        # information about the error. There is a predefined set of error detail types
+        # in the package `google.rpc` that can be used for common error conditions.
+        # # Language mapping
+        # The `Status` message is the logical representation of the error model, but it
+        # is not necessarily the actual wire format. When the `Status` message is
+        # exposed in different client libraries and different wire protocols, it can be
+        # mapped differently. For example, it will likely be mapped to some exceptions
+        # in Java, but more likely mapped to some error codes in C.
+        # # Other uses
+        # The error model and the `Status` message can be used in a variety of
+        # environments, either with or without APIs, to provide a
+        # consistent developer experience across different environments.
+        # Example uses of this error model include:
+        # - Partial errors. If a service needs to return partial errors to the client,
+        # it may embed the `Status` in the normal response to indicate the partial
+        # errors.
+        # - Workflow errors. A typical workflow has multiple steps. Each step may
+        # have a `Status` message for error reporting.
+        # - Batch operations. If a client uses batch request and batch response, the
+        # `Status` message should be used directly inside batch response, one for
+        # each error sub-response.
+        # - Asynchronous operations. If an API call embeds asynchronous operation
+        # results in its response, the status of those operations should be
+        # represented directly using the `Status` message.
+        # - Logging. If some API errors are stored in logs, the message `Status` could
+        # be used directly after any stripping needed for security/privacy reasons.
+        # Corresponds to the JSON property `errorStatus`
+        # @return [Google::Apis::DialogflowV2beta1::GoogleRpcStatus]
+        attr_accessor :error_status
+      
+        # Required. The type of the event that this notification refers to.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @conversation = args[:conversation] if args.key?(:conversation)
+          @error_status = args[:error_status] if args.key?(:error_status)
+          @type = args[:type] if args.key?(:type)
+        end
+      end
+      
       # The request to detect user's intent.
       class GoogleCloudDialogflowV2beta1DetectIntentRequest
         include Google::Apis::Core::Hashable
@@ -2009,6 +2082,8 @@ module Google
       end
       
       # A document resource.
+      # Note: resource `projects.agent.knowledgeBases.documents` is deprecated,
+      # please use `projects.knowledgeBases.documents` instead.
       class GoogleCloudDialogflowV2beta1Document
         include Google::Apis::Core::Hashable
       
@@ -2090,7 +2165,7 @@ module Google
         # @return [String]
         attr_accessor :auto_expansion_mode
       
-        # Required. The name of the entity.
+        # Required. The name of the entity type.
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
@@ -2278,6 +2353,33 @@ module Google
         end
       end
       
+      # Represents a notification sent to Cloud Pub/Sub subscribers for
+      # agent assistant events in a specific conversation.
+      class GoogleCloudDialogflowV2beta1HumanAgentAssistantEvent
+        include Google::Apis::Core::Hashable
+      
+        # Required. The conversation this notification refers to.
+        # Format: `projects/<Project ID>/conversations/<Conversation ID>`.
+        # Corresponds to the JSON property `conversation`
+        # @return [String]
+        attr_accessor :conversation
+      
+        # Required. The type of the event that this notification refers to.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @conversation = args[:conversation] if args.key?(:conversation)
+          @type = args[:type] if args.key?(:type)
+        end
+      end
+      
       # The request message for Agents.ImportAgent.
       class GoogleCloudDialogflowV2beta1ImportAgentRequest
         include Google::Apis::Core::Hashable
@@ -3536,6 +3638,8 @@ module Google
       end
       
       # Represents knowledge base resource.
+      # Note: resource `projects.agent.knowledgeBases` is deprecated, please use
+      # `projects.knowledgeBases` instead.
       class GoogleCloudDialogflowV2beta1KnowledgeBase
         include Google::Apis::Core::Hashable
       
@@ -3905,9 +4009,9 @@ module Google
         # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1SentimentAnalysisRequestConfig]
         attr_accessor :sentiment_analysis_request_config
       
-        # Optional. The collection of session entity types to replace or extend
-        # developer entities with for this query only. The entity synonyms apply
-        # to all languages.
+        # Optional. Additional session entity types to replace or extend developer
+        # entity types with. The entity synonyms apply to all languages and persist
+        # for the session of this query.
         # Corresponds to the JSON property `sessionEntityTypes`
         # @return [Array<Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1SessionEntityType>]
         attr_accessor :session_entity_types
@@ -4243,6 +4347,8 @@ module Google
         # ID>/sessions/<Session ID>/entityTypes/<Entity Type Display Name>`.
         # If `Environment ID` is not specified, we assume default 'draft'
         # environment. If `User ID` is not specified, we assume default '-' user.
+        # `<Entity Type Display Name>` must be the display name of an existing entity
+        # type in the same agent that will be overridden or supplemented.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -4416,7 +4522,9 @@ module Google
       
         # The unique identifier of detectIntent request session.
         # Can be used to identify end-user inside webhook implementation.
-        # Format: `projects/<Project ID>/agent/sessions/<Session ID>`.
+        # Format: `projects/<Project ID>/agent/sessions/<Session ID>`, or
+        # `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
+        # ID>/sessions/<Session ID>`.
         # Corresponds to the JSON property `session`
         # @return [String]
         attr_accessor :session