Comments: insert

मौजूदा टिप्पणी का जवाब बनाता है. ध्यान दें: टॉप-लेवल टिप्पणी बनाने के लिए, commentThreads.insert तरीके का इस्तेमाल करें.

कोटे पर असर: इस तरीके को कॉल करने पर, कोटे की 50 यूनिट खर्च होती हैं.

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

अनुरोध

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

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

अनुमति देना

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

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

पैरामीटर

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

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

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

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

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

  • snippet.textOriginal
  • snippet.parentId

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

  • snippet.textOriginal

जवाब

कामयाब रहने पर, यह तरीका जवाब के मुख्य हिस्से में टिप्पणी का संसाधन दिखाता है.

गड़बड़ियां

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

गड़बड़ी का टाइप	गड़बड़ी की जानकारी	ब्यौरा
badRequest (400)	commentTextRequired	जो comment संसाधन जोड़ा जा रहा है उसमें, snippet.textOriginal प्रॉपर्टी के लिए वैल्यू बताना ज़रूरी है. टिप्पणियां खाली नहीं हो सकतीं.
badRequest (400)	commentTextTooLong	जो comment संसाधन जोड़ा जा रहा है उसमें, snippet.textOriginal प्रॉपर्टी में बहुत ज़्यादा वर्ण शामिल हैं.
badRequest (400)	invalidCustomEmoji	जो comment संसाधन जोड़ा जा रहा है उसमें, अमान्य कस्टम इमोजी शामिल हैं.
badRequest (400)	invalidCommentMetadata	अनुरोध का मेटाडेटा अमान्य है.
badRequest (400)	operationNotSupported	एपीआई का उपयोगकर्ता, snippet.parentId प्रॉपर्टी से पहचानी गई टॉप-लेवल टिप्पणी के जवाब में, कोई टिप्पणी नहीं जोड़ सकता. commentThread संसाधन में, snippet.canReply प्रॉपर्टी से पता चलता है कि मौजूदा दर्शक थ्रेड का जवाब दे सकता है या नहीं.
badRequest (400)	parentCommentIsPrivate	बताई गई पैरंट टिप्पणी निजी है. एपीआई, निजी टिप्पणियों के जवाब देने की सुविधा नहीं देता.
badRequest (400)	parentIdMissing	जो टिप्पणी जोड़ी जा रही है उसे किसी पैरंट टिप्पणी से लिंक करना ज़रूरी है. हालांकि, एपीआई अनुरोध के मुख्य हिस्से में मौजूद comment संसाधन में, snippet.parentId प्रॉपर्टी के लिए कोई वैल्यू नहीं बताई गई.
badRequest (400)	processingFailure	एपीआई का सर्वर, अनुरोध को सफलतापूर्वक प्रोसेस नहीं कर सका. हालांकि, यह अस्थायी गड़बड़ी हो सकती है. आम तौर पर, इसका मतलब है कि अनुरोध का इनपुट अमान्य है. अनुरोध के मुख्य हिस्से में मौजूद comment संसाधन की संरचना की जांच करें, ताकि यह पक्का किया जा सके कि यह मान्य है.
forbidden (403)	forbidden	ज़रूरी अनुमतियां न होने की वजह से, टिप्पणी नहीं बनाई जा सकती. ऐसा हो सकता है कि अनुरोध को सही तरीके से अनुमति न मिली हो.
forbidden (403)	ineligibleAccount	टिप्पणी या टिप्पणी की थ्रेड जोड़ने के लिए, एपीआई अनुरोध को अनुमति देने के लिए इस्तेमाल किए गए YouTube खाते को उपयोगकर्ता के Google खाते के साथ मर्ज करना ज़रूरी है.
notFound (404)	parentCommentNotFound	बताई गई पैरंट टिप्पणी नहीं मिली. अनुरोध के मुख्य हिस्से में मौजूद snippet.parentId प्रॉपर्टी की वैल्यू की जांच करें, ताकि यह पक्का किया जा सके कि यह सही है.

इसे आज़माएं!

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