Comments: insert

پاسخی برای نظر موجود ایجاد می‌کند. توجه: برای ایجاد نظر سطح بالا، از روش commentThreads.insert استفاده کنید.

تأثیر بر سهمیه: تماس با این روش هزینه سهمیه ۵۰ واحدی دارد.

موارد استفاده رایج

درخواست

درخواست HTTP

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 کاربر API نمی‌تواند نظری را در پاسخ به نظر سطح بالا که با ویژگی snippet.parentId شناسایی شده است درج کند. در منبع commentThread، ویژگی snippet.canReply نشان می‌دهد که آیا بیننده فعلی می‌تواند به رشته پاسخ دهد یا نه.
badRequest (400) parentCommentIsPrivate نظر اصلی مشخص‌شده خصوصی است. میانای برنامه‌سازی کاربردی از پاسخ به نظرات خصوصی پشتیبانی نمی‌کند.
badRequest (400) parentIdMissing نظری که درج می‌شود باید به نظر اصلی پیوند داده شود. بااین‌حال، منبع comment در متن درخواست API مقداری برای دارایی snippet.parentId مشخص نکرده است.
badRequest (400) processingFailure سرور میانای برنامه‌سازی کاربردی نتوانست درخواست را با موفقیت پردازش کند. اگرچه این خطا می‌تواند گذرا باشد، اما معمولاً نشان می‌دهد که ورودی درخواست نامعتبر است. ساختار منبع comment را در بدنه درخواست بررسی کنید تا مطمئن شوید معتبر است.
forbidden (403) forbidden به‌دلیل نداشتن اجازه‌های کافی، نظر ایجاد نشد. ممکن است درخواست به‌درستی مجاز نشده باشد.
forbidden (403) ineligibleAccount حساب YouTube که برای مجاز کردن درخواست API استفاده می‌شود باید با حساب Google کاربر ادغام شود تا بتواند نظر یا رشته نظر را درج کند.
notFound (404) parentCommentNotFound نظر اصلی مشخص‌شده پیدا نشد. مقدار ویژگی snippet.parentId را در بدنه درخواست بررسی کنید تا مطمئن شوید درست است.

امتحان کنید!

از APIs Explorer برای فراخوانی این API و دیدن درخواست و پاسخ API استفاده کنید.