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.