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 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 के अनुरोध पैरामीटर का इस्तेमाल करके, उस टिप्पणी की पहचान करनी होगी जिसके जवाब वापस पाने हैं.