लागू करना: रेटिंग

यहां दिए गए उदाहरणों में बताया गया है कि वीडियो रेटिंग से जुड़े फ़ंक्शन करने के लिए, YouTube Data API (v3) का इस्तेमाल कैसे किया जाता है.

वीडियो का मूल्यांकन करें

वीडियो के लिए उपयोगकर्ता की रेटिंग सबमिट करने के लिए videos.rate विधि को कॉल करें. यह अनुरोध OAuth 2.0 का उपयोग करके अधिकृत होना चाहिए.

अपने अनुरोध में, ये दो पैरामीटर सेट करें:

• id पैरामीटर, वीडियो का रेटिंग देने वाले (या उसकी रेटिंग हटाने) वीडियो का YouTube वीडियो आईडी बताता है.
• rating पैरामीटर से उस रेटिंग की जानकारी मिलती है जिसे इस्तेमाल करने वाला व्यक्ति रिकॉर्ड करना चाहता है. like, dislike, और none मान्य पैरामीटर वैल्यू हैं. पहली दो वैल्यू के लिए रेटिंग सेट की जाती है और तीसरा विकल्प ऐसी किसी भी रेटिंग को हटा देता है जो उपयोगकर्ता के लिए पहले से मौजूद थी.

नीचे दिया गया नमूना अनुरोध 2014 के Google I/O कॉन्फ़्रेंस में मुख्य बातों को दिए गए वीडियो को एक सकारात्मक (पसंद) रेटिंग देता है:

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

वीडियो की मौजूदा उपयोगकर्ता रेटिंग फिर से पाएं

videos.getRating का इस्तेमाल करके, उपयोगकर्ता की एक या ज़्यादा वीडियो की रेटिंग फिर से पाई जा सकती है. अपने अनुरोध में, उन संसाधनों के लिए जिनके लिए आप रेटिंग डेटा फिर से पा रहे हैं, YouTube वीडियो आईडी की अल्पविराम से अलग की गई सूची पर id पैरामीटर के मान को सेट करें. ध्यान दें कि यह अनुरोध OAuth 2.0 का इस्तेमाल करके किया जाना चाहिए.

नीचे दिया गया नमूना अनुरोध, 2014 के Google I/O कॉन्फ़्रेंस में कीनोट स्पीच के वीडियो की मौजूदा उपयोगकर्ता रेटिंग को फिर से हासिल करता है. (अगर आपने एपीआई एक्सप्लोरर में पिछला उदाहरण चलाया था, तो एपीआई से मिले रिस्पॉन्स में यह बताना चाहिए कि रेटिंग like है.

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

वर्तमान उपयोगकर्ता के रेट किए गए वीडियो फिर से पाएं

videos.list तरीके के myRating पैरामीटर की मदद से, उन वीडियो की सूची को फिर से पाया जा सकता है जिन्हें उपयोगकर्ता ने एपीआई अनुरोध को अनुमति देने के लिए रेटिंग दी है. पैरामीटर वैल्यू से पता चलता है कि आप पसंद किए गए या नापसंद किए गए वीडियो को वापस पाना चाहते हैं या नहीं.

नीचे दिया गया नमूना अनुरोध उन वीडियो की सूची पर ले जाता है, जिन्हें मौजूदा उपयोगकर्ता ने like रेटिंग दी है. अनुरोध को OAuth 2.0 का इस्तेमाल करके अनुमति दी जानी चाहिए.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list?
part=snippet
&myRating=like

ध्यान दें: चैनल के पसंदीदा वीडियो फिर से पाने के लिए दिए गए निर्देशों का पालन करके, उपयोगकर्ता के पसंद किए गए वीडियो की सूची फिर से हासिल की जा सकती है. इस प्रोसेस के पहले चरण में, चैनल के पसंदीदा वीडियो का प्लेलिस्ट आईडी पाने के बजाय, चैनल के पसंद किए गए वीडियो का प्लेलिस्ट आईडी पाएं. contentDetails.relatedPlaylists.likes प्रॉपर्टी में वैल्यू होती है.

इस तरह, एपीआई में आपको उन वीडियो की सूची वापस पाने की सुविधा मिलती है जिन्हें उपयोगकर्ता ने videos.list तरीके या playlistItems.list तरीके का इस्तेमाल करके पसंद किया है. ऐसा इसलिए, क्योंकि playlistItem रिसॉर्स के बजाय, video रिसॉर्स में अलग-अलग जानकारी दिखती है. इसलिए, अपनी ज़रूरत के हिसाब से सबसे सही तरीका चुना जा सकता है.