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