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

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