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

यहां दिए गए उदाहरणों में, वीडियो रेटिंग से जुड़े फ़ंक्शन करने के लिए, 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 तरीके की मदद से, पुष्टि किए गए मौजूदा उपयोगकर्ता की ओर से एक या एक से ज़्यादा वीडियो को दी गई रेटिंग को वापस पाया जा सकता है. अपने अनुरोध में, id पैरामीटर की वैल्यू को कॉमा लगाकर अलग किए गए YouTube वीडियो आईडी की सूची में सेट करें. यह सूची, उन संसाधनों के लिए होनी चाहिए जिनकी रेटिंग का डेटा आपको चाहिए. ध्यान दें कि इस अनुरोध को OAuth 2.0 का इस्तेमाल करके अनुमति दी जानी चाहिए.

यहां दिए गए सैंपल अनुरोध में, 2014 Google I/O कॉन्फ़्रेंस के मुख्य भाषण के वीडियो की रेटिंग का पता चलता है. (अगर आपने API Explorer में पिछले उदाहरण को लागू किया है, तो एपीआई के जवाब से पता चलना चाहिए कि रेटिंग 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 तरीके का इस्तेमाल करके पसंद किया है. video रिसॉर्स में playlistItem रिसॉर्स से अलग जानकारी दिखती है. इसलिए, अपनी ज़रूरत के हिसाब से कोई एक तरीका चुना जा सकता है.