google-api-client 0.9.26 → 0.9.28

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

@@ -27,17 +27,17 @@ module Google
       class SearchResponse
         include Google::Apis::Core::Hashable
       
+        # The schema type of top-level JSON-LD object, e.g. ItemList.
+        # Corresponds to the JSON property `@type`
+        # @return [Object]
+        attr_accessor :_type
+      
         # The local context applicable for the response. See more details at
         # http://www.w3.org/TR/json-ld/#context-definitions.
         # Corresponds to the JSON property `@context`
         # @return [Object]
         attr_accessor :_context
       
-        # The schema type of top-level JSON-LD object, e.g. ItemList.
-        # Corresponds to the JSON property `@type`
-        # @return [Object]
-        attr_accessor :_type
-      
         # The item list of search results.
         # Corresponds to the JSON property `itemListElement`
         # @return [Array<Object>]
@@ -49,8 +49,8 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @_context = args[:_context] if args.key?(:_context)
           @_type = args[:_type] if args.key?(:_type)
+          @_context = args[:_context] if args.key?(:_context)
           @item_list_element = args[:item_list_element] if args.key?(:item_list_element)
         end
       end

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

@@ -31,8 +31,8 @@ module Google
       class SearchResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
-          property :_context, as: '@context'
           property :_type, as: '@type'
+          property :_context, as: '@context'
           collection :item_list_element, as: 'itemListElement'
         end
       end

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

@@ -49,30 +49,30 @@ module Google
         # Searches Knowledge Graph for entities that match the constraints.
         # A list of matched entities will be returned in response, which will be in
         # JSON-LD format and compatible with http://schema.org
-        # @param [Fixnum] limit
-        #   Limits the number of entities to be returned.
-        # @param [Array<String>, String] ids
-        #   The list of entity id to be used for search instead of query string.
-        #   To specify multiple ids in the HTTP request, repeat the parameter in the
-        #   URL as in ...?ids=A&ids=B
         # @param [Boolean] prefix
         #   Enables prefix match against names and aliases of entities
         # @param [String] query
         #   The literal query string for search.
-        # @param [Boolean] indent
-        #   Enables indenting of json results.
         # @param [Array<String>, String] types
         #   Restricts returned entities with these types, e.g. Person
         #   (as defined in http://schema.org/Person). If multiple types are specified,
         #   returned entities will contain one or more of these types.
+        # @param [Boolean] indent
+        #   Enables indenting of json results.
         # @param [Array<String>, String] languages
         #   The list of language codes (defined in ISO 693) to run the query with,
         #   e.g. 'en'.
+        # @param [Array<String>, String] ids
+        #   The list of entity id to be used for search instead of query string.
+        #   To specify multiple ids in the HTTP request, repeat the parameter in the
+        #   URL as in ...?ids=A&ids=B
+        # @param [Fixnum] limit
+        #   Limits the number of entities to be returned.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
         #   Available to use for quota purposes for server-side applications. Can be any
         #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -85,19 +85,19 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def search_entities(limit: nil, ids: nil, prefix: nil, query: nil, indent: nil, types: nil, languages: nil, quota_user: nil, fields: nil, options: nil, &block)
+        def search_entities(prefix: nil, query: nil, types: nil, indent: nil, languages: nil, ids: nil, limit: nil, fields: nil, quota_user: nil, options: nil, &block)
           command =  make_simple_command(:get, 'v1/entities:search', options)
           command.response_representation = Google::Apis::KgsearchV1::SearchResponse::Representation
           command.response_class = Google::Apis::KgsearchV1::SearchResponse
-          command.query['limit'] = limit unless limit.nil?
-          command.query['ids'] = ids unless ids.nil?
           command.query['prefix'] = prefix unless prefix.nil?
           command.query['query'] = query unless query.nil?
-          command.query['indent'] = indent unless indent.nil?
           command.query['types'] = types unless types.nil?
+          command.query['indent'] = indent unless indent.nil?
           command.query['languages'] = languages unless languages.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['ids'] = ids unless ids.nil?
+          command.query['limit'] = limit unless limit.nil?
           command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
 

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 = '20170103'
+      REVISION = '20170123'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -22,41 +22,26 @@ module Google
   module Apis
     module LanguageV1beta1
       
