commentThread
के संसाधन में, YouTube पर की गई टिप्पणी की थ्रेड के बारे में जानकारी होती है. इसमें एक टॉप लेवल की टिप्पणी और उस टिप्पणी पर दिए गए जवाब (अगर कोई मौजूद हो) शामिल होते हैं. commentThread
संसाधन किसी वीडियो पर की गई टिप्पणियों को दिखाता है.
टॉप लेवल की टिप्पणी और उस पर दिए गए जवाब, दोनों ही comment
संसाधन होते हैं, जो commentThread
संसाधन में नेस्ट किए गए होते हैं. यह ज़रूरी नहीं है कि 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 अनुरोध पैरामीटर का इस्तेमाल करके उस टिप्पणी की पहचान करनी होगी जिसके लिए आपको जवाब वापस पाने हैं. |