Halaman ini diterjemahkan oleh Cloud Translation API.

Comments

Resource comment berisi informasi tentang satu komentar YouTube. Resource comment dapat mewakili komentar tentang video atau channel. Selain itu, komentar tersebut dapat berupa komentar tingkat atas 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 teratas, gunakan metode commentThreads.insert. Coba sekarang.
pembaruan: Memodifikasi komentar. Coba sekarang.
hapus: Menghapus komentar. Coba sekarang.
setModerationStatus: Menetapkan status moderasi untuk satu atau beberapa komentar. Permintaan API harus mendapatkan izin dari pemilik channel atau video yang terkait dengan komentar tersebut. Coba sekarang.
markAsSpam: Catatan: Metode ini tidak digunakan lagi dan tidak lagi didukung.; Menyatakan pendapat penelepon bahwa satu atau beberapa komentar harus ditandai sebagai spam.

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,
    "videoId": string,
    "textDisplay": string,
    "textOriginal": string,
    "parentId": string,
    "canRate": boolean,
    "viewerRating": string,
    "likeCount": unsigned integer,
    "moderationStatus": string,
    "publishedAt": datetime,
    "updatedAt": datetime
  }
}

Properti

Tabel berikut menentukan properti yang muncul di resource ini:

Properti
`kind`	`string` Mengidentifikasi jenis resource API. Nilainya akan berupa `youtube#comment`.
`etag`	`etag` Etag referensi 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. Jika komentar tersebut adalah komentar video, properti ini akan mengidentifikasi channel video, dan properti `snippet.videoId` akan mengidentifikasi video tersebut. Jika komentar tersebut adalah komentar channel, properti ini mengidentifikasi channel yang memuat komentar tersebut.
`snippet.videoId`	`string` ID video yang dirujuk dalam komentar. Properti ini hanya ada jika komentar dibuat pada video.
`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 diinginkan.) Perhatikan bahwa teks biasa dapat berbeda dengan teks komentar asli. Sebagai contoh, alat ini dapat mengganti link video dengan judul video.
`snippet.textOriginal`	`string` Teks asli dan mentah dari komentar seperti pertama kali diposting atau terakhir diperbarui. Teks asli hanya ditampilkan jika dapat diakses oleh pengguna terautentikasi, yang hanya dijamin jika pengguna tersebut adalah penulis komentar.
`snippet.parentId`	`string` ID unik komentar induk. Properti ini hanya ditetapkan jika komentar dikirim sebagai balasan untuk komentar lain.
`snippet.canRate`	`boolean` Setelan ini menunjukkan apakah pelihat saat ini dapat memberikan rating pada komentar.
`snippet.viewerRating`	`string` Rating yang diberikan penonton untuk komentar ini. Perhatikan bahwa properti ini saat ini tidak mengidentifikasi rating `dislike`, meskipun perilaku ini dapat berubah. Sementara itu, nilai properti adalah `like` jika penonton memberi rating komentar secara positif. Nilainya adalah `none` dalam semua kasus lainnya, termasuk pengguna yang telah 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 diberi otorisasi oleh pemilik channel atau video yang berisi komentar yang diminta. Selain itu, perhatikan bahwa 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 reguler. Nilai ini ditentukan dalam format ISO 8601.
`snippet.updatedAt`	`datetime` Tanggal dan waktu komentar terakhir diperbarui. Nilai ini ditentukan dalam format ISO 8601.