CommentThreads: insert

एक नई शीर्ष-स्तरीय टिप्पणी बनाता है. मौजूदा टिप्पणी का जवाब देने के लिए, comments.insert के तरीके का इस्तेमाल करें.

कोटा असर: इस तरीके को कॉल करने पर कोटा लागत 50 यूनिट हो जाती है.

इस्तेमाल के सामान्य उदाहरण

अनुरोध करें

एचटीटीपी अनुरोध

POST https://www.googleapis.com/youtube/v3/commentThreads

अनुमति दें

इस अनुरोध के लिए, इनमें से कम से कम एक दायरे की अनुमति लेना ज़रूरी है. पुष्टि करने और अनुमति देने के बारे में ज़्यादा जानें.

दायरा
https://www.googleapis.com/auth/youtube.force-ssl

पैरामीटर

इस टेबल में ऐसे पैरामीटर दिए गए हैं जो क्वेरी के साथ काम करते हैं. सूची में दिए गए सभी पैरामीटर, क्वेरी पैरामीटर हैं.

पैरामीटर
ज़रूरी पैरामीटर
part string
part पैरामीटर उन प्रॉपर्टी की पहचान करता है जिन्हें एपीआई रिस्पॉन्स में शामिल किया जाएगा. पैरामीटर वैल्यू को snippet पर सेट करें. snippet वाले हिस्से में कोटा यूनिट की कीमत दो होती है.

नीचे दी गई सूची में part नाम शामिल हैं, जिन्हें आप पैरामीटर की वैल्यू में शामिल कर सकते हैं:
  • id
  • replies
  • snippet

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में टिप्पणी थ्रेड रिसॉर्स उपलब्ध कराएं. उस संसाधन के लिए:

  • आपको इन प्रॉपर्टी के लिए एक मान तय करना होगा:

    • snippet.channelId
    • snippet.topLevelComment.snippet.textOriginal

  • आपके पास इन प्रॉपर्टी के लिए वैल्यू सेट करने का विकल्प है:

    • snippet.channelId
    • snippet.videoId
    • snippet.topLevelComment.snippet.textOriginal

जवाब

अगर यह तरीका काम करता है, तो रिस्पॉन्स के मुख्य भाग में commentThread संसाधन मिलता है.

गड़बड़ियां

इस टेबल में उन गड़बड़ी के मैसेज के बारे में बताया गया है जो इस तरीके से कॉल करने पर एपीआई मिल सकता है. ज़्यादा जानकारी के लिए, कृपया गड़बड़ी का मैसेज दस्तावेज़ देखें.

गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा
badRequest (400) channelOrVideoIdMissing टिप्पणी का हर थ्रेड किसी चैनल या वीडियो से जुड़ा होना चाहिए.
  • अगर टिप्पणी किसी चैनल पर लागू होती है, तो पक्का करें कि अनुरोध के मुख्य हिस्से में बताया गया संसाधन snippet.channelId प्रॉपर्टी के लिए सही हो. किसी चैनल पर लागू होने वाली एक टिप्पणी, चैनल के चर्चा टैब में दिखती है.
  • अगर टिप्पणी किसी वीडियो पर लागू होती है, तो पक्का करें कि रिसॉर्स, snippet.channelId और snippet.videoId, दोनों प्रॉपर्टी के लिए वैल्यू बताता हो. वीडियो पर लागू होने वाली कोई टिप्पणी, वीडियो के वॉच पेज पर दिखती है.
badRequest (400) commentTextRequired शामिल किए जा रहे comment रिसॉर्स में, snippet.topLevelComment.snippet.textOriginal प्रॉपर्टी के लिए एक वैल्यू तय की जानी चाहिए. टिप्पणियां खाली नहीं हो सकतीं.
badRequest (400) commentTextTooLong comment संसाधन का इस्तेमाल किया जा रहा है. इसमें snippet.topLevelComment.snippet.textOriginal प्रॉपर्टी में बहुत ज़्यादा वर्ण शामिल हैं.
badRequest (400) invalidCommentThreadMetadata अनुरोध का मेटाडेटा अमान्य है.
badRequest (400) processingFailure एपीआई सर्वर अनुरोध को पूरा नहीं कर सका. हालांकि यह कोई अस्थायी गड़बड़ी हो सकती है, लेकिन आम तौर पर यह बताती है कि अनुरोध का इनपुट गलत है. अनुरोध के मुख्य भाग में commentThread संसाधन के स्ट्रक्चर की जांच करें, ताकि यह पक्का हो सके कि वह मान्य है.
forbidden (403) forbidden कम अनुमति की वजह से टिप्पणी की थ्रेड नहीं बनाई जा सकी. हो सकता है कि अनुरोध को सही तरीके से अनुमति न दी गई हो.
forbidden (403) ineligibleAccount एपीआई अनुरोध को अनुमति देने के लिए इस्तेमाल किया जाने वाला YouTube खाता, टिप्पणी या टिप्पणी की थ्रेड डालने के लिए उपयोगकर्ता के Google खाते के साथ मर्ज किया जाना चाहिए.
notFound (404) channelNotFound बताया गया चैनल नहीं मिला. snippet.channelId प्रॉपर्टी की वैल्यू की जांच करके, पक्का करें कि वह सही है.
notFound (404) videoNotFound बताया गया वीडियो नहीं मिला. snippet.videoId प्रॉपर्टी की वैल्यू की जांच करके, पक्का करें कि वह सही है.

इसे आज़माएं!

इस एपीआई को कॉल करने और एपीआई का अनुरोध और जवाब देखने के लिए, APIs Explorer का इस्तेमाल करें.