Channels

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

Referensi channel berisi informasi tentang 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.
perbarui
Memperbarui metadata channel. Perhatikan 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 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,
      "moderateComments": boolean,
      "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 dalam resource ini:

Properti
kind string
Mengidentifikasi jenis resource API. Nilai akan menjadi 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 1000 karakter.
snippet.customUrl string
URL kustom channel. Pusat Bantuan YouTube menjelaskan persyaratan kelayakan untuk mendapatkan URL kustom serta cara menyiapkan URL.
snippet.publishedAt datetime
Tanggal dan waktu channel dibuat. Nilainya ditentukan dalam format ISO 8601.
snippet.thumbnails object
Peta gambar thumbnail yang terkait dengan saluran. 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 Anda, pastikan kode Anda menggunakan URL gambar persis seperti yang ditampilkan dalam respons API. Misalnya, aplikasi Anda sebaiknya tidak menggunakan domain http, bukan domain https di URL yang ditampilkan di respons API.

URL thumbnail channel hanya tersedia di domain https, karena URL ditampilkan dalam respons API. Anda mungkin melihat gambar yang rusak dalam aplikasi jika mencoba memuat gambar YouTube dari domain http. Gambar thumbnail untuk channel yang baru dibuat mungkin kosong dan mungkin perlu waktu hingga satu hari untuk mengisinya.
snippet.thumbnails.(key) object
Nilai kunci yang valid adalah:
  • default – Gambar thumbnail default. Thumbnail default untuk video – atau resource yang merujuk pada video, seperti item playlist atau hasil penelusuran – memiliki lebar 120 piksel dan tinggi 90 piksel. Thumbnail default untuk sebuah channel memiliki lebar 88 piksel dan tinggi 88 piksel.
  • medium – Versi resolusi gambar thumbnail yang lebih tinggi. Untuk video (atau resource yang merujuk pada video), gambar ini memiliki lebar 320 piksel dan tinggi 180 piksel. Untuk channel, gambar ini memiliki lebar 240 px dan tinggi 240 px.
  • high – Versi gambar thumbnail beresolusi tinggi. Untuk video (atau resource yang merujuk pada video), gambar ini memiliki lebar 480 piksel dan tinggi 360 piksel. Untuk channel, gambar ini memiliki lebar 800 px dan tinggi 800 px.
snippet.thumbnails.(key).url string
URL gambar. Lihat definisi properti snippet.thumbnails untuk 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 tersebut, 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 mengenkapsulasi informasi tentang konten saluran.
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 tersebut 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 memiliki fungsi video favorit. Misalnya, properti statistics.favoriteCount resource video tidak digunakan lagi pada 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 di channel. Gunakan metode videos.insert untuk mengupload video baru dan metode videos.delete untuk menghapus video yang diupload sebelumnya.
statistics object
Objek statistics mengenkapsulasi statistik untuk saluran.
statistics.viewCount unsigned long
Frekuensi 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. Baca Histori Revisi atau Pusat Bantuan YouTube untuk mengetahui detail pembulatan jumlah subscriber lebih lanjut.
statistics.hiddenSubscriberCount boolean
Menunjukkan apakah jumlah subscriber channel terlihat secara publik atau tidak.
statistics.videoCount unsigned long
Jumlah video publik yang diupload ke channel. Perlu diperhatikan bahwa nilai ini hanya mencerminkan jumlah video publik channel, bahkan kepada pemilik. Perilaku ini konsisten 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 tersebut.

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 mulai 27 Februari 2017. Pada saat itu, YouTube mulai menampilkan sekumpulan kecil ID topik hasil seleksi.

topicDetails.topicCategories[] list
Daftar URL Wikipedia yang mendeskripsikan konten channel.
status object
Objek status mengenkapsulasi informasi tentang status privasi saluran.
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 berdurasi lebih dari 15 menit. Properti ini hanya dikembalikan jika pemilik saluran 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 berdurasi lebih dari 15 menit.
  • disallowed – Channel ini tidak dapat atau tidak memenuhi syarat untuk mengupload video berdurasi lebih dari 15 menit. Channel hanya memenuhi syarat untuk mengupload video berdurasi panjang jika reputasinya baik berdasarkan Pedoman Komunitas YouTube dan tidak memiliki pemblokiran Content ID di seluruh dunia pada kontennya.

    Setelah pemilik channel menyelesaikan masalah yang mencegah channel tersebut mengupload video yang berdurasi lebih panjang, channel akan dikembalikan ke status allowed atau eligible.
  • eligible – Channel ini memenuhi syarat untuk mengupload video 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. Lihat Pusat Bantuan YouTube untuk mengetahui informasi selengkapnya tentang fitur ini.
