channel
dan video kini juga berisi properti yang mengidentifikasi status "Dibuat untuk Anak-Anak"
dari channel atau video tersebut. Persyaratan Layanan untuk Layanan YouTube API dan Kebijakan Developer
juga diperbarui pada 10 Januari 2020. Untuk mengetahui informasi selengkapnya, lihat histori revisi untuk
Layanan YouTube Data API dan
Persyaratan Layanan untuk Layanan YouTube API.
Resource channel berisi informasi tentang channel YouTube.
Metode
API ini mendukung metode berikut untuk resource channels:
- list
- Menampilkan kumpulan nol atau beberapa resource
channelyang cocok dengan kriteria permintaan. Coba sekarang. - update
- Memperbarui metadata channel. Perhatikan bahwa metode ini saat ini hanya mendukung update pada objek
brandingSettingsdaninvideoPromotionresourcechannelserta properti turunannya. Coba sekarang.
Representasi resource
Struktur JSON berikut menunjukkan format resource channels:
{
"kind": "youtube#channel",
"etag": etag,
"id": string,
"snippet": {
"title": string,
"description": string,
"customUrl": string,
"publishedAt": datetime,
"thumbnails": {
(key): {
"url": string,
"width": unsigned integer,
"height": unsigned integer
}
},
"defaultLanguage": string,
"localized": {
"title": string,
"description": string
},
"country": string
},
"contentDetails": {
"relatedPlaylists": {
"likes": string,
"favorites": string,
"uploads": string
}
},
"statistics": {
"viewCount": unsigned long,
"subscriberCount": unsigned long, // this value is rounded to three significant figures
"hiddenSubscriberCount": boolean,
"videoCount": unsigned long
},
"topicDetails": {
"topicIds": [
string
],
"topicCategories": [
string
]
},
"status": {
"privacyStatus": string,
"isLinked": boolean,
"longUploadsStatus": string,
"madeForKids": boolean,
"selfDeclaredMadeForKids": boolean
},
"brandingSettings": {
"channel": {
"title": string,
"description": string,
"keywords": string,
"trackingAnalyticsAccountId": string,
"unsubscribedTrailer": string,
"defaultLanguage": string,
"country": string
},
"watch": {
"textColor": string,
"backgroundColor": string,
"featuredPlaylistId": string
}
},
"auditDetails": {
"overallGoodStanding": boolean,
"communityGuidelinesGoodStanding": boolean,
"copyrightStrikesGoodStanding": boolean,
"contentIdClaimsGoodStanding": boolean
},
"contentOwnerDetails": {
"contentOwner": string,
"timeLinked": datetime
},
"localizations": {
(key): {
"title": string,
"description": string
}
}
}Properti
Tabel berikut menentukan properti yang muncul di resource ini:
| Properti | |
|---|---|
kind |
stringMengidentifikasi jenis resource API. Nilainya akan menjadi youtube#channel. |
etag |
etagEtag resource ini. |
id |
stringID yang digunakan YouTube untuk mengidentifikasi channel secara unik. |
snippet |
objectObjek snippet berisi detail dasar tentang channel, seperti judul, deskripsi, dan gambar thumbnail. |
snippet.title |
stringJudul channel. |
snippet.description |
stringDeskripsi channel. Nilai properti memiliki panjang maksimum 1.000 karakter. |
snippet.customUrl |
stringURL kustom channel. Pusat Bantuan YouTube menjelaskan persyaratan kelayakan untuk mendapatkan URL kustom serta cara menyiapkan URL. |
snippet.publishedAt |
datetimeTanggal dan waktu pembuatan channel. Nilai ditentukan dalam format ISO 8601. |
snippet.thumbnails |
objectPeta gambar thumbnail yang terkait dengan channel. Untuk setiap objek dalam peta, kuncinya adalah nama gambar thumbnail, dan nilainya adalah objek yang berisi informasi lain tentang thumbnail. Saat menampilkan thumbnail di aplikasi, pastikan kode Anda menggunakan URL gambar persis seperti yang ditampilkan dalam respons API. Misalnya, aplikasi Anda tidak boleh menggunakan domain http, bukan domain https, dalam URL yang ditampilkan dalam respons API.URL thumbnail channel hanya tersedia di domain https, yang merupakan cara URL muncul dalam respons API. Anda mungkin melihat gambar rusak di aplikasi Anda jika aplikasi tersebut mencoba memuat gambar YouTube dari domain http. Gambar thumbnail mungkin kosong untuk channel yang baru dibuat dan mungkin perlu waktu hingga satu hari untuk diisi. |
snippet.thumbnails.(key) |
objectNilai kunci yang valid adalah:
|
snippet.thumbnails.(key).url |
stringURL gambar. Untuk panduan tambahan tentang penggunaan URL thumbnail di aplikasi Anda, lihat definisi properti snippet.thumbnails. |
snippet.thumbnails.(key).width |
unsigned integerLebar gambar. |
snippet.thumbnails.(key).height |
unsigned integerTinggi gambar. |
snippet.defaultLanguage |
stringBahasa teks di properti snippet.title dan snippet.description resource channel. |
snippet.localized |
objectObjek snippet.localized berisi judul dan deskripsi yang dilokalkan untuk channel atau berisi judul dan deskripsi channel dalam bahasa default untuk metadata channel.
localizations untuk menambahkan, memperbarui, atau menghapus metadata yang dilokalkan. |
snippet.localized.title |
stringJudul channel yang dilokalkan. |
snippet.localized.description |
stringDeskripsi channel yang dilokalkan. |
snippet.country |
stringNegara yang terkait dengan channel. Untuk menetapkan nilai properti ini, perbarui nilai properti brandingSettings.channel.country. |
contentDetails |
objectObjek contentDetails mengenkapsulasi informasi tentang konten channel. |
contentDetails.relatedPlaylists |
objectObjek relatedPlaylists adalah peta yang mengidentifikasi playlist yang terkait dengan channel, seperti video yang diupload atau video yang disukai di channel. Anda dapat mengambil playlist ini menggunakan metode playlists.list. |
contentDetails.relatedPlaylists.likes |
stringID playlist yang berisi video yang disukai channel. Gunakan metode playlistItems.insert dan playlistItems.delete untuk menambahkan atau menghapus item dari daftar tersebut. |
contentDetails.relatedPlaylists.favorites |
stringProperti ini tidak digunakan lagi. ID playlist yang berisi video favorit channel. Gunakan metode playlistItems.insert dan playlistItems.delete untuk menambahkan atau menghapus item dari daftar tersebut.Perhatikan bahwa YouTube telah menghentikan fungsi video favorit. Misalnya, properti statistics.favoriteCount resource video tidak digunakan lagi pada 28 Agustus 2015. Oleh karena itu, karena alasan historis, nilai properti ini mungkin berisi ID playlist yang merujuk ke playlist kosong, sehingga tidak dapat diambil. |
contentDetails.relatedPlaylists.uploads |
stringID playlist yang berisi video yang diupload channel. Gunakan metode videos.insert untuk mengupload video baru dan metode videos.delete untuk menghapus video yang diupload sebelumnya. |
statistics |
objectObjek statistics mengenkapsulasi statistik untuk channel. |
statistics.viewCount |
unsigned longJumlah frekuensi semua video dalam semua format ditonton untuk sebuah channel. Untuk semua format video (video panjang, Live, dan Shorts) di channel, Untuk semua format video (video panjang, Live, dan video Shorts) di channel, |
statistics.commentCount |
unsigned longProperti ini sudah tidak digunakan lagi. Jumlah komentar untuk channel. |
statistics.subscriberCount |
unsigned longJumlah subscriber yang dimiliki channel. Nilai ini dibulatkan ke bawah menjadi tiga angka penting. Untuk mengetahui detail selengkapnya tentang cara pembulatan jumlah subscriber, lihat Histori Revisi atau Pusat Bantuan YouTube. |
statistics.videoCount |
unsigned longJumlah video publik yang diupload ke channel. Perhatikan bahwa nilai ini hanya mencerminkan jumlah video publik channel, bahkan untuk pemilik. Perilaku ini konsisten dengan jumlah yang ditampilkan di situs YouTube. |
topicDetails |
objectObjek topicDetails mengenkapsulasi informasi tentang topik yang terkait dengan channel.Penting: Untuk mengetahui detail selengkapnya tentang perubahan terkait ID topik, lihat definisi properti topicDetails.topicIds[] dan histori revisi. |
topicDetails.topicIds[] |
listDaftar ID topik yang terkait dengan channel. Properti ini tidak digunakan lagi sejak 10 November 2016. ID ini akan didukung hingga 10 November 2017. Penting: Karena penghentian penggunaan Freebase dan Freebase API, ID topik mulai berfungsi secara berbeda sejak 27 Februari 2017. Pada saat itu, YouTube mulai menampilkan sejumlah kecil ID topik yang diseleksi. |
topicDetails.topicCategories[] |
listDaftar URL Wikipedia yang menjelaskan konten channel. |
status |
objectObjek status merangkum informasi tentang status privasi channel. |
status.privacyStatus |
stringStatus privasi channel. Nilai yang valid untuk properti ini adalah:
|
status.isLinked |
booleanMenunjukkan apakah data channel mengidentifikasi pengguna yang sudah ditautkan ke nama pengguna YouTube atau akun Google+. Pengguna yang memiliki salah satu link ini sudah memiliki identitas YouTube publik, yang merupakan prasyarat untuk beberapa tindakan, seperti mengupload video. |
status.longUploadsStatus |
stringMenunjukkan apakah channel memenuhi syarat untuk mengupload video berdurasi lebih dari 15 menit. Properti ini hanya ditampilkan jika pemilik channel mengizinkan permintaan API. Untuk mengetahui informasi selengkapnya tentang fitur ini, lihat Pusat Bantuan YouTube. Nilai yang valid untuk properti ini adalah:
|
status.madeForKids |
booleanNilai ini menunjukkan apakah channel ditetapkan sebagai ditujukan untuk anak-anak, dan berisi status "Dibuat untuk Anak-Anak" saat ini dari channel tersebut. Misalnya, status mungkin ditentukan berdasarkan nilai properti selfDeclaredMadeForKids. Untuk mengetahui informasi selengkapnya tentang cara menetapkan audiens untuk channel, video, atau siaran Anda, lihat Pusat Bantuan YouTube. |
status.selfDeclaredMadeForKids |
booleanDalam permintaan channels.update,
properti ini memungkinkan pemilik channel menetapkan channel sebagai ditujukan untuk anak-anak. Nilai properti hanya ditampilkan jika pemilik channel mengizinkan permintaan API.
|
brandingSettings |
objectObjek brandingSettings merangkum informasi tentang branding channel. |
brandingSettings.channel |
objectObjek channel mengenkapsulasi properti branding halaman channel. |
brandingSettings.channel.title |
stringJudul channel. Judul memiliki panjang maksimum 30 karakter. |
brandingSettings.channel.description |
stringDeskripsi channel, yang muncul di kotak informasi channel di halaman channel Anda. Nilai properti memiliki panjang maksimum 1.000 karakter. |
brandingSettings.channel.keywords |
stringKata kunci yang terkait dengan channel Anda. Nilainya adalah daftar string yang dipisahkan spasi. Kata kunci channel mungkin terpotong jika melebihi panjang maksimum yang diizinkan, yaitu 500 karakter, atau jika berisi tanda petik yang tidak di-escape ( "). Perhatikan bahwa batas 500 karakter bukanlah batas per kata kunci, melainkan batas panjang total semua kata kunci. |
brandingSettings.channel.trackingAnalyticsAccountId |
stringID untuk akun Google Analytics yang ingin Anda gunakan untuk melacak dan mengukur traffic ke channel Anda. |
brandingSettings.channel.unsubscribedTrailer |
stringVideo yang akan diputar di modul video unggulan dalam tampilan jelajah halaman channel untuk penonton yang belum subscribe. Penonton yang telah subscribe mungkin melihat video berbeda yang menyoroti aktivitas channel terbaru. Jika ditentukan, nilai properti harus berupa ID video YouTube dari video publik atau tidak publik yang dimiliki oleh pemilik channel. |
brandingSettings.channel.defaultLanguage |
stringBahasa teks di properti snippet.title dan snippet.description resource channel. |
brandingSettings.channel.country |
stringNegara yang terkait dengan channel. Perbarui properti ini untuk menetapkan nilai properti snippet.country. |
brandingSettings.watch |
objectCatatan: Objek ini dan semua properti turunannya tidak digunakan lagi. Objek watch mengenkapsulasi properti branding halaman tonton untuk video channel. |
brandingSettings.watch.textColor |
stringCatatan: Properti ini sudah tidak digunakan lagi. Warna teks untuk area bermerek di halaman tonton video. |
brandingSettings.watch.backgroundColor |
stringCatatan: Properti ini sudah tidak digunakan lagi. Warna latar belakang untuk area bermerek di halaman tonton video. |
brandingSettings.watch.featuredPlaylistId |
stringCatatan: Properti ini sudah tidak digunakan lagi. API akan menampilkan error jika Anda mencoba menetapkan nilainya. |
brandingSettings.image |
objectProperti ini dan semua properti turunannya sudah tidak digunakan lagi. Objek image mengenkapsulasi informasi tentang gambar yang ditampilkan di halaman channel atau halaman tonton video. |
brandingSettings.image.bannerImageUrl |
stringProperti ini sudah tidak digunakan lagi. URL untuk gambar banner yang ditampilkan di halaman channel di situs YouTube. Gambar berukuran 1060 px x 175 px. |
brandingSettings.image.bannerMobileImageUrl |
stringProperti ini sudah tidak digunakan lagi. URL untuk gambar banner yang ditampilkan di halaman channel di aplikasi seluler. Gambar berukuran 640 px x 175 px. |
brandingSettings.image.watchIconImageUrl |
stringProperti ini sudah tidak digunakan lagi. URL untuk gambar yang muncul di atas pemutar video. Gambar ini memiliki tinggi 25 piksel dengan lebar fleksibel yang tidak boleh melebihi 170 piksel. Jika Anda tidak memberikan gambar ini, nama channel Anda akan muncul, bukan gambar. |
brandingSettings.image.trackingImageUrl |
stringProperti ini sudah tidak digunakan lagi. URL untuk piksel pelacakan 1 piksel x 1 piksel yang dapat digunakan untuk mengumpulkan statistik penayangan halaman channel atau video. |
brandingSettings.image.bannerTabletLowImageUrl |
stringProperti ini sudah tidak digunakan lagi. URL untuk gambar banner beresolusi rendah yang ditampilkan di halaman channel di aplikasi tablet. Ukuran maksimum gambar adalah 1138 px x 188 px. |
brandingSettings.image.bannerTabletImageUrl |
stringProperti ini sudah tidak digunakan lagi. URL untuk gambar banner yang ditampilkan di halaman channel di aplikasi tablet. Gambar berukuran 1707 px x 283 px. |
brandingSettings.image.bannerTabletHdImageUrl |
stringProperti ini sudah tidak digunakan lagi. URL untuk gambar banner resolusi tinggi yang ditampilkan di halaman channel di aplikasi tablet. Ukuran maksimum gambar adalah 2276 px x 377 px. |
brandingSettings.image.bannerTabletExtraHdImageUrl |
stringProperti ini sudah tidak digunakan lagi. URL untuk gambar banner beresolusi ekstra tinggi yang ditampilkan di halaman channel di aplikasi tablet. Ukuran maksimum gambar adalah 2560 px x 424 px. |
brandingSettings.image.bannerMobileLowImageUrl |
stringProperti ini sudah tidak digunakan lagi. URL untuk gambar banner beresolusi rendah yang ditampilkan di halaman channel di aplikasi seluler. Ukuran maksimum gambar adalah 320 px x 88 px. |
brandingSettings.image.bannerMobileMediumHdImageUrl |
stringProperti ini sudah tidak digunakan lagi. URL untuk gambar banner beresolusi sedang yang ditampilkan di halaman channel di aplikasi seluler. Ukuran maksimum gambar adalah 960 px x 263 px. |
brandingSettings.image.bannerMobileHdImageUrl |
stringProperti ini sudah tidak digunakan lagi. URL untuk gambar banner beresolusi tinggi yang ditampilkan di halaman channel di aplikasi seluler. Ukuran maksimum gambar adalah 1280 px x 360 px. |
brandingSettings.image.bannerMobileExtraHdImageUrl |
stringProperti ini sudah tidak digunakan lagi. URL untuk gambar banner beresolusi sangat tinggi yang ditampilkan di halaman channel di aplikasi seluler. Ukuran maksimum gambar adalah 1440 px x 395 px. |
brandingSettings.image.bannerTvImageUrl |
stringProperti ini sudah tidak digunakan lagi. URL untuk gambar banner beresolusi sangat tinggi yang ditampilkan di halaman channel di aplikasi televisi. Ukuran maksimum gambar adalah 2120 x 1192 piksel. |
brandingSettings.image.bannerTvLowImageUrl |
stringProperti ini sudah tidak digunakan lagi. URL untuk gambar banner beresolusi rendah yang ditampilkan di halaman channel di aplikasi televisi. Ukuran maksimum gambar adalah 854 px x 480 px. |
brandingSettings.image.bannerTvMediumImageUrl |
stringProperti ini sudah tidak digunakan lagi. URL untuk gambar banner beresolusi sedang yang ditampilkan di halaman channel di aplikasi televisi. Ukuran maksimum gambar adalah 1280 px x 720 px. |
brandingSettings.image.bannerTvHighImageUrl |
stringProperti ini sudah tidak digunakan lagi. URL untuk gambar banner resolusi tinggi yang ditampilkan di halaman channel di aplikasi televisi. Ukuran maksimum gambar adalah 1920 px x 1080 px. |
brandingSettings.image.bannerExternalUrl |
stringProperti ini menentukan lokasi gambar banner yang digunakan YouTube untuk membuat berbagai ukuran gambar banner untuk channel. |
brandingSettings.hints[] |
listProperti ini dan semua properti turunannya sudah tidak digunakan lagi. Objek hints mengenkapsulasi properti branding tambahan. |
brandingSettings.hints[].property |
stringProperti ini sudah tidak digunakan lagi. Properti. |
brandingSettings.hints[].value |
stringProperti ini sudah tidak digunakan lagi. Nilai properti. |
auditDetails |
objectObjek auditDetails mengenkapsulasi data channel yang akan dievaluasi oleh jaringan multichannel (MCN) saat menentukan apakah akan menerima atau menolak channel tertentu. Perhatikan bahwa setiap permintaan API yang mengambil bagian resource ini harus memberikan token otorisasi yang berisi cakupan https://www.googleapis.com/auth/youtubepartner-channel-audit. Selain itu, token apa pun yang menggunakan cakupan tersebut harus dicabut saat MCN memutuskan untuk menerima atau menolak channel atau dalam waktu dua minggu sejak tanggal token dikeluarkan. |
auditDetails.overallGoodStanding |
booleanKolom ini menunjukkan apakah ada masalah dengan saluran. Saat ini, kolom ini mewakili hasil operasi AND logis pada properti communityGuidelinesGoodStanding, copyrightStrikesGoodStanding, dan contentIdClaimsGoodStanding, yang berarti properti ini memiliki nilai true jika semua properti lainnya juga memiliki nilai true. Namun, properti ini akan memiliki nilai false jika salah satu properti tersebut memiliki nilai false. Namun, perhatikan bahwa metodologi yang digunakan untuk menetapkan nilai properti ini dapat berubah. |
auditDetails.communityGuidelinesGoodStanding |
booleanMenunjukkan apakah channel mematuhi pedoman komunitas YouTube. |
auditDetails.copyrightStrikesGoodStanding |
booleanMenunjukkan apakah channel memiliki teguran hak cipta. |
auditDetails.contentIdClaimsGoodStanding |
booleanMenunjukkan apakah channel memiliki klaim yang belum terselesaikan. |
contentOwnerDetails |
objectObjek contentOwnerDetails mengenkapsulasi data channel yang hanya dapat dilihat oleh Partner YouTube yang telah menautkan channel ke Pengelola Kontennya. |
contentOwnerDetails.contentOwner |
stringID pemilik konten yang ditautkan ke channel. |
contentOwnerDetails.timeLinked |
datetimeTanggal dan waktu saat channel ditautkan ke pemilik konten. Nilai ditentukan dalam format ISO 8601. |
localizations |
objectObjek localizations mengenkapsulasi terjemahan metadata channel. |
localizations.(key) |
objectBahasa metadata yang dilokalkan yang terkait dengan nilai kunci. Nilainya adalah string yang berisi kode bahasa BCP-47. |
localizations.(key).title |
stringJudul channel yang dilokalkan. |
localizations.(key).description |
stringDeskripsi channel yang dilokalkan. |