משאב channelBanner
מכיל את כתובת ה-URL שבה תשתמש כדי להגדיר תמונה חדשה שהעלית בתור תמונת הבאנר של הערוץ.
שיטות
ה-API תומך בשיטות הבאות עבור משאבי channelBanners
:
- הוספה
- המערכת מעלה תמונת באנר של הערוץ ל-YouTube. שיטה זו מייצגת את שני השלבים הראשונים בתהליך בן שלושה שלבים לעדכון תמונת הבאנר של ערוץ:
- צריך להתקשר לשיטה
channelBanners.insert
כדי להעלות את נתוני התמונה הבינארית ל-YouTube. התמונה צריכה להיות ביחס גובה-רוחב של 16:9 ובגודל 2,048x1,152 פיקסלים לפחות. מומלץ להעלות תמונה בגודל 2560 על 1440 פיקסלים. - יש לחלץ את הערך של הנכס
url
מהתגובה שה-API מחזיר לשלב 1. - צריך להפעיל שיטה של
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 כדי להגדיר את תמונת הבאנר של הערוץ. |