Videos: getRating

यह एपीआई, अनुमति वाले उपयोगकर्ता की ओर से वीडियो की सूची को दी गई रेटिंग को वापस लाता है.

कोटा पर असर: इस तरीके को कॉल करने पर, 1 यूनिट का कोटा खर्च होता है.

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

अनुरोध

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

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
https://www.googleapis.com/auth/youtube.readonly

पैरामीटर

यहां दी गई टेबल में उन पैरामीटर की सूची दी गई है जिनका इस्तेमाल इस क्वेरी में किया जा सकता है. यहां दिए गए सभी पैरामीटर, क्वेरी पैरामीटर हैं.

पैरामीटर
ज़रूरी पैरामीटर
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
इस संसाधन का Etag.
items[] list
रेटिंग की ऐसी सूची जो अनुरोध की शर्तों से मेल खाती हो.
items[].videoId string
यह आईडी, YouTube पर वीडियो की पहचान करने के लिए इस्तेमाल किया जाता है.
items[].rating string
भरोसेमंद उपयोगकर्ता ने वीडियो को जो रेटिंग दी है.

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

गड़बड़ियां

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

इसे आज़माएं!

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