google-api-client 0.41.1 → 0.43.0

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

@@ -50,8 +50,8 @@ module Google
         end
         
         # Finds named entities (currently proper names and common nouns) in the text
-        # along with entity types, salience, mentions for each entity, and
-        # other properties.
+        # along with entity types, salience, mentions for each entity, and other
+        # properties.
         # @param [Google::Apis::LanguageV1::AnalyzeEntitiesRequest] analyze_entities_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -81,8 +81,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Finds entities, similar to AnalyzeEntities in the text and analyzes
-        # sentiment associated with each entity and its mentions.
+        # Finds entities, similar to AnalyzeEntities in the text and analyzes sentiment
+        # associated with each entity and its mentions.
         # @param [Google::Apis::LanguageV1::AnalyzeEntitySentimentRequest] analyze_entity_sentiment_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

data/generated/google/apis/language_v1beta1.rb

@@ -27,7 +27,7 @@ module Google
     # @see https://cloud.google.com/natural-language/
     module LanguageV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20200406'
+      REVISION = '20200801'
 
       # Apply machine learning models to reveal the structure and meaning of text
       AUTH_CLOUD_LANGUAGE = 'https://www.googleapis.com/auth/cloud-language'

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

@@ -26,8 +26,8 @@ module Google
       class AnalyzeEntitiesRequest
         include Google::Apis::Core::Hashable
       
-        # ################################################################ #
-        # Represents the input to API methods.
+        # ################################################################ # Represents
+        # the input to API methods.
         # Corresponds to the JSON property `document`
         # @return [Google::Apis::LanguageV1beta1::Document]
         attr_accessor :document
@@ -57,9 +57,9 @@ module Google
         # @return [Array<Google::Apis::LanguageV1beta1::Entity>]
         attr_accessor :entities
       
-        # The language of the text, which will be the same as the language specified
-        # in the request or, if not specified, the automatically-detected language.
-        # See Document.language field for more details.
+        # The language of the text, which will be the same as the language specified in
+        # the request or, if not specified, the automatically-detected language. See
+        # Document.language field for more details.
         # Corresponds to the JSON property `language`
         # @return [String]
         attr_accessor :language
@@ -79,8 +79,8 @@ module Google
       class AnalyzeSentimentRequest
         include Google::Apis::Core::Hashable
       
-        # ################################################################ #
-        # Represents the input to API methods.
+        # ################################################################ # Represents
+        # the input to API methods.
         # Corresponds to the JSON property `document`
         # @return [Google::Apis::LanguageV1beta1::Document]
         attr_accessor :document
@@ -106,15 +106,14 @@ module Google
       class AnalyzeSentimentResponse
         include Google::Apis::Core::Hashable
       
-        # Represents the feeling associated with the entire text or entities in
-        # the text.
+        # Represents the feeling associated with the entire text or entities in the text.
         # Corresponds to the JSON property `documentSentiment`
         # @return [Google::Apis::LanguageV1beta1::Sentiment]
         attr_accessor :document_sentiment
       
-        # The language of the text, which will be the same as the language specified
-        # in the request or, if not specified, the automatically-detected language.
-        # See Document.language field for more details.
+        # The language of the text, which will be the same as the language specified in
+        # the request or, if not specified, the automatically-detected language. See
+        # Document.language field for more details.
         # Corresponds to the JSON property `language`
         # @return [String]
         attr_accessor :language
@@ -140,8 +139,8 @@ module Google
       class AnalyzeSyntaxRequest
         include Google::Apis::Core::Hashable
       
-        # ################################################################ #
-        # Represents the input to API methods.
+        # ################################################################ # Represents
+        # the input to API methods.
         # Corresponds to the JSON property `document`
         # @return [Google::Apis::LanguageV1beta1::Document]
         attr_accessor :document
@@ -166,9 +165,9 @@ module Google
       class AnalyzeSyntaxResponse
         include Google::Apis::Core::Hashable
       
-        # The language of the text, which will be the same as the language specified
-        # in the request or, if not specified, the automatically-detected language.
-        # See Document.language field for more details.
+        # The language of the text, which will be the same as the language specified in
+        # the request or, if not specified, the automatically-detected language. See
+        # Document.language field for more details.
         # Corresponds to the JSON property `language`
         # @return [String]
         attr_accessor :language
