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 का इस्तेमाल करें.