CommentThreads: insert

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

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

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

درخواست

درخواست HTTP

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

پاسخ

اگر موفقیت‌آمیز باشد، این روش یک منبع رشته نظر در بدنه پاسخ برمی‌گرداند.

خطاها

جدول زیر پیام‌های خطایی را که ممکن است API در پاسخ به فراخوانی این روش برگرداند، مشخص می‌کند. برای جزئیات بیشتر، به مستندات پیام خطا مراجعه کنید.

نوع خطا جزئیات خطا شرح
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 استفاده‌شده برای مجاز کردن درخواست API باید با «حساب Google» کاربر ادغام شود تا بتواند نظر یا رشته نظر درج کند.
notFound (404) channelNotFound کانال مشخص‌شده پیدا نشد. مقدار ویژگی snippet.channelId را بررسی کنید تا مطمئن شوید درست است.
notFound (404) videoNotFound ویدیو مشخص‌شده پیدا نشد. مقدار ویژگی snippet.videoId را بررسی کنید تا مطمئن شوید درست است.

امتحان کنید!

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