הטמעה: דירוגים

הדוגמאות הבאות מראות איך להשתמש ב-YouTube Data API (v3) כדי לבצע פונקציות שקשורות לסיווגי סרטונים.

דרג סרטון

צריך לקרוא לשיטה videos.rate כדי לשלוח את הדירוג של המשתמש לסרטון. יש לאשר את הבקשה הזו באמצעות OAuth 2.0.

מגדירים את שני הפרמטרים הבאים בבקשה:

  • הפרמטר id מציין את מזהה סרטון YouTube של הסרטון בעל הדירוג (או שהדירוג שלו הוסר).
  • הפרמטר rating מציין את הדירוג שהמשתמש מאשר את הבקשה להקליט. ערכי הפרמטר החוקיים הם like, dislike ו-none. שני הערכים הראשונים מגדירים דירוג, והשלישי מסיר כל דירוג שהיה קיים בעבר עבור המשתמש.

הבקשה לדוגמה הבאה נותנת דירוג חיובי (לייק) לסרטון הנאום במהלך נאום הפתיחה של כנס Google I/O ב-2014:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.rate?
        id=wtLJPvx7-ys
        &rating=like

אחזור דירוג הסרטון הנוכחי של משתמש

השיטה videos.getRating מאפשרת לאחזר את הדירוג של משתמש מאומת אחד לפחות של סרטון אחד. בבקשה שלך, צריך להגדיר את הערך של הפרמטר id ברשימה מופרדת בפסיקים של מזהי סרטונים ב-YouTube של המשאבים שעבורם מאחזרים נתוני סיווג. לתשומת ליבך, יש לאשר את הבקשה הזו באמצעות OAuth 2.0.

הבקשה לדוגמה הבאה מאחזרת את הדירוג הנוכחי של המשתמש בסרטון הווידאו של נאום הפתיחה בכנס Google I/O בשנת 2014. (אם הפעלתם את הדוגמה הקודמת ב-APIs Explorer, התשובה מה-API צריכה לציין שהדירוג הוא like.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.getRating?
id=wtLJPvx7-ys

אחזור סרטונים שדורגו על ידי המשתמש הנוכחי

הפרמטר myRating של השיטה videos.list מאפשר לאחזר רשימה של סרטונים שדורגו על ידי המשתמש המאשר את בקשת ה-API. ערך הפרמטר מציין אם רוצים לאחזר סרטונים שסומנו ב'לייק' או 'דיסלייק'.

הבקשה לדוגמה שבהמשך מאחזרת רשימה של סרטונים שהמשתמש הנוכחי העניק להם דירוג של like. יש לאשר את הבקשה באמצעות OAuth 2.0.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list?
part=snippet
&myRating=like
הערה: אתם יכולים גם לאחזר רשימה של סרטונים שמצאו חן בעיני המשתמש (אבל לא סרטונים שסומנו ב'דיסלייק') על ידי ביצוע השלבים לאחזור הסרטונים האהובים על הערוץ. בשלב 1 של התהליך הזה, במקום לאחזר את מזהה הפלייליסט עבור הסרטונים המועדפים בערוץ, תוכלו לאחזר את מזהה הפלייליסט עבור הסרטונים שסימנתם להם לייק בערוץ. המאפיין contentDetails.relatedPlaylists.likes מכיל את הערך.

בעזרת ה-API, אפשר לאחזר רשימה של סרטונים שהמשתמש אהבו. אפשר להשתמש בשיטה videos.list או בשיטה playlistItems.list. מאחר שמידע שונה מוחזר במשאב video בהשוואה למשאב playlistItem, ניתן לבחור את השיטה המתאימה ביותר לצרכים שלך.