CommentThreads: list

एपीआई अनुरोध के पैरामीटर से मैच करने वाली टिप्पणी के थ्रेड की सूची दिखाता है.

कोटा असर: इस तरीके को कॉल करने पर कोटा लागत एक इकाई हो जाती है.

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

अनुरोध करें

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

GET https://www.googleapis.com/youtube/v3/commentThreads

पैरामीटर

इस टेबल में ऐसे पैरामीटर दिए गए हैं जो क्वेरी के साथ काम करते हैं. सूची में दिए गए सभी पैरामीटर, क्वेरी पैरामीटर हैं.

पैरामीटर
ज़रूरी पैरामीटर
part string
part पैरामीटर में एक या उससे ज़्यादा commentThread संसाधन प्रॉपर्टी की कॉमा-सेपरेटेड लिस्ट होती है, जिसे एपीआई रिस्पॉन्स में शामिल किया जाएगा.

नीचे दी गई सूची में part नाम शामिल हैं, जिन्हें आप पैरामीटर वैल्यू में शामिल कर सकते हैं:
  • id
  • replies
  • snippet
फ़िल्टर (इनमें से किसी एक पैरामीटर के बारे में बताएं)
allThreadsRelatedToChannelId string
allThreadsRelatedToChannelId पैरामीटर, एपीआई को बताए गए चैनल से जुड़ी सभी टिप्पणी थ्रेड को वापस करने का निर्देश देता है. जवाब में चैनल के बारे में या चैनल के वीडियो के बारे में टिप्पणियां शामिल हो सकती हैं.
channelId string
channelId पैरामीटर, एपीआई को दिए गए चैनल के बारे में टिप्पणियों के थ्रेड दिखाने का निर्देश देता है. (जवाब में, चैनल पर अपलोड किए गए वीडियो पर की गई टिप्पणियां शामिल नहीं की जाएंगी.)
id string
id पैरामीटर, उन रिसॉर्स के लिए टिप्पणी थ्रेड आईडी की कॉमा-सेपरेटेड लिस्ट बनाता है जिन्हें वापस पाना है.
videoId string
videoId पैरामीटर, एपीआई को खास वीडियो आईडी से जुड़े टिप्पणी थ्रेड वापस करने का निर्देश देता है.
ज़रूरी पैरामीटर
maxResults unsigned integer
maxResults पैरामीटर से पता चलता है कि नतीजों के सेट में कितने आइटम लौटाने हैं.

ध्यान दें: इस पैरामीटर को id पैरामीटर के साथ इस्तेमाल नहीं किया जा सकता. 1 से 100 तक के मान स्वीकार किए जाते हैं. डिफ़ॉल्ट वैल्यू 20 है.
moderationStatus string
इस पैरामीटर का इस्तेमाल सिर्फ़ सही तरीके से की गई अनुमति वाले अनुरोध में किया जा सकता है. इस पैरामीटर को सेट करें, ताकि जवाब वाली टिप्पणियों के थ्रेड को किसी खास मॉडरेशन स्टेटस तक सीमित रखा जा सके.

ध्यान दें: इस पैरामीटर का इस्तेमाल id पैरामीटर के साथ नहीं किया जा सकता. डिफ़ॉल्ट वैल्यू published है.

मान्य वैल्यू ये हैं:
  • heldForReview – टिप्पणियों की वे थ्रेड फिर से पाएं जिन्हें मॉडरेटर समीक्षा के लिए इंतज़ार कर रहा है. जवाब में टिप्पणी के थ्रेड को शामिल किया जा सकता है. ऐसा तब किया जा सकता है, जब सबसे ऊपर के लेवल की टिप्पणी या उस टिप्पणी के कम से कम किसी एक जवाब की समीक्षा होनी बाकी हो.
  • likelySpam – स्पैम के तौर पर मार्क की गई टिप्पणियों के थ्रेड वापस पाएं. जवाब में टिप्पणी के थ्रेड को शामिल किया जा सकता है. ऐसा तब किया जा सकता है, जब सबसे ऊपर के लेवल की टिप्पणी या उस टिप्पणी के कम से कम किसी एक जवाब को स्पैम माना जाए.
  • published – पब्लिश की गई टिप्पणियों के थ्रेड वापस पाएं. यह डिफ़ॉल्ट मान है. जवाब में टिप्पणी के थ्रेड को शामिल किया जा सकता है. ऐसा तब किया जाएगा, जब इसकी टॉप-लेवल टिप्पणी पब्लिश की गई हो.
order string
order पैरामीटर से यह जानकारी मिलती है कि एपीआई के जवाब में टिप्पणी के थ्रेड किस क्रम में शामिल होने चाहिए. मान्य मान हैं:
  • time - टिप्पणी के थ्रेड को समय के हिसाब से क्रम में लगाया जाता है. यह डिफ़ॉल्ट व्यवहार है.
  • relevance - टिप्पणी के थ्रेड इस क्रम में दिखाए जाते हैं कि वे कितने काम के हैं.
