Catatan: Panduan Mematuhi Kebijakan Developer YouTube yang baru akan memberikan panduan dan contoh guna membantu Anda memastikan bahwa klien API Anda mematuhi bagian tertentu dari Persyaratan dan Kebijakan Layanan YouTube API (TOS API). Panduan ini menawarkan insight tentang cara YouTube menegakkan aspek TOS API tertentu, tetapi tidak menggantikan dokumen apa pun yang sudah ada.
Dokumen ini menjelaskan persyaratan fungsional minimum untuk klien API yang menerapkan atau menyediakan akses ke fitur tertentu dari layanan YouTube API ("Klien API").
Persyaratan dan pedoman ini memastikan bahwa klien API memberikan pengalaman pengguna yang konsisten, yang melindungi kepentingan pengguna YouTube, pemilik konten, dan pengiklan. Aturan ini merupakan bagian yang tidak terpisahkan dari Persyaratan Layanan YouTube API dan harus diikuti dalam pengembangan dan penerapan Klien API apa pun.
Persyaratan dalam dokumen ini akan berubah agar kami dapat memastikan pengalaman pengguna yang lebih baik dengan fitur YouTube yang ada. Iklan tersebut juga akan berubah sebagai respons terhadap fitur YouTube baru dan yang diperbarui. Terkadang, perubahan tersebut mungkin mengharuskan Anda memperbarui Klien API untuk memenuhi persyaratan baru. Histori revisi Persyaratan Layanan akan mendokumentasikan setiap perubahan, jadi periksa dokumen tersebut secara rutin, atau berlangganan feed RSS untuk memastikan Anda dapat dengan cepat mempelajari perubahan yang dapat memengaruhi Klien API.
Selain persyaratan dalam dokumen ini, kami sangat menyarankan Anda untuk mengikuti praktik terbaik yang dijelaskan dalam Kebijakan Layanan YouTube API dan dibahas di bagian lain dalam dokumentasi layanan YouTube API. Meskipun tidak diwajibkan secara ketat, praktik ini dapat membantu Klien API Anda untuk pulih dengan 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 kondisi ekosistem YouTube dan, terutama, untuk memberikan pengalaman terbaik kepada pengguna Klien API dan Aplikasi YouTube.
Pemutar tersemat dan pemutaran video YouTube
Persyaratan di bagian ini berkaitan 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 yang disematkan harus memiliki area pandang yang berukuran setidaknya 200 x 200 piksel. Jika pemutar menampilkan kontrol, kontrol tersebut 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.
Putar otomatis dan pemutaran dengan skrip
Bagian ini membahas pemutaran otomatis. Kebijakan ini berlaku untuk pemutar tersemat YouTube yang menggunakan parameter pemutar autoplay atau memulai pemutaran otomatis secara terprogram menggunakan layanan YouTube IFrame Player API, layanan YouTube Player Player API YouTube, atau layanan YouTube API lainnya.
-
Pemutar tersemat yang memutar video secara otomatis harus memulai pemutaran segera setelah 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 apa pun yang memulai pemutaran harus memiliki lebar minimal 120 piksel dan tinggi 70 piksel.
Atribut Pemutar YouTube
Atribut dan parameter pemutar YouTube – termasuk, misalnya, tampilan branding YouTube di pemutar – ditetapkan dalam dokumentasi dan spesifikasi YouTube API (https://developers.google.com/youtube). Anda tidak boleh melakukan perubahan pada pemutar YouTube yang tidak dijelaskan secara eksplisit oleh dokumentasi API.
Overlay dan frame
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 mana pun dari pemutar tersemat, termasuk kontrol pemutar.
Arahan kursor
Anda tidak boleh menggunakan pengarahan mouse atau peristiwa sentuh pada pemutar YouTube untuk memulai tindakan apa pun atas nama pengguna, seperti membuka jendela atau berlangganan saluran.
Mengupload video
Jika Klien API memungkinkan pengguna mengupload konten ke beberapa platform, pengguna harus dapat memilih dan membatalkan pilihan platform tempat mereka ingin mengupload video mereka.
Persyaratan data
Klien API yang memungkinkan pengguna mengupload video ke YouTube harus memungkinkan pengguna menetapkan nilai dalam daftar berikut. Semua properti yang tidak tercantum bersifat opsional.
| Nama | Deskripsi | |
|---|---|---|
| Properti resource | ||
snippet.title |
Wajib. Judul video. YouTube akan menampilkan error jika nilainya melebihi 100 karakter. YouTube mendukung semua karakter UTF-8 yang valid kecuali < dan >.
| |
snippet.description |
Wajib. Deskripsi video. YouTube akan menampilkan error jika nilainya melebihi 5.000 byte. YouTube mendukung semua karakter UTF-8 yang valid kecuali < dan >. |
|
status.privacyStatus |
Wajib. Setelan privasi video. Pengguna harus dapat memilih apakah video yang diupload akan disetel ke publik, pribadi, atau tidak publik. | |
| Parameter permintaan | ||
onBehalfOfContentOwnerChannel |
Wajib bersyarat. Jika kredensial otorisasi permintaan mengidentifikasi pemilik konten dan parameter onBehalfOfContentOwner disetel, pengguna API juga harus dapat menentukan channel YouTube tempat video diupload. |
|
Menampilkan komentar
| Nama | Deskripsi | |
|---|---|---|
| Properti resource | ||
snippet.textDisplay |
Wajib. Teks komentar. Klien API harus (a) menampilkan teks lengkap komentar atau balasan komentar, atau (b) memotong teks dan menyediakan cara bagi pengakses lihat-saja untuk mengakses teks lengkap dari versi yang terpotong dengan mudah. Persyaratan ini berlaku untuk semua komentar dan balasan komentar, terlepas dari jenis resource mana yang dikaitkan dengan komentar (video, channel, dll.). Perhatikan bahwa nilai properti snippet.topLevelComment resource commentThread adalah resource comment dan properti replies.comments[] Dengan demikian, persyaratan ini juga berlaku untuk properti snippet.topLevelComment.snippet.textDisplay dan replies.comments[].snippet.textDisplay. |
|
snippet.title( channel) |
Wajib (saran). Judul saluran.
|
|
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, layar harus mengidentifikasi status tersebut dengan jelas menggunakan nilai properti, bahasa yang mirip (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. Judul saluran.
|
|
snippet.title( video) |
Wajib. Jika pengguna menambahkan komentar tentang video, klien API harus menampilkan judul video tersebut. | |
| Persyaratan lain | ||
Comment author's channel name |
Wajib. Klien API harus secara jelas mengidentifikasi akun pengguna YouTube yang akan dikaitkan dengan komentar tersebut. Jika kredensial otorisasi permintaan mengidentifikasi pemilik konten dan parameter onBehalfOfContentOwner disetel, pengguna API juga harus dapat menentukan channel YouTube yang akan dikaitkan dengan komentar tersebut. |
|
Menambahkan balasan komentar
| Nama | Deskripsi | |
|---|---|---|
| Properti resource | ||
snippet.textDisplay |
Wajib. Teks komentar. Klien API harus menampilkan teks komentar yang dibalas pengguna sesuai dengan aturan yang ditetapkan di bagian Menampilkan komentar pada dokumen ini. | |
snippet.title( channel) |
Wajib. Judul saluran.
|
|
snippet.title( video) |
Wajib. Jika pengguna membalas komentar tentang video, klien API harus menampilkan judul video tersebut. | |
| Persyaratan lain | ||
Comment author's channel name |
Wajib. Klien API harus secara jelas mengidentifikasi akun pengguna YouTube yang akan diatribusikan ke balasan komentar. Jika kredensial otorisasi permintaan mengidentifikasi pemilik konten dan parameter onBehalfOfContentOwner ditetapkan, pengguna API juga harus dapat menentukan channel YouTube yang akan diatribusikan ke balasan komentar. |
|
Mengedit atau menghapus balasan komentar
| Nama | Deskripsi | |
|---|---|---|
| Properti resource | ||
snippet.textDisplay |
Wajib. Teks komentar. Klien API harus menampilkan teks komentar yang diedit atau dihapus pengguna sesuai dengan aturan yang ditetapkan di bagian Menampilkan komentar dalam dokumen ini. | |
snippet.title( channel) |
Wajib. Judul saluran.
|
|
snippet.title( video) |
Wajib. Jika pengguna mengedit atau menghapus komentar tentang video, klien API harus menampilkan judul video. | |
| Persyaratan lain | ||
Comment author's channel name |
Wajib. Klien API harus secara jelas mengidentifikasi akun pengguna YouTube yang dikaitkan dengan komentar tersebut. | |
Memblokir pengguna dari live chat (atau menghapus pemblokiran)
| Nama | Deskripsi | |
|---|---|---|
| Properti resource | ||
snippet.title( channel) |
Wajib. Nama channel YouTube yang sedang diblokir atau tidak diblokir. Selain itu, nama harus ditautkan ke channel atau URL channel juga harus ditampilkan. | |
| Persyaratan lain | ||
| Nama channel penulis komentar | Wajib. Klien API harus secara jelas mengidentifikasi akun pengguna YouTube yang digunakan untuk menambahkan atau menghapus pemblokiran. | |