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

הדוגמאות הבאות מראות איך להשתמש ב-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, לכן תוכלו לבחור את השיטה המתאימה ביותר לצרכים שלכם.