Api-roll 47: 2017-03-27

discovery/googleapis_beta/speech__v1beta1.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://speech.googleapis.com/",
     "batchPath": "batch",
     "description": "Google Cloud Speech API.",
     "discoveryVersion": "v1",
     "documentationLink": "https://cloud.google.com/speech/",
     "icons": {
         "x16": "http://www.google.com/images/icons/product/search-16.gif",
         "x32": "http://www.google.com/images/icons/product/search-32.gif"
     },
     "id": "speech:v1beta1",
     "kind": "discovery#restDescription",
     "name": "speech",
     "ownerDomain": "google.com",
     "ownerName": "Google",
     "parameters": {
+        "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\").",
             "location": "query",
             "type": "string"
         },
         "prettyPrint": {
             "default": "true",
             "description": "Returns response with indentations and line breaks.",
             "location": "query",
             "type": "boolean"
         },
+        "fields": {
+            "description": "Selector specifying which fields to include in a partial response.",
+            "location": "query",
+            "type": "string"
+        },
         "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",
                 "Media download with context-dependent Content-Type",
                 "Responses with Content-Type of application/x-protobuf"
             ],
             "location": "query",
             "type": "string"
         },
+        "access_token": {
+            "description": "OAuth access token.",
+            "location": "query",
+            "type": "string"
+        },
         "key": {
             "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
             "location": "query",
             "type": "string"
         },
-        "access_token": {
-            "description": "OAuth access token.",
-            "location": "query",
-            "type": "string"
-        },
         "quotaUser": {
             "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"
-        },
-        "bearer_token": {
-            "description": "OAuth bearer token.",
-            "location": "query",
-            "type": "string"
-        },
-        "oauth_token": {
-            "description": "OAuth 2.0 token for the current user.",
-            "location": "query",
-            "type": "string"
         }
     },
     "protocol": "rest",
     "resources": {
         "operations": {
             "methods": {
                 "cancel": {
                     "description": "Starts asynchronous cancellation on a long-running operation.  The server\nmakes a best effort to cancel the operation, but success is not\nguaranteed.  If the server doesn't support this method, it returns\n`google.rpc.Code.UNIMPLEMENTED`.  Clients can use\nOperations.GetOperation or\nother methods to check whether the cancellation succeeded or whether the\noperation completed despite cancellation. On successful cancellation,\nthe operation is not deleted; instead, it becomes an operation with\nan Operation.error value with a google.rpc.Status.code of 1,\ncorresponding to `Code.CANCELLED`.",
                     "httpMethod": "POST",
                     "id": "speech.operations.cancel",
@@ skipping 40 matching lines @@
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform"
                     ]
                 },
                 "list": {
                     "description": "Lists operations that match the specified filter in the request. If the\nserver doesn't support this method, it returns `UNIMPLEMENTED`.\n\nNOTE: the `name` binding below allows API services to override the binding\nto use different resource name schemes, such as `users/*/operations`.",
                     "httpMethod": "GET",
                     "id": "speech.operations.list",
                     "parameterOrder": [],
                     "parameters": {
-                        "filter": {
-                            "description": "The standard list filter.",
-                            "location": "query",
-                            "type": "string"
-                        },
                         "name": {
                             "description": "The name of the operation collection.",
                             "location": "query",
                             "type": "string"
                         },
                         "pageToken": {
                             "description": "The standard list page token.",
                             "location": "query",
                             "type": "string"
                         },
                         "pageSize": {
                             "description": "The standard list page size.",
                             "format": "int32",
                             "location": "query",
                             "type": "integer"
+                        },
+                        "filter": {
+                            "description": "The standard list filter.",
+                            "location": "query",
+                            "type": "string"
                         }
                     },
                     "path": "v1beta1/operations",
                     "response": {
                         "$ref": "ListOperationsResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform"
                     ]
                 },
@@ skipping 55 matching lines @@
                     "response": {
                         "$ref": "SyncRecognizeResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform"
                     ]
                 }
             }
         }
     },
