يجلب فيديو يستند إلى عنوانه أو معرّف الفيديو. ستكون الاستجابة إما فيديو به مجموعة من معرفات الموارد المنتظمة (URI) للتشغيل للفيديوهات النشطة، أو حالة "المعالجة" للفيديوهات المعلّقة، أو رسالة الخطأ 404 في حال عدم وجود الفيديو. يُعد استلام فيديو حدثًا قابلاً للفوترة، لذا يجب أن يكون المتصلون الذين يتّبعون هذه الطريقة على استعداد لاستخدام معرِّفات الموارد المنتظمة (URI) التي تم إرجاعها عند تقديم الطلب.
طلب HTTP
GET https://aerialview.googleapis.com/v1/videos:lookupVideo
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
معلمات طلب البحث
المَعلمات | |
---|---|
معلمة الاتحاد key . مطلوبة. مفتاح يتم استخدامه للبحث عن فيديو. يمكن أن تكون السمة "key " واحدة فقط مما يلي: |
|
videoId |
تم عرض رقم تعريف من " |
address |
عنوان بريدي في الولايات المتحدة. |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
يشير ذلك المصطلح إلى كائن يتضمّن كل البيانات المتعلّقة بالفيديو.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "uris": { string: { object ( |
الحقول | |
---|---|
uris |
تعيين أنواع الوسائط إلى معرفات الموارد المنتظمة (URI) الخاصة بها. يتم تضمين هذا الحقل لـ عنصر يحتوي على قائمة من أزواج |
state |
الحالة الحالية لطلب العرض |
metadata |
يحتوي على البيانات الوصفية للفيديو، ويتم ضبطه فقط إذا كانت الحالة |
أوريس
يحتوي على جميع معرفات الموارد المنتظمة (URI) لتنسيق فيديو معيّن.
تمثيل JSON |
---|
{ "landscapeUri": string, "portraitUri": string } |
الحقول | |
---|---|
landscapeUri |
معرف موارد منتظم (URI) قصير الأجل مُوقَّع للوسائط في اتجاه أفقي. |
portraitUri |
معرف موارد منتظم (URI) قصير الأجل مُوقَّع للوسائط في الاتجاه العمودي. |