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 का इस्तेमाल करें. साथ ही, एपीआई अनुरोध और उसका जवाब देखें.