پیاده سازی: درخواست های جستجو

مثال‌های زیر نحوه تکمیل چندین نوع مختلف درخواست جستجو را در API v3 نشان می‌دهند.

فیلم های

این مثال روش 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

کانال ها

این مثال نشان می دهد که چگونه می توان کانال های منطبق با عبارت جستجوی "سفر" را پیدا کرد. متد 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 ) و پاسخ API باید حاوی نتایجی باشد که بیشترین ارتباط را با زبان فرانسوی دارد ( relevanceLanguage=fr ).

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

توجه داشته باشید که درخواست مقداری برای پارامتر type تعیین نمی کند، به این معنی که هر نتیجه جستجو می تواند به یک ویدیو، لیست پخش یا کانال اشاره کند.

ویدیوهای آپلود شده از طریق برنامه یا وب سایت توسعه دهنده

این مثال نحوه استفاده از پارامتر forDeveloper را برای محدود کردن جستجو برای بازیابی ویدیوهای آپلود شده از طریق برنامه یا وب سایت توسعه دهنده نشان می دهد. این پارامتر را می توان همراه با پارامترهای جستجوی اختیاری مانند پارامتر q استفاده کرد.

توجه: این پرس و جو در واقع نتایج را در APIs Explorer بر نمی گرداند زیرا APIs Explorer از آپلود ویدیو پشتیبانی نمی کند. شما می توانید این پرس و جو را برای برنامه خود خارج از APIs Explorer اجرا کنید، اما نمی توانید با استفاده از APIs Explorer نتایجی را برای برنامه خود دریافت کنید.

هر ویدیوی آپلود شده به طور خودکار با شماره پروژه مرتبط با برنامه برنامه‌نویس در Google API Console برچسب‌گذاری می‌شود.

هنگامی که یک درخواست جستجو متعاقباً پارامتر forDeveloper را روی true تنظیم می کند، سرویس API از اعتبارنامه مجوز درخواست برای شناسایی توسعه دهنده استفاده می کند. بنابراین، یک برنامه‌نویس می‌تواند نتایج را به ویدیوهای آپلود شده از طریق برنامه یا وب‌سایت خود برنامه‌نویس محدود کند، اما نه به ویدیوهای آپلود شده از طریق برنامه‌ها یا سایت‌های دیگر.

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