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.