Comments: update

نظری را اصلاح می‌کند.

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

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

درخواست

درخواست HTTP

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

صدور مجوز

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

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

پارامترها

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

پارامترها
پارامترهای الزامی
part string
پارامتر part ویژگی‌هایی را که پاسخ میانای برنامه‌سازی کاربردی دربرخواهد داشت شناسایی می‌کند. باید حداقل بخش snippet را در مقدار پارامتر بگنجانید زیرا این بخش حاوی همه ویژگی‌هایی است که درخواست میانای برنامه‌سازی کاربردی می‌تواند به‌روز کند.

فهرست زیر حاوی نام‌های part است که می‌توانید در مقدار پارامتر بگنجانید:
  • id
  • snippet

متن درخواست

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

  • می‌توانید برای این مشخصات مقدار تنظیم کنید:

    • snippet.textOriginal

پاسخ

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

خطاها

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

نوع خطا جزئیات خطا شرح
badRequest (400) commentTextTooLong منبع comment که درحال به‌روزرسانی است، نویسه‌های بسیار زیادی در ویژگی snippet.textOriginal دارد.
badRequest (400) invalidCommentMetadata فراداده درخواست نامعتبر است.
badRequest (400) operationNotSupported فقط نظرات مبتنی بر Google+‎ را می‌توان به‌روز کرد.
badRequest (400) processingFailure سرور میانای برنامه‌سازی کاربردی نتوانست درخواست را با موفقیت پردازش کند. اگرچه این خطا می‌تواند گذرا باشد، اما معمولاً نشان می‌دهد که ورودی درخواست نامعتبر است. ساختار منبع comment را در بدنه درخواست بررسی کنید تا مطمئن شوید معتبر است.
forbidden (403) forbidden به‌دلیل کافی نبودن اجازه‌ها، نظر به‌روز نشد. ممکن است درخواست به‌درستی مجاز نشده باشد.
forbidden (403) ineligibleAccount حساب YouTube که برای مجاز کردن درخواست API استفاده می‌شود باید با حساب Google کاربر ادغام شود تا نظر یا رشته نظر به‌روز شود.
notFound (404) commentNotFound نظر مشخص‌شده پیدا نشد. مقدار ویژگی id را در بدنه درخواست بررسی کنید تا مطمئن شوید درست است.

امتحان کنید!

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