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

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

דרג סרטון

קוראים ל-method‏ 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. (אם הפעלתם את הדוגמה הקודמת ב-API 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, אתם יכולים לבחור את השיטה שמתאימה ביותר לצרכים שלכם.