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

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

अनुरोध, नीचे दिखाया गया संसाधन डालता है. APIs Explorer में अनुरोध को लागू करने के लिए, जवाब से जुड़ी टॉप-लेवल टिप्पणी की पहचान करने के लिए, 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