GuideCategories: list

ध्यान दें: यह सुविधा बंद होने का एलान किया गया है.

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 का इस्तेमाल करें.