CommentThreads

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.