Method: videos.lookupVideo

根據影片的地址或 videoId 擷取影片。回應會是含有一組播放中 URI 的影片，對於待處理影片具有「處理中」狀態，若影片不存在，則會傳回 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。