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

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

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