@@ -200,8 +199,8 @@ module Google
       class AnnotateTextRequest
         include Google::Apis::Core::Hashable
       
-        # ################################################################ #
-        # Represents the input to API methods.
+        # ################################################################ # Represents
+        # the input to API methods.
         # Corresponds to the JSON property `document`
         # @return [Google::Apis::LanguageV1beta1::Document]
         attr_accessor :document
@@ -211,8 +210,8 @@ module Google
         # @return [String]
         attr_accessor :encoding_type
       
-        # All available features for sentiment, syntax, and semantic analysis.
-        # Setting each one to true will enable that specific analysis for the input.
+        # All available features for sentiment, syntax, and semantic analysis. Setting
+        # each one to true will enable that specific analysis for the input.
         # Corresponds to the JSON property `features`
         # @return [Google::Apis::LanguageV1beta1::Features]
         attr_accessor :features
@@ -233,22 +232,20 @@ module Google
       class AnnotateTextResponse
         include Google::Apis::Core::Hashable
       
-        # Represents the feeling associated with the entire text or entities in
-        # the text.
+        # Represents the feeling associated with the entire text or entities in the text.
         # Corresponds to the JSON property `documentSentiment`
         # @return [Google::Apis::LanguageV1beta1::Sentiment]
         attr_accessor :document_sentiment
       
         # Entities, along with their semantic information, in the input document.
-        # Populated if the user enables
-        # AnnotateTextRequest.Features.extract_entities.
+        # Populated if the user enables AnnotateTextRequest.Features.extract_entities.
         # Corresponds to the JSON property `entities`
         # @return [Array<Google::Apis::LanguageV1beta1::Entity>]
         attr_accessor :entities
       
-        # The language of the text, which will be the same as the language specified
-        # in the request or, if not specified, the automatically-detected language.
-        # See Document.language field for more details.
+        # The language of the text, which will be the same as the language specified in
+        # the request or, if not specified, the automatically-detected language. See
+        # Document.language field for more details.
         # Corresponds to the JSON property `language`
         # @return [String]
         attr_accessor :language
@@ -260,8 +257,7 @@ module Google
         attr_accessor :sentences
       
         # Tokens, along with their syntactic information, in the input document.
-        # Populated if the user enables
-        # AnnotateTextRequest.Features.extract_syntax.
+        # Populated if the user enables AnnotateTextRequest.Features.extract_syntax.
         # Corresponds to the JSON property `tokens`
         # @return [Array<Google::Apis::LanguageV1beta1::Token>]
         attr_accessor :tokens
@@ -284,11 +280,10 @@ module Google
       class DependencyEdge
         include Google::Apis::Core::Hashable
       
-        # Represents the head of this token in the dependency tree.
-        # This is the index of the token which has an arc going to this token.
-        # The index is the position of the token in the array of tokens returned
-        # by the API method. If this token is a root token, then the
-        # `head_token_index` is its own index.
+        # Represents the head of this token in the dependency tree. This is the index of
+        # the token which has an arc going to this token. The index is the position of
+        # the token in the array of tokens returned by the API method. If this token is
+        # a root token, then the `head_token_index` is its own index.
         # Corresponds to the JSON property `headTokenIndex`
         # @return [Fixnum]
         attr_accessor :head_token_index
@@ -309,39 +304,37 @@ module Google
         end
       end
       
-      # ################################################################ #
-      # Represents the input to API methods.
+      # ################################################################ # Represents
+      # the input to API methods.
       class Document
         include Google::Apis::Core::Hashable
       
-        # The content of the input in string format.
-        # Cloud audit logging exempt since it is based on user data.
+        # The content of the input in string format. Cloud audit logging exempt since it
+        # is based on user data.
         # Corresponds to the JSON property `content`
         # @return [String]
         attr_accessor :content
       
-        # The Google Cloud Storage URI where the file content is located.
-        # This URI must be of the form: gs://bucket_name/object_name. For more
-        # details, see https://cloud.google.com/storage/docs/reference-uris.
-        # NOTE: Cloud Storage object versioning is not supported.
+        # The Google Cloud Storage URI where the file content is located. This URI must
+        # be of the form: gs://bucket_name/object_name. For more details, see https://
+        # cloud.google.com/storage/docs/reference-uris. NOTE: Cloud Storage object
+        # versioning is not supported.
         # Corresponds to the JSON property `gcsContentUri`
         # @return [String]
         attr_accessor :gcs_content_uri
       
