Method: videos.lookupVideo
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
ดึงข้อมูลวิดีโอโดยใช้ที่อยู่หรือรหัสวิดีโอ การตอบสนองจะเป็นวิดีโอที่มีชุด URI การเล่นสำหรับวิดีโอที่ใช้งานอยู่, สถานะ "กำลังดำเนินการ" สำหรับวิดีโอที่รอดำเนินการ หรือข้อผิดพลาด 404 หากไม่มีวิดีโอ การรับวิดีโอเป็นเหตุการณ์ที่เรียกเก็บเงินได้ ดังนั้นผู้เรียกใช้วิธีนี้ควรพร้อมที่จะใช้ URI ที่แสดงผล ณ เวลาที่ขอ
คำขอ HTTP
GET https://aerialview.googleapis.com/v1/videos:lookupVideo
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์การค้นหา
พารามิเตอร์ |
พารามิเตอร์การรวม key ต้องระบุ คีย์ที่ใช้ค้นหาวิดีโอ key ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้ |
videoId |
string
รหัสที่ส่งคืนจาก videos.renderVideo
|
address |
string
ที่อยู่ไปรษณีย์ในสหรัฐอเมริกา
|
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
ออบเจ็กต์ที่สรุปข้อมูลทั้งหมดเกี่ยวกับวิดีโอ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
{
"uris": {
string: {
object (Uris )
},
...
},
"state": enum (State ),
"metadata": {
object (VideoMetadata )
}
} |
ช่อง |
uris |
map (key: string, value: object (Uris ))
การแมปประเภทสื่อกับ URI ช่องนี้ใช้สำหรับวิดีโอ ACTIVE เท่านั้น คีย์คือค่า enum จาก 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 ที่มีอายุสั้นที่มีการรับรองสำหรับสื่อในแนวตั้ง
|
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-08-31 UTC
[null,null,["อัปเดตล่าสุด 2025-08-31 UTC"],[[["\u003cp\u003eFetches a video using its address or videoId, returning playback URIs for active videos or a processing state for pending ones.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes a set of URIs for different media types if the video is active, along with its current state and metadata.\u003c/p\u003e\n"],["\u003cp\u003eA 404 error is returned if the video does not exist, and receiving a video is a billable event.\u003c/p\u003e\n"],["\u003cp\u003eThe request utilizes a \u003ccode\u003eGET\u003c/code\u003e method with the endpoint \u003ccode\u003ehttps://aerialview.googleapis.com/v1/videos:lookupVideo\u003c/code\u003e and requires either a \u003ccode\u003evideoId\u003c/code\u003e or \u003ccode\u003eaddress\u003c/code\u003e as a query parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe response body provides the video's URIs (if active), state, and metadata.\u003c/p\u003e\n"]]],["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"],null,["# Method: videos.lookupVideo\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.Video.SCHEMA_REPRESENTATION)\n- [Uris](#Uris)\n - [JSON representation](#Uris.SCHEMA_REPRESENTATION)\n\nFetches a video given its address or videoId. The response will either be a video with a set of playback URIs for ACTIVE videos, a PROCESSING state for pending videos, or a 404 error if the video does not exist. Receiving a video is a billable event, so callers of this method should be ready to use the returned URIs at the time of request.\n\n### HTTP request\n\n`GET https://aerialview.googleapis.com/v1/videos:lookupVideo`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|-----------|----------------------------------------------------|\n| Union parameter `key`. Required. A key used to look-up a video. `key` can be only one of the following: ||\n| `videoId` | `string` An ID returned from `videos.renderVideo`. |\n| `address` | `string` A US postal address. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nAn object that encapsulates all of the data about a video.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"uris\": { string: { object (/maps/documentation/aerial-view/reference/rest/v1/videos/lookupVideo#Uris) }, ... }, \"state\": enum (/maps/documentation/aerial-view/reference/rest/v1/State), \"metadata\": { object (/maps/documentation/aerial-view/reference/rest/v1/VideoMetadata) } } ``` |\n\n| Fields ||\n|------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `uris` | `map (key: string, value: object (`[Uris](/maps/documentation/aerial-view/reference/rest/v1/videos/lookupVideo#Uris)`))` A mapping of media types to their URIs. This field is only included for `ACTIVE` videos. The key is an enum value from `MediaFormat`. An object containing a list of `\"key\": value` pairs. Example: `{ \"name\": \"wrench\", \"mass\": \"1.3kg\", \"count\": \"3\" }`. |\n| `state` | `enum (`[State](/maps/documentation/aerial-view/reference/rest/v1/State)`)` Current state of the render request. |\n| `metadata` | `object (`[VideoMetadata](/maps/documentation/aerial-view/reference/rest/v1/VideoMetadata)`)` Contains the video's metadata, only set if the state is `ACTIVE`. |\n\nUris\n----\n\nContains all the uris for a given video format.\n\n| JSON representation |\n|-----------------------------------------------------------|\n| ``` { \"landscapeUri\": string, \"portraitUri\": string } ``` |\n\n| Fields ||\n|----------------|-----------------------------------------------------------------------------|\n| `landscapeUri` | `string` A signed short-lived URI for the media in a landscape orientation. |\n| `portraitUri` | `string` A signed short-lived URI for the media in a portrait orientation. |"]]