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

توضّح الأمثلة التالية كيفية إكمال عدة أنواع مختلفة من طلبات البحث في الإصدار 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 Cloud Console.

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

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