9 सितंबर, 2020 से
guideCategories
संसाधन और guideCategories.list
तरीके, दोनों पर रोक लगा दी गई है.
YouTube चैनल से जुड़ी जा सकने वाली कैटगरी की सूची दिखाता है.
कोटा असर: इस तरीके को कॉल करने पर कोटा लागत एक इकाई हो जाती है.
अनुरोध करें
एचटीटीपी अनुरोध
GET https://www.googleapis.com/youtube/v3/guideCategories
पैरामीटर
नीचे दी गई टेबल में उन पैरामीटर की सूची दी गई है जो इस क्वेरी के साथ काम करते हैं. सूची में दिए गए सभी पैरामीटर, क्वेरी पैरामीटर हैं.
पैरामीटर | ||
---|---|---|
ज़रूरी पैरामीटर | ||
part |
string part पैरामीटर, guideCategory संसाधन प्रॉपर्टी के बारे में बताता है, जिन्हें एपीआई रिस्पॉन्स में शामिल किया जाएगा. पैरामीटर वैल्यू को snippet पर सेट करें.
|
|
फ़िल्टर (इनमें से किसी एक पैरामीटर के बारे में बताएं) | ||
id |
string id पैरामीटर में, हटाए जा रहे संसाधनों के लिए YouTube चैनल के कैटगरी आईडी की सूची दी गई है. कॉमा लगाकर इन्हें अलग किया गया है. guideCategory के संसाधन में, id प्रॉपर्टी से YouTube चैनल की श्रेणी आईडी का पता चलता है. |
|
regionCode |
string regionCode पैरामीटर, एपीआई को खास देश में उपलब्ध गाइड की कैटगरी की सूची लौटाने का निर्देश देता है. पैरामीटर की वैल्यू ISO 3166-1 ऐल्फ़ा-2 देश कोड है. |
|
ज़रूरी पैरामीटर | ||
hl |
string hl पैरामीटर से उस भाषा का पता चलता है जिसका इस्तेमाल एपीआई रिस्पॉन्स में टेक्स्ट वैल्यू के लिए किया जाएगा. डिफ़ॉल्ट वैल्यू en-US है. |
अनुरोध का मुख्य भाग
इस तरीके को कॉल करते समय, अनुरोध का मुख्य हिस्सा न दें.
जवाब
अगर अनुरोध कामयाब रहता है, तो इस रिस्पॉन्स के साथ रिस्पॉन्स का फ़ॉर्मैट नीचे दिया गया है:
{ "kind": "youtube#guideCategoryListResponse", "etag": etag, "nextPageToken": string, "prevPageToken": string, "pageInfo": { "totalResults": integer, "resultsPerPage": integer }, "items": [ guideCategory resource ] }
प्रॉपर्टी
इस टेबल में उन प्रॉपर्टी के बारे में बताया गया है जो इस रिसॉर्स में मौजूद हैं:
प्रॉपर्टी | |
---|---|
kind |
string इससे यह पता चलता है कि एपीआई संसाधन किस तरह का है. वैल्यू youtube#guideCategoryListResponse होगी. |
etag |
etag इस संसाधन का ऐट. |
nextPageToken |
string यह टोकन, pageToken सेट की वैल्यू के तौर पर इस्तेमाल किया जा सकता है. इससे नतीजों के सेट में, अगला पेज फिर से मिल जाता है. |
prevPageToken |
string यह टोकन, pageToken सेट की वैल्यू के तौर पर इस्तेमाल किया जा सकता है. इससे नतीजों के सेट में, पिछले पेज को वापस लाया जा सकता है. |
pageInfo |
object pageInfo ऑब्जेक्ट, नतीजे के सेट के लिए पेजिंग जानकारी इकट्ठा करता है. |
pageInfo.totalResults |
integer नतीजों के सेट में कुल नतीजे. |
pageInfo.resultsPerPage |
integer एपीआई रिस्पॉन्स में शामिल किए गए नतीजों की संख्या. |
items[] |
list YouTube चैनल से जुड़ी कैटगरी की सूची. इस मैप में, कैटगरी आईडी मैप कुंजी है और इसकी वैल्यू इससे जुड़े guideCategory रिसॉर्स है. |
गड़बड़ियां
नीचे दी गई टेबल में, गड़बड़ी के उन मैसेज के बारे में बताया गया है जो एपीआई, इस तरीके का इस्तेमाल करके बनाए गए कॉल के जवाब में दे सकता है. ज़्यादा जानकारी के लिए, कृपया गड़बड़ी का मैसेज दस्तावेज़ देखें.
गड़बड़ी का टाइप | गड़बड़ी की जानकारी | ब्यौरा |
---|---|---|
notFound (404) |
notFound |
id पैरामीटर से पहचानी गई गाइड की कैटगरी नहीं मिली. मान्य वैल्यू की सूची फिर से पाने के लिए, guideCategory.list तरीके का इस्तेमाल करें. |
इसे आज़माएं!
इस एपीआई को कॉल करने और एपीआई का अनुरोध और जवाब देखने के लिए, APIs Explorer का इस्तेमाल करें.