-      # ################################################################ #
-      # Represents the input to API methods.
-      class Document
+      # The sentiment analysis response message.
+      class AnalyzeSentimentResponse
         include Google::Apis::Core::Hashable
       
-        # The language of the document (if not specified, the language is
-        # automatically detected). Both ISO and BCP-47 language codes are
-        # accepted.<br>
-        # **Current Language Restrictions:**
-        # * Only English, Spanish, and Japanese textual content are supported.
-        # 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 text, which will be the same as the language specified
+        # in the request or, if not specified, the automatically-detected language.
         # Corresponds to the JSON property `language`
         # @return [String]
         attr_accessor :language
       
-        # 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
-      
-        # 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
+        # The sentiment for all the sentences in the document.
+        # Corresponds to the JSON property `sentences`
+        # @return [Array<Google::Apis::LanguageV1beta1::Sentence>]
+        attr_accessor :sentences
       
-        # The content of the input in string format.
-        # Corresponds to the JSON property `content`
-        # @return [String]
-        attr_accessor :content
+        # 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
       
         def initialize(**args)
            update!(**args)
@@ -65,26 +50,26 @@ module Google
         # Update properties of this object
         def update!(**args)
           @language = args[:language] if args.key?(:language)
-          @gcs_content_uri = args[:gcs_content_uri] if args.key?(:gcs_content_uri)
-          @type = args[:type] if args.key?(:type)
-          @content = args[:content] if args.key?(:content)
+          @sentences = args[:sentences] if args.key?(:sentences)
+          @document_sentiment = args[:document_sentiment] if args.key?(:document_sentiment)
         end
       end
       
-      # Represents an output piece of text.
-      class TextSpan
+      # The entity analysis response message.
+      class AnalyzeEntitiesResponse
         include Google::Apis::Core::Hashable
       
-        # The API calculates the beginning offset of the content in the original
-        # document according to the EncodingType specified in the API request.
-        # Corresponds to the JSON property `beginOffset`
-        # @return [Fixnum]
-        attr_accessor :begin_offset
-      
-        # The content of the output text.
-        # Corresponds to the JSON property `content`
+        # 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 :content
+        attr_accessor :language
+      
+        # The recognized entities in the input document.
+        # Corresponds to the JSON property `entities`
+        # @return [Array<Google::Apis::LanguageV1beta1::Entity>]
+        attr_accessor :entities
       
         def initialize(**args)
            update!(**args)
@@ -92,70 +77,31 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @begin_offset = args[:begin_offset] if args.key?(:begin_offset)
-          @content = args[:content] if args.key?(:content)
+          @language = args[:language] if args.key?(:language)
+          @entities = args[:entities] if args.key?(:entities)
         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:
-      # - 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` which 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 purpose.
-      # - 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.
-      class Status
+      # The syntax analysis response message.
+      class AnalyzeSyntaxResponse
         include Google::Apis::Core::Hashable
       
-        # The status code, which should be an enum value of google.rpc.Code.
-        # Corresponds to the JSON property `code`
-        # @return [Fixnum]
-        attr_accessor :code
+        # 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
       
-        # A list of messages that carry the error details.  There will be a
-        # common set of message types for APIs to use.
-        # Corresponds to the JSON property `details`
-        # @return [Array<Hash<String,Object>>]
-        attr_accessor :details
+        # Sentences in the input document.
+        # Corresponds to the JSON property `sentences`
+        # @return [Array<Google::Apis::LanguageV1beta1::Sentence>]
+        attr_accessor :sentences
       
-        # 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
+        # Tokens, along with their syntactic information, in the input document.
+        # Corresponds to the JSON property `tokens`
+        # @return [Array<Google::Apis::LanguageV1beta1::Token>]
+        attr_accessor :tokens
       
         def initialize(**args)
            update!(**args)
@@ -163,79 +109,85 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @code = args[:code] if args.key?(:code)
-          @details = args[:details] if args.key?(:details)
-          @message = args[:message] if args.key?(:message)
+          @language = args[:language] if args.key?(:language)
+          @sentences = args[:sentences] if args.key?(:sentences)
+          @tokens = args[:tokens] if args.key?(:tokens)
         end
       end
       
