Videos: getRating

उन वीडियो की रेटिंग फिर से हासिल करता है जो अधिकृत उपयोगकर्ता ने खास वीडियो की सूची को दी हैं.

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

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

अनुरोध

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

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
आधिकारिक उपयोगकर्ता ने वीडियो को जो रेटिंग दी है.

इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
  • dislike
  • like
  • none
  • unspecified

गड़बड़ियां

एपीआई सिर्फ़ ऐसे गड़बड़ी के मैसेज के बारे में नहीं बताता जो सिर्फ़ एपीआई के इस तरीके के लिए हो. हालांकि, इस तरीके से अब भी एपीआई से जुड़ी सामान्य गड़बड़ियां मिल सकती हैं. ये गड़बड़ियां, गड़बड़ी के मैसेज दस्तावेज़ में मौजूद होती हैं.

इसे आज़माएं!

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