Index: discovery/googleapis_beta/language__v1beta1.json |
diff --git a/discovery/googleapis_beta/language__v1beta1.json b/discovery/googleapis_beta/language__v1beta1.json |
index 8deb053d1e22e23e6a5ce3b1bd24017c02287d8c..32e3349ea9bfc45f7f287b17cb1c76c755496621 100644 |
--- a/discovery/googleapis_beta/language__v1beta1.json |
+++ b/discovery/googleapis_beta/language__v1beta1.json |
@@ -133,6 +133,23 @@ |
"https://www.googleapis.com/auth/cloud-platform" |
] |
}, |
+ "analyzeSyntax": { |
+ "description": "Analyzes the syntax of the text and provides sentence boundaries and\ntokenization along with part of speech tags, dependency trees, and other\nproperties.", |
+ "httpMethod": "POST", |
+ "id": "language.documents.analyzeSyntax", |
+ "parameterOrder": [], |
+ "parameters": {}, |
+ "path": "v1beta1/documents:analyzeSyntax", |
+ "request": { |
+ "$ref": "AnalyzeSyntaxRequest" |
+ }, |
+ "response": { |
+ "$ref": "AnalyzeSyntaxResponse" |
+ }, |
+ "scopes": [ |
+ "https://www.googleapis.com/auth/cloud-platform" |
+ ] |
+ }, |
"annotateText": { |
"description": "A convenience method that provides all the features that analyzeSentiment,\nanalyzeEntities, and analyzeSyntax provide in one call.", |
"httpMethod": "POST", |
@@ -170,7 +187,7 @@ |
} |
} |
}, |
- "revision": "20161103", |
+ "revision": "20161205", |
"rootUrl": "https://language.googleapis.com/", |
"schemas": { |
"Document": { |
@@ -178,11 +195,11 @@ |
"id": "Document", |
"properties": { |
"language": { |
- "description": "The language of the document (if not specified, the language is\nautomatically detected). Both ISO and BCP-47 language codes are\naccepted.<br>\n**Current Language Restrictions:**\n\n * Only English, Spanish, and Japanese textual content\n are supported, with the following additional restriction:\n * `analyzeSentiment` only supports English text.\nIf the language (either specified by the caller or automatically detected)\nis not supported by the called API method, an `INVALID_ARGUMENT` error\nis returned.", |
+ "description": "The language of the document (if not specified, the language is\nautomatically detected). Both ISO and BCP-47 language codes are\naccepted.<br>\n**Current Language Restrictions:**\n\n * Only English, Spanish, and Japanese textual content are supported.\nIf the language (either specified by the caller or automatically detected)\nis not supported by the called API method, an `INVALID_ARGUMENT` error\nis returned.", |
"type": "string" |
}, |
"gcsContentUri": { |
- "description": "The Google Cloud Storage URI where the file content is located.", |
+ "description": "The Google Cloud Storage URI where the file content is located.\nThis URI must be of the form: gs://bucket_name/object_name. For more\ndetails, see https://cloud.google.com/storage/docs/reference-uris.\nNOTE: Cloud Storage object versioning is not supported.", |
"type": "string" |
}, |
"type": { |
@@ -283,6 +300,20 @@ |
"text": { |
"$ref": "TextSpan", |
"description": "The mention text." |
+ }, |
+ "type": { |
+ "description": "The type of the entity mention.", |
+ "enum": [ |
+ "TYPE_UNKNOWN", |
+ "PROPER", |
+ "COMMON" |
+ ], |
+ "enumDescriptions": [ |
+ "Unknown", |
+ "Proper name", |
+ "Common noun (or noun compound)" |
+ ], |
+ "type": "string" |
} |
}, |
"type": "object" |
@@ -294,6 +325,22 @@ |
"document": { |
"$ref": "Document", |
"description": "Input document. Currently, `analyzeSentiment` only supports English text\n(Document.language=\"EN\")." |
+ }, |
+ "encodingType": { |
+ "description": "The encoding type used by the API to calculate sentence offsets for the\nsentence sentiment.", |
+ "enum": [ |
+ "NONE", |
+ "UTF8", |
+ "UTF16", |
+ "UTF32" |
+ ], |
+ "enumDescriptions": [ |
+ "If `EncodingType` is not specified, encoding-dependent information (such as\n`begin_offset`) will be set at `-1`.", |
+ "Encoding-dependent information (such as `begin_offset`) is calculated based\non the UTF-8 encoding of the input. C++ and Go are examples of languages\nthat use this encoding natively.", |
+ "Encoding-dependent information (such as `begin_offset`) is calculated based\non the UTF-16 encoding of the input. Java and Javascript are examples of\nlanguages that use this encoding natively.", |
+ "Encoding-dependent information (such as `begin_offset`) is calculated based\non the UTF-32 encoding of the input. Python is an example of a language\nthat uses this encoding natively." |
+ ], |
+ "type": "string" |
} |
}, |
"type": "object" |
@@ -309,6 +356,40 @@ |
"language": { |
"description": "The language of the text, which will be the same as the language specified\nin the request or, if not specified, the automatically-detected language.", |
"type": "string" |
+ }, |
+ "sentences": { |
+ "description": "The sentiment for all the sentences in the document.", |
+ "items": { |
+ "$ref": "Sentence" |
+ }, |
+ "type": "array" |
+ } |
+ }, |
+ "type": "object" |
+ }, |
+ "AnalyzeSyntaxRequest": { |
+ "description": "The syntax analysis request message.", |
+ "id": "AnalyzeSyntaxRequest", |
+ "properties": { |
+ "document": { |
+ "$ref": "Document", |
+ "description": "Input document." |
+ }, |
+ "encodingType": { |
+ "description": "The encoding type used by the API to calculate offsets.", |
+ "enum": [ |
+ "NONE", |
+ "UTF8", |
+ "UTF16", |
+ "UTF32" |
+ ], |
+ "enumDescriptions": [ |
+ "If `EncodingType` is not specified, encoding-dependent information (such as\n`begin_offset`) will be set at `-1`.", |
+ "Encoding-dependent information (such as `begin_offset`) is calculated based\non the UTF-8 encoding of the input. C++ and Go are examples of languages\nthat use this encoding natively.", |
+ "Encoding-dependent information (such as `begin_offset`) is calculated based\non the UTF-16 encoding of the input. Java and Javascript are examples of\nlanguages that use this encoding natively.", |
+ "Encoding-dependent information (such as `begin_offset`) is calculated based\non the UTF-32 encoding of the input. Python is an example of a language\nthat uses this encoding natively." |
+ ], |
+ "type": "string" |
} |
}, |
"type": "object" |
@@ -487,6 +568,31 @@ |
}, |
"type": "object" |
}, |
+ "AnalyzeSyntaxResponse": { |
+ "description": "The syntax analysis response message.", |
+ "id": "AnalyzeSyntaxResponse", |
+ "properties": { |
+ "language": { |
+ "description": "The language of the text, which will be the same as the language specified\nin the request or, if not specified, the automatically-detected language.\nSee Document.language field for more details.", |
+ "type": "string" |
+ }, |
+ "tokens": { |
+ "description": "Tokens, along with their syntactic information, in the input document.", |
+ "items": { |
+ "$ref": "Token" |
+ }, |
+ "type": "array" |
+ }, |
+ "sentences": { |
+ "description": "Sentences in the input document.", |
+ "items": { |
+ "$ref": "Sentence" |
+ }, |
+ "type": "array" |
+ } |
+ }, |
+ "type": "object" |
+ }, |
"AnnotateTextRequest": { |
"description": "The request message for the text annotation API, which can perform multiple\nanalysis types (sentiment, entities, and syntax) in one call.", |
"id": "AnnotateTextRequest", |
@@ -525,6 +631,10 @@ |
"text": { |
"$ref": "TextSpan", |
"description": "The sentence text." |
+ }, |
+ "sentiment": { |
+ "$ref": "Sentiment", |
+ "description": "For calls to AnalyzeSentiment or if\nAnnotateTextRequest.Features.extract_document_sentiment is set to\ntrue, this field will contain the sentiment for the sentence." |
} |
}, |
"type": "object" |
@@ -552,6 +662,184 @@ |
"description": "Represents part of speech information for a token.", |
"id": "PartOfSpeech", |
"properties": { |
+ "aspect": { |
+ "description": "The grammatical aspect.", |
+ "enum": [ |
+ "ASPECT_UNKNOWN", |
+ "PERFECTIVE", |
+ "IMPERFECTIVE", |
+ "PROGRESSIVE" |
+ ], |
+ "enumDescriptions": [ |
+ "Aspect is not applicable in the analyzed language or is not predicted.", |
+ "Perfective", |
+ "Imperfective", |
+ "Progressive" |
+ ], |
+ "type": "string" |
+ }, |
+ "gender": { |
+ "description": "The grammatical gender.", |
+ "enum": [ |
+ "GENDER_UNKNOWN", |
+ "FEMININE", |
+ "MASCULINE", |
+ "NEUTER" |
+ ], |
+ "enumDescriptions": [ |
+ "Gender is not applicable in the analyzed language or is not predicted.", |
+ "Feminine", |
+ "Masculine", |
+ "Neuter" |
+ ], |
+ "type": "string" |
+ }, |
+ "person": { |
+ "description": "The grammatical person.", |
+ "enum": [ |
+ "PERSON_UNKNOWN", |
+ "FIRST", |
+ "SECOND", |
+ "THIRD", |
+ "REFLEXIVE_PERSON" |
+ ], |
+ "enumDescriptions": [ |
+ "Person is not applicable in the analyzed language or is not predicted.", |
+ "First", |
+ "Second", |
+ "Third", |
+ "Reflexive" |
+ ], |
+ "type": "string" |
+ }, |
+ "case": { |
+ "description": "The grammatical case.", |
+ "enum": [ |
+ "CASE_UNKNOWN", |
+ "ACCUSATIVE", |
+ "ADVERBIAL", |
+ "COMPLEMENTIVE", |
+ "DATIVE", |
+ "GENITIVE", |
+ "INSTRUMENTAL", |
+ "LOCATIVE", |
+ "NOMINATIVE", |
+ "OBLIQUE", |
+ "PARTITIVE", |
+ "PREPOSITIONAL", |
+ "REFLEXIVE_CASE", |
+ "RELATIVE_CASE", |
+ "VOCATIVE" |
+ ], |
+ "enumDescriptions": [ |
+ "Case is not applicable in the analyzed language or is not predicted.", |
+ "Accusative", |
+ "Adverbial", |
+ "Complementive", |
+ "Dative", |
+ "Genitive", |
+ "Instrumental", |
+ "Locative", |
+ "Nominative", |
+ "Oblique", |
+ "Partitive", |
+ "Prepositional", |
+ "Reflexive", |
+ "Relative", |
+ "Vocative" |
+ ], |
+ "type": "string" |
+ }, |
+ "form": { |
+ "description": "The grammatical form.", |
+ "enum": [ |
+ "FORM_UNKNOWN", |
+ "ADNOMIAL", |
+ "AUXILIARY", |
+ "COMPLEMENTIZER", |
+ "FINAL_ENDING", |
+ "GERUND", |
+ "REALIS", |
+ "IRREALIS", |
+ "SHORT", |
+ "LONG", |
+ "ORDER", |
+ "SPECIFIC" |
+ ], |
+ "enumDescriptions": [ |
+ "Form is not applicable in the analyzed language or is not predicted.", |
+ "Adnomial", |
+ "Auxiliary", |
+ "Complementizer", |
+ "Final ending", |
+ "Gerund", |
+ "Realis", |
+ "Irrealis", |
+ "Short form", |
+ "Long form", |
+ "Order form", |
+ "Specific form" |
+ ], |
+ "type": "string" |
+ }, |
+ "tense": { |
+ "description": "The grammatical tense.", |
+ "enum": [ |
+ "TENSE_UNKNOWN", |
+ "CONDITIONAL_TENSE", |
+ "FUTURE", |
+ "PAST", |
+ "PRESENT", |
+ "IMPERFECT", |
+ "PLUPERFECT" |
+ ], |
+ "enumDescriptions": [ |
+ "Tense is not applicable in the analyzed language or is not predicted.", |
+ "Conditional", |
+ "Future", |
+ "Past", |
+ "Present", |
+ "Imperfect", |
+ "Pluperfect" |
+ ], |
+ "type": "string" |
+ }, |
+ "proper": { |
+ "description": "The grammatical properness.", |
+ "enum": [ |
+ "PROPER_UNKNOWN", |
+ "PROPER", |
+ "NOT_PROPER" |
+ ], |
+ "enumDescriptions": [ |
+ "Proper is not applicable in the analyzed language or is not predicted.", |
+ "Proper", |
+ "Not proper" |
+ ], |
+ "type": "string" |
+ }, |
+ "mood": { |
+ "description": "The grammatical mood.", |
+ "enum": [ |
+ "MOOD_UNKNOWN", |
+ "CONDITIONAL_MOOD", |
+ "IMPERATIVE", |
+ "INDICATIVE", |
+ "INTERROGATIVE", |
+ "JUSSIVE", |
+ "SUBJUNCTIVE" |
+ ], |
+ "enumDescriptions": [ |
+ "Mood is not applicable in the analyzed language or is not predicted.", |
+ "Conditional", |
+ "Imperative", |
+ "Indicative", |
+ "Interrogative", |
+ "Jussive", |
+ "Subjunctive" |
+ ], |
+ "type": "string" |
+ }, |
"tag": { |
"description": "The part of speech tag.", |
"enum": [ |
@@ -587,6 +875,52 @@ |
"Affix" |
], |
"type": "string" |
+ }, |
+ "number": { |
+ "description": "The grammatical number.", |
+ "enum": [ |
+ "NUMBER_UNKNOWN", |
+ "SINGULAR", |
+ "PLURAL", |
+ "DUAL" |
+ ], |
+ "enumDescriptions": [ |
+ "Number is not applicable in the analyzed language or is not predicted.", |
+ "Singular", |
+ "Plural", |
+ "Dual" |
+ ], |
+ "type": "string" |
+ }, |
+ "reciprocity": { |
+ "description": "The grammatical reciprocity.", |
+ "enum": [ |
+ "RECIPROCITY_UNKNOWN", |
+ "RECIPROCAL", |
+ "NON_RECIPROCAL" |
+ ], |
+ "enumDescriptions": [ |
+ "Reciprocity is not applicable in the analyzed language or is not\npredicted.", |
+ "Reciprocal", |
+ "Non-reciprocal" |
+ ], |
+ "type": "string" |
+ }, |
+ "voice": { |
+ "description": "The grammatical voice.", |
+ "enum": [ |
+ "VOICE_UNKNOWN", |
+ "ACTIVE", |
+ "CAUSATIVE", |
+ "PASSIVE" |
+ ], |
+ "enumDescriptions": [ |
+ "Voice is not applicable in the analyzed language or is not predicted.", |
+ "Active", |
+ "Causative", |
+ "Passive" |
+ ], |
+ "type": "string" |
} |
}, |
"type": "object" |
@@ -635,7 +969,7 @@ |
"additionalProperties": { |
"type": "string" |
}, |
- "description": "Metadata associated with the entity.\n\nCurrently, only Wikipedia URLs are provided, if available.\nThe associated key is \"wikipedia_url\".", |
+ "description": "Metadata associated with the entity.\n\nCurrently, Wikipedia URLs and Knowledge Graph MIDs are provided, if\navailable. The associated keys are \"wikipedia_url\" and \"mid\", respectively.", |
"type": "object" |
}, |
"salience": { |
@@ -685,13 +1019,18 @@ |
"description": "Represents the feeling associated with the entire text or entities in\nthe text.", |
"id": "Sentiment", |
"properties": { |
+ "score": { |
+ "description": "Sentiment score between -1.0 (negative sentiment) and 1.0\n(positive sentiment).", |
+ "format": "float", |
+ "type": "number" |
+ }, |
"polarity": { |
"description": "DEPRECATED FIELD - This field is being deprecated in\nfavor of score. Please refer to our documentation at\nhttps://cloud.google.com/natural-language/docs for more information.", |
"format": "float", |
"type": "number" |
}, |
"magnitude": { |
- "description": "A non-negative number in the [0, +inf) range, which represents\nthe absolute magnitude of sentiment regardless of polarity (positive or\nnegative).", |
+ "description": "A non-negative number in the [0, +inf) range, which represents\nthe absolute magnitude of sentiment regardless of score (positive or\nnegative).", |
"format": "float", |
"type": "number" |
} |
@@ -715,7 +1054,7 @@ |
"description": "Dependency tree parse for this token." |
}, |
"lemma": { |
- "description": "[Lemma](https://en.wikipedia.org/wiki/Lemma_(morphology))\nof the token.", |
+ "description": "[Lemma](https://en.wikipedia.org/wiki/Lemma_%28morphology%29) of the token.", |
"type": "string" |
} |
}, |