-        # The language of the document (if not specified, the language is
-        # automatically detected). Both ISO and BCP-47 language codes are
-        # accepted.<br>
-        # [Language
-        # Support](https://cloud.google.com/natural-language/docs/languages) lists
-        # currently supported languages for each API method. If the language (either
-        # specified by the caller or automatically detected) is not supported by the
-        # called API method, an `INVALID_ARGUMENT` error is returned.
+        # The language of the document (if not specified, the language is automatically
+        # detected). Both ISO and BCP-47 language codes are accepted. [Language Support](
+        # https://cloud.google.com/natural-language/docs/languages) lists currently
+        # supported languages for each API method. If the language (either specified by
+        # the caller or automatically detected) is not supported by the called API
+        # method, an `INVALID_ARGUMENT` error is returned.
         # Corresponds to the JSON property `language`
         # @return [String]
         attr_accessor :language
       
-        # Required. If the type is not set or is `TYPE_UNSPECIFIED`,
-        # returns an `INVALID_ARGUMENT` error.
+        # Required. If the type is not set or is `TYPE_UNSPECIFIED`, returns an `
+        # INVALID_ARGUMENT` error.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -359,21 +352,21 @@ module Google
         end
       end
       
-      # Represents a phrase in the text that is a known entity, such as
-      # a person, an organization, or location. The API associates information, such
-      # as salience and mentions, with entities.
+      # Represents a phrase in the text that is a known entity, such as a person, an
+      # organization, or location. The API associates information, such as salience
+      # and mentions, with entities.
       class Entity
         include Google::Apis::Core::Hashable
       
-        # The mentions of this entity in the input document. The API currently
-        # supports proper noun mentions.
+        # The mentions of this entity in the input document. The API currently supports
+        # proper noun mentions.
         # Corresponds to the JSON property `mentions`
         # @return [Array<Google::Apis::LanguageV1beta1::EntityMention>]
         attr_accessor :mentions
       
-        # Metadata associated with the entity.
-        # Currently, Wikipedia URLs and Knowledge Graph MIDs are provided, if
-        # available. The associated keys are "wikipedia_url" and "mid", respectively.
+        # Metadata associated with the entity. Currently, Wikipedia URLs and Knowledge
+        # Graph MIDs are provided, if available. The associated keys are "wikipedia_url"
+        # and "mid", respectively.
         # Corresponds to the JSON property `metadata`
         # @return [Hash<String,String>]
         attr_accessor :metadata
@@ -383,11 +376,10 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # The salience score associated with the entity in the [0, 1.0] range.
-        # The salience score for an entity provides information about the
-        # importance or centrality of that entity to the entire document text.
-        # Scores closer to 0 are less salient, while scores closer to 1.0 are highly
-        # salient.
+        # The salience score associated with the entity in the [0, 1.0] range. The
+        # salience score for an entity provides information about the importance or
+        # centrality of that entity to the entire document text. Scores closer to 0 are
+        # less salient, while scores closer to 1.0 are highly salient.
         # Corresponds to the JSON property `salience`
         # @return [Float]
         attr_accessor :salience
@@ -437,8 +429,8 @@ module Google
         end
       end
       
-      # All available features for sentiment, syntax, and semantic analysis.
-      # Setting each one to true will enable that specific analysis for the input.
+      # All available features for sentiment, syntax, and semantic analysis. Setting
+      # each one to true will enable that specific analysis for the input.
       class Features
         include Google::Apis::Core::Hashable
       
@@ -561,8 +553,7 @@ module Google
       class Sentence
         include Google::Apis::Core::Hashable
       
-        # Represents the feeling associated with the entire text or entities in
-        # the text.
+        # Represents the feeling associated with the entire text or entities in the text.
         # Corresponds to the JSON property `sentiment`
         # @return [Google::Apis::LanguageV1beta1::Sentiment]
         attr_accessor :sentiment
@@ -583,27 +574,24 @@ module Google
         end
       end
       
