Method: videos.lookupVideo
根据视频或 videoId 提取视频。响应将是包含一组播放 URI 的视频(对于 ACTIVE 视频)或 PROCESSING 状态(对于待处理视频)或 404 错误(如果视频不存在)。接收视频是可计费事件,因此此方法的调用方应准备好在请求时使用返回的 URI。
HTTP 请求
GET https://aerialview.googleapis.com/v1/videos:lookupVideo
网址采用 gRPC 转码语法。
查询参数
参数 |
联合参数 key 。必需。用于查找视频的键。key 只能是下列其中一项: |
videoId |
string
从 videos.renderVideo 返回的 ID。
|
address |
string
美国邮政地址。
|
响应正文
用于封装视频所有相关数据的对象。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
{
"uris": {
string: {
object (Uris )
},
...
},
"state": enum (State ),
"metadata": {
object (VideoMetadata )
}
} |
字段 |
uris |
map (key: string, value: object (Uris ))
媒体类型到其 URI 的映射。只有 ACTIVE 个视频才会包含此字段。键是来自 MediaFormat 的枚举值。 包含一系列 "key": value 对的对象。示例:{ "name": "wrench", "mass": "1.3kg", "count": "3" } 。
|
state |
enum (State )
呈现请求的当前状态。
|
metadata |
object (VideoMetadata )
包含视频的元数据,仅在状态为 ACTIVE 时才设置。
|
URI
JSON 表示法 |
{
"landscapeUri": string,
"portraitUri": string
} |
字段 |
landscapeUri |
string
横屏媒体的已签名短期 URI。
|
portraitUri |
string
纵向媒体的已签名短期有效 URI。
|
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-08-22。
[null,null,["最后更新时间 (UTC):2024-08-22。"],[[["Fetches a video using its address or videoId, returning playback URIs for active videos or a processing state for pending ones."],["The response includes a set of URIs for different media types if the video is active, along with its current state and metadata."],["A 404 error is returned if the video does not exist, and receiving a video is a billable event."],["The request utilizes a `GET` method with the endpoint `https://aerialview.googleapis.com/v1/videos:lookupVideo` and requires either a `videoId` or `address` as a query parameter."],["The response body provides the video's URIs (if active), state, and metadata."]]],["The core action is fetching a video using a `GET` request to `https://aerialview.googleapis.com/v1/videos:lookupVideo`. The request requires a `key` parameter, either a `videoId` or an `address`. The request body must be empty. A successful response returns a video object with `uris`, `state`, and `metadata`. `uris` map media types to URIs, `state` indicates the video's status, and `metadata` contains video details. The video can also be in `PROCESSING` or result in a 404 error.\n"]]