लागू करने का तरीका: टिप्पणियां

comments.markAsSpam का तरीका अब काम नहीं करता.

यहां दिए गए उदाहरणों में बताया गया है कि टिप्पणियों से जुड़े फ़ंक्शन के लिए, YouTube Data API (v3) का इस्तेमाल कैसे किया जाए.

वीडियो पर की गई टिप्पणियां वापस पाना

किसी वीडियो के लिए टिप्पणी की थ्रेड की सूची पाने के लिए, commentThreads.list तरीके को कॉल करें. अपने अनुरोध में, नीचे दिए गए पैरामीटर वैल्यू सेट करें:

  • part: अगर आपको सिर्फ़ टॉप लेवल की टिप्पणियों को फिर से पाना है, तो पैरामीटर वैल्यू को snippet पर सेट करें. इसके अलावा, अगर टॉप लेवल की टिप्पणियों के जवाब भी वापस पाने हैं, तो पैरामीटर वैल्यू को snippet,replies पर सेट करें. (ध्यान दें, यह ज़रूरी नहीं है कि commentThread संसाधन में किसी टिप्पणी के सभी जवाब शामिल हों. अगर आपको किसी खास टिप्पणी के सभी जवाब वापस पाने हैं, तो आपको comments.list का तरीका इस्तेमाल करना होगा.)

  • videoId: उस वीडियो का YouTube वीडियो आईडी बताएं जिसके लिए आप टिप्पणियां पाना चाहते हैं.

नीचे दिए गए अनुरोध में, 2014 में Google I/O कॉन्फ़्रेंस में हुए अहम भाषण के वीडियो से जुड़ी टिप्पणियां और टिप्पणियों के जवाब शामिल किए गए हैं. इस भाषण का वीडियो आईडी wtLJPvx7-ys है.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.commentThreads.list?
part=snippet,replies
&videoId=wtLJPvx7-ys

चैनल के बारे में या उससे जुड़ी टिप्पणियों को वापस पाना

यह एपीआई किसी चैनल के बारे में की गई टिप्पणियों की थ्रेड वापस पाने या चैनल से जुड़ी सभी टिप्पणी की थ्रेड वापस पाने की सुविधा देता है. बाद के मामले में, एपीआई में चैनल या चैनल के किसी भी वीडियो के बारे में टिप्पणियां शामिल हो सकती हैं.

नीचे दिया गया अनुरोध, GoogleDevelopers YouTube चैनल से जुड़ी सभी टिप्पणी की थ्रेड वापस लाता है:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.commentThreads.list?
part=snippet,replies
&allThreadsRelatedToChannelId=UC_x5XG1OV2P6uZZ5FSM9Ttw

टिप्पणी जोड़ना

किसी चैनल या वीडियो पर नई और सबसे बेहतर टिप्पणी जोड़ने के लिए, commentThreads.insert वाले तरीके को कॉल करें. अनुरोध के part पैरामीटर की वैल्यू को snippet पर सेट करें. अनुरोध का मुख्य हिस्सा commentThread resource है, जिसमें snippet.topLevelComment[].snippet[].textOriginal प्रॉपर्टी में टिप्पणी का टेक्स्ट शामिल होता है. इस अनुरोध को OAuth 2.0 का इस्तेमाल करके अनुमति दी जानी चाहिए.

  • किसी चैनल पर टिप्पणी जोड़ने के लिए, snippet.channelId प्रॉपर्टी का इस्तेमाल करके चैनल की पहचान करें.
  • किसी वीडियो पर टिप्पणी जोड़ने के लिए, snippet.channelId प्रॉपर्टी का इस्तेमाल करके, उस चैनल की पहचान करें जिसने वीडियो अपलोड किया है. वीडियो की पहचान के लिए, snippet.videoId प्रॉपर्टी का भी इस्तेमाल करें.

नीचे दिए गए अनुरोध का उदाहरण, वीडियो में टिप्पणी जोड़ता है.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.commentThreads.insert?
part=snippet

अनुरोध नीचे दिखाए गए संसाधन को शामिल करता है.