-      # Represents the feeling associated with the entire text or entities in
-      # the text.
+      # Represents the feeling associated with the entire text or entities in the text.
       class Sentiment
         include Google::Apis::Core::Hashable
       
-        # A non-negative number in the [0, +inf) range, which represents
-        # the absolute magnitude of sentiment regardless of score (positive or
-        # negative).
+        # A non-negative number in the [0, +inf) range, which represents the absolute
+        # magnitude of sentiment regardless of score (positive or negative).
         # Corresponds to the JSON property `magnitude`
         # @return [Float]
         attr_accessor :magnitude
       
-        # DEPRECATED FIELD - This field is being deprecated in
-        # favor of score. Please refer to our documentation at
-        # https://cloud.google.com/natural-language/docs for more information.
+        # DEPRECATED FIELD - This field is being deprecated in favor of score. Please
+        # refer to our documentation at https://cloud.google.com/natural-language/docs
+        # for more information.
         # Corresponds to the JSON property `polarity`
         # @return [Float]
         attr_accessor :polarity
       
-        # Sentiment score between -1.0 (negative sentiment) and 1.0
-        # (positive sentiment).
+        # Sentiment score between -1.0 (negative sentiment) and 1.0 (positive sentiment).
         # Corresponds to the JSON property `score`
         # @return [Float]
         attr_accessor :score
@@ -620,12 +608,12 @@ 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). Each `Status` message contains
-      # three pieces of data: error code, error message, and error details.
-      # You can find out more about this error model and how to work with it in the
-      # [API Design Guide](https://cloud.google.com/apis/design/errors).
+      # 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). Each `Status` message contains three pieces of
+      # data: error code, error message, and error details. You can find out more
+      # about this error model and how to work with it in the [API Design Guide](https:
+      # //cloud.google.com/apis/design/errors).
       class Status
         include Google::Apis::Core::Hashable
       
@@ -634,15 +622,15 @@ module Google
         # @return [Fixnum]
         attr_accessor :code
       
-        # A list of messages that carry the error details.  There is a common set of
+        # A list of messages that carry the error details. There is a common set of
         # message types for APIs to use.
         # Corresponds to the JSON property `details`
         # @return [Array<Hash<String,Object>>]
         attr_accessor :details
       
-        # A developer-facing error message, which should be in English. Any
-        # user-facing error message should be localized and sent in the
-        # google.rpc.Status.details field, or localized by the client.
+        # A developer-facing error message, which should be in English. Any user-facing
+        # error message should be localized and sent in the google.rpc.Status.details
+        # field, or localized by the client.
         # Corresponds to the JSON property `message`
         # @return [String]
         attr_accessor :message

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

@@ -50,8 +50,8 @@ module Google
         end
         
         # Finds named entities (currently proper names and common nouns) in the text
-        # along with entity types, salience, mentions for each entity, and
-        # other properties.
+        # along with entity types, salience, mentions for each entity, and other
+        # properties.
         # @param [Google::Apis::LanguageV1beta1::AnalyzeEntitiesRequest] analyze_entities_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

data/generated/google/apis/language_v1beta2.rb

@@ -27,7 +27,7 @@ module Google
     # @see https://cloud.google.com/natural-language/
     module LanguageV1beta2
       VERSION = 'V1beta2'
-      REVISION = '20200406'
+      REVISION = '20200801'
 
       # Apply machine learning models to reveal the structure and meaning of text
       AUTH_CLOUD_LANGUAGE = 'https://www.googleapis.com/auth/cloud-language'

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

@@ -26,8 +26,8 @@ module Google
       class AnalyzeEntitiesRequest
         include Google::Apis::Core::Hashable
       
-        # ################################################################ #
-        # Represents the input to API methods.
+        # ################################################################ # Represents
+        # the input to API methods.
         # Corresponds to the JSON property `document`
         # @return [Google::Apis::LanguageV1beta2::Document]
         attr_accessor :document
@@ -57,9 +57,9 @@ module Google
         # @return [Array<Google::Apis::LanguageV1beta2::Entity>]
         attr_accessor :entities
       
-        # The language of the text, which will be the same as the language specified
-        # in the request or, if not specified, the automatically-detected language.
-        # See Document.language field for more details.
+        # The language of the text, which will be the same as the language specified in
+        # the request or, if not specified, the automatically-detected language. See
+        # Document.language field for more details.
         # Corresponds to the JSON property `language`
         # @return [String]
         attr_accessor :language
