VideoCategories: list

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

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

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

अनुरोध

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

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 इस संसाधन का ईटैग.
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 का इस्तेमाल करें. साथ ही, एपीआई अनुरोध और रिस्पॉन्स देखें.