Kami memperbarui Data API agar sesuai dengan cara YouTube menghitung penayangan untuk Shorts.
Pelajari lebih lanjut
ChannelBanners
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Resource channelBanner berisi URL yang akan Anda gunakan untuk menetapkan gambar yang baru diupload sebagai gambar banner untuk channel.
Metode
API ini mendukung metode berikut untuk resource channelBanners:
- insert
- Mengupload gambar banner channel ke YouTube. Metode ini mewakili dua langkah pertama dalam proses tiga langkah untuk memperbarui gambar banner channel:
- Panggil metode
channelBanners.insert untuk mengupload data gambar biner ke YouTube. Gambar harus memiliki rasio lebar tinggi 16:9 dan berukuran minimal 2048x1152 piksel. Sebaiknya upload gambar berukuran 2560x1440 piksel. - Ekstrak nilai properti
url dari respons yang ditampilkan API untuk langkah 1. - Panggil metode
channels.update untuk memperbarui setelan branding channel. Tetapkan nilai properti brandingSettings.image.bannerExternalUrl ke URL yang diperoleh di langkah 2.
Representasi resource
Struktur JSON berikut menunjukkan format resource channelBanners:
{
"kind": "youtube#channelBannerResource",
"etag": etag,
"url": string
}
Properti
Tabel berikut menentukan properti yang muncul dalam resource ini:
| Properti |
kind |
string
Mengidentifikasi jenis resource API. Nilainya akan menjadi youtube#channelBannerResource. |
etag |
etag
Etag resource ini. |
url |
string
URL gambar banner. Setelah memanggil metode channelBanners.insert, ekstrak nilai ini dari respons API. Kemudian, panggil metode channels.update, dan tetapkan URL sebagai nilai properti brandingSettings.image.bannerExternalUrl untuk menetapkan gambar banner untuk channel. |
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-21 UTC.
[null,null,["Terakhir diperbarui pada 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. |"]]
