Method: videos.lookupVideo

根据地址或 videoId 获取视频。响应要么是一个视频，其中包含一组有效视频的播放 URI；对于待定视频，响应将是 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。