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

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

الفيديوهات

يستدعي هذا المثال الطريقة search.list للعثور على الفيديوهات العالية الدقة الأكثر مشاهدة والمرتبطة بطلب البحث "كلب يتزلّج على لوحة تزلج". يضبط طلب البحث المَعلمات 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

القنوات

يوضّح هذا المثال كيفية العثور على قنوات تتطابق مع طلب البحث "سفر". تستدعي هذه الطريقة 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 API.

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

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