הדוגמאות הבאות מראות איך להשתמש ב-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
contentDetails.relatedPlaylists.likes
מכיל את הערך.כלומר, ה-API מאפשר לכם לאחזר רשימה של סרטונים שהמשתמש סימן בלייק, באמצעות השיטה
videos.list
או השיטה playlistItems.list
. במשאב video
מוחזר מידע שונה מאשר במשאב playlistItem
, לכן תוכלו לבחור את השיטה המתאימה ביותר לצרכים שלכם.