LiveChatMessages: insert

Menambahkan pesan ke live chat. API tersebut saat ini hanya mendukung kemampuan untuk menyisipkan pesan teks.

Kasus penggunaan umum

Permintaan

Permintaan HTTP

POST https://www.googleapis.com/youtube/v3/liveChat/messages

Otorisasi

Permintaan ini memerlukan otorisasi dengan setidaknya salah satu cakupan berikut (baca selengkapnya tentang autentikasi dan otorisasi).

Cakupan
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Parameter

Tabel berikut mencantumkan parameter yang didukung kueri ini. Semua parameter yang tercantum adalah parameter kueri.

Parameter
Parameter yang diperlukan
part string
Parameter part memiliki dua tujuan. Kode ini mengidentifikasi properti yang akan ditetapkan operasi tulis serta properti yang akan disertakan oleh respons API. Setel nilai parameter ke snippet.

Isi permintaan

Sediakan resource liveChatMessage dalam isi permintaan. Untuk resource tersebut:

  • Anda harus menentukan nilai untuk properti ini:

    • snippet.liveChatId
    • snippet.type: Saat ini, satu-satunya nilai yang didukung adalah textMessageEvent.
    • snippet.textMessageDetails.messageText

Respons

Jika berhasil, metode ini akan menampilkan resource liveChatMessage dalam isi respons.

Error

Tabel berikut mengidentifikasi pesan error yang dapat ditampilkan API sebagai respons terhadap panggilan ke metode ini. Lihat dokumentasi pesan error untuk detail selengkapnya.

Jenis error Detail error Deskripsi
forbidden (403) forbidden Anda tidak memiliki izin yang diperlukan untuk membuat pesan yang ditentukan.
forbidden (403) liveChatDisabled Live chat yang ditentukan telah dinonaktifkan oleh pemilik, yang berarti pesan tidak dapat ditambahkan ke chat.
forbidden (403) liveChatEnded Live chat yang ditentukan tidak aktif lagi.
invalidValue (400) messageTextInvalid Teks pesan (snippet.textMessageDetails.messageText) tidak valid.
notFound (404) liveChatNotFound Live chat yang diidentifikasi dalam permintaan API tidak ada. Error ini terjadi jika chat telah dihapus oleh pemilik.
rateLimitExceeded rateLimitExceeded Pengguna telah memposting terlalu banyak pesan chat dalam jangka waktu yang ditentukan.
required (400) liveChatIdRequired Resource liveChatMessage harus menyertakan dan menentukan nilai untuk properti snippet.liveChatId.
required (400) messageTextRequired Resource liveChatMessage harus menyertakan dan menentukan nilai untuk properti snippet.textMessageDetails.messageText.
required (400) typeRequired Resource liveChatMessage harus menyertakan dan menentukan nilai untuk properti snippet.type. Tetapkan nilai parameter ke text

Cobalah!

Gunakan APIs Explorer untuk memanggil API ini dan melihat permintaan dan respons API.