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 کوتاه مدت امضا شده برای رسانه در جهت پرتره.