ניתן להוסיף לסרטון דירוג של לייק או דיסלייק או להסיר דירוג מסרטון.
השפעת המכסה: קריאה לשיטה הזו כרוכה בעלות המכסה של 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 מציין את הדירוג לתיעוד. הערכים המקובלים הם:
|
תוכן הבקשה
אין לספק תוכן בקשה בקריאה לשיטה הזו.
תשובה
אם הפעולה מצליחה, השיטה הזו מחזירה קוד תגובה 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.