Method: videos.lookupVideo
یک ویدیو را با توجه به آدرس یا شناسه ویدیوی آن واکشی می کند. پاسخ یا ویدیویی با مجموعهای از URIهای پخش برای ویدیوهای ACTIVE، وضعیت پردازش برای ویدیوهای در انتظار یا خطای 404 در صورت عدم وجود ویدیو خواهد بود. دریافت یک ویدیو یک رویداد قابل پرداخت است، بنابراین تماس گیرندگان این روش باید در زمان درخواست آماده استفاده از URI های برگشتی باشند.
درخواست HTTP
GET https://aerialview.googleapis.com/v1/videos:lookupVideo
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای پرس و جو
پارامترها |
---|
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 باشد. |
اوریس
شامل تمام اوریس برای یک فرمت ویدیویی معین است.
نمایندگی JSON |
---|
{
"landscapeUri": string,
"portraitUri": string
} |
فیلدها |
---|
landscapeUri | string یک URI کوتاه مدت امضا شده برای رسانه در جهت افقی. |
portraitUri | string یک URI کوتاه مدت امضا شده برای رسانه در جهت پرتره. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2024-11-13 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2024-11-13 بهوقت ساعت هماهنگ جهانی."],[[["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."]]],[]]