ChannelBanners

משאב channelBanner מכיל את כתובת ה-URL שבה תשתמש כדי להגדיר תמונה חדשה שהעלית בתור תמונת הבאנר של הערוץ.

שיטות

ה-API תומך בשיטות הבאות עבור משאבי channelBanners:

הוספה
המערכת מעלה תמונת באנר של הערוץ ל-YouTube. שיטה זו מייצגת את שני השלבים הראשונים בתהליך בן שלושה שלבים לעדכון תמונת הבאנר של ערוץ:

  1. צריך להתקשר לשיטה channelBanners.insert כדי להעלות את נתוני התמונה הבינארית ל-YouTube. התמונה צריכה להיות ביחס גובה-רוחב של 16:9 ובגודל 2,048x1,152 פיקסלים לפחות. מומלץ להעלות תמונה בגודל 2560 על 1440 פיקסלים.
  2. יש לחלץ את הערך של הנכס url מהתגובה שה-API מחזיר לשלב 1.
  3. צריך להפעיל שיטה של channels.update כדי לעדכן את הגדרות המיתוג של הערוץ. מגדירים את הערך של המאפיין brandingSettings.image.bannerExternalUrl לכתובת ה-URL שהתקבלה בשלב 2.

ייצוג משאבים

המבנה הבא של JSON מציג את הפורמט של משאב channelBanners:

{
  "kind": "youtube#channelBannerResource",
  "etag": etag,
  "url": string
}

נכסים

הטבלה הבאה מגדירה את המאפיינים שמופיעים במשאב הזה:

נכסים
kind string
מזהה את סוג המשאב של ה-API. הערך יהיה youtube#channelBannerResource.
etag etag
התג של המשאב הזה.
url string
כתובת ה-URL של תמונת הבאנר. לאחר הקריאה לשיטה channelBanners.insert, יש לחלץ את הערך הזה מתגובת ה-API. לאחר מכן צריך להפעיל את השיטה channels.update, ולהגדיר את כתובת ה-URL כערך של המאפיין brandingSettings.image.bannerExternalUrl כדי להגדיר את תמונת הבאנר של הערוץ.