Comments

Resource comment berisi informasi tentang satu komentar YouTube. Aset comment dapat merepresentasikan komentar tentang video atau channel. Selain itu, komentar tersebut dapat berupa komentar teratas atau balasan atas komentar teratas.

Metode

API ini mendukung metode berikut untuk resource comments:

list
Menampilkan daftar komentar yang cocok dengan parameter permintaan API. Coba sekarang.
insert
Membuat balasan untuk komentar yang ada. Catatan: Untuk membuat komentar tingkat teratas, gunakan metode commentThreads.insert. Coba sekarang.
update
Mengubah komentar. Coba sekarang.
hapus
Menghapus komentar. Coba sekarang.
setModerationStatus
Menetapkan status moderasi satu atau beberapa komentar. Permintaan API harus diotorisasi oleh pemilik channel atau video yang terkait dengan komentar. Coba sekarang.

Representasi resource

Struktur JSON berikut menunjukkan format resource comments:

{
  "kind": "youtube#comment",
  "etag": etag,
  "id": string,
  "snippet": {
    "authorDisplayName": string,
    "authorProfileImageUrl": string,
    "authorChannelUrl": string,
    "authorChannelId": {
      "value": string
    },
    "channelId": string,
    "textDisplay": string,
    "textOriginal": string,
    "parentId": string,
    "canRate": boolean,
    "viewerRating": string,
    "likeCount": unsigned integer,
    "moderationStatus": string,
    "publishedAt": datetime,
    "updatedAt": datetime,
    "imageUrl": string
  }
}

Properti

Tabel berikut menentukan properti yang muncul di resource ini:

Properti
kind string
Mengidentifikasi jenis resource API. Nilainya adalah youtube#comment.
etag etag
ETag resource ini.
id string
ID yang digunakan YouTube untuk mengidentifikasi komentar secara unik.
snippet object
Objek snippet berisi detail dasar tentang komentar.
snippet.authorDisplayName string
Nama tampilan pengguna yang memposting komentar.
snippet.authorProfileImageUrl string
URL untuk avatar pengguna yang memposting komentar.
snippet.authorChannelUrl string
URL channel YouTube penulis komentar, jika tersedia.
snippet.authorChannelId object
Objek ini merangkum informasi tentang channel YouTube penulis komentar, jika tersedia.
snippet.authorChannelId.value string
ID channel YouTube penulis komentar, jika tersedia.
snippet.channelId string
ID channel YouTube yang terkait dengan komentar.
snippet.textDisplay string
Teks komentar. Teks dapat diambil dalam teks biasa atau HTML. (Metode comments.list dan commentThreads.list mendukung parameter textFormat, yang menentukan format teks yang dipilih.)

Bahkan teks biasa dapat berbeda dari teks komentar asli. Misalnya, link video dapat diganti dengan judul video.
snippet.textOriginal string
Teks asli dan mentah dari komentar saat pertama kali diposting atau terakhir diperbarui. Teks asli hanya ditampilkan kepada pengguna terautentikasi jika mereka adalah penulis komentar.
snippet.parentId string
ID unik komentar induk. Properti ini hanya disetel jika komentar dikirim sebagai balasan untuk komentar lain.
snippet.canRate boolean
Setelan ini menunjukkan apakah pelihat saat ini dapat memberi rating komentar.
snippet.viewerRating string
Rating yang diberikan penonton untuk komentar ini. Properti ini tidak mengidentifikasi rating dislike, meskipun perilaku ini dapat berubah. Sementara itu, nilai properti adalah like jika penonton telah memberi rating positif pada komentar. Nilainya adalah none dalam semua kasus lainnya, termasuk pengguna yang memberikan rating negatif pada komentar atau tidak memberikan rating pada komentar.

Nilai yang valid untuk properti ini adalah:
  • like
  • none
snippet.likeCount unsigned integer
Jumlah total suka (rating positif) yang diterima komentar.
snippet.moderationStatus string
Status moderasi komentar. Properti ini hanya ditampilkan jika permintaan API diizinkan oleh pemilik channel atau video tempat komentar yang diminta dibuat. Selain itu, properti ini tidak disetel jika permintaan API menggunakan parameter filter id.

Nilai yang valid untuk properti ini adalah:
  • heldForReview
  • likelySpam
  • published
  • rejected
snippet.publishedAt datetime
Tanggal dan waktu saat komentar pertama kali dipublikasikan. Nilai ditentukan dalam format ISO 8601.
snippet.updatedAt datetime
Tanggal dan waktu saat komentar terakhir diperbarui. Nilai ditentukan dalam format ISO 8601.
snippet.imageUrl string
URL gambar atau GIF animasi yang dilampirkan ke komentar, jika ada. Properti ini hanya ada jika komentar berisi gambar atau GIF. URL ditayangkan sebagai link bertanda tangan dengan waktu aktif (TTL) enam jam dan akan berakhir enam jam setelah pengambilan.