GuideCategories: list

ध्यान दें: यह सुविधा बंद होने की सूचना है.

guideCategories संसाधन और guideCategories.list तरीका, दोनों 9 सितंबर, 2020 से बंद हो गए हैं.

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

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

अनुरोध

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

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 alpha-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
इस संसाधन का ETag.
nextPageToken string
यह ऐसा टोकन है जिसका इस्तेमाल pageToken पैरामीटर की वैल्यू के तौर पर किया जा सकता है. इससे नतीजों के सेट में अगला पेज वापस पाया जा सकता है.
prevPageToken string
यह ऐसा टोकन है जिसका इस्तेमाल pageToken पैरामीटर की वैल्यू के तौर पर किया जा सकता है. इससे नतीजों के सेट में पिछला पेज वापस पाया जा सकता है.
pageInfo object
pageInfo ऑब्जेक्ट, नतीजों के सेट के लिए पेजिंग की जानकारी शामिल करता है.
pageInfo.totalResults integer
नतीजे के सेट में मौजूद नतीजों की कुल संख्या.
pageInfo.resultsPerPage integer
एपीआई के जवाब में शामिल नतीजों की संख्या.
items[] list
उन कैटगरी की सूची जिन्हें YouTube चैनलों से जोड़ा जा सकता है. इस मैप में, कैटगरी आईडी, मैप कुंजी है. इसकी वैल्यू, इससे जुड़ी guideCategory संसाधन है.

गड़बड़ियां

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

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

इसे आज़माएं!

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