Api-Roll 52: 2017-07-31

generated/googleapis/lib/speech/v1.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis.speech.v1;
 
 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 563 matching lines @@
     return _json;
   }
 }
 
 /**
  * Provides information to the recognizer that specifies how to process the
  * request.
  */
 class RecognitionConfig {
   /**
+   * *Optional* If `true`, a list of `words` are returned in the top result,
+   * containing the start and end timestamps for those words. The default value,
+   * 'false' does not return any word-level timing information.
+   */
+  core.bool enableWordTimeOffsets;
+  /**
    * *Required* Encoding of audio data sent in all `RecognitionAudio` messages.
    * Possible string values are:
    * - "ENCODING_UNSPECIFIED" : Not specified. Will return result
    * google.rpc.Code.INVALID_ARGUMENT.
    * - "LINEAR16" : Uncompressed 16-bit signed little-endian samples (Linear
    * PCM).
    * - "FLAC" : [`FLAC`](https://xiph.org/flac/documentation.html) (Free
    * Lossless Audio
    * Codec) is the recommended encoding because it is
    * lossless--therefore recognition is not compromised--and
@@ skipping 58 matching lines @@
    */
   core.int sampleRateHertz;
   /**
    * *Optional* A means to provide context to assist the speech recognition.
    */
   core.List<SpeechContext> speechContexts;
 
   RecognitionConfig();
 
   RecognitionConfig.fromJson(core.Map _json) {
+    if (_json.containsKey("enableWordTimeOffsets")) {
+      enableWordTimeOffsets = _json["enableWordTimeOffsets"];
+    }
     if (_json.containsKey("encoding")) {
       encoding = _json["encoding"];
     }
     if (_json.containsKey("languageCode")) {
       languageCode = _json["languageCode"];
     }
     if (_json.containsKey("maxAlternatives")) {
       maxAlternatives = _json["maxAlternatives"];
     }
     if (_json.containsKey("profanityFilter")) {
       profanityFilter = _json["profanityFilter"];
     }
     if (_json.containsKey("sampleRateHertz")) {
       sampleRateHertz = _json["sampleRateHertz"];
     }
     if (_json.containsKey("speechContexts")) {
       speechContexts = _json["speechContexts"].map((value) => new SpeechContext.fromJson(value)).toList();
     }
   }
 
   core.Map<core.String, core.Object> toJson() {
     final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    if (enableWordTimeOffsets != null) {
+      _json["enableWordTimeOffsets"] = enableWordTimeOffsets;
+    }
     if (encoding != null) {
       _json["encoding"] = encoding;
     }
     if (languageCode != null) {
       _json["languageCode"] = languageCode;
     }
     if (maxAlternatives != null) {
       _json["maxAlternatives"] = maxAlternatives;
     }
     if (profanityFilter != null) {
@@ skipping 111 matching lines @@
    * correct. This field is typically provided only for the top hypothesis, and
    * only for `is_final=true` results. Clients should not rely on the
    * `confidence` field as it is not guaranteed to be accurate or consistent.
    * The default of 0.0 is a sentinel value indicating `confidence` was not set.
    */
   core.double confidence;
   /**
    * *Output-only* Transcript text representing the words that the user spoke.
    */
   core.String transcript;
+  /**
+   * *Output-only* List of word-specific information for each recognized word.
+   */
+  core.List<WordInfo> words;
 
   SpeechRecognitionAlternative();
 
   SpeechRecognitionAlternative.fromJson(core.Map _json) {
     if (_json.containsKey("confidence")) {
       confidence = _json["confidence"];
     }
     if (_json.containsKey("transcript")) {
       transcript = _json["transcript"];
     }
+    if (_json.containsKey("words")) {
+      words = _json["words"].map((value) => new WordInfo.fromJson(value)).toList();
+    }
   }
 
   core.Map<core.String, core.Object> toJson() {
     final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
     if (confidence != null) {
       _json["confidence"] = confidence;
     }
     if (transcript != null) {
       _json["transcript"] = transcript;
     }
+    if (words != null) {
+      _json["words"] = words.map((value) => (value).toJson()).toList();
+    }
     return _json;
   }
 }
 
 /** A speech recognition result corresponding to a portion of the audio. */
 class SpeechRecognitionResult {
   /**
    * *Output-only* May contain one or more recognition hypotheses (up to the
    * maximum specified in `max_alternatives`).
    * These alternatives are ordered in terms of accuracy, with the first/top
@@ skipping 71 matching lines @@
  *     results in its response, the status of those operations should be
  *     represented directly using the `Status` message.
  *
  * - Logging. If some API errors are stored in logs, the message `Status` could
  * be used directly after any stripping needed for security/privacy reasons.
  */
 class Status {
   /** The status code, which should be an enum value of google.rpc.Code. */
   core.int code;
   /**
-   * A list of messages that carry the error details.  There will be a
-   * common set of message types for APIs to use.
+   * A list of messages that carry the error details.  There is a common set of
+   * message types for APIs to use.
    *
    * The values for Object must be JSON objects. It can consist of `num`,
    * `String`, `bool` and `null` as well as `Map` and `List` values.
    */
   core.List<core.Map<core.String, core.Object>> details;
   /**
    * A developer-facing error message, which should be in English. Any
    * user-facing error message should be localized and sent in the
    * google.rpc.Status.details field, or localized by the client.
    */
@@ skipping 20 matching lines @@
     }
     if (details != null) {
       _json["details"] = details;
     }
     if (message != null) {
       _json["message"] = message;
     }
     return _json;
   }
 }
+
+/**
+ * Word-specific information detected along with speech recognition when certain
+ * request parameters are set.
+ */
+class WordInfo {
+  /**
+   * *Output-only* Time offset relative to the beginning of the audio,
+   * and corresponding to the end of the spoken word.
+   * This field is only set if `enable_word_time_offsets=true` and only
+   * in the top hypothesis.
+   * This is an experimental feature and the accuracy of the time offset can
+   * vary.
+   */
+  core.String endTime;
+  /**
+   * *Output-only* Time offset relative to the beginning of the audio,
+   * and corresponding to the start of the spoken word.
+   * This field is only set if `enable_word_time_offsets=true` and only
+   * in the top hypothesis.
+   * This is an experimental feature and the accuracy of the time offset can
+   * vary.
+   */
+  core.String startTime;
+  /** *Output-only* The word corresponding to this set of information. */
+  core.String word;
+
+  WordInfo();
+
+  WordInfo.fromJson(core.Map _json) {
+    if (_json.containsKey("endTime")) {
+      endTime = _json["endTime"];
+    }
+    if (_json.containsKey("startTime")) {
+      startTime = _json["startTime"];
+    }
+    if (_json.containsKey("word")) {
+      word = _json["word"];
+    }
+  }
+
+  core.Map<core.String, core.Object> toJson() {
+    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    if (endTime != null) {
+      _json["endTime"] = endTime;
+    }
+    if (startTime != null) {
+      _json["startTime"] = startTime;
+    }
+    if (word != null) {
+      _json["word"] = word;
+    }
+    return _json;
+  }
+}