@@ -79,8 +79,8 @@ module Google
       class AnalyzeEntitySentimentRequest
         include Google::Apis::Core::Hashable
       
-        # ################################################################ #
-        # Represents the input to API methods.
+        # ################################################################ # Represents
+        # the input to API methods.
         # Corresponds to the JSON property `document`
         # @return [Google::Apis::LanguageV1beta2::Document]
         attr_accessor :document
@@ -110,9 +110,9 @@ module Google
         # @return [Array<Google::Apis::LanguageV1beta2::Entity>]
         attr_accessor :entities
       
-        # The language of the text, which will be the same as the language specified
-        # in the request or, if not specified, the automatically-detected language.
-        # See Document.language field for more details.
+        # The language of the text, which will be the same as the language specified in
+        # the request or, if not specified, the automatically-detected language. See
+        # Document.language field for more details.
         # Corresponds to the JSON property `language`
         # @return [String]
         attr_accessor :language
@@ -132,8 +132,8 @@ module Google
       class AnalyzeSentimentRequest
         include Google::Apis::Core::Hashable
       
-        # ################################################################ #
-        # Represents the input to API methods.
+        # ################################################################ # Represents
+        # the input to API methods.
         # Corresponds to the JSON property `document`
         # @return [Google::Apis::LanguageV1beta2::Document]
         attr_accessor :document
@@ -159,16 +159,15 @@ module Google
       class AnalyzeSentimentResponse
         include Google::Apis::Core::Hashable
       
-        # Represents the feeling associated with the entire text or entities in
-        # the text.
+        # Represents the feeling associated with the entire text or entities in the text.
         # Next ID: 6
         # Corresponds to the JSON property `documentSentiment`
         # @return [Google::Apis::LanguageV1beta2::Sentiment]
         attr_accessor :document_sentiment
       
-        # The language of the text, which will be the same as the language specified
-        # in the request or, if not specified, the automatically-detected language.
-        # See Document.language field for more details.
+        # The language of the text, which will be the same as the language specified in
+        # the request or, if not specified, the automatically-detected language. See
+        # Document.language field for more details.
         # Corresponds to the JSON property `language`
         # @return [String]
         attr_accessor :language
@@ -194,8 +193,8 @@ module Google
       class AnalyzeSyntaxRequest
         include Google::Apis::Core::Hashable
       
-        # ################################################################ #
-        # Represents the input to API methods.
+        # ################################################################ # Represents
+        # the input to API methods.
         # Corresponds to the JSON property `document`
         # @return [Google::Apis::LanguageV1beta2::Document]
         attr_accessor :document
@@ -220,9 +219,9 @@ module Google
       class AnalyzeSyntaxResponse
         include Google::Apis::Core::Hashable
       
-        # The language of the text, which will be the same as the language specified
-        # in the request or, if not specified, the automatically-detected language.
-        # See Document.language field for more details.
+        # The language of the text, which will be the same as the language specified in
+        # the request or, if not specified, the automatically-detected language. See
+        # Document.language field for more details.
         # Corresponds to the JSON property `language`
         # @return [String]
         attr_accessor :language
@@ -254,8 +253,8 @@ module Google
       class AnnotateTextRequest
         include Google::Apis::Core::Hashable
       
-        # ################################################################ #
-        # Represents the input to API methods.
+        # ################################################################ # Represents
+        # the input to API methods.
         # Corresponds to the JSON property `document`
         # @return [Google::Apis::LanguageV1beta2::Document]
         attr_accessor :document
@@ -265,9 +264,8 @@ module Google
         # @return [String]
         attr_accessor :encoding_type
       
-        # All available features for sentiment, syntax, and semantic analysis.
-        # Setting each one to true will enable that specific analysis for the input.
-        # Next ID: 10
+        # All available features for sentiment, syntax, and semantic analysis. Setting
+        # each one to true will enable that specific analysis for the input. Next ID: 10
         # Corresponds to the JSON property `features`
         # @return [Google::Apis::LanguageV1beta2::Features]
         attr_accessor :features