-    "revision": "20170303",
+    "revision": "20170323",
     "rootUrl": "https://speech.googleapis.com/",
     "schemas": {
+        "RecognitionAudio": {
+            "description": "Contains audio data in the encoding specified in the `RecognitionConfig`.\nEither `content` or `uri` must be supplied. Supplying both or neither\nreturns google.rpc.Code.INVALID_ARGUMENT. See\n[audio limits](https://cloud.google.com/speech/limits#content).",
+            "id": "RecognitionAudio",
+            "properties": {
+                "content": {
+                    "description": "The audio data bytes encoded as specified in\n`RecognitionConfig`. Note: as with all bytes fields, protobuffers use a\npure binary representation, whereas JSON representations use base64.",
+                    "format": "byte",
+                    "type": "string"
+                },
+                "uri": {
+                    "description": "URI that points to a file that contains audio data bytes as specified in\n`RecognitionConfig`. Currently, only Google Cloud Storage URIs are\nsupported, which must be specified in the following format:\n`gs://bucket_name/object_name` (other URI formats return\ngoogle.rpc.Code.INVALID_ARGUMENT). For more information, see\n[Request URIs](https://cloud.google.com/storage/docs/reference-uris).",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
+        "AsyncRecognizeRequest": {
+            "description": "The top-level message sent by the client for the `AsyncRecognize` method.",
+            "id": "AsyncRecognizeRequest",
+            "properties": {
+                "config": {
+                    "$ref": "RecognitionConfig",
+                    "description": "*Required* Provides information to the recognizer that specifies how to\nprocess the request."
+                },
+                "audio": {
+                    "$ref": "RecognitionAudio",
+                    "description": "*Required* The audio data to be recognized."
+                }
+            },
+            "type": "object"
+        },
         "Operation": {
             "description": "This resource represents a long-running operation that is the result of a\nnetwork API call.",
             "id": "Operation",
             "properties": {
                 "done": {
                     "description": "If the value is `false`, it means the operation is still in progress.\nIf true, the operation is completed, and either `error` or `response` is\navailable.",
                     "type": "boolean"
                 },
                 "response": {
                     "additionalProperties": {
@@ skipping 19 matching lines @@
                     "description": "Service-specific metadata associated with the operation.  It typically\ncontains progress information and common metadata such as create time.\nSome services might not provide such metadata.  Any method that returns a\nlong-running operation should document the metadata type, if any.",
                     "type": "object"
                 }
             },
             "type": "object"
         },
         "RecognitionConfig": {
             "description": "Provides information to the recognizer that specifies how to process the\nrequest.",
             "id": "RecognitionConfig",
             "properties": {
-                "maxAlternatives": {
-                    "description": "*Optional* Maximum number of recognition hypotheses to be returned.\nSpecifically, the maximum number of `SpeechRecognitionAlternative` messages\nwithin each `SpeechRecognitionResult`.\nThe server may return fewer than `max_alternatives`.\nValid values are `0`-`30`. A value of `0` or `1` will return a maximum of\none. If omitted, will return a maximum of one.",
-                    "format": "int32",
-                    "type": "integer"
-                },
-                "sampleRate": {
-                    "description": "*Required* Sample rate in Hertz of the audio data sent in all\n`RecognitionAudio` messages. Valid values are: 8000-48000.\n16000 is optimal. For best results, set the sampling rate of the audio\nsource to 16000 Hz. If that's not possible, use the native sample rate of\nthe audio source (instead of re-sampling).",
-                    "format": "int32",
-                    "type": "integer"
-                },
-                "languageCode": {
-                    "description": "*Optional* The language of the supplied audio as a BCP-47 language tag.\nExample: \"en-GB\"  https://www.rfc-editor.org/rfc/bcp/bcp47.txt\nIf omitted, defaults to \"en-US\". See\n[Language Support](https://cloud.google.com/speech/docs/languages)\nfor a list of the currently supported language codes.",
-                    "type": "string"
-                },
                 "speechContext": {
                     "$ref": "SpeechContext",
                     "description": "*Optional* A means to provide context to assist the speech recognition."
                 },
                 "encoding": {
                     "description": "*Required* Encoding of audio data sent in all `RecognitionAudio` messages.",
                     "enum": [
                         "ENCODING_UNSPECIFIED",
                         "LINEAR16",
                         "FLAC",
                         "MULAW",
                         "AMR",
                         "AMR_WB"
                     ],
                     "enumDescriptions": [
                         "Not specified. Will return result google.rpc.Code.INVALID_ARGUMENT.",
                         "Uncompressed 16-bit signed little-endian samples (Linear PCM).\nThis is the only encoding that may be used by `AsyncRecognize`.",
                         "This is the recommended encoding for `SyncRecognize` and\n`StreamingRecognize` because it uses lossless compression; therefore\nrecognition accuracy is not compromised by a lossy codec.\n\nThe stream FLAC (Free Lossless Audio Codec) encoding is specified at:\nhttp://flac.sourceforge.net/documentation.html.\n16-bit and 24-bit samples are supported.\nNot all fields in STREAMINFO are supported.",
                         "8-bit samples that compand 14-bit audio samples using G.711 PCMU/mu-law.",
                         "Adaptive Multi-Rate Narrowband codec. `sample_rate` must be 8000 Hz.",
                         "Adaptive Multi-Rate Wideband codec. `sample_rate` must be 16000 Hz."
                     ],
                     "type": "string"
                 },
                 "profanityFilter": {
                     "description": "*Optional* If set to `true`, the server will attempt to filter out\nprofanities, replacing all but the initial character in each filtered word\nwith asterisks, e.g. \"f***\". If set to `false` or omitted, profanities\nwon't be filtered out.",
                     "type": "boolean"
+                },
+                "maxAlternatives": {
+                    "description": "*Optional* Maximum number of recognition hypotheses to be returned.\nSpecifically, the maximum number of `SpeechRecognitionAlternative` messages\nwithin each `SpeechRecognitionResult`.\nThe server may return fewer than `max_alternatives`.\nValid values are `0`-`30`. A value of `0` or `1` will return a maximum of\none. If omitted, will return a maximum of one.",
+                    "format": "int32",
+                    "type": "integer"
+                },
+                "sampleRate": {
+                    "description": "*Required* Sample rate in Hertz of the audio data sent in all\n`RecognitionAudio` messages. Valid values are: 8000-48000.\n16000 is optimal. For best results, set the sampling rate of the audio\nsource to 16000 Hz. If that's not possible, use the native sample rate of\nthe audio source (instead of re-sampling).",
+                    "format": "int32",
+                    "type": "integer"
+                },
+                "languageCode": {
+                    "description": "*Optional* The language of the supplied audio as a BCP-47 language tag.\nExample: \"en-GB\"  https://www.rfc-editor.org/rfc/bcp/bcp47.txt\nIf omitted, defaults to \"en-US\". See\n[Language Support](https://cloud.google.com/speech/docs/languages)\nfor a list of the currently supported language codes.",
+                    "type": "string"
                 }
             },
             "type": "object"
         },
         "SyncRecognizeRequest": {
             "description": "The top-level message sent by the client for the `SyncRecognize` method.",
             "id": "SyncRecognizeRequest",
             "properties": {
                 "config": {
                     "$ref": "RecognitionConfig",
@@ skipping 80 matching lines @@
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
         "ListOperationsResponse": {
             "description": "The response message for Operations.ListOperations.",
             "id": "ListOperationsResponse",
             "properties": {
-                "nextPageToken": {
-                    "description": "The standard List next-page token.",
-                    "type": "string"
-                },
                 "operations": {
                     "description": "A list of operations that matches the specified filter in the request.",
                     "items": {
                         "$ref": "Operation"
                     },
                     "type": "array"
+                },
+                "nextPageToken": {
+                    "description": "The standard List next-page token.",
+                    "type": "string"
                 }
             },
             "type": "object"
         },
         "SpeechRecognitionResult": {
             "description": "A speech recognition result corresponding to a portion of the audio.",
             "id": "SpeechRecognitionResult",
             "properties": {
                 "alternatives": {
                     "description": "*Output-only* May contain one or more recognition hypotheses (up to the\nmaximum specified in `max_alternatives`).",
                     "items": {
                         "$ref": "SpeechRecognitionAlternative"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
-        },
-        "AsyncRecognizeRequest": {
-            "description": "The top-level message sent by the client for the `AsyncRecognize` method.",
-            "id": "AsyncRecognizeRequest",
-            "properties": {
-                "config": {
-                    "$ref": "RecognitionConfig",
-                    "description": "*Required* Provides information to the recognizer that specifies how to\nprocess the request."
-                },
-                "audio": {
-                    "$ref": "RecognitionAudio",
-                    "description": "*Required* The audio data to be recognized."
-                }
-            },
-            "type": "object"
-        },
-        "RecognitionAudio": {
-            "description": "Contains audio data in the encoding specified in the `RecognitionConfig`.\nEither `content` or `uri` must be supplied. Supplying both or neither\nreturns google.rpc.Code.INVALID_ARGUMENT. See\n[audio limits](https://cloud.google.com/speech/limits#content).",
-            "id": "RecognitionAudio",
-            "properties": {
-                "content": {
-                    "description": "The audio data bytes encoded as specified in\n`RecognitionConfig`. Note: as with all bytes fields, protobuffers use a\npure binary representation, whereas JSON representations use base64.",
-                    "format": "byte",
-                    "type": "string"
-                },
-                "uri": {
-                    "description": "URI that points to a file that contains audio data bytes as specified in\n`RecognitionConfig`. Currently, only Google Cloud Storage URIs are\nsupported, which must be specified in the following format:\n`gs://bucket_name/object_name` (other URI formats return\ngoogle.rpc.Code.INVALID_ARGUMENT). For more information, see\n[Request URIs](https://cloud.google.com/storage/docs/reference-uris).",
-                    "type": "string"
-                }
-            },
-            "type": "object"
         }
     },
     "servicePath": "",
     "title": "Google Cloud Speech API",
     "version": "v1beta1"
 }