CommentThreads

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.)
  • Jika komentar berkaitan dengan video, maka nilai tersebut mengidentifikasi channel yang mengupload video. (Properti snippet.videoId mengidentifikasi video.)
  • Jika komentar merujuk ke channel itu sendiri, properti snippet.videoId tidak akan memiliki nilai.
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.