GuideCategories: list

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

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

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