status.madeForKids boolean
Nilai ini menunjukkan apakah channel ditetapkan sebagai ditujukan untuk anak-anak dan berisi status saat ini "Dibuat untuk Anak-Anak". Misalnya, status mungkin ditentukan berdasarkan nilai properti selfDeclaredMadeForKids. Baca Pusat Bantuan YouTube untuk mengetahui informasi selengkapnya 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 tersebut sebagai ditujukan untuk anak-anak. Nilai properti hanya ditampilkan jika pemilik saluran mengizinkan permintaan API.
brandingSettings object
Objek brandingSettings mengenkapsulasi 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 channel, yang muncul di kotak informasi channel di halaman channel Anda. Nilai properti memiliki panjang maksimum 1000 karakter.
brandingSettings.channel.keywords string
Kata kunci yang terkait dengan channel Anda. Nilainya adalah daftar string yang dipisahkan spasi. Kata kunci saluran dapat dipotong jika melebihi panjang maksimum 500 karakter yang diizinkan atau jika berisi tanda kutip yang tidak di-escape ("). Perhatikan bahwa batas 500 karakter bukan batas per kata kunci, melainkan batas total panjang 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.moderateComments boolean
Setelan ini menentukan apakah komentar yang dikirim pengguna di halaman channel harus disetujui oleh pemilik channel agar dapat dilihat oleh publik atau tidak. Nilai defaultnya adalah false.
brandingSettings.channel.unsubscribedTrailer string
Video yang akan diputar dalam modul video unggulan di tampilan jelajah halaman channel untuk penonton yang tidak subscribe. Penonton yang subscribe mungkin akan 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 tersebut.
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 mengenkapsulasi properti branding di 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 sudah 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 1060 x 175 piksel.
brandingSettings.image.bannerMobileImageUrl string
Properti ini tidak digunakan lagi.

URL untuk gambar banner yang ditampilkan di halaman channel di aplikasi seluler. Gambar berukuran 640x175 piksel.
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 1 piksel x 1 piksel yang dapat digunakan untuk mengumpulkan statistik penayangan saluran atau halaman video.
brandingSettings.image.bannerTabletLowImageUrl string
Properti ini tidak digunakan lagi.

URL untuk gambar banner resolusi rendah yang ditampilkan di halaman channel pada aplikasi tablet. Ukuran maksimum gambar adalah 1138 x 188 piksel.
brandingSettings.image.bannerTabletImageUrl string
Properti ini tidak digunakan lagi.

URL untuk gambar banner yang ditampilkan di halaman channel pada aplikasi tablet. Gambar berukuran 1707 x 283 piksel.
brandingSettings.image.bannerTabletHdImageUrl string
Properti ini tidak digunakan lagi.

URL untuk gambar banner resolusi tinggi yang ditampilkan di halaman channel di aplikasi tablet. Ukuran maksimum gambar adalah 2276 x 377 piksel.
brandingSettings.image.bannerTabletExtraHdImageUrl string
Properti ini tidak digunakan lagi.

URL untuk gambar banner resolusi ekstra tinggi yang ditampilkan di halaman channel pada aplikasi tablet. Ukuran maksimum gambar adalah 2560 x 424 piksel.
brandingSettings.image.bannerMobileLowImageUrl string
Properti ini tidak digunakan lagi.

URL untuk gambar banner resolusi rendah yang ditampilkan di halaman channel pada aplikasi seluler. Ukuran maksimum gambar adalah 320 x 88 piksel.
brandingSettings.image.bannerMobileMediumHdImageUrl string
Properti ini tidak digunakan lagi.

URL untuk gambar banner resolusi sedang yang ditampilkan di halaman channel pada aplikasi seluler. Ukuran maksimum gambar adalah 960 x 263 piksel.
brandingSettings.image.bannerMobileHdImageUrl string
Properti ini tidak digunakan lagi.

URL untuk gambar banner resolusi tinggi yang ditampilkan di halaman channel pada aplikasi seluler. Ukuran maksimum gambar adalah 1280 x 360 piksel.
brandingSettings.image.bannerMobileExtraHdImageUrl string
Properti ini tidak digunakan lagi.

URL untuk gambar banner 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 banner resolusi ekstra tinggi yang ditampilkan di halaman channel di aplikasi televisi. Ukuran maksimum gambar adalah 2120 x 1192 piksel.
brandingSettings.image.bannerTvLowImageUrl string
Properti ini tidak digunakan lagi.

URL untuk gambar banner resolusi rendah yang ditampilkan di 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 resolusi sedang yang ditampilkan di halaman channel di aplikasi televisi. Ukuran maksimum gambar adalah 1280 x 720 piksel.
brandingSettings.image.bannerTvHighImageUrl string
Properti ini tidak digunakan lagi.

URL untuk gambar banner resolusi tinggi yang ditampilkan di halaman channel di aplikasi televisi. Ukuran maksimum gambar adalah 1920x1080 piksel.
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 sudah 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 mengenkapsulasi data saluran yang akan dievaluasi oleh jaringan multisaluran (MCN) saat menentukan apakah akan menerima atau menolak saluran tertentu. Perhatikan bahwa permintaan API apa pun 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 tersebut atau dalam waktu dua minggu sejak tanggal token tersebut dikeluarkan.
auditDetails.overallGoodStanding boolean
Kolom ini menunjukkan apakah ada masalah dengan saluran. Saat ini, kolom ini mewakili hasil operasi AND yang logis selama properti communityGuidelinesGoodStanding, copyrightStrikesGoodStanding, dan contentIdClaimsGoodStanding, yang berarti bahwa properti ini memiliki nilai true jika semua properti lainnya 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.
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 mengenkapsulasi data channel yang hanya terlihat oleh Partner YouTube yang telah menautkan channel ke Pengelola Konten miliknya.
contentOwnerDetails.contentOwner string
ID pemilik konten yang ditautkan ke channel.
contentOwnerDetails.timeLinked datetime
Tanggal dan waktu channel ditautkan ke pemilik konten. Nilainya 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. Nilai tersebut adalah string yang berisi kode bahasa BCP-47.
localizations.(key).title string
Judul channel yang dilokalkan.
localizations.(key).description string
Deskripsi channel yang dilokalkan.