VideoCategories: list

यह उन कैटगरी की सूची दिखाता है जिन्हें YouTube वीडियो से जोड़ा जा सकता है.

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

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

अनुरोध

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

GET https://www.googleapis.com/youtube/v3/videoCategories

पैरामीटर

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

पैरामीटर
ज़रूरी पैरामीटर
part string
part पैरामीटर, videoCategory संसाधन की उन प्रॉपर्टी के बारे में बताता है जिन्हें एपीआई से मिली जानकारी में शामिल किया जाएगा. पैरामीटर वैल्यू को snippet पर सेट करें.
फ़िल्टर (इनमें से सिर्फ़ एक पैरामीटर तय करें)
id string
id पैरामीटर, उन संसाधनों के लिए वीडियो कैटगरी आईडी की कॉमा लगाकर अलग की गई सूची के बारे में बताता है जिन्हें वापस लाया जा रहा है.
regionCode string
regionCode पैरामीटर, एपीआई को निर्देश देता है कि वह चुने गए देश में उपलब्ध वीडियो कैटगरी की सूची दिखाए. इस पैरामीटर की वैल्यू, ISO 3166-1 alpha-2 देश का कोड है.
वैकल्पिक पैरामीटर
hl string
hl पैरामीटर से यह तय होता है कि एपीआई से मिली जानकारी में टेक्स्ट वैल्यू के लिए किस भाषा का इस्तेमाल किया जाना चाहिए. डिफ़ॉल्ट वैल्यू en_US है.

अनुरोध का मुख्य भाग

इस तरीके को कॉल करते समय, अनुरोध का मुख्य हिस्सा न दें.

जवाब

अगर यह तरीका सही से काम करता है, तो जवाब के मुख्य हिस्से में नीचे दिया गया स्ट्रक्चर शामिल होता है:

{
  "kind": "youtube#videoCategoryListResponse",
  "etag": etag,
  "nextPageToken": string,
  "prevPageToken": string,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    videoCategory resource
  ]
}

प्रॉपर्टी

यहां दी गई टेबल में, इस संसाधन में दिखने वाली प्रॉपर्टी के बारे में बताया गया है:

प्रॉपर्टी
kind string
इससे एपीआई संसाधन के टाइप की पहचान होती है. वैल्यू youtube#videoCategoryListResponse होगी.
etag etag
इस संसाधन का ETag.
nextPageToken string
वह टोकन जिसका इस्तेमाल pageToken पैरामीटर की वैल्यू के तौर पर किया जा सकता है, ताकि नतीजों के सेट में अगला पेज वापस लाया जा सके.
prevPageToken string
यह ऐसा टोकन है जिसका इस्तेमाल pageToken पैरामीटर की वैल्यू के तौर पर किया जा सकता है. इससे नतीजों के सेट में पिछला पेज वापस पाया जा सकता है.
pageInfo object
pageInfo ऑब्जेक्ट, नतीजों के सेट के लिए पेजिंग की जानकारी को एन्कैप्सुलेट करता है.
pageInfo.totalResults integer
नतीजों के सेट में मौजूद नतीजों की कुल संख्या.
pageInfo.resultsPerPage integer
एपीआई से मिली जानकारी में शामिल नतीजों की संख्या.
items[] list
वीडियो की कैटगरी की सूची, जिसे YouTube वीडियो से जोड़ा जा सकता है. इस मैप में, वीडियो कैटगरी का आईडी, मैप कुंजी है. इसकी वैल्यू, इससे जुड़ी videoCategory संसाधन होती है.

गड़बड़ियां

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

गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा
notFound (404) videoCategoryNotFound id पैरामीटर से पहचानी गई वीडियो कैटगरी नहीं मिली. मान्य वैल्यू की सूची पाने के लिए, videoCategories.list तरीके का इस्तेमाल करें.

इसे आज़माएं!

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