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 فيديو فقط. المفتاح هو قيمة تعداد من 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) قصير الأجل مُوقَّع للوسائط في الاتجاه العمودي.