@@ -293,23 +291,21 @@ module Google
         # @return [Array<Google::Apis::LanguageV1beta2::ClassificationCategory>]
         attr_accessor :categories
       
-        # Represents the feeling associated with the entire text or entities in
-        # the text.
+        # Represents the feeling associated with the entire text or entities in the text.
         # Next ID: 6
         # Corresponds to the JSON property `documentSentiment`
         # @return [Google::Apis::LanguageV1beta2::Sentiment]
         attr_accessor :document_sentiment
       
         # Entities, along with their semantic information, in the input document.
-        # Populated if the user enables
-        # AnnotateTextRequest.Features.extract_entities.
+        # Populated if the user enables AnnotateTextRequest.Features.extract_entities.
         # Corresponds to the JSON property `entities`
         # @return [Array<Google::Apis::LanguageV1beta2::Entity>]
         attr_accessor :entities
       
-        # The language of the text, which will be the same as the language specified
-        # in the request or, if not specified, the automatically-detected language.
-        # See Document.language field for more details.
+        # The language of the text, which will be the same as the language specified in
+        # the request or, if not specified, the automatically-detected language. See
+        # Document.language field for more details.
         # Corresponds to the JSON property `language`
         # @return [String]
         attr_accessor :language
@@ -321,8 +317,7 @@ module Google
         attr_accessor :sentences
       
         # Tokens, along with their syntactic information, in the input document.
-        # Populated if the user enables
-        # AnnotateTextRequest.Features.extract_syntax.
+        # Populated if the user enables AnnotateTextRequest.Features.extract_syntax.
         # Corresponds to the JSON property `tokens`
         # @return [Array<Google::Apis::LanguageV1beta2::Token>]
         attr_accessor :tokens
@@ -346,8 +341,8 @@ module Google
       class ClassificationCategory
         include Google::Apis::Core::Hashable
       
-        # The classifier's confidence of the category. Number represents how certain
-        # the classifier is that this category represents the given text.
+        # The classifier's confidence of the category. Number represents how certain the
+        # classifier is that this category represents the given text.
         # Corresponds to the JSON property `confidence`
         # @return [Float]
         attr_accessor :confidence
@@ -373,8 +368,8 @@ module Google
       class ClassifyTextRequest
         include Google::Apis::Core::Hashable
       
-        # ################################################################ #
-        # Represents the input to API methods.
+        # ################################################################ # Represents
+        # the input to API methods.
         # Corresponds to the JSON property `document`
         # @return [Google::Apis::LanguageV1beta2::Document]
         attr_accessor :document
@@ -412,11 +407,10 @@ module Google
       class DependencyEdge
         include Google::Apis::Core::Hashable
       
-        # Represents the head of this token in the dependency tree.
-        # This is the index of the token which has an arc going to this token.
-        # The index is the position of the token in the array of tokens returned
-        # by the API method. If this token is a root token, then the
-        # `head_token_index` is its own index.
+        # Represents the head of this token in the dependency tree. This is the index of
+        # the token which has an arc going to this token. The index is the position of
+        # the token in the array of tokens returned by the API method. If this token is
+        # a root token, then the `head_token_index` is its own index.
         # Corresponds to the JSON property `headTokenIndex`
         # @return [Fixnum]
         attr_accessor :head_token_index
@@ -437,52 +431,50 @@ module Google
         end
       end
       
-      # ################################################################ #
-      # Represents the input to API methods.
+      # ################################################################ # Represents
+      # the input to API methods.
       class Document
         include Google::Apis::Core::Hashable
       
-        # Indicates how detected boilerplate(e.g. advertisements, copyright
-        # declarations, banners) should be handled for this document. If not
-        # specified, boilerplate will be treated the same as content.
+        # Indicates how detected boilerplate(e.g. advertisements, copyright declarations,
+        # banners) should be handled for this document. If not specified, boilerplate
+        # will be treated the same as content.
         # Corresponds to the JSON property `boilerplateHandling`
         # @return [String]
         attr_accessor :boilerplate_handling
       
-        # The content of the input in string format.
-        # Cloud audit logging exempt since it is based on user data.
+        # The content of the input in string format. Cloud audit logging exempt since it
+        # is based on user data.
         # Corresponds to the JSON property `content`
         # @return [String]
         attr_accessor :content
       
