Api-roll 42: 2016-11-08

generated/googleapis_beta/lib/speech/v1beta1.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis_beta.speech.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 25 matching lines @@
   OperationsResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
    * Starts asynchronous cancellation on a long-running operation.  The server
    * makes a best effort to cancel the operation, but success is not
    * guaranteed.  If the server doesn't support this method, it returns
    * `google.rpc.Code.UNIMPLEMENTED`.  Clients can use
    * Operations.GetOperation or
    * other methods to check whether the cancellation succeeded or whether the
-   * operation completed despite cancellation.
+   * operation completed despite cancellation. On successful cancellation,
+   * the operation is not deleted; instead, it becomes an operation with
+   * an Operation.error value with a google.rpc.Status.code of 1,
+   * corresponding to `Code.CANCELLED`.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [name] - The name of the operation resource to be cancelled.
-   * Value must have pattern "^[^/]*$".
+   * Value must have pattern "^[^/]+$".
    *
    * Completes with a [Empty].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
   async.Future<Empty> cancel(CancelOperationRequest request, core.String name) {
@@ skipping 25 matching lines @@
 
   /**
    * Deletes a long-running operation. This method indicates that the client is
    * no longer interested in the operation result. It does not cancel the
    * operation. If the server doesn't support this method, it returns
    * `google.rpc.Code.UNIMPLEMENTED`.
    *
    * Request parameters:
    *
    * [name] - The name of the operation resource to be deleted.
-   * Value must have pattern "^[^/]*$".
+   * Value must have pattern "^[^/]+$".
    *
    * Completes with a [Empty].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
   async.Future<Empty> delete(core.String name) {
@@ skipping 21 matching lines @@
   }
 
   /**
    * Gets the latest state of a long-running operation.  Clients can use this
    * method to poll the operation result at intervals as recommended by the API
    * service.
    *
    * Request parameters:
    *
    * [name] - The name of the operation resource.
-   * Value must have pattern "^[^/]*$".
+   * Value must have pattern "^[^/]+$".
    *
    * Completes with a [Operation].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
   async.Future<Operation> get(core.String name) {
@@ skipping 81 matching lines @@
 }
 
 
 class SpeechResourceApi {
   final commons.ApiRequester _requester;
 
   SpeechResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
-   * Perform asynchronous speech-recognition: receive results via the
+   * Performs asynchronous speech recognition: receive results via the
    * google.longrunning.Operations interface. Returns either an
    * `Operation.error` or an `Operation.response` which contains
    * an `AsyncRecognizeResponse` message.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * Completes with a [Operation].
    *
@@ skipping 21 matching lines @@
                                        "POST",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Perform synchronous speech-recognition: receive results after all audio
+   * Performs synchronous speech recognition: receive results after all audio
    * has been sent and processed.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * Completes with a [SyncRecognizeResponse].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 137 matching lines @@
  * This resource represents a long-running operation that is the result of a
  * network API call.
  */
 class Operation {
   /**
    * If the value is `false`, it means the operation is still in progress.
    * If true, the operation is completed, and either `error` or `response` is
    * available.
    */
   core.bool done;
-  /** The error result of the operation in case of failure. */
+  /** The error result of the operation in case of failure or cancellation. */
   Status error;
   /**
    * Service-specific metadata associated with the operation.  It typically
    * contains progress information and common metadata such as create time.
    * Some services might not provide such metadata.  Any method that returns a
    * long-running operation should document the metadata type, if any.
    *
    * The values for Object must be JSON objects. It can consist of `num`,
    * `String`, `bool` and `null` as well as `Map` and `List` values.
    */
@@ skipping 116 matching lines @@
 /**
  * The `RecognitionConfig` message provides information to the recognizer
  * that specifies how to process the request.
  */
 class RecognitionConfig {
   /**
    * [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.
+   * - "LINEAR16" : Uncompressed 16-bit signed little-endian samples (Linear
+   * PCM).
    * This is the only encoding that may be used by `AsyncRecognize`.
    * - "FLAC" : This is the recommended encoding for `SyncRecognize` and
    * `StreamingRecognize` because it uses lossless compression; therefore
    * recognition accuracy is not compromised by a lossy codec.
    *
    * The stream FLAC (Free Lossless Audio Codec) encoding is specified at:
    * http://flac.sourceforge.net/documentation.html.
-   * Only 16-bit samples are supported.
+   * 16-bit and 24-bit samples are supported.
    * Not all fields in STREAMINFO are supported.
    * - "MULAW" : 8-bit samples that compand 14-bit audio samples using G.711
    * PCMU/mu-law.
    * - "AMR" : Adaptive Multi-Rate Narrowband codec. `sample_rate` must be 8000
    * Hz.
    * - "AMR_WB" : Adaptive Multi-Rate Wideband codec. `sample_rate` must be
    * 16000 Hz.
    */
   core.String encoding;
   /**
    * [Optional] The language of the supplied audio as a BCP-47 language tag.
    * Example: "en-GB"  https://www.rfc-editor.org/rfc/bcp/bcp47.txt
    * If omitted, defaults to "en-US". See
-   * [Language
-   * Support](https://cloud.google.com/speech/docs/best-practices#language_support)
+   * [Language Support](https://cloud.google.com/speech/docs/languages)
    * for a list of the currently supported language codes.
    */
   core.String languageCode;
   /**
    * [Optional] Maximum number of recognition hypotheses to be returned.
    * Specifically, the maximum number of `SpeechRecognitionAlternative` messages
    * within each `SpeechRecognitionResult`.
    * The server may return fewer than `max_alternatives`.
    * Valid values are `0`-`30`. A value of `0` or `1` will return a maximum of
    * `1`. If omitted, defaults to `1`.
@@ skipping 321 matching lines @@
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     if (results != null) {
       _json["results"] = results.map((value) => (value).toJson()).toList();
     }
     return _json;
   }
 }