Api-roll 42: 2016-11-08

discovery/googleapis_beta/language__v1beta1.json

 {
     "auth": {
         "oauth2": {
             "scopes": {
                 "https://www.googleapis.com/auth/cloud-platform": {
                     "description": "View and manage your data across Google Cloud Platform services"
                 }
             }
         }
     },
     "basePath": "",
     "baseUrl": "https://language.googleapis.com/",
     "batchPath": "batch",
-    "canonicalName": "Cloud Natural Language API",
+    "canonicalName": "Cloud Natural Language",
     "description": "Google Cloud Natural Language API provides natural language understanding technologies to developers. Examples include sentiment analysis, entity recognition, and text annotations.",
     "discoveryVersion": "v1",
     "documentationLink": "https://cloud.google.com/natural-language/",
     "icons": {
         "x16": "http://www.google.com/images/icons/product/search-16.gif",
         "x32": "http://www.google.com/images/icons/product/search-32.gif"
     },
     "id": "language:v1beta1",
     "kind": "discovery#restDescription",
     "name": "language",
@@ skipping 102 matching lines @@
                         "$ref": "AnalyzeSentimentRequest"
                     },
                     "response": {
                         "$ref": "AnalyzeSentimentResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform"
                     ]
                 },
                 "annotateText": {
-                    "description": "Advanced API that analyzes the document and provides a full set of text\nannotations, including semantic, syntactic, and sentiment information. This\nAPI is intended for users who are familiar with machine learning and need\nin-depth text features to build upon.",
+                    "description": "A convenience method that provides all the features that analyzeSentiment,\nanalyzeEntities, and analyzeSyntax provide in one call.",
                     "httpMethod": "POST",
                     "id": "language.documents.annotateText",
                     "parameterOrder": [],
                     "parameters": {},
                     "path": "v1beta1/documents:annotateText",
                     "request": {
                         "$ref": "AnnotateTextRequest"
                     },
                     "response": {
                         "$ref": "AnnotateTextResponse"
@@ skipping 15 matching lines @@
                     "response": {
                         "$ref": "AnalyzeEntitiesResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform"
                     ]
                 }
             }
         }
     },
-    "revision": "20160816",
+    "revision": "20161103",
     "rootUrl": "https://language.googleapis.com/",
     "schemas": {
         "Document": {
             "description": "################################################################ #\n\nRepresents the input to API methods.",
             "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.",
                     "type": "string"
                 },
@@ skipping 297 matching lines @@
                         "Compound of numeric modifier",
                         "Copula",
                         "Dislocated relation (for fronted/topicalized elements)"
                     ],
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "AnnotateTextRequest": {
-            "description": "The request message for the advanced text annotation API, which performs all\nthe above plus syntactic analysis.",
+            "description": "The request message for the text annotation API, which can perform multiple\nanalysis types (sentiment, entities, and syntax) in one call.",
             "id": "AnnotateTextRequest",
             "properties": {
                 "document": {
                     "$ref": "Document",
                     "description": "Input document."
                 },
                 "encodingType": {
                     "description": "The encoding type used by the API to calculate offsets.",
                     "enum": [
                         "NONE",
@@ skipping 98 matching lines @@
                     "items": {
                         "$ref": "Entity"
                     },
                     "type": "array"
                 },
                 "documentSentiment": {
                     "$ref": "Sentiment",
                     "description": "The overall sentiment for the document. Populated if the user enables\nAnnotateTextRequest.Features.extract_document_sentiment."
                 },
                 "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.",
+                    "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.\nPopulated if the user enables\nAnnotateTextRequest.Features.extract_syntax.",
                     "items": {
                         "$ref": "Token"
                     },
                     "type": "array"
                 },
                 "sentences": {
@@ skipping 58 matching lines @@
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Sentiment": {
             "description": "Represents the feeling associated with the entire text or entities in\nthe text.",
             "id": "Sentiment",
             "properties": {
                 "polarity": {
-                    "description": "Polarity of the sentiment in the [-1.0, 1.0] range. Larger numbers\nrepresent more positive sentiments.",
+                    "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).",
                     "format": "float",
                     "type": "number"
                 }
             },
             "type": "object"
@@ skipping 26 matching lines @@
             "id": "AnalyzeEntitiesResponse",
             "properties": {
                 "entities": {
                     "description": "The recognized entities in the input document.",
                     "items": {
                         "$ref": "Entity"
                     },
                     "type": "array"
                 },
                 "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.",
+                    "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"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "",
     "title": "Google Cloud Natural Language API",
     "version": "v1beta1"
 }