-        # The Google Cloud Storage URI where the file content is located.
-        # This URI must be of the form: gs://bucket_name/object_name. For more
-        # details, see https://cloud.google.com/storage/docs/reference-uris.
-        # NOTE: Cloud Storage object versioning is not supported.
+        # The Google Cloud Storage URI where the file content is located. This URI must
+        # be of the form: gs://bucket_name/object_name. For more details, see https://
+        # cloud.google.com/storage/docs/reference-uris. NOTE: Cloud Storage object
+        # versioning is not supported.
         # Corresponds to the JSON property `gcsContentUri`
         # @return [String]
         attr_accessor :gcs_content_uri
       
-        # The language of the document (if not specified, the language is
-        # automatically detected). Both ISO and BCP-47 language codes are
-        # accepted.<br>
-        # [Language
-        # Support](https://cloud.google.com/natural-language/docs/languages) lists
-        # currently supported languages for each API method. If the language (either
-        # specified by the caller or automatically detected) is not supported by the
-        # called API method, an `INVALID_ARGUMENT` error is returned.
+        # The language of the document (if not specified, the language is automatically
+        # detected). Both ISO and BCP-47 language codes are accepted. [Language Support](
+        # https://cloud.google.com/natural-language/docs/languages) lists currently
+        # supported languages for each API method. If the language (either specified by
+        # the caller or automatically detected) is not supported by the called API
+        # method, an `INVALID_ARGUMENT` error is returned.
         # Corresponds to the JSON property `language`
         # @return [String]
         attr_accessor :language
       
-        # The web URI where the document comes from. This URI is not used for
-        # fetching the content, but as a hint for analyzing the document.
+        # The web URI where the document comes from. This URI is not used for fetching
+        # the content, but as a hint for analyzing the document.
         # Corresponds to the JSON property `referenceWebUri`
         # @return [String]
         attr_accessor :reference_web_uri
       
-        # Required. If the type is not set or is `TYPE_UNSPECIFIED`,
-        # returns an `INVALID_ARGUMENT` error.
+        # Required. If the type is not set or is `TYPE_UNSPECIFIED`, returns an `
+        # INVALID_ARGUMENT` error.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -502,22 +494,22 @@ module Google
         end
       end
       
-      # Represents a phrase in the text that is a known entity, such as
-      # a person, an organization, or location. The API associates information, such
-      # as salience and mentions, with entities.
+      # Represents a phrase in the text that is a known entity, such as a person, an
+      # organization, or location. The API associates information, such as salience
+      # and mentions, with entities.
       class Entity
         include Google::Apis::Core::Hashable
       
-        # The mentions of this entity in the input document. The API currently
-        # supports proper noun mentions.
+        # The mentions of this entity in the input document. The API currently supports
+        # proper noun mentions.
         # Corresponds to the JSON property `mentions`
         # @return [Array<Google::Apis::LanguageV1beta2::EntityMention>]
         attr_accessor :mentions
       
-        # Metadata associated with the entity.
-        # For most entity types, the metadata is a Wikipedia URL (`wikipedia_url`)
-        # and Knowledge Graph MID (`mid`), if they are available. For the metadata
-        # associated with other entity types, see the Type table below.
+        # Metadata associated with the entity. For most entity types, the metadata is a
+        # Wikipedia URL (`wikipedia_url`) and Knowledge Graph MID (`mid`), if they are
+        # available. For the metadata associated with other entity types, see the Type
+        # table below.
         # Corresponds to the JSON property `metadata`
         # @return [Hash<String,String>]
         attr_accessor :metadata
@@ -527,17 +519,15 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # The salience score associated with the entity in the [0, 1.0] range.
-        # The salience score for an entity provides information about the
-        # importance or centrality of that entity to the entire document text.
-        # Scores closer to 0 are less salient, while scores closer to 1.0 are highly
-        # salient.
+        # The salience score associated with the entity in the [0, 1.0] range. The
+        # salience score for an entity provides information about the importance or
+        # centrality of that entity to the entire document text. Scores closer to 0 are
+        # less salient, while scores closer to 1.0 are highly salient.
         # Corresponds to the JSON property `salience`
         # @return [Float]
         attr_accessor :salience
       
