Halaman ini mencantumkan perubahan YouTube Data API (v3) dan pembaruan dokumentasi. Berlangganan log perubahan ini.
30 April 2024
Catatan: Ini adalah pengumuman penghentian penggunaan.
Update ini berisi perubahan berikut:
API tidak lagi mendukung kemampuan untuk menyisipkan atau mengambil diskusi saluran. Perubahan ini konsisten dengan fungsi yang didukung di situs YouTube, yang tidak mendukung postingan komentar ke channel.
13 Maret 2024
Catatan: Ini adalah pengumuman penghentian penggunaan.
Update ini berisi perubahan berikut:
Parameter sync
untuk
captions.insert
dan
Metode captions.update
tidak digunakan lagi. YouTube akan berhenti mendukung
per 12 April 2024.
Akibat perubahan ini, developer harus menyertakan informasi pengaturan waktu saat menyisipkan atau mengubah trek teks atau upload akan gagal.
12 Maret 2024
Update ini berisi perubahan berikut:
Dokumentasi untuk resource captions
telah diperbarui untuk mencatat bahwa panjang maksimum yang diizinkan untuk snippet.name
panjangnya 150 karakter. API menampilkan nameTooLong
error jika nama trek lebih panjang dari itu.
7 Maret 2024
Catatan: Ini adalah pengumuman penghentian penggunaan.
Properti resource channel
brandingSettings.channel.moderateComments
tidak digunakan lagi. YouTube akan berhenti
yang mendukung parameter tersebut per 7 Maret 2024.
31 Januari 2024
Update ini berisi perubahan berikut:
forHandle
baru dari metode channels.list
memungkinkan Anda mengambil informasi tentang channel dengan menentukan nama sebutan channel YouTube-nya.
9 November 2023
Semua referensi ke resource videoId
di bagian Comments
dihapus karena resource videoId
tidak ditampilkan menggunakan panggilan API.
12 September 2023
Catatan: Ini adalah pengumuman penghentian penggunaan.
Metode comments.markAsSpam
tidak digunakan lagi selama beberapa tahun. Metode ini sudah tidak didukung di YouTube dan tidak
tidak lagi didukung melalui API.
Pemberitahuan penghentian penggunaan telah ditambahkan ke semua dokumen yang merujuk ke
Metode comments.markAsSpam
.
22 Agustus 2023
Metode search.list
kini mendukung
videoPaidProductPlacement
. Parameter ini memungkinkan Anda memfilter hasil penelusuran agar hanya menyertakan video yang
kreator telah dilambangkan sebagai
melakukan promosi berbayar.
18 Agustus 2023
Definisi resource video
liveStreamingDetails.concurrentViewers
telah diperbarui untuk mencatat bahwa jumlah penonton serentak yang ditampilkan oleh YouTube Data API mungkin
berbeda dari jumlah penonton serentak yang diproses tanpa spam yang tersedia melalui YouTube
Analisis. Tujuan
Pusat Bantuan YouTube
memberikan informasi selengkapnya tentang metrik live streaming.
7 Agustus 2023
Seperti yang diumumkan pada 12 Juni 2023,
Metode search.list
Parameter relatedToVideoId
tidak digunakan lagi. Parameter itu tidak lagi
didukung, dan referensi ke parameter telah dihapus dari dokumentasi API.
28 Juni 2023
Metode thumbnails.set kini mendukung
uploadRateLimitExceeded
error, yang menunjukkan bahwa channel telah mengupload terlalu banyak
thumbnail selama 24 jam terakhir dan harus mencoba lagi nanti.
12 Juni 2023
Catatan: Ini adalah pengumuman penghentian penggunaan.
Metode search.list
Parameter relatedToVideoId
sudah tidak digunakan lagi. YouTube akan berhenti mendukung
per 7 Agustus 2023.
Saat ini, pemberitahuan penghentian telah ditambahkan ke metode search.list
dokumentasi tambahan. Parameter ini akan dihapus sepenuhnya dari dokumentasi search.list
pada atau setelah 7 Agustus 2023.
Selain itu, contoh yang menunjukkan cara mengambil video terkait telah dihapus dari panduan penerapan API.
22 Agustus 2022
Memperbaiki anotasi jenis untuk video.statistics {i>field<i} ke {i>string<i} dari long yang tidak ditandatangani.
5 Agustus 2022
YouTube telah mengubah cara pembuatan ID teks, dan sebagai bagian dari perubahan tersebut,
menetapkan ID teks baru ke semua trek teks. Perubahan ini mungkin tidak kompatibel dengan versi sebelumnya
perubahan untuk aplikasi yang menyimpan
caption_id
nilai, meskipun tidak
memengaruhi aplikasi yang tidak menyimpan
caption_id
nilai.
Antara saat ini hingga 1 Desember 2022,
captions.list
,
captions.update
,
captions.download
, dan
dan metode captions.delete
akan
mendukung ID trek teks lama dan baru. Namun, pada atau setelah 1 Desember 2022, YouTube
akan berhenti mendukung ID trek teks lama. Pada saat itu, memanggil salah satu metode API tersebut
dengan ID trek teks lama akan menghasilkan
captionNotFound
error.
Untuk mempersiapkan perubahan ini, Anda harus merencanakan untuk sepenuhnya mengganti semua data trek teks yang tersimpan yang tersimpan
mulai saat ini hingga 1 Desember 2022. Artinya, untuk setiap video yang trek teksnya Anda simpan
Anda harus menghapus data yang saat ini tersimpan, lalu panggil
Metode captions.list
untuk mengambil
kumpulan trek teks saat ini untuk video dan simpan datanya dalam respons API seperti yang biasa
seperti biasanya.
12 Juli 2022
Persyaratan Layanan untuk Layanan YouTube API telah diperbarui. Memohon lihat Persyaratan Layanan untuk Layanan YouTube API - Revisi Histori untuk mengetahui informasi selengkapnya.
27 April 2022
Deskripsi metode videos.insert
telah diperbarui untuk mencatat bahwa ukuran file maksimum untuk video yang diupload telah ditingkatkan dari 128 GB menjadi 256 GB.
8 April 2022
Metode subscriptions.list
myRecentSubscribers
dan mySubscribers
definisi parameter
telah diupdate untuk mencatat bahwa jumlah maksimum pelanggan yang ditampilkan oleh API mungkin dibatasi.
Perubahan ini mewakili koreksi dokumentasi, bukan perubahan perilaku API.
15 Desember 2021
Sebagaimana diumumkan pada 18 November 2021, bersamaan dengan
perubahan untuk membuat video tidak disukai
pribadi di seluruh platform YouTube, referensi video
statistics.dislikeCount
sekarang menjadi pribadi.
Anda dapat mempelajari lebih lanjut perubahan ini di blog resmi YouTube.
18 November 2021
Sehubungan dengan perubahan pada
jadikan jumlah tidak suka video menjadi pribadi di seluruh platform YouTube, referensi video
statistics.dislikeCount
properti akan diubah menjadi pribadi pada 13 Desember 2021. Ini berarti bahwa
properti hanya akan
disertakan dalam respons API dari endpoint videos.list
jika permintaan API
diautentikasi oleh pemilik video.
Endpoint videos.rate
tidak terpengaruh
oleh perubahan ini.
Developer yang tidak menampilkan jumlah tidak suka secara publik dan tetap memerlukan jumlah tidak suka untuk Klien API dapat mengajukan permohonan agar dimasukkan dalam daftar yang diizinkan untuk pengecualian. Untuk mengajukan pengecualian, Anda harus menyelesaikan ini formulir permohonan.
Anda dapat mempelajari lebih lanjut perubahan ini di blog resmi YouTube.
2 Juli 2021
Catatan: Ini adalah pengumuman penghentian penggunaan.
Endpoint commentThreads.update
tidak digunakan lagi dan tidak didukung lagi.
Endpoint ini meduplikasi fungsi yang tersedia melalui endpoint API lainnya. Sebagai gantinya, Anda dapat
panggil comments.update
commentThreads
, lakukan panggilan sekunder ke
Metode commentThreads.list
.
1 Juli 2021
Semua developer yang menggunakan Layanan API YouTube harus menyelesaikan Audit Kepatuhan API agar dapat diberi lebih dari alokasi kuota default sebesar 10.000 unit. Hingga saat ini, proses audit kepatuhan dan permintaan untuk alokasi unit kuota tambahan telah dilakukan oleh developer yang mengisi dan mengirimkan Layanan YouTube API - Formulir Audit dan Perluasan Kuota.
Untuk memperjelas proses ini dan lebih memenuhi kebutuhan developer yang menggunakan Layanan API, kami menambahkan tiga formulir baru dan panduan untuk melengkapi formulir tersebut:
- Formulir Permintaan Developer yang Diaudit: Developer yang telah lulus Audit Kepatuhan API dapat mengisi dan mengirimkan formulir yang lebih singkat ini untuk meminta perpanjangan kuota yang dialokasikan.
- Formulir Permohonan Banding: Developer yang project API-nya gagal dalam audit kepatuhan (atau penolakan penambahan unit kuota) dapat mengisi dan mengirimkan formulir ini.
- Formulir Perubahan Kontrol: Developer, atau pihak mana pun yang mengoperasikan klien API atas nama developer, yang mengalami perubahan kontrol (misalnya, melalui pembelian atau penjualan saham, merger, atau bentuk transaksi perusahaan lainnya) yang terkait dengan project API harus mengisi dan mengirimkan formulir ini. Dengan begitu, tim API YouTube dapat memperbarui catatan kami, mengaudit kepatuhan kasus penggunaan project API baru, dan memvalidasi alokasi kuota developer saat ini.
Setiap formulir baru akan memberi tahu kami tentang tujuan penggunaan API YouTube sehingga kami dapat membantu Anda dengan lebih baik.
Detail selengkapnya tersedia di panduan Audit Kepatuhan API yang baru.
12 Mei 2021
Catatan: Ini adalah pengumuman penghentian penggunaan.
Update ini mencakup perubahan API berikut:
-
Resource
channel
contentDetails.relatedPlaylists.favorites
tidak digunakan lagi. Fungsi video favorit sudah tidak digunakan lagi untuk selama beberapa tahun seperti yang disebutkan dalam 28 April 2016, entri histori.Sebelum pembaruan ini, API masih akan membuat playlist baru jika klien API mencoba menambahkan video ke daftar putar favorit yang tidak ada. Untuk selanjutnya, playlist tidak akan yang dibuat dalam hal ini dan API akan menampilkan error. Upaya untuk mengubah playlist favorit dengan menambahkan, memodifikasi, atau menghapus item juga tidak digunakan lagi sesuai dengan pengumuman sebelumnya dan mungkin mulai memunculkan pesan {i>error<i} kapan saja.
-
Resource
channel
berikut properti tidak digunakan lagi. Properti ini sudah tidak didukung di UI YouTube Studio dan di YouTube. Akibatnya, video tersebut juga tidak lagi didukung melalui API.brandingSettings.channel.defaultTab
brandingSettings.channel.featuredChannelsTitle
brandingSettings.channel.featuredChannelsUrls[]
brandingSettings.channel.profileColor
brandingSettings.channel.showBrowseView
brandingSettings.channel.showRelatedChannels
Semua properti telah dihapus dari
channel
representasi resource, dan definisinya telah dihapus dari daftar properti. Selain itu, error yang terkait dengan properti ini telah dihapus dari dokumentasi khusus metode. -
Resource
channelSection
berikut properti tidak digunakan lagi. Properti ini sudah tidak didukung di UI YouTube Studio dan di YouTube. Akibatnya, video tersebut juga tidak lagi didukung melalui API.snippet.style
snippet.defaultLanguage
snippet.localized.title
localizations
localizations.(key)
localizations.(key).title
targeting
targeting.languages[]
targeting.regions[]
targeting.countries[]
Sehubungan dengan perubahan ini, metode
channelSection.list
Parameterhl
juga memiliki tidak digunakan lagi karena fitur yang didukungnya tidak didukung.Semua properti telah dihapus dari
channelSection
representasi resource, dan definisinya telah dihapus dari daftar properti. Selain itu, error yang terkait dengan properti ini telah dihapus dari dokumentasi khusus metode. -
Untuk resource
channelSection
snippet.type
, nilai berikut tidak digunakan lagi. Nilai ini sudah tidak didukung di YouTube halaman channel dan, akibatnya, halaman tersebut juga tidak lagi didukung melalui API ini.likedPlaylists
likes
postedPlaylists
postedVideos
recentActivity
recentPosts
-
Resource
playlist
Propertisnippet.tags[]
tidak digunakan lagi. Properti ini sudah tidak didukung di YouTube, dan akibatnya, video tersebut tidak lagi didukung melalui API.
9 Februari 2021
Resource playlistItem
mendukung dua properti baru:
snippet.videoOwnerChannelId
mengidentifikasi ID channel yang mengupload video playlist.snippet.videoOwnerChannelTitle
menunjukkan nama channel yang mengupload video playlist.
28 Januari 2021
Update ini berisi perubahan berikut:
-
playlistItems.delete
,playlistItems.insert
,playlistItems.list
,playlistItems.update
,playlists.delete
,playlists.list
, dan Semua metodeplaylists.update
mendukung errorplaylistOperationUnsupported
baru. Error terjadi saat permintaan mencoba melakukan operasi yang tidak diizinkan untuk daftar putar tertentu. Misalnya, pengguna tidak bisa menghapus video dari playlist video yang diuploadnya atau menghapus playlist itu sendiri.Dalam semua kasus, error ini akan menampilkan kode respons HTTP
400
(Permintaan Buruk). -
Metode
playlistItems.list
ErrorwatchHistoryNotAccessible
danwatchLaterNotAccessible
memiliki telah dihapus dari dokumentasi. Sementara pengguna histori tontonan dan daftar tonton nanti, memang tidak dapat diakses melalui API, error khusus ini tidak ditampilkan oleh API.
15 Oktober 2020
Dua bagian baru telah ditambahkan ke Developer Kebijakan:
- Bagian III.E.4.i yang baru memberikan informasi tambahan tentang data yang dikumpulkan dan dikirim melalui pemutar tersemat YouTube. Anda bertanggung jawab atas setiap data pengguna yang Anda kirimkan kepada kami melalui pemutar tersemat YouTube sebelum pengguna telah berinteraksi dengan pemutar untuk menunjukkan intent pemutaran. Anda dapat membatasi data yang dibagikan dengan YouTube sebelum pengguna berinteraksi dengan pemutar dengan menyetel Putar Otomatis ke false.
- Bagian III.E.4.j yang baru terkait memeriksa status konten yang Dibuat untuk Anak-Anak (MFK) sebelum menyematkannya di situs Anda dan aplikasi. Anda bertanggung jawab untuk mengetahui kapan video yang Anda sematkan di Klien API dibuat untuk anak-anak, dan memperlakukan data yang dikumpulkan dari pemutar tersemat sebagaimana mestinya. Dengan demikian, Anda harus memeriksa status konten menggunakan Layanan YouTube Data API sebelum menyematkannya ke API Anda Klien melalui pemutar tersemat YouTube.
Menemukan status MadeForKids video baru ini menjelaskan cara mencari status Dibuat untuk Anak-Anak dari video menggunakan Layanan YouTube Data API.
Sehubungan dengan perubahan ini, pengingat telah ditambahkan ke Dokumentasi Parameter Pemutar Tersemat untuk menjelaskan bahwa jika Anda mengaktifkan Putar Otomatis, pemutaran akan terjadi tanpa interaksi pengguna dengan pemutar; pemutaran pengumpulan dan berbagi data akan dilakukan setelah laman dimuat.
8 Oktober 2020
Update ini mencakup tiga perubahan kecil terkait
Referensi channel
:
snippet.thumbnails
, yang mengidentifikasi gambar thumbnail channel, mungkin kosong untuk elemen saluran dan mungkin memerlukan waktu hingga satu hari.statistics.videoCount
mencerminkan jumlah video publik channel saja, bahkan kepada pemilik. Perilaku ini konsisten dengan jumlah yang ditampilkan di situs YouTube.- Kata kunci saluran, yang diidentifikasi dalam
brandingSettings.channel.keywords
properti, mungkin dipangkas jika melebihi panjang maksimum 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. Perilaku ini sesuai dengan yang terjadi di situs YouTube.
9 September 2020
Catatan: Ini adalah pengumuman penghentian penggunaan.
Update ini mencakup perubahan API berikut. Semua perubahan akan berlaku pada atau setelah 9 September 2020, tanggal pengumuman ini. Dengan mengingat hal itu, developer seharusnya tidak lagi mengandalkan salah satu fitur API yang tercantum di bawah ini.
-
Resource, metode, parameter, dan properti resource API berikut tidak digunakan lagi
segera dan akan berhenti berfungsi pada atau setelah tanggal pengumuman ini:
- Resource
channel
berikut properti:- Properti
statistics.commentCount
- Objek
brandingSettings.image
dan semua properti turunannya - Daftar
brandingSettings.hints
dan semua properti turunannya
- Properti
- Metode
channels.list
Parameter filtercategoryId
- Resource
guideCategories
danguideCategories.list
metode
- Resource
-
Respons API untuk
Metode
channels.list
tidak lagi memuatprevPageToken
jika permintaan API menetapkan ParametermanagedByMe
ketrue
. Perubahan ini tidak memengaruhi propertiprevPageToken
untuk permintaanchannels.list
lainnya, dan hal ini tidak memengaruhinextPageToken
untuk setiap permintaan. -
contentDetails.relatedPlaylists.watchLater
resourcechannel
dancontentDetails.relatedPlaylists.watchHistory
properti diumumkan tidak digunakan lagi pada 11 Agustus 2016. Tujuan Dukungan metodeplaylistItems.insert
dan metodeplaylistItems.delete
untuk playlist ini juga sudah tidak digunakan lagi, dan kedua properti tersebut telah dihapus dari dokumentasi. -
Parameter
mySubscribers
metodechannels.list
, yang yang diumumkan sebagai tidak digunakan lagi pada 30 Juli 2013, telah dihapus dari dokumentasi. Gunakan Metodesubscriptions.list
dan parametermySubscribers
-nya untuk mengambil daftar pelanggan pada saluran pengguna yang telah diautentikasi. -
Objek
invideoPromotion
resourcechannel
dan semua turunannya properti, yang diumumkan sebagai tidak digunakan lagi pada 27 November 2017, telah dihapus dari dokumentasi.
29 Juli 2020
Kami telah menyederhanakan proses penagihan kuota untuk permintaan API dengan menghapus
biaya yang terkait dengan parameter part
. Berlaku segera, kami hanya akan menagih
biaya dasar untuk metode yang dipanggil. Anda dapat menemukan informasi selengkapnya tentang
kuota di sini.
Efek dari perubahan ini adalah sebagian besar panggilan API akan memiliki biaya kuota yang sedikit lebih rendah, sedangkan beberapa panggilan API akan tetap memiliki biaya yang sama. Perubahan ini tidak meningkatkan biaya API apa pun panggilan telepon. Secara keseluruhan, kemungkinan dampaknya adalah kuota yang dialokasikan. Konsol Google Cloud, akan selangkah lebih maju.
Sebaiknya semua developer menyelesaikan audit kepatuhan terhadap project untuk memastikan keberlanjutan akses ke Layanan YouTube API.
Entri histori revisi ini awalnya dipublikasikan pada 20 Juli 2020.
28 Juli 2020
Semua video diupload melalui videos.insert
endpoint dari project API yang belum diverifikasi yang dibuat setelah 28 Juli 2020 akan dibatasi untuk
mode tampilan pribadi. Untuk mencabut batasan ini, setiap project harus
menjalani audit untuk memverifikasi
kepatuhan terhadap
Persyaratan Layanan.
Kreator yang menggunakan klien API yang belum diverifikasi untuk mengupload video akan menerima email yang menjelaskan bahwa video mereka dikunci sebagai pribadi, dan mereka dapat menghindari pembatasan dengan atau klien yang diaudit.
Project API yang dibuat sebelum 28 Juli 2020 saat ini tidak terpengaruh oleh perubahan ini. Namun, sebaiknya semua developer menyelesaikan audit kepatuhan untuk project mereka guna memastikan keberlanjutan akses ke Layanan YouTube API.
21 Juli 2020
[Diperbarui pada 28 Juli 2020.] Pembaruan dokumentasi yang dirujuk dalam revisi ini entri sejarah dipublikasikan ulang pada 28 Juli 2020.
Kemarin, kami memublikasikan pembaruan dokumentasi terkait proses kami untuk menagih kuota. Namun, karena keadaan yang tidak terduga, perubahan kuota belum berlaku. Hasilnya, dokumentasi telah dikembalikan demi akurasi. Untuk menghindari kebingungan, revisi entri histori yang menjelaskan perubahan telah dihapus dan akan dipublikasikan ulang dalam waktu dekat.
7 Juli 2020
Catatan: Ini adalah pengumuman penghentian penggunaan.
Metode videos.insert
Parameter autoLevels
dan stabilize
kini tidak digunakan lagi, dan keduanya
parameter telah dihapus dari dokumentasi. Nilainya diabaikan dan tidak memengaruhi
cara memproses video yang baru diupload.
15 Juni 2020
Versi baru Mematuhi Panduan Developer YouTube Panduan kebijakan memberikan panduan dan contoh untuk membantu Anda memastikan bahwa klien API Anda mematuhinya bagian tertentu dari Layanan YouTube API Persyaratan dan Kebijakan (TOS API).
Panduan ini memberikan insight tentang cara YouTube menegakkan aspek tertentu dari TOS API, tetapi tidak menggantikan dokumen yang ada. Panduan ini membahas beberapa pertanyaan paling umum yang yang diajukan developer selama audit kepatuhan API. Semoga ini menyederhanakan pengembangan fitur Anda dengan membantu Anda memahami cara kami menafsirkan dan menegakkan kebijakan kami.
4 Juni 2020
Catatan: Ini adalah pembaruan untuk pengumuman penghentian sebelumnya.
Fitur buletin saluran kini sepenuhnya tidak digunakan lagi. Perubahan ini pertama kali diumumkan
pada 17 April 2020 dan sekarang sudah diberlakukan. Hasilnya,
Metode activities.insert
tidak
tidak lagi didukung, dan
activities.list
tidak lagi mengembalikan buletin saluran. Untuk detail selengkapnya, lihat
Pusat Bantuan YouTube.
17 April 2020
Catatan: Ini adalah pengumuman penghentian penggunaan.
YouTube akan menghentikan fitur buletin channel. Hasilnya,
Metode activities.insert
akan menjadi
tidak digunakan lagi, dan activities.list
akan berhenti menampilkan buletin saluran. Perubahan ini akan berlaku pada API pada atau
setelah 18 Mei 2020. Untuk detail selengkapnya, lihat
Pusat Bantuan YouTube.
31 Maret 2020
Update ini berisi perubahan berikut:
-
Referensi dan metode baru
-
Resource
member
baru mewakili pelanggan channel untuk channel YouTube. Seorang anggota memberikan dukungan keuangan berulang kepada kreator dan menerima manfaat khusus. Misalnya, pelanggan dapat melakukan chat jika kreator mengaktifkan mode khusus pelanggan untuk chat.Resource ini menggantikan
sponsor
, yang didokumentasikan sebagai bagian dari YouTube Live Streaming API. Tujuan Resourcesponsor
sekarang tidak digunakan lagi dan klien API harus memperbarui panggilan ke metodesponsors.list
untuk menggunakan Sebagai gantinya, metodemembers.list
. -
membershipsLevel
baru mengidentifikasi level harga yang dikelola oleh kreator yang mengizinkan permintaan API.membershipsLevels.list
yang berisi daftar semua level keanggotaan kreator.
-
January 10, 2020
API tersebut kini mendukung kemampuan untuk mengidentifikasi konten yang ditujukan untuk anak-anak, yang dipanggil YouTube "Dibuat untuk Anak-Anak". Pelajari lebih lanjut "Dibuat untuk Anak-Anak" konten di Pusat Bantuan YouTube.
channel
dan
Resource video
mendukung dua properti baru untuk
memungkinkan kreator konten dan penonton mengidentifikasi konten yang Dibuat untuk Anak-Anak:
-
Properti
selfDeclaredMadeForKids
memungkinkan kreator konten menentukan apakah channel atau video dibuat untuk anak-anak.
Untuk saluran, properti ini dapat diatur saat memanggil Metodechannels.update
. Untuk video, properti ini dapat diatur saat memanggil metodevideos.insert
atau Metodevideos.update
.
Perhatikan bahwa properti ini hanya disertakan dalam respons API yang berisichannel
atauvideo
resource jika pemilik channel mengizinkan permintaan API. -
Properti
madeForKids
memungkinkan pengguna mengambil kategori "Dibuat untuk Anak-Anak" status channel atau video. Misalnya, statusnya mungkin ditentukan berdasarkan nilai propertiselfDeclaredMadeForKids
. Lihat Pusat Bantuan YouTube untuk informasi lebih lanjut informasi tentang cara menetapkan penonton untuk channel, video, atau siaran Anda.
Kami juga telah memperbarui Persyaratan Layanan untuk Layanan YouTube API dan Kebijakan Developer. Memohon lihat Persyaratan Layanan untuk Layanan YouTube API - Revisi Histori untuk mengetahui informasi selengkapnya. Perubahan pada Persyaratan Layanan untuk Layanan YouTube API dan Kebijakan Developer akan berlaku pada 10 Januari 2020 Waktu Pasifik.
10 September 2019
Dokumentasi referensi API telah diperbarui untuk mencerminkan perubahan pada cara pelanggan
jumlah dilaporkan di YouTube dan, akibatnya, dalam respons API. Sebagai hasil dari perubahan tersebut,
jumlah subscriber yang ditampilkan oleh Layanan YouTube Data API dibulatkan ke bawah menjadi tiga
untuk jumlah pelanggan yang lebih besar dari 1.000 pelanggan. Perubahan ini memengaruhi
channel
resource
statistics.subscriberCount
saat ini.
Catatan: Perubahan ini akan memengaruhi nilai properti ini bahkan saat pengguna mengirim permintaan resmi untuk data tentang channel-nya sendiri. Pemilik channel masih dapat melihat persisnya jumlah subscriber di YouTube Studio.
Misalnya, jika suatu channel memiliki 123.456 subscriber,
Properti statistics.subscriberCount
akan berisi nilai 123000
.
Tabel di bawah ini menunjukkan contoh bagaimana jumlah pelanggan dibulatkan pada respons API dan
disingkat dalam antarmuka pengguna YouTube lain yang bisa dilihat publik:
Contoh jumlah subscriber | YouTube Data API | UI YouTube yang terlihat secara publik |
---|---|---|
1,234 | 1230 | 1,23 rb |
12.345 | 12300 | 12,3 RB |
123.456. | 123000 | 123 rb |
1.234.567 | 1230000 | 1,23 jt |
12.345.678 | 12300000 | 12,3 jt |
123.456.789 | 123000000 | 123 jt |
4 April 2019
Update ini berisi perubahan berikut:
-
Dokumentasi referensi API telah diperbarui untuk menjelaskan dengan lebih baik kasus penggunaan umum untuk setiap metode dan untuk memberikan contoh kode yang dinamis dan berkualitas tinggi melalui widget APIs Explorer. Lihat dokumentasi metode
channels.list
untuk mengetahui contohnya. Sekarang ada dua elemen baru pada halaman yang menjelaskan metode API:-
Widget APIs Explorer memungkinkan Anda memilih cakupan otorisasi, memasukkan contoh parameter dan nilai properti, lalu mengirim permintaan API yang sebenarnya dan melihat respons API yang sebenarnya. Widget juga menawarkan tampilan layar penuh yang menunjukkan contoh kode lengkap, yang diperbarui secara dinamis untuk menggunakan cakupan dan nilai yang telah Anda masukkan.
-
Bagian Kasus penggunaan umum menjelaskan satu atau beberapa kasus penggunaan umum untuk metode yang dijelaskan di halaman. Misalnya, Anda dapat memanggil metode
channels.list
untuk mengambil data tentang saluran tertentu atau mengambil data tentang saluran pengguna saat ini.Anda dapat menggunakan link di bagian tersebut untuk mengisi APIs Explorer dengan nilai contoh untuk kasus penggunaan Anda atau membuka APIs Explorer layar penuh dengan nilai yang sudah diisi. Perubahan ini bertujuan untuk memudahkan Anda melihat contoh kode yang secara langsung berlaku untuk kasus penggunaan yang coba Anda terapkan di aplikasi Anda sendiri.
Contoh kode saat ini didukung untuk Java, JavaScript, PHP, Python, dan curl.
-
-
Alat contoh kode juga telah diupdate dengan UI baru yang menawarkan semua fitur yang sama seperti yang dijelaskan di atas. Dengan menggunakan alat tersebut, Anda dapat mempelajari kasus penggunaan untuk berbagai metode, memuat nilai ke dalam APIs Explorer, dan membuka APIs Explorer layar penuh untuk mendapatkan contoh kode di Java, JavaScript, PHP, dan Python.
Sehubungan dengan perubahan ini, halaman yang sebelumnya mencantumkan contoh kode yang tersedia untuk Java, JavaScript, PHP, dan Python telah dihapus.
-
Panduan memulai untuk Java, JavaScript, PHP, dan Python telah diperbarui. Panduan yang direvisi tersebut menjelaskan cara menjalankan satu contoh dengan kunci API dan contoh lainnya dengan client ID OAuth 2.0 menggunakan contoh kode dari APIs Explorer.
Perhatikan bahwa perubahan yang dijelaskan di atas menggantikan alat interaktif yang telah ditambahkan ke dokumentasi API di tahun 2017.
9 Juli 2018
Update ini berisi perubahan berikut:
-
Definisi properti
snippet.thumbnails
resourcechannel
telah diperbarui untuk memperhatikan bahwa saat menampilkan thumbnail di aplikasi, kode Anda harus menggunakan URL gambar persis seperti yang ditampilkan dalam respons API. Misalnya, aplikasi Anda tidak boleh menggunakan domainhttp
, bukan domainhttps
, di URL yang ditampilkan dalam respons API.Mulai Juli 2018, URL thumbnail channel hanya akan tersedia di domain
https
, yang merupakan tampilan URL dalam respons API. Setelah itu, Anda mungkin melihat gambar rusak di aplikasi jika mencoba memuat gambar YouTube dari domainhttp
. -
Catatan: Ini adalah pengumuman penghentian penggunaan.
Properti
recordingDetails.location.altitude
resourcevideo
tidak digunakan lagi. Tidak ada jaminan bahwa video akan menampilkan nilai untuk properti ini. Demikian pula, meskipun permintaan API mencoba menetapkan nilai untuk properti tersebut, data yang masuk kemungkinan tidak akan disimpan.
22 Juni 2018
Panduan penerapan, sebelumnya disebut Panduan Penerapan dan Migrasi telah diperbarui untuk menghapus petunjuk migrasi dari v2 ke API v3. Selain itu, petunjuk juga telah dihapus untuk fitur yang karena tidak digunakan lagi dalam API v3, seperti video favorit.
27 November 2017
Update ini berisi perubahan berikut:
-
Catatan: Ini adalah pengumuman penghentian penggunaan.
YouTube akan menghapus dukungan untuk fitur Video Unggulan dan Situs Unggulan, yang didukung di API melalui objek
invideoPromotion
resourcechannel
. Akibatnya, objek tersebut, termasuk semua properti turunannya, tidak digunakan lagi.Anda tetap dapat mengambil dan menetapkan data
invideoPromotion
hingga 14 Desember 2017. Setelah tanggal tersebut:- Upaya untuk mengambil bagian
invideoPromotion
saat memanggilchannels.list
akan menampilkaninvideoPromotion
kosong atau tidak akan menampilkan datainvideoPromotion
sama sekali. - Percobaan untuk mengupdate data
invideoPromotion
saat memanggilchannels.update
akan menampilkan respons yang berhasil hingga setidaknya 27 Mei 2018, tetapi akan diperlakukan sebagai tanpa pengoperasian, yang berarti bahwa aplikasi tidak akan benar-benar melakukan update.
Setelah 27 Mei 2018, permintaan ini mungkin menampilkan pesan error untuk menunjukkan, misalnya, bahwa
invalidPromotion
adalah bagian yang tidak valid. - Upaya untuk mengambil bagian
16 November 2017
Update ini berisi perubahan berikut:
-
Alat cuplikan kode interaktif kini mendukung contoh kode Node.js. Contoh ini juga terlihat dalam dokumentasi untuk hampir semua metode API, seperti metode
channels.list
.Contoh yang dapat disesuaikan didesain untuk memberi Anda titik awal yang spesifik untuk kasus penggunaan untuk aplikasi Node.js. Fungsinya mirip dengan kode di panduan memulai Node.js. Namun, contoh berisi beberapa fungsi utilitas yang tidak tercantum di panduan memulai:
- Fungsi
removeEmptyParameters
mengambil daftar key-value pair yang sesuai dengan parameter permintaan API dan menghapus parameter yang tidak memiliki nilai. - Fungsi
createResource
mengambil daftar key-value pair yang sesuai dengan properti di resource API. Kemudian, properti ini mengonversi properti menjadi objek JSON yang dapat digunakan dalam operasiinsert
danupdate
. Contoh di bawah ini menunjukkan kumpulan nama dan nilai properti serta objek JSON yang akan dibuat oleh kode untuk keduanya:# Key-value pairs: {'id': 'ABC123', 'snippet.title': 'Resource title', 'snippet.description': 'Resource description', 'status.privacyStatus': 'private'} # JSON object: { 'id': 'ABC123', 'snippet': { 'title': 'Resource title', 'description': 'Resource description', }, 'status': { 'privacyStatus': 'private' } }
Semua contoh ini dirancang untuk didownload dan dijalankan secara lokal. Untuk informasi selengkapnya, lihat prasyarat untuk menjalankan contoh kode lengkap secara lokal dalam petunjuk alat cuplikan kode.
- Fungsi
25 Oktober 2017
Update ini berisi perubahan berikut:
-
Contoh kode Python di alat cuplikan kode interaktif telah diupdate untuk menggunakan library
google-auth
dangoogle-auth-oauthlib
, bukan libraryoauth2client
yang kini tidak digunakan lagi.Selain perubahan tersebut, alat ini sekarang menyediakan contoh kode lengkap untuk aplikasi Python dan aplikasi server web Python yang terinstal, yang menggunakan alur otorisasi yang sedikit berbeda. Untuk melihat contoh lengkap (dan perubahan ini):
- Buka alat cuplikan kode interaktif atau buka dokumentasi untuk metode API apa pun, seperti metode
channels.list
. - Klik tab
Python
di atas contoh kode. - Klik tombol di atas tab untuk beralih dari melihat cuplikan ke contoh lengkap.
- Sekarang tab seharusnya menampilkan contoh kode lengkap yang menggunakan alur otorisasi
InstalledAppFlow
. Deskripsi di atas contoh menjelaskan hal ini dan juga menautkan ke contoh untuk aplikasi server web. - Klik link ini untuk beralih ke contoh server web. Sampel tersebut menggunakan framework aplikasi web Flask dan alur otorisasi yang berbeda.
Semua contoh ini dirancang untuk didownload dan dijalankan secara lokal. Jika Anda ingin menjalankan contoh, lihat petunjuk untuk menjalankan contoh kode lengkap secara lokal dalam petunjuk alat cuplikan kode.
- Buka alat cuplikan kode interaktif atau buka dokumentasi untuk metode API apa pun, seperti metode
29 Agustus 2017
Update ini berisi perubahan berikut:
- Definisi parameter
forContentOwner
metodesearch.list
telah diperbarui untuk memperhatikan bahwa jika parameter tersebut disetel ketrue
, parametertype
harus ditetapkan kevideo
. - Definisi parameter
regionCode
metodesearch.list
telah diperbarui untuk mengklarifikasi bahwa parameter tersebut membatasi hasil penelusuran untuk video yang dapat ditonton di wilayah yang ditentukan. - YouTube telah memperbarui logo dan ikon brandingnya. "Dikembangkan dengan YouTube" baru logo dapat didownload dari halaman pedoman branding. Logo dan ikon YouTube baru lainnya juga ditampilkan di halaman tersebut dan dapat didownload dari situs brand YouTube.
24 Juli 2017
Update ini berisi perubahan berikut:
- Panduan memulai baru YouTube Data API tersedia untuk iOS. Panduan ini menjelaskan cara menggunakan YouTube Data API pada aplikasi iOS sederhana yang ditulis dalam Objective-C atau Swift.
- Alat cuplikan kode interaktif untuk YouTube Data API kini menyertakan dokumentasi yang menjelaskan beberapa fitur alat:
- Mengeksekusi permintaan API
- Beralih antara cuplikan kode dan contoh kode lengkap
- Menggunakan fungsi boilerplate
- Memuat resource yang ada (untuk metode update)
Catatan: Alat ini juga disematkan di dokumentasi referensi API untuk metode API (contoh).
1 Juni 2017
Update ini berisi perubahan berikut:
-
Catatan: Ini adalah pengumuman penghentian penggunaan.
Properti resource
video
berikut tidak digunakan lagi. Meskipun properti akan didukung hingga 1 Desember 2017, tidak ada jaminan bahwa video akan terus menampilkan nilai untuk properti tersebut hingga waktu tersebut. Demikian pula, permintaanvideos.insert
danvideos.update
yang menetapkan nilai properti tersebut tidak akan menghasilkan error sebelum tanggal tersebut, tetapi ada kemungkinan data yang masuk tidak akan disimpan.
17 Mei 2017
Update ini berisi perubahan berikut:
-
Dokumentasi referensi API telah diperbarui untuk membuat cuplikan kode lebih ada di mana-mana dan interaktif. Halaman yang menjelaskan metode API, seperti
channels.list
atauvideos.rate
, kini menampilkan alat interaktif yang memungkinkan Anda melihat dan menyesuaikan cuplikan kode di Java, JavaScript, PHP, Python, Ruby, Apps Script, dan Go.Untuk setiap metode, alat ini menampilkan cuplikan kode untuk satu atau beberapa kasus penggunaan, dan setiap kasus penggunaan menjelaskan cara umum untuk memanggil metode tersebut. Misalnya, Anda dapat memanggil metode
channels.list
untuk mengambil data tentang saluran tertentu atau saluran pengguna saat ini.Anda juga dapat berinteraksi dengan contoh kode:
-
Ubah parameter dan nilai properti, dan cuplikan kode akan diperbarui secara dinamis untuk mencerminkan nilai yang Anda berikan.
-
Beralih antara cuplikan kode dan contoh lengkap. Cuplikan kode menunjukkan bagian dari kode yang memanggil metode API. Contoh lengkap berisi cuplikan tersebut serta kode boilerplate untuk memberi otorisasi dan mengirim permintaan. Contoh lengkap dapat disalin dan dijalankan dari command line atau server web lokal.
-
Jalankan permintaan dengan mengklik tombol. (Untuk mengeksekusi permintaan, Anda harus mengizinkan alat untuk memanggil API atas nama Anda.)
Perhatikan bahwa alat ini telah menggantikan APIs Explorer di halaman tempat fitur ini tersedia. (Setiap halaman menampilkan link sehingga Anda juga memiliki opsi untuk memuat permintaan yang sedang Anda kerjakan di APIs Explorer.)
-
-
Alat Cuplikan Kode API Data juga telah diupdate dengan UI baru yang menawarkan semua fitur yang sama seperti yang dijelaskan di atas. Fitur baru utama yang tersedia di halaman ini adalah:
- Dukungan untuk permintaan API yang menulis data.
- Dukungan untuk contoh Java.
- Kode boilerplate yang lebih fleksibel dan komprehensif untuk memberi otorisasi kepada pengguna dan membuat permintaan API.
27 April 2017
Update ini berisi perubahan berikut:
- Panduan memulai baru menjelaskan cara menyiapkan aplikasi sederhana yang membuat permintaan YouTube Data API. Panduan saat ini tersedia untuk Android, Apps Script, Go, Java, JavaScript, Node.js, PHP, Python, dan Ruby.
30 Maret 2017
Update ini berisi perubahan berikut:
- Properti
topicDetails.topicCategories[]
baru dari resourcechannel
berisi daftar URL Wikipedia yang menjelaskan konten channel. URL ini sesuai dengan ID topik yang ditampilkan di propertitopicDetails.topicIds[]
resource. - Properti
contentDetails.videoPublishedAt
baru dari resourceplaylistItem
mengidentifikasi waktu video dipublikasikan ke YouTube. Resource sudah berisi propertisnippet.publishedAt
, yang mengidentifikasi waktu saat item ditambahkan ke playlist. - Seperti resource
channel
, resourcevideo
kini menampilkan propertitopicDetails.topicCategories[]
, yang berisi daftar URL Wikipedia yang menjelaskan konten video. Untuk resourcevideo
, URL sesuai dengan ID topik yang ditampilkan di propertitopicDetails.relevantTopicIds[]
resource. - Properti
contentDetails.contentRating.mpaatRating
baru dari resourcevideo
mengidentifikasi rating yang diberikan Motion Picture Association of America ke cuplikan atau pratinjau film.
27 Februari 2017
Seperti yang telah diumumkan pada 11 Agustus 2016, YouTube telah mengubah daftar ID topik yang didukung menjadi daftar hasil seleksi. Daftar lengkap ID topik yang didukung disertakan di properti topicDetails
untuk resource channel
dan video
serta di parameter topicId
metode search.list
.
Perlu diketahui bahwa ada beberapa perubahan pada daftar pilihan:
- Topik berikut telah ditambahkan sebagai subtopik dari
Society
:Nama ID topik Bisnis /m/09s1f
Kesehatan /m/0kt51
Militer /m/01h6rj
Politik /m/05qt0
Agama /m/06bvp
- Topik
Animated cartoon
, yang sebelumnya merupakan turunan dariEntertainment
, telah dihapus. - Topik
Children's music
, yang sebelumnya merupakan turunan dariMusic
, telah dihapus.
Akibat perubahan ini, topik yang terkait dengan video kini selalu ditampilkan di nilai properti topicDetails.relevantTopicIds[]
resource video
.
29 November 2016
Update ini berisi perubahan berikut:
-
Ada tiga perubahan kecil pada daftar ID topik yang akan didukung mulai 10 Februari 2017:
- Kategori
Professional wrestling
, yang sebelumnya merupakan turunan dari kategoriSports
, sekarang merupakan turunan dariEntertainment
. - Kategori
TV shows
, yang merupakan turunan dariEntertainment
, adalah kategori baru. - Kategori
Health
, yang sebelumnya adalah turunan dariLifestyle
, telah dihapus.
Perhatikan juga bahwa ada beberapa kategori induk (
Entertainment
,Gaming
,Lifestyle
,Music
, danSports
). Semua video yang terkait dengan kategori anak, sepertiTennis
, juga akan dikaitkan dengan kategori induk (Sports
). - Kategori
10 November 2016
Update ini berisi perubahan berikut:
-
Seperti yang pertama kali diumumkan pada tanggal 11 Agustus 2016, penghentian Freebase dan Freebase API memerlukan beberapa perubahan terkait ID topik. ID topik mengidentifikasi topik yang terkait dengan referensi
channel
danvideo
, dan Anda juga dapat menggunakan parameter penelusurantopicId
untuk menemukan channel atau video yang terkait dengan topik tertentu.Pada 10 Februari 2017, YouTube akan mulai menampilkan sejumlah kecil ID topik, bukan kumpulan ID yang jauh lebih terperinci yang ditampilkan sejauh ini. Selain itu, perlu diperhatikan bahwa channel dan video tidak dijamin akan dikaitkan dengan topik apa pun, sesuai dengan perilaku API saat ini.
Agar Anda dapat mempersiapkan Klien API untuk perubahan tersebut, definisi parameter dan properti API berikut telah diperbarui untuk mencantumkan ID topik yang akan didukung setelah waktu tersebut. Perhatikan bahwa daftar kategori sama untuk semua properti.
- Properti
topicDetails.topicIds[]
resourcechannel
. - Properti
topicDetails.relevantTopicIds[]
resourcevideo
. - Parameter
topicId
metodesearch.list
.
- Properti
-
Catatan: Ini adalah pengumuman penghentian penggunaan.
Properti berikut tidak digunakan lagi:
- Properti
topicDetails.topicIds[]
resourcechannel
. Properti ini akan didukung hingga 10 November 2017. - Properti
topicDetails.relevantTopicIds[]
resourcevideo
. Properti ini akan didukung hingga 10 November 2017. - Properti
topicDetails.topicIds[]
resourcevideo
. Properti ini tidak akan berisi nilai setelah 10 Februari 2017. (Setelah tanggal tersebut, nilai propertitopicDetails.relevantTopicIds[]
akan mengidentifikasi semua topik yang terkait dengan video.)
- Properti
-
Karena Freebase tidak digunakan lagi, panduan Menelusuri dengan Topik Freebase telah dihapus dari dokumentasi. Panduan tersebut memberikan contoh kode untuk menunjukkan cara aplikasi bekerja dengan Freebase API.
Selain itu, beberapa contoh kode yang terkait dengan ID topik telah dihapus dari dokumentasi metode
search.list
.
2 November 2016
Update ini berisi perubahan berikut:
-
Properti dan parameter baru
-
Resource
video
berisi beberapa properti baru:-
Properti
player.embedHtml
berisi tag<iframe>
yang dapat Anda gunakan untuk menyematkan pemutar yang memutar video. Propertiplayer.embedHeight
danplayer.embedWidth
yang baru mengidentifikasi dimensi pemutar tersemat. Properti ini hanya ditampilkan jika permintaan API menentukan nilai untuk setidaknya salah satu parametermaxHeight
ataumaxWidth
. Kedua parameter baru tersebut akan dijelaskan nanti dalam entri histori revisi ini. -
Properti
hasCustomThumbnail
yang baru menunjukkan apakah uploader video telah memberikan gambar thumbnail kustom untuk video tersebut atau tidak. Perhatikan bahwa properti ini hanya dapat dilihat oleh uploader video. -
fpbRatingReasons[]
yang baru mengidentifikasi alasan video tersebut menerima rating FPB (Afrika Selatan). -
mcstRating
yang baru mengidentifikasi rating yang diterima video di Vietnam.
-
-
Metode
videos.list
mendukung dua parameter baru,maxHeight
danmaxWidth
. Anda dapat menggunakan parameter atau kedua parameter saat mengambil bagianplayer
dalam resourcevideo
.Secara default, tinggi
<iframe>
yang ditampilkan di propertiplayer.embedHtml
adalah 360 piksel. Lebarnya disesuaikan agar cocok dengan rasio aspek video, sehingga memastikan bahwa pemutar tersemat tidak memiliki kotak hitam yang membingkai video. Jadi, misalnya, jika rasio aspek video adalah 16:9, lebar pemutar adalah 640 piksel.Dengan parameter baru, Anda dapat menetapkan bahwa alih-alih dimensi default, kode sematan harus menggunakan tinggi dan/atau lebar yang sesuai untuk tata letak aplikasi Anda. Server API menskalakan dimensi pemutar sebagaimana mestinya untuk memastikan pemutar tersemat tidak memiliki kotak hitam yang membingkai video. Perhatikan bahwa kedua parameter menentukan dimensi maksimum pemutar tersemat. Jadi, jika kedua parameter ditentukan, satu dimensi mungkin masih lebih kecil dari jumlah maksimum yang diizinkan untuk dimensi tersebut.
Misalnya, video memiliki rasio aspek 16:9. Dengan demikian, tag
player.embedHtml
akan berisi pemutar berukuran 640x360 jika parametermaxHeight
ataumaxWidth
tidak ditetapkan.- Jika parameter
maxHeight
disetel ke720
, dan parametermaxWidth
tidak disetel, API akan menampilkan pemutar berukuran 1280x720. - Jika parameter
maxWidth
disetel ke960
, dan parametermaxHeight
tidak disetel, API akan menampilkan pemutar berukuran 960x540. - Jika parameter
maxWidth
disetel ke960
, dan parametermaxHeight
disetel ke450
, API akan menampilkan pemutar berukuran 800x450.
Properti
player.embedHeight
danplayer.embedWidth
baru, yang dijelaskan di atas, mengidentifikasi dimensi pemutar. - Jika parameter
-
-
Pembaruan pada metode, properti, dan parameter yang ada
-
Deskripsi aset
channelSection
telah diperbarui untuk menunjukkan bahwa saluran dapat membuat maksimum 10 galeri tanpa menetapkan data penargetan dan dapat membuat maksimum 100 galeri dengan data penargetan.Selain itu, properti
targeting
resourcechannelSection
telah diperbarui untuk mencerminkan fakta bahwa opsi penargetan hanya dapat ditetapkan menggunakan API. Opsi penargetan akan dihapus jika bagian channel diubah menggunakan antarmuka pengguna di situs YouTube. -
Definisi properti
snippet.name
resourcei18nLanguage
telah dikoreksi untuk mencerminkan bahwa nilai tersebut mewakili nama bahasa seperti yang ditulis dalam bahasa yang ditentukan oleh parameterhl
metodei18nLanguage.list
. -
Properti
contentDetails.note
resourceplaylistItem
telah diperbarui untuk mencatat bahwa panjang maksimum nilai properti adalah 280 karakter. -
Properti
contentDetails.startAt
dancontentDetails.endAt
resourceplaylistItem
tidak digunakan lagi. Kolom ini diabaikan jika ditetapkan dalam permintaanplaylistItems.insert
atauplaylistItems.update
. -
Metode
playlistItems.delete
danplaylistItems.update
kini mendukung parameteronBehalfOfContentOwner
, yang sudah didukung untuk beberapa metode lainnya. Permintaan yang menggunakan metode tersebut juga harus diberi otorisasi dengan token yang memberikan akses ke cakupanhttps://www.googleapis.com/auth/youtubepartner
. -
Parameter
publishedBefore
danpublishedAfter
metodesearch.list
telah diperbarui untuk menunjukkan bahwa nilai parameter bersifat inklusif. Jadi, misalnya, jika parameterpublishedBefore
ditetapkan, API akan menampilkan resource yang dibuat sebelum atau pada waktu yang ditentukan. -
Properti
contentDetails.contentRating.grfilmRating
resourcevideo
mendukung tiga nilai tambahan:grfilmK12
,grfilmK15
, dangrfilmK18
. -
Deskripsi metode
videos.insert
telah diperbarui untuk mencatat bahwa ukuran file maksimum untuk video yang diupload telah ditingkatkan dari 64 GB menjadi 128 GB.
-
-
Error baru dan yang diperbarui
-
API ini mendukung error baru berikut:
Jenis error Detail error Deskripsi forbidden (403)
homeParameterDeprecated
Metode activities.list
menampilkan error ini untuk menunjukkan bahwa data aktivitas halaman beranda pengguna tidak tersedia melalui API ini. Error ini dapat terjadi jika Anda menetapkan parameterhome
ketrue
dalam permintaan yang tidak sah.invalidValue (400)
invalidContentDetails
Metode playlistItems.insert
menampilkan error ini untuk menunjukkan bahwa objekcontentDetails
dalam permintaan tidak valid. Salah satu alasan terjadinya error ini adalah kolomcontentDetails.note
lebih panjang dari 280 karakter.forbidden (403)
watchHistoryNotAccessible
Metode playlistItems.list
menampilkan error ini untuk menunjukkan bahwa permintaan mencoba mengambil "histori tontonan" item playlist, tetapi tidak dapat diambil menggunakan API.forbidden (403)
watchLaterNotAccessible
Metode playlistItems.list
menampilkan error ini untuk menunjukkan bahwa permintaan mencoba mengambil "tonton nanti" item playlist, tetapi tidak dapat diambil menggunakan API.badRequest (400)
uploadLimitExceeded
Metode videos.insert
menampilkan error ini untuk menunjukkan bahwa channel telah melebihi jumlah video yang dapat diuploadnya.forbidden (403)
forbiddenEmbedSetting
Metode videos.update
menampilkan error ini untuk menunjukkan bahwa permintaan API mencoba menetapkan setelan penyematan yang tidak valid untuk video. Perlu diperhatikan bahwa beberapa channel mungkin tidak memiliki izin untuk menawarkan pemutar tersemat untuk live stream. Baca Pusat Bantuan YouTube untuk mengetahui informasi selengkapnya. -
Metode
playlistItems.insert
tidak lagi menampilkan error jika Anda menyisipkan video duplikat ke dalam playlist. Kesalahan tersebut sebelumnya terjadi pada beberapa playlist, seperti video favorit, yang tidak mengizinkan duplikat tetapi tidak lagi didukung. Secara umum, playlist mengizinkan video duplikat.
-
-
Info terbaru lainnya
-
Entri histori revisi untuk 15 September 2016 telah diperbarui untuk mengklarifikasi bahwa, setiap kali properti
contentDetails.relatedPlaylists.watchHistory
dancontentDetails.relatedPlaylists.watchLater
resourcechannel
disertakan dalam respons, keduanya selalu berisi nilaiHL
danWL
. Selain itu, properti tersebut hanya disertakan jika pengguna yang diotorisasi mengambil data tentang saluran pengguna itu sendiri.
-
15 September 2016
Update ini berisi perubahan berikut:
-
Pada 11 Agustus 2016, pembaruan histori revisi membahas beberapa perubahan terkait ID topik, termasuk fakta bahwa kumpulan ID topik yang didukung akan berubah mulai 10 Februari 2017. Daftar topik yang akan didukung akan dipublikasikan paling lambat 10 November 2016.
-
Perubahan berikut sekarang berlaku. Pemberitahuan tentang perubahan ini diberikan dalam pembaruan histori revisi pada 11 Agustus 2016:
-
Jika metode
activities.list
dipanggil dengan parameterhome
yang disetel ketrue
, respons API kini berisi item yang mirip dengan apa yang akan dilihat oleh pengguna YouTube yang telah logout di halaman beranda.Ini adalah perubahan kecil yang dimaksudkan untuk memberikan pengalaman pengguna yang lebih baik daripada perilaku yang dijelaskan dalam pembaruan histori revisi pada 11 Agustus 2016. Update tersebut telah menyatakan bahwa permintaan yang menggunakan parameter
home
akan menampilkan daftar kosong. -
Properti
contentDetails.relatedPlaylists.watchHistory
dancontentDetails.relatedPlaylists.watchLater
resourcechannel
masing-masing sekarang berisi nilaiHL
danWL
untuk semua saluran.Agar jelas, properti ini hanya terlihat oleh pengguna yang diberi otorisasi yang mengambil data tentang saluran pengguna itu sendiri. Properti selalu berisi nilai
HL
danWL
, bahkan untuk pengguna yang diberi otorisasi yang mengambil data tentang saluran pengguna itu sendiri. Dengan demikian, ID histori tontonan dan playlist tonton nanti tidak dapat diambil melalui API.Selain itu, permintaan untuk mengambil detail playlist (
playlists.list
) atau item playlist (playlistItems.list
) untuk histori tontonan channel atau playlist tonton nanti kini menampilkan daftar kosong. Perilaku ini berlaku untuk nilai baru,HL
danWL
, serta untuk semua histori tontonan atau ID playlist tonton nanti yang mungkin telah disimpan oleh Klien API Anda.
-
-
Objek
fileDetails.recordingLocation
resourcevideo
dan properti turunannya tidak lagi ditampilkan. Sebelumnya, data ini (seperti objekfileDetails
induk) hanya dapat diambil oleh pemilik video.
11 Agustus 2016
Update ini berisi perubahan berikut:
-
Persyaratan Layanan untuk Layanan YouTube API ("Persyaratan yang Diperbarui"), yang dibahas secara mendetail di Blog Developer dan Engineering YouTube, menyediakan berbagai pembaruan pada Persyaratan Layanan saat ini. Selain Persyaratan yang Diperbarui, yang akan berlaku mulai 10 Februari 2017, pembaruan ini menyertakan beberapa dokumen pendukung untuk membantu menjelaskan kebijakan yang harus dipatuhi oleh developer.
Kumpulan lengkap dokumen baru dijelaskan di histori revisi untuk Persyaratan yang Diperbarui. Selain itu, perubahan mendatang pada Persyaratan yang Diperbarui atau dokumen pendukung tersebut juga akan dijelaskan dalam histori revisi tersebut. Anda dapat berlangganan feed RSS yang mencantumkan perubahan dalam histori revisi tersebut dari link dalam dokumen tersebut.
-
Penghentian penggunaan Freebase dan Freebase API menyebabkan beberapa perubahan terkait ID topik. ID topik digunakan dalam sumber daya dan metode API berikut:
- Bagian
topicDetails
resourcechannel
mengidentifikasi topik yang terkait dengan channel. - Bagian
topicDetails
resourcevideo
mengidentifikasi topik yang terkait dengan video. - Parameter
topicId
metodesearch.list
memungkinkan Anda menelusuri video atau channel yang terkait dengan topik tertentu.
Perubahan pada fitur ini adalah:
-
Mulai 10 Februari 2017, YouTube akan mulai menampilkan sejumlah kecil ID topik, bukan kumpulan ID yang ditampilkan sejauh ini. Rangkaian topik yang didukung tersebut akan mengidentifikasi kategorisasi tingkat tinggi seperti Olahraga atau Bola basket, tetapi, misalnya, kategorisasi tersebut tidak akan mengidentifikasi tim atau pemain tertentu. Kami akan mengumumkan serangkaian topik yang didukung sehingga Anda memiliki waktu untuk mempersiapkan pendaftaran Anda untuk perubahan ini.
-
Semua ID topik Freebase yang telah Anda ambil dapat digunakan untuk menelusuri konten hingga 10 Februari 2017. Namun, setelah itu, Anda hanya dapat menggunakan kumpulan topik yang lebih sedikit yang diidentifikasi di item sebelumnya untuk mengambil hasil penelusuran berdasarkan topik.
-
Setelah 10 Februari 2017, jika Anda mencoba menelusuri hasil menggunakan ID topik yang tidak ada dalam kumpulan ID topik yang didukung, API akan menampilkan set hasil kosong.
- Bagian
-
Beberapa kolom dan parameter API tidak akan digunakan lagi mulai 12 September 2016:
-
Parameter
home
metodeactivities.list
memungkinkan pengguna yang diotorisasi mengambil feed aktivitas yang akan ditampilkan di halaman beranda YouTube untuk pengguna tersebut. Permintaan yang menggunakan parameter ini setelah 12 September 2016 akan menampilkan daftar kosong. -
Properti
contentDetails.relatedPlaylists.watchHistory
dancontentDetails.relatedPlaylists.watchLater
resourcechannel
hanya terlihat oleh pengguna yang diotorisasi yang mengambil data tentang saluran pengguna itu sendiri. Setelah 12 September 2016,contentDetails.relatedPlaylists.watchHistory
akan menampilkan nilaiHL
dan properticontentDetails.relatedPlaylists.watchLater
akan menampilkan nilaiWL
untuk semua saluran.Permintaan untuk mengambil detail playlist (
playlists.list
) untuk histori tontonan channel atau playlist tonton nanti akan menampilkan daftar kosong setelah 12 September 2016. Permintaan untuk mengambil item playlist (playlistItems.list
) di salah satu playlist tersebut juga akan menampilkan daftar kosong setelah jangka waktu tersebut. Hal ini berlaku untuk nilai baru,HL
danWL
, serta untuk semua histori tontonan atau ID playlist tonton nanti yang mungkin sudah disimpan oleh Klien API Anda. -
Objek
fileDetails.recordingLocation
resourcevideo
atau properti turunannya lagi tidak akan ditampilkan lagi setelah 12 September 2016. Data ini hanya dapat diambil oleh pemilik video karena objekfileDetails
induk hanya dapat diambil oleh pemilik video.
-
13 Juni 2016
Update ini berisi perubahan berikut:
-
Properti
contentDetails.googlePlusUserId
resourcechannel
tidak digunakan lagi. Sebelumnya, properti ini hanya ada jika channel dikaitkan dengan profil Google+. Setelah penghentian tersebut, properti tidak akan disertakan lagi dalam resourcechannel
. -
Properti
snippet.authorGoogleplusProfileUrl
resourcecomment
tidak digunakan lagi. Sebelumnya, properti ini hanya ada jika channel dikaitkan dengan profil Google+. Setelah penghentian tersebut, properti tidak akan disertakan lagi dalam resourcecomment
.
Karena tidak satu pun dari properti ini akan ditampilkan setelah penghentian penggunaan, kedua properti telah dihapus dari dokumentasi resource terkait.
31 Mei 2016
Update ini berisi perubahan berikut:
-
Parameter
myRecentSubscribers
baru dari metodesubscriptions.list
mengambil daftar pelanggan saluran pengguna yang diautentikasi dalam urutan kronologis terbalik dari waktu berlangganan ke saluran tersebut.Perhatikan bahwa parameter baru hanya mendukung pengambilan 1.000 pelanggan terbaru ke saluran pengguna yang diautentikasi. Untuk mengambil daftar lengkap pelanggan, gunakan parameter
mySubscribers
. Parameter tersebut, yang tidak mengembalikan pelanggan dalam urutan tertentu, tidak membatasi jumlah pelanggan yang dapat diambil. -
Definisi properti
snippet.thumbnails.(key)
telah diperbarui untuk referensi aktivitas, playlistItem, playlist, hasil penelusuran, thumbnail, dan video untuk memperhatikan bahwa ukuran gambar thumbnail tambahan tersedia untuk beberapa video.- Gambar
standard
memiliki lebar 640 piksel dan tinggi 480 piksel. - Gambar
maxres
memiliki lebar 1.280 piksel dan tinggi 720 piksel.
- Gambar
-
Definisi parameter
part
metodechannelSection.list
telah diperbarui untuk mengetahui bahwa bagiantargeting
dapat diambil dengan biaya2
unit kuota. -
Metode
videos.list
kini menampilkan error terlarang (403
) saat permintaan yang tidak diberi otorisasi dengan benar mencoba mengambil bagianfileDetails
,processingDetails
, atausuggestions
dari resourcevideo
. Bagian tersebut hanya tersedia untuk pemilik video.
17 Mei 2016
Alat Cuplikan Kode API Data yang baru menyediakan cuplikan kode singkat untuk kasus penggunaan YouTube Data API yang umum. Cuplikan kode saat ini tersedia untuk semua metode API hanya baca di Apps Script, Go, JavaScript, PHP, Python, dan Ruby.
Untuk setiap metode, alat ini menampilkan contoh kode untuk satu atau beberapa kasus penggunaan. Misalnya, menyediakan lima cuplikan kode untuk metode search.list
:
- Membuat daftar video berdasarkan kata kunci
- Membuat daftar video berdasarkan lokasi
- Membuat daftar acara live
- Telusuri video pengguna yang diautentikasi
- Buat daftar video terkait
Untuk setiap kasus penggunaan, alat ini akan menampilkan parameter yang digunakan dalam permintaan API. Anda dapat mengubah nilai parameter tersebut, sehingga alat ini akan memperbarui cuplikan kode untuk mencerminkan nilai parameter yang Anda berikan.
Terakhir, alat ini akan menampilkan respons API untuk setiap permintaan. Jika Anda telah mengubah parameter permintaan, respons API didasarkan pada nilai parameter yang diberikan. Perhatikan bahwa Anda perlu mengizinkan alat ini untuk mengirimkan permintaan atas nama Anda agar respons API ditampilkan.
28 April 2016
Update ini berisi perubahan berikut:
-
Properti
contentDetails.projection
baru dari resourcevideo
menentukan format proyeksi video. Nilai properti yang valid adalah360
danrectangular
. -
Properti
recordingDetails.location
danfileDetails.recordingLocation
resourcevideo
telah diperbarui untuk menjelaskan perbedaan antara kedua properti tersebut:- Properti
recordingDetails.location
mengidentifikasi lokasi yang ingin dikaitkan oleh pemilik video dengan video tersebut. Lokasi ini dapat diedit, dapat ditelusuri di video publik, dan mungkin ditampilkan kepada pengguna untuk video publik. - Nilai properti
fileDetails.recordingLocation
tidak dapat diubah dan mewakili lokasi yang dikaitkan dengan file video asli yang diupload. Nilai hanya dapat dilihat oleh pemilik video.
- Properti
-
Definisi properti
contentDetails.relatedPlaylists.favorites
resourcechannel
telah diperbarui untuk mencatat bahwa nilai properti mungkin berisi ID playlist yang merujuk ke playlist kosong dan tidak dapat diambil. Hal ini disebabkan karena fungsi video favorit sudah tidak digunakan lagi. Perhatikan bahwa properti ini tidak tunduk pada kebijakan penghentian API. -
Definisi error
ineligibleAccount
, yang dapat ditampilkan oleh metodecomments.insert
,comments.update
,commentThreads.insert
, ataucommentThreads.update
, telah diperbarui untuk mencerminkan bahwa error terjadi saat akun YouTube yang digunakan untuk mengizinkan permintaan API belum digabungkan dengan Akun Google pengguna.
20 April 2016
Update ini berisi perubahan berikut:
-
Definisi parameter
part
metodechannels.update
telah diperbarui untuk memperhatikan bahwalocalizations
juga merupakan nilai yang valid untuk parameter tersebut. -
Bagian Penggunaan Kuota pada panduan Memulai telah diperbarui dan ditautkan ke Konsol Google Developers, tempat Anda dapat melihat kuota dan penggunaan kuota sebenarnya.
16 Maret 2016
Update ini berisi perubahan berikut:
-
Pembaruan pada resource dan metode yang ada
-
Dokumentasi resource
channelBanner
telah diperbarui untuk mencatat bahwa ukuran yang direkomendasikan untuk gambar banner channel yang diupload adalah 2560x1440 piksel. Ukuran minimum (2048x1152 piksel) tidak berubah. -
Properti
snippet.customUrl
baru dari resourcechannel
mengidentifikasi URL kustom yang terkait dengan saluran tersebut. (Tidak semua channel memiliki URL kustom.) Pusat Bantuan YouTube menjelaskan persyaratan kelayakan untuk mendapatkan URL kustom serta cara menyiapkan URL tersebut. -
Objek
brandingSettings.watch
resourcechannel
dan semua properti turunannya tidak digunakan lagi. -
Respons API terhadap permintaan
search.list
sekarang berisi propertiregionCode
. Properti ini mengidentifikasi kode wilayah yang digunakan untuk kueri penelusuran. Kode wilayah menginstruksikan API agar menampilkan hasil penelusuran untuk negara yang ditetapkan.Nilai properti adalah kode negara ISO dua huruf yang mengidentifikasi wilayah. Metode
i18nRegions.list
menampilkan daftar wilayah yang didukung. Nilai defaultnya adalahUS
. Jika wilayah yang tidak didukung ditentukan, YouTube mungkin tetap akan memilih wilayah lain, bukan nilai default, untuk menangani kueri tersebut. -
Definisi properti
snippet.label
dansnippet.secondaryReasons[].label
resourcevideoAbuseReportReason
telah diperbarui untuk memperhatikan bahwa properti berisi teks label yang dilokalkan karena alasan laporan penyalahgunaan.Selain itu, metode
videoAbuseReportReasons.list
kini mendukung parameterhl
, yang menentukan bahasa yang harus digunakan untuk teks label dalam respons API. Nilai parameter default adalahen_US
. -
Properti
contentDetails.contentRating.ecbmctRating
baru di resourcevideo
mengidentifikasi rating video dari Dewan Evaluasi dan Klasifikasi Turkiye dari Kementerian Kebudayaan dan Pariwisata.Selain itu, properti API untuk sistem rating lainnya mendukung nilai properti baru berikut:
contentDetails.contentRating.fpbRating
(Afrika Selatan)
Rating: 10; nilai properti:fpb10
contentDetails.contentRating.moctwRating
(Taiwan)
Rating: R-12; nilai properti:moctwR12
contentDetails.contentRating.moctwRating
(Taiwan)
Rating: R-15; nilai properti:moctwR15
-
Properti
liveStreamingDetails.activeLiveChatId
resourcevideo
berisi ID live chat aktif yang terkait dengan video. Nilai properti hanya ada jika video merupakan live streaming saat ini yang mengaktifkan live chat. Setelah siaran berakhir dan live chat selesai, properti tidak lagi ditampilkan untuk video. -
Properti
status.rejectionReason
resourcevideo
mendukung nilai properti barulegal
.
-
-
API ini mendukung error baru berikut:
Jenis error Detail error Deskripsi badRequest (400)
notEditable
Metode channelSections.insert
,channelSections.update
, danchannelSections.delete
menampilkan error ini untuk menunjukkan bahwa bagian saluran yang ditentukan tidak dapat dibuat, diperbarui, atau dihapus.badRequest (400)
styleRequired
Metode channelSections.insert
danchannelSections.update
menampilkan error ini untuk menunjukkan bahwa resourcechannelSection
yang dikirimkan dalam permintaan API harus menentukan nilai untuk propertisnippet.style
.badRequest (400)
typeRequired
Metode channelSections.insert
danchannelSections.update
menampilkan error ini untuk menunjukkan bahwa resourcechannelSection
yang dikirimkan dalam permintaan API harus menentukan nilai untuk propertisnippet.type
.badRequest (400)
processingFailure
Metode commentThreads.list
menampilkan error ini untuk menunjukkan bahwa server API gagal memproses permintaan. Meskipun ini merupakan error sementara, hal ini biasanya menunjukkan bahwa input permintaan tidak valid. Periksa struktur resourcecommentThread
dalam isi permintaan untuk memastikannya valid.forbidden (403)
commentsDisabled
Metode commentThreads.list
menampilkan error ini untuk menunjukkan bahwa video yang diidentifikasi oleh parametervideoId
telah menonaktifkan komentar.badRequest (400)
commentTextTooLong
Metode commentThreads.insert
menampilkan error ini untuk menunjukkan bahwa resourcecomment
yang dimasukkan berisi terlalu banyak karakter dalam propertisnippet.topLevelComment.snippet.textOriginal
.invalidValue (400)
videoAlreadyInAnotherSeriesPlaylist
Metode playlistItems.insert
menampilkan error ini untuk menandakan bahwa video yang Anda coba tambahkan ke playlist sudah ada di playlist bersambung lain. Buka Pusat Bantuan YouTube untuk mengetahui informasi lebih lanjut tentang playlist bersambung.badRequest (400)
subscriptionForbidden
Metode subscriptions.insert
menampilkan error ini untuk menunjukkan bahwa Anda telah mencapai jumlah langganan maksimum atau Anda telah membuat terlalu banyak langganan terbaru. Untuk kasus yang terakhir, Anda dapat mencoba lagi permintaan tersebut setelah beberapa jam.badRequest (400)
invalidCategoryId
Metode videos.update
menampilkan error ini untuk menunjukkan bahwa propertisnippet.categoryId
di resourcevideo
yang diupload menetapkan ID kategori yang tidak valid. Gunakan metodevideoCategories.list
untuk mengambil kategori yang didukung.badRequest (400)
invalidDescription
Metode videos.update
menampilkan error ini untuk menunjukkan bahwa propertisnippet.description
di resourcevideo
yang diupload menetapkan nilai yang tidak valid.badRequest (400)
invalidPublishAt
Metode videos.update
menampilkan error ini untuk menunjukkan bahwa propertistatus.publishAt
di resourcevideo
yang diupload menentukan waktu publikasi terjadwal yang tidak valid.badRequest (400)
invalidRecordingDetails
Metode videos.update
menampilkan error ini untuk menunjukkan bahwa objekrecordingDetails
di resourcevideo
yang diupload menetapkan detail rekaman yang tidak valid.badRequest (400)
invalidTags
Metode videos.update
menampilkan error ini untuk menunjukkan bahwa propertisnippet.tags
di resourcevideo
yang diupload menetapkan nilai yang tidak valid.badRequest (400)
invalidTitle
Metode videos.update
menampilkan error ini untuk menunjukkan bahwa propertisnippet.title
di asetvideo
yang diupload menetapkan judul video yang tidak valid atau kosong.badRequest (400)
invalidVideoMetadata
Metode videos.update
menampilkan error ini untuk menunjukkan bahwa metadata permintaan tidak valid. Error ini terjadi jika permintaan memperbarui bagiansnippet
dari resourcevideo
, tetapi tidak menetapkan nilai untuk propertisnippet.title
dansnippet.categoryId
.
18 Desember 2015
Hukum Uni Eropa (EU) mewajibkan pengungkapan tertentu kepada dan mendapatkan izin dari pengguna akhir di Uni Eropa. Oleh karena itu, bagi pengguna akhir di Uni Eropa, Anda harus mematuhi Kebijakan Izin Pengguna Uni Eropa. Kami telah menambahkan pemberitahuan terkait persyaratan ini di Persyaratan Layanan YouTube API.
19 November 2015
API ini sekarang mendukung kemampuan untuk menetapkan dan mengambil teks yang dilokalkan untuk properti snippet.title
dan snippet.description
resource playlist
dan video
, properti snippet.title
dari resource channelSection
, dan properti snippet.description
dari resource channel
.
-
Menetapkan judul dan deskripsi yang dilokalkan
Anda dapat menetapkan nilai yang dilokalkan untuk resource saat memanggil metode
insert
atauupdate
untuk resource tersebut. Untuk menetapkan nilai yang dilokalkan untuk resource, lakukan kedua hal berikut:-
Pastikan nilai ditetapkan untuk properti
snippet.defaultLanguage
resource. Properti tersebut mengidentifikasi bahasa propertisnippet.title
dansnippet.description
resource. Nilainya dapat berupa bahasa aplikasi yang didukung atau sebagian besar kode bahasa ISO 639-1:2002 lainnya. Misalnya, jika Anda mengupload video yang memiliki judul dan deskripsi dalam bahasa Inggris, Anda harus menetapkan propertisnippet.defaultLanguage
keen
.Catatan untuk memperbarui resource
channel
: Untuk menetapkan propertisnippet.defaultLanguage
untuk resourcechannel
, Anda sebenarnya harus memperbarui propertibrandingSettings.channel.defaultLanguage
. -
Tambahkan objek
localizations
ke resource yang sedang Anda perbarui. Setiap kunci objek adalah string yang mengidentifikasi bahasa aplikasi atau kode bahasa ISO 639-1:2002, dan setiap kunci memetakan ke objek yang berisi judul (dan deskripsi) yang dilokalkan untuk sumber daya.Cuplikan contoh di bawah menetapkan bahasa default resource ke bahasa Inggris. Tag tersebut juga menambahkan judul dan deskripsi bahasa Jerman dan Spanyol yang dilokalkan ke video:
{ "kind": "youtube#video", ... "snippet": { "title": "Playing soccer", "description": "We play soccer in the park on Sundays.", "defaultLanguage": "en", ... }, "localizations": "de": { "title": "Fußball spielen", "description": "Wir spielen Fußball im Park am Sonntag" }, "es": { "title": "Jugar al fútbol", "description": "Nosotros jugamos fútbol en el parque los domingos", } } }
Penting: Perlu diingat bahwa saat Anda memperbarui data yang dilokalkan untuk resource, permintaan API Anda harus menyertakan semua versi data yang dilokalkan yang ada. Misalnya, jika Anda mengirim permintaan berikutnya untuk menambahkan data bahasa Portugis ke video dalam contoh di atas, permintaan tersebut harus menyertakan data yang dilokalkan untuk bahasa Jerman, Spanyol, dan Portugis.
-
-
Mengambil nilai yang dilokalkan
API ini mendukung dua cara untuk mengambil nilai yang dilokalkan untuk resource:
-
Tambahkan parameter
hl
ke permintaanchannels.list
,channelSections.list
,playlists.list
, atauvideos.list
Anda guna mengambil data yang dilokalkan untuk bahasa aplikasi tertentu yang didukung situs YouTube. Jika detail resource yang dilokalkan tersedia dalam bahasa tersebut, objeksnippet.localized
resource akan berisi nilai yang dilokalkan. Namun, jika detail yang dilokalkan tidak tersedia, objeksnippet.localized
akan berisi detail resource dalam bahasa default resource.Misalnya, permintaan
videos.list
mengambil data untuk video yang dijelaskan di atas dengan data yang dilokalkan dalam bahasa Jerman dan Spanyol. Jika parameterhl
ditetapkan kede
, resource akan berisi data berikut:{ "kind": "youtube#video", ... "snippet": { "title": "Playing soccer", "description": "We play soccer in the park on Sundays.", "defaultLanguage": "en", "localized": { "title": "Fußball spielen", "description": "Wir spielen Fußball im Park am Sonntag" } ... } }
Namun, jika parameter
hl
ditetapkan kefr
, objeksnippet.localized
akan berisi judul dan deskripsi dalam bahasa Inggris karena bahasa Inggris adalah bahasa default untuk resource, dan detail bahasa Prancis yang dilokalkan tidak tersedia.Penting: Parameterhl
hanya mendukung nilai yang mengidentifikasi bahasa aplikasi yang didukung situs YouTube. Untuk menentukan apakah teks yang dilokalkan tersedia untuk bahasa lain, Anda harus mengambil bagianlocalizations
untuk resource dan memfilter untuk menentukan apakah teks yang dilokalkan ada.
Misalnya, Anda perlu mengambil daftar lengkap pelokalan untuk menentukan apakah teks yang dilokalkan tersedia dalam bahasa Inggris Appalachia.
-
Saat mengambil resource, sertakan
localizations
dalam nilai parameterpart
untuk mengambil semua detail yang dilokalkan untuk resource tersebut. Jika Anda mengambil data yang dilokalkan untuk bahasa yang bukan bahasa aplikasi YouTube saat ini, Anda harus menggunakan pendekatan ini untuk mengambil semua pelokalan, lalu menerapkan filter untuk menentukan apakah data yang dilokalkan yang diinginkan ada atau tidak.
-
-
Error terkait nilai teks yang dilokalkan
API ini juga mendukung error baru berikut untuk nilai teks yang dilokalkan:
Jenis error Detail error Deskripsi badRequest (400)
defaultLanguageNotSetError
Error ini menunjukkan bahwa permintaan yang mencoba menyisipkan atau memperbarui objek localizations
untuk resource gagal karena propertisnippet.defaultLanguage
tidak ditetapkan untuk resource tersebut. Metodechannels.update
,channelSections.insert
,channelSections.update
,playlists.insert
,playlists.update
,videos.insert
, danvideos.update
mendukung error ini.badRequest (400)
localizationValidationError
Error ini menunjukkan bahwa salah satu nilai dalam objek localizations
resource gagal divalidasi. Misalnya, error ini mungkin terjadi jika objek berisi kode bahasa yang tidak valid. Metodechannels.update
,channelSections.insert
,channelSections.update
,playlists.insert
, danplaylists.update
mendukung error ini.
4 November 2015
Update ini berisi perubahan berikut:
-
Pembaruan pada resource dan metode yang ada
-
Parameter
order
metodesearch.list
telah diperbarui untuk memperhatikan bahwa jika Anda mengurutkan live streaming menurutviewCount
, hasil API akan diurutkan berdasarkan siaran. jumlah penonton serentak saat siaran masih berlangsung. -
Parameter
relatedToVideoId
metodesearch.list
telah diperbarui untuk mencatat bahwa jika parameter disetel, satu-satunya parameter lain yang didukung adalahpart
,maxResults
,pageToken
,regionCode
,relevanceLanguage
,safeSearch
,type
(yang harus disetel kevideo
), danfields
. Update ini tidak mencerminkan perubahan pada perilaku API. -
Definisi properti
snippet.publishedAt
resourcevideo
telah diperbarui untuk mencatat bahwa nilai properti, yang menentukan tanggal dan waktu video dipublikasikan, mungkin berbeda dengan waktu video diupload. Misalnya, jika video diupload sebagai video pribadi dan kemudian disetel untuk publik di lain waktu, nilai properti menentukan waktu video tersebut disetel ke publik. Definisi yang diperbarui ini juga menjelaskan cara nilai diisi untuk video pribadi dan tidak publik.Perubahan ini tidak mencerminkan perubahan pada perilaku API.
-
Definisi properti
status.publishAt
resourcevideo
telah diperbarui untuk mencatat:- Jika Anda menetapkan nilai properti ini saat memanggil metode
videos.update
, Anda juga harus menyetel nilai propertistatus.privacyStatus
keprivate
meskipun video sudah berstatus pribadi. - Jika permintaan tersebut menjadwalkan video untuk dipublikasikan pada waktu yang lalu, video tersebut akan segera dipublikasikan. Dengan demikian, efek menyetel properti
status.publishAt
ke tanggal dan waktu terdahulu sama dengan mengubahprivacyStatus
video dariprivate
menjadipublic
.
- Jika Anda menetapkan nilai properti ini saat memanggil metode
-
Properti
contentDetails.contentRating.cncRating
resourcevideo
menentukan rating video dari Cinematographique Commission de Classification Prancis. Properti ini menggantikan properticontentDetails.contentRating.fmocRating
, yang sekarang tidak digunakan lagi. -
Definisi brandingSettings.channel.keywords resource
channel
telah diperbarui untuk menunjukkan dengan benar bahwa nilai properti berisi daftar string yang dipisahkan spasi, bukan daftar yang dipisahkan koma, seperti yang didokumentasikan sebelumnya. Update ini tidak mencerminkan perubahan pada perilaku API. -
Dokumentasi untuk metode
thumbnails.set
telah diperbarui untuk menunjukkan secara akurat bahwa isi permintaan berisi gambar thumbnail yang Anda upload dan kaitkan dengan video. Isi permintaan tidak berisi resourcethumbnail
. Sebelumnya, dokumentasi menyatakan bahwa Anda tidak boleh memberikan isi permintaan saat memanggil metode ini. Update ini tidak mencerminkan perubahan pada perilaku API. -
Deskripsi resource
activity
telah diperbarui untuk mencerminkan fakta bahwa metodeactivities.list
saat ini tidak menyertakan resource yang terkait dengan komentar video baru.snippet.type
dancontentDetails.comment
resource juga telah diupdate.
-
-
Error baru dan yang diperbarui
-
API kini mendukung error berikut:
Detail error activities.insert
Kode Respons HTTP badRequest (400)
Alasan invalidMetadata
Deskripsi Properti kind
tidak cocok dengan jenis tanda pengenal yang diberikan.commentThreads.update
comments.insert
comments.update
Kode Respons HTTP badRequest (400)
Alasan commentTextTooLong
Deskripsi Resource comment
yang dimasukkan atau diperbarui berisi terlalu banyak karakter dalam propertisnippet.topLevelComment.snippet.textOriginal
.playlistItems.insert
playlistItems.update
Kode Respons HTTP forbidden (403)
Alasan playlistItemsNotAccessible
Deskripsi Permintaan tidak diizinkan dengan benar untuk menyisipkan, memperbarui, atau menghapus item playlist yang ditentukan. playlists.delete
playlists.insert
playlists.update
Kode Respons HTTP badRequest (400)
Alasan playlistForbidden
Deskripsi Operasi ini dilarang atau permintaan tidak diizinkan dengan benar. search.list
Kode Respons HTTP badRequest (400)
Alasan invalidLocation
Deskripsi Nilai parameter location
dan/ataulocationRadius
tidak diformat dengan benar.search.list
Kode Respons HTTP badRequest (400)
Alasan invalidRelevanceLanguage
Deskripsi Nilai parameter relevanceLanguage
tidak diformat dengan benar.subscriptions.insert
Kode Respons HTTP badRequest (400)
Alasan subscriptionForbidden
Deskripsi Kesalahan ini terjadi jika salah satu hal berikut terjadi: - Langganan yang Anda coba buat sudah ada
- Anda telah mencapai jumlah maksimum langganan
- Anda mencoba subscribe ke channel Anda sendiri, dan itu tidak didukung.
- Anda baru-baru ini membuat terlalu banyak langganan dan harus menunggu beberapa jam sebelum mencoba lagi permintaan tersebut.
videos.update
Kode Respons HTTP badRequest (400)
Alasan invalidDefaultBroadcastPrivacySetting
Deskripsi Permintaan tersebut mencoba menetapkan setelan privasi yang tidak valid untuk siaran default.
-
28 Agustus 2015
Update ini berisi perubahan berikut:
-
Pembaruan pada resource dan metode yang ada
-
Properti
statistics.favoriteCount
resourcevideo
tidak digunakan lagi.Sesuai dengan kebijakan penghentian penggunaan kami, properti ini akan terus disertakan dalam resource
video
setidaknya selama satu tahun setelah pengumuman ini. Namun, nilai properti kini selalu ditetapkan ke0
.
-
7 Agustus 2015
Update ini berisi perubahan berikut:
-
Pembaruan pada resource dan metode yang ada
-
Definisi properti
snippet.tags[]
resourcevideo
telah diperbarui untuk memberikan informasi selengkapnya tentang cara server API menghitung panjang nilai properti. Perlu diketahui bahwa pembaruan ini tidak mencerminkan perubahan pada perilaku API.Secara khusus, definisi tersebut sekarang menjelaskan bahwa jika tag berisi spasi, server API akan menangani nilai tag seolah-olah nilai tag tersebut digabungkan dalam tanda kutip, dan tanda kutip memengaruhi batas karakter. Jadi, untuk tujuan batas karakter, tag Foo-Baz berisi tujuh karakter, tetapi tag Foo Baz berisi sembilan karakter.
-
Metode
commentThreads.insert
tidak lagi mendukung parametershareOnGooglePlus
, yang sebelumnya menunjukkan apakah komentar dan balasan atas komentar tersebut juga harus diposting ke profil Google+ penulis. Jika permintaan mengirimkan parameter, server API akan mengabaikan parameter tersebut, tetapi sebaliknya akan menangani permintaan.
-
18 Juni 2015
Update ini berisi perubahan berikut:
-
Pembaruan pada resource dan metode yang ada
-
Parameter
order
baru dari metodecommentThreads.list
menentukan urutan respons API harus mencantumkan thread komentar. Rangkaian pesan dapat diurutkan menurut waktu atau relevansi. Perilaku defaultnya adalah mengurutkannya berdasarkan waktu. -
Properti
snippet.defaultAudioLanguage
baru dari resourcevideo
menentukan bahasa yang digunakan dalam trek audio default video. -
Definisi properti
contentDetails.licensedContent
dari resourcevideo
telah diperbarui untuk mengklarifikasi bahwa konten tersebut harus awalnya diupload ke channel yang ditautkan ke partner konten YouTube, lalu diklaim oleh partner tersebut. Hal ini tidak mencerminkan perubahan pada perilaku API yang sebenarnya. -
Metode
captions.delete
,captions.download
,captions.insert
,captions.list
, dancaptions.update
kini mendukung parameteronBehalfOfContentOwner
, yang sudah didukung untuk beberapa metode lainnya. Permintaan yang menggunakan metode tersebut juga harus diberi otorisasi dengan token yang memberikan akses ke cakupanhttps://www.googleapis.com/auth/youtubepartner
.
-
-
Error baru dan yang diperbarui
-
API kini mendukung error berikut:
Detail error videos.rate
Kode Respons HTTP badRequest (400)
Alasan emailNotVerified
Deskripsi Pengguna harus memverifikasi alamat emailnya sebelum memberikan rating pada video. videos.rate
Kode Respons HTTP badRequest (400)
Alasan videoPurchaseRequired
Deskripsi Video rental hanya dapat dinilai oleh pengguna yang menyewanya. -
Metode
subscriptions.delete
dansubscriptions.insert
tidak lagi mendukung erroraccountClosed
danaccountSuspended
.
-
27 April 2015
Update ini berisi perubahan berikut:
-
Referensi dan metode baru
-
Referensi
videoAbuseReportReason
baru berisi informasi tentang alasan video akan ditandai karena berisi konten yang melanggar. MetodevideoAbuseReportReasons.list
memungkinkan Anda mengambil daftar semua alasan mengapa video mungkin dilaporkan. -
Metode
videos.reportAbuse
yang baru menyediakan cara untuk benar-benar melaporkan video yang berisi konten yang melanggar. Isi permintaan berisi objek JSON yang menentukan video yang ditandai serta alasan video tersebut dianggap berisi konten yang melanggar. Alasan yang valid dapat diperoleh dari metodevideoAbuseReportReason.list
yang dijelaskan di atas.Panduan migrasi juga telah diperbarui dengan contoh pelaporan video yang melanggar kebijakan. Dengan perubahan ini, API v3 kini mendukung semua fitur API v2 yang dijadwalkan untuk didukung. Semua fitur ini juga dijelaskan dalam panduan migrasi.
-
-
Pembaruan pada resource dan metode yang ada
-
Parameter filter
forDeveloper
baru dari metodesearch.list
membatasi penelusuran agar hanya mengambil video yang diupload melalui aplikasi atau situs developer. ParameterforDeveloper
dapat digunakan bersama dengan parameter penelusuran opsional seperti parameterq
.Untuk fitur ini, setiap video yang diupload akan otomatis diberi tag dengan nomor project yang dikaitkan dengan aplikasi developer di Google Developers Console.
Jika permintaan penelusuran kemudian menetapkan parameter
forDeveloper
ketrue
, server API akan menggunakan kredensial otorisasi permintaan untuk mengidentifikasi developer. Oleh karena itu, developer dapat membatasi hasil pada video yang diupload melalui aplikasi atau situs milik developer, tetapi tidak pada video yang diupload melalui aplikasi atau situs lain.Fitur baru ini menawarkan fungsi yang serupa, meskipun tidak sama, dengan fungsi tag developer yang didukung API v2.
-
Properti
snippet.country
baru dari resourcechannel
memungkinkan pemilik channel mengaitkan channel mereka dengan negara tertentu.Catatan: Untuk menetapkan properti
snippet.country
untuk resourcechannel
, Anda sebenarnya harus memperbarui propertibrandingSettings.channel.country
. -
API ini sekarang mendukung penargetan untuk resource
channelSection
. Penargetan bagian channel memberikan cara untuk membatasi visibilitas bagian konten kepada pengguna yang cocok dengan kriteria tertentu.API ini mengekspos tiga opsi penargetan. Pengguna harus memenuhi semua setelan penargetan agar bagian channel dapat terlihat.
-
targeting.languages[]
: Daftar bahasa aplikasi YouTube. Pengguna yang telah memilih salah satu bahasa tersebut dapat melihat bagian channel yang sesuai. -
targeting.regions[]
: Daftar wilayah konten pilihan YouTube. Bagian saluran dapat dilihat oleh pengguna yang telah memilih salah satu wilayah tersebut serta pengguna yang salah satu wilayah tersebut dipilih secara otomatis. -
targeting.countries[]
: Daftar negara tempat bagian channel terlihat. Setiap nilai dalam daftar adalah kode negara ISO 3166-1 alpha-2.
-
-
Definisi properti
contentDetails.duration
resourcevideo
telah dikoreksi untuk mencerminkan bahwa nilai tersebut dapat mencerminkan jam, hari, dan sebagainya. -
Dokumentasi untuk metode
channelSections.delete
,playlistItems.delete
,playlists.delete
,subscriptions.delete
, danvideos.delete
telah diperbaiki untuk mencerminkan bahwa, jika berhasil, semua metode tersebut menampilkan kode respons204
HTTP (No Content
).
-
-
Error baru dan yang diperbarui
-
API kini mendukung error berikut:
Jenis error Detail error Deskripsi badRequest (400)
targetInvalidCountry
Metode channelSections.insert
danchannelSections.update
akan menampilkan error ini jika resourcechannelSection
yang dimasukkan berisi nilai yang tidak valid untuk propertitargeting.countries[]
.badRequest (400)
targetInvalidLanguage
Metode channelSections.insert
danchannelSections.update
akan menampilkan error ini jika resourcechannelSection
yang dimasukkan berisi nilai yang tidak valid untuk propertitargeting.languages[]
.badRequest (400)
targetInvalidRegion
Metode channelSections.insert
danchannelSections.update
akan menampilkan error ini jika resourcechannelSection
yang dimasukkan berisi nilai yang tidak valid untuk propertitargeting.regions[]
.badRequest (400)
operationNotSupported
Metode comments.insert
menampilkan error ini jika pengguna API tidak dapat menyisipkan komentar sebagai balasan atas komentar tingkat atas yang diidentifikasi oleh propertisnippet.parentId
. Dalam resourcecommentThread
, propertisnippet.canReply
menunjukkan apakah pelihat saat ini dapat membalas rangkaian pesan.badRequest (400)
invalidChannelId
Metode search.list
akan menampilkan error ini jika parameterchannelId
dalam permintaan menentukan ID saluran yang tidak valid.badRequest (400)
subscriptionForbidden
Metode subscriptions.insert
akan menampilkan error ini jika pengguna API mencoba berlangganan ke saluran pengguna itu sendiri. -
Metode
captions.update
tidak lagi mendukung errorinvalidMetadata
danvideoNotFound
.
-
16 April 2015
Update ini berisi perubahan berikut:
-
Panduan migrasi telah diperbarui untuk menjelaskan cara memigrasikan aplikasi yang masih menggunakan fungsi komentar dari API v2.
Panduan ini juga menyebutkan beberapa fitur komentar yang tidak didukung oleh API v2, tetapi didukung di API v3. Ini mencakup:
- Mengambil komentar tentang channel
- Mengambil semua rangkaian komentar yang terkait dengan channel, yang berarti respons API dapat berisi komentar tentang channel atau videonya.
- Memperbarui teks komentar
- Menandai komentar sebagai spam
- Menyetel status moderasi komentar
-
Panduan Berlangganan notifikasi push telah diperbarui untuk mencerminkan fakta bahwa notifikasi hanya dikirim ke hub Google PubSubHubBub, dan bukan ke hub Superfeedr seperti yang ditunjukkan sebelumnya.
9 April 2015
Update ini berisi perubahan berikut:
-
Resource
commentThread
dancomment
baru dari API memungkinkan Anda mengambil, menyisipkan, memperbarui, menghapus, dan memoderasi komentar.-
Referensi
commentThread
berisi informasi tentang rangkaian komentar YouTube, yang terdiri dari komentar dan balasan tingkat atas, jika ada, untuk komentar tersebut. ResourcecommentThread
dapat mewakili komentar tentang video atau channel.Komentar dan balasan tingkat atas sebenarnya adalah resource
comment
yang disusun bertingkat di dalam resourcecommentThread
. Penting untuk diperhatikan bahwa resourcecommentThread
tidak selalu berisi semua balasan untuk sebuah komentar, dan Anda harus menggunakan metodecomments.list
jika ingin mengambil semua balasan untuk komentar tertentu. Selain itu, beberapa komentar tidak memiliki balasan.API ini mendukung metode berikut untuk resource
commentThread
:commentThreads.list
– Mengambil daftar rangkaian pesan komentar. Gunakan metode ini untuk mengambil komentar yang terkait dengan video atau channel tertentu.commentThreads.insert
– Membuat komentar tingkat atas baru (Gunakan metodecomments.insert
untuk membalas komentar yang sudah ada.)commentThreads.update
– Mengubah komentar tingkat atas.
-
Referensi
comment
berisi informasi tentang satu komentar YouTube. Resourcecomment
dapat mewakili komentar tentang video atau channel. Selain itu, komentar tersebut dapat berupa komentar tingkat atas atau balasan atas komentar tingkat atas.API ini mendukung metode berikut untuk resource
comment
:comments.list
– Mengambil daftar komentar. Gunakan metode ini untuk mengambil semua balasan atas komentar tertentu.comments.insert
– Membuat balasan untuk komentar yang ada.comments.update
– Mengubah komentar.comments.markAsSpam
– Menandai satu atau beberapa komentar sebagai spam.comments.setModerationStatus
– Menyetel status moderasi untuk satu atau beberapa komentar. Misalnya, hapus komentar untuk ditampilkan secara publik atau tolak komentar sebagai tidak layak untuk ditampilkan. Permintaan API harus mendapatkan otorisasi dari pemilik channel atau video yang terkait dengan komentar.comments.delete
– Menghapus komentar.
Perhatikan bahwa cakupan
https://www.googleapis.com/auth/youtube.force-ssl
baru API, yang dijelaskan di histori revisi untuk 2 April 2015, diperlukan untuk panggilan ke metodecomments.insert
,comments.update
,comments.markAsSpam
,comments.setModerationStatus
,comments.delete
,commentThreads.insert
, dancommentThreads.update
. -
-
Panduan Berlangganan notifikasi push yang baru menjelaskan dukungan baru API untuk notifikasi push melalui PubSubHubBub, protokol publikasi/langganan server ke server untuk referensi yang dapat diakses dari Web. Server callback PubSubHubBub Anda dapat menerima notifikasi feed Atom saat saluran melakukan salah satu aktivitas berikut:
- mengupload video
- memperbarui judul video
- memperbarui deskripsi video
-
Panduan migrasi juga telah diperbarui untuk mencatat dukungan baru untuk notifikasi push. Namun, karena API v2 mendukung berbagai jenis notifikasi push lainnya yang tidak didukung di API v3, penyebutan dukungan PubSubHubBub masih tercantum di bagian Tidak digunakan lagi dalam panduan tersebut.
-
Cakupan
https://www.googleapis.com/auth/youtube.force-ssl
baru API sekarang menjadi cakupan yang valid untuk semua metode API yang sebelumnya mendukung cakupanhttps://www.googleapis.com/auth/youtube
. -
API kini mendukung error berikut:
Jenis error Detail error Deskripsi badRequest (400)
invalidRating
Metode videos.rate
akan menampilkan error ini jika permintaan berisi nilai yang tidak terduga untuk parameterrating
. -
Metode
subscriptions.insert
tidak lagi mendukung errorsubscriptionLimitExceeded
, yang sebelumnya menunjukkan bahwa pelanggan yang diidentifikasi dengan permintaan tersebut telah melebihi batas nilai langganan.
2 April 2015
Update ini berisi perubahan berikut:
-
Resource
captions
baru mewakili trek teks YouTube. Trek teks dikaitkan dengan satu video YouTube saja.API ini mendukung metode untuk mencantumkan, menyisipkan, memperbarui, mendownload, dan menghapus trek teks.
-
Panduan migrasi juga telah diperbarui untuk menjelaskan cara memigrasikan aplikasi yang masih menggunakan fungsi teks di API v2.
-
Cakupan
https://www.googleapis.com/auth/youtube.force-ssl
baru API memerlukan komunikasi dengan server API dilakukan melalui koneksi SSL.Cakupan baru ini memberikan akses yang sama dengan cakupan
https://www.googleapis.com/auth/youtube
. Terlebih lagi, kedua cakupan tersebut secara fungsional identik karena server YouTube API hanya tersedia melalui endpoint HTTPS. Akibatnya, meskipun cakupanhttps://www.googleapis.com/auth/youtube
tidak memerlukan koneksi SSL, sebenarnya tidak ada cara lain untuk membuat permintaan API.Cakupan baru diperlukan untuk panggilan ke semua metode resource
caption
.
11 Maret 2015
Update ini berisi perubahan berikut:
-
Panduan migrasi YouTube Data API (v3) berisi tab baru bernama Baru di API v3, yang mencantumkan berbagai fitur yang didukung API v3 dan yang tidak didukung API v2. Fitur yang sama sebelumnya dan masih tercantum di tab lain dalam panduan ini. Misalnya, fitur baru yang menjelaskan cara memperbarui data kampanye promosi in-video untuk channel juga tercantum di tab Channel (profil).
-
Panduan migrasi YouTube Data API (v3) telah diperbarui untuk memberi tahu bahwa API v3 akan mendukung fitur API v2 berikut:
-
Panduan migrasi YouTube Data API (v3) telah diperbarui untuk memberi tahu bahwa fitur API v2 berikut tidak akan didukung di API v3:
-
Mengambil rekomendasi video – API v3 tidak mengambil daftar yang hanya berisi video yang direkomendasikan untuk pengguna API saat ini. Namun, Anda dapat menggunakan API v3 untuk menemukan rekomendasi video dengan memanggil metode
activities.list
dan menetapkan nilai parameterhome
ketrue
.Dalam respons API, resource sesuai dengan video yang direkomendasikan jika nilai properti
snippet.type
adalahrecommendation
. Dalam hal ini, properticontentDetails.recommendation.reason
dancontentDetails.recommendation.seedResourceId
akan berisi informasi tentang alasan video direkomendasikan. Perlu diperhatikan bahwa tidak ada jaminan bahwa respons akan berisi sejumlah rekomendasi video dalam jumlah tertentu. -
Mengambil video langganan baru – API v3 tidak mengambil daftar yang hanya berisi video yang baru-baru ini diupload ke channel yang di-subscribe pengguna API. Namun, Anda dapat menggunakan API v3 untuk menemukan video langganan baru dengan memanggil metode
activities.list
dan menetapkan nilai parameterhome
ketrue
.Dalam respons API, resource sesuai dengan video langganan baru jika nilai properti
snippet.type
adalahupload
. Perlu diperhatikan bahwa tidak ada jaminan bahwa respons akan berisi sejumlah video langganan baru. -
Notifikasi push untuk pembaruan feed – Notifikasi push yang mendukung API v2, menggunakan Simple Update Protocol (SUP) atau PubSubHubbub, untuk memantau feed aktivitas pengguna untuk pengguna YouTube. Notifikasi diberikan untuk subscription channel baru dan kapan video dinilai, dibagikan, ditandai sebagai favorit, dikomentari, atau diupload.
API v3 akan mendukung notifikasi push menggunakan protokol PubSubHubbub, tetapi notifikasi hanya akan mencakup upload dan update video pada judul atau deskripsi video.
-
Lokasi channel – API v2 menggunakan tag
<yt:location>
untuk mengidentifikasi lokasi pengguna seperti yang dimasukkan di profil publik YouTube channel. Meskipun beberapa developer menggunakan kolom ini untuk mengaitkan saluran dengan negara tertentu, data kolom tidak dapat digunakan secara konsisten untuk tujuan tersebut. -
Menyetel atau mengambil tag developer – API v2 mendukung kemampuan untuk mengaitkan kata kunci, atau tag developer, dengan video pada saat video diupload. Tag developer tidak akan ditampilkan kepada pengguna YouTube, tetapi pemilik video dapat mengambil video yang cocok dengan tag developer tertentu.
API v3 akan menyediakan fitur yang serupa, tetapi tidak sama. Secara khusus, developer akan dapat menelusuri video yang diupload oleh aplikasi developer sendiri. Untuk fitur ini, setiap video yang diupload akan otomatis diberi tag dengan nomor project yang dikaitkan dengan aplikasi developer di Google Developers Console. Kemudian, developer menggunakan nomor project yang sama untuk menelusuri video.
-
Daftar video menurut tanggal publikasi, jumlah penayangan, atau rating – Di API v2, parameter
orderby
memungkinkan Anda mengurutkan video dalam playlist berdasarkan posisi, durasi, tanggal publikasi, judul, dan beberapa nilai lainnya. Pada API v3, item playlist biasanya diurutkan berdasarkan posisi dalam urutan menaik dan opsi pengurutan lainnya tidak tersedia.Ada beberapa pengecualian. Upload baru, video favorit, video yang disukai, atau video yang baru saja ditonton ditambahkan secara otomatis sebagai item pertama (
snippet.position
=0
) untuk jenis playlist berikut. Jadi, setiap daftar ini diurutkan secara efektif dalam urutan dari item terbaru hingga terlama berdasarkan waktu saat item tersebut ditambahkan ke daftar.- upload pengguna
- video favorit
- video yang disukai
- riwayat tontonan
Namun, perlu diketahui bahwa item baru telah ditambahkan ke "Tonton Nanti" playlist akan ditambahkan sebagai item terakhir dalam daftar tersebut, sehingga daftar tersebut diurutkan secara efektif dari item terlama ke terbaru.
-
Batch processing – API v3 mendukung salah satu kasus penggunaan batch processing yang didukung oleh API v2. Semua metode
channels.list
,channelSections.list
,guideCategories.list
,playlistItems.list
,playlists.list
,subscriptions.list
,videoCategories.list
, danvideos.list
API v3 mendukung parameterid
, yang dapat digunakan untuk menentukan daftar ID yang dipisahkan koma (ID video, ID channel, dll.). Dengan metode tersebut, Anda dapat mengambil daftar beberapa resource dengan satu permintaan.
Dengan perubahan ini, panduan ini sekarang mengidentifikasi semua fungsi yang didukung di API (v2) lama yang tidak akan digunakan lagi di versi API saat ini (v3).
-
4 Maret 2015
Update ini berisi perubahan berikut:
-
Metode
channelSections.delete
danchannelSections.update
kini mendukung parameteronBehalfOfContentOwner
, yang sudah didukung untuk beberapa metode lainnya. -
Properti berikut dan properti turunannya tidak digunakan lagi:
brandingSettings.image.backgroundImageUrl
brandingSettings.image.largeBrandedBannerImageImapScript
brandingSettings.image.largeBrandedBannerImageUrl
brandingSettings.image.smallBrandedBannerImageImapScript
brandingSettings.image.smallBrandedBannerImageUrl
Catatan: Tidak satu pun dari properti ini yang tunduk pada Kebijakan Penghentian API.
-
Properti
contentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons
baru dari resourcevideo
mengidentifikasi alasan yang menjelaskan mengapa video menerima rating DJCQT (Brasil). -
API kini mendukung error berikut:
Jenis error Detail error Deskripsi notFound (404)
channelNotFound
Metode channels.update
akan menampilkan error ini jika parameterid
permintaan menentukan saluran yang tidak dapat ditemukan.badRequest (400)
manualSortRequiredinvalidValue
Metode playlistItems.insert
danplaylistItems.update
akan menampilkan error ini jika permintaan mencoba menetapkan posisi item playlist, tetapi playlist tidak menggunakan pengurutan manual. Misalnya, item playlist dapat diurutkan menurut tanggal atau popularitas. Anda dapat mengatasi error ini dengan menghapus elemensnippet.position
dari resource yang dikirim dalam isi permintaan. Jika ingin item playlist memiliki posisi tertentu dalam daftar, Anda harus memperbarui setelan pengurutan playlist ke Manual terlebih dahulu. Setelan ini dapat disesuaikan di Pengelola Video YouTube.forbidden (403)
channelClosed
Metode playlists.list
akan menampilkan error ini jika parameterchannelId
permintaan menentukan saluran yang telah ditutup.forbidden (403)
channelSuspended
Metode playlists.list
akan menampilkan error ini jika parameterchannelId
permintaan menentukan saluran yang telah ditangguhkan.forbidden (403)
playlistForbidden
Metode playlists.list
akan menampilkan error ini jika parameterid
permintaan tidak mendukung permintaan atau permintaan tidak diberi otorisasi dengan benar.notFound (404)
channelNotFound
Metode playlists.list
akan menampilkan error ini jika parameterchannelId
permintaan menentukan saluran yang tidak dapat ditemukan.notFound (404)
playlistNotFound
Metode playlists.list
akan menampilkan error ini jika parameterid
permintaan menentukan playlist yang tidak dapat ditemukan.notFound (404)
videoNotFound
Metode videos.list
akan menampilkan error ini jika parameterid
permintaan menentukan video yang tidak dapat ditemukan.badRequest (400)
invalidRating
Metode videos.rate
akan menampilkan error ini jika permintaan berisi nilai yang tidak terduga untuk parameterrating
.
2 Maret 2015
Update ini berisi perubahan berikut:
-
Metode
search.list
kini mendukung parameterrelevanceLanguage
, yang memungkinkan Anda meminta hasil yang paling relevan untuk bahasa tertentu.Panduan migrasi YouTube Data API (v3) juga telah diperbarui untuk menjelaskan cara menggunakan parameter baru ini. Parameter ini mengatasi kesenjangan fitur yang sebelumnya ada antara versi API saat ini (v3) dan versi sebelumnya (v2), yang sudah tidak digunakan lagi.
-
Panduan migrasi YouTube Data API (v3) juga telah diperbarui untuk menunjukkan penghentian kolom metadata dan feed khusus yang disediakan API v2 untuk mendeskripsikan film, cuplikan, acara televisi, season televisi, dan episode televisi.
14 Januari 2015
Update ini berisi perubahan berikut:
-
Panduan migrasi YouTube Data API (v3) telah diperbarui untuk menjelaskan cara menggunakan API v3 untuk mengupload video menggunakan JavaScript. (Lihat bagian Mengupload video untuk mengetahui detailnya.) Fungsi ini sebanding dengan fungsi upload berbasis browser yang didukung API v2. Perhatikan bahwa perubahan pada panduan migrasi ini tidak mencerminkan perubahan API yang sebenarnya, melainkan ketersediaan kode contoh baru untuk mengupload video dengan JavaScript sisi klien.
Mengingat dukungan untuk mengupload video dengan library klien JavaScript dan CORS, panduan migrasi tidak lagi mencantumkan upload berbasis browser sebagai fitur yang mungkin tidak digunakan lagi di API v3.
-
Dokumentasi untuk metode
videos.insert
telah diperbarui untuk menyertakan contoh kode JavaScript baru yang dijelaskan di atas. Daftar contoh kode JavaScript untuk YouTube Data API (v3) juga telah diperbarui.
11 November 2014
Update ini berisi perubahan berikut:
-
Biaya kuota untuk panggilan ke metode
search.list
telah diubah menjadi 100 unit.Penting: Dalam banyak kasus, Anda dapat menggunakan metode API lain untuk mengambil informasi dengan biaya kuota yang lebih rendah. Misalnya, pertimbangkan dua cara berikut untuk menemukan video yang diupload ke channel GoogleDevelopers.
-
Biaya kuota: 100 unit
Panggil metode
search.list
dan telusuriGoogleDevelopers
. -
Biaya kuota: 6 unit
Panggil metode
channels.list
untuk menemukan ID saluran yang tepat. Setel parameterforUsername
keGoogleDevelopers
dan parameterpart
kecontentDetails
. Dalam respons API, properticontentDetails.relatedPlaylists.uploads
menentukan ID playlist untuk video yang diupload channel.Kemudian, panggil metode
playlistItems.list
dan setel parameterplaylistId
ke ID yang diambil dan parameterpart
kesnippet
.
-
8 Oktober 2014
Update ini berisi perubahan berikut:
-
Resource
channel
berisi dua properti baru:-
Properti
status.longUploadsStatus
menunjukkan apakah channel memenuhi syarat untuk mengupload video yang berdurasi lebih dari 15 menit. Properti ini hanya ditampilkan jika pemilik channel mengizinkan permintaan API. Nilai properti yang valid adalah:allowed
– Channel dapat mengupload video yang berdurasi lebih dari 15 menit.eligible
– Channel memenuhi syarat untuk mengupload video berdurasi lebih dari 15 menit, tetapi harus mengaktifkan fitur ini terlebih dahulu.disallowed
– Channel tidak dapat atau tidak memenuhi syarat untuk mengupload video yang berdurasi lebih dari 15 menit.
Lihat definisi properti untuk informasi selengkapnya tentang nilai ini. Pusat Bantuan YouTube juga memberikan informasi lebih mendetail tentang fitur ini.
-
Properti
invideoPromotion.useSmartTiming
menunjukkan apakah kampanye promosi saluran menggunakan "waktu pintar". Fitur ini mencoba menampilkan promosi pada titik tertentu dalam video yang cenderung diklik dan cenderung tidak mengganggu pengalaman menonton. Fitur ini juga mengambil satu promosi untuk ditampilkan di setiap video.
-
-
Definisi properti
snippet.title
dansnippet.categoryId
resourcevideo
telah diperbarui untuk memperjelas cara API menangani panggilan ke metodevideos.update
. Jika Anda memanggil metode tersebut untuk memperbarui bagiansnippet
dari resourcevideo
, Anda harus menetapkan nilai untuk kedua properti tersebut.Jika Anda mencoba memperbarui bagian
snippet
dari resourcevideo
dan tidak menetapkan nilai untuk kedua properti tersebut, API akan menampilkan errorinvalidRequest
. Deskripsi error tersebut juga telah diperbarui. -
Properti
contentDetails.contentRating.oflcRating
resourcevideo
, yang mengidentifikasi rating video dari Office of Film and Literature Classification Selandia Baru, kini mendukung dua rating baru:oflcRp13
danoflcRp16
. Keduanya masing-masing sesuai dengan ratingRP13
danRP16
. -
Metode
channelBanners.insert
kini mendukung error berikut:Jenis error Detail error Deskripsi badRequest
bannerAlbumFull
Album Header Channel YouTube pemilik channel memiliki terlalu banyak gambar. Pemilik saluran harus membuka http://photos.google.com, membuka halaman album, dan menghapus beberapa gambar dari album tersebut.
12 September 2014
Update ini berisi perubahan berikut:
-
Biaya kuota untuk panggilan ke metode
search.list
telah berubah dari 1 unit menjadi 2 unit selain biaya bagian resource yang telah ditetapkan.
13 Agustus 2014
Update ini berisi perubahan berikut:
-
Metode
subscriptions.insert
kini mendukung error berikut:Jenis error Detail error Deskripsi badRequest
subscriptionLimitExceeded
Pelanggan yang diidentifikasi dengan permintaan tersebut telah melampaui batas jumlah langganan. Langganan lainnya dapat dicoba dalam beberapa jam.
12 Agustus 2014
Update ini berisi perubahan berikut:
-
Panduan baru, berjudul Memigrasikan Aplikasi Anda ke YouTube Data API (v3), menjelaskan cara menggunakan YouTube Data API (v3) untuk menjalankan fungsi yang tersedia di YouTube Data API (v2). API lama secara resmi tidak digunakan lagi mulai 4 Maret 2014. Panduan ini bertujuan untuk membantu Anda memigrasikan aplikasi yang masih menggunakan API v2 ke versi API terbaru.
8 Juli 2014
Update ini berisi perubahan berikut:
-
Metode
playlists.insert
kini mendukung error berikut:Jenis error Detail error Deskripsi badRequest
maxPlaylistExceeded
Error ini terjadi jika playlist tidak dapat dibuat karena jumlah playlist yang diizinkan pada channel telah mencapai batas maksimum.
18 Juni 2014
Update ini berisi perubahan berikut:
-
Deskripsi setiap metode API telah diperbarui untuk menyertakan biaya kuota yang dikeluarkan oleh panggilan ke metode tersebut. Demikian pula, definisi parameter
part
telah diperbarui untuk menentukan biaya kuota setiap bagian yang dapat diambil dalam panggilan API. Misalnya, panggilan ke metodesubscriptions.insert
memiliki biaya kuota sekitar 50 unit. Resourcesubscription
juga berisi tiga bagian (snippet
,contentDetails
, dansubscriberSnippet
), dan masing-masing memiliki biaya dua unit.Perlu diingat bahwa biaya kuota dapat berubah tanpa peringatan.
-
Referensi
video
kini mendukung 43 sistem rating konten baru, yang mengidentifikasi rating yang diterima video dari berbagai lembaga rating nasional.
28 Mei 2014
Update ini berisi perubahan berikut:
-
Metode
search.list
kini mendukung parameterlocation
danlocationRadius
, yang memungkinkan Anda menelusuri video yang terkait dengan lokasi geografis. Permintaan harus menentukan nilai kedua parameter untuk mengambil hasil berdasarkan lokasi, dan API akan menampilkan error jika permintaan hanya menyertakan salah satu dari kedua parameter tersebut.-
Parameter
location
menetapkan koordinat lintang/bujur di pusat area geografis lingkaran. -
Parameter
locationRadius
menentukan jarak maksimum lokasi yang terkait dengan video dapat berada dari tengah area agar video tetap disertakan dalam hasil penelusuran.
-
13 Mei 2014
Update ini berisi perubahan berikut:
-
Properti
invideoPromotion.items[]
resourcechannel
telah diperbarui untuk menunjukkan bahwa biasanya Anda hanya dapat menetapkan satu item yang dipromosikan untuk channel Anda. Jika Anda mencoba menyisipkan terlalu banyak item yang dipromosikan, API akan menampilkan errortooManyPromotedItems
, yang memiliki kode status HTTP400
. -
Resource
channelSection
kini dapat berisi informasi tentang beberapa jenis konten unggulan baru. Propertisnippet.type
resourcechannelSection
kini mendukung nilai berikut:postedPlaylists
- playlist yang diposting pemilik channel ke feed aktivitas channelpostedVideos
- video yang diposting pemilik channel ke feed aktivitas channelsubscriptions
- channel yang di-subscribe pemilik channel
-
Properti
contentDetails.contentRating.ifcoRating
baru dari resourcevideo
mengidentifikasi rating yang diterima video dari Irish Film Classification Office. -
Definisi properti
position.cornerPosition
resourcewatermark
telah diperbarui untuk memperhatikan bahwa watermark selalu muncul di sudut kanan atas pemutar video. -
Definisi parameter
q
untuk metodesearch.list
telah diperbarui untuk mencatat bahwa istilah kueri dapat menggunakan operator Boolean NOT (-
) untuk mengecualikan video yang terkait dengan istilah penelusuran tertentu. Nilai ini juga dapat menggunakan operator Boolean OR (|
) untuk menemukan video yang terkait dengan salah satu dari beberapa istilah penelusuran. -
Definisi properti
pageInfo.totalResults
yang ditampilkan dalam respons API ke panggilansearch.list
telah diperbarui untuk mencatat bahwa nilai merupakan perkiraan dan mungkin tidak merepresentasikan nilai yang tepat. Selain itu, nilai maksimumnya adalah 1.000.000. Anda tidak boleh menggunakan nilai ini untuk membuat link penomoran halaman. Sebagai gantinya, gunakan nilai propertinextPageToken
danprevPageToken
untuk menentukan apakah akan menampilkan link penomoran halaman. -
Metode
watermarks.set
danwatermarks.unset
telah diperbarui untuk mencerminkan bahwa API menampilkan kode respons HTTP204
untuk permintaan yang berhasil ke metode tersebut.
2 Mei 2014
Update ini berisi perubahan berikut:
-
Resource
i18nLanguage
yang baru mengidentifikasi bahasa aplikasi yang didukung oleh situs YouTube. Bahasa aplikasi juga dapat disebut sebagai bahasa UI. Untuk situs web YouTube, bahasa aplikasi dapat dipilih secara otomatis berdasarkan setelan Akun Google, bahasa browser, atau lokasi IP, dan pengguna juga dapat memilih secara manual bahasa UI yang diinginkan dari footer situs YouTube.API mendukung metode untuk mencantumkan bahasa aplikasi yang didukung. Bahasa yang didukung dapat digunakan sebagai nilai parameter
hl
saat memanggil metode API sepertivideoCategories.list
danguideCategories.list
. -
Resource
i18nRegion
yang baru mengidentifikasi area geografis yang dapat dipilih pengguna YouTube sebagai wilayah konten pilihan. Wilayah konten juga dapat disebut sebagai lokalitas konten. Untuk situs YouTube, region konten dapat dipilih secara otomatis berdasarkan heuristik seperti domain YouTube atau lokasi IP pengguna, dan pengguna juga dapat memilih secara manual wilayah konten yang diinginkan dari footer situs YouTube.API mendukung metode untuk mencantumkan wilayah konten yang didukung. Kode wilayah yang didukung dapat digunakan sebagai nilai parameter
regionCode
saat memanggil metode API sepertisearch.list
,videos.list
,activities.list
, danvideoCategories.list
.
7 April 2014
Update ini berisi perubahan berikut:
-
Resource
channelSection
baru berisi informasi tentang serangkaian video yang telah dipilih channel untuk diunggulkan. Misalnya, suatu bagian dapat menampilkan upload terbaru channel, upload paling populer, atau video dari satu atau beberapa playlist.API ini mendukung metode untuk mencantumkan, menyisipkan, memperbarui, atau menghapus bagian saluran. Anda dapat mengambil daftar bagian saluran untuk saluran pengguna yang diautentikasi, dengan menentukan ID saluran tertentu, atau dengan menentukan daftar ID bagian saluran unik.
Dokumentasi error juga telah diperbarui untuk menjelaskan pesan error yang didukung API khususnya untuk metode baru ini.
-
Definisi objek
fileDetails
resourcevideo
telah diperbarui untuk menjelaskan bahwa objek tersebut hanya akan ditampilkan jika propertiprocessingDetails.fileDetailsAvailability
video memiliki nilaiavailable
.Demikian pula, definisi objek
suggestions
resourcevideo
telah diperbarui untuk menjelaskan bahwa objek tersebut hanya akan ditampilkan jika propertiprocessingDetails.tagSuggestionsAvailability
video atau propertiprocessingDetails.editorSuggestionsAvailability
-nya memiliki nilaiavailable
. -
Dokumentasi untuk metode
videos.insert
danvideos.update
telah diperbarui untuk mencerminkan bahwa propertistatus.publishAt
dapat disetel saat memanggil metode tersebut. -
Definisi objek
invideoPromotion
resourcechannel
telah diperbarui untuk menjelaskan bahwa objek hanya dapat diambil oleh pemilik saluran. -
Daftar parameter untuk metode
videos.rate
telah diperbarui untuk mencerminkan bahwa metode tersebut tidak benar-benar mendukung parameteronBehalfOfContentOwner
. Ini adalah error dokumentasi karena permintaanvideos.rate
yang menetapkan parameter ini menampilkan error500
.
31 Maret 2014
Update ini berisi perubahan berikut:
-
Properti
status.publishAt
baru dari resourcevideo
memungkinkan Anda menentukan tanggal dan waktu saat video pribadi dijadwalkan untuk dipublikasikan. Properti ini hanya dapat disetel jika status privasi video adalahprivate
dan video tidak pernah dipublikasikan. Properti baru ini tidak tunduk pada kebijakan penghentian layanan.
13 Maret 2014
Update ini berisi perubahan berikut:
-
API kini mendukung bagian
contentOwnerDetails
untuk resourcechannel
. Bagian baru berisi data channel yang relevan bagi partner YouTube yang ditautkan dengan channel, termasuk ID pemilik konten yang ditautkan ke channel tersebut serta tanggal dan waktu saat pemilik konten dan channel ditautkan. Perhatikan bahwa komponen baru ini tidak tunduk pada kebijakan penghentian layanan. -
Dokumentasi sekarang mencantumkan panjang karakter maksimum yang didukung untuk properti berikut:
Resource Properti Panjang maksimum channel
invideoPromotion.items[].customMessage
40 karakter video
snippet.title
100 karakter video
snippet.description
5.000 byte video
snippet.tags
500 karakter. Perhatikan bahwa nilai properti berupa daftar, dan tanda koma di antara item dalam daftar dihitung dalam batas. -
Properti
brandingSettings.watch.featuredPlaylistId
resourcechannel
tidak digunakan lagi. API akan menampilkan error jika Anda mencoba menetapkan nilainya. -
Properti resource
video
berikut telah ditambahkan ke daftar nilai yang dapat ditetapkan saat menyisipkan atau memperbarui video: -
Dokumentasi error sekarang menentukan kode respons HTTP untuk setiap jenis error.
-
API kini mendukung error berikut:
Jenis error Detail error Deskripsi badRequest (400)
invalidCriteria
Metode channels.list
akan menampilkan error ini jika permintaan mencantumkan parameter filter yang tidak dapat digunakan bersama satu sama lain.badRequest (400)
channelTitleUpdateForbidden
Metode channels.update
akan menampilkan error ini jika Anda mencoba mengupdate bagianbrandingSettings
saluran dan mengubah nilai propertibrandingSettings.channel.title
. (Perhatikan bahwa API tidak akan menampilkan error jika Anda menghilangkan properti.)badRequest (400)
invalidRecentlyUploadedBy
Metode channels.update
akan menampilkan error ini jika propertiinvideoPromotion.items[].id.recentlyUploadedBy
menetapkan ID saluran yang tidak valid.badRequest (400)
invalidTimingOffset
Metode channels.update
akan menampilkan error ini jika bagianinvideoPromotion
menentukan offset waktu yang tidak valid.badRequest (400)
tooManyPromotedItems
Metode channels.update
akan menampilkan error ini jika bagianinvideoPromotion
mencantumkan lebih dari jumlah item yang dipromosikan yang diizinkan.forbidden (403)
promotedVideoNotAllowed
Metode channels.update
menampilkan error ini jika propertiinvideoPromotion.items[].id.videoId
menentukan ID video yang tidak dapat ditemukan atau tidak dapat digunakan sebagai item yang dipromosikan.forbidden (403)
websiteLinkNotAllowed
Metode channels.update
akan menampilkan error ini jika propertiinvideoPromotion.items[].id.websiteUrl
menentukan URL yang tidak diizinkan.required (400)
requiredTimingType
Metode channels.update
akan menampilkan error ini jika permintaan tidak menentukan setelan waktu default terkait kapan YouTube harus menampilkan item yang dipromosikan.required (400)
requiredTiming
Metode channels.update
harus menentukan objekinvideoPromotion.items[].timing
untuk setiap item yang dipromosikan.required (400)
requiredWebsiteUrl
Metode channels.update
harus menentukan propertiinvideoPromotion.items[].id.websiteUrl
untuk setiap item yang dipromosikan.badRequest (400)
invalidPublishAt
Metode videos.insert
akan menampilkan error ini jika metadata permintaan mencantumkan waktu publikasi terjadwal yang tidak valid.
4 Maret 2014
Update ini berisi perubahan berikut:
-
YouTube Data API, v3 kini tunduk pada Kebijakan Penghentian Layanan yang dijelaskan dalam Persyaratan Layanan YouTube API. Perhatikan bahwa halaman yang mencantumkan API yang tunduk pada kebijakan penghentian penggunaan secara khusus mengecualikan beberapa fungsi API v3 agar tidak tunduk pada kebijakan ini.
5 Desember 2013
Update ini berisi perubahan berikut:
-
Dokumentasi metode
search.list
telah diperbarui untuk mencerminkan dengan benar bahwa Anda tidak perlu menentukan nilai untuk satu parameter filter secara tepat saat mengirimkan permintaan penelusuran. Namun, Anda dapat menetapkan nilai untuk parameter filter nol atau untuk satu parameter filter. -
Definisi untuk parameter metode
search.list
telah diperbarui untuk mengetahui bahwa Anda harus menetapkan nilai parametertype
kevideo
jika Anda juga menentukan nilai untuk salah satu parameter berikut:eventType
videoCaption
videoCategoryId
videoDefinition
videoDimension
videoDuration
videoEmbeddable
videoLicense
videoSyndicated
videoType
-
Ukuran minimum gambar banner channel yang diupload telah dikurangi menjadi 2048px kali 1152px. (Sebelumnya, ukuran minimum adalah 2120 x 1192 piksel.) Selain itu, perhatikan bahwa dokumentasi resource
channel
menentukan ukuran maksimum semua gambar banner yang disajikan dari API. Misalnya, ukuran maksimum gambarbrandingSettings.image.bannerTvImageUrl
untuk aplikasi televisi adalah 2120 x 1192 piksel, tetapi gambar sebenarnya mungkin 2048 x 1152 piksel. Pusat Bantuan YouTube memberikan panduan tambahan untuk mengoptimalkan header channel agar dapat ditampilkan di berbagai jenis perangkat. -
Beberapa definisi properti resource
channel
telah diperbarui untuk mencerminkan informasi berikut:- Nilai properti
brandingSettings.channel.description
memiliki panjang maksimum 1.000 karakter. - Properti
brandingSettings.channel.featuredChannelsTitle
memiliki panjang maksimum 30 karakter. - Properti
brandingSettings.channel.featuredChannelsUrls[]
kini dapat mencantumkan hingga 100 channel. - Nilai properti
brandingSettings.channel.unsubscribedTrailer
, jika ditetapkan, harus menentukan ID video YouTube dari video publik atau tidak publik yang dimiliki oleh pemilik channel.
- Nilai properti
-
Metode
channels.update
kini mendukung pembaruan pada propertiinvideoPromotion.items[].promotedByContentOwner
. Properti tersebut menunjukkan apakah nama pemilik konten akan ditampilkan saat menampilkan promosi. Atribut ini hanya dapat disetel jika permintaan API yang menetapkan nilai properti dibuat atas nama pemilik konten menggunakan parameteronBehalfOfContentOwner
. -
Metode
playlistItems.list
danplaylistItems.insert
kini mendukung parameteronBehalfOfContentOwner
, yang sudah didukung untuk beberapa metode lainnya. -
Properti
contentDetails.contentRating.acbRating
kini dapat menentukan rating dari Australian Classification Board (ACB) untuk film atau dari Australian Communications and Media Authority (ACMA) untuk program televisi anak-anak. -
Properti
contentDetails.contentRating.catvRating
dancontentDetails.contentRating.catvfrRating
yang baru mengidentifikasi rating yang diterima video menurut Sistem Klasifikasi TV Kanada dan sistem rating Régie du cinéma berbahasa Prancis, yang digunakan di Québec. -
Properti
snippet.assignable
baru dari resourcevideoCategory
menunjukkan apakah video yang diperbarui atau video yang baru diupload dapat dikaitkan dengan kategori video tersebut. -
Contoh kode telah ditambahkan untuk metode berikut:
activities.insert
(Buka)channelBanners.insert
(Python)channels.update
(Python)playlistItems.list
(Buka)search.list
(Buka)thumbnails.set
(Java)videos.insert
(Buka)
24 Oktober 2013
Update ini berisi perubahan berikut:
-
API ini mencakup dua fitur tambahan yang dirancang untuk membantu menemukan dan menampilkan konten live streaming:
Properti
snippet.liveBroadcastContent
yang baru di hasil penelusuran menunjukkan apakah resource video atau channel memiliki konten live streaming. Nilai properti yang valid adalahupcoming
,active
, dannone
.-
Properti
snippet.liveBroadcastContent
baru dari resourcevideo
menunjukkan apakah video merupakan live streaming yang akan datang atau aktif. Daftar di bawah ini menjelaskan kemungkinan nilai properti:upcoming
– Video adalah live streaming yang belum dimulai.active
– Video sedang melakukan live streaming.none
– Video bukan merupakan live streaming mendatang atau aktif. Nilai ini akan menjadi nilai properti untuk siaran yang telah selesai, yang masih dapat dilihat di YouTube.
-
Properti
liveStreamingDetails
baru dari resourcevideo
adalah objek yang berisi metadata tentang siaran video live. Untuk mengambil metadata ini, sertakanliveStreamingDetails
dalam daftar bagian resource untuk nilai parameterpart
. Metadata mencakup properti baru berikut:liveStreamingDetails.actualStartTime
– Waktu saat siaran benar-benar dimulai. (Nilai ini akan ada setelah status siaran adalahactive
.)liveStreamingDetails.actualEndTime
– Waktu saat siaran benar-benar berakhir. (Nilai ini akan ada setelah siaran selesai.)liveStreamingDetails.scheduledStartTime
– Waktu siaran dijadwalkan untuk dimulai.liveStreamingDetails.scheduledEndTime
– Waktu siaran dijadwalkan untuk berakhir. Jika nilai properti kosong atau properti tidak ada, siaran dijadwalkan untuk berlangsung tanpa batas waktu.liveStreamingDetails.concurrentViewers
– Jumlah orang yang menonton live streaming.
Untuk mengambil metadata ini, sertakan
liveStreamingDetails
dalam nilai parameterpart
saat memanggil metodevideos.list
,videos.insert
, atauvideos.update
.
Perlu diketahui bahwa dua fitur lain untuk mengidentifikasi konten live streaming dirilis pada 1 Oktober 2013 – parameter
eventType
metodesearch.list
dan propertisnippet.liveBroadcastContent
hasil penelusuran. -
-
Metode
videos.insert
kini mendukung parameternotifySubscribers
, yang menunjukkan apakah YouTube harus mengirimkan notifikasi tentang video baru kepada pengguna yang subscribe ke channel video tersebut. Nilai default parameter adalahTrue
, yang menunjukkan bahwa subscriber akan diberi tahu jika ada video yang baru diupload. Namun, pemilik channel yang mengupload banyak video dapat memilih untuk menyetel nilai keFalse
untuk menghindari pengiriman notifikasi tentang setiap video baru kepada subscriber channel. -
Daftar properti yang dapat diubah saat memanggil metode
channels.update
telah diperbarui untuk menyertakan propertiinvideoPromotion.items[].customMessage
daninvideoPromotion.items[].websiteUrl
. Selain itu, daftar telah dimodifikasi untuk mengidentifikasi propertibrandingSettings
yang dapat diubah. PropertibrandingSettings
ini sudah dapat diubah, sehingga perubahan dokumentasi tidak mencerminkan perubahan pada fungsi API yang ada. -
Metode
playlists.insert
,playlists.update
, danplaylists.delete
kini mendukung parameteronBehalfOfContentOwner
, yang sudah didukung untuk beberapa metode lainnya. -
Metode
playlists.insert
kini mendukung parameteronBehalfOfContentOwnerChannel
, yang sudah didukung untuk beberapa metode lainnya. -
Properti
contentDetails.contentRating.tvpgRating
resourcevideo
kini mendukung nilaipg14
, yang sesuai dengan ratingTV-14
. -
Definisi properti
snippet.liveBroadcastContent
, yang merupakan bagian dari hasil penelusuran, telah diperbaiki untuk mencerminkan bahwalive
adalah nilai properti yang valid, tetapiactive
bukan nilai properti yang valid. -
Properti
contentDetails.contentRating.mibacRating
resourcevideo
kini mendukung dua rating tambahan:mibacVap
(VAP) – Anak-anak harus didampingi orang dewasa.mibacVm6
(V.M.6) – Dibatasi untuk usia 6 tahun ke atas.mibacVm12
(V.M.12) – Dibatasi untuk usia 12 tahun ke atas.
-
Properti
invideoPromotion.items[].promotedByContentOwner
baru pada resourcechannel
menunjukkan apakah nama pemilik konten akan ditampilkan saat menampilkan promosi. Kolom ini hanya dapat disetel jika permintaan API yang menyetel nilai dilakukan atas nama pemilik konten. Lihat parameteronBehalfOfContentOwner
untuk mengetahui informasi selengkapnya.
1 Oktober 2013
Update ini berisi perubahan berikut:
-
Objek
auditDetails
baru dari resourcechannel
berisi 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 cakupanhttps://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. -
Properti
invideoPromotion.items[].id.type
resourcechannel
kini mendukung nilairecentUpload
, yang menunjukkan bahwa item yang dipromosikan adalah video yang baru diupload dari channel tertentu.Secara default, channel sama dengan channel yang data promosi in-video-nya ditetapkan. Namun, Anda dapat mempromosikan video yang baru diupload dari channel lain dengan menetapkan nilai properti
invideoPromotion.items[].id.recentlyUploadedBy
yang baru ke ID channel untuk channel tersebut. -
Resource
channel
berisi tiga properti baru –brandingSettings.image.bannerTvLowImageUrl
,brandingSettings.image.bannerTvMediumImageUrl
,brandingSettings.image.bannerTvHighImageUrl
– yang menentukan URL untuk gambar banner yang ditampilkan di halaman channel dalam aplikasi televisi. -
Properti
snippet.liveBroadcastContent
yang baru di hasil penelusuran menunjukkan apakah resource video atau channel memiliki konten live streaming. Nilai properti yang valid adalahupcoming
,active
, dannone
.- Untuk resource
video
, nilaiupcoming
menunjukkan bahwa video tersebut adalah live streaming yang belum dimulai, sedangkan nilaiactive
menunjukkan bahwa video adalah live streaming yang sedang berlangsung. - Untuk resource
channel
, nilaiupcoming
menunjukkan bahwa saluran memiliki siaran terjadwal yang belum dimulai, sedangkan nilaiacive
menunjukkan bahwa saluran memiliki live streaming yang sedang berlangsung.
- Untuk resource
-
Di resource
watermark
, propertitargetChannelId
telah berubah dari objek menjadi string. PropertitargetChannelId
kini menentukan nilai itu sendiri, bukan berisi properti turunan yang menentukan ID channel YouTube dari channel yang ditautkan oleh gambar watermark. Oleh karena itu, propertitargetChannelId.value
resource telah dihapus. -
Metode
thumbnails.set
kini mendukung parameteronBehalfOfContentOwner
, yang sudah didukung untuk beberapa metode lainnya. -
Metode
search.list
kini mendukung parametereventType
, yang membatasi penelusuran untuk hanya menampilkan peristiwa siaran aktif, mendatang, atau yang sudah selesai. -
Properti
contentDetails.contentRating.mibacRating
yang baru mengidentifikasi rating yang diterima video dari Ministero dei Beni e delle Attivita Culturali e del Turismo Italia. -
API kini mendukung error berikut:
Jenis error Detail error Deskripsi badRequest
invalidImage
Metode thumbnails.set
akan menampilkan error ini jika konten gambar yang diberikan tidak valid.forbidden
videoRatingDisabled
Metode videos.rate
akan menampilkan error ini jika pemilik video yang sedang diberi rating telah menonaktifkan rating untuk video tersebut.
27 Agustus 2013
Update ini berisi perubahan berikut:
-
Resource
watermark
baru mengidentifikasi gambar yang ditampilkan selama pemutaran video di channel tertentu. Anda juga dapat menentukan saluran target tempat gambar akan ditautkan serta detail pengaturan waktu yang menentukan kapan watermark muncul selama pemutaran video dan berapa lama watermark terlihat.Metode
watermarks.set
mengupload dan menyetel gambar watermark channel. Metodewatermarks.unset
menghapus gambar watermark channel.Dokumentasi error menjelaskan pesan error yang didukung API secara khusus untuk metode
watermarks.set
danwatermarks.unset
. -
Properti
statistics.hiddenSubscriberCount
baru dari resourcechannel
berisi nilai boolean yang menunjukkan apakah jumlah subscriber channel disembunyikan atau tidak. Dengan demikian, nilai properti adalahfalse
jika jumlah subscriber channel dapat dilihat oleh publik. -
Metode
playlists.list
kini mendukung parameteronBehalfOfContentOwner
danonBehalfOfContentOwnerChannel
. Kedua parameter sudah didukung untuk beberapa metode lainnya. -
Metode
videos.list
kini mendukung parameterregionCode
, yang mengidentifikasi region konten tempat diagram harus diambil. Parameter ini hanya dapat digunakan bersama dengan parameterchart
. Nilai parameter adalah kode negara ISO 3166-1 alpha-2. -
error documentation
menjelaskan error permintaan umum baru berikut, yang dapat terjadi untuk beberapa metode API:Jenis error Detail error Deskripsi forbidden
insufficientPermissions
Cakupan yang dikaitkan dengan token OAuth 2.0 yang diberikan untuk permintaan tidak cukup untuk mengakses data yang diminta.
15 Agustus 2013
Update ini berisi perubahan berikut:
-
Objek
invideoPromotion
resourcechannel
memiliki properti baru dan yang diperbarui berikut:-
API ini kini mendukung kemampuan untuk menentukan situs sebagai item yang dipromosikan. Untuk melakukannya, tetapkan nilai properti
invideoPromotion.items[].id.type
kewebsite
dan gunakan propertiinvideoPromotion.items[].id.websiteUrl
baru untuk menentukan URL. Gunakan juga propertiinvideoPromotion.items[].customMessage
yang baru untuk menentukan pesan kustom yang akan ditampilkan selama promosi.Link dapat mengarah ke situs terkait, situs penjual, atau situs jejaring sosial. Baca petunjuk Pusat Bantuan YouTube untuk situs terkait dan situs penjual guna mendapatkan informasi lebih lanjut terkait cara mengaktifkan link untuk konten Anda.
Dengan menambahkan link promosi, Anda setuju bahwa link tersebut tidak akan digunakan untuk mengalihkan traffic ke situs yang tidak sah dan bahwa link tersebut akan mematuhi kebijakan AdWords, kebijakan iklan YouTube, Pedoman Komunitas YouTube, dan Persyaratan Layanan YouTube.
-
Properti yang terkait dengan setelan waktu untuk menampilkan item yang dipromosikan selama pemutaran video telah disusun ulang:
-
Objek
invideoPromotion.timing
telah dipindahkan keinvideoPromotion.items[].timing
. Objek ini sekarang memungkinkan Anda menyesuaikan data waktu untuk setiap item yang dipromosikan dalam daftarinvideoPromotion.items[]
. -
Objek
invideoPromotion.defaultTiming
baru menentukan setelan waktu default untuk promosi Anda. Setelan tersebut menentukan kapan item yang dipromosikan akan ditampilkan selama pemutaran salah satu video di channel Anda. Anda dapat mengganti waktu default untuk setiap item yang dipromosikan menggunakan objekinvideoPromotion.items[].timing
. -
Properti
invideoPromotion.items[].timing.durationMs
yang baru menentukan jumlah waktu, dalam milidetik, untuk menampilkan promosi. ObjekinvideoPromotion.defaultTiming
juga berisi kolomdurationMs
yang menentukan jumlah waktu default saat item yang dipromosikan akan ditampilkan.
-
-
Properti
invideoPromotion.items[].type
daninvideoPromotion.items[].videoId
telah dipindahkan ke objekinvideoPromotion.items[].id
.
-
-
Metode
subscriptions.list
kini mendukung parameteronBehalfOfContentOwner
danonBehalfOfContentOwnerChannel
. Kedua parameter sudah didukung untuk beberapa metode lainnya. -
Dalam respons API terhadap permintaan
thumbnails.set
, nilai propertikind
telah diubah dariyoutube#thumbnailListResponse
menjadiyoutube#thumbnailSetResponse
. -
Contoh kode telah ditambahkan untuk metode berikut:
channels.update
(Java, Python)playlists.insert
(.NET, PHP)subscriptions.insert
(PHP, Python)thumbnails.set
(PHP, Python)videos.insert
(PHP)videos.list
(PHP)videos.rate
(Python)videos.update
(Java, PHP, Python)
Perlu diperhatikan bahwa contoh Python untuk metode
playlistItems.insert
juga dihapus karena fungsi yang ditunjukkan kini ditangani oleh metodevideos.rate
. -
error documentation
menjelaskan error konteks permintaan baru berikut, yang dapat terjadi untuk metode API apa pun yang mendukung parameter permintaanmine
:Jenis error Detail error Deskripsi badRequest
invalidMine
Parameter mine
tidak dapat digunakan dalam permintaan yang penggunanya merupakan partner YouTube. Anda harus menghapus parametermine
, melakukan autentikasi sebagai pengguna YouTube dengan menghapus parameteronBehalfOfContentOwner
, atau bertindak sebagai salah satu saluran partner dengan memberikan parameteronBehalfOfContentOwnerChannel
jika tersedia untuk metode yang dipanggil.
8 Agustus 2013
Update ini berisi perubahan berikut:
-
Bagian Penggunaan Kuota dalam panduan Memulai YouTube Data API telah diperbarui untuk mencerminkan perubahan biaya kuota upload video dari sekitar 16.000 unit menjadi sekitar 1.600 unit.
30 Juli 2013
Update ini berisi perubahan berikut:
-
Dalam resource
channelBanner
, nilai propertikind
telah diubah dariyoutube#channelBannerInsertResponse
menjadiyoutube#channelBannerResource
. Resource ini ditampilkan sebagai respons terhadap permintaanchannelBanners.insert
. -
Properti
brandingSettings.channel.profileColor
baru dari resourcechannel
menentukan warna jelas yang melengkapi konten channel. Nilai properti adalah tanda pagar (#
) yang diikuti dengan string heksadesimal enam karakter, seperti#2793e6
. -
API ini kini mendukung kemampuan untuk menentukan apakah subscription ditujukan untuk semua aktivitas channel atau hanya untuk upload baru. Properti
contentDetails.activityType
baru dari resourcesubscription
mengidentifikasi jenis aktivitas yang akan diberitahukan kepada pelanggan. Nilai properti yang valid adalahall
danuploads
. -
Metode
videos.list
mendukung parameter baru untuk mengambil diagram video terpopuler di YouTube:- Parameter
chart
mengidentifikasi diagram yang ingin Anda ambil. Saat ini, satu-satunya nilai yang didukung adalahmostPopular
. Perhatikan bahwa parameterchart
adalah parameter filter, yang berarti parameter tersebut tidak dapat digunakan dalam permintaan yang sama dengan parameter filter lainnya (id
danmyRating
). - Parameter
videoCategoryId
mengidentifikasi kategori video tempat diagram akan diambil. Parameter ini hanya dapat digunakan bersama dengan parameterchart
. Secara default, diagram tidak dibatasi pada kategori tertentu.
- Parameter
-
Properti
topicDetails.relevantTopicIds[]
baru dari resourcevideo
menyediakan daftar ID topik Freebase yang relevan dengan video atau kontennya. Subjek topik ini dapat disebutkan dalam atau muncul dalam video. -
Properti
recordingDetails.location.elevation
resourcevideo
telah diganti namanya menjadirecordingDetails.location.altitude
, dan propertifileDetails.recordingLocation.location.elevation
-nya telah diganti namanya menjadifileDetails.recordingLocation.location.altitude
. -
Objek
contentDetails.contentRating
resourcevideo
menentukan rating yang diterima video berdasarkan berbagai skema rating, termasuk rating MPAA, rating TVPG, dan sebagainya. Untuk setiap sistem rating, API kini mendukung nilai rating yang menunjukkan bahwa video belum diberi rating. Perhatikan bahwa untuk rating MPAA, "unrated" {i>rating<i} sering digunakan untuk mengidentifikasi versi film tanpa {i>uncut<i} yang mendapatkan {i>rating<i} resmi untuk film tersebut. -
Properti
contentDetails.contentRating.ytRating
baru dari resourcevideo
mengidentifikasi konten yang dikenai pembatasan usia. Nilai properti akan menjadiytAgeRestricted
jika YouTube mengidentifikasi bahwa video tersebut berisi konten yang tidak pantas bagi pengguna yang berusia di bawah 18 tahun. Jika properti tidak ada atau jika nilai properti kosong, konten tersebut belum diidentifikasi sebagai dikenai pembatasan usia. -
Parameter
mySubscribers
metodechannels.list
sudah tidak digunakan lagi. Gunakan metodesubscriptions.list
dan parametermySubscribers
-nya untuk mengambil daftar pelanggan ke saluran pengguna yang diautentikasi. -
Semua metode
channelBanners.insert
,channels.update
,videos.getRating
, danvideos.rate
sekarang mendukung parameteronBehalfOfContentOwner
. Parameter tersebut menunjukkan bahwa pengguna terautentikasi bertindak atas nama pemilik konten yang ditentukan di nilai parameter. -
Dokumentasi metode
channels.update
telah diperbarui untuk mencerminkan fakta bahwa metode tersebut dapat digunakan untuk memperbarui objekbrandingSettings
resourcechannel
dan properti turunannya. Sekarang dokumentasi juga mencantumkan daftar properti terbaru yang dapat Anda tetapkan untuk objekinvideoPromotion
resourcechannel
. -
error documentation
menjelaskan error baru berikut:Jenis error Detail error Deskripsi forbidden
accountDelegationForbidden
Error ini tidak spesifik untuk metode API tertentu. Otorisasi menunjukkan bahwa pengguna yang diautentikasi tidak diizinkan untuk bertindak atas nama Akun Google yang ditentukan. forbidden
authenticatedUserAccountClosed
Error ini tidak spesifik untuk metode API tertentu. Pesan ini menunjukkan bahwa akun YouTube pengguna terautentikasi ditutup. Jika pengguna bertindak atas nama Akun Google lain, error ini akan menunjukkan bahwa akun lain ditutup. forbidden
authenticatedUserAccountSuspended
Error ini tidak spesifik untuk metode API tertentu. Pesan ini menunjukkan bahwa akun YouTube pengguna yang diautentikasi ditangguhkan. Jika pengguna bertindak atas nama Akun Google lain, error ini akan menunjukkan bahwa akun lain ditangguhkan. forbidden
authenticatedUserNotChannel
Error ini tidak spesifik untuk metode API tertentu. Ini menunjukkan bahwa server API tidak dapat mengidentifikasi saluran yang terkait dengan permintaan API. Jika permintaan diberi otorisasi dan menggunakan parameter onBehalfOfContentOwner
, Anda juga harus menetapkan parameteronBehalfOfContentOwnerChannel
.forbidden
cmsUserAccountNotFound
Error ini tidak spesifik untuk metode API tertentu. Pengguna CMS tidak diizinkan untuk bertindak atas nama pemilik konten yang ditentukan. notFound
contentOwnerAccountNotFound
Error ini tidak spesifik untuk metode API tertentu. Akun pemilik konten yang ditentukan tidak ditemukan. badRequest
invalidPart
Error ini tidak spesifik untuk metode API tertentu. Parameter part
permintaan menentukan bagian yang tidak dapat ditulis secara bersamaan.badRequest
videoChartNotFound
Metode videos.list
akan menampilkan error ini jika permintaan mencantumkan diagram video yang tidak didukung atau tidak tersedia.notFound
videoNotFound
Metode videos.update
menampilkan error ini untuk menunjukkan bahwa video yang Anda coba perbarui tidak dapat ditemukan. Periksa nilai propertiid
dalam isi permintaan untuk memastikan nilainya benar.
10 Juni 2013
Update ini berisi perubahan berikut:
-
Parameter
forUsername
baru dari metodechannels.list
memungkinkan Anda mengambil informasi tentang channel dengan menentukan nama pengguna YouTube-nya. -
Metode
activities.list
kini mendukung parameterregionCode
, yang menginstruksikan API untuk menampilkan hasil yang relevan dengan negara yang ditentukan. YouTube menggunakan nilai ini saat aktivitas sebelumnya dari pengguna yang diotorisasi di YouTube tidak memberikan informasi yang memadai untuk membuat feed aktivitas. -
Resource playlist sekarang berisi properti
snippet.tags
. Properti hanya akan ditampilkan kepada pengguna yang diotorisasi yang mengambil data tentang playlist mereka sendiri. Pengguna yang diotorisasi juga dapat menetapkan tag playlist saat memanggil metodeplaylists.insert
atauplaylists.update
. -
Parameter
onBehalfOfContentOwner
, yang sebelumnya didukung untuk metodechannels.list
dansearch.list
, kini juga didukung untuk metodevideos.insert
,videos.update
, danvideos.delete
. Perhatikan bahwa saat parameter ini digunakan dalam panggilan ke metodevideos.insert
, permintaan tersebut juga harus menentukan nilai untuk parameteronBehalfOfContentOwnerChannel
baru, yang mengidentifikasi channel tempat video akan ditambahkan. Channel harus ditautkan ke pemilik konten yang ditentukan oleh parameteronBehalfOfContentOwner
.Parameter ini menunjukkan bahwa kredensial otorisasi permintaan mengidentifikasi pengguna YouTube CMS yang bertindak atas nama pemilik konten yang ditentukan dalam nilai parameter. Akun CMS yang digunakan pengguna untuk melakukan autentikasi harus ditautkan ke pemilik konten YouTube yang ditentukan.
Parameter ini ditujukan untuk partner konten yang memiliki dan mengelola berbagai channel YouTube. Dengan parameter ini, partner tersebut dapat melakukan autentikasi satu kali dan mendapatkan akses ke semua data video dan channel mereka, tanpa harus memberikan kredensial autentikasi untuk setiap channel.
Khusus terkait rilis ini, parameter ini kini memungkinkan partner konten menyisipkan, memperbarui, atau menghapus video di channel YouTube mana pun yang dimiliki partner tersebut.
-
error documentation
menjelaskan error baru berikut:Jenis error Detail error Deskripsi forbidden
insufficientCapabilities
Error ini tidak spesifik untuk metode API tertentu. Ini menunjukkan bahwa pengguna CMS yang memanggil API tidak memiliki izin yang memadai untuk melakukan operasi yang diminta. Error ini terkait dengan penggunaan parameter onBehalfOfContentOwner
, yang didukung untuk beberapa metode API.unauthorized
authorizationRequired
Metode activities.list
menampilkan error ini saat permintaan menggunakan parameterhome
, tetapi tidak diberi otorisasi dengan benar. -
Di resource
channels
, propertiinvideoPromotion.channelId
telah dihapus karena ID channel telah ditentukan menggunakan propertiid
resource. -
Panduan baru Menggunakan ID Channel menjelaskan cara API menggunakan ID channel. Panduan ini mungkin sangat berguna bagi developer yang bermigrasi dari API versi sebelumnya dan yang memiliki aplikasi yang meminta konten untuk pengguna
default
, atau yang mengandalkan anggapan bahwa setiap channel YouTube memiliki nama pengguna unik, dan hal ini tidak berlaku lagi.
22 Mei 2013
Update ini berisi perubahan berikut:
-
Metode
channelBanners.insert
baru memungkinkan Anda mengupload gambar banner yang selanjutnya dapat ditetapkan sebagai gambar banner untuk channel menggunakan propertibrandingSettings.image.bannerExternalUrl
baru dari resourcechannel
. -
Dokumentasi untuk metode
channels.update
telah diperbarui untuk mencantumkan properti yang dapat diubah saat memanggil metode. -
Dokumentasi resource
video
tidak lagi mencantumkanunspecified
sebagai nilai properti yang valid untuk propertisuggestions.processingErrors[]
,suggestions.processingHints[]
,suggestions.processingWarnings[]
, dansuggestions.editorSuggestions[]
. -
Parameter
maxResults
metodevideos.list
sekarang memiliki nilai default5
. -
error documentation
kini mencantumkan error untuk metodechannelBanners.insert
dansubscriptions.list
. Bagian ini juga mencantumkan beberapa error baru untuk metodechannels.update
.
14 Mei 2013
Update ini berisi perubahan berikut:
-
Halaman mandiri kini mencantumkan contoh kode untuk Java, .NET, PHP, dan Ruby.
-
Halaman yang mencantumkan contoh kode Python kini menyertakan contoh untuk menambahkan langganan, membuat playlist, dan memperbarui video.
10 Mei 2013
Update ini berisi perubahan berikut:
-
YouTube tidak lagi mengidentifikasi fitur dan layanan API eksperimental. Sebagai gantinya, sekarang kami menyediakan daftar YouTube API yang tunduk pada kebijakan penghentian layanan.
8 Mei 2013
Update ini berisi perubahan berikut:
-
Resource saluran kini mendukung objek
inVideoPromotion
, yang merangkum informasi tentang kampanye promosi yang terkait dengan saluran. Channel dapat menggunakan kampanye promosi in-video untuk menampilkan gambar thumbnail untuk video yang dipromosikan dalam pemutar video selama pemutaran video di channel tersebut.Anda dapat mengambil data ini dengan menyertakan
invideoPromotion
dalam nilai parameterpart
dalam permintaanchannels.list
. -
Metode
channels.update
baru dapat digunakan untuk memperbarui data kampanye promosi in-video channel. Perhatikan bahwa metode ini hanya mendukung update pada bagianinvideoPromotion
resourcechannel
dan belum mendukung update untuk bagian lain dari resource tersebut.
2 Mei 2013
Update ini berisi perubahan berikut:
-
Sumber daya saluran kini mendukung properti
status.isLinked
, yang menunjukkan apakah data saluran 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. -
Resource langganan kini mendukung bagian
subscriberSnippet
. Objek tersebut dienkapsulasi berisi data cuplikan untuk channel subscriber. -
API tersebut kini mendukung metode
videos.getRating
, yang mengambil rating yang diberikan pengguna terautentikasi ke daftar satu atau beberapa video. -
Parameter
myRating
baru dari metodevideos.list
memungkinkan Anda mengambil daftar video yang diberi rating oleh pengguna terautentikasi dengan ratinglike
ataudislike
.Parameter
myRating
dan parameterid
kini dianggap sebagai parameter filter, yang berarti permintaan API harus menentukan salah satu parameter. (Sebelumnya, parameterid
adalah parameter wajib untuk metode ini.)Metode ini menampilkan error
forbidden
untuk permintaan yang mencoba mengambil informasi rating video, tetapi tidak diberi otorisasi dengan benar untuk melakukannya. -
Dengan diperkenalkannya parameter
myRating
, metodevideos.list
juga telah diperbarui untuk mendukung penomoran halaman. Namun, perhatikan bahwa parameter paging hanya didukung untuk permintaan yang menggunakan parametermyRating
. (Parameter dan informasi Paging tidak didukung untuk permintaan yang menggunakan parameterid
.)-
Parameter
maxResults
menentukan jumlah maksimum video yang dapat ditampilkan API dalam kumpulan hasil, dan parameterpageToken
mengidentifikasi halaman tertentu dalam set hasil yang ingin Anda ambil. -
Resource
youtube#videoListResponse
, yang ditampilkan sebagai respons terhadap permintaanvideos.list
, kini berisi objekpageInfo
, yang berisi detail seperti jumlah total hasil dan jumlah hasil yang disertakan dalam set hasil saat ini. Resourceyoutube#videoListResponse
juga dapat menyertakan propertinextPageToken
danprevPageToken
, yang masing-masing menyediakan token yang dapat digunakan untuk mengambil halaman tertentu dalam kumpulan hasil.
-
-
Metode
videos.insert
mendukung parameter baru berikut:autoLevels
– Setel nilai parameter ini ketrue
untuk memerintahkan YouTube meningkatkan pencahayaan dan warna video secara otomatis.stabilize
– Setel nilai parameter ini ketrue
untuk memerintahkan YouTube menyesuaikan video dengan menghilangkan guncangan yang disebabkan oleh gerakan kamera.
-
Properti
channelTitle
telah ditambahkan kesnippet
untuk resource berikut:playlistItem
– Properti menentukan nama channel yang menambahkan item playlist.playlist
– Properti menentukan nama channel yang membuat playlist.subscription
– Properti menentukan nama channel yang disubscribe.
-
Contoh kode telah ditambahkan untuk metode berikut:
activities.insert
(Ruby)playlistItems.list
(.NET)search.list
(.NET)subscriptions.insert
(Java, Ruby)videos.insert
(.NET, Ruby)
-
Parameter
mySubscribers
baru dari metodesubscriptions.list
memungkinkan Anda mengambil daftar pelanggan pengguna yang saat ini diautentikasi. Parameter ini hanya dapat digunakan dalam permintaan yang diberi otorisasi dengan benar.Catatan: Fungsi ini dimaksudkan untuk menggantikan parameter
mySubscribers
yang saat ini didukung untuk metodechannels.list
. Parameter tersebut tidak akan digunakan lagi. -
Dalam resource
video
, nilai propertiunspecified
tidak lagi menjadi nilai yang mungkin untuk salah satu properti berikut: -
Permintaan API yang berisi parameter tak terduga kini menampilkan error
badRequest
, dan alasan error yang dilaporkan adalahunexpectedParameter
. -
Error yang ditampilkan metode
playlistItems.insert
saat playlist telah berisi jumlah maksimum item yang diizinkan. Error ini telah diperbarui. Error tersebut kini dilaporkan sebagai errorforbidden
, dan alasan error tersebut adalahplaylistContainsMaximumNumberOfVideos
.
19 April 2013
Update ini berisi perubahan berikut:
-
Metode
videos.rate
baru memungkinkan pengguna menyetel ratinglike
ataudislike
pada video atau menghapus rating dari video.Dokumentasi error juga telah diperbarui untuk mencantumkan error yang mungkin ditampilkan API sebagai respons terhadap panggilan metode
videos.rate
. -
Gambar thumbnail kini diidentifikasi dalam dokumentasi API sebagai referensi terpisah, dan metode
thumbnails.set
yang baru memungkinkan Anda mengupload thumbnail video kustom ke YouTube dan menyetelnya untuk video.Dokumentasi error juga telah diperbarui untuk mencantumkan error yang mungkin ditampilkan API sebagai respons terhadap panggilan metode
thumbnails.set
.Perhatikan bahwa perubahan ini tidak benar-benar memengaruhi resource yang sudah ada yang menampilkan gambar thumbnail. Gambar thumbnail ditampilkan di resource tersebut dengan cara yang sama seperti sebelumnya, meskipun dokumentasi sekarang mencantumkan nama berbagai ukuran thumbnail yang mungkin ditampilkan oleh API.
-
Bagian
brandingSettings
baru pada resourcechannel
mengidentifikasi setelan, teks, dan gambar untuk halaman channel dan halaman tonton video pada channel tersebut. -
Resource
playlistItem
berisi properti baru berikut:-
Objek
status
baru merangkum informasi status tentang item playlist, dan propertistatus.privacyStatus
mengidentifikasi status privasi item playlist.
-
-
Resource
video
berisi properti baru berikut:-
Properti
status.publicStatsViewable
menunjukkan apakah statistik video yang diperluas di halaman tonton dapat dilihat oleh publik. Secara default, statistik tersebut dapat dilihat, dan statistik seperti jumlah penayangan dan rating video akan tetap terlihat secara publik meskipun nilai properti ini ditetapkan kefalse
. Anda dapat menetapkan nilai properti ini saat memanggil metodevideos.insert
atauvideos.update
. -
Objek
contentDetails.contentRating
merangkum rating yang diterima video dalam berbagai skema rating. Daftar di bawah ini mengidentifikasi sistem rating yang didukung dan menyediakan link ke properti yang terkait dengan setiap sistem rating. Definisi properti mengidentifikasi nilai rating yang didukung untuk setiap sistem.Negara Sistem rating Properti Amerika Serikat Motion Picture Association of America (MPAA) contentDetails.contentRating.mpaaRating
Amerika Serikat Panduan TV untuk Orang Tua contentDetails.contentRating.tvpgRating
Australia Australian Classification Board (ACB) contentDetails.contentRating.acbRating
Brasil Departamento de Justiça, Classificação, Qualificação e Títulos contentDetails.contentRating.djctqRating
Kanada Sistem Rating Video Rumah Kanada (CHVRS) contentDetails.contentRating.chvrsRating
Prancis Centre National du cinéma et de l'image animée (Kementerian Kebudayaan Prancis) contentDetails.contentRating.fmocRating
Jerman Freiwillige Selbstkontrolle der Filmwirtschaft (FSK) contentDetails.contentRating.fskRating
Britania Raya Dewan Klasifikasi Film Inggris (BBFC) contentDetails.contentRating.bbfcRating
India Central Board of Film Certification (CBFC) contentDetails.contentRating.cbfcRating
Jepang 映倫管理委員会 (EIRIN) contentDetails.contentRating.eirinRating
Korea 영물등設위니회 (KMRB) contentDetails.contentRating.kmrbRating
Meksiko Direktorat Jenderal Radio, Televisi, dan Sinematografi (RTC) contentDetails.contentRating.rtcRating
Selandia Baru Kantor Klasifikasi Film dan Sastra contentDetails.contentRating.oflcRating
Rusia Pendaftaran Film Nasional Federasi Rusia contentDetails.contentRating.russiaRating
Spanyol Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA) contentDetails.contentRating.icaaRating
-
-
Dokumentasi metode
playlistItems.update
telah diperbarui untuk mencerminkan fakta bahwa propertisnippet.resourceId
harus ditentukan dalam resource yang dikirim sebagai isi permintaan. -
Metode
search.list
kini mendukung fungsi berikut:-
Parameter
forMine
yang baru membatasi penelusuran agar hanya mengambil video pengguna yang diautentikasi. -
Parameter
order
kini mendukung kemampuan untuk mengurutkan hasil menurut abjad berdasarkan judul (order=title
) atau berdasarkan jumlah video dalam urutan menurun (order=videoCount
). -
Parameter
safeSearch
baru menunjukkan apakah hasil penelusuran harus menyertakan konten yang dibatasi.
-
-
Metode
videos.insert
mendukung beberapa error baru, yang tercantum dalam tabel di bawah:Jenis error Detail error Deskripsi badRequest
invalidCategoryId
Properti snippet.categoryId
mencantumkan ID kategori yang tidak valid. Gunakan metodevideoCategories.list
untuk mengambil kategori yang didukung.badRequest
invalidRecordingDetails
metadata specifies invalid recording details.
badRequest
invalidVideoGameRating
Metadata permintaan mencantumkan rating video game yang tidak valid. badRequest
invalidVideoMetadata
Metadata permintaan tidak valid. -
Parameter
onBehalfOfContentOwner
telah dihapus dari daftar parameter yang didukung untuk metodevideos.update
danvideos.delete
.
12 Maret 2013
Update ini berisi perubahan berikut:
-
Properti
channelTitle
telah ditambahkan kesnippet
untuk resource berikut: -
Metode
search.list
mendukung parameter baru berikut:-
Parameter
channelType
memungkinkan Anda membatasi penelusuran saluran untuk mengambil semua saluran atau hanya mengambil acara TV. -
Parameter
videoType
memungkinkan Anda membatasi penelusuran video untuk mengambil semua video atau hanya mengambil film atau episode acara saja.
-
-
Definisi bagian
recordingDetails
resourcevideo
telah diperbarui untuk mencatat bahwa objek hanya akan ditampilkan untuk video jika data geolokasi video atau waktu perekaman telah ditetapkan. -
Metode
playlistItems.update
kini menampilkan errorinvalidSnippet
, yang ditampilkan jika permintaan API tidak menentukan cuplikan yang valid. -
Beberapa metode API mendukung parameter baru yang ditujukan khusus untuk partner konten YouTube. Partner konten YouTube meliputi studio film dan televisi, label rekaman, dan kreator konten lainnya yang membuat kontennya tersedia di YouTube.
-
Parameter
onBehalfOfContentOwner
menunjukkan bahwa kredensial otorisasi permintaan mengidentifikasi pengguna YouTube CMS yang bertindak atas nama pemilik konten yang ditentukan di nilai parameter. Akun CMS yang digunakan pengguna untuk melakukan autentikasi harus ditautkan ke pemilik konten YouTube yang ditentukan.Parameter ini ditujukan untuk partner konten yang memiliki dan mengelola berbagai channel YouTube. Dengan parameter ini, partner tersebut dapat melakukan autentikasi satu kali dan mendapatkan akses ke semua data video dan channel mereka, tanpa harus memberikan kredensial autentikasi untuk setiap channel.
Semua metode
channels.list
,search.list
,videos.delete
,videos.list
, danvideos.update
mendukung parameter ini. -
Parameter
managedByMe
, yang didukung oleh metodechannels.list
, menginstruksikan API untuk menampilkan semua saluran milik pemilik konten yang ditentukan oleh parameteronBehalfOfContentOwner
. -
Parameter
forContentOwner
, yang didukung oleh metodesearch.list
, menginstruksikan API untuk membatasi hasil penelusuran agar hanya menyertakan resource milik pemilik konten yang ditentukan oleh parameteronBehalfOfContentOwner
.
-
25 Februari 2013
Update ini berisi perubahan berikut:
-
API ini mendukung beberapa bagian dan properti baru untuk resource
video
:-
Bagian
fileDetails
,processingDetails
, dansuggestions
yang baru memberikan informasi kepada pemilik video tentang video yang mereka upload. Data ini sangat berguna dalam aplikasi yang memungkinkan upload video dan mencakup hal berikut:- status dan progres pemrosesan
- error atau masalah lain yang dialami saat memproses video
- ketersediaan gambar thumbnail
- saran untuk meningkatkan kualitas video atau metadata
- detail tentang file asli yang diupload ke YouTube
Semua bagian ini hanya dapat diambil oleh pemilik video. Daftar di bawah ini menjelaskan secara singkat bagian-bagian baru, dan dokumentasi resource
video
menentukan semua properti yang terdapat dalam setiap bagian.-
Objek
fileDetails
berisi informasi tentang file video yang diupload ke YouTube, termasuk resolusi file, durasi, codec audio dan video, kecepatan bit streaming, dan lainnya. -
Objek
processingProgress
berisi informasi tentang kemajuan YouTube dalam memproses file video yang diupload. Properti objek mengidentifikasi status pemrosesan saat ini dan memperkirakan waktu yang tersisa hingga YouTube selesai memproses video. Bagian ini juga menunjukkan apakah berbagai jenis data atau konten, seperti detail file atau gambar thumbnail, tersedia untuk video.Objek ini dirancang untuk polling, sehingga uploader video dapat melacak progres yang telah dibuat YouTube dalam memproses file video yang diupload.
-
Objek
suggestions
berisi saran yang mengidentifikasi peluang untuk meningkatkan kualitas video atau metadata untuk video yang diupload.
-
Bagian
contentDetails
berisi empat properti baru. Properti ini dapat diambil dengan permintaan yang tidak diautentikasi.dimension
– Menunjukkan apakah video tersedia dalam 2D atau 3D.definition
– Menunjukkan apakah video tersedia dalam definisi standar atau tinggi.caption
– Menunjukkan apakah teks tersedia untuk video atau tidak.licensedContent
– Menunjukkan apakah video berisi konten yang telah diklaim oleh partner konten YouTube.
-
Bagian
status
berisi dua properti baru. Pemilik video dapat menyetel nilai untuk kedua properti saat menyisipkan atau memperbarui video. Properti ini juga dapat diambil dengan permintaan yang tidak diautentikasi.embeddable
– Menunjukkan apakah video dapat disematkan di situs lain.license
– Menentukan lisensi video. Nilai yang valid adalahcreativeCommon
danyoutube
.
-
-
Definisi parameter
part
telah diperbarui untuk metodevideos.list
,videos.insert
, danvideos.update
untuk mencantumkan bagian yang baru ditambahkan seperti yang dijelaskan di atas serta bagianrecordingDetails
, yang secara tidak sengaja dihilangkan. -
Properti
contentDetails.googlePlusUserId
baru dari resourcechannel
menentukan ID profil Google+ yang terkait dengan saluran. Nilai ini dapat digunakan untuk membuat link ke profil Google+. -
Setiap objek gambar thumbnail kini menentukan lebar dan tinggi gambar. Gambar thumbnail saat ini ditampilkan di resource
activity
,channel
,playlist
,playlistItem
,search result
,subscription
, danvideo
. -
playlistItems.list
kini mendukung parametervideoId
, yang dapat digunakan bersama dengan parameterplaylistId
untuk hanya mengambil item playlist yang mewakili video yang ditentukan.API akan menampilkan error
notFound
jika video yang diidentifikasi parameter tidak dapat ditemukan dalam playlist. -
Dokumentasi error menjelaskan error
forbidden
baru, yang menunjukkan bahwa permintaan tidak diberi otorisasi dengan benar untuk tindakan yang diminta. -
Properti
snippet.channelId
resourcechannel
telah dihapus. Propertiid
resource memberikan nilai yang sama.
30 Januari 2013
Update ini berisi perubahan berikut:
-
Halaman error baru mencantumkan error yang dapat ditampilkan API. Halaman ini menyertakan error umum, yang mungkin terjadi untuk beberapa metode API yang berbeda, serta error spesifik per metode.
16 Januari 2013
Update ini berisi perubahan berikut:
-
Contoh kode kini tersedia untuk metode dan bahasa yang ditampilkan dalam daftar di bawah:
activities.insert
– JavaplaylistItems.insert
– PythonplaylistItems.list
– Java, JavaScript, PHP, Python, Rubyplaylists.insert
– Java, JavaScript, Pythonsearch.list
– Java, JavaScript, Python, Rubyvideos.insert
– Java
-
Resource
activity
kini dapat melaporkan tindakanchannelItem
, yang terjadi saat YouTube menambahkan video ke channel YouTube yang dibuat secara otomatis. (YouTube secara algoritmis mengidentifikasi topik yang memiliki kehadiran signifikan di situs web YouTube dan secara otomatis membuat saluran untuk topik tersebut.) -
Parameter
search.list
berikut telah diperbarui:- Parameter
q
tidak lagi ditetapkan sebagai filter, yang berarti .... - Parameter
relatedToVideo
telah diganti namanya menjadirelatedToVideoId
. - Parameter
published
telah diganti dengan dua parameter baru,publishedAfter
danpublishedBefore
, yang dijelaskan di bawah.
- Parameter
-
Metode
search.list
mendukung parameter baru berikut:Nama parameter Nilai Deskripsi channelId
string
Menampilkan resource yang dibuat oleh saluran yang ditentukan. publishedAfter
datetime
Menampilkan resource yang dibuat setelah waktu yang ditentukan. publishedBefore
datetime
Menampilkan resource yang dibuat sebelum waktu yang ditentukan. regionCode
string
Menampilkan resource untuk negara yang ditentukan. videoCategoryId
string
Filter hasil penelusuran video agar hanya menyertakan video yang terkait dengan kategori video yang ditentukan. videoEmbeddable
string
Filter hasil penelusuran video agar hanya menyertakan video yang dapat diputar dalam pemutar tersemat di halaman web. Setel nilai parameter ke true
untuk hanya mengambil video yang dapat disematkan.videoSyndicated
string
Filter hasil penelusuran video agar hanya menyertakan video yang dapat diputar di luar YouTube.com. Setel nilai parameter ke true
untuk hanya mengambil video yang didistribusikan offline. -
Beberapa resource API mendukung properti baru. Tabel di bawah mengidentifikasi resource dan properti barunya:
Resource Nama properti Nilai Deskripsi activity
contentDetails.playlistItem.playlistItemId
string
ID item playlist yang ditetapkan YouTube untuk mengidentifikasi item dalam playlist secara unik. activity
contentDetails.channelItem
object
Objek yang berisi informasi tentang resource yang ditambahkan ke saluran. Properti ini hanya ada jika snippet.type
adalahchannelItem
.activity
contentDetails.channelItem.resourceId
object
Objek yang mengidentifikasi resource yang ditambahkan ke saluran. Seperti properti resourceId
lainnya, properti ini berisi propertikind
yang menentukan jenis resource, seperti video atau playlist. Elemen ini juga berisi tepat salah satu dari beberapa properti –videoId
,playlistId
, dll. – yang menentukan ID yang mengidentifikasi resource tersebut secara unik.channel
status
object
Objek ini merangkum informasi tentang status privasi channel. channel
status.privacyStatus
string
Status privasi channel. Nilai yang valid adalah private
danpublic
.playlist
contentDetails
object
Objek ini berisi metadata tentang konten playlist. playlist
contentDetails.itemCount
unsigned integer
Jumlah video dalam playlist. playlist
player
object
Objek ini berisi informasi yang akan Anda gunakan untuk memutar playlist di pemutar tersemat. playlist
player.embedHtml
string
Tag <iframe>
yang menyematkan pemutar video yang memutar playlist.video
recordingDetails
object
Objek ini merangkum informasi yang mengidentifikasi atau menjelaskan tempat dan waktu saat video direkam. video
recordingDetails.location
object
Objek ini berisi informasi geolokasi yang terkait dengan video. video
recordingDetails.location.latitude
double
Lintang dalam derajat. video
recordingDetails.location.longitude
double
Bujur dalam derajat. video
recordingDetails.location.elevation
double
Ketinggian di atas Bumi, dalam meter. video
recordingDetails.locationDescription
string
Deskripsi teks yang menunjukkan lokasi rekaman video. video
recordingDetails.recordingDate
datetime
Tanggal dan waktu video direkam. Nilai ditentukan dalam format ISO 8601 ( YYYY-MM-DDThh:mm:ss.sZ
). -
Dokumentasi untuk beberapa metode API kini mengidentifikasi properti yang harus ditentukan dalam isi permintaan atau yang diupdate berdasarkan nilai dalam isi permintaan. Tabel di bawah mencantumkan metode tersebut serta properti wajib atau yang dapat diubah.
Catatan: Dokumentasi untuk metode lain mungkin sudah mencantumkan properti yang diperlukan dan dapat diubah.
Metode Properti activities.insert
Properti yang diperlukan: snippet.description
snippet.description
contentDetails.bulletin.resourceId
playlists.update
Properti yang diperlukan: id
playlistItems.update
Properti yang diperlukan: id
videos.update
Properti yang diperlukan: id
-
API ini tidak lagi melaporkan error
playlistAlreadyExists
jika Anda mencoba membuat atau memperbarui playlist yang memiliki judul yang sama dengan playlist yang sudah ada di channel yang sama. -
Beberapa metode API mendukung jenis error baru. Tabel di bawah ini mengidentifikasi metode dan error yang baru didukung:
Metode Jenis error Detail error Deskripsi guideCategories.list
notFound
notFound
Kategori panduan yang diidentifikasi oleh parameter id
tidak dapat ditemukan. Gunakan metode guideCategories.list untuk mengambil daftar nilai yang valid.playlistItems.delete
forbidden
playlistItemsNotAccessible
Permintaan tidak diberi otorisasi dengan benar untuk menghapus item playlist yang ditentukan. videoCategories.list
notFound
videoCategoryNotFound
Kategori video yang diidentifikasi oleh parameter id
tidak dapat ditemukan. Gunakan metode videoCategories.list untuk mengambil daftar nilai yang valid.