-      # The entity analysis request message.
-      class AnalyzeEntitiesRequest
+      # 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
       
-        # ################################################################ #
-        # Represents the input to API methods.
-        # Corresponds to the JSON property `document`
-        # @return [Google::Apis::LanguageV1beta1::Document]
-        attr_accessor :document
+        # 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
       
-        # The encoding type used by the API to calculate offsets.
-        # Corresponds to the JSON property `encodingType`
+        # The representative name for the entity.
+        # Corresponds to the JSON property `name`
         # @return [String]
-        attr_accessor :encoding_type
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @document = args[:document] if args.key?(:document)
-          @encoding_type = args[:encoding_type] if args.key?(:encoding_type)
-        end
-      end
-      
-      # Represents a mention for an entity in the text. Currently, proper noun
-      # mentions are supported.
-      class EntityMention
-        include Google::Apis::Core::Hashable
-      
-        # Represents an output piece of text.
-        # Corresponds to the JSON property `text`
-        # @return [Google::Apis::LanguageV1beta1::TextSpan]
-        attr_accessor :text
+        attr_accessor :name
       
-        # The type of the entity mention.
+        # The entity type.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
       
+        # 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
+      
+        # 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
+      
         def initialize(**args)
            update!(**args)
         end
       
         # Update properties of this object
         def update!(**args)
-          @text = args[:text] if args.key?(:text)
+          @mentions = args[:mentions] if args.key?(:mentions)
+          @name = args[:name] if args.key?(:name)
           @type = args[:type] if args.key?(:type)
+          @metadata = args[:metadata] if args.key?(:metadata)
+          @salience = args[:salience] if args.key?(:salience)
         end
       end
       
-      # The sentiment analysis request message.
-      class AnalyzeSentimentRequest
+      # The request message for the text annotation API, which can perform multiple
+      # analysis types (sentiment, entities, and syntax) in one call.
+      class AnnotateTextRequest
         include Google::Apis::Core::Hashable
       
+        # The encoding type used by the API to calculate offsets.
+        # Corresponds to the JSON property `encodingType`
+        # @return [String]
+        attr_accessor :encoding_type
+      
         # ################################################################ #
         # Represents the input to API methods.
         # Corresponds to the JSON property `document`
         # @return [Google::Apis::LanguageV1beta1::Document]
         attr_accessor :document
       
-        # The encoding type used by the API to calculate sentence offsets for the
-        # sentence sentiment.
-        # Corresponds to the JSON property `encodingType`
-        # @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.
+        # Corresponds to the JSON property `features`
+        # @return [Google::Apis::LanguageV1beta1::Features]
+        attr_accessor :features
       
         def initialize(**args)
            update!(**args)
@@ -243,67 +195,87 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @document = args[:document] if args.key?(:document)
           @encoding_type = args[:encoding_type] if args.key?(:encoding_type)
+          @document = args[:document] if args.key?(:document)
+          @features = args[:features] if args.key?(:features)
         end
       end
       
-      # The sentiment analysis response message.
-      class AnalyzeSentimentResponse
+      # The text annotations response message.
+      class AnnotateTextResponse
         include Google::Apis::Core::Hashable
       
-        # 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.
         # Corresponds to the JSON property `language`
         # @return [String]
         attr_accessor :language
       
-        # The sentiment for all the sentences in the document.
+        # Sentences in the input document. Populated if the user enables
+        # AnnotateTextRequest.Features.extract_syntax.
         # Corresponds to the JSON property `sentences`
         # @return [Array<Google::Apis::LanguageV1beta1::Sentence>]
         attr_accessor :sentences
       
+        # Tokens, along with their syntactic information, in the input document.
+        # Populated if the user enables
+        # AnnotateTextRequest.Features.extract_syntax.
+        # Corresponds to the JSON property `tokens`
+        # @return [Array<Google::Apis::LanguageV1beta1::Token>]
+        attr_accessor :tokens
+      
+        # Entities, along with their semantic information, in the input document.
+        # Populated if the user enables
+        # AnnotateTextRequest.Features.extract_entities.
+        # Corresponds to the JSON property `entities`
+        # @return [Array<Google::Apis::LanguageV1beta1::Entity>]
+        attr_accessor :entities
+      
+        # 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
+      
         def initialize(**args)
            update!(**args)
         end
       
         # Update properties of this object
         def update!(**args)
