Referensi commentThread
berisi informasi tentang rangkaian komentar YouTube, yang terdiri dari komentar dan balasan tingkat atas, jika ada, pada komentar tersebut. Resource commentThread
mewakili komentar pada video.
Komentar tingkat atas dan balasan sebenarnya merupakan resource comment
yang disusun bertingkat di dalam resource commentThread
. Resource commentThread
tidak selalu berisi semua balasan untuk komentar, dan Anda harus menggunakan metode comments.list
jika ingin mengambil semua balasan untuk komentar tertentu. Beberapa komentar tidak memiliki balasan.
Metode
API ini mendukung metode berikut untuk resource commentThreads
:
- list
- Menampilkan daftar rangkaian komentar yang cocok dengan parameter permintaan API. Coba sekarang.
- sisipkan
- Membuat komentar tingkat atas baru. Untuk menambahkan balasan ke komentar yang ada, gunakan metode
comments.insert
. Coba sekarang.
Representasi resource
Struktur JSON menampilkan format resource commentThreads
:
{ "kind": "youtube#commentThread", "etag": etag, "id": string, "snippet": { "channelId": string, "videoId": string, "topLevelComment": comments Resource, "canReply": boolean, "totalReplyCount": unsigned integer, "isPublic": boolean }, "replies": { "comments": [ comments Resource ] } }
Properti
Tabel berikut mendefinisikan properti yang muncul di resource ini:
Properti | |
---|---|
kind |
string Mengidentifikasi jenis resource API. Nilainya akan berupa youtube#commentThread . |
etag |
etag Etag resource ini. |
id |
string ID yang digunakan YouTube untuk mengidentifikasi rangkaian komentar secara unik. |
snippet |
object Objek snippet berisi detail dasar tentang rangkaian komentar. File ini juga berisi komentar tingkat atas rangkaian pesan, yang merupakan resource comment . |
snippet.channelId |
string Channel YouTube yang terkait dengan komentar dalam rangkaian pesan. Properti snippet.videoId mengidentifikasi video. |
snippet.videoId |
string ID video yang dirujuk oleh komentar. |
snippet.topLevelComment |
object Komentar tingkat teratas rangkaian pesan ini. Nilai properti adalah resource comment . |
snippet.canReply |
boolean Setelan ini menunjukkan apakah pelihat saat ini dapat membalas rangkaian pesan. |
snippet.totalReplyCount |
unsigned integer Jumlah total balasan yang telah dikirim sebagai respons terhadap komentar tingkat teratas. |
snippet.isPublic |
boolean Setelan ini menunjukkan apakah rangkaian pesan, termasuk semua komentar dan balasan komentar, dapat dilihat oleh semua pengguna YouTube. |
replies |
object Objek replies adalah penampung yang berisi daftar balasan atas komentar, jika ada. Properti replies.comments merepresentasikan daftar komentar itu sendiri. |
replies.comments[] |
list Daftar satu atau beberapa balasan untuk komentar tingkat teratas. Setiap item dalam daftar adalah resource comment .Daftar ini berisi jumlah balasan yang terbatas, dan kecuali jika jumlah item dalam daftar sama dengan nilai properti snippet.totalReplyCount , daftar balasan hanyalah sebagian dari jumlah total balasan yang tersedia untuk komentar tingkat atas. Untuk mengambil semua balasan untuk komentar tingkat teratas, Anda harus memanggil metode comments.list dan menggunakan parameter permintaan parentId untuk mengidentifikasi komentar yang balasannya ingin Anda ambil. |