google-api-client 0.28.4 → 0.28.5

data/generated/google/apis/dialogflow_v2beta1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/dialogflow-enterprise/
     module DialogflowV2beta1
       VERSION = 'V2beta1'
-      REVISION = '20190122'
+      REVISION = '20190318'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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 20 minutes even if there
+        # immediately. Contexts expire automatically after 20 minutes if there
         # are no matching queries.
         # Corresponds to the JSON property `lifespanCount`
         # @return [Fixnum]
@@ -81,8 +81,10 @@ module Google
         attr_accessor :name
       
         # Optional. The collection of parameters associated with this context.
-        # Refer to [this doc](https://dialogflow.com/docs/actions-and-parameters) for
-        # syntax.
+        # Refer to [this
+        # doc](https://cloud.google.com/dialogflow-enterprise/docs/intents-actions-
+        # parameters)
+        # for syntax.
         # Corresponds to the JSON property `parameters`
         # @return [Hash<String,Object>]
         attr_accessor :parameters
@@ -193,9 +195,10 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Required. The language of this query. See [Language
-        # Support](https://dialogflow.com/docs/languages) for a list of the
-        # currently supported language codes. Note that queries in the same session
-        # do not necessarily need to specify the same language.
+        # Support](https://cloud.google.com/dialogflow-enterprise/docs/reference/
+        # language)
+        # for a list of the currently supported language codes. Note that queries in
+        # the same session do not necessarily need to specify the same language.
         # Corresponds to the JSON property `languageCode`
         # @return [String]
         attr_accessor :language_code
@@ -1112,9 +1115,20 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # Required. The collection of training phrase parts (can be annotated).
-        # Fields: `entity_type`, `alias` and `user_defined` should be populated
-        # only for the annotated parts of the training phrase.
+        # Required. The ordered list of training phrase parts.
+        # The parts are concatenated in order to form the training phrase.
+        # Note: The API does not automatically annotate training phrases like the
+        # Dialogflow Console does.
+        # Note: Do not forget to include whitespace at part boundaries,
+        # so the training phrase is well formatted when the parts are concatenated.
+        # If the training phrase does not need to be annotated with parameters,
+        # you just need a single part with only the Part.text field set.
+        # If you want to annotate the training phrase, you must create multiple
+        # parts, where the fields of each part are populated in one of two ways:
+        # -   `Part.text` is set to a part of the phrase that has no parameters.
+        # -   `Part.text` is set to a part of the phrase that you want to annotate,
+        # and the `entity_type`, `alias`, and `user_defined` fields are all
+        # set.
         # Corresponds to the JSON property `parts`
         # @return [Array<Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2IntentTrainingPhrasePart>]
         attr_accessor :parts
@@ -1150,26 +1164,26 @@ module Google
       
         # Optional. The parameter name for the value extracted from the
         # annotated part of the example.
+        # This field is required for annotated parts of the training phrase.
         # Corresponds to the JSON property `alias`
         # @return [String]
         attr_accessor :alias
       
-        # Optional. The entity type name prefixed with `@`. This field is
-        # required for the annotated part of the text and applies only to
-        # examples.
+        # Optional. The entity type name prefixed with `@`.
+        # This field is required for annotated parts of the training phrase.
         # Corresponds to the JSON property `entityType`
         # @return [String]
         attr_accessor :entity_type
       
-        # Required. The text corresponding to the example,
-        # if there are no annotations. For
-        # annotated examples, it is the text for one of the example's parts.
+        # Required. The text for this part.
         # Corresponds to the JSON property `text`
         # @return [String]
         attr_accessor :text
       
-        # Optional. Indicates whether the text was manually annotated by the
-        # developer.
+        # Optional. Indicates whether the text was manually annotated.
+        # This field is set to true when the Dialogflow Console is used to
+        # manually annotate the part. When creating an annotated part with the
+        # API, you must set this to true.
         # Corresponds to the JSON property `userDefined`
         # @return [Boolean]
         attr_accessor :user_defined
@@ -1286,7 +1300,9 @@ module Google
         attr_accessor :intent_detection_confidence
       
         # The language that was triggered during intent detection.
-        # See [Language Support](https://dialogflow.com/docs/reference/language)
+        # See [Language
+        # Support](https://cloud.google.com/dialogflow-enterprise/docs/reference/
+        # language)
         # for a list of the currently supported language codes.
         # Corresponds to the JSON property `languageCode`
         # @return [String]
@@ -1489,7 +1505,10 @@ module Google
       
         # Optional. The URI of the agent's avatar.
         # Avatars are used throughout the Dialogflow console and in the self-hosted
-        # [Web Demo](https://dialogflow.com/docs/integrations/web-demo) integration.
+        # [Web
+        # Demo](https://cloud.google.com/dialogflow-enterprise/docs/integrations/web-
+        # demo)
+        # integration.
         # Corresponds to the JSON property `avatarUri`
         # @return [String]
         attr_accessor :avatar_uri
@@ -1497,7 +1516,7 @@ module Google
         # 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
-        # the threshold value, then a fallback intent is be triggered or, if there
+        # the threshold value, then a fallback intent will be triggered or, if there
         # are no fallback intents defined, no intent will be triggered. The score
         # values range from 0.0 (completely uncertain) to 1.0 (completely certain).
         # If set to 0.0, the default of 0.3 is used.
@@ -1506,9 +1525,11 @@ module Google
         attr_accessor :classification_threshold
       
         # Required. The default language of the agent as a language tag. See
-        # [Language Support](https://dialogflow.com/docs/reference/language) for a
-        # list of the currently supported language codes.
-        # This field cannot be set by the `Update` method.
+        # [Language
+        # Support](https://cloud.google.com/dialogflow-enterprise/docs/reference/
+        # language)
+        # for a list of the currently supported language codes. This field cannot be
+        # set by the `Update` method.
         # Corresponds to the JSON property `defaultLanguageCode`
         # @return [String]
         attr_accessor :default_language_code
@@ -1584,9 +1605,11 @@ module Google
       
         # Optional. The language of entity synonyms defined in `entities`. If not
         # specified, the agent's default language is used.
-        # [More than a dozen
-        # languages](https://dialogflow.com/docs/reference/language) are supported.
-        # Note: languages must be enabled in the agent, before they can be used.
+        # [Many
+        # languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/
+        # language)
+        # are supported. Note: languages must be enabled in the agent before they can
+        # be used.
         # Corresponds to the JSON property `languageCode`
         # @return [String]
         attr_accessor :language_code
@@ -1615,9 +1638,11 @@ module Google
       
         # Optional. The language of entity synonyms defined in `entities`. If not
         # specified, the agent's default language is used.
-        # [More than a dozen
-        # languages](https://dialogflow.com/docs/reference/language) are supported.
-        # Note: languages must be enabled in the agent, before they can be used.
+        # [Many
+        # languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/
+        # language)
+        # are supported. Note: languages must be enabled in the agent before they can
+        # be used.
         # Corresponds to the JSON property `languageCode`
         # @return [String]
         attr_accessor :language_code
@@ -1684,9 +1709,11 @@ module Google
       
         # Optional. The language of entity synonyms defined in `entities`. If not
         # specified, the agent's default language is used.
-        # [More than a dozen
-        # languages](https://dialogflow.com/docs/reference/language) are supported.
-        # Note: languages must be enabled in the agent, before they can be used.
+        # [Many
+        # languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/
+        # language)
+        # are supported. Note: languages must be enabled in the agent before they can
+        # be used.
         # Corresponds to the JSON property `languageCode`
         # @return [String]
         attr_accessor :language_code
@@ -1727,9 +1754,11 @@ module Google
       
         # Optional. The language of entity synonyms defined in `entity_types`. If not
         # specified, the agent's default language is used.
-        # [More than a dozen
-        # languages](https://dialogflow.com/docs/reference/language) are supported.
-        # Note: languages must be enabled in the agent, before they can be used.
+        # [Many
+        # languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/
+        # language)
+        # are supported. Note: languages must be enabled in the agent before they can
+        # be used.
         # Corresponds to the JSON property `languageCode`
         # @return [String]
         attr_accessor :language_code
@@ -1794,9 +1823,11 @@ module Google
       
         # Optional. The language of training phrases, parameters and rich messages
         # defined in `intents`. If not specified, the agent's default language is
-        # used. [More than a dozen
-        # languages](https://dialogflow.com/docs/reference/language) are supported.
-        # Note: languages must be enabled in the agent, before they can be used.
+        # used. [Many
+        # languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/
+        # language)
+        # are supported. Note: languages must be enabled in the agent before they can
+        # be used.
         # Corresponds to the JSON property `languageCode`
         # @return [String]
         attr_accessor :language_code
@@ -1845,7 +1876,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 if there
         # are no matching queries.
         # Corresponds to the JSON property `lifespanCount`
         # @return [Fixnum]
@@ -1864,8 +1895,10 @@ module Google
         attr_accessor :name
       
         # Optional. The collection of parameters associated with this context.
-        # Refer to [this doc](https://dialogflow.com/docs/actions-and-parameters) for
-        # syntax.
+        # Refer to [this
+        # doc](https://cloud.google.com/dialogflow-enterprise/docs/intents-actions-
+        # parameters)
+        # for syntax.
         # Corresponds to the JSON property `parameters`
         # @return [Hash<String,Object>]
         attr_accessor :parameters
@@ -1969,14 +2002,14 @@ module Google
         # @return [String]
         attr_accessor :response_id
       
-        # 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:
+        # 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
+        # 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
@@ -2212,9 +2245,10 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Required. The language of this query. See [Language
-        # Support](https://dialogflow.com/docs/languages) for a list of the
-        # currently supported language codes. Note that queries in the same session
-        # do not necessarily need to specify the same language.
+        # Support](https://cloud.google.com/dialogflow-enterprise/docs/reference/
+        # language)
+        # for a list of the currently supported language codes. Note that queries in
+        # the same session do not necessarily need to specify the same language.
         # Corresponds to the JSON property `languageCode`
         # @return [String]
         attr_accessor :language_code
@@ -2355,9 +2389,10 @@ module Google
       
         # Required. The language of the supplied audio. Dialogflow does not do
         # translations. See [Language
-        # Support](https://dialogflow.com/docs/languages) for a list of the
-        # currently supported language codes. Note that queries in the same session
-        # do not necessarily need to specify the same language.
+        # Support](https://cloud.google.com/dialogflow-enterprise/docs/reference/
+        # language)
+        # for a list of the currently supported language codes. Note that queries in
+        # the same session do not necessarily need to specify the same language.
         # Corresponds to the JSON property `languageCode`
         # @return [String]
         attr_accessor :language_code
@@ -3409,9 +3444,20 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # Required. The collection of training phrase parts (can be annotated).
-        # Fields: `entity_type`, `alias` and `user_defined` should be populated
-        # only for the annotated parts of the training phrase.
+        # Required. The ordered list of training phrase parts.
+        # The parts are concatenated in order to form the training phrase.
+        # Note: The API does not automatically annotate training phrases like the
+        # Dialogflow Console does.
+        # Note: Do not forget to include whitespace at part boundaries,
+        # so the training phrase is well formatted when the parts are concatenated.
+        # If the training phrase does not need to be annotated with parameters,
+        # you just need a single part with only the Part.text field set.
+        # If you want to annotate the training phrase, you must create multiple
+        # parts, where the fields of each part are populated in one of two ways:
+        # -   `Part.text` is set to a part of the phrase that has no parameters.
+        # -   `Part.text` is set to a part of the phrase that you want to annotate,
+        # and the `entity_type`, `alias`, and `user_defined` fields are all
+        # set.
         # Corresponds to the JSON property `parts`
         # @return [Array<Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1IntentTrainingPhrasePart>]
         attr_accessor :parts
@@ -3447,26 +3493,26 @@ module Google
       
         # Optional. The parameter name for the value extracted from the
         # annotated part of the example.
+        # This field is required for annotated parts of the training phrase.
         # Corresponds to the JSON property `alias`
         # @return [String]
         attr_accessor :alias
       
-        # Optional. The entity type name prefixed with `@`. This field is
-        # required for the annotated part of the text and applies only to
-        # examples.
+        # Optional. The entity type name prefixed with `@`.
+        # This field is required for annotated parts of the training phrase.
         # Corresponds to the JSON property `entityType`
         # @return [String]
         attr_accessor :entity_type
       
-        # Required. The text corresponding to the example,
-        # if there are no annotations. For
-        # annotated examples, it is the text for one of the example's parts.
+        # Required. The text for this part.
         # Corresponds to the JSON property `text`
         # @return [String]
         attr_accessor :text
       
-        # Optional. Indicates whether the text was manually annotated by the
-        # developer.
+        # Optional. Indicates whether the text was manually annotated.
+        # This field is set to true when the Dialogflow Console is used to
+        # manually annotate the part. When creating an annotated part with the
+        # API, you must set this to true.
         # Corresponds to the JSON property `userDefined`
         # @return [Boolean]
         attr_accessor :user_defined
@@ -4025,7 +4071,9 @@ module Google
         attr_accessor :knowledge_answers
       
         # The language that was triggered during intent detection.
-        # See [Language Support](https://dialogflow.com/docs/reference/language)
+        # See [Language
+        # Support](https://cloud.google.com/dialogflow-enterprise/docs/reference/
+        # language)
         # for a list of the currently supported language codes.
         # Corresponds to the JSON property `languageCode`
         # @return [String]
@@ -4368,9 +4416,10 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Required. The language of this conversational query. See [Language
-        # Support](https://dialogflow.com/docs/languages) for a list of the
-        # currently supported language codes. Note that queries in the same session
-        # do not necessarily need to specify the same language.
+        # Support](https://cloud.google.com/dialogflow-enterprise/docs/reference/
+        # language)
+        # for a list of the currently supported language codes. Note that queries in
+        # the same session do not necessarily need to specify the same language.
         # Corresponds to the JSON property `languageCode`
         # @return [String]
         attr_accessor :language_code
@@ -4583,14 +4632,14 @@ module Google
         attr_accessor :done
         alias_method :done?, :done
       
-        # 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:
+        # 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
+        # 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
@@ -4686,14 +4735,14 @@ module Google
         end
       end
       
-      # 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:
+      # 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
+      # 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

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

@@ -346,9 +346,11 @@ module Google
         # @param [String] language_code
         #   Optional. The language of entity synonyms defined in `entity_type`. If not
         #   specified, the agent's default language is used.
-        #   [More than a dozen
-        #   languages](https://dialogflow.com/docs/reference/language) are supported.
-        #   Note: languages must be enabled in the agent, before they can be used.
+        #   [Many
+        #   languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/
+        #   language)
+        #   are supported. Note: languages must be enabled in the agent before they can
+        #   be used.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -417,9 +419,11 @@ module Google
         # @param [String] language_code
         #   Optional. The language to retrieve entity synonyms for. If not specified,
         #   the agent's default language is used.
-        #   [More than a dozen
-        #   languages](https://dialogflow.com/docs/reference/language) are supported.
-        #   Note: languages must be enabled in the agent, before they can be used.
+        #   [Many
+        #   languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/
+        #   language)
+        #   are supported. Note: languages must be enabled in the agent before they can
+        #   be used.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -455,9 +459,11 @@ module Google
         # @param [String] language_code
         #   Optional. The language to list entity synonyms for. If not specified,
         #   the agent's default language is used.
-        #   [More than a dozen
-        #   languages](https://dialogflow.com/docs/reference/language) are supported.
-        #   Note: languages must be enabled in the agent, before they can be used.
+        #   [Many
+        #   languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/
+        #   language)
+        #   are supported. Note: languages must be enabled in the agent before they can
+        #   be used.
         # @param [Fixnum] page_size
         #   Optional. The maximum number of items to return in a single page. By
         #   default 100 and at most 1000.
@@ -503,9 +509,11 @@ module Google
         # @param [String] language_code
         #   Optional. The language of entity synonyms defined in `entity_type`. If not
         #   specified, the agent's default language is used.
-        #   [More than a dozen
-        #   languages](https://dialogflow.com/docs/reference/language) are supported.
-        #   Note: languages must be enabled in the agent, before they can be used.
+        #   [Many
+        #   languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/
+        #   language)
+        #   are supported. Note: languages must be enabled in the agent before they can
+        #   be used.
         # @param [String] update_mask
         #   Optional. The mask to control which fields get updated.
         # @param [String] fields
@@ -1194,9 +1202,11 @@ module Google
         # @param [String] language_code
         #   Optional. The language of training phrases, parameters and rich messages
         #   defined in `intent`. If not specified, the agent's default language is
-        #   used. [More than a dozen
-        #   languages](https://dialogflow.com/docs/reference/language) are supported.
-        #   Note: languages must be enabled in the agent, before they can be used.
+        #   used. [Many
+        #   languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/
+        #   language)
+        #   are supported. Note: languages must be enabled in the agent before they can
+        #   be used.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1269,9 +1279,11 @@ module Google
         # @param [String] language_code
         #   Optional. The language to retrieve training phrases, parameters and rich
         #   messages for. If not specified, the agent's default language is used.
-        #   [More than a dozen
-        #   languages](https://dialogflow.com/docs/reference/language) are supported.
-        #   Note: languages must be enabled in the agent, before they can be used.
+        #   [Many
+        #   languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/
+        #   language)
+        #   are supported. Note: languages must be enabled in the agent before they can
+        #   be used.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1310,9 +1322,11 @@ module Google
         # @param [String] language_code
         #   Optional. The language to list training phrases, parameters and rich
         #   messages for. If not specified, the agent's default language is used.
-        #   [More than a dozen
-        #   languages](https://dialogflow.com/docs/reference/language) are supported.
-        #   Note: languages must be enabled in the agent before they can be used.
+        #   [Many
+        #   languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/
+        #   language)
+        #   are supported. Note: languages must be enabled in the agent before they can
+        #   be used.
         # @param [Fixnum] page_size
         #   Optional. The maximum number of items to return in a single page. By
         #   default 100 and at most 1000.
@@ -1361,9 +1375,11 @@ module Google
         # @param [String] language_code
         #   Optional. The language of training phrases, parameters and rich messages
         #   defined in `intent`. If not specified, the agent's default language is
-        #   used. [More than a dozen
-        #   languages](https://dialogflow.com/docs/reference/language) are supported.
-        #   Note: languages must be enabled in the agent, before they can be used.
+        #   used. [Many
+        #   languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/
+        #   language)
+        #   are supported. Note: languages must be enabled in the agent before they can
+        #   be used.
         # @param [String] update_mask
         #   Optional. The mask to control which fields get updated.
         # @param [String] fields