Referensi API

Referensi API ini menjelaskan cara menjadwalkan live streaming dan streaming video di YouTube menggunakan YouTube Live Streaming API.

Jenis resource

LiveBroadcasts

Referensi liveBroadcast mewakili acara yang akan di-streaming, melalui video live, di YouTube.

Untuk mengetahui informasi selengkapnya tentang resource ini, lihat representasi resource dan daftar properti-nya.

Metode Permintaan HTTP Deskripsi
URI yang relatif terhadap https://www.googleapis.com/youtube/v3
bind POST /liveBroadcasts/bind Mengikat siaran YouTube ke streaming atau menghapus binding yang ada antara siaran dan streaming. Siaran hanya dapat dikaitkan dengan satu streaming video, meskipun streaming video mungkin terikat dengan lebih dari satu siaran.
delete DELETE /liveBroadcasts Menghapus siaran.
insert POST /liveBroadcasts Membuat siaran.
list GET /liveBroadcasts Menampilkan daftar siaran YouTube yang cocok dengan parameter permintaan API.
transition POST /liveBroadcasts/transition Mengubah status live streaming YouTube dan memulai proses apa pun yang berkaitan dengan status baru tersebut. Misalnya, saat Anda mentransisikan status siaran ke testing, YouTube akan mulai mentransmisikan video ke streaming monitor siaran tersebut. Sebelum memanggil metode ini, sebaiknya konfirmasi bahwa nilai properti status.streamStatus untuk streaming yang terikat ke siaran Anda adalah active.
update PUT /liveBroadcasts Memperbarui siaran. Misalnya, Anda dapat mengubah setelan siaran yang ditentukan dalam objek contentDetails resource liveBroadcast.
cuepoint POST /liveBroadcasts/cuepoint Menyisipkan titik tanda ke live streaming. Titik tanda dapat memicu jeda iklan.

LiveChatBans

Referensi liveChatBan mengidentifikasi pengguna YouTube dan live chat YouTube yang dilarang berpartisipasi untuknya.

Untuk mengetahui informasi selengkapnya tentang resource ini, lihat representasi resource dan daftar properti-nya.

Metode Permintaan HTTP Deskripsi
URI yang relatif terhadap https://www.googleapis.com/youtube/v3
delete DELETE /liveChat/bans Menghapus pemblokiran yang mencegah pengguna tertentu berkontribusi ke live chat, sehingga memungkinkan pengguna bergabung kembali ke chat. Permintaan API harus diizinkan oleh pemilik channel atau moderator live chat yang terkait dengan pemblokiran.
insert POST /liveChat/bans Memblokir pengguna tertentu untuk berpartisipasi dalam live chat. Permintaan API harus diizinkan oleh pemilik channel atau moderator live chat yang terkait dengan pemblokiran.

LiveChatMessages

Referensi liveChatMessage merepresentasikan pesan chat dalam live chat YouTube. Resource ini dapat berisi detail tentang beberapa jenis pesan, termasuk pesan teks yang baru diposting atau acara fan funding.

Fitur live chat diaktifkan secara default untuk live streaming dan tersedia selama live streaming berlangsung. (Setelah acara berakhir, live chat tidak lagi tersedia untuk acara tersebut.)

Untuk mengetahui informasi selengkapnya tentang resource ini, lihat representasi resource dan daftar properti-nya.

Metode Permintaan HTTP Deskripsi
URI yang relatif terhadap https://www.googleapis.com/youtube/v3
delete DELETE /liveChat/messages Menghapus pesan chat. Permintaan API harus diizinkan oleh pemilik channel atau moderator live chat yang terkait dengan pemblokiran.
insert POST /liveChat/messages Menambahkan pesan ke live chat.
list GET /liveChat/messages Mencantumkan pesan live chat untuk chat tertentu.

LiveChatModerators

Referensi liveChatModerator mewakili moderator untuk live chat YouTube. Moderator chat memiliki kemampuan untuk memblokir atau membatalkan pemblokiran pengguna dari chat, menghapus pesan, dan melakukan tindakan administratif lainnya untuk live chat.

Untuk mengetahui informasi selengkapnya tentang resource ini, lihat representasi resource dan daftar properti-nya.

Metode Permintaan HTTP Deskripsi
URI yang relatif terhadap https://www.googleapis.com/youtube/v3
delete DELETE /liveChat/moderators Menghapus moderator chat. Permintaan harus diizinkan oleh pemilik channel live streaming.
insert POST /liveChat/moderators Menambahkan moderator baru untuk chat. Permintaan harus diizinkan oleh pemilik channel live streaming.
list GET /liveChat/moderators Menampilkan daftar moderator untuk live chat. Permintaan harus diizinkan oleh pemilik channel live streaming.

