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

包含特定影片格式的所有 URI。

JSON 表示法
{
  "landscapeUri": string,
  "portraitUri": string
}
欄位
landscapeUri

string

橫向模式下的已簽署媒體的已簽署短期 URI。

portraitUri

string

已簽署的直向短期 URI。這個 URI 適用於直向模式的媒體。