Videos: rate

به یک ویدیو رده‌بندی پسندیدن یا نپسندیدن اضافه کنید یا رده‌بندی را از یک ویدیو بردارید.

تأثیر سهمیه: فراخوانی این روش هزینه سهمیه ۵۰ واحدی دارد.

توجه: این کار بر تعداد رسمی پسندیدن/نپسندیدن ویدیو تأثیری ندارد.

موارد استفاده رایج

درخواست

درخواست HTTP

POST https://www.googleapis.com/youtube/v3/videos/rate

صدور مجوز

این درخواست به مجوز با حداقل یکی از دامنه‌های زیر نیاز دارد (درباره اصالت‌سنجی و مجوز بیشتر بخوانید).

حوزه
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

پارامترها

جدول زیر پارامترهایی را که این پُرسمان پشتیبانی می‌کند فهرست می‌کند. همه پارامترهای فهرست‌شده پارامترهای پُرسمان هستند.

پارامترها
پارامترهای الزامی
id string
پارامتر id شناسه ویدیو YouTube ویدیویی را مشخص می‌کند که درحال رده‌بندی شدن است یا رده‌بندی آن برداشته می‌شود.
rating string
رده‌بندی را برای ضبط مشخص می‌کند.

مقادیر قابل‌قبول عبارت‌اند از:
  • dislike – سوابقی که نشان می‌دهد کاربر اصالت‌سنجی‌شده ویدیو را نپسندیده است.
  • like – ثبت می‌کند که کاربر اصالت‌سنجی‌شده ویدیو را پسندیده است.
  • none – هر رده‌بندی‌ای را که کاربر اصالت‌سنجی‌شده قبلاً برای ویدیو تنظیم کرده است برمی‌دارد.

متن درخواست

هنگام فراخوانی این روش، بدنه درخواست ارائه نکنید.

پاسخ

اگر موفقیت‌آمیز باشد، این روش کد پاسخ HTTP 204 (No Content) را برمی‌گرداند.

خطاها

جدول زیر پیام‌های خطایی را که ممکن است API در پاسخ به فراخوانی این روش برگرداند، مشخص می‌کند. لطفاً برای جزئیات بیشتر به سند پیام خطا مراجعه کنید.

نوع خطا جزئیات خطا شرح
badRequest (400) emailNotVerified کاربر باید قبل‌از رتبه‌بندی، نشانی ایمیل خود را تأیید کند.
badRequest (400) invalidRating درخواست حاوی مقدار غیرمنتظره‌ای برای پارامتر rating بود.
badRequest (400) videoPurchaseRequired فقط کاربرانی که ویدیوهای کرایه‌ای را کرایه کرده‌اند می‌توانند به آن‌ها رده‌بندی بدهند.
forbidden (403) forbidden ویدیویی که می‌خواهید رتبه‌بندی کنید قابل رتبه‌بندی نیست. ممکن است درخواست به‌درستی مجاز نشده باشد.
forbidden (403) videoRatingDisabled مالک ویدیویی که تلاش می‌کنید رتبه‌بندی کنید، رتبه‌بندی‌ها را برای آن ویدیو غیرفعال کرده است.
notFound (404) videoNotFound ویدیویی که می‌خواهید رتبه‌بندی کنید پیدا نشد. مقدار پارامتر id درخواست را بررسی کنید تا مطمئن شوید درست است.

امتحان کنید!

برای فراخوانی این API و دیدن درخواست و پاسخ API، از APIs Explorer استفاده کنید.