LiveStreams

Resource liveStream berisi informasi tentang streaming video yang Anda transmisikan ke YouTube. Streaming menyediakan konten yang akan disiarkan kepada pengguna YouTube. Setelah dibuat, resource liveStream dapat diikat ke satu atau beberapa resource liveBroadcast.

Untuk mengetahui informasi selengkapnya tentang resource ini, lihat representasi resource dan daftar properti-nya.

Metode Permintaan HTTP Deskripsi
URI yang relatif terhadap https://www.googleapis.com/youtube/v3
delete DELETE /liveStreams Menghapus streaming video.
insert POST /liveStreams Membuat streaming video. Streaming memungkinkan Anda mengirimkan video ke YouTube, yang kemudian dapat menyiarkan video tersebut kepada audiens.
list GET /liveStreams Menampilkan daftar streaming video yang cocok dengan parameter permintaan API.
update PUT /liveStreams Memperbarui streaming video. Jika properti yang ingin diubah tidak dapat diperbarui, Anda harus membuat aliran data baru dengan setelan yang tepat.

SuperChatEvents

Referensi superChatEvent merepresentasikan pesan Super Chat yang dibeli oleh penggemar selama live stream YouTube. Dalam streaming live chat YouTube, Super Chat berbeda dari pesan lainnya dalam dua hal:

  • Super Chat ditandai dengan warna.
  • Super Chat terus disematkan di ticker dalam jangka waktu tertentu.

Warna Super Chat, jangka waktu penyematan di ticker, dan panjang pesan maksimum ditentukan oleh jumlah pembelian. Lihat Pusat Bantuan YouTube untuk mempelajari Super Chat lebih lanjut.

Untuk mengetahui informasi selengkapnya tentang resource ini, lihat representasi resource dan daftar properti-nya.

Metode Permintaan HTTP Deskripsi
URI yang relatif terhadap https://www.googleapis.com/youtube/v3
list GET /superChatEvents Mencantumkan peristiwa Super Chat dari live stream channel dalam 30 hari sebelumnya.

Jenis resource yang tidak digunakan lagi

FanFundingEvents

Referensi fanFundingEvent merepresentasikan acara Fan Funding di channel YouTube. Fan Funding memberikan cara untuk mendukung para kreator YouTube secara finansial. Acara Fan Funding terjadi ketika pengguna melakukan pembayaran sukarela satu kali ke channel. Buka Pusat Bantuan YouTube untuk mempelajari lebih lanjut Fan Funding.

Untuk mengetahui informasi selengkapnya tentang resource ini, lihat representasi resource dan daftar properti-nya.

Metode Permintaan HTTP Deskripsi
URI yang relatif terhadap https://www.googleapis.com/youtube/v3
list GET /fanFundingEvents Mencantumkan acara fan funding untuk channel. Permintaan API harus diotorisasi oleh pemilik channel.

LiveCuepoints

Resource liveCuepoint memulai jeda iklan di streaming video siaran.

Catatan: Perintah API untuk mengontrol titik tanda sebenarnya merupakan bagian dari YouTube Content ID API dan memiliki persyaratan otorisasi yang berbeda dengan permintaan untuk mengelola resource liveBroadcast dan liveStream.

Untuk mengetahui informasi selengkapnya tentang resource ini, lihat representasi resource dan daftar properti-nya.

Metode Permintaan HTTP Deskripsi
URI yang relatif terhadap https://www.googleapis.com/
insert POST /liveCuepoints Menyisipkan titik tanda ke live streaming. Saat ini, permintaan untuk metode ini harus diizinkan oleh akun yang terkait dengan Pemilik Konten YouTube.

Sponsor

Resource sponsor mewakili sponsor untuk channel YouTube. Sponsor memberikan dukungan moneter berulang, seperti biaya langganan atau keanggotaan, kepada kreator dan menerima manfaat khusus. Misalnya, sponsor dapat melakukan chat saat kreator mengaktifkan mode khusus sponsor untuk chat.

Untuk mengetahui informasi selengkapnya tentang resource ini, lihat representasi resource dan daftar properti-nya.

Metode Permintaan HTTP Deskripsi
URI yang relatif terhadap https://www.googleapis.com/youtube/v3
list GET /sponsors Mencantumkan sponsor untuk channel. Permintaan API harus diotorisasi oleh pemilik channel.