Resource commentThread
berisi informasi tentang rangkaian komentar YouTube, yang terdiri atas komentar dan balasan tingkat atas, jika ada, terhadap komentar tersebut. Resource commentThread
dapat mewakili komentar tentang video atau channel.
Baik komentar tingkat atas maupun balasan sebenarnya adalah resource comment
yang 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. Perhatikan juga bahwa beberapa komentar tidak memiliki balasan.
Metode
API mendukung metode berikut untuk resource commentThreads
:
- list
- Menampilkan daftar thread komentar yang cocok dengan parameter permintaan API. Coba sekarang.
- masukkan
- Membuat komentar tingkat teratas yang baru. Untuk menambahkan balasan ke komentar yang sudah ada, gunakan metode
comments.insert
sebagai gantinya. Coba sekarang.
Representasi resource
Struktur JSON di bawah ini menunjukkan 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 menentukan properti yang muncul di resource ini:
Properti | |
---|---|
kind |
string Mengidentifikasi jenis resource API. Nilainya adalah 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 thread, yang merupakan resource comment . |
snippet.channelId |
string Channel YouTube yang terkait dengan komentar di rangkaian pesan. (Properti snippet.videoId mengidentifikasi video.)
|
snippet.videoId |
string ID video yang dirujuk oleh komentar, jika ada. Jika properti ini tidak ada atau tidak memiliki nilai, thread akan diterapkan ke channel, bukan ke video tertentu. |
snippet.topLevelComment |
object Komentar tingkat atas dari rangkaian pesan. Nilai properti adalah resource comment . |
snippet.canReply |
boolean Setelan ini menunjukkan apakah penonton saat ini dapat membalas rangkaian pesan. |
snippet.totalReplyCount |
unsigned integer Jumlah total balasan yang telah dikirim sebagai respons terhadap komentar tingkat atas. |
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 komentar, jika ada. Properti replies.comments mewakili daftar komentar itu sendiri. |
replies.comments[] |
list Daftar satu atau beberapa balasan untuk komentar tingkat atas. Setiap item dalam daftar adalah resource comment .Daftar berisi jumlah balasan yang terbatas, dan kecuali jumlah item dalam daftar sama dengan nilai properti snippet.totalReplyCount , daftar balasan hanya merupakan subset dari jumlah total balasan yang tersedia untuk komentar tingkat atas. Guna mengambil semua balasan untuk komentar tingkat atas, Anda harus memanggil metode comments.list dan menggunakan parameter permintaan parentId untuk mengidentifikasi komentar yang ingin Anda ambil balasannya. |