ध्यान दें: id पैरामीटर के साथ इस पैरामीटर का इस्तेमाल नहीं किया जा सकता.
pageToken string
pageToken पैरामीटर, नतीजों के सेट में मौजूद उस खास पेज की पहचान करता है जिसे दिखाना है. एपीआई रिस्पॉन्स में, nextPageToken प्रॉपर्टी, नतीजे के अगले पेज की पहचान करती है जिसे फिर से पाया जा सकता है.

ध्यान दें: इस पैरामीटर का इस्तेमाल id पैरामीटर के साथ नहीं किया जा सकता.
searchTerms string
searchTerms पैरामीटर, एपीआई के नतीजों में सिर्फ़ उन टिप्पणियों को शामिल करने की सलाह देता है जिनमें खोज के लिए कुछ खास शब्द शामिल हों.

ध्यान दें: इस पैरामीटर को id पैरामीटर के साथ इस्तेमाल नहीं किया जा सकता.
textFormat string
इस पैरामीटर की वैल्यू को html या plainText पर सेट करें, ताकि एपीआई का इस्तेमाल करने वाले लोगों को, एचटीएमएल फ़ॉर्मैट में या सादे टेक्स्ट में टिप्पणियां वापस करने का निर्देश मिल सके. डिफ़ॉल्ट वैल्यू html है.

मान्य वैल्यू ये हैं:
  • html – टिप्पणियों को एचटीएमएल फ़ॉर्मैट में दिखाता है. यह डिफ़ॉल्ट मान है.
  • plainText – टिप्पणियों को सादे टेक्स्ट वाले फ़ॉर्मैट में दिखाता है.

अनुरोध का मुख्य भाग

इस तरीके को कॉल करते समय, अनुरोध का मुख्य हिस्सा न दें.

जवाब

अगर अनुरोध कामयाब रहता है, तो इस रिस्पॉन्स के साथ रिस्पॉन्स का फ़ॉर्मैट नीचे दिया गया है:

{
  "kind": "youtube#commentThreadListResponse",
  "etag": etag,
  "nextPageToken": string,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    commentThread Resource
  ]
}

प्रॉपर्टी

इस टेबल में उन प्रॉपर्टी के बारे में बताया गया है जो इस रिसॉर्स में मौजूद हैं:

प्रॉपर्टी
kind string
इससे यह पता चलता है कि एपीआई संसाधन किस तरह का है. वैल्यू youtube#commentThreadListResponse होगी.
etag etag
इस संसाधन का ऐट.
nextPageToken string
यह टोकन, pageTokenसेट की वैल्यू के तौर पर इस्तेमाल किया जा सकता है. इससे नतीजों के सेट में, अगला पेज फिर से मिल जाता है.
pageInfo object
pageInfo ऑब्जेक्ट, नतीजे के सेट के लिए पेजिंग जानकारी इकट्ठा करता है.
pageInfo.totalResults integer
नतीजों के सेट में कुल नतीजे.
pageInfo.resultsPerPage integer
एपीआई रिस्पॉन्स में शामिल किए गए नतीजों की संख्या.
items[] list
टिप्पणी के ऐसे थ्रेड की सूची जो अनुरोध की शर्तों को पूरा करते हैं.

गड़बड़ियां

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

गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा
badRequest (400) operationNotSupported आईडी फ़िल्टर सिर्फ़ Google+ पर आधारित टिप्पणियों के साथ काम करता है.
badRequest (400) processingFailure एपीआई सर्वर अनुरोध को पूरा नहीं कर सका. हालांकि यह कोई अस्थायी गड़बड़ी हो सकती है, लेकिन आम तौर पर यह बताती है कि अनुरोध का इनपुट गलत है. अनुरोध के मुख्य भाग में commentThread संसाधन के स्ट्रक्चर की जांच करें, ताकि यह पक्का हो सके कि वह मान्य है.
forbidden (403) commentsDisabled videoId पैरामीटर से पहचाने गए वीडियो में टिप्पणियां बंद कर दी गई हैं.
forbidden (403) forbidden कम अनुमतियों की वजह से अनुरोध की गई एक या ज़्यादा टिप्पणी थ्रेड को नहीं पाया जा सकता. हो सकता है कि अनुरोध को सही तरीके से अनुमति न दी गई हो.
notFound (404) channelNotFound channelId या allThreadsRelatedToChannelId पैरामीटर से पहचाना गया चैनल नहीं मिला.
notFound (404) commentThreadNotFound बताई गई एक या ज़्यादा टिप्पणी थ्रेड नहीं मिली. अनुरोध के id पैरामीटर की वैल्यू देखकर पक्का करें कि वह सही है.
notFound (404) videoNotFound videoId पैरामीटर से पहचाना गया वीडियो नहीं मिला.

इसे आज़माएं!

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