Data API'yi, YouTube'un Shorts görüntülemelerini sayma şekliyle eşleşecek şekilde güncelliyoruz.
Daha fazla bilgi
ChannelBanners
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
channelBanner kaynağı, yeni yüklenen bir resmi bir kanalın banner resmi olarak ayarlamak için kullanacağınız URL'yi içerir.
Yöntemler
API, channelBanners kaynakları için aşağıdaki yöntemleri destekler:
- insert
- YouTube'a kanal banner'ı resmi yükler. Bu yöntem, bir kanalın banner resmini güncellemeyle ilgili üç adımlı sürecin ilk iki adımını gösterir:
- İkili görüntü verilerini YouTube'a yüklemek için
channelBanners.insert yöntemini çağırın. Resim en boy oranı 16:9 ve en az 2048x1152 piksel olmalıdır. 2560 piksel x 1440 piksel boyutunda bir resim yüklemenizi öneririz. - 1. adımda API'nin döndürdüğü yanıttan
url mülkünün değerini çıkarın. - Kanalın marka öğelerini güncellemek için
channels.update yöntemini çağırın. brandingSettings.image.bannerExternalUrl mülkünün değerini 2. adımda elde edilen URL olarak ayarlayın.
Kaynak temsili
Aşağıdaki JSON yapısında, channelBanners kaynağının biçimi gösterilmektedir:
{
"kind": "youtube#channelBannerResource",
"etag": etag,
"url": string
}
Özellikler
Aşağıdaki tabloda bu kaynakta görünen özellikler tanımlanmaktadır:
| Özellikler |
kind |
string
API kaynağının türünü tanımlar. Değer youtube#channelBannerResource olur. |
etag |
etag
Bu kaynağın Etag değeri. |
url |
string
Banner resminin URL'si. channelBanners.insert yöntemini çağırdıktan sonra bu değeri API yanıtından ayıklayın. Ardından, bir kanalın banner resmini ayarlamak için channels.update yöntemini çağırın ve URL'yi brandingSettings.image.bannerExternalUrl mülkünün değeri olarak ayarlayın. |
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-21 UTC.
[null,null,["Son güncelleme tarihi: 2025-08-21 UTC."],[[["\u003cp\u003eThe \u003ccode\u003echannelBanner\u003c/code\u003e resource provides the URL needed to set a newly uploaded image as a channel's banner image.\u003c/p\u003e\n"],["\u003cp\u003eUpdating a channel banner image involves a three-step process, starting with uploading the image using the \u003ccode\u003echannelBanners.insert\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eThe uploaded banner image must have a 16:9 aspect ratio and be at least 2048x1152 pixels, with 2560x1440 recommended.\u003c/p\u003e\n"],["\u003cp\u003eAfter uploading, the \u003ccode\u003eurl\u003c/code\u003e property from the API response is extracted, and then used in the \u003ccode\u003echannels.update\u003c/code\u003e method, specifically in the \u003ccode\u003ebrandingSettings.image.bannerExternalUrl\u003c/code\u003e property, to set the banner image.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003echannelBanners\u003c/code\u003e resource contains \u003ccode\u003ekind\u003c/code\u003e, \u003ccode\u003eetag\u003c/code\u003e, and \u003ccode\u003eurl\u003c/code\u003e properties, with the \u003ccode\u003eurl\u003c/code\u003e property holding the banner image's URL.\u003c/p\u003e\n"]]],["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"],null,["# ChannelBanners\n\nA `channelBanner` resource contains the URL that you would use to set a newly uploaded image as the banner image for a channel.\n\nMethods\n-------\n\nThe API supports the following methods for `channelBanners` resources:\n\n[insert](/youtube/v3/docs/channelBanners/insert)\n: Uploads a channel banner image to YouTube. This method represents the first two steps in a three-step process to update the banner image for a channel:\n\n 1. Call the [channelBanners.insert](/youtube/v3/docs/channelBanners/insert) method to upload the binary image data to YouTube. The image must have a 16:9 aspect ratio and be at least 2048x1152 pixels. We recommend uploading a 2560px by 1440px image.\n 2. Extract the `url` property's value from the response that the API returns for step 1.\n 3. Call the [channels.update](/youtube/v3/docs/channels/update) method to update the channel's branding settings. Set the [brandingSettings.image.bannerExternalUrl](/youtube/v3/docs/channels#brandingSettings.image.bannerExternalUrl) property's value to the URL obtained in step 2.\n\nResource representation\n-----------------------\n\nThe following JSON structure shows the format of a `channelBanners` resource: \n\n```text\n{\n \"kind\": \"youtube#channelBannerResource\",\n \"etag\": etag,\n \"url\": string\n}\n```\n\n### Properties\n\nThe following table defines the properties that appear in this resource:\n\n| Properties ||\n|--------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Identifies the API resource's type. The value will be `youtube#channelBannerResource`. |\n| `etag` | `etag` The Etag of this resource. |\n| `url` | `string` The banner image's URL. After calling the [channelBanners.insert](/youtube/v3/docs/channelBanners/insert) method, extract this value from the API response. Then call the [channels.update](/youtube/v3/docs/channels/update) method, and set the URL as the value of the [brandingSettings.image.bannerExternalUrl](/youtube/v3/docs/channels#brandingSettings.image.bannerExternalUrl) property to set the banner image for a channel. |"]]
