CommentThreads

commentThread संसाधन में YouTube टिप्पणी थ्रेड के बारे में जानकारी होती है. इसमें उस टिप्पणी के लिए एक टॉप-लेवल टिप्पणी और जवाब (अगर कोई है) शामिल होते हैं. commentThread संसाधन, किसी वीडियो या चैनल की टिप्पणियों को दिखा सकता है.

सबसे ऊपर की टिप्पणी और जवाब, दोनों असल में commentThread संसाधन में मौजूद comment संसाधन हैं. यह ज़रूरी नहीं है कि commentThread संसाधन में किसी टिप्पणी के सभी जवाब शामिल हों. अगर आप किसी खास टिप्पणी के लिए सभी जवाब पाना चाहते हैं, तो आपको comments.list तरीके का इस्तेमाल करना होगा. यह भी ध्यान रखें कि कुछ टिप्पणियों के जवाब नहीं दिए जाते हैं.

तरीके

एपीआई commentThreads रिसॉर्स के लिए, इन तरीकों का इस्तेमाल करता है:

list
यह नीति, एपीआई अनुरोध के पैरामीटर से मेल खाने वाली टिप्पणियों की सूची दिखाती है. इसे अभी आज़माएं.
शामिल करें
एक नई शीर्ष-स्तरीय टिप्पणी बनाता है. मौजूदा टिप्पणी का जवाब देने के लिए, comments.insert के तरीके का इस्तेमाल करें. इसे अभी आज़माएं.

संसाधन का प्रतिनिधित्व

नीचे JSON स्ट्रक्चर में, commentThreads रिसॉर्स का फ़ॉर्मैट दिखता है:

{
  "kind": "youtube#commentThread",
  "etag": etag,
  "id": string,
  "snippet": {
    "channelId": string,
    "videoId": string,
    "topLevelComment": comments Resource,
    "canReply": boolean,
    "totalReplyCount": unsigned integer,
    "isPublic": boolean
  },
  "replies": {
    "comments": [
      comments Resource
    ]
  }
}

प्रॉपर्टी

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

प्रॉपर्टी
kind string
इससे यह पता चलता है कि एपीआई संसाधन किस तरह का है. वैल्यू youtube#commentThread होगी.
etag etag
इस संसाधन का ऐट.
id string
वह आईडी जिसे YouTube, टिप्पणी के थ्रेड को पहचानने के लिए इस्तेमाल करता है.
snippet object
snippet ऑब्जेक्ट में, टिप्पणी के थ्रेड के बारे में बुनियादी जानकारी होती है. इसमें, थ्रेड के सबसे ऊपरी लेवल की टिप्पणी भी शामिल है, जो कि comment रिसॉर्स है.
snippet.channelId string
वह YouTube चैनल जो थ्रेड में की गई टिप्पणियों से जुड़ा है. (snippet.videoId प्रॉपर्टी वीडियो की पहचान करती है.)
  • अगर टिप्पणियां किसी वीडियो के बारे में हैं, तो वैल्यू से उस चैनल की पहचान होती है जिसने वीडियो अपलोड किया है. (snippet.videoId प्रॉपर्टी वीडियो की पहचान करती है.)
  • अगर टिप्पणियां चैनल का संदर्भ देती हैं, तो snippet.videoId प्रॉपर्टी की कोई वैल्यू नहीं होगी.
snippet.videoId string
उस वीडियो का आईडी जिस पर की गई टिप्पणियां मौजूद हैं. अगर यह प्रॉपर्टी मौजूद नहीं है या उसकी कोई वैल्यू नहीं है, तो थ्रेड, चैनल पर लागू होती है, न कि किसी वीडियो पर.
snippet.topLevelComment object
थ्रेड के लिए टॉप-लेवल टिप्पणी. प्रॉपर्टी की वैल्यू एक comment रिसॉर्स है.
snippet.canReply boolean
इस सेटिंग से पता चलता है कि मौजूदा दर्शक, थ्रेड पर जवाब दे सकता है या नहीं.
snippet.totalReplyCount unsigned integer
सबसे ऊपर के लेवल की टिप्पणी के जवाब में सबमिट किए गए जवाबों की कुल संख्या.
snippet.isPublic boolean
इस सेटिंग से पता चलता है कि थ्रेड को YouTube के सभी उपयोगकर्ता देख सकते हैं या नहीं. इसमें, टिप्पणी और टिप्पणी के जवाब भी शामिल हैं.
replies object
replies ऑब्जेक्ट एक कंटेनर होता है, जिसमें टिप्पणी के जवाबों की सूची होती है. replies.comments प्रॉपर्टी से ही टिप्पणियों की सूची दिखती है.
replies.comments[] list
टॉप-लेवल टिप्पणी के एक या उससे ज़्यादा जवाबों की सूची. सूची में मौजूद हर आइटम एक comment संसाधन है.

इस सूची में जवाबों की सीमित संख्या है. अगर सूची में मौजूद आइटम की संख्या, snippet.totalReplyCount प्रॉपर्टी की वैल्यू के बराबर नहीं है, तो जवाबों की सूची में टॉप लेवल की टिप्पणी के लिए उपलब्ध जवाबों की कुल संख्या का सिर्फ़ एक सबसेट है. टॉप-लेवल टिप्पणी के सभी जवाब पाने के लिए, आपको comments.list तरीके पर कॉल करना होगा. इसके बाद, parentId टिप्पणी के पैरामीटर का इस्तेमाल करके, उस टिप्पणी की पहचान करनी होगी जिसके लिए आपको जवाब चाहिए.