Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / google-api-python-client / 2f245374da9c895dbd8bb0423e98707d51b53414 / . / docs / dyn / language_v1beta1.documents.html
blob: 37ff1bf869d4d8f78d870b81f251be975ef8ff93 [file] [log] [blame]
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]1<html><body>
2<style>
3
4body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13}
14
15body {
16 font-size: 13px;
17 padding: 1em;
18}
19
20h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23}
24
25h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28}
29
30h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34}
35
36pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42 margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46 font-family: Arial, sans serif;
47}
48
49h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51}
52
53.toc_element {
54 margin-top: 0.5em;
55}
56
57.firstline {
58 margin-left: 2 em;
59}
60
61.method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66}
67
68.details {
69 font-weight: bold;
70 font-size: 14px;
71}
72
73</style>
74
75<h1><a href="language_v1beta1.html">Google Cloud Natural Language API</a> . <a href="language_v1beta1.documents.html">documents</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78 <code><a href="#analyzeEntities">analyzeEntities(body, x__xgafv=None)</a></code></p>
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame]79<p class="firstline">Finds named entities (currently proper names and common nouns) in the text</p>
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]80<p class="toc_element">
81 <code><a href="#analyzeSentiment">analyzeSentiment(body, x__xgafv=None)</a></code></p>
82<p class="firstline">Analyzes the sentiment of the provided text.</p>
83<p class="toc_element">
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]84 <code><a href="#analyzeSyntax">analyzeSyntax(body, x__xgafv=None)</a></code></p>
85<p class="firstline">Analyzes the syntax of the text and provides sentence boundaries and</p>
86<p class="toc_element">
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]87 <code><a href="#annotateText">annotateText(body, x__xgafv=None)</a></code></p>
Sai Cheemalapatiea3a5e12016-10-12 14:05:53 -0700[diff] [blame]88<p class="firstline">A convenience method that provides all the features that analyzeSentiment,</p>
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]89<h3>Method Details</h3>
90<div class="method">
91 <code class="details" id="analyzeEntities">analyzeEntities(body, x__xgafv=None)</code>
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame]92 <pre>Finds named entities (currently proper names and common nouns) in the text
93along with entity types, salience, mentions for each entity, and
94other properties.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]95
96Args:
97 body: object, The request body. (required)
98 The object takes the form of:
99
100{ # The entity analysis request message.
Thomas Coffee2f245372017-03-27 10:39:26 -0700[diff] [blame^]101 "encodingType": "A String", # The encoding type used by the API to calculate offsets.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]102 "document": { # ################################################################ # # Input document.
103 #
104 # Represents the input to API methods.
105 "content": "A String", # The content of the input in string format.
106 "type": "A String", # Required. If the type is not set or is `TYPE_UNSPECIFIED`,
107 # returns an `INVALID_ARGUMENT` error.
108 "language": "A String", # The language of the document (if not specified, the language is
109 # automatically detected). Both ISO and BCP-47 language codes are
110 # accepted.<br>
111 # **Current Language Restrictions:**
112 #
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]113 # * Only English, Spanish, and Japanese textual content are supported.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]114 # If the language (either specified by the caller or automatically detected)
115 # is not supported by the called API method, an `INVALID_ARGUMENT` error
116 # is returned.
117 "gcsContentUri": "A String", # The Google Cloud Storage URI where the file content is located.
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]118 # This URI must be of the form: gs://bucket_name/object_name. For more
119 # details, see https://cloud.google.com/storage/docs/reference-uris.
120 # NOTE: Cloud Storage object versioning is not supported.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]121 },
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]122 }
123
124 x__xgafv: string, V1 error format.
125 Allowed values
126 1 - v1 error format
127 2 - v2 error format
128
129Returns:
130 An object of the form:
131
132 { # The entity analysis response message.
133 "entities": [ # The recognized entities in the input document.
134 { # Represents a phrase in the text that is a known entity, such as
135 # a person, an organization, or location. The API associates information, such
136 # as salience and mentions, with entities.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]137 "mentions": [ # The mentions of this entity in the input document. The API currently
138 # supports proper noun mentions.
139 { # Represents a mention for an entity in the text. Currently, proper noun
140 # mentions are supported.
141 "text": { # Represents an output piece of text. # The mention text.
142 "content": "A String", # The content of the output text.
143 "beginOffset": 42, # The API calculates the beginning offset of the content in the original
144 # document according to the EncodingType specified in the API request.
145 },
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]146 "type": "A String", # The type of the entity mention.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]147 },
148 ],
149 "salience": 3.14, # The salience score associated with the entity in the [0, 1.0] range.
150 #
151 # The salience score for an entity provides information about the
152 # importance or centrality of that entity to the entire document text.
153 # Scores closer to 0 are less salient, while scores closer to 1.0 are highly
154 # salient.
Sai Cheemalapatic30d2b52017-03-13 12:12:03 -0400[diff] [blame]155 "type": "A String", # The entity type.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]156 "name": "A String", # The representative name for the entity.
157 "metadata": { # Metadata associated with the entity.
158 #
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]159 # Currently, Wikipedia URLs and Knowledge Graph MIDs are provided, if
160 # available. The associated keys are "wikipedia_url" and "mid", respectively.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]161 "a_key": "A String",
162 },
163 },
164 ],
165 "language": "A String", # The language of the text, which will be the same as the language specified
166 # in the request or, if not specified, the automatically-detected language.
Sai Cheemalapatiea3a5e12016-10-12 14:05:53 -0700[diff] [blame]167 # See Document.language field for more details.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]168 }</pre>
169</div>
170
171<div class="method">
172 <code class="details" id="analyzeSentiment">analyzeSentiment(body, x__xgafv=None)</code>
173 <pre>Analyzes the sentiment of the provided text.
174
175Args:
176 body: object, The request body. (required)
177 The object takes the form of:
178
179{ # The sentiment analysis request message.
Thomas Coffee2f245372017-03-27 10:39:26 -0700[diff] [blame^]180 "encodingType": "A String", # The encoding type used by the API to calculate sentence offsets for the
181 # sentence sentiment.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]182 "document": { # ################################################################ # # Input document. Currently, `analyzeSentiment` only supports English text
183 # (Document.language="EN").
184 #
185 # Represents the input to API methods.
186 "content": "A String", # The content of the input in string format.
187 "type": "A String", # Required. If the type is not set or is `TYPE_UNSPECIFIED`,
188 # returns an `INVALID_ARGUMENT` error.
189 "language": "A String", # The language of the document (if not specified, the language is
190 # automatically detected). Both ISO and BCP-47 language codes are
191 # accepted.<br>
192 # **Current Language Restrictions:**
193 #
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]194 # * Only English, Spanish, and Japanese textual content are supported.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]195 # If the language (either specified by the caller or automatically detected)
196 # is not supported by the called API method, an `INVALID_ARGUMENT` error
197 # is returned.
198 "gcsContentUri": "A String", # The Google Cloud Storage URI where the file content is located.
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]199 # This URI must be of the form: gs://bucket_name/object_name. For more
200 # details, see https://cloud.google.com/storage/docs/reference-uris.
201 # NOTE: Cloud Storage object versioning is not supported.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]202 },
203 }
204
205 x__xgafv: string, V1 error format.
206 Allowed values
207 1 - v1 error format
208 2 - v2 error format
209
210Returns:
211 An object of the form:
212
213 { # The sentiment analysis response message.
214 "documentSentiment": { # Represents the feeling associated with the entire text or entities in # The overall sentiment of the input document.
215 # the text.
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]216 "polarity": 3.14, # DEPRECATED FIELD - This field is being deprecated in
217 # favor of score. Please refer to our documentation at
218 # https://cloud.google.com/natural-language/docs for more information.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]219 "magnitude": 3.14, # A non-negative number in the [0, +inf) range, which represents
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]220 # the absolute magnitude of sentiment regardless of score (positive or
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]221 # negative).
Thomas Coffee2f245372017-03-27 10:39:26 -0700[diff] [blame^]222 "score": 3.14, # Sentiment score between -1.0 (negative sentiment) and 1.0
223 # (positive sentiment).
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]224 },
225 "language": "A String", # The language of the text, which will be the same as the language specified
226 # in the request or, if not specified, the automatically-detected language.
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]227 "sentences": [ # The sentiment for all the sentences in the document.
228 { # Represents a sentence in the input document.
229 "text": { # Represents an output piece of text. # The sentence text.
230 "content": "A String", # The content of the output text.
231 "beginOffset": 42, # The API calculates the beginning offset of the content in the original
232 # document according to the EncodingType specified in the API request.
233 },
234 "sentiment": { # Represents the feeling associated with the entire text or entities in # For calls to AnalyzeSentiment or if
235 # AnnotateTextRequest.Features.extract_document_sentiment is set to
236 # true, this field will contain the sentiment for the sentence.
237 # the text.
238 "polarity": 3.14, # DEPRECATED FIELD - This field is being deprecated in
239 # favor of score. Please refer to our documentation at
240 # https://cloud.google.com/natural-language/docs for more information.
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]241 "magnitude": 3.14, # A non-negative number in the [0, +inf) range, which represents
242 # the absolute magnitude of sentiment regardless of score (positive or
243 # negative).
Thomas Coffee2f245372017-03-27 10:39:26 -0700[diff] [blame^]244 "score": 3.14, # Sentiment score between -1.0 (negative sentiment) and 1.0
245 # (positive sentiment).
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]246 },
247 },
248 ],
249 }</pre>
250</div>
251
252<div class="method">
253 <code class="details" id="analyzeSyntax">analyzeSyntax(body, x__xgafv=None)</code>
254 <pre>Analyzes the syntax of the text and provides sentence boundaries and
255tokenization along with part of speech tags, dependency trees, and other
256properties.
257
258Args:
259 body: object, The request body. (required)
260 The object takes the form of:
261
262{ # The syntax analysis request message.
Thomas Coffee2f245372017-03-27 10:39:26 -0700[diff] [blame^]263 "encodingType": "A String", # The encoding type used by the API to calculate offsets.
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]264 "document": { # ################################################################ # # Input document.
265 #
266 # Represents the input to API methods.
267 "content": "A String", # The content of the input in string format.
268 "type": "A String", # Required. If the type is not set or is `TYPE_UNSPECIFIED`,
269 # returns an `INVALID_ARGUMENT` error.
270 "language": "A String", # The language of the document (if not specified, the language is
271 # automatically detected). Both ISO and BCP-47 language codes are
272 # accepted.<br>
273 # **Current Language Restrictions:**
274 #
275 # * Only English, Spanish, and Japanese textual content are supported.
276 # If the language (either specified by the caller or automatically detected)
277 # is not supported by the called API method, an `INVALID_ARGUMENT` error
278 # is returned.
279 "gcsContentUri": "A String", # The Google Cloud Storage URI where the file content is located.
280 # This URI must be of the form: gs://bucket_name/object_name. For more
281 # details, see https://cloud.google.com/storage/docs/reference-uris.
282 # NOTE: Cloud Storage object versioning is not supported.
283 },
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]284 }
285
286 x__xgafv: string, V1 error format.
287 Allowed values
288 1 - v1 error format
289 2 - v2 error format
290
291Returns:
292 An object of the form:
293
294 { # The syntax analysis response message.
295 "tokens": [ # Tokens, along with their syntactic information, in the input document.
296 { # Represents the smallest syntactic building block of the text.
Thomas Coffee2f245372017-03-27 10:39:26 -0700[diff] [blame^]297 "lemma": "A String", # [Lemma](https://en.wikipedia.org/wiki/Lemma_%28morphology%29) of the token.
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]298 "dependencyEdge": { # Represents dependency parse tree information for a token. # Dependency tree parse for this token.
299 "headTokenIndex": 42, # Represents the head of this token in the dependency tree.
300 # This is the index of the token which has an arc going to this token.
301 # The index is the position of the token in the array of tokens returned
302 # by the API method. If this token is a root token, then the
303 # `head_token_index` is its own index.
304 "label": "A String", # The parse label for the token.
305 },
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame]306 "partOfSpeech": { # Represents part of speech information for a token. # Parts of speech tag for this token.
307 "case": "A String", # The grammatical case.
Thomas Coffee2f245372017-03-27 10:39:26 -0700[diff] [blame^]308 "reciprocity": "A String", # The grammatical reciprocity.
309 "mood": "A String", # The grammatical mood.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame]310 "form": "A String", # The grammatical form.
311 "gender": "A String", # The grammatical gender.
312 "number": "A String", # The grammatical number.
313 "person": "A String", # The grammatical person.
314 "tag": "A String", # The part of speech tag.
315 "tense": "A String", # The grammatical tense.
Thomas Coffee2f245372017-03-27 10:39:26 -0700[diff] [blame^]316 "aspect": "A String", # The grammatical aspect.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame]317 "proper": "A String", # The grammatical properness.
318 "voice": "A String", # The grammatical voice.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame]319 },
Thomas Coffee2f245372017-03-27 10:39:26 -0700[diff] [blame^]320 "text": { # Represents an output piece of text. # The token text.
321 "content": "A String", # The content of the output text.
322 "beginOffset": 42, # The API calculates the beginning offset of the content in the original
323 # document according to the EncodingType specified in the API request.
324 },
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]325 },
326 ],
327 "language": "A String", # The language of the text, which will be the same as the language specified
328 # in the request or, if not specified, the automatically-detected language.
329 # See Document.language field for more details.
330 "sentences": [ # Sentences in the input document.
331 { # Represents a sentence in the input document.
332 "text": { # Represents an output piece of text. # The sentence text.
333 "content": "A String", # The content of the output text.
334 "beginOffset": 42, # The API calculates the beginning offset of the content in the original
335 # document according to the EncodingType specified in the API request.
336 },
337 "sentiment": { # Represents the feeling associated with the entire text or entities in # For calls to AnalyzeSentiment or if
338 # AnnotateTextRequest.Features.extract_document_sentiment is set to
339 # true, this field will contain the sentiment for the sentence.
340 # the text.
341 "polarity": 3.14, # DEPRECATED FIELD - This field is being deprecated in
342 # favor of score. Please refer to our documentation at
343 # https://cloud.google.com/natural-language/docs for more information.
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]344 "magnitude": 3.14, # A non-negative number in the [0, +inf) range, which represents
345 # the absolute magnitude of sentiment regardless of score (positive or
346 # negative).
Thomas Coffee2f245372017-03-27 10:39:26 -0700[diff] [blame^]347 "score": 3.14, # Sentiment score between -1.0 (negative sentiment) and 1.0
348 # (positive sentiment).
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]349 },
350 },
351 ],
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]352 }</pre>
353</div>
354
355<div class="method">
356 <code class="details" id="annotateText">annotateText(body, x__xgafv=None)</code>
Sai Cheemalapatiea3a5e12016-10-12 14:05:53 -0700[diff] [blame]357 <pre>A convenience method that provides all the features that analyzeSentiment,
358analyzeEntities, and analyzeSyntax provide in one call.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]359
360Args:
361 body: object, The request body. (required)
362 The object takes the form of:
363
Sai Cheemalapatiea3a5e12016-10-12 14:05:53 -0700[diff] [blame]364{ # The request message for the text annotation API, which can perform multiple
365 # analysis types (sentiment, entities, and syntax) in one call.
Sai Cheemalapatic30d2b52017-03-13 12:12:03 -0400[diff] [blame]366 "encodingType": "A String", # The encoding type used by the API to calculate offsets.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]367 "document": { # ################################################################ # # Input document.
368 #
369 # Represents the input to API methods.
370 "content": "A String", # The content of the input in string format.
371 "type": "A String", # Required. If the type is not set or is `TYPE_UNSPECIFIED`,
372 # returns an `INVALID_ARGUMENT` error.
373 "language": "A String", # The language of the document (if not specified, the language is
374 # automatically detected). Both ISO and BCP-47 language codes are
375 # accepted.<br>
376 # **Current Language Restrictions:**
377 #
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]378 # * Only English, Spanish, and Japanese textual content are supported.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]379 # If the language (either specified by the caller or automatically detected)
380 # is not supported by the called API method, an `INVALID_ARGUMENT` error
381 # is returned.
382 "gcsContentUri": "A String", # The Google Cloud Storage URI where the file content is located.
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]383 # This URI must be of the form: gs://bucket_name/object_name. For more
384 # details, see https://cloud.google.com/storage/docs/reference-uris.
385 # NOTE: Cloud Storage object versioning is not supported.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]386 },
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]387 "features": { # All available features for sentiment, syntax, and semantic analysis. # The enabled features.
388 # Setting each one to true will enable that specific analysis for the input.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]389 "extractDocumentSentiment": True or False, # Extract document-level sentiment.
Sai Cheemalapatic30d2b52017-03-13 12:12:03 -0400[diff] [blame]390 "extractEntities": True or False, # Extract entities.
391 "extractSyntax": True or False, # Extract syntax information.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]392 },
393 }
394
395 x__xgafv: string, V1 error format.
396 Allowed values
397 1 - v1 error format
398 2 - v2 error format
399
400Returns:
401 An object of the form:
402
403 { # The text annotations response message.
404 "tokens": [ # Tokens, along with their syntactic information, in the input document.
405 # Populated if the user enables
406 # AnnotateTextRequest.Features.extract_syntax.
407 { # Represents the smallest syntactic building block of the text.
Thomas Coffee2f245372017-03-27 10:39:26 -0700[diff] [blame^]408 "lemma": "A String", # [Lemma](https://en.wikipedia.org/wiki/Lemma_%28morphology%29) of the token.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]409 "dependencyEdge": { # Represents dependency parse tree information for a token. # Dependency tree parse for this token.
410 "headTokenIndex": 42, # Represents the head of this token in the dependency tree.
411 # This is the index of the token which has an arc going to this token.
412 # The index is the position of the token in the array of tokens returned
413 # by the API method. If this token is a root token, then the
414 # `head_token_index` is its own index.
415 "label": "A String", # The parse label for the token.
416 },
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame]417 "partOfSpeech": { # Represents part of speech information for a token. # Parts of speech tag for this token.
418 "case": "A String", # The grammatical case.
Thomas Coffee2f245372017-03-27 10:39:26 -0700[diff] [blame^]419 "reciprocity": "A String", # The grammatical reciprocity.
420 "mood": "A String", # The grammatical mood.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame]421 "form": "A String", # The grammatical form.
422 "gender": "A String", # The grammatical gender.
423 "number": "A String", # The grammatical number.
424 "person": "A String", # The grammatical person.
425 "tag": "A String", # The part of speech tag.
426 "tense": "A String", # The grammatical tense.
Thomas Coffee2f245372017-03-27 10:39:26 -0700[diff] [blame^]427 "aspect": "A String", # The grammatical aspect.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame]428 "proper": "A String", # The grammatical properness.
429 "voice": "A String", # The grammatical voice.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame]430 },
Thomas Coffee2f245372017-03-27 10:39:26 -0700[diff] [blame^]431 "text": { # Represents an output piece of text. # The token text.
432 "content": "A String", # The content of the output text.
433 "beginOffset": 42, # The API calculates the beginning offset of the content in the original
434 # document according to the EncodingType specified in the API request.
435 },
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]436 },
437 ],
438 "entities": [ # Entities, along with their semantic information, in the input document.
439 # Populated if the user enables
440 # AnnotateTextRequest.Features.extract_entities.
441 { # Represents a phrase in the text that is a known entity, such as
442 # a person, an organization, or location. The API associates information, such
443 # as salience and mentions, with entities.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]444 "mentions": [ # The mentions of this entity in the input document. The API currently
445 # supports proper noun mentions.
446 { # Represents a mention for an entity in the text. Currently, proper noun
447 # mentions are supported.
448 "text": { # Represents an output piece of text. # The mention text.
449 "content": "A String", # The content of the output text.
450 "beginOffset": 42, # The API calculates the beginning offset of the content in the original
451 # document according to the EncodingType specified in the API request.
452 },
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]453 "type": "A String", # The type of the entity mention.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]454 },
455 ],
456 "salience": 3.14, # The salience score associated with the entity in the [0, 1.0] range.
457 #
458 # The salience score for an entity provides information about the
459 # importance or centrality of that entity to the entire document text.
460 # Scores closer to 0 are less salient, while scores closer to 1.0 are highly
461 # salient.
Sai Cheemalapatic30d2b52017-03-13 12:12:03 -0400[diff] [blame]462 "type": "A String", # The entity type.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]463 "name": "A String", # The representative name for the entity.
464 "metadata": { # Metadata associated with the entity.
465 #
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]466 # Currently, Wikipedia URLs and Knowledge Graph MIDs are provided, if
467 # available. The associated keys are "wikipedia_url" and "mid", respectively.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]468 "a_key": "A String",
469 },
470 },
471 ],
472 "documentSentiment": { # Represents the feeling associated with the entire text or entities in # The overall sentiment for the document. Populated if the user enables
473 # AnnotateTextRequest.Features.extract_document_sentiment.
474 # the text.
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]475 "polarity": 3.14, # DEPRECATED FIELD - This field is being deprecated in
476 # favor of score. Please refer to our documentation at
477 # https://cloud.google.com/natural-language/docs for more information.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]478 "magnitude": 3.14, # A non-negative number in the [0, +inf) range, which represents
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]479 # the absolute magnitude of sentiment regardless of score (positive or
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]480 # negative).
Thomas Coffee2f245372017-03-27 10:39:26 -0700[diff] [blame^]481 "score": 3.14, # Sentiment score between -1.0 (negative sentiment) and 1.0
482 # (positive sentiment).
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]483 },
484 "language": "A String", # The language of the text, which will be the same as the language specified
485 # in the request or, if not specified, the automatically-detected language.
Sai Cheemalapatiea3a5e12016-10-12 14:05:53 -0700[diff] [blame]486 # See Document.language field for more details.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]487 "sentences": [ # Sentences in the input document. Populated if the user enables
488 # AnnotateTextRequest.Features.extract_syntax.
489 { # Represents a sentence in the input document.
490 "text": { # Represents an output piece of text. # The sentence text.
491 "content": "A String", # The content of the output text.
492 "beginOffset": 42, # The API calculates the beginning offset of the content in the original
493 # document according to the EncodingType specified in the API request.
494 },
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]495 "sentiment": { # Represents the feeling associated with the entire text or entities in # For calls to AnalyzeSentiment or if
496 # AnnotateTextRequest.Features.extract_document_sentiment is set to
497 # true, this field will contain the sentiment for the sentence.
498 # the text.
499 "polarity": 3.14, # DEPRECATED FIELD - This field is being deprecated in
500 # favor of score. Please refer to our documentation at
501 # https://cloud.google.com/natural-language/docs for more information.
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]502 "magnitude": 3.14, # A non-negative number in the [0, +inf) range, which represents
503 # the absolute magnitude of sentiment regardless of score (positive or
504 # negative).
Thomas Coffee2f245372017-03-27 10:39:26 -0700[diff] [blame^]505 "score": 3.14, # Sentiment score between -1.0 (negative sentiment) and 1.0
506 # (positive sentiment).
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]507 },
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]508 },
509 ],
510 }</pre>
511</div>
512
513</body></html>