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。這個 URI 適用於直向模式的媒體。
|
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-08-22 (世界標準時間)。
[null,null,["上次更新時間: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"]]