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