التنفيذ: طلبات البحث

توضح الأمثلة التالية كيفية إكمال عدة أنواع مختلفة من طلبات البحث في واجهة برمجة التطبيقات الإصدار 3.

الفيديوهات

يستدعي هذا المثال الطريقة search.list للعثور على الفيديوهات الأكثر مشاهدة ودقة عالية (HD) المرتبطة بطلب البحث "كلب تزلج". يعيّن طلب البحث المعلمات order وpart وq وtype وvideoDefinition.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &order=viewCount
        &q=skateboarding+dog
        &type=video
        &videoDefinition=high

يمكنك الاطّلاع على وثائق طريقة search.list للحصول على نماذج رموز.

قوائم التشغيل

يعرض هذا المثال كيفية العثور على قوائم التشغيل المطابقة لعبارة طلب البحث "GoogleDevelopers". تستدعي الدالة الطريقة search.list وتضبط قيمة المعلمة type على playlist بحيث لا تتضمن مجموعة النتائج سوى قوائم تشغيل.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &q=GoogleDevelopers
        &type=playlist

القنوات

يعرض هذا المثال كيفية العثور على قنوات تتطابق مع عبارة البحث "travel". تستدعي الطريقة search.list وتضبط قيمة المعلمة type على channel بحيث لا تتضمن مجموعة النتائج سوى القنوات.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &q=travel
        &type=channel

نتائج ذات صلة بلغة معيّنة

يستدعي هذا المثال طريقة search.list للعثور على نتائج البحث الأكثر صلة بلغة معيّنة. يوضح المثال أن عبارة طلب البحث هي marine (q=marine) وأن استجابة واجهة برمجة التطبيقات يجب أن تتضمن نتائج أكثر صلة باللغة الفرنسية (relevanceLanguage=fr).

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &q=marine
        &relevanceLanguage=fr

تجدر الإشارة إلى أن الطلب لا يعيّن قيمة للمعلمة type، مما يعني أن كل نتيجة بحث يمكن أن تشير إلى فيديو أو قائمة تشغيل أو قناة.

مقاطع الفيديو التي تم تحميلها عبر تطبيق مطور البرامج أو موقعه على الويب

يوضح هذا المثال كيفية استخدام المعلمة forDeveloper لتقييد عملية البحث لاسترداد الفيديوهات التي تم تحميلها فقط عبر تطبيق مطور البرامج أو موقعه الإلكتروني. يمكن استخدام هذه المعلمة بالاقتران مع معلمات بحث اختيارية، مثل المعلمة q.

ملاحظة: لا يعرض طلب البحث هذا النتائج فعليًا في "مستكشف واجهات برمجة التطبيقات" لأنّ "مستكشف واجهات برمجة التطبيقات" لا يتيح تحميلات الفيديو. يمكنك تشغيل طلب البحث هذا لتطبيقك خارج مستكشف واجهات برمجة التطبيقات، ولكن لا يمكنك الحصول على نتائج لتطبيقك باستخدام مستكشف واجهات برمجة التطبيقات.

يتم وضع علامة تلقائيًا على كل فيديو تم تحميله باستخدام رقم المشروع المرتبط بتطبيق مطور البرامج في وحدة تحكم واجهة برمجة تطبيقات Google.

عندما يضبط طلب بحث في ما بعد المعلَمة forDeveloper على "صحيح"، تستخدم خدمة واجهة برمجة التطبيقات بيانات اعتماد التفويض الخاصة بالطلب لتحديد مطوّر البرامج. وبالتالي، يمكن لمطوّر البرامج حصر نتائج البحث على الفيديوهات التي يتم تحميلها من خلال التطبيق أو الموقع الإلكتروني الخاص بالمطوّر وليس على الفيديوهات التي تم تحميلها من خلال تطبيقات أو مواقع إلكترونية أخرى.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &q=fun
        &forDeveloper=true