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 फ़ॉर्मैट में दी जाती है.