इस पेज का अनुवाद Cloud Translation API से किया गया है.

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