ChannelBanners
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Ресурс channelBanner содержит URL-адрес, который вы можете использовать для установки только что загруженного изображения в качестве изображения баннера для канала.
Методы
API поддерживает следующие методы для ресурсов channelBanners :
- insert
- Загружает изображение баннера канала на YouTube. Этот метод представляет собой первые два шага трехэтапного процесса обновления изображения баннера для канала:
- Вызовите
channelBanners.insert , чтобы загрузить данные двоичного изображения на YouTube. Изображение должно иметь соотношение сторон 16:9 и размер не менее 2048x1152 пикселей. Мы рекомендуем загружать изображение размером 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 , чтобы задать изображение баннера для канала. |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-01-05 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"]],["Последнее обновление: 2025-01-05 UTC."],[[["The `channelBanner` resource provides the URL needed to set a newly uploaded image as a channel's banner image."],["Updating a channel banner image involves a three-step process, starting with uploading the image using the `channelBanners.insert` method."],["The uploaded banner image must have a 16:9 aspect ratio and be at least 2048x1152 pixels, with 2560x1440 recommended."],["After uploading, the `url` property from the API response is extracted, and then used in the `channels.update` method, specifically in the `brandingSettings.image.bannerExternalUrl` property, to set the banner image."],["The `channelBanners` resource contains `kind`, `etag`, and `url` properties, with the `url` property holding the banner image's URL."]]],["The `channelBanner` resource provides a URL for setting a channel's banner image. Updating a banner involves three steps: first, use `channelBanners.insert` to upload an image (16:9 aspect ratio, at least 2048x1152 pixels). Second, extract the `url` from the response. Third, use `channels.update`, setting `brandingSettings.image.bannerExternalUrl` to the extracted URL. The resource includes `kind` (`youtube#channelBannerResource`), `etag`, and the banner image's `url`.\n"]]
