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 इस संसाधन का ईटैग.
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 फ़ॉर्मैट में होती है.