Comments

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

Metode

API ini mendukung metode berikut untuk resource comments:

list

Menampilkan daftar komentar yang cocok dengan parameter permintaan API. Coba sekarang.

sisipkan

Membuat balasan untuk komentar yang ada. Catatan: Untuk membuat komentar tingkat atas, gunakan metode commentThreads.insert. Coba sekarang.

perbarui

Memodifikasi komentar. Coba sekarang.

hapus

Menghapus komentar. Coba sekarang.

setModerationStatus

Menetapkan status moderasi untuk satu atau beberapa komentar. Permintaan API harus diizinkan oleh pemilik channel atau video yang terkait dengan komentar. Coba sekarang.

markAsSpam

Catatan: Metode ini tidak digunakan lagi dan tidak lagi didukung.

Menyampaikan pendapat penelepon bahwa satu atau beberapa komentar harus ditandai sebagai spam.

Representasi resource

Struktur JSON berikut menampilkan 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
  }
}

Properti

Tabel berikut mendefinisikan properti yang muncul di resource ini:

Properti
kind	string Mengidentifikasi jenis resource API. Nilainya akan berupa 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 ada.
snippet.authorChannelId	object Objek ini merangkum informasi tentang channel YouTube penulis komentar, jika tersedia.
snippet.authorChannelId.value	string ID channel YouTube penulis komentar, jika ada.
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 mungkin berbeda dari teks komentar asli. Misalnya, link video dapat diganti dengan judul video.
snippet.textOriginal	string Teks asli dan mentah dari komentar seperti pertama kali diposting atau terakhir diperbarui. Teks asli hanya ditampilkan kepada pengguna yang diautentikasi 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 penonton saat ini dapat memberikan rating pada 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 pada komentar secara positif. Nilainya adalah none pada semua kasus lainnya, termasuk pengguna yang telah memberi rating negatif pada komentar atau tidak memberi 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 telah diberi otorisasi oleh pemilik channel atau video yang berisi komentar yang diminta. Selain itu, properti ini tidak ditetapkan jika permintaan API menggunakan parameter filter id. Nilai yang valid untuk properti ini adalah: heldForReview likelySpam published rejected
snippet.publishedAt	datetime Tanggal dan waktu komentar dipublikasikan secara formal. Nilai ditentukan dalam format ISO 8601.
snippet.updatedAt	datetime Tanggal dan waktu komentar terakhir diperbarui. Nilai ditentukan dalam format ISO 8601.