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,
    "imageUrl": string
  }
}

प्रॉपर्टी

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

प्रॉपर्टी
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 चैनल की जानकारी होती है. हालांकि, यह जानकारी सिर्फ़ तब उपलब्ध होती है, जब टिप्पणी करने वाले व्यक्ति ने अपना 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 फ़ॉर्मैट में दी जाती है.
snippet.imageUrl string
अगर टिप्पणी में कोई इमेज या ऐनिमेट किया गया GIF अटैच किया गया है, तो उसका यूआरएल. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब किसी टिप्पणी में कोई इमेज या GIF शामिल हो. यूआरएल को हस्ताक्षर किए गए लिंक के तौर पर दिखाया जाता है. इसे छह घंटे तक इस्तेमाल किया जा सकता है. इसके बाद, यह काम नहीं करता.