ChannelBanners

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

שיטות

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

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

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