Comments: update

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

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

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

درخواست

درخواست HTTP

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

مجوز

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

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

مولفه های

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

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

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

درخواست بدن

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

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

    • snippet.textOriginal

واکنش

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

خطاها

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

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

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

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