-          @document_sentiment = args[:document_sentiment] if args.key?(:document_sentiment)
           @language = args[:language] if args.key?(:language)
           @sentences = args[:sentences] if args.key?(:sentences)
+          @tokens = args[:tokens] if args.key?(:tokens)
+          @entities = args[:entities] if args.key?(:entities)
+          @document_sentiment = args[:document_sentiment] if args.key?(:document_sentiment)
         end
       end
-      
-      # The syntax analysis request message.
-      class AnalyzeSyntaxRequest
+      
+      # The sentiment analysis request message.
+      class AnalyzeSentimentRequest
         include Google::Apis::Core::Hashable
       
+        # The encoding type used by the API to calculate sentence offsets for the
+        # sentence sentiment.
+        # Corresponds to the JSON property `encodingType`
+        # @return [String]
+        attr_accessor :encoding_type
+      
         # ################################################################ #
         # Represents the input to API methods.
         # Corresponds to the JSON property `document`
         # @return [Google::Apis::LanguageV1beta1::Document]
         attr_accessor :document
       
-        # The encoding type used by the API to calculate offsets.
-        # Corresponds to the JSON property `encodingType`
-        # @return [String]
-        attr_accessor :encoding_type
-      
         def initialize(**args)
            update!(**args)
         end
       
         # Update properties of this object
         def update!(**args)
-          @document = args[:document] if args.key?(:document)
           @encoding_type = args[:encoding_type] if args.key?(:encoding_type)
+          @document = args[:document] if args.key?(:document)
         end
       end
       
@@ -336,26 +308,55 @@ module Google
         end
       end
       
-      # The syntax analysis response message.
-      class AnalyzeSyntaxResponse
+      # Represents an output piece of text.
+      class TextSpan
         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.
-        # Corresponds to the JSON property `language`
+        # The API calculates the beginning offset of the content in the original
+        # document according to the EncodingType specified in the API request.
+        # Corresponds to the JSON property `beginOffset`
+        # @return [Fixnum]
+        attr_accessor :begin_offset
+      
+        # The content of the output text.
+        # Corresponds to the JSON property `content`
         # @return [String]
-        attr_accessor :language
+        attr_accessor :content
       
-        # Tokens, along with their syntactic information, in the input document.
-        # Corresponds to the JSON property `tokens`
-        # @return [Array<Google::Apis::LanguageV1beta1::Token>]
-        attr_accessor :tokens
+        def initialize(**args)
+           update!(**args)
+        end
       
-        # Sentences in the input document.
-        # Corresponds to the JSON property `sentences`
-        # @return [Array<Google::Apis::LanguageV1beta1::Sentence>]
-        attr_accessor :sentences
+        # Update properties of this object
+        def update!(**args)
+          @begin_offset = args[:begin_offset] if args.key?(:begin_offset)
+          @content = args[:content] if args.key?(:content)
+        end
+      end
+      
+      # Represents the smallest syntactic building block of the text.
+      class Token
+        include Google::Apis::Core::Hashable
+      
+        # [Lemma](https://en.wikipedia.org/wiki/Lemma_%28morphology%29) of the token.
+        # Corresponds to the JSON property `lemma`
+        # @return [String]
+        attr_accessor :lemma
+      
+        # Represents part of speech information for a token.
+        # Corresponds to the JSON property `partOfSpeech`
+        # @return [Google::Apis::LanguageV1beta1::PartOfSpeech]
+        attr_accessor :part_of_speech
+      
+        # Represents an output piece of text.
+        # Corresponds to the JSON property `text`
+        # @return [Google::Apis::LanguageV1beta1::TextSpan]
+        attr_accessor :text
+      
+        # Represents dependency parse tree information for a token.
+        # Corresponds to the JSON property `dependencyEdge`
+        # @return [Google::Apis::LanguageV1beta1::DependencyEdge]
+        attr_accessor :dependency_edge
       
         def initialize(**args)
            update!(**args)
