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

包含给定视频格式的所有 URI。

JSON 表示法
{
  "landscapeUri": string,
  "portraitUri": string
}
字段
landscapeUri

string

横屏媒体的已签名短期 URI。

portraitUri

string

纵向媒体的已签名短期有效 URI。