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