@@ -363,33 +364,72 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @language = args[:language] if args.key?(:language)
-          @tokens = args[:tokens] if args.key?(:tokens)
-          @sentences = args[:sentences] if args.key?(:sentences)
+          @lemma = args[:lemma] if args.key?(:lemma)
+          @part_of_speech = args[:part_of_speech] if args.key?(:part_of_speech)
+          @text = args[:text] if args.key?(:text)
+          @dependency_edge = args[:dependency_edge] if args.key?(:dependency_edge)
         end
       end
       
-      # The request message for the text annotation API, which can perform multiple
-      # analysis types (sentiment, entities, and syntax) in one call.
-      class AnnotateTextRequest
+      # 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` which 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 purpose.
+      # - 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.
+      class Status
         include Google::Apis::Core::Hashable
       
-        # ################################################################ #
-        # Represents the input to API methods.
-        # Corresponds to the JSON property `document`
-        # @return [Google::Apis::LanguageV1beta1::Document]
-        attr_accessor :document
+        # A list of messages that carry the error details.  There will be a
+        # common set of message types for APIs to use.
+        # Corresponds to the JSON property `details`
+        # @return [Array<Hash<String,Object>>]
+        attr_accessor :details
       
-        # The encoding type used by the API to calculate offsets.
-        # Corresponds to the JSON property `encodingType`
-        # @return [String]
-        attr_accessor :encoding_type
+        # The status code, which should be an enum value of google.rpc.Code.
+        # Corresponds to the JSON property `code`
+        # @return [Fixnum]
+        attr_accessor :code
       
-        # 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
+        # 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
       
         def initialize(**args)
            update!(**args)
@@ -397,14 +437,15 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @document = args[:document] if args.key?(:document)
-          @encoding_type = args[:encoding_type] if args.key?(:encoding_type)
-          @features = args[:features] if args.key?(:features)
+          @details = args[:details] if args.key?(:details)
+          @code = args[:code] if args.key?(:code)
+          @message = args[:message] if args.key?(:message)
         end
       end
       
-      # Represents a sentence in the input document.
-      class Sentence
+      # Represents a mention for an entity in the text. Currently, proper noun
+      # mentions are supported.
+      class EntityMention
         include Google::Apis::Core::Hashable
       
         # Represents an output piece of text.
@@ -412,11 +453,10 @@ module Google
         # @return [Google::Apis::LanguageV1beta1::TextSpan]
         attr_accessor :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
+        # The type of the entity mention.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
       
         def initialize(**args)
            update!(**args)
@@ -425,7 +465,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @text = args[:text] if args.key?(:text)
-          @sentiment = args[:sentiment] if args.key?(:sentiment)
+          @type = args[:type] if args.key?(:type)
         end
       end
       
@@ -434,6 +474,12 @@ module Google
       class Features
         include Google::Apis::Core::Hashable
       
+        # Extract syntax information.
+        # Corresponds to the JSON property `extractSyntax`
+        # @return [Boolean]
+        attr_accessor :extract_syntax
+        alias_method :extract_syntax?, :extract_syntax
+      
         # Extract document-level sentiment.
         # Corresponds to the JSON property `extractDocumentSentiment`
         # @return [Boolean]
@@ -446,87 +492,53 @@ module Google
         attr_accessor :extract_entities
         alias_method :extract_entities?, :extract_entities
       
-        # Extract syntax information.
-        # Corresponds to the JSON property `extractSyntax`
-        # @return [Boolean]
-        attr_accessor :extract_syntax
-        alias_method :extract_syntax?, :extract_syntax
-      
         def initialize(**args)
            update!(**args)
         end
       
         # Update properties of this object
         def update!(**args)
+          @extract_syntax = args[:extract_syntax] if args.key?(:extract_syntax)
           @extract_document_sentiment = args[:extract_document_sentiment] if args.key?(:extract_document_sentiment)
           @extract_entities = args[:extract_entities] if args.key?(:extract_entities)
-          @extract_syntax = args[:extract_syntax] if args.key?(:extract_syntax)
         end
       end
       
