CommentThreads: insert

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

تاثیر سهمیه ای: فراخوانی به این روش هزینه سهمیه ای 50 واحدی دارد.

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

درخواست

درخواست HTTP

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

مجوز

این درخواست به مجوز حداقل با یکی از حوزه های زیر نیاز دارد ( در مورد احراز هویت و مجوز بیشتر بخوانید ).

محدوده
https://www.googleapis.com/auth/youtube.force-ssl

مولفه های

جدول زیر پارامترهایی را که این کوئری پشتیبانی می کند فهرست می کند. تمام پارامترهای لیست شده پارامترهای پرس و جو هستند.

مولفه های
پارامترهای مورد نیاز
part string
پارامتر part ویژگی هایی را که پاسخ API شامل می شود مشخص می کند. مقدار پارامتر را روی snippet تنظیم کنید. قسمت snippet دارای هزینه سهمیه ای 2 واحدی می باشد.

لیست زیر شامل نام part است که می توانید در مقدار پارامتر بگنجانید:
  • id
  • replies
  • snippet

درخواست بدن

یک منبع commentThread در بدنه درخواست ارائه دهید. برای آن منبع:

  • شما باید یک مقدار برای این ویژگی ها مشخص کنید:

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

  • شما می توانید مقادیری را برای این ویژگی ها تنظیم کنید:

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

واکنش

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

خطاها

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

نوع خطا جزئیات خطا شرح
badRequest (400) channelOrVideoIdMissing هر رشته نظر باید به یک کانال یا ویدیو پیوند داده شود.
  • اگر نظر برای یک کانال اعمال می شود، مطمئن شوید که منبع مشخص شده در بدنه درخواست مقداری برای ویژگی snippet.channelId ارائه می دهد. نظری که برای یک کانال اعمال می شود در برگه بحث کانال ظاهر می شود.
  • اگر نظر برای یک ویدیو اعمال می‌شود، مطمئن شوید که منبع مقادیری را برای ویژگی‌های 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 سرور API نتوانست درخواست را با موفقیت پردازش کند. در حالی که این می تواند یک خطای گذرا باشد، معمولاً نشان می دهد که ورودی درخواست نامعتبر است. ساختار منبع commentThread را در بدنه درخواست بررسی کنید تا مطمئن شوید که معتبر است.
forbidden (403) forbidden به دلیل مجوزهای ناکافی، موضوع نظر ایجاد نشد. ممکن است درخواست به درستی مجاز نباشد.
forbidden (403) ineligibleAccount حساب YouTube مورد استفاده برای مجوز درخواست API باید با حساب Google کاربر ادغام شود تا یک نظر یا موضوع نظر درج شود.
notFound (404) channelNotFound کانال مشخص شده یافت نشد. مقدار ویژگی snippet.channelId را بررسی کنید تا مطمئن شوید که درست است.
notFound (404) videoNotFound ویدیوی مشخص شده یافت نشد. مقدار ویژگی snippet.videoId را بررسی کنید تا مطمئن شوید که درست است.

آن را امتحان کنید!

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