ChannelSections: update

یک بخش کانال را به روز می کند.

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

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

درخواست

درخواست HTTP

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

مجوز

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

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

مولفه های

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

مولفه های
پارامترهای مورد نیاز
part string
پارامتر part در این عملیات دو هدف را دنبال می کند. ویژگی هایی را که عملیات نوشتن تنظیم می کند و همچنین ویژگی هایی را که پاسخ API شامل می شود شناسایی می کند.

لیست زیر شامل نام part است که می توانید در مقدار پارامتر بگنجانید:
  • contentDetails
  • id
  • snippet
پارامترهای اختیاری
onBehalfOfContentOwner string
این پارامتر فقط در یک درخواست مجاز به درستی قابل استفاده است. توجه: این پارامتر منحصراً برای شرکای محتوای YouTube در نظر گرفته شده است.

پارامتر onBehalfOfContentOwner نشان می دهد که اعتبارنامه مجوز درخواست، کاربر YouTube CMS را شناسایی می کند که از طرف مالک محتوا مشخص شده در مقدار پارامتر عمل می کند. این پارامتر برای شرکای محتوای YouTube در نظر گرفته شده است که کانال‌های مختلف YouTube را مالک و مدیریت می‌کنند. این به صاحبان محتوا امکان می‌دهد یک بار احراز هویت کنند و به تمام داده‌های ویدیویی و کانال خود دسترسی داشته باشند، بدون اینکه نیازی به ارائه اعتبارنامه احراز هویت برای هر کانال جداگانه داشته باشند. حساب CMS که کاربر با آن احراز هویت می‌کند باید به مالک محتوای YouTube مشخص شده مرتبط باشد.

درخواست بدن

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

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

    • snippet.type

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

    • snippet.type
    • snippet.title
    • snippet.position
    • contentDetails.playlists[]
    • contentDetails.channels[]

    اگر درخواست به‌روزرسانی ارسال می‌کنید و درخواست شما مقداری را برای خاصیتی که قبلاً دارای مقدار است مشخص نمی‌کند، مقدار موجود ویژگی حذف می‌شود.

واکنش

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

خطاها

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

نوع خطا جزئیات خطا شرح
badRequest (400) notEditable این بخش کانال قابل ویرایش نیست.
badRequest (400) typeRequired منبع channelSection باید مقداری را برای فیلد snippet.type مشخص کند.
forbidden (403) channelSectionForbidden درخواست به درستی احراز هویت نشده است یا برای این کانال پشتیبانی نمی شود.
invalidValue (400) channelNotActive حداقل یکی از کانال های مشخص شده فعال نیست.
invalidValue (400) channelsDuplicated درخواست ناموفق بود زیرا کانال های تکراری را مشخص کرده بود.
invalidValue (400) channelsNeeded اگر خاصیت snippet.type دارای مقدار multipleChannels باشد، باید ویژگی contentDetails.channels[] مشخص شود و حداقل یک کانال مشخص شود.
invalidValue (400) channelsNotExpected منبع ارائه شده با درخواست، مقداری را برای ویژگی contentDetails.channels[] مشخص کرده است، اما کانال‌هایی برای این نوع بخش کانال انتظار نمی‌رود.
invalidValue (400) contentDetailsNeeded منبعی که به‌روزرسانی می‌کنید باید حاوی یک شی contentDetails برای این نوع بخش کانال باشد.
invalidValue (400) idInvalid ویژگی id شناسه بخش کانال نامعتبر را مشخص می کند.
invalidValue (400) idRequired ویژگی id باید مقداری را مشخص کند که بخش کانال در حال به روز رسانی را مشخص کند.
invalidValue (400) inValidPosition ویژگی snippet.position حاوی یک مقدار نامعتبر است.
invalidValue (400) maxChannelsExceeded درخواست انجام نشد زیرا سعی داشت تعداد زیادی کانال را در بخش کانال قرار دهد.
invalidValue (400) maxPlaylistExceeded این درخواست شکست خورد زیرا سعی داشت تعداد زیادی لیست پخش را در بخش کانال قرار دهد.
invalidValue (400) onePlaylistNeeded اگر ویژگی snippet.type دارای مقدار singlePlaylist باشد، ویژگی contentDetails.playlists[] باید دقیقاً یک لیست پخش را مشخص کند.
invalidValue (400) ownChannelInChannels شما نمی توانید کانال خود را در بخش کانالی که در آن کانال ظاهر می شود قرار دهید.
invalidValue (400) playlistIsPrivate یک یا چند لیست پخش مشخص شده خصوصی هستند و بنابراین نمی توان آنها را در بخش کانال قرار داد.
invalidValue (400) playlistsDuplicated درخواست انجام نشد زیرا لیست های پخش تکراری را مشخص کرده بود.
invalidValue (400) playlistsNeeded اگر ویژگی snippet.type دارای مقدار singlePlaylist یا multiplePlaylists باشد، باید ویژگی contentDetails.playlists[] مشخص شود.
invalidValue (400) playlistsNotExpected منبع ارائه شده همراه با درخواست مقداری را برای ویژگی contentDetails.playlists[] مشخص کرده است، اما لیست های پخش برای این نوع بخش کانال انتظار نمی رود.
invalidValue (400) snippetNeeded برای به روز رسانی بخش کانال باید یک snippet مشخص کنید.
invalidValue (400) titleLengthExceeded مقدار ویژگی snippet.title بسیار طولانی است.
invalidValue (400) titleRequired اگر ویژگی snippet.type دارای مقدار multiplePlaylists یا multipleChannels باشد، باید عنوان بخش را با تعیین مقداری برای ویژگی snippet.title تنظیم کنید.
notFound (404) channelNotFound یک یا چند کانال مشخص شده یافت نمی شود.
notFound (404) channelSectionNotFound بخش کانالی که می‌خواهید به‌روزرسانی کنید پیدا نمی‌شود.
notFound (404) playlistNotFound یک یا چند لیست پخش مشخص شده یافت نمی شود.

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

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