{
 "snippet": {
  "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
  "topLevelComment": {
   "snippet": {
    "textOriginal": "This video is awesome!"
   }
  },
  "videoId": "MILSirUni5E"
 }
}

किसी टिप्पणी का जवाब देना

किसी टिप्पणी का जवाब देने के लिए, comments.insert वाले तरीके को कॉल करें. अनुरोध के part पैरामीटर की वैल्यू को snippet पर सेट करें. अनुरोध का मुख्य हिस्सा comment resource है, जिसमें snippet.textOriginal प्रॉपर्टी में टिप्पणी का टेक्स्ट शामिल होता है. snippet.parentId प्रॉपर्टी, जवाब से जुड़ी टिप्पणी की पहचान करती है और इसकी वैल्यू commentThread resource's ID होती है. इस अनुरोध को OAuth 2.0 का इस्तेमाल करके अनुमति दी जानी चाहिए.

नीचे दिए गए अनुरोध का उदाहरण किसी मौजूदा टिप्पणी का जवाब देता है.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.comments.insert?
part=snippet

अनुरोध नीचे दिखाए गए संसाधन को शामिल करता है. एपीआई एक्सप्लोरर में अनुरोध पूरा करने के लिए, snippet.parentId प्रॉपर्टी की वैल्यू का इस्तेमाल करें, ताकि जवाब से जुड़ी टॉप-लेवल टिप्पणी की पहचान की जा सके. commentThread संसाधन में, snippet.topLevelComment[].id प्रॉपर्टी संसाधन के यूनीक आईडी के बारे में बताती है.

{
  "snippet": {
    "parentId": "COMMENT_THREAD_ID",
    "textOriginal": "That is true."
  }
}

सबसे ऊपर के लेवल पर की गई टिप्पणी या टिप्पणी का जवाब अपडेट करें

किसी टॉप लेवल की टिप्पणी या किसी टॉप लेवल की टिप्पणी का जवाब देने के लिए, comments.update वाले तरीके को कॉल करें. part पैरामीटर की वैल्यू को snippet पर सेट करें. अनुरोध के मुख्य हिस्से में, id प्रॉपर्टी उस टिप्पणी की पहचान करती है जिसमें बदलाव किया जा रहा है. साथ ही, यह प्रॉपर्टी नई टिप्पणी की पहचान करती है.

  • commentThread संसाधन में, जो टॉप लेवल टिप्पणी की पहचान करता है, snippet.topLevelComment[].id प्रॉपर्टी टिप्पणी के यूनीक आईडी के बारे में बताती है.
  • comment संसाधन में, जो किसी टॉप लेवल की टिप्पणी या किसी टिप्पणी के जवाब की पहचान कर सकता है, id प्रॉपर्टी में उस टिप्पणी के यूनीक आईडी के बारे में बताया जाता है.

नीचे दिया गया सैंपल अनुरोध, मौजूदा टिप्पणी के टेक्स्ट को अपडेट करता है.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.comments.update?
part=snippet

अनुरोध के मुख्य हिस्से में, नीचे दिखाया गया JSON स्निपेट शामिल है. एपीआई एक्सप्लोरर में अनुरोध पूरा करने के लिए, id प्रॉपर्टी की वैल्यू सेट करें, ताकि उस टिप्पणी की पहचान की जा सके जिसे अपडेट किया जा रहा है. टिप्पणी करने वाले व्यक्ति से, अनुरोध की अनुमति मिलनी चाहिए.

{
  "id": "COMMENT_ID",
  "snippet": {
    "textOriginal": "That is true."
  }
}

किसी टिप्पणी को मॉडरेट करने की स्थिति सेट करना

किसी टिप्पणी को मॉडरेट करने की स्थिति सेट करने के लिए, comments.setModerationStatus वाले तरीके को कॉल करें. इस कार्रवाई का इस्तेमाल तब किया जाता है, जब चैनल का मालिक, चैनल या चैनल के वीडियो पर टिप्पणियां मॉडरेट करता है.

