Channels

API ini kini mendukung kemampuan untuk menandai channel atau video Anda sebagai "Dibuat untuk Anak-Anak". Selain itu, referensi channel dan video kini juga berisi properti yang mengidentifikasi status "Dibuat untuk Anak-Anak" untuk channel atau video tersebut. Kebijakan Developer dan Persyaratan Layanan untuk Layanan YouTube API juga diperbarui pada 10 Januari 2020. Untuk mengetahui informasi selengkapnya, lihat histori revisi untuk Layanan Data API YouTube dan Persyaratan Layanan untuk Layanan YouTube API.

Referensi channel berisi informasi tentang channel YouTube.

Metode

API ini mendukung metode berikut untuk resource channels:

list

Menampilkan kumpulan nol resource channel atau lebih yang cocok dengan kriteria permintaan. Coba sekarang.

perbarui

Memperbarui metadata channel. Perlu diperhatikan bahwa metode ini saat ini hanya mendukung update untuk objek brandingSettings dan invideoPromotion resource channel serta properti turunannya. Coba sekarang.

Representasi resource

Struktur JSON berikut menampilkan 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 mendefinisikan properti yang muncul di resource ini:

Properti
kind	string Mengidentifikasi jenis resource API. Nilainya akan berupa 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 channel, 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 dan cara menyiapkan URL.
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 dan 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 Anda jika aplikasi 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)	object Nilai kunci yang valid adalah: default – Gambar thumbnail default. Thumbnail default untuk video – atau referensi yang merujuk ke video, seperti item playlist atau hasil penelusuran – adalah lebar 120 piksel dan tinggi 90 piksel. Thumbnail default untuk saluran adalah lebar 88px dan tinggi 88px. medium – Versi gambar thumbnail beresolusi lebih tinggi. Untuk video (atau sumber daya yang merujuk pada video), gambar ini memiliki lebar 320px dan tinggi 180px. Untuk channel, gambar ini memiliki lebar 240px dan tinggi 240px. high – Versi gambar thumbnail beresolusi tinggi. Untuk video (atau sumber daya yang merujuk pada video), gambar ini memiliki lebar 480px dan tinggi 360px. Untuk channel, gambar ini memiliki lebar 800 piksel dan tinggi 800 piksel.
snippet.thumbnails.(key).url	string URL gambar. Lihat definisi properti snippet.thumbnails untuk mendapatkan panduan tambahan tentang penggunaan URL thumbnail pada 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. Teks yang dilokalkan ditampilkan dalam cuplikan resource jika permintaan channels.list menggunakan parameter hl untuk menentukan bahasa yang akan digunakan untuk menampilkan teks yang dilokalkan, nilai parameter hl mengidentifikasi bahasa aplikasi YouTube, dan teks yang dilokalkan tersedia dalam bahasa tersebut. Metadata untuk bahasa default ditampilkan jika nilai parameter hl tidak ditentukan atau nilai ditentukan, tetapi metadata yang dilokalkan tidak tersedia untuk bahasa yang ditentukan. Properti ini berisi nilai hanya baca. Gunakan objek 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 channel.
contentDetails.relatedPlaylists	object Objek relatedPlaylists adalah peta yang mengidentifikasi playlist yang terkait dengan channel, seperti video yang diupload channel atau video yang disukai. Anda dapat mengambil playlist ini menggunakan metode playlists.list.
contentDetails.relatedPlaylists.likes	string ID playlist yang berisi video yang disukai di 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 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	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 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 penting. Buka Histori Revisi atau Pusat Bantuan YouTube untuk mengetahui detail selengkapnya tentang cara pembulatan jumlah subscriber.
statistics.hiddenSubscriberCount	boolean Menunjukkan apakah jumlah subscriber channel dapat dilihat oleh publik.
statistics.videoCount	unsigned long Jumlah video publik yang diupload ke channel. Perhatikan bahwa nilai ini mencerminkan jumlah video publik channel saja, bahkan kepada pemilik. Perilaku ini konsisten dengan jumlah yang ditampilkan di situs YouTube.
topicDetails	object Objek topicDetails merangkum informasi mengenai topik yang terkait dengan saluran. Penting: Lihat definisi properti topicDetails.topicIds[] dan histori revisi untuk 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. Fitur ini akan didukung hingga 10 November 2017. Penting: Karena penghentian 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. Lihat ID topik yang didukung mulai 15 Februari 2017 Topik Topik musik /m/04rlf Musik (topik orang tua) /m/02mscn musik rohani Kristen /m/0ggq0m Musik klasik /m/01lyv Negara /m/02lkt Musik elektronik /m/0glt670 Musik hip-hop /m/05rwpb Musik independen /m/03_d0 Musik jazz /m/028sqc Musik Asia /m/0g293 Musik Amerika Latin /m/064t9 Musik pop /m/06cqb Musik reggae /m/06j6l Irama dan musik biru /m/06by7 Musik rock /m/0gywn Musik soul Topik game /m/0bzvm2 Game (topik orang tua) /m/025zzc Game aksi /m/02ntfj Game aksi petualangan /m/0b1vjn Game kasual /m/02hygl Video game musik /m/04q1x3q Video game teka-teki /m/01sjng Video game balapan /m/0403l3g Video game RPG /m/021bp2 Video game simulasi /m/022dc6 Game olahraga /m/03hf_rm Video game strategi Topik olahraga /m/06ntj Olahraga (topik orang tua) /m/0jm_ Sepak bola Amerika /m/018jz Bisbol /m/018w8 Bola Basket /m/01cgz Tinju /m/09xp_ Kriket /m/02vx4 Sepak Bola /m/037hz Golf /m/03tmr Hoki es /m/01h7lh Seni bela diri campuran /m/0410tth Motorsport /m/07bs0 Tenis /m/07_53 Bola Voli Topik hiburan /m/02jjt Hiburan (topik orang tua) /m/09kqc Humor /m/02vxn Film /m/05qjc Seni pertunjukan /m/066wd Gulat profesional /m/0f2f9 Acara TV Topik gaya hidup /m/019_rr Gaya hidup (topik orang tua) /m/032tl Fashion /m/027x7n Kebugaran /m/02wbm Makanan /m/03glg Hobi /m/068hy Hewan peliharaan /m/041xxh Daya tarik fisik [Kecantikan] /m/07c1v Teknologi /m/07bxq Pariwisata /m/07yv9 Kendaraan Topik masyarakat /m/098wr Masyarakat (topik orang tua) /m/09s1f Bisnis /m/0kt51 Kesehatan /m/01h6rj Militer /m/05qt0 Politik /m/06bvp Agama Topik lainnya /m/01k8wb Pengetahuan
topicDetails.topicCategories[]	list Daftar URL Wikipedia yang mendeskripsikan konten channel.
status	object Objek status merangkum informasi tentang status privasi channel.
status.privacyStatus	string Status privasi channel. Nilai yang valid untuk properti ini adalah: private public unlisted
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: allowed – Channel ini dapat mengupload video yang berdurasi lebih dari 15 menit. disallowed – Channel ini tidak dapat atau memenuhi syarat untuk mengupload video yang berdurasi lebih dari 15 menit. Channel hanya memenuhi syarat untuk mengupload video berdurasi panjang jika memiliki reputasi baik berdasarkan Pedoman Komunitas YouTube dan tidak memiliki pemblokiran Content ID di seluruh dunia pada kontennya. Setelah pemilik channel menyelesaikan masalah yang mencegah channel mengupload video berdurasi lebih panjang, channel tersebut akan kembali ke status allowed atau eligible. eligible – Channel ini memenuhi syarat untuk mengupload video yang berdurasi lebih dari 15 menit. Namun, pemilik channel harus terlebih dahulu mengaktifkan kemampuan untuk mengupload video berdurasi lebih panjang di https://www.youtube.com/verify. Baca Pusat Bantuan YouTube untuk mendapatkan informasi lebih lanjut tentang fitur ini.
status.madeForKids	boolean Nilai ini menunjukkan apakah channel ditetapkan sebagai ditujukan untuk anak-anak, dan berisi status channel saat ini "Dibuat untuk Anak-Anak". Misalnya, status mungkin ditentukan berdasarkan nilai properti selfDeclaredMadeForKids. Buka Pusat Bantuan YouTube untuk mengetahui informasi lebih lanjut mengenai cara menetapkan penonton untuk channel, video, atau siaran Anda.
status.selfDeclaredMadeForKids	boolean Dalam permintaan channels.update, properti ini memungkinkan pemilik channel menetapkan channel sebagai ditujukan untuk anak-anak. Nilai properti hanya ditampilkan jika pemilik saluran mengizinkan permintaan API.
brandingSettings	object Objek brandingSettings merangkum informasi tentang branding channel.
brandingSettings.channel	object Objek channel merangkum properti branding halaman channel.
brandingSettings.channel.title	string Judul channel. Judul memiliki panjang maksimum 30 karakter.
brandingSettings.channel.description	string Deskripsi channel, yang muncul di kotak informasi channel di halaman channel 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. Kata kunci saluran dapat terpotong jika melebihi panjang maksimum yang diizinkan, yaitu 500 karakter, atau jika berisi tanda kutip yang tidak di-escape ("). Perhatikan bahwa batas 500 karakter bukan merupakan batas per kata kunci, melainkan batas pada 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 harus diputar di modul video unggulan di tampilan jelajah halaman channel untuk penonton yang tidak subscribe. Penonton yang subscribe mungkin melihat video lain 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 sudah 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 dalam 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 di halaman channel pada aplikasi tablet. Ukuran maksimum gambar adalah 1138px kali 188px.
brandingSettings.image.bannerTabletImageUrl	string Properti ini tidak digunakan lagi. URL untuk gambar banner yang ditampilkan di halaman channel dalam aplikasi tablet. Gambar berukuran 1707px x 283px.
brandingSettings.image.bannerTabletHdImageUrl	string Properti ini tidak digunakan lagi. URL untuk gambar banner beresolusi tinggi yang ditampilkan di halaman channel pada aplikasi tablet. Ukuran maksimum gambar adalah 2276px x 377px.
brandingSettings.image.bannerTabletExtraHdImageUrl	string Properti ini tidak digunakan lagi. URL untuk gambar banner beresolusi ekstra tinggi yang ditampilkan di halaman channel pada aplikasi tablet. Ukuran maksimum gambar adalah 2560px kali 424px.
brandingSettings.image.bannerMobileLowImageUrl	string Properti ini tidak digunakan lagi. URL untuk gambar banner beresolusi rendah yang ditampilkan di halaman channel pada aplikasi seluler. Ukuran maksimum gambar adalah 320px kali 88px.
brandingSettings.image.bannerMobileMediumHdImageUrl	string Properti ini tidak digunakan lagi. URL untuk gambar banner beresolusi sedang yang ditampilkan di halaman channel pada aplikasi seluler. Ukuran maksimum gambar adalah 960px kali 263px.
brandingSettings.image.bannerMobileHdImageUrl	string Properti ini tidak digunakan lagi. URL untuk gambar banner beresolusi tinggi yang ditampilkan di halaman channel pada aplikasi seluler. Ukuran maksimum gambar adalah 1280x360 piksel.
brandingSettings.image.bannerMobileExtraHdImageUrl	string Properti ini tidak digunakan lagi. URL untuk gambar banner beresolusi sangat tinggi yang ditampilkan di halaman channel pada aplikasi seluler. Ukuran maksimum gambar adalah 1440 x 395 piksel.
brandingSettings.image.bannerTvImageUrl	string Properti ini tidak digunakan lagi. URL untuk gambar banner beresolusi ekstra tinggi yang ditampilkan di halaman channel pada 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 di halaman channel pada aplikasi televisi. Ukuran maksimum gambar adalah 854px kali 480px.
brandingSettings.image.bannerTvMediumImageUrl	string Properti ini tidak digunakan lagi. URL untuk gambar banner beresolusi sedang yang ditampilkan di halaman channel pada aplikasi televisi. Ukuran maksimum gambar adalah 1280x720 piksel.
brandingSettings.image.bannerTvHighImageUrl	string Properti ini tidak digunakan lagi. URL untuk gambar banner beresolusi tinggi yang ditampilkan di halaman channel pada aplikasi televisi. Ukuran maksimum gambar adalah 1920px kali 1080px.
brandingSettings.image.bannerExternalUrl	string Properti ini menentukan lokasi gambar banner yang digunakan YouTube untuk menghasilkan berbagai ukuran gambar banner pada channel.
brandingSettings.hints[]	list Properti ini dan semua properti turunannya tidak digunakan lagi. Objek hints merangkum 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, perhatikan bahwa metodologi yang digunakan untuk menetapkan nilai properti ini dapat berubah.
auditDetails.communityGuidelinesGoodStanding	boolean Menunjukkan apakah channel mematuhi pedoman komunitas YouTube atau tidak.
auditDetails.copyrightStrikesGoodStanding	boolean Menunjukkan apakah channel memiliki 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 tersebut 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 mengenkapsulasi terjemahan metadata channel.
localizations.(key)	object Bahasa metadata yang dilokalkan yang 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.