Bump version, regen APIs

This commit is contained in:
Steve Bazyl committed 2017-05-26 10:44:32 -06:00
1 parent b8f6f7c2fe
commit 9237ba59cb
241 files changed
+53894 -50212

No files matched your search

+315 -315
View File
@@ -22,290 +22,12 @@ module Google
module Apis
module LanguageV1
# 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
# 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 status code, which should be an enum value of google.rpc.Code.
# Corresponds to the JSON property `code`
# @return [Fixnum]
attr_accessor :code
# 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)
end
# Update properties of this object
def update!(**args)
@details = args[:details] if args.key?(:details)
@code = args[:code] if args.key?(:code)
@message = args[:message] if args.key?(:message)
end
end
# 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
# 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]
attr_accessor :extract_document_sentiment
alias_method :extract_document_sentiment?, :extract_document_sentiment
# Extract entities.
# Corresponds to the JSON property `extractEntities`
# @return [Boolean]
attr_accessor :extract_entities
alias_method :extract_entities?, :extract_entities
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)
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::LanguageV1::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
# Update properties of this object
def update!(**args)
@text = args[:text] if args.key?(:text)
@type = args[:type] if args.key?(:type)
end
end
# ################################################################ #
# Represents the input to API methods.
class Document
include Google::Apis::Core::Hashable
# 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.
# 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.
# Corresponds to the JSON property `type`
# @return [String]
attr_accessor :type
# The content of the input in string format.
# Corresponds to the JSON property `content`
# @return [String]
attr_accessor :content
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@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
# Represents a sentence in the input document.
class Sentence
include Google::Apis::Core::Hashable
# Represents the feeling associated with the entire text or entities in
# the text.
# Corresponds to the JSON property `sentiment`
# @return [Google::Apis::LanguageV1::Sentiment]
attr_accessor :sentiment
# Represents an output piece of text.
# Corresponds to the JSON property `text`
# @return [Google::Apis::LanguageV1::TextSpan]
attr_accessor :text
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@sentiment = args[:sentiment] if args.key?(:sentiment)
@text = args[:text] if args.key?(:text)
end
end
# Represents the feeling associated with the entire text or entities in
# the text.
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
# 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
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@score = args[:score] if args.key?(:score)
@magnitude = args[:magnitude] if args.key?(:magnitude)
end
end
# The entity analysis request message.
class AnalyzeEntitiesRequest
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::LanguageV1::Document]
attr_accessor :document
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@encoding_type = args[:encoding_type] if args.key?(:encoding_type)
@document = args[:document] if args.key?(:document)
end
end
# Represents part of speech information for a token. Parts of speech
# are as defined in
# http://www.lrec-conf.org/proceedings/lrec2012/pdf/274_Paper.pdf
class PartOfSpeech
include Google::Apis::Core::Hashable
# The grammatical case.
# Corresponds to the JSON property `case`
# @return [String]
attr_accessor :case
# The grammatical tense.
# Corresponds to the JSON property `tense`
# @return [String]
attr_accessor :tense
# The grammatical reciprocity.
# Corresponds to the JSON property `reciprocity`
# @return [String]
attr_accessor :reciprocity
# The grammatical form.
# Corresponds to the JSON property `form`
# @return [String]
@@ -351,15 +73,27 @@ module Google
# @return [String]
attr_accessor :proper
# The grammatical case.
# Corresponds to the JSON property `case`
# @return [String]
attr_accessor :case
# The grammatical tense.
# Corresponds to the JSON property `tense`
# @return [String]
attr_accessor :tense
# The grammatical reciprocity.
# Corresponds to the JSON property `reciprocity`
# @return [String]
attr_accessor :reciprocity
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@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)
@@ -369,6 +103,9 @@ module Google
@gender = args[:gender] if args.key?(:gender)
@person = args[:person] if args.key?(:person)
@proper = args[:proper] if args.key?(:proper)
@case = args[:case] if args.key?(:case)
@tense = args[:tense] if args.key?(:tense)
@reciprocity = args[:reciprocity] if args.key?(:reciprocity)
end
end
@@ -582,13 +319,6 @@ module Google
class AnnotateTextResponse
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::LanguageV1::Entity>]
attr_accessor :entities
# Represents the feeling associated with the entire text or entities in
# the text.
# Corresponds to the JSON property `documentSentiment`
@@ -615,17 +345,24 @@ module Google
# @return [Array<Google::Apis::LanguageV1::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::LanguageV1::Entity>]
attr_accessor :entities
def initialize(**args)
update!(**args)
end
# 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)
@sentences = args[:sentences] if args.key?(:sentences)
@tokens = args[:tokens] if args.key?(:tokens)
@entities = args[:entities] if args.key?(:entities)
end
end
@@ -661,11 +398,6 @@ module Google
class DependencyEdge
include Google::Apis::Core::Hashable
# The parse label for the token.
# Corresponds to the JSON property `label`
# @return [String]
attr_accessor :label
# 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
@@ -675,14 +407,60 @@ module Google
# @return [Fixnum]
attr_accessor :head_token_index
# The parse label for the token.
# Corresponds to the JSON property `label`
# @return [String]
attr_accessor :label
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@label = args[:label] if args.key?(:label)
@head_token_index = args[:head_token_index] if args.key?(:head_token_index)
@label = args[:label] if args.key?(:label)
end
end
# Represents the smallest syntactic building block of the text.
class Token
include Google::Apis::Core::Hashable
# Represents an output piece of text.
# Corresponds to the JSON property `text`
# @return [Google::Apis::LanguageV1::TextSpan]
attr_accessor :text
# Represents dependency parse tree information for a token. (For more
# information on dependency labels, see
# http://www.aclweb.org/anthology/P13-2017
# Corresponds to the JSON property `dependencyEdge`
# @return [Google::Apis::LanguageV1::DependencyEdge]
attr_accessor :dependency_edge
# [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. Parts of speech
# are as defined in
# http://www.lrec-conf.org/proceedings/lrec2012/pdf/274_Paper.pdf
# Corresponds to the JSON property `partOfSpeech`
# @return [Google::Apis::LanguageV1::PartOfSpeech]
attr_accessor :part_of_speech
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@text = args[:text] if args.key?(:text)
@dependency_edge = args[:dependency_edge] if args.key?(:dependency_edge)
@lemma = args[:lemma] if args.key?(:lemma)
@part_of_speech = args[:part_of_speech] if args.key?(:part_of_speech)
end
end
@@ -712,33 +490,92 @@ module Google
end
end
# Represents the smallest syntactic building block of the text.
class Token
# The `Status` type defines a logical error model that is suitable for different
# programming environments, including REST APIs and RPC APIs. It is used by
# [gRPC](https://github.com/grpc). The error model is designed to be:
# - Simple to use and understand for most users
# - Flexible enough to meet unexpected needs
# # Overview
# The `Status` message contains three pieces of data: error code, error message,
# and error details. The error code should be an enum value of
# google.rpc.Code, but it may accept additional error codes if needed. The
# error message should be a developer-facing English message that helps
# developers *understand* and *resolve* the error. If a localized user-facing
# error message is needed, put the localized message in the error details or
# localize it in the client. The optional error details may contain arbitrary
# information about the error. There is a predefined set of error detail types
# in the package `google.rpc` that can be used for common error conditions.
# # Language mapping
# The `Status` message is the logical representation of the error model, but it
# is not necessarily the actual wire format. When the `Status` message is
# exposed in different client libraries and different wire protocols, it can be
# mapped differently. For example, it will likely be mapped to some exceptions
# in Java, but more likely mapped to some error codes in C.
# # Other uses
# The error model and the `Status` message can be used in a variety of
# environments, either with or without APIs, to provide a
# consistent developer experience across different environments.
# Example uses of this error model include:
# - Partial errors. If a service needs to return partial errors to the client,
# it may embed the `Status` in the normal response to indicate the partial
# errors.
# - Workflow errors. A typical workflow has multiple steps. Each step may
# have a `Status` message for error reporting.
# - Batch operations. If a client uses batch request and batch response, the
# `Status` message should be used directly inside batch response, one for
# each error sub-response.
# - Asynchronous operations. If an API call embeds asynchronous operation
# results in its response, the status of those operations should be
# represented directly using the `Status` message.
# - Logging. If some API errors are stored in logs, the message `Status` could
# be used directly after any stripping needed for security/privacy reasons.
class Status
include Google::Apis::Core::Hashable
# [Lemma](https://en.wikipedia.org/wiki/Lemma_%28morphology%29) of the token.
# Corresponds to the JSON property `lemma`
# The status code, which should be an enum value of google.rpc.Code.
# Corresponds to the JSON property `code`
# @return [Fixnum]
attr_accessor :code
# 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 :lemma
attr_accessor :message
# Represents part of speech information for a token. Parts of speech
# are as defined in
# http://www.lrec-conf.org/proceedings/lrec2012/pdf/274_Paper.pdf
# Corresponds to the JSON property `partOfSpeech`
# @return [Google::Apis::LanguageV1::PartOfSpeech]
attr_accessor :part_of_speech
# 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
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@code = args[:code] if args.key?(:code)
@message = args[:message] if args.key?(:message)
@details = args[:details] if args.key?(:details)
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::LanguageV1::TextSpan]
attr_accessor :text
# Represents dependency parse tree information for a token. (For more
# information on dependency labels, see
# http://www.aclweb.org/anthology/P13-2017
# Corresponds to the JSON property `dependencyEdge`
# @return [Google::Apis::LanguageV1::DependencyEdge]
attr_accessor :dependency_edge
# The type of the entity mention.
# Corresponds to the JSON property `type`
# @return [String]
attr_accessor :type
def initialize(**args)
update!(**args)
@@ -746,10 +583,173 @@ module Google
# Update properties of this object
def update!(**args)
@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)
@type = args[:type] if args.key?(:type)
end
end
# 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
# 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]
attr_accessor :extract_document_sentiment
alias_method :extract_document_sentiment?, :extract_document_sentiment
# Extract entities.
# Corresponds to the JSON property `extractEntities`
# @return [Boolean]
attr_accessor :extract_entities
alias_method :extract_entities?, :extract_entities
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)
end
end
# ################################################################ #
# Represents the input to API methods.
class Document
include Google::Apis::Core::Hashable
# 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 content of the input in string format.
# 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.
# 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](/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
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@type = args[:type] if args.key?(:type)
@content = args[:content] if args.key?(:content)
@gcs_content_uri = args[:gcs_content_uri] if args.key?(:gcs_content_uri)
@language = args[:language] if args.key?(:language)
end
end
# Represents a sentence in the input document.
class Sentence
include Google::Apis::Core::Hashable
# Represents an output piece of text.
# Corresponds to the JSON property `text`
# @return [Google::Apis::LanguageV1::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::LanguageV1::Sentiment]
attr_accessor :sentiment
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@text = args[:text] if args.key?(:text)
@sentiment = args[:sentiment] if args.key?(:sentiment)
end
end
# The entity analysis request message.
class AnalyzeEntitiesRequest
include Google::Apis::Core::Hashable
# ################################################################ #
# Represents the input to API methods.
# Corresponds to the JSON property `document`
# @return [Google::Apis::LanguageV1::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
# 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).
# Corresponds to the JSON property `magnitude`
# @return [Float]
attr_accessor :magnitude
# Sentiment score between -1.0 (negative sentiment) and 1.0
# (positive sentiment).
# Corresponds to the JSON property `score`
# @return [Float]
attr_accessor :score
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@magnitude = args[:magnitude] if args.key?(:magnitude)
@score = args[:score] if args.key?(:score)
end
end
end