अधिकृत उपयोगकर्ता ने जो रेटिंग दी है, वह उनसे संबंधित वीडियो की सूची को फिर से पाता है.
कोटा असर: इस तरीके को कॉल करने पर कोटा लागत एक इकाई हो जाती है.
इस्तेमाल के सामान्य उदाहरण
अनुरोध करें
एचटीटीपी अनुरोध
GET https://www.googleapis.com/youtube/v3/videos/getRating
अनुमति दें
इस अनुरोध के लिए, इनमें से कम से कम एक दायरे की अनुमति लेना ज़रूरी है. पुष्टि करने और अनुमति देने के बारे में ज़्यादा जानें.
दायरा |
---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
पैरामीटर
इस टेबल में ऐसे पैरामीटर दिए गए हैं जो क्वेरी के साथ काम करते हैं. सूची में दिए गए सभी पैरामीटर, क्वेरी पैरामीटर हैं.
पैरामीटर | ||
---|---|---|
ज़रूरी पैरामीटर | ||
id |
string id पैरामीटर, YouTube वीडियो आईडी की ऐसी कॉमा-सेपरेटेड लिस्ट देता है जिसके लिए आपको रेटिंग डेटा मिल रहा है. video रिसॉर्स में, id प्रॉपर्टी में वीडियो का आईडी दिखता है. |
|
ज़रूरी पैरामीटर | ||
onBehalfOfContentOwner |
string इस पैरामीटर का इस्तेमाल सिर्फ़ सही तरीके से की गई अनुमति वाले अनुरोध में किया जा सकता है. ध्यान दें: यह पैरामीटर खास तौर पर YouTube कॉन्टेंट पार्टनर के लिए है. onBehalfOfContentOwner पैरामीटर से पता चलता है कि अनुरोध की पुष्टि के लिए, किसी YouTube कॉन्टेंट मैनेजमेंट सिस्टम के उपयोगकर्ता की पहचान की गई है. यह उपयोगकर्ता, पैरामीटर वैल्यू में तय किए गए कॉन्टेंट के मालिक की तरफ़ से काम करता है. यह पैरामीटर उन YouTube कॉन्टेंट पार्टनर के लिए है जो कई अलग-अलग YouTube चैनलों के मालिक हैं और उन्हें प्रबंधित करते हैं. इसकी मदद से कॉन्टेंट के मालिक एक बार पुष्टि कर सकते हैं. साथ ही, अपने सभी वीडियो और चैनल के डेटा को ऐक्सेस कर सकते हैं. इसके लिए, उन्हें हर चैनल के लिए पुष्टि करने के क्रेडेंशियल नहीं देने होंगे. जिस कॉन्टेंट मैनेजमेंट सिस्टम खाते से उपयोगकर्ता की पुष्टि होती है उसे YouTube के कॉन्टेंट के मालिक से लिंक होना चाहिए. |
अनुरोध का मुख्य भाग
इस तरीके को कॉल करते समय, अनुरोध का मुख्य हिस्सा न दें.
जवाब
अगर अनुरोध कामयाब रहता है, तो इस रिस्पॉन्स के साथ रिस्पॉन्स का फ़ॉर्मैट नीचे दिया गया है:
{ "kind": "youtube#videoGetRatingResponse", "etag": etag, "items": [ { "videoId": string, "rating": string } ] }
प्रॉपर्टी
इस टेबल में उन प्रॉपर्टी के बारे में बताया गया है जो इस रिसॉर्स में मौजूद हैं:
प्रॉपर्टी | |
---|---|
kind |
string इससे यह पता चलता है कि एपीआई संसाधन किस तरह का है. वैल्यू youtube#videoGetRatingResponse होगी. |
etag |
etag इस संसाधन का ऐट. |
items[] |
list रेटिंग की सूची, जो अनुरोध से जुड़ी शर्तों को पूरा करती है. |
items[].videoId |
string वह आईडी जिसका इस्तेमाल YouTube, वीडियो की खास तौर पर पहचान करने के लिए करता है. |
items[].rating |
string वह रेटिंग जो आधिकारिक उपयोगकर्ता ने वीडियो को दी है. इस प्रॉपर्टी की सही वैल्यू हैं:
|
गड़बड़ियां
एपीआई में इस तरह के खास गड़बड़ी वाले मैसेज शामिल नहीं हैं. हालांकि, यह तरीका अब भी गड़बड़ी के मैसेज वाले दस्तावेज़ में मौजूद सामान्य एपीआई से जुड़ी गड़बड़ियां दिखा सकता है.
इसे आज़माएं!
इस एपीआई को कॉल करने और एपीआई का अनुरोध और जवाब देखने के लिए, APIs Explorer का इस्तेमाल करें.