REST 资源：projects.locations.datasets.dictationStores.dictations

资源：语音输入

音频语音输入。

JSON 表示法 

{
  "name": string,
  "audio": {
    object (RecognitionAudio)
  },
  "createTime": string,
  "trainingConsent": enum (TrainingConsent)
}
字段
name

string

口录的资源名称，格式为 projects/{project_id}/locations/{locationId}/datasets/{datasetId}/dictationStores/{dictationStoreId}/dictations/{dictation_id}。由服务器分配。
audio

object (RecognitionAudio)

当在 Dations.get 响应中返回时，其中包含采用二进制文件表示法的音频内容。音频字段不在 dictations.create 和 dictations.patch 响应的涵盖范围内。
createTime

string (Timestamp format)

仅供输出。语音输入创建的时间。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒。示例："2014-10-02T15:01:23.045123456Z"。

RecognitionAudio

包含按 RecognitionConfig 中指定的方式编码的音频数据。必须提供 content 或 uri。同时提供两者或两者都不提供会返回 google.rpc.Code.INVALID_ARGUMENT。请参阅音频限制。

JSON 表示法 

{

  // Union field audio_source can be only one of the following:
  "content": string,
  "uri": string
  // End of list of possible types for union field audio_source.
}
字段
联合字段 audio_source。音频源，可以是内嵌内容，也可以是 Cloud Storage URI。audio_source 只能是下列其中一项：
content

string (bytes format)

按 RecognitionConfig 中所指定的方式编码的音频数据字节。注意：与所有字节字段一样，协议缓冲区使用纯二进制表示法，而 JSON 表示法使用 base64。

使用 base64 编码的字符串。
uri

string

指向一个文件的 URI，该文件包含 RecognitionConfig 中指定的音频数据字节。仅支持 Google Cloud Storage URI，且必须使用以下格式指定：gs://bucket_name/object_name。其他 URI 格式返回 google.rpc.Code.INVALID_ARGUMENT。如需了解详情，请参阅请求 URI。

方法

create

 创建新的 Dictation 记录。

delete

 删除 Dictation 或若存在则返回 NOT_FOUND。

get

 获取 Dictation。

list

 列出给定的 Dictation store 中的 Dictations。

patch

 更新 Dictation。

recognize

 执行异步语音识别：通过 google.longrunning.Operations 接口接收结果。