PlaylistImages: update

تصویر لیست پخش را تغییر می دهد.

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

درخواست کنید

درخواست HTTP 

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

مجوز

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

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

پارامترها

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

پارامترها
پارامترهای مورد نیاز
part string

پارامتر part یک لیست جدا شده با کاما از یک یا چند ویژگی منبع playlistImage را مشخص می کند که پاسخ API شامل آن می شود.

اگر پارامتر خاصیتی را مشخص کند که حاوی ویژگی های فرزند است، ویژگی های فرزند در پاسخ گنجانده می شود.

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

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

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

درخواست بدن

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

برای آن منبع:

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

    • snippet.playlistId
    • snippet.type

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

    • snippet.width
    • snippet.height

پاسخ

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

،

تصویر لیست پخش را تغییر می دهد.

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

درخواست کنید

درخواست HTTP 

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

مجوز

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

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

پارامترها

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

پارامترها
پارامترهای مورد نیاز
part string

پارامتر part یک لیست جدا شده با کاما از یک یا چند ویژگی منبع playlistImage را مشخص می کند که پاسخ API شامل آن می شود.

اگر پارامتر خاصیتی را مشخص کند که حاوی ویژگی های فرزند است، ویژگی های فرزند در پاسخ گنجانده می شود.

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

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

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

درخواست بدن

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

برای آن منبع:

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

    • snippet.playlistId
    • snippet.type

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

    • snippet.width
    • snippet.height

پاسخ

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