-      # Represents part of speech information for a token.
-      class PartOfSpeech
+      # ################################################################ #
+      # Represents the input to API methods.
+      class Document
         include Google::Apis::Core::Hashable
       
-        # The grammatical aspect.
-        # Corresponds to the JSON property `aspect`
-        # @return [String]
-        attr_accessor :aspect
-      
-        # The grammatical gender.
-        # Corresponds to the JSON property `gender`
-        # @return [String]
-        attr_accessor :gender
-      
-        # The grammatical person.
-        # Corresponds to the JSON property `person`
-        # @return [String]
-        attr_accessor :person
-      
-        # The grammatical case.
-        # Corresponds to the JSON property `case`
-        # @return [String]
-        attr_accessor :case
-      
-        # The grammatical form.
-        # Corresponds to the JSON property `form`
-        # @return [String]
-        attr_accessor :form
-      
-        # The grammatical tense.
-        # Corresponds to the JSON property `tense`
-        # @return [String]
-        attr_accessor :tense
-      
-        # The grammatical properness.
-        # Corresponds to the JSON property `proper`
-        # @return [String]
-        attr_accessor :proper
-      
-        # The grammatical mood.
-        # Corresponds to the JSON property `mood`
-        # @return [String]
-        attr_accessor :mood
-      
-        # The part of speech tag.
-        # Corresponds to the JSON property `tag`
+        # 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 :tag
+        attr_accessor :gcs_content_uri
       
-        # The grammatical number.
-        # Corresponds to the JSON property `number`
+        # The language of the document (if not specified, the language is
+        # automatically detected). Both ISO and BCP-47 language codes are
+        # accepted.<br>
+        # **Current Language Restrictions:**
+        # * Only English, Spanish, and Japanese textual content are supported.
+        # 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 :number
+        attr_accessor :language
       
-        # The grammatical reciprocity.
-        # Corresponds to the JSON property `reciprocity`
+        # 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 :reciprocity
+        attr_accessor :type
       
-        # The grammatical voice.
-        # Corresponds to the JSON property `voice`
+        # The content of the input in string format.
+        # Corresponds to the JSON property `content`
         # @return [String]
-        attr_accessor :voice
+        attr_accessor :content
       
         def initialize(**args)
            update!(**args)
@@ -534,57 +546,27 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @aspect = args[:aspect] if args.key?(:aspect)
-          @gender = args[:gender] if args.key?(:gender)
-          @person = args[:person] if args.key?(:person)
-          @case = args[:case] if args.key?(:case)
-          @form = args[:form] if args.key?(:form)
-          @tense = args[:tense] if args.key?(:tense)
-          @proper = args[:proper] if args.key?(:proper)
-          @mood = args[:mood] if args.key?(:mood)
-          @tag = args[:tag] if args.key?(:tag)
-          @number = args[:number] if args.key?(:number)
-          @reciprocity = args[:reciprocity] if args.key?(:reciprocity)
-          @voice = args[:voice] if args.key?(:voice)
+          @gcs_content_uri = args[:gcs_content_uri] if args.key?(:gcs_content_uri)
+          @language = args[:language] if args.key?(:language)
+          @type = args[:type] if args.key?(:type)
+          @content = args[:content] if args.key?(:content)
         end
       end
       
-      # The text annotations response message.
-      class AnnotateTextResponse
+      # Represents a sentence in the input document.
+      class Sentence
         include Google::Apis::Core::Hashable
       
-        # Entities, along with their semantic information, in the input document.
-        # Populated if the user enables
-        # AnnotateTextRequest.Features.extract_entities.
-        # Corresponds to the JSON property `entities`
-        # @return [Array<Google::Apis::LanguageV1beta1::Entity>]
-        attr_accessor :entities
+        # Represents an output piece of text.
+        # Corresponds to the JSON property `text`
+        # @return [Google::Apis::LanguageV1beta1::TextSpan]
+        attr_accessor :text
       
         # Represents the feeling associated with the entire text or entities in
         # the text.
-        # Corresponds to the JSON property `documentSentiment`
+        # Corresponds to the JSON property `sentiment`
         # @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.
