Method: videos.lookupVideo

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