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