Videos: rate

ניתן להוסיף לסרטון דירוג של לייק או דיסלייק או להסיר דירוג מסרטון.

השפעת המכסה: קריאה לשיטה הזו כרוכה בעלות המכסה של 50 יחידות.

הערה: ההגדרה הזו לא משפיעה על מספר הלייקים/הדיסלייקים הרשמי של הסרטון.

תרחישים נפוצים

בקשה

בקשת 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 – הסרת כל סיווג שהמשתמש המאומת הגדיר לסרטון לפני כן.

תוכן הבקשה

אין לספק תוכן בקשה בקריאה לשיטה הזו.

תשובה

אם הפעולה מצליחה, השיטה הזו מחזירה קוד תגובה 204 HTTP (No Content).

שגיאות

בטבלה הבאה מפורטות הודעות השגיאה שה-API עשוי להחזיר בתגובה לקריאה לשיטה הזו. כדי לקבל פרטים נוספים, אפשר לעיין במסמכי התיעוד בנושא הודעת שגיאה.

סוג השגיאה פרטי השגיאה התיאור
badRequest (400) emailNotVerified המשתמש חייב לאמת את כתובת האימייל שלו לפני הדירוג.
badRequest (400) invalidRating הבקשה הכילה ערך לא צפוי לפרמטר rating.
badRequest (400) videoPurchaseRequired רק משתמשים ששכרו סרטונים בהשכרה יכולים לדרג אותם.
forbidden (403) forbidden לא ניתן לדרג את הסרטון שניסית לדרג. יכול להיות שהבקשה לא מורשית כראוי.
forbidden (403) videoRatingDisabled הבעלים של הסרטון שאתה מנסה לדרג השבית את הדירוגים עבור הסרטון הזה.
notFound (404) videoNotFound לא ניתן למצוא את הסרטון שניסית לדרג. צריך לבדוק את ערך הפרמטר id של הבקשה כדי לוודא שהוא נכון.

רוצה לנסות?

צריך להשתמש בערך APIs Explorer כדי לקרוא ל-API הזה ולראות את הבקשה והתגובה של ה-API.