Comments

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

तरीके

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

list

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

insert

मौजूदा टिप्पणी का जवाब बनाता है. ध्यान दें: सबसे ऊपर दिखने वाली टिप्पणी बनाने के लिए, commentThreads.insert तरीके का इस्तेमाल करें. इसे अभी आज़माएं.

अपडेट करें

टिप्पणी में बदलाव करता है. इसे अभी आज़माएं.

मिटाएं

टिप्पणी मिटाता है. इसे अभी आज़माएं.

setModerationStatus

इससे एक या उससे ज़्यादा टिप्पणियों के मॉडरेशन का स्टेटस सेट किया जाता है. एपीआई अनुरोध को उस चैनल या वीडियो के मालिक की अनुमति मिलनी चाहिए जिस पर टिप्पणियां की गई हैं. इसे अभी आज़माएं.

संसाधन का रेप्रज़ेंटेशन

यहां दिए गए JSON स्ट्रक्चर में, comments संसाधन का फ़ॉर्मैट दिखाया गया है:

{
  "kind": "youtube#comment",
  "etag": etag,
  "id": string,
  "snippet": {
    "authorDisplayName": string,
    "authorProfileImageUrl": string,
    "authorChannelUrl": string,
    "authorChannelId": {
      "value": string
    },
    "channelId": string,
    "textDisplay": string,
    "textOriginal": string,
    "parentId": string,
    "canRate": boolean,
    "viewerRating": string,
    "likeCount": unsigned integer,
    "moderationStatus": string,
    "publishedAt": datetime,
    "updatedAt": datetime
  }
}

प्रॉपर्टी

यहां दी गई टेबल में, इस संसाधन में दिखने वाली प्रॉपर्टी के बारे में बताया गया है:

प्रॉपर्टी
kind	string इससे एपीआई संसाधन के टाइप की पहचान होती है. वैल्यू youtube#comment होगी.
etag	etag इस संसाधन का ETag.
id	string यह वह आईडी है जिसका इस्तेमाल YouTube, टिप्पणी की पहचान करने के लिए करता है.
snippet	object snippet ऑब्जेक्ट में टिप्पणी के बारे में बुनियादी जानकारी होती है.
snippet.authorDisplayName	string टिप्पणी पोस्ट करने वाले व्यक्ति का डिसप्ले नेम.
snippet.authorProfileImageUrl	string यह उस व्यक्ति के अवतार का यूआरएल है जिसने टिप्पणी पोस्ट की है.
snippet.authorChannelUrl	string अगर टिप्पणी करने वाले व्यक्ति का YouTube चैनल उपलब्ध है, तो उसका यूआरएल.
snippet.authorChannelId	object अगर टिप्पणी करने वाले व्यक्ति का YouTube चैनल मौजूद है, तो यह ऑब्जेक्ट उसकी जानकारी को कैप्सूल करता है.
snippet.authorChannelId.value	string अगर टिप्पणी लिखने वाले व्यक्ति के YouTube चैनल का आईडी उपलब्ध है, तो उसे यहां दिखाया जाता है.
snippet.channelId	string यह उस YouTube चैनल का आईडी होता है जिस पर टिप्पणी की गई है.
snippet.textDisplay	string टिप्पणी का टेक्स्ट. टेक्स्ट को सादे टेक्स्ट या एचटीएमएल फ़ॉर्मैट में वापस लाया जा सकता है. (comments.list और commentThreads.list, दोनों तरीकों में textFormat पैरामीटर का इस्तेमाल किया जा सकता है. इससे चुने गए टेक्स्ट फ़ॉर्मैट के बारे में पता चलता है.) सादा टेक्स्ट भी, टिप्पणी के ओरिजनल टेक्स्ट से अलग हो सकता है. उदाहरण के लिए, यह वीडियो लिंक की जगह वीडियो के टाइटल दिखा सकता है.
snippet.textOriginal	string टिप्पणी का ओरिजनल टेक्स्ट, जैसा कि उसे पहली बार पोस्ट किया गया था या आखिरी बार अपडेट किया गया था. ओरिजनल टेक्स्ट सिर्फ़ पुष्टि किए गए उपयोगकर्ता को दिखाया जाता है. हालांकि, ऐसा तब होता है, जब वह टिप्पणी का लेखक हो.
snippet.parentId	string पैरंट टिप्पणी का यूनीक आईडी. यह प्रॉपर्टी सिर्फ़ तब सेट की जाती है, जब टिप्पणी को किसी दूसरी टिप्पणी के जवाब के तौर पर सबमिट किया गया हो.
snippet.canRate	boolean इस सेटिंग से पता चलता है कि टिप्पणी देखने वाला मौजूदा व्यक्ति, टिप्पणी को रेटिंग दे सकता है या नहीं.
snippet.viewerRating	string दर्शक ने इस टिप्पणी को जो रेटिंग दी है. इस प्रॉपर्टी से dislike रेटिंग की पहचान नहीं होती. हालांकि, इस तरीके में बदलाव हो सकता है. इस बीच, अगर दर्शक ने टिप्पणी को अच्छी रेटिंग दी है, तो प्रॉपर्टी की वैल्यू like होती है. अन्य सभी मामलों में वैल्यू none होती है. इनमें वे मामले भी शामिल हैं जिनमें उपयोगकर्ता ने टिप्पणी को खराब रेटिंग दी है या टिप्पणी को रेटिंग नहीं दी है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं: like none
snippet.likeCount	unsigned integer टिप्पणी को मिले कुल लाइक (पॉज़िटिव रेटिंग) की संख्या.
snippet.moderationStatus	string टिप्पणी को मॉडरेट करने का स्टेटस. यह प्रॉपर्टी सिर्फ़ तब दिखती है, जब एपीआई अनुरोध को उस चैनल या वीडियो के मालिक ने अनुमति दी हो जिस पर टिप्पणियां करने का अनुरोध किया गया था. अगर एपीआई अनुरोध में id फ़िल्टर पैरामीटर का इस्तेमाल किया गया है, तो यह प्रॉपर्टी सेट नहीं होती है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं: heldForReview likelySpam published rejected
snippet.publishedAt	datetime टिप्पणी को पहली बार पब्लिश करने की तारीख और समय. इसकी वैल्यू ISO 8601 फ़ॉर्मैट में दी जाती है.
snippet.updatedAt	datetime वह तारीख और समय जब टिप्पणी को पिछली बार अपडेट किया गया था. इसकी वैल्यू ISO 8601 फ़ॉर्मैट में दी जाती है.