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

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

ویدیوها

این مثال متد 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 را برای یافتن نتایج جستجویی که بیشترین ارتباط را با زبانی خاص دارند فراخوانی می‌کند. این مثال نشان می‌دهد که عبارت پُرسمان دریایی (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 Cloud مرتبط است برچسب‌گذاری می‌شود.

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

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