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