ChannelBanners: insert
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
מעלה תמונת באנר של הערוץ ל-YouTube. השיטה הזו מייצגת את שני השלבים הראשונים בתהליך בן שלושה שלבים לעדכון תמונת הבאנר של הערוץ:
- קוראים לשיטה
channelBanners.insert כדי להעלות את נתוני התמונה הבינארית ל-YouTube. התמונה צריכה להיות ביחס גובה-רוחב של 16:9 ובגודל 2048x1152 פיקסלים לפחות. מומלץ להעלות תמונה בגודל 2560px על 1440px. - מחלצים את הערך של המאפיין
url מהתגובה שה-API מחזיר בשלב 1. - כדי לעדכן את הגדרות המיתוג של הערוץ, צריך להפעיל את השיטה
channels.update. מגדירים את הערך של המאפיין brandingSettings.image.bannerExternalUrl לכתובת ה-URL שהתקבלה בשלב 2.
השיטה הזו תומכת בהעלאת מדיה. הקבצים שהועלו צריכים לעמוד במגבלות הבאות:
- גודל קובץ מקסימלי: 6MB
- סוגי MIME מקובלים של מדיה:
image/jpeg, image/png, application/octet-stream
השפעה על המכסה: קריאה לשיטה הזו מחייבת עלות מכסה של 50 יחידות.
בקשה
בקשת HTTP
POST https://www.googleapis.com/upload/youtube/v3/channelBanners/insert
אישור
הבקשה הזו דורשת הרשאה עם לפחות אחד מההיקפים הבאים. למידע נוסף על אימות והרשאה, קראו את המאמר הטמעת הרשאה של OAuth 2.0.
| היקף |
|---|
https://www.googleapis.com/auth/youtube.upload |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
פרמטרים
בטבלה הבאה מפורטים הפרמטרים שהשאילתה הזו תומכת בהם. כל הפרמטרים שמפורטים הם פרמטרים של שאילתות.
| פרמטרים |
| פרמטרים אופציונליים |
onBehalfOfContentOwner |
string
אפשר להשתמש בפרמטר הזה רק בבקשה מורשית.
הערה: הפרמטר הזה מיועד אך ורק לשותפי תוכן של YouTube.
הפרמטר onBehalfOfContentOwner מציין שפרטי הכניסה של הבקשה מזהים משתמש במערכת ניהול התוכן של YouTube שפועל בשם בעלי התוכן שצוין בערך הפרמטר. הפרמטר הזה מיועד לשותפי תוכן ב-YouTube שיש להם בעלות על ערוצי YouTube רבים ושהם מנהלים אותם. היא מאפשרת לבעלי תוכן לבצע אימות פעם אחת ולקבל גישה לכל נתוני הסרטונים והערוצים שלהם, בלי לספק פרטי כניסה לכל ערוץ בנפרד. חשבון ה-CMS שבו המשתמש מבצע אימות חייב להיות מקושר לבעלי התוכן שצוין ב-YouTube. |
גוף הבקשה
אין לספק גוף בקשה בקריאה ל-method הזה.
תשובה
אם הפעולה בוצעה ללא שגיאות, ה-method מחזיר משאב channelBanner בגוף התגובה.
שגיאות
בטבלה הבאה מפורטות הודעות השגיאה שיכולות להופיע בתגובה לקריאה לשיטה הזו. פרטים נוספים זמינים במאמר YouTube Data API – שגיאות.
| סוג השגיאה |
פרטי השגיאה |
תיאור |
badRequest (400) |
bannerAlbumFull |
יש יותר מדי תמונות באלבום של עיצוב הערוץ ב-YouTube. כדי לפתור את הבעיה, עוברים ל-Google Photos, עוברים לדף האלבומים ומסירים כמה תמונות מהאלבום הזה. |
badRequest (400) |
mediaBodyRequired |
הבקשה לא כוללת את תוכן התמונה. |
נסה בעצמך!
משתמשים ב-APIs Explorer כדי לקרוא ל-API הזה ולראות את הבקשה ואת התשובה של ה-API.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2024-12-21 (שעון UTC).
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2024-12-21 (שעון UTC)."],[[["\u003cp\u003eThis method allows you to upload a channel banner image to YouTube, which is the initial stage of a three-step process for updating a channel's banner image.\u003c/p\u003e\n"],["\u003cp\u003eThe image uploaded must adhere to specific constraints, requiring a 16:9 aspect ratio, a minimum resolution of 2048x1152 pixels (recommended 2560x1440), a maximum file size of 6MB, and supported MIME types including \u003ccode\u003eimage/jpeg\u003c/code\u003e, \u003ccode\u003eimage/png\u003c/code\u003e, and \u003ccode\u003eapplication/octet-stream\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAfter uploading the image, you need to extract the URL from the API response and use it in the \u003ccode\u003echannels.update\u003c/code\u003e method to set the channel's \u003ccode\u003ebannerExternalUrl\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eUtilizing this API method will incur a quota cost of 50 units, and it necessitates authorization with one of the specified scopes: \u003ccode\u003ehttps://www.googleapis.com/auth/youtube.upload\u003c/code\u003e, \u003ccode\u003ehttps://www.googleapis.com/auth/youtube\u003c/code\u003e, or \u003ccode\u003ehttps://www.googleapis.com/auth/youtube.force-ssl\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe content owner can use the \u003ccode\u003eonBehalfOfContentOwner\u003c/code\u003e optional parameter to make the request, by authenticating with their CMS account, allowing to manage multiple channels.\u003c/p\u003e\n"]]],["To update a YouTube channel banner, first, use the `channelBanners.insert` method to upload a 16:9 aspect ratio image (at least 2048x1152 pixels, recommended 2560x1440px). The image file must be under 6MB and of `image/jpeg`, `image/png`, or `application/octet-stream` type. Then, extract the image URL from the API response. Finally, use the `channels.update` method to set the `brandingSettings.image.bannerExternalUrl` to the extracted URL. This method has a quota cost of 50 units.\n"],null,[]]
