YouTube वीडियो से जुड़ी कैटगरी की सूची दिखाता है.
कोटा असर: इस तरीके को कॉल करने पर कोटा लागत एक इकाई हो जाती है.
इस्तेमाल के सामान्य उदाहरण
अनुरोध करें
एचटीटीपी अनुरोध
GET https://www.googleapis.com/youtube/v3/videoCategories
पैरामीटर
इस टेबल में ऐसे पैरामीटर दिए गए हैं जो क्वेरी के साथ काम करते हैं. सूची में दिए गए सभी पैरामीटर, क्वेरी पैरामीटर हैं.
पैरामीटर | ||
---|---|---|
ज़रूरी पैरामीटर | ||
part |
string part पैरामीटर, videoCategory संसाधन प्रॉपर्टी के बारे में बताता है, जिन्हें एपीआई रिस्पॉन्स में शामिल किया जाएगा. पैरामीटर वैल्यू को snippet पर सेट करें.
|
|
फ़िल्टर (इनमें से किसी एक पैरामीटर के बारे में बताएं) | ||
id |
string id पैरामीटर उन वीडियो कैटगरी आईडी की कॉमा-सेपरेटेड लिस्ट देता है जिन्हें आप वापस पा रहे हैं. |
|
regionCode |
string regionCode पैरामीटर, एपीआई को देश के हिसाब से उपलब्ध वीडियो कैटगरी की सूची लौटाने का निर्देश देता है. पैरामीटर की वैल्यू ISO 3166-1 ऐल्फ़ा-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 इस संसाधन का ऐट. |
nextPageToken |
string यह टोकन, pageToken सेट की वैल्यू के तौर पर इस्तेमाल किया जा सकता है. इससे नतीजों के सेट में, अगला पेज फिर से मिल जाता है. |
prevPageToken |
string यह टोकन, pageToken सेट की वैल्यू के तौर पर इस्तेमाल किया जा सकता है. इससे नतीजों के सेट में, पिछले पेज को वापस लाया जा सकता है. |
pageInfo |
object pageInfo ऑब्जेक्ट, नतीजे के सेट के लिए पेजिंग जानकारी इकट्ठा करता है. |
pageInfo.totalResults |
integer नतीजों के सेट में कुल नतीजे. |
pageInfo.resultsPerPage |
integer एपीआई रिस्पॉन्स में शामिल किए गए नतीजों की संख्या. |
items[] |
list वीडियो कैटगरी की सूची, जिसे YouTube वीडियो से जोड़ा जा सकता है. इस मैप में, वीडियो कैटगरी आईडी, मैप कुंजी है. इसकी वैल्यू इससे जुड़े videoCategory रिसॉर्स है. |
गड़बड़ियां
इस टेबल में उन गड़बड़ी के मैसेज के बारे में बताया गया है जो इस तरीके से कॉल करने पर एपीआई मिल सकता है. ज़्यादा जानकारी के लिए, कृपया गड़बड़ी का मैसेज दस्तावेज़ देखें.
गड़बड़ी का टाइप | गड़बड़ी की जानकारी | ब्यौरा |
---|---|---|
notFound (404) |
videoCategoryNotFound |
id पैरामीटर से पहचानी गई वीडियो कैटगरी नहीं मिली. मान्य वैल्यू की सूची फिर से पाने के लिए, videoकैटगरी.list तरीके का इस्तेमाल करें. |
इसे आज़माएं!
इस एपीआई को कॉल करने और एपीआई का अनुरोध और जवाब देखने के लिए, APIs Explorer का इस्तेमाल करें.