-        # Corresponds to the JSON property `language`
-        # @return [String]
-        attr_accessor :language
-      
-        # Tokens, along with their syntactic information, in the input document.
-        # Populated if the user enables
-        # AnnotateTextRequest.Features.extract_syntax.
-        # Corresponds to the JSON property `tokens`
-        # @return [Array<Google::Apis::LanguageV1beta1::Token>]
-        attr_accessor :tokens
-      
-        # Sentences in the input document. Populated if the user enables
-        # AnnotateTextRequest.Features.extract_syntax.
-        # Corresponds to the JSON property `sentences`
-        # @return [Array<Google::Apis::LanguageV1beta1::Sentence>]
-        attr_accessor :sentences
+        attr_accessor :sentiment
       
         def initialize(**args)
            update!(**args)
@@ -592,51 +574,25 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @entities = args[:entities] if args.key?(:entities)
-          @document_sentiment = args[:document_sentiment] if args.key?(:document_sentiment)
-          @language = args[:language] if args.key?(:language)
-          @tokens = args[:tokens] if args.key?(:tokens)
-          @sentences = args[:sentences] if args.key?(:sentences)
+          @text = args[:text] if args.key?(:text)
+          @sentiment = args[:sentiment] if args.key?(:sentiment)
         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.
-      class Entity
+      # The entity analysis request message.
+      class AnalyzeEntitiesRequest
         include Google::Apis::Core::Hashable
       
-        # 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
-      
-        # 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
-      
-        # The entity type.
-        # Corresponds to the JSON property `type`
+        # The encoding type used by the API to calculate offsets.
+        # Corresponds to the JSON property `encodingType`
         # @return [String]
-        attr_accessor :type
-      
-        # 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
+        attr_accessor :encoding_type
       
-        # The representative name for the entity.
-        # Corresponds to the JSON property `name`
-        # @return [String]
-        attr_accessor :name
+        # ################################################################ #
+        # Represents the input to API methods.
+        # Corresponds to the JSON property `document`
+        # @return [Google::Apis::LanguageV1beta1::Document]
+        attr_accessor :document
       
         def initialize(**args)
            update!(**args)
@@ -644,11 +600,8 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @metadata = args[:metadata] if args.key?(:metadata)
-          @salience = args[:salience] if args.key?(:salience)
-          @type = args[:type] if args.key?(:type)
-          @mentions = args[:mentions] if args.key?(:mentions)
-          @name = args[:name] if args.key?(:name)
+          @encoding_type = args[:encoding_type] if args.key?(:encoding_type)
+          @document = args[:document] if args.key?(:document)
         end
       end
       
@@ -657,12 +610,6 @@ module Google
       class Sentiment
         include Google::Apis::Core::Hashable
       
-        # Sentiment score between -1.0 (negative sentiment) and 1.0
-        # (positive sentiment).
-        # Corresponds to the JSON property `score`
-        # @return [Float]
-        attr_accessor :score
-      
         # 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.
@@ -670,6 +617,12 @@ module Google
         # @return [Float]
         attr_accessor :polarity
       
+        # Sentiment score between -1.0 (negative sentiment) and 1.0
+        # (positive sentiment).
+        # Corresponds to the JSON property `score`
+        # @return [Float]
+        attr_accessor :score
+      
         # A non-negative number in the [0, +inf) range, which represents
         # the absolute magnitude of sentiment regardless of score (positive or
         # negative).
@@ -683,35 +636,75 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @score = args[:score] if args.key?(:score)
           @polarity = args[:polarity] if args.key?(:polarity)
+          @score = args[:score] if args.key?(:score)
           @magnitude = args[:magnitude] if args.key?(:magnitude)
         end
       end
       
-      # Represents the smallest syntactic building block of the text.
-      class Token
+      # Represents part of speech information for a token.
+      class PartOfSpeech
         include Google::Apis::Core::Hashable
       
-        # Represents an output piece of text.
-        # Corresponds to the JSON property `text`
-        # @return [Google::Apis::LanguageV1beta1::TextSpan]
-        attr_accessor :text
+        # The grammatical case.
+        # Corresponds to the JSON property `case`
+        # @return [String]
+        attr_accessor :case
       
