PlaylistImages: update

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

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

درخواست

درخواست 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» به مالک محتوای مشخص‌شده پیوند داده شود.

متن درخواست

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

برای آن منبع:

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

    • snippet.playlistId
    • snippet.type

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

    • snippet.width
    • snippet.height

پاسخ

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