Comments

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

तरीके

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

list
एपीआई के अनुरोध पैरामीटर से मेल खाने वाली टिप्पणियों की सूची दिखाता है. इसे अभी आज़माएं.
शामिल करें
किसी मौजूदा टिप्पणी का जवाब देता है. ध्यान दें: टॉप-लेवल की टिप्पणी बनाने के लिए, commentThreads.insert तरीके का इस्तेमाल करें. इसे अभी आज़माएं.
अपडेट करें
किसी टिप्पणी में बदलाव करता है. इसे अभी आज़माएं.
मिटाएं
किसी टिप्पणी को मिटाता है. इसे अभी आज़माएं.
setModerationStatus
एक या उससे ज़्यादा टिप्पणियों के लिए, मॉडरेशन का स्टेटस सेट करता है. टिप्पणियों से जुड़े चैनल या वीडियो के मालिक को एपीआई अनुरोध की अनुमति देनी होगी. इसे अभी आज़माएं.
markAsSpam
ध्यान दें: यह तरीका अब काम नहीं करता.
इसमें कॉलर का यह मत ज़ाहिर किया गया है कि एक या उससे ज़्यादा टिप्पणियों को स्पैम के तौर पर फ़्लैग किया जाना चाहिए.

संसाधन का प्रतिनिधित्व

यहां दिया गया 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 फ़ॉर्मैट में बताया गया है.