ChannelBanners

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

Methods

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

insert
העלאת תמונה של באנר הערוץ ל-YouTube. השיטה הזו מייצגת את שני השלבים הראשונים בתהליך בן שלושה שלבים לעדכון תמונת הבאנר של הערוץ:
  1. קוראים לשיטה channelBanners.insert כדי להעלות את נתוני התמונה הבינארית ל-YouTube. התמונה צריכה להיות ביחס גובה-רוחב של 16:9 ובגודל ‎2048x1152 פיקסלים לפחות. מומלץ להעלות תמונה בגודל 2560px על 1440px.
  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
ה-Etag של המשאב הזה.
url string
כתובת ה-URL של תמונת הבאנר. אחרי שמפעילים את השיטה channelBanners.insert, מחלצים את הערך הזה מתשובת ה-API. לאחר מכן, קוראים ל-method‏ channels.update ומגדירים את כתובת ה-URL כערך של המאפיין brandingSettings.image.bannerExternalUrl כדי להגדיר את תמונת הבאנר של הערוץ.