Catatan: Mematuhi Kebijakan Developer YouTube memberikan panduan dan contoh untuk membantu Anda memastikan bahwa klien API Anda mengikuti bagian tertentu dari Persyaratan dan Kebijakan Layanan YouTube API (TOS API). Panduan ini menawarkan insight tentang cara YouTube menerapkan aspek tertentu dari TOS API, tetapi tidak menggantikan dokumen yang ada.
Dokumen ini menentukan persyaratan fungsional minimum untuk klien API yang menerapkan atau memberikan akses ke fitur tertentu dari layanan YouTube API ("Klien API").
Persyaratan dan panduan ini memastikan bahwa klien API memberikan pengalaman pengguna yang konsisten yang melindungi kepentingan pengguna YouTube, pemilik konten, dan pengiklan. Aturan ini merupakan bagian integral dari Persyaratan Layanan YouTube API dan harus diikuti dalam pengembangan dan penerapan Klien API apa pun.
Persyaratan dalam dokumen ini dapat berubah agar kami dapat memastikan pengalaman pengguna yang lebih baik dengan fitur YouTube yang ada. Kebijakan ini juga akan berubah sebagai respons terhadap fitur YouTube baru dan yang diperbarui. Terkadang, perubahan tersebut mungkin mengharuskan Anda mengupdate Klien API untuk memenuhi persyaratan baru. Histori revisi Persyaratan Layanan akan mendokumentasikan setiap perubahan, jadi periksa dokumen tersebut secara rutin, atau berlangganan feed RSS-nya, untuk memastikan Anda dapat dengan cepat mempelajari perubahan yang dapat memengaruhi Klien API Anda.
Selain persyaratan dalam dokumen ini, sebaiknya Anda mengikuti praktik terbaik yang dijelaskan dalam Kebijakan Layanan YouTube API dan dibahas di tempat lain dalam dokumentasi layanan YouTube API. Meskipun tidak sepenuhnya diperlukan, praktik ini membantu Klien API Anda pulih lebih cepat dari error dan mengoptimalkan penggunaan kuota jika mereka menggunakan layanan YouTube API yang mengalokasikan kuota. Pada saat yang sama, praktik ini membantu memastikan kesehatan ekosistem YouTube dan, yang terpenting, memberikan pengalaman terbaik kepada pengguna Klien API dan Aplikasi YouTube Anda.
Pemutar tersemat YouTube dan pemutaran video
Persyaratan di bagian ini berkaitan secara khusus dengan pemutar YouTube tersemat. Kebijakan Layanan YouTube API juga mencakup beberapa kebijakan yang relevan dengan Klien API yang memutar konten audiovisual YouTube.
Ukuran Pemutar YouTube tersemat
Pemutar tersemat harus memiliki area pandang minimal 200x200 piksel. Jika pemutar menampilkan kontrol, pemutar harus cukup besar untuk menampilkan kontrol sepenuhnya tanpa memperkecil area pandang di bawah ukuran minimum. Sebaiknya pemutar 16:9 memiliki lebar minimal 480 piksel dan tinggi 270 piksel.
Pemutaran otomatis dan dengan skrip
Bagian ini membahas pemutaran otomatis. Kebijakan ini berlaku untuk pemutar sematan YouTube yang menggunakan parameter pemutar autoplay atau memulai pemutaran otomatis secara terprogram menggunakan layanan YouTube IFrame Player API atau layanan YouTube API lainnya.
-
Pemutar tersemat yang otomatis memutar video harus segera memulai pemutaran saat halaman dimuat atau segera setelah pemutar tersemat terlihat sepenuhnya. Namun, Klien API tidak boleh memulai pemutaran otomatis hingga pemutar terlihat dan lebih dari setengah pemutar terlihat di halaman atau layar.
-
Halaman atau layar tidak boleh memiliki lebih dari satu pemutar YouTube yang otomatis memutar konten secara bersamaan.
-
Thumbnail YouTube yang memulai pemutaran harus memiliki lebar minimal 120 piksel dan tinggi minimal 70 piksel.
Atribut Pemutar YouTube
Atribut dan parameter pemutar YouTube – termasuk, misalnya, tampilan branding YouTube di pemutar – ditentukan dalam dokumentasi dan spesifikasi YouTube API (https://developers.google.com/youtube). Anda tidak boleh membuat perubahan pada pemutar YouTube yang tidak dijelaskan secara eksplisit oleh dokumentasi API.
Overlay dan bingkai
Anda tidak boleh menampilkan overlay, bingkai, atau elemen visual lainnya di depan bagian mana pun dari pemutar sematan YouTube, termasuk kontrol pemutar. Demikian pula, Anda tidak boleh menggunakan overlay, bingkai, atau elemen visual lainnya untuk mengaburkan bagian apa pun dari pemutar tersemat, termasuk kontrol pemutar.
Arahan kursor
Anda tidak boleh menggunakan peristiwa mouseover atau sentuh di pemutar YouTube untuk memulai tindakan apa pun atas nama pengguna, seperti membuka jendela atau berlangganan channel.
Mengupload video
Jika Klien API mengizinkan pengguna mengupload konten ke beberapa platform, pengguna harus dapat memilih dan membatalkan pilihan platform tempat mereka ingin mengupload video.
Persyaratan data
Klien API yang memungkinkan pengguna mengupload video ke YouTube harus mengaktifkan pengguna untuk menetapkan nilai dalam daftar berikut. Setiap properti yang tidak tercantum bersifat opsional.
| Nama | Deskripsi | |
|---|---|---|
| Properti resource | ||
snippet.title |
Wajib diisi. Judul video. YouTube akan menampilkan error jika nilai melebihi 100 karakter. YouTube mendukung semua karakter UTF-8 yang valid, kecuali < dan >.
| |
snippet.description |
Wajib diisi. Deskripsi video. YouTube akan menampilkan error jika nilai melebihi 5.000 byte. YouTube mendukung semua karakter UTF-8 yang valid, kecuali < dan >. |
|
status.privacyStatus |
Wajib diisi. Setelan privasi video. Pengguna harus dapat memilih apakah video yang diupload akan bersifat publik, pribadi, atau tidak publik. | |
| Parameter permintaan | ||
onBehalfOfContentOwnerChannel |
Wajib bersyarat. Jika kredensial otorisasi permintaan mengidentifikasi pemilik konten dan parameter onBehalfOfContentOwner ditetapkan, pengguna API juga harus dapat menentukan channel YouTube tempat video diupload. |
|
Menampilkan komentar
| Nama | Deskripsi | |
|---|---|---|
| Properti resource | ||
snippet.textDisplay |
Wajib diisi. Teks komentar. Klien API harus (a) menampilkan teks lengkap komentar atau balasan komentar, atau (b) memotong teks dan memberikan cara bagi penonton untuk mengakses teks lengkap dengan mudah dari versi yang terpotong. Persyaratan ini berlaku untuk semua komentar dan balasan komentar, terlepas dari jenis resource yang terkait dengan komentar (video, channel, dll.). Perhatikan bahwa nilai properti snippet.topLevelComment resource commentThread adalah resource comment dan properti replies.comments[] adalah daftar resource comment. Dengan demikian, persyaratan ini juga berlaku untuk properti snippet.topLevelComment.snippet.textDisplay dan replies.comments[].snippet.textDisplay. |
|
snippet.title( channel) |
Wajib (saran). Judul channel.
|
|
snippet.title( video) |
Wajib bersyarat (saran). Judul video. Nilai ini harus ditampilkan jika komentar berkaitan dengan video. | |
snippet.moderationStatus |
Wajib bersyarat. Jika nilai parameter moderationStatus dalam permintaan API adalah heldForReview atau likelySpam, tampilan harus mengidentifikasi status tersebut dengan jelas menggunakan nilai properti, bahasa serupa (misalnya, "Komentar ini ditahan untuk ditinjau"), header (misalnya, "Ditahan untuk ditinjau"), atau bahasa lain yang tidak ambigu. Metode commentThreads.list mendukung kemampuan untuk mengambil komentar berdasarkan status moderasinya. |
|
Menambahkan komentar
| Nama | Deskripsi | |
|---|---|---|
| Properti resource | ||
snippet.title( channel) |
Wajib diisi. Judul channel.
|
|
snippet.title( video) |
Wajib diisi. Jika pengguna menambahkan komentar tentang video, klien API harus menampilkan judul video. | |
| Persyaratan lainnya | ||
Comment author's channel name |
Wajib diisi. Klien API harus mengidentifikasi dengan jelas akun pengguna YouTube yang akan diatribusikan komentarnya. Jika kredensial otorisasi permintaan mengidentifikasi pemilik konten dan parameter onBehalfOfContentOwner ditetapkan, pengguna API juga harus dapat menentukan channel YouTube tempat komentar akan diatribusikan. |
|
Menambahkan balasan komentar
| Nama | Deskripsi | |
|---|---|---|
| Properti resource | ||
snippet.textDisplay |
Wajib diisi. Teks komentar. Klien API harus menampilkan teks komentar yang dibalas pengguna sesuai dengan aturan yang ditentukan di bagian Menampilkan komentar dalam dokumen ini. | |
snippet.title( channel) |
Wajib diisi. Judul channel.
|
|
snippet.title( video) |
Wajib diisi. Jika pengguna membalas komentar tentang video, klien API harus menampilkan judul video. | |
| Persyaratan lainnya | ||
Comment author's channel name |
Wajib diisi. Klien API harus mengidentifikasi dengan jelas akun pengguna YouTube yang akan diatribusikan balasan komentar. Jika kredensial otorisasi permintaan mengidentifikasi pemilik konten dan parameter onBehalfOfContentOwner ditetapkan, pengguna API juga harus dapat menentukan channel YouTube tempat balasan komentar akan diatribusikan. |
|
Mengedit atau menghapus balasan komentar
| Nama | Deskripsi | |
|---|---|---|
| Properti resource | ||
snippet.textDisplay |
Wajib diisi. Teks komentar. Klien API harus menampilkan teks komentar yang sedang diedit atau dihapus oleh pengguna sesuai dengan aturan yang ditentukan di bagian Menampilkan komentar dalam dokumen ini. | |
snippet.title( channel) |
Wajib diisi. Judul channel.
|
|
snippet.title( video) |
Wajib diisi. Jika pengguna mengedit atau menghapus komentar tentang video, klien API harus menampilkan judul video. | |
| Persyaratan lainnya | ||
Comment author's channel name |
Wajib diisi. Klien API harus mengidentifikasi dengan jelas akun pengguna YouTube yang diatribusikan ke komentar. | |
Memblokir pengguna dari live chat (atau menghapus pemblokiran)
| Nama | Deskripsi | |
|---|---|---|
| Properti resource | ||
snippet.title( channel) |
Wajib diisi. Nama channel YouTube yang diblokir atau dihapus blokirnya. Selain itu, nama harus ditautkan ke channel atau URL channel juga harus ditampilkan. | |
| Persyaratan lainnya | ||
| Nama channel penulis komentar | Wajib diisi. Klien API harus mengidentifikasi dengan jelas akun pengguna YouTube yang digunakan untuk menambahkan atau menghapus larangan. | |