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 का इस्तेमाल करें.