نمونه‌های زیر نشان می‌دهند که چگونه می‌توان از YouTube Data API (v3) برای انجام عملکردهای مرتبط با رده‌بندی ویدیو استفاده کرد.
رده‌بندی کردن ویدیو
برای ارسال رده‌بندی کاربر برای ویدیو، روش videos.rate را فراخوانی کنید. این درخواست باید بااستفاده از OAuth 2.0 مجاز شود.
دو پارامتر زیر را در درخواستتان تنظیم کنید:
- پارامتر
idشناسه ویدیو YouTube ویدیویی را مشخص می‌کند که درحال رده‌بندی شدن است (یا رده‌بندی آن برداشته می‌شود). - پارامتر
ratingرده‌بندی‌ای را مشخص می‌کند که کاربر مجازکننده درخواست می‌خواهد ثبت کند. مقادیر معتبر پارامتر عبارتند ازlike،dislike، وnone. دو مقدار اول رده‌بندی را تنظیم می‌کند و مقدار سوم هر رده‌بندی‌ای را که قبلاً برای کاربر وجود داشته است برمی‌دارد.
نمونه درخواست زیر رتبه‌بندی مثبت (پسندیدن) را به ویدیو سخنرانی اصلی در کنفرانس Google I/O سال ۲۰۱۴ می‌دهد:
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.rate? id=wtLJPvx7-ys &rating=like
بازیابی رده‌بندی کاربر فعلی از ویدیو
روش videos.getRating به شما امکان می‌دهد رده‌بندی کاربر اصالت‌سنجی‌شده فعلی را برای یک یا چند ویدیو بازیابی کنید. در درخواست خود، مقدار پارامتر id را به فهرستی از شناسه‌های ویدیو YouTube برای منابعی که داده‌های رده‌بندی را برای آن‌ها بازیابی می‌کنید، تنظیم کنید. توجه داشته باشید که این درخواست باید بااستفاده از OAuth 2.0 مجاز شود.
درخواست نمونه زیر رده‌بندی کاربر فعلی از ویدیو سخنرانی اصلی در کنفرانس Google I/O در سال ۲۰۱۴ را بازیابی می‌کند. (اگر مثال قبلی را در APIs Explorer اجرا کرده باشید، پاسخ میانای برنامه‌سازی کاربردی باید نشان دهد که رده‌بندی like است.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.getRating? id=wtLJPvx7-ys
بازیابی ویدیوهای رده‌بندی‌شده توسط کاربر فعلی
پارامتر myRating روش videos.list به شما امکان می‌دهد فهرستی از ویدیوهای رتبه‌بندی‌شده توسط کاربر را که درخواست API را مجاز می‌کند، بازیابی کنید. مقدار پارامتر نشان می‌دهد که آیا می‌خواهید ویدیوهای پسندیده یا نپسندیده را بازیابی کنید.
نمونه درخواست زیر فهرستی از ویدیوهایی را بازیابی می‌کند که کاربر فعلی به آن‌ها رده‌بندی like داده است. درخواست باید بااستفاده از OAuth 2.0 مجاز شود.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list? part=snippet &myRating=like
contentDetails.relatedPlaylists.likes قرار دارد.بنابراین، API به شما امکان می‌دهد فهرست ویدیوهایی را که کاربر پسندیده است بااستفاده از روش
videos.list یا روش playlistItems.list بازیابی کنید. ازآنجایی‌که اطلاعات متفاوتی در منبع video نسبت‌به منبع playlistItem برگردانده می‌شود، می‌توانید روشی را انتخاب کنید که بهترین تناسب را با نیازهایتان دارد.