-        # Represents the feeling associated with the entire text or entities in
-        # the text.
+        # Represents the feeling associated with the entire text or entities in the text.
         # Next ID: 6
         # Corresponds to the JSON property `sentiment`
         # @return [Google::Apis::LanguageV1beta2::Sentiment]
@@ -568,8 +558,7 @@ module Google
       class EntityMention
         include Google::Apis::Core::Hashable
       
-        # Represents the feeling associated with the entire text or entities in
-        # the text.
+        # Represents the feeling associated with the entire text or entities in the text.
         # Next ID: 6
         # Corresponds to the JSON property `sentiment`
         # @return [Google::Apis::LanguageV1beta2::Sentiment]
@@ -597,16 +586,14 @@ module Google
         end
       end
       
-      # All available features for sentiment, syntax, and semantic analysis.
-      # Setting each one to true will enable that specific analysis for the input.
-      # Next ID: 10
+      # All available features for sentiment, syntax, and semantic analysis. Setting
+      # each one to true will enable that specific analysis for the input. Next ID: 10
       class Features
         include Google::Apis::Core::Hashable
       
-        # Classify the full document into categories. If this is true,
-        # the API will use the default model which classifies into a
-        # [predefined
-        # taxonomy](https://cloud.google.com/natural-language/docs/categories).
+        # Classify the full document into categories. If this is true, the API will use
+        # the default model which classifies into a [predefined taxonomy](https://cloud.
+        # google.com/natural-language/docs/categories).
         # Corresponds to the JSON property `classifyText`
         # @return [Boolean]
         attr_accessor :classify_text
@@ -739,8 +726,7 @@ module Google
       class Sentence
         include Google::Apis::Core::Hashable
       
-        # Represents the feeling associated with the entire text or entities in
-        # the text.
+        # Represents the feeling associated with the entire text or entities in the text.
         # Next ID: 6
         # Corresponds to the JSON property `sentiment`
         # @return [Google::Apis::LanguageV1beta2::Sentiment]
@@ -762,21 +748,18 @@ module Google
         end
       end
       
-      # Represents the feeling associated with the entire text or entities in
-      # the text.
+      # Represents the feeling associated with the entire text or entities in the text.
       # Next ID: 6
       class Sentiment
         include Google::Apis::Core::Hashable
       
-        # A non-negative number in the [0, +inf) range, which represents
-        # the absolute magnitude of sentiment regardless of score (positive or
-        # negative).
+        # A non-negative number in the [0, +inf) range, which represents the absolute
+        # magnitude of sentiment regardless of score (positive or negative).
         # Corresponds to the JSON property `magnitude`
         # @return [Float]
         attr_accessor :magnitude
       
-        # Sentiment score between -1.0 (negative sentiment) and 1.0
-        # (positive sentiment).
+        # Sentiment score between -1.0 (negative sentiment) and 1.0 (positive sentiment).
         # Corresponds to the JSON property `score`
         # @return [Float]
         attr_accessor :score
@@ -792,12 +775,12 @@ 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). Each `Status` message contains
-      # three pieces of data: error code, error message, and error details.
-      # You can find out more about this error model and how to work with it in the
-      # [API Design Guide](https://cloud.google.com/apis/design/errors).
+      # 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). Each `Status` message contains three pieces of
+      # data: error code, error message, and error details. You can find out more
+      # about this error model and how to work with it in the [API Design Guide](https:
+      # //cloud.google.com/apis/design/errors).
       class Status
         include Google::Apis::Core::Hashable
       
@@ -806,15 +789,15 @@ module Google
         # @return [Fixnum]
         attr_accessor :code
       
-        # A list of messages that carry the error details.  There is a common set of
+        # A list of messages that carry the error details. There is a common set of
         # message types for APIs to use.
         # Corresponds to the JSON property `details`
         # @return [Array<Hash<String,Object>>]
         attr_accessor :details
       
-        # A developer-facing error message, which should be in English. Any
-        # user-facing error message should be localized and sent in the
-        # google.rpc.Status.details field, or localized by the client.
+        # A developer-facing error message, which should be in English. Any user-facing
+        # error message should be localized and sent in the google.rpc.Status.details
+        # field, or localized by the client.
         # Corresponds to the JSON property `message`
         # @return [String]
         attr_accessor :message