Api-roll 42: 2016-11-08

generated/googleapis_beta/lib/language/v1beta1.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis_beta.language.v1beta1;
 
 import 'dart:core' as core;
 import 'dart:async' as async;
 import 'dart:convert' as convert;
 
 import 'package:_discoveryapis_commons/_discoveryapis_commons.dart' as commons;
 import 'package:http/http.dart' as http;
@@ skipping 101 matching lines @@
                                        "POST",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new AnalyzeSentimentResponse.fromJson(data));
   }
 
   /**
-   * Advanced API that analyzes the document and provides a full set of text
-   * annotations, including semantic, syntactic, and sentiment information. This
-   * API is intended for users who are familiar with machine learning and need
-   * in-depth text features to build upon.
+   * A convenience method that provides all the features that analyzeSentiment,
+   * analyzeEntities, and analyzeSyntax provide in one call.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * Completes with a [AnnotateTextResponse].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
@@ skipping 76 matching lines @@
   }
 }
 
 /** The entity analysis response message. */
 class AnalyzeEntitiesResponse {
   /** The recognized entities in the input document. */
   core.List<Entity> entities;
   /**
    * The language of the text, which will be the same as the language specified
    * in the request or, if not specified, the automatically-detected language.
+   * See Document.language field for more details.
    */
   core.String language;
 
   AnalyzeEntitiesResponse();
 
   AnalyzeEntitiesResponse.fromJson(core.Map _json) {
     if (_json.containsKey("entities")) {
       entities = _json["entities"].map((value) => new Entity.fromJson(value)).toList();
     }
     if (_json.containsKey("language")) {
@@ skipping 65 matching lines @@
       _json["documentSentiment"] = (documentSentiment).toJson();
     }
     if (language != null) {
       _json["language"] = language;
     }
     return _json;
   }
 }
 
 /**
- * The request message for the advanced text annotation API, which performs all
- * the above plus syntactic analysis.
+ * The request message for the text annotation API, which can perform multiple
+ * analysis types (sentiment, entities, and syntax) in one call.
  */
 class AnnotateTextRequest {
   /** Input document. */
   Document document;
   /**
    * The encoding type used by the API to calculate offsets.
    * Possible string values are:
    * - "NONE" : If `EncodingType` is not specified, encoding-dependent
    * information (such as
    * `begin_offset`) will be set at `-1`.
@@ skipping 52 matching lines @@
   Sentiment documentSentiment;
   /**
    * Entities, along with their semantic information, in the input document.
    * Populated if the user enables
    * AnnotateTextRequest.Features.extract_entities.
    */
   core.List<Entity> entities;
   /**
    * The language of the text, which will be the same as the language specified
    * in the request or, if not specified, the automatically-detected language.
+   * See Document.language field for more details.
    */
   core.String language;
   /**
    * Sentences in the input document. Populated if the user enables
    * AnnotateTextRequest.Features.extract_syntax.
    */
   core.List<Sentence> sentences;
   /**
    * Tokens, along with their syntactic information, in the input document.
    * Populated if the user enables
@@ skipping 444 matching lines @@
  * the text.
  */
 class Sentiment {
   /**
    * A non-negative number in the [0, +inf) range, which represents
    * the absolute magnitude of sentiment regardless of polarity (positive or
    * negative).
    */
   core.double magnitude;
   /**
-   * Polarity of the sentiment in the [-1.0, 1.0] range. Larger numbers
-   * represent more positive sentiments.
+   * DEPRECATED FIELD - This field is being deprecated in
+   * favor of score. Please refer to our documentation at
+   * https://cloud.google.com/natural-language/docs for more information.
    */
   core.double polarity;
 
   Sentiment();
 
   Sentiment.fromJson(core.Map _json) {
     if (_json.containsKey("magnitude")) {
       magnitude = _json["magnitude"];
     }
     if (_json.containsKey("polarity")) {
@@ skipping 190 matching lines @@
     }
     if (partOfSpeech != null) {
       _json["partOfSpeech"] = (partOfSpeech).toJson();
     }
     if (text != null) {
       _json["text"] = (text).toJson();
     }
     return _json;
   }
 }