Api-Roll 50: 2017-06-12

discovery/googleapis_beta/language__v1beta2.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",
     "description": "Provides natural language understanding technologies to developers. Examples include sentiment analysis, entity recognition, entity sentiment analysis, 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:v1beta2",
     "kind": "discovery#restDescription",
     "name": "language",
     "ownerDomain": "google.com",
     "ownerName": "Google",
     "parameters": {
+        "upload_protocol": {
+            "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
+            "location": "query",
+            "type": "string"
+        },
+        "prettyPrint": {
+            "default": "true",
+            "description": "Returns response with indentations and line breaks.",
+            "location": "query",
+            "type": "boolean"
+        },
         "uploadType": {
             "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
             "location": "query",
             "type": "string"
         },
         "fields": {
             "description": "Selector specifying which fields to include in a partial response.",
             "location": "query",
             "type": "string"
         },
+        "callback": {
+            "description": "JSONP",
+            "location": "query",
+            "type": "string"
+        },
         "$.xgafv": {
             "description": "V1 error format.",
             "enum": [
                 "1",
                 "2"
             ],
             "enumDescriptions": [
                 "v1 error format",
                 "v2 error format"
             ],
             "location": "query",
             "type": "string"
         },
-        "callback": {
-            "description": "JSONP",
-            "location": "query",
-            "type": "string"
-        },
         "alt": {
             "default": "json",
             "description": "Data format for response.",
             "enum": [
                 "json",
                 "media",
                 "proto"
             ],
             "enumDescriptions": [
                 "Responses with Content-Type of application/json",
@@ skipping 17 matching lines @@
             "description": "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.",
             "location": "query",
             "type": "string"
         },
         "pp": {
             "default": "true",
             "description": "Pretty-print response.",
             "location": "query",
             "type": "boolean"
         },
-        "oauth_token": {
-            "description": "OAuth 2.0 token for the current user.",
-            "location": "query",
-            "type": "string"
-        },
         "bearer_token": {
             "description": "OAuth bearer token.",
             "location": "query",
             "type": "string"
         },
-        "upload_protocol": {
-            "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
+        "oauth_token": {
+            "description": "OAuth 2.0 token for the current user.",
             "location": "query",
             "type": "string"
-        },
-        "prettyPrint": {
-            "default": "true",
-            "description": "Returns response with indentations and line breaks.",
-            "location": "query",
-            "type": "boolean"
         }
     },
     "protocol": "rest",
     "resources": {
         "documents": {
             "methods": {
                 "analyzeSentiment": {
                     "description": "Analyzes the sentiment of the provided text.",
                     "httpMethod": "POST",
                     "id": "language.documents.analyzeSentiment",
@@ skipping 74 matching lines @@
                     "response": {
                         "$ref": "AnalyzeSyntaxResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform"
                     ]
                 }
             }
         }
     },
-    "revision": "20170515",
+    "revision": "20170601",
     "rootUrl": "https://language.googleapis.com/",
     "schemas": {
-        "AnalyzeSyntaxResponse": {
-            "description": "The syntax analysis response message.",
-            "id": "AnalyzeSyntaxResponse",
+        "AnalyzeSentimentResponse": {
+            "description": "The sentiment analysis response message.",
+            "id": "AnalyzeSentimentResponse",
+            "properties": {
+                "documentSentiment": {
+                    "$ref": "Sentiment",
+                    "description": "The overall sentiment of the input document."
+                },
+                "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"
+                },
+                "sentences": {
+                    "description": "The sentiment for all the sentences in the document.",
+                    "items": {
+                        "$ref": "Sentence"
+                    },
+                    "type": "array"
+                }
+            },
+            "type": "object"
+        },
+        "AnalyzeEntitiesResponse": {
+            "description": "The entity analysis response message.",
+            "id": "AnalyzeEntitiesResponse",
             "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"
                 },
-                "sentences": {
-                    "description": "Sentences in the input document.",
+                "entities": {
+                    "description": "The recognized entities in the input document.",
                     "items": {
-                        "$ref": "Sentence"
-                    },
-                    "type": "array"
-                },
-                "tokens": {
-                    "description": "Tokens, along with their syntactic information, in the input document.",
-                    "items": {
-                        "$ref": "Token"
+                        "$ref": "Entity"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
         "Entity": {
             "description": "Represents a phrase in the text that is a known entity, such as\na person, an organization, or location. The API associates information, such\nas salience and mentions, with entities.",
             "id": "Entity",
             "properties": {
@@ skipping 44 matching lines @@
                 "mentions": {
                     "description": "The mentions of this entity in the input document. The API currently\nsupports proper noun mentions.",
                     "items": {
                         "$ref": "EntityMention"
                     },
                     "type": "array"
                 }
             },
             "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"
+                },
+                "sentences": {
+                    "description": "Sentences in the input document.",
+                    "items": {
+                        "$ref": "Sentence"
+                    },
+                    "type": "array"
+                },
+                "tokens": {
+                    "description": "Tokens, along with their syntactic information, in the input document.",
+                    "items": {
+                        "$ref": "Token"
+                    },
+                    "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",
             "properties": {
                 "encodingType": {
                     "description": "The encoding type used by the API to calculate offsets.",
                     "enum": [
                         "NONE",
                         "UTF8",
                         "UTF16",
@@ skipping 252 matching lines @@
                     "format": "int32",
                     "type": "integer"
                 }
             },
             "type": "object"
         },
         "Token": {
             "description": "Represents the smallest syntactic building block of the text.",
             "id": "Token",
             "properties": {
-                "lemma": {
-                    "description": "[Lemma](https://en.wikipedia.org/wiki/Lemma_%28morphology%29) of the token.",
-                    "type": "string"
-                },
                 "partOfSpeech": {
                     "$ref": "PartOfSpeech",
                     "description": "Parts of speech tag for this token."
                 },
                 "text": {
                     "$ref": "TextSpan",
                     "description": "The token text."
                 },
                 "dependencyEdge": {
                     "$ref": "DependencyEdge",
                     "description": "Dependency tree parse for this token."
+                },
+                "lemma": {
+                    "description": "[Lemma](https://en.wikipedia.org/wiki/Lemma_%28morphology%29) of the token.",
+                    "type": "string"
                 }
             },
             "type": "object"
         },
         "TextSpan": {
             "description": "Represents an output piece of text.",
             "id": "TextSpan",
             "properties": {
                 "beginOffset": {
                     "description": "The API calculates the beginning offset of the content in the original\ndocument according to the EncodingType specified in the API request.",
@@ skipping 27 matching lines @@
                     "format": "int32",
                     "type": "integer"
                 },
                 "message": {
                     "description": "A developer-facing error message, which should be in English. Any\nuser-facing error message should be localized and sent in the\ngoogle.rpc.Status.details field, or localized by the client.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
-        "Features": {
-            "description": "All available features for sentiment, syntax, and semantic analysis.\nSetting each one to true will enable that specific analysis for the input.",
-            "id": "Features",
-            "properties": {
-                "extractSyntax": {
-                    "description": "Extract syntax information.",
-                    "type": "boolean"
-                },
-                "extractDocumentSentiment": {
-                    "description": "Extract document-level sentiment.",
-                    "type": "boolean"
-                },
-                "extractEntitySentiment": {
-                    "description": "Extract entities and their associated sentiment.",
-                    "type": "boolean"
-                },
-                "extractEntities": {
-                    "description": "Extract entities.",
-                    "type": "boolean"
-                }
-            },
-            "type": "object"
-        },
         "EntityMention": {
             "description": "Represents a mention for an entity in the text. Currently, proper noun\nmentions are supported.",
             "id": "EntityMention",
             "properties": {
+                "sentiment": {
+                    "$ref": "Sentiment",
+                    "description": "For calls to AnalyzeEntitySentiment or if\nAnnotateTextRequest.Features.extract_entity_sentiment is set to\ntrue, this field will contain the sentiment expressed for this mention of\nthe entity in the provided document."
+                },
                 "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"
-                },
-                "sentiment": {
-                    "$ref": "Sentiment",
-                    "description": "For calls to AnalyzeEntitySentiment or if\nAnnotateTextRequest.Features.extract_entity_sentiment is set to\ntrue, this field will contain the sentiment expressed for this mention of\nthe entity in the provided document."
                 }
             },
             "type": "object"
         },
-        "Sentence": {
-            "description": "Represents a sentence in the input document.",
-            "id": "Sentence",
+        "Features": {
+            "description": "All available features for sentiment, syntax, and semantic analysis.\nSetting each one to true will enable that specific analysis for the input.",
+            "id": "Features",
             "properties": {
-                "text": {
-                    "$ref": "TextSpan",
-                    "description": "The sentence text."
+                "extractSyntax": {
+                    "description": "Extract syntax information.",
+                    "type": "boolean"
                 },
-                "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."
+                "extractDocumentSentiment": {
+                    "description": "Extract document-level sentiment.",
+                    "type": "boolean"
+                },
+                "extractEntitySentiment": {
+                    "description": "Extract entities and their associated sentiment.",
+                    "type": "boolean"
+                },
+                "extractEntities": {
+                    "description": "Extract entities.",
+                    "type": "boolean"
                 }
             },
             "type": "object"
         },
         "Document": {
             "description": "################################################################ #\n\nRepresents the input to API methods.",
             "id": "Document",
             "properties": {
-                "gcsContentUri": {
-                    "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"
-                },
                 "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[Language Support](/natural-language/docs/languages)\nlists currently supported languages for each API method.\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"
                 },
                 "type": {
                     "description": "Required. If the type is not set or is `TYPE_UNSPECIFIED`,\nreturns an `INVALID_ARGUMENT` error.",
                     "enum": [
                         "TYPE_UNSPECIFIED",
                         "PLAIN_TEXT",
                         "HTML"
                     ],
                     "enumDescriptions": [
                         "The content type is not specified.",
                         "Plain text",
                         "HTML"
                     ],
                     "type": "string"
                 },
                 "content": {
                     "description": "The content of the input in string format.",
                     "type": "string"
+                },
+                "gcsContentUri": {
+                    "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": "object"
         },
-        "Sentiment": {
-            "description": "Represents the feeling associated with the entire text or entities in\nthe text.",
-            "id": "Sentiment",
+        "Sentence": {
+            "description": "Represents a sentence in the input document.",
+            "id": "Sentence",
             "properties": {
-                "score": {
-                    "description": "Sentiment score between -1.0 (negative sentiment) and 1.0\n(positive sentiment).",
-                    "format": "float",
-                    "type": "number"
+                "text": {
+                    "$ref": "TextSpan",
+                    "description": "The sentence text."
                 },
-                "magnitude": {
-                    "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"
+                "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"
         },
         "AnalyzeEntitiesRequest": {
             "description": "The entity analysis request message.",
             "id": "AnalyzeEntitiesRequest",
             "properties": {
                 "encodingType": {
                     "description": "The encoding type used by the API to calculate offsets.",
@@ skipping 11 matching lines @@
                     ],
                     "type": "string"
                 },
                 "document": {
                     "$ref": "Document",
                     "description": "Input document."
                 }
             },
             "type": "object"
         },
+        "Sentiment": {
+            "description": "Represents the feeling associated with the entire text or entities in\nthe text.",
+            "id": "Sentiment",
+            "properties": {
+                "magnitude": {
+                    "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"
+                },
+                "score": {
+                    "description": "Sentiment score between -1.0 (negative sentiment) and 1.0\n(positive sentiment).",
+                    "format": "float",
+                    "type": "number"
+                }
+            },
+            "type": "object"
+        },
         "AnalyzeEntitySentimentResponse": {
             "description": "The entity-level sentiment analysis response message.",
             "id": "AnalyzeEntitySentimentResponse",
             "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"
-                },
                 "entities": {
                     "description": "The recognized entities in the input document with associated sentiments.",
                     "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.\nSee Document.language field for more details.",
+                    "type": "string"
                 }
             },
             "type": "object"
         },
         "AnalyzeEntitySentimentRequest": {
             "description": "The entity-level sentiment analysis request message.",
             "id": "AnalyzeEntitySentimentRequest",
             "properties": {
                 "encodingType": {
                     "description": "The encoding type used by the API to calculate offsets.",
@@ skipping 15 matching lines @@
                     "$ref": "Document",
                     "description": "Input document."
                 }
             },
             "type": "object"
         },
         "PartOfSpeech": {
             "description": "Represents part of speech information for a token.",
             "id": "PartOfSpeech",
             "properties": {
-                "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"
-                },
                 "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",
@@ skipping 221 matching lines @@
                         "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"
                 }
             },
             "type": "object"
         },
         "AnalyzeSyntaxRequest": {
             "description": "The syntax analysis request message.",
             "id": "AnalyzeSyntaxRequest",
             "properties": {
                 "encodingType": {
                     "description": "The encoding type used by the API to calculate offsets.",
@@ skipping 10 matching lines @@
                         "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"
                 },
                 "document": {
                     "$ref": "Document",
                     "description": "Input document."
                 }
             },
             "type": "object"
-        },
-        "AnalyzeSentimentResponse": {
-            "description": "The sentiment analysis response message.",
-            "id": "AnalyzeSentimentResponse",
-            "properties": {
-                "documentSentiment": {
-                    "$ref": "Sentiment",
-                    "description": "The overall sentiment of the input document."
-                },
-                "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"
-                },
-                "sentences": {
-                    "description": "The sentiment for all the sentences in the document.",
-                    "items": {
-                        "$ref": "Sentence"
-                    },
-                    "type": "array"
-                }
-            },
-            "type": "object"
-        },
-        "AnalyzeEntitiesResponse": {
-            "description": "The entity analysis response message.",
-            "id": "AnalyzeEntitiesResponse",
-            "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"
-                },
-                "entities": {
-                    "description": "The recognized entities in the input document.",
-                    "items": {
-                        "$ref": "Entity"
-                    },
-                    "type": "array"
-                }
-            },
-            "type": "object"
         }
     },
     "servicePath": "",
     "title": "Google Cloud Natural Language API",
     "version": "v1beta2"
 }