-        # Represents part of speech information for a token.
-        # Corresponds to the JSON property `partOfSpeech`
-        # @return [Google::Apis::LanguageV1beta1::PartOfSpeech]
-        attr_accessor :part_of_speech
+        # The grammatical tense.
+        # Corresponds to the JSON property `tense`
+        # @return [String]
+        attr_accessor :tense
       
-        # Represents dependency parse tree information for a token.
-        # Corresponds to the JSON property `dependencyEdge`
-        # @return [Google::Apis::LanguageV1beta1::DependencyEdge]
-        attr_accessor :dependency_edge
+        # The grammatical reciprocity.
+        # Corresponds to the JSON property `reciprocity`
+        # @return [String]
+        attr_accessor :reciprocity
       
-        # [Lemma](https://en.wikipedia.org/wiki/Lemma_%28morphology%29) of the token.
-        # Corresponds to the JSON property `lemma`
+        # The grammatical form.
+        # Corresponds to the JSON property `form`
         # @return [String]
-        attr_accessor :lemma
+        attr_accessor :form
+      
+        # The grammatical number.
+        # Corresponds to the JSON property `number`
+        # @return [String]
+        attr_accessor :number
+      
+        # The grammatical voice.
+        # Corresponds to the JSON property `voice`
+        # @return [String]
+        attr_accessor :voice
+      
+        # The grammatical aspect.
+        # Corresponds to the JSON property `aspect`
+        # @return [String]
+        attr_accessor :aspect
+      
+        # The grammatical mood.
+        # Corresponds to the JSON property `mood`
+        # @return [String]
+        attr_accessor :mood
+      
+        # The part of speech tag.
+        # Corresponds to the JSON property `tag`
+        # @return [String]
+        attr_accessor :tag
+      
+        # The grammatical gender.
+        # Corresponds to the JSON property `gender`
+        # @return [String]
+        attr_accessor :gender
+      
+        # The grammatical person.
+        # Corresponds to the JSON property `person`
+        # @return [String]
+        attr_accessor :person
+      
+        # The grammatical properness.
+        # Corresponds to the JSON property `proper`
+        # @return [String]
+        attr_accessor :proper
       
         def initialize(**args)
            update!(**args)
@@ -719,28 +712,35 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @text = args[:text] if args.key?(:text)
-          @part_of_speech = args[:part_of_speech] if args.key?(:part_of_speech)
-          @dependency_edge = args[:dependency_edge] if args.key?(:dependency_edge)
-          @lemma = args[:lemma] if args.key?(:lemma)
+          @case = args[:case] if args.key?(:case)
+          @tense = args[:tense] if args.key?(:tense)
+          @reciprocity = args[:reciprocity] if args.key?(:reciprocity)
+          @form = args[:form] if args.key?(:form)
+          @number = args[:number] if args.key?(:number)
+          @voice = args[:voice] if args.key?(:voice)
+          @aspect = args[:aspect] if args.key?(:aspect)
+          @mood = args[:mood] if args.key?(:mood)
+          @tag = args[:tag] if args.key?(:tag)
+          @gender = args[:gender] if args.key?(:gender)
+          @person = args[:person] if args.key?(:person)
+          @proper = args[:proper] if args.key?(:proper)
         end
       end
       
-      # The entity analysis response message.
-      class AnalyzeEntitiesResponse
+      # The syntax analysis request message.
+      class AnalyzeSyntaxRequest
         include Google::Apis::Core::Hashable
       
-        # The recognized entities in the input document.
-        # 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.
-        # Corresponds to the JSON property `language`
+        # The encoding type used by the API to calculate offsets.
+        # Corresponds to the JSON property `encodingType`
         # @return [String]
-        attr_accessor :language
+        attr_accessor :encoding_type
+      
+        # ################################################################ #
+        # Represents the input to API methods.
+        # Corresponds to the JSON property `document`
+        # @return [Google::Apis::LanguageV1beta1::Document]
+        attr_accessor :document
       
         def initialize(**args)
            update!(**args)
@@ -748,8 +748,8 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @entities = args[:entities] if args.key?(:entities)
-          @language = args[:language] if args.key?(:language)
+          @encoding_type = args[:encoding_type] if args.key?(:encoding_type)
+          @document = args[:document] if args.key?(:document)
         end
       end
     end