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

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

अनुरोध के मुख्य हिस्से में, commentThread संसाधन उपलब्ध कराएं.

इस संसाधन के लिए, आपको नीचे दी गई प्रॉपर्टी के लिए एक वैल्यू तय करनी होगी:

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

जवाब

अगर यह तरीका काम करता है, तो जवाब के मुख्य हिस्से में commentThread संसाधन दिखाए जाते हैं.

गड़बड़ियां

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

गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा
badRequest (400) channelOrVideoIdMissing टिप्पणी की हर थ्रेड किसी वीडियो से लिंक होनी चाहिए. पक्का करें कि संसाधन में 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 का इस्तेमाल करें. साथ ही, एपीआई अनुरोध और रिस्पॉन्स देखें.