API ini kini mendukung kemampuan
untuk menandai channel Anda atau
video sebagai "Dibuat untuk Anak-Anak". Selain itu,
channel
dan resource video
kini juga berisi properti yang mengidentifikasi "Dibuat untuk Anak-Anak"
untuk mengetahui status channel atau video tersebut. Persyaratan Layanan untuk Layanan YouTube API dan Kebijakan Developer
juga diperbarui pada tanggal 10 Januari 2020. Untuk informasi lebih lanjut, lihat riwayat revisi untuk
Layanan Data API YouTube dan
Persyaratan Layanan untuk Layanan YouTube API.
Referensi channel
berisi informasi mengenai channel YouTube.
Metode
API ini mendukung metode berikut untuk resource channels
:
- list
- Menampilkan kumpulan nol atau beberapa resource
channel
yang cocok dengan kriteria permintaan. Coba sekarang. - info terbaru
- Memperbarui metadata channel. Perhatikan bahwa metode ini saat ini hanya mendukung pembaruan untuk objek
brandingSettings
daninvideoPromotion
resourcechannel
serta 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 |
string Mengidentifikasi jenis resource API. Nilainya adalah youtube#channel . |
etag |
etag Etag resource ini. |
id |
string ID yang digunakan YouTube untuk mengidentifikasi channel secara unik. |
snippet |
object Objek snippet berisi detail dasar tentang saluran, seperti judul, deskripsi, dan gambar thumbnail. |
snippet.title |
string Judul channel. |
snippet.description |
string Deskripsi channel. Nilai properti memiliki panjang maksimum 1.000 karakter. |
snippet.customUrl |
string URL kustom channel. Pusat Bantuan YouTube menjelaskan persyaratan kelayakan untuk mendapatkan URL kustom serta cara menyiapkan URL tersebut. |
snippet.publishedAt |
datetime Tanggal dan waktu channel dibuat. Nilai ditentukan dalam format ISO 8601. |
snippet.thumbnails |
object Peta 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 , di URL yang ditampilkan dalam respons API.URL thumbnail channel hanya tersedia di domain https , yang merupakan tampilan URL dalam respons API. Anda mungkin melihat gambar rusak di aplikasi jika aplikasi mencoba memuat gambar YouTube dari domain http . Gambar thumbnail mungkin kosong untuk channel yang baru dibuat dan mungkin memerlukan waktu hingga satu hari untuk diisi. |
snippet.thumbnails.(key) |
object Nilai kunci yang valid adalah:
|
snippet.thumbnails.(key).url |
string URL gambar. Lihat definisi properti snippet.thumbnails untuk mendapatkan panduan tambahan tentang penggunaan URL thumbnail di aplikasi Anda. |
snippet.thumbnails.(key).width |
unsigned integer Lebar gambar. |
snippet.thumbnails.(key).height |
unsigned integer Tinggi gambar. |
snippet.defaultLanguage |
string Bahasa teks di properti snippet.title dan snippet.description resource channel . |
snippet.localized |
object Objek 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 |
string Judul channel yang dilokalkan. |
snippet.localized.description |
string Deskripsi channel yang dilokalkan. |
snippet.country |
string Negara yang terkait dengan channel. Untuk menetapkan nilai properti ini, perbarui nilai properti brandingSettings.channel.country . |
contentDetails |
object Objek contentDetails merangkum informasi tentang konten saluran. |
contentDetails.relatedPlaylists |
object Objek relatedPlaylists adalah peta yang mengidentifikasi playlist yang terkait dengan channel, seperti video yang diupload channel tersebut atau video yang disukai. Anda dapat mengambil salah satu playlist ini menggunakan metode playlists.list . |
contentDetails.relatedPlaylists.likes |
string ID playlist yang berisi video yang disukai dari channel. Gunakan metode playlistItems.insert dan playlistItems.delete untuk menambahkan atau menghapus item dari daftar tersebut. |
contentDetails.relatedPlaylists.favorites |
string Properti 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 tidak lagi menggunakan fungsi video favorit. Misalnya, properti statistics.favoriteCount resource video tidak digunakan lagi mulai 28 Agustus 2015. Akibatnya, karena alasan historis, nilai properti ini mungkin berisi ID playlist yang merujuk ke playlist kosong sehingga tidak dapat diambil. |
contentDetails.relatedPlaylists.uploads |
string ID playlist yang berisi video yang diupload channel. Gunakan metode videos.insert untuk mengupload video baru dan metode videos.delete untuk menghapus video yang telah diupload sebelumnya. |
statistics |
object Objek statistics mengenkapsulasi statistik untuk saluran. |
statistics.viewCount |
unsigned long Berapa kali channel telah ditonton. |
statistics.commentCount |
unsigned long Properti ini tidak digunakan lagi. Jumlah komentar untuk channel. |
statistics.subscriberCount |
unsigned long Jumlah subscriber yang dimiliki channel. Nilai ini dibulatkan ke bawah menjadi tiga angka yang signifikan. Lihat Histori Revisi atau Pusat Bantuan YouTube untuk informasi selengkapnya detail tentang bagaimana jumlah subscriber dibulatkan. |
statistics.videoCount |
unsigned long Jumlah video publik yang diupload ke channel. Perhatikan, nilai mencerminkan jumlah video publik channel saja, bahkan kepada pemiliknya. Perilaku ini sesuai dengan jumlah yang ditampilkan di situs YouTube. |
topicDetails |
object Objek topicDetails mengenkapsulasi informasi tentang topik yang terkait dengan saluran.Penting: Lihat definisi properti topicDetails.topicIds[] dan histori revisi untuk mengetahui detail selengkapnya tentang perubahan terkait ID topik. |
topicDetails.topicIds[] |
list Daftar ID topik yang terkait dengan channel. Properti ini tidak digunakan lagi mulai 10 November 2016. API ini akan didukung hingga 10 November 2017. Penting: Karena Freebase dan Freebase API yang saat ini tidak digunakan lagi, fungsi ID topik mulai berfungsi secara berbeda mulai 27 Februari 2017. Pada saat itu, YouTube mulai menampilkan sejumlah kecil ID topik yang telah diseleksi. |
topicDetails.topicCategories[] |
list Daftar URL Wikipedia yang mendeskripsikan konten channel. |
status |
object Objek status merangkum informasi tentang status privasi saluran. |
status.privacyStatus |
string Status privasi channel. Nilai yang valid untuk properti ini adalah:
|
status.isLinked |
boolean Menunjukkan 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 |
string Menunjukkan apakah channel memenuhi syarat untuk mengupload video yang berdurasi lebih dari 15 menit. Properti ini hanya ditampilkan jika pemilik channel mengizinkan permintaan API. Buka Pusat Bantuan YouTube untuk mengetahui informasi selengkapnya tentang fitur ini. Nilai yang valid untuk properti ini adalah:
|
status.madeForKids |
boolean Nilai ini menunjukkan apakah saluran ditetapkan sebagai ditujukan untuk anak-anak, dan berisi kategori "Dibuat untuk Anak-Anak" saat ini status channel. Misalnya, statusnya mungkin ditentukan berdasarkan nilai properti selfDeclaredMadeForKids . Lihat
Pusat Bantuan YouTube untuk informasi lebih lanjut
informasi tentang cara menetapkan penonton untuk channel, video, atau siaran Anda.
|
status.selfDeclaredMadeForKids |
boolean Dalam permintaan channels.update ,
properti ini memungkinkan pemilik channel untuk menetapkan channel sebagai ditujukan untuk anak-anak. Tujuan
nilai properti hanya ditampilkan jika pemilik channel mengizinkan permintaan API.
|
brandingSettings |
object Objek brandingSettings merangkum informasi tentang branding channel. |
brandingSettings.channel |
object Objek channel mengenkapsulasi properti branding halaman channel. |
brandingSettings.channel.title |
string Judul channel. Judul memiliki panjang maksimum 30 karakter. |
brandingSettings.channel.description |
string Deskripsi saluran, yang muncul di kotak informasi saluran di halaman saluran Anda. Nilai properti memiliki panjang maksimum 1.000 karakter. |
brandingSettings.channel.keywords |
string Kata kunci yang terkait dengan channel Anda. Nilainya adalah daftar string yang dipisahkan spasi. Saluran kata kunci dapat terpotong jika panjangnya melebihi 500 karakter atau jika teks tersebut berisi tanda kutip yang tidak di-escape ( " ). Perhatikan bahwa karakter 500
batas ini bukan batas per kata kunci, melainkan batas panjang total semua kata kunci. |
brandingSettings.channel.trackingAnalyticsAccountId |
string ID untuk akun Google Analytics yang ingin Anda gunakan untuk melacak dan mengukur traffic ke channel Anda. |
brandingSettings.channel.unsubscribedTrailer |
string Video yang seharusnya diputar dalam modul video unggulan pada tampilan jelajah halaman channel bagi penonton yang tidak subscribe. Penonton yang subscribe dapat 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 |
string Bahasa teks di properti snippet.title dan snippet.description resource channel . |
brandingSettings.channel.country |
string Negara yang terkait dengan channel. Perbarui properti ini untuk menetapkan nilai properti snippet.country . |
brandingSettings.watch |
object Catatan: Objek ini dan semua properti turunannya tidak digunakan lagi. Objek watch merangkum properti branding halaman tonton untuk video channel. |
brandingSettings.watch.textColor |
string Catatan: Properti ini tidak digunakan lagi. Warna teks untuk area bermerek halaman tonton video. |
brandingSettings.watch.backgroundColor |
string Catatan: Properti ini tidak digunakan lagi. Warna latar belakang untuk area bermerek halaman tonton video. |
brandingSettings.watch.featuredPlaylistId |
string Catatan: Properti ini tidak digunakan lagi. API akan menampilkan error jika Anda mencoba menetapkan nilainya. |
brandingSettings.image |
object Properti ini dan semua properti turunannya tidak digunakan lagi. Objek image merangkum informasi tentang gambar yang ditampilkan di halaman channel atau halaman tonton video. |
brandingSettings.image.bannerImageUrl |
string Properti ini tidak digunakan lagi. URL untuk gambar banner yang ditampilkan di halaman channel di situs YouTube. Gambar berukuran 1060px kali 175px. |
brandingSettings.image.bannerMobileImageUrl |
string Properti ini tidak digunakan lagi. URL untuk gambar banner yang ditampilkan di halaman channel pada aplikasi seluler. Gambar berukuran 640px kali 175px. |
brandingSettings.image.watchIconImageUrl |
string Properti ini tidak digunakan lagi. URL untuk gambar yang muncul di atas pemutar video. Ini adalah gambar setinggi 25 piksel dengan lebar fleksibel yang tidak boleh melebihi 170 piksel. Jika Anda tidak memberikan gambar ini, nama channel Anda yang akan muncul, bukan gambar. |
brandingSettings.image.trackingImageUrl |
string Properti ini tidak digunakan lagi. URL untuk piksel pelacakan 1px kali 1px yang dapat digunakan untuk mengumpulkan statistik penayangan channel atau halaman video. |
brandingSettings.image.bannerTabletLowImageUrl |
string Properti ini tidak digunakan lagi. URL untuk gambar banner beresolusi rendah yang ditampilkan pada halaman channel di aplikasi tablet. Ukuran maksimum gambar adalah 1138x188 piksel. |
brandingSettings.image.bannerTabletImageUrl |
string Properti ini tidak digunakan lagi. URL untuk gambar banner yang ditampilkan pada halaman channel di aplikasi tablet. Gambar berukuran 1707px kali 283px. |
brandingSettings.image.bannerTabletHdImageUrl |
string Properti ini tidak digunakan lagi. URL untuk gambar banner beresolusi tinggi yang ditampilkan pada halaman channel di aplikasi tablet. Ukuran maksimum gambar adalah 2.276x377 piksel. |
brandingSettings.image.bannerTabletExtraHdImageUrl |
string Properti ini tidak digunakan lagi. URL untuk gambar banner dengan resolusi ekstra tinggi yang ditampilkan pada halaman channel di aplikasi tablet. Ukuran maksimum gambar adalah 2560 x 424 piksel. |
brandingSettings.image.bannerMobileLowImageUrl |
string Properti ini tidak digunakan lagi. URL untuk gambar banner beresolusi rendah yang ditampilkan pada halaman channel di aplikasi seluler. Ukuran maksimum gambar adalah 320 x 88 piksel. |
brandingSettings.image.bannerMobileMediumHdImageUrl |
string Properti ini tidak digunakan lagi. URL untuk gambar banner dengan resolusi sedang yang ditampilkan pada halaman channel di aplikasi seluler. Ukuran maksimum gambar adalah 960 x 263 piksel. |
brandingSettings.image.bannerMobileHdImageUrl |
string Properti ini tidak digunakan lagi. URL untuk gambar banner beresolusi tinggi yang ditampilkan pada halaman channel di aplikasi seluler. Ukuran maksimum gambar adalah 1280x360 piksel. |
brandingSettings.image.bannerMobileExtraHdImageUrl |
string Properti ini tidak digunakan lagi. URL untuk gambar banner dengan resolusi sangat tinggi yang ditampilkan pada halaman channel di aplikasi seluler. Ukuran maksimum gambar adalah 1440 x 395 piksel. |
brandingSettings.image.bannerTvImageUrl |
string Properti ini tidak digunakan lagi. URL untuk gambar spanduk dengan resolusi ekstra tinggi yang ditampilkan pada halaman channel di aplikasi televisi. Ukuran maksimum gambar adalah 2120px kali 1192px. |
brandingSettings.image.bannerTvLowImageUrl |
string Properti ini tidak digunakan lagi. URL untuk gambar banner beresolusi rendah yang ditampilkan pada halaman channel di aplikasi televisi. Ukuran maksimum gambar adalah 854 x 480 piksel. |
brandingSettings.image.bannerTvMediumImageUrl |
string Properti ini tidak digunakan lagi. URL untuk gambar banner beresolusi sedang yang ditampilkan pada halaman channel dalam aplikasi televisi. Ukuran maksimum gambar adalah 1280 x 720 piksel. |
brandingSettings.image.bannerTvHighImageUrl |
string Properti ini tidak digunakan lagi. URL untuk gambar spanduk beresolusi tinggi yang ditampilkan pada halaman channel dalam aplikasi televisi. Ukuran maksimum gambar adalah 1920px kali 1080px. |
brandingSettings.image.bannerExternalUrl |
string Properti ini menentukan lokasi gambar banner yang digunakan YouTube untuk membuat berbagai ukuran gambar banner untuk channel. |
brandingSettings.hints[] |
list Properti ini dan semua properti turunannya tidak digunakan lagi. Objek hints mengenkapsulasi properti branding tambahan. |
brandingSettings.hints[].property |
string Properti ini tidak digunakan lagi. Properti. |
brandingSettings.hints[].value |
string Properti ini tidak digunakan lagi. Nilai properti. |
auditDetails |
object Objek auditDetails merangkum 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 |
boolean Kolom ini menunjukkan apakah ada masalah dengan channel atau tidak. 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 lain tersebut juga memiliki nilai true . Namun, properti ini akan memiliki nilai false jika salah satu properti tersebut memiliki nilai false . Namun, perlu diperhatikan bahwa metodologi yang digunakan untuk menetapkan nilai properti ini dapat berubah sewaktu-waktu. |
auditDetails.communityGuidelinesGoodStanding |
boolean Menunjukkan apakah channel mematuhi pedoman komunitas YouTube. |
auditDetails.copyrightStrikesGoodStanding |
boolean Menunjukkan apakah channel mendapatkan teguran hak cipta atau tidak. |
auditDetails.contentIdClaimsGoodStanding |
boolean Menunjukkan apakah channel memiliki klaim yang belum terselesaikan. |
contentOwnerDetails |
object Objek contentOwnerDetails merangkum data channel yang hanya dapat dilihat oleh Partner YouTube yang telah menautkan channel ke Pengelola Kontennya. |
contentOwnerDetails.contentOwner |
string ID pemilik konten yang ditautkan ke channel. |
contentOwnerDetails.timeLinked |
datetime Tanggal dan waktu saat channel ditautkan ke pemilik konten. Nilai ditentukan dalam format ISO 8601. |
localizations |
object Objek localizations merangkum terjemahan metadata channel. |
localizations.(key) |
object Bahasa metadata yang dilokalkan dan terkait dengan nilai kunci. Nilainya adalah string yang berisi kode bahasa BCP-47. |
localizations.(key).title |
string Judul channel yang dilokalkan. |
localizations.(key).description |
string Deskripsi channel yang dilokalkan. |