CommentThreads

Referensi commentThread berisi informasi tentang rangkaian komentar YouTube, yang terdiri dari komentar dan balasan tingkat atas, jika ada, untuk komentar tersebut. Resource commentThread mewakili komentar pada video.

Komentar tingkat atas dan balasan sebenarnya merupakan comment referensi yang disusun bertingkat dalam resource commentThread. Resource commentThread tidak harus 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 yang baru. Untuk menambahkan balasan ke komentar yang sudah 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 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. 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. 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 dikirimkan sebagai tanggapan atas komentar tingkat atas.
snippet.isPublic boolean
Setelan ini menunjukkan apakah rangkaian pesan, termasuk semua komentar dan balasan komentarnya, dapat dilihat oleh semua pengguna YouTube.
replies object
Objek replies adalah penampung yang berisi daftar balasan untuk 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 sumber comment.

Daftar ini berisi jumlah balasan 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 atas, Anda harus memanggil metode comments.list dan menggunakan parameter permintaan parentId untuk mengidentifikasi komentar yang balasannya ingin Anda ambil.