इस तरीके को कॉल करते समय, टिप्पणी की पहचान करने के लिए id पैरामीटर की वैल्यू सेट करें. साथ ही, moderationStatus पैरामीटर को पसंद के स्टेटस पर सेट करें. टिप्पणी की स्थिति में बदलाव, सिर्फ़ उस चैनल का मालिक कर सकता है जहां टिप्पणी दिखती है.

  • पहला चरण: उन टिप्पणियों को वापस लाना जिन्हें समीक्षा के लिए रोका गया है

    चैनल या वीडियो पर की गई टिप्पणियां वापस पाने के लिए, commentThreads.list वाले तरीके को कॉल करें. moderationStatus पैरामीटर की वैल्यू को heldForReview पर सेट करें. एपीआई की मदद से मिले रिस्पॉन्स का इस्तेमाल, टिप्पणियों की सूची दिखाने के लिए किया जा सकता है. इसमें, चैनल के मालिक के पास हर टिप्पणी को पब्लिश या अस्वीकार करने का विकल्प होता है.

  • दूसरा चरण: किसी टिप्पणी की समीक्षा का स्टेटस अपडेट करना

    टिप्पणी की स्थिति अपडेट करने के लिए, comments.setModerationStatus वाले तरीके को कॉल करें. टिप्पणी का यूनीक आईडी बताने के लिए, id पैरामीटर की वैल्यू इस्तेमाल करें. moderationStatus पैरामीटर को published या rejected पर सेट करें. अगर किसी टिप्पणी को अस्वीकार किया जा रहा है, तो banAuthor पैरामीटर को true पर सेट किया जा सकता है. इससे, लेखक को चैनल या वीडियो पर अन्य टिप्पणियां करने से रोका जा सकता है.

ध्यान दें: यह एपीआई अस्वीकार की गई टिप्पणियों की सूची बनाने या उन्हें किसी और तरीके से खोजने का तरीका नहीं देता. हालांकि, अगर अस्वीकार की गई टिप्पणी का यूनीक आईडी पता है, तो आपके पास उसके मॉडरेट करने के स्टेटस को published में बदलने का विकल्प है. साथ ही, किसी टिप्पणी की मॉडरेशन स्थिति को published या rejected पर अपडेट करने के बाद, मॉडरेट करने की स्थिति को वापस heldForReview में नहीं बदला जा सकता.

किसी टिप्पणी को हटाना

इस उदाहरण में टिप्पणी मिटाने का तरीका बताया गया है. उदाहरण में, नीचे दिए गए चरण दिए गए हैं:

  • पहला चरण: टिप्पणी का आईडी वापस पाना

    किसी वीडियो या चैनल से जुड़ी टिप्पणियों की सूची वापस पाने के लिए, ऊपर दिया गया तरीका अपनाएं. याद रखें कि किसी टिप्पणी को सिर्फ़ उसका लेखक मिटा सकता है, इसलिए आपको comment संसाधन की snippet.authorChannelId.value प्रॉपर्टी की वैल्यू की तुलना, पुष्टि किए गए उपयोगकर्ता के चैनल आईडी से करनी होगी. इससे यह पता चलेगा कि उपयोगकर्ता उस टिप्पणी को मिटा सकता है या नहीं.

  • दूसरा चरण: टिप्पणी या टिप्पणी की थ्रेड मिटाना

    जिस टिप्पणी थ्रेड या टिप्पणी को मिटाया जा रहा है उसके आईडी की पहचान कर लेने के बाद, उसे मिटाने के लिए comments.delete का इस्तेमाल करें. मिटाए जा रहे टिप्पणी आईडी या टिप्पणी के थ्रेड आईडी की पहचान करने के लिए, id पैरामीटर वैल्यू का इस्तेमाल करें. अनुरोध को OAuth 2.0 का इस्तेमाल करके अनुमति दी जानी चाहिए. अगर एपीआई एक्सप्लोरर में इस क्वेरी की जांच की जा रही है, तो आपको नीचे दिए गए अनुरोध में, id पैरामीटर वैल्यू के लिए मान्य टिप्पणी आईडी या टिप्पणी थ्रेड आईडी बदलना होगा.

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.comments.delete?
id=COMMENT_ID