پیاده سازی: رتبه بندی

مثال‌های زیر نحوه استفاده از YouTube Data API (v3) را برای انجام عملکردهای مرتبط با رتبه‌بندی ویدیو نشان می‌دهند.

به یک ویدیو امتیاز دهید

با روش videos.rate تماس بگیرید تا امتیاز یک کاربر را برای یک ویدیو ارسال کنید. این درخواست باید با استفاده از OAuth 2.0 مجاز باشد.

دو پارامتر زیر را در درخواست خود تنظیم کنید:

  • پارامتر id شناسه ویدیوی YouTube را مشخص می کند که در حال رتبه بندی (یا حذف رتبه آن) است.
  • پارامتر rating رتبه بندی را مشخص می کند که کاربر مجاز به درخواست می خواهد ثبت کند. مقادیر پارامترهای معتبر like ، dislike و none هستند. دو مقدار اول یک رتبه بندی را تعیین می کنند، و سومی هر رتبه ای را که قبلا برای کاربر وجود داشت حذف می کند.

درخواست نمونه زیر امتیاز مثبت (پسندیدن) را به ویدیوی سخنرانی اصلی در کنفرانس Google I/O 2014 می دهد:

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 2014 را بازیابی می‌کند. (اگر مثال قبلی را در APIs Explorer اجرا کرده اید، پاسخ API باید نشان دهد که رتبه 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
توجه: همچنین می‌توانید با دنبال کردن جریان بازیابی ویدیوهای مورد علاقه یک کانال، فهرستی از ویدیوهای پسندیده کاربر (اما نه ویدیوهای دوست نداشتنی) را بازیابی کنید. در مرحله 1 از آن فرآیند، به جای بازیابی شناسه لیست پخش برای ویدیوهای مورد علاقه کانال، شناسه لیست پخش برای ویدیوهای پسندیده کانال را بازیابی کنید. ویژگی contentDetails.relatedPlaylists.likes حاوی مقدار است.

بنابراین، API به شما امکان می دهد لیستی از ویدیوهایی را که کاربر دوست داشته است با استفاده از روش videos.list یا روش playlistItems.list بازیابی کنید. از آنجایی که اطلاعات متفاوتی در یک منبع video نسبت به منبع playlistItem برگردانده می‌شود، می‌توانید بهترین روش را انتخاب کنید که با نیازهای شما مطابقت دارد.