google-api-client 0.9.20 → 0.9.21

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 = '20161103'
+      REVISION = '20170103'
 
       # 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

@@ -31,9 +31,7 @@ module Google
         # automatically detected). Both ISO and BCP-47 language codes are
         # accepted.<br>
         # **Current Language Restrictions:**
-        # * Only English, Spanish, and Japanese textual content
-        # are supported, with the following additional restriction:
-        # * `analyzeSentiment` only supports English text.
+        # * 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.
@@ -42,6 +40,9 @@ module Google
         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
@@ -204,6 +205,11 @@ module Google
         # @return [Google::Apis::LanguageV1beta1::TextSpan]
         attr_accessor :text
       
+        # The type of the entity mention.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
         def initialize(**args)
            update!(**args)
         end
@@ -211,6 +217,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @text = args[:text] if args.key?(:text)
+          @type = args[:type] if args.key?(:type)
         end
       end
       
@@ -224,6 +231,12 @@ module Google
         # @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
+      
         def initialize(**args)
            update!(**args)
         end
@@ -231,6 +244,7 @@ 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)
         end
       end
       
@@ -250,6 +264,11 @@ module Google
         # @return [String]
         attr_accessor :language
       
+        # The sentiment for all the sentences in the document.
+        # Corresponds to the JSON property `sentences`
+        # @return [Array<Google::Apis::LanguageV1beta1::Sentence>]
+        attr_accessor :sentences
+      
         def initialize(**args)
            update!(**args)
         end
@@ -258,6 +277,33 @@ module Google
         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)
+        end
+      end
+      
+      # The syntax analysis request message.
+      class AnalyzeSyntaxRequest
+        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 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)
         end
       end
       
@@ -290,6 +336,39 @@ module Google
         end
       end
       
+      # The syntax analysis response message.
+      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.
+        # Corresponds to the JSON property `language`
+        # @return [String]
+        attr_accessor :language
+      
+        # 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
+      
+        # Sentences in the input document.
+        # Corresponds to the JSON property `sentences`
+        # @return [Array<Google::Apis::LanguageV1beta1::Sentence>]
+        attr_accessor :sentences
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # 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)
+        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
@@ -333,6 +412,12 @@ 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
+      
         def initialize(**args)
            update!(**args)
         end
@@ -340,6 +425,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)
         end
       end
       
@@ -382,18 +468,84 @@ module Google
       class PartOfSpeech
         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`
         # @return [String]
         attr_accessor :tag
       
+        # The grammatical number.
+        # Corresponds to the JSON property `number`
+        # @return [String]
+        attr_accessor :number
+      
+        # The grammatical reciprocity.
+        # Corresponds to the JSON property `reciprocity`
+        # @return [String]
+        attr_accessor :reciprocity
+      
+        # The grammatical voice.
+        # Corresponds to the JSON property `voice`
+        # @return [String]
+        attr_accessor :voice
+      
         def initialize(**args)
            update!(**args)
         end
       
         # 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)
         end
       end
       
@@ -455,8 +607,8 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Metadata associated with the entity.
-        # Currently, only Wikipedia URLs are provided, if available.
-        # The associated key is "wikipedia_url".
+        # 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
@@ -505,6 +657,12 @@ 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.
@@ -513,7 +671,7 @@ module Google
         attr_accessor :polarity
       
         # A non-negative number in the [0, +inf) range, which represents
-        # the absolute magnitude of sentiment regardless of polarity (positive or
+        # the absolute magnitude of sentiment regardless of score (positive or
         # negative).
         # Corresponds to the JSON property `magnitude`
         # @return [Float]
@@ -525,6 +683,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @score = args[:score] if args.key?(:score)
           @polarity = args[:polarity] if args.key?(:polarity)
           @magnitude = args[:magnitude] if args.key?(:magnitude)
         end
@@ -549,8 +708,7 @@ module Google
         # @return [Google::Apis::LanguageV1beta1::DependencyEdge]
         attr_accessor :dependency_edge
       
-        # [Lemma](https://en.wikipedia.org/wiki/Lemma_(morphology))
-        # of the token.
+        # [Lemma](https://en.wikipedia.org/wiki/Lemma_%28morphology%29) of the token.
         # Corresponds to the JSON property `lemma`
         # @return [String]
         attr_accessor :lemma

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

@@ -64,12 +64,24 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class AnalyzeSyntaxRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class DependencyEdge
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class AnalyzeSyntaxResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class AnnotateTextRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -165,6 +177,7 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :text, as: 'text', class: Google::Apis::LanguageV1beta1::TextSpan, decorator: Google::Apis::LanguageV1beta1::TextSpan::Representation
       
+          property :type, as: 'type'
         end
       end
       
@@ -173,6 +186,7 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :document, as: 'document', class: Google::Apis::LanguageV1beta1::Document, decorator: Google::Apis::LanguageV1beta1::Document::Representation
       
+          property :encoding_type, as: 'encodingType'
         end
       end
       
@@ -182,6 +196,17 @@ module Google
           property :document_sentiment, as: 'documentSentiment', class: Google::Apis::LanguageV1beta1::Sentiment, decorator: Google::Apis::LanguageV1beta1::Sentiment::Representation
       
           property :language, as: 'language'
+          collection :sentences, as: 'sentences', class: Google::Apis::LanguageV1beta1::Sentence, decorator: Google::Apis::LanguageV1beta1::Sentence::Representation
+      
+        end
+      end
+      
+      class AnalyzeSyntaxRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :document, as: 'document', class: Google::Apis::LanguageV1beta1::Document, decorator: Google::Apis::LanguageV1beta1::Document::Representation
+      
+          property :encoding_type, as: 'encodingType'
         end
       end
       
@@ -193,6 +218,17 @@ module Google
         end
       end
       
+      class AnalyzeSyntaxResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :language, as: 'language'
+          collection :tokens, as: 'tokens', class: Google::Apis::LanguageV1beta1::Token, decorator: Google::Apis::LanguageV1beta1::Token::Representation
+      
+          collection :sentences, as: 'sentences', class: Google::Apis::LanguageV1beta1::Sentence, decorator: Google::Apis::LanguageV1beta1::Sentence::Representation
+      
+        end
+      end
+      
       class AnnotateTextRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -209,6 +245,8 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :text, as: 'text', class: Google::Apis::LanguageV1beta1::TextSpan, decorator: Google::Apis::LanguageV1beta1::TextSpan::Representation
       
+          property :sentiment, as: 'sentiment', class: Google::Apis::LanguageV1beta1::Sentiment, decorator: Google::Apis::LanguageV1beta1::Sentiment::Representation
+      
         end
       end
       
@@ -224,7 +262,18 @@ module Google
       class PartOfSpeech
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :aspect, as: 'aspect'
+          property :gender, as: 'gender'
+          property :person, as: 'person'
+          property :case, as: 'case'
+          property :form, as: 'form'
+          property :tense, as: 'tense'
+          property :proper, as: 'proper'
+          property :mood, as: 'mood'
           property :tag, as: 'tag'
+          property :number, as: 'number'
+          property :reciprocity, as: 'reciprocity'
+          property :voice, as: 'voice'
         end
       end
       
@@ -258,6 +307,7 @@ module Google
       class Sentiment
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :score, as: 'score'
           property :polarity, as: 'polarity'
           property :magnitude, as: 'magnitude'
         end

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

@@ -78,6 +78,38 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Analyzes the syntax of the text and provides sentence boundaries and
+        # tokenization along with part of speech tags, dependency trees, and other
+        # properties.
+        # @param [Google::Apis::LanguageV1beta1::AnalyzeSyntaxRequest] analyze_syntax_request_object
+        # @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
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::LanguageV1beta1::AnalyzeSyntaxResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::LanguageV1beta1::AnalyzeSyntaxResponse]
+        #
+        # @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 analyze_document_syntax(analyze_syntax_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1beta1/documents:analyzeSyntax', options)
+          command.request_representation = Google::Apis::LanguageV1beta1::AnalyzeSyntaxRequest::Representation
+          command.request_object = analyze_syntax_request_object
+          command.response_representation = Google::Apis::LanguageV1beta1::AnalyzeSyntaxResponse::Representation
+          command.response_class = Google::Apis::LanguageV1beta1::AnalyzeSyntaxResponse
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['fields'] = fields unless fields.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # A convenience method that provides all the features that analyzeSentiment,
         # analyzeEntities, and analyzeSyntax provide in one call.
         # @param [Google::Apis::LanguageV1beta1::AnnotateTextRequest] annotate_text_request_object