Videos: rate

वीडियो को पसंद या नापसंद करने की रेटिंग जोड़ें या वीडियो से रेटिंग हटाएं.

कोटा पर असर: इस तरीके का इस्तेमाल करने पर 50 यूनिट का कोटा शुल्क होगा.

ध्यान दें: इससे, वीडियो को आधिकारिक तौर पर पसंद/नापसंद करने की संख्या पर कोई असर नहीं पड़ता.

इस्तेमाल के सामान्य उदाहरण

अनुरोध

एचटीटीपी अनुरोध

POST https://www.googleapis.com/youtube/v3/videos/rate

अनुमति

इस अनुरोध के लिए, इनमें से कम से कम एक स्कोप के साथ अनुमति देना ज़रूरी है (पुष्टि करने और अनुमति देने के बारे में ज़्यादा पढ़ें).

स्कोप
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

पैरामीटर

इस टेबल में वे पैरामीटर दिए गए हैं जो इस क्वेरी पर काम करते हैं. सूची में शामिल सभी पैरामीटर, क्वेरी पैरामीटर हैं.

पैरामीटर
ज़रूरी पैरामीटर
id string
id पैरामीटर, उस वीडियो के YouTube वीडियो का आईडी बताता है जिसे रेटिंग दी जा रही है या जिसकी रेटिंग हटा दी गई है.
rating string
इससे, रिकॉर्ड की जाने वाली रेटिंग के बारे में पता चलता है.

ये वैल्यू स्वीकार की जाती हैं:
  • dislike – इससे पता चलता है कि पुष्टि किए गए उपयोगकर्ता ने वीडियो को नापसंद किया है.
  • like – इससे पता चलता है कि पुष्टि किए गए उपयोगकर्ता ने वीडियो को पसंद किया है.
  • none – पुष्टि किए गए उपयोगकर्ता ने वीडियो के लिए पहले जो रेटिंग सेट की थी उसे हटा दिया जाता है.

अनुरोध का मुख्य भाग

इस तरीके को कॉल करते समय, अनुरोध का मुख्य हिस्सा न दें.

जवाब

अगर यह तरीका काम करता है, तो यह एचटीटीपी 204 रिस्पॉन्स कोड (No Content) दिखाता है.

गड़बड़ियां

नीचे दी गई टेबल में गड़बड़ी के ऐसे मैसेज की पहचान की गई है जिन्हें एपीआई इस तरीके को कॉल करने पर जवाब दे सकता है. ज़्यादा जानकारी के लिए, कृपया गड़बड़ी के मैसेज का दस्तावेज़ देखें.

गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा
badRequest (400) emailNotVerified रेटिंग देने से पहले, उपयोगकर्ता को अपने ईमेल पते की पुष्टि करनी होगी.
badRequest (400) invalidRating अनुरोध में rating पैरामीटर के लिए एक अनचाहा वैल्यू मौजूद थी.
badRequest (400) videoPurchaseRequired किराये पर लिए गए वीडियो को सिर्फ़ वे उपयोगकर्ता रेटिंग दे सकते हैं जिन्होंने उन्हें किराये पर लिया है.
forbidden (403) forbidden आप जिस वीडियो को रेटिंग देने की कोशिश कर रहे हैं उसे रेट नहीं किया जा सकता. हो सकता है कि अनुरोध को सही तरीके से अनुमति न मिली हो.
forbidden (403) videoRatingDisabled आप जिस वीडियो को रेटिंग देना चाहते हैं, उसके मालिक ने उस वीडियो की रेटिंग बंद कर दी है.
notFound (404) videoNotFound आप जिस वीडियो को रेटिंग देना चाहते हैं वह नहीं मिला. अनुरोध के id पैरामीटर की वैल्यू की जांच करके पक्का करें कि वह सही है.

इसे आज़माएं!

इस एपीआई को कॉल करने के लिए, APIs Explorer का इस्तेमाल करें. साथ ही, एपीआई अनुरोध और रिस्पॉन्स देखें.