Implementasi: Komentar

Metode comments.markAsSpam tidak lagi didukung.

Contoh berikut menunjukkan cara menggunakan YouTube Data API (v3) untuk menjalankan fungsi terkait komentar.

Mengambil komentar untuk video

Untuk mengambil daftar rangkaian komentar untuk video, panggil metode commentThreads.list. Tetapkan nilai parameter berikut dalam permintaan Anda:

  • part: Tetapkan nilai parameter ke snippet jika Anda hanya ingin mengambil komentar tingkat atas atau ke snippet,replies jika Anda juga ingin mengambil balasan ke komentar tingkat atas. (Perhatikan bahwa resource commentThread tidak selalu berisi semua balasan ke komentar, dan Anda harus menggunakan metode comments.list jika ingin mengambil semua balasan untuk komentar tertentu.)

  • videoId: Tentukan ID video YouTube dari video yang komentarnya Anda ambil.

Permintaan di bawah mengambil komentar dan balasan komentar terkait video pidato utama di konferensi Google I/O 2014, yang memiliki ID video wtLJPvx7-ys.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.commentThreads.list?
part=snippet,replies
&videoId=wtLJPvx7-ys

Mengambil komentar tentang atau terkait dengan channel

API mendukung kemampuan untuk mengambil rangkaian komentar tentang channel atau mengambil semua rangkaian komentar yang terkait dengan channel. Dalam kasus terakhir, API dapat berisi komentar tentang channel atau tentang video channel mana pun.

Permintaan di bawah mengambil semua rangkaian komentar yang terkait dengan channel YouTube GoogleDevelopers:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.commentThreads.list?
part=snippet,replies
&allThreadsRelatedToChannelId=UC_x5XG1OV2P6uZZ5FSM9Ttw

Menambahkan komentar

Panggil metode commentThreads.insert untuk menambahkan komentar tingkat atas baru ke channel atau video. Tetapkan nilai parameter part permintaan ke snippet. Isi permintaan adalah commentThread resource yang properti snippet.topLevelComment[].snippet[].textOriginal-nya berisi teks komentar. Permintaan ini harus diotorisasi menggunakan OAuth 2.0.

  • Untuk menambahkan komentar ke channel, gunakan properti snippet.channelId untuk mengidentifikasi channel.
  • Untuk menambahkan komentar ke video, gunakan properti snippet.channelId untuk mengidentifikasi channel yang mengupload video. Gunakan juga properti snippet.videoId untuk mengidentifikasi video.

Contoh permintaan berikut menambahkan komentar ke video.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.commentThreads.insert?
part=snippet

Permintaan ini menyisipkan resource yang ditampilkan di bawah.

{
 "snippet": {
  "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
  "topLevelComment": {
   "snippet": {
    "textOriginal": "This video is awesome!"
   }
  },
  "videoId": "MILSirUni5E"
 }
}

Membalas komentar

Panggil metode comments.insert untuk membalas komentar. Tetapkan nilai parameter part permintaan ke snippet. Isi permintaan adalah comment resource yang properti snippet.textOriginal-nya berisi teks komentar. Properti snippet.parentId mengidentifikasi komentar yang terkait dengan balasan, dan nilainya adalah commentThread resource's ID. Permintaan ini harus diotorisasi menggunakan OAuth 2.0.

Contoh permintaan berikut menambahkan balasan ke komentar yang ada.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.comments.insert?
part=snippet

Permintaan ini menyisipkan resource yang ditampilkan di bawah. Untuk menjalankan permintaan di APIs Explorer, gunakan nilai properti snippet.parentId untuk mengidentifikasi komentar tingkat atas yang terkait dengan balasan. Dalam resource commentThread, properti snippet.topLevelComment[].id menentukan ID unik resource.

{
  "snippet": {
    "parentId": "COMMENT_THREAD_ID",
    "textOriginal": "That is true."
  }
}

Memperbarui komentar tingkat atas atau balasan komentar

Untuk memperbarui teks komentar tingkat atas atau balasan ke komentar tingkat atas, panggil metode comments.update. Tetapkan nilai parameter part ke snippet. Di isi permintaan, properti id mengidentifikasi komentar yang Anda ubah dan teks komentar baru.

  • Dalam resource commentThread, yang mengidentifikasi komentar tingkat atas, properti snippet.topLevelComment[].id menentukan ID unik komentar.
  • Dalam resource comment, yang dapat mengidentifikasi komentar tingkat atas atau balasan ke komentar, properti id menentukan ID unik komentar.

Contoh permintaan di bawah memperbarui teks komentar yang ada.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.comments.update?
part=snippet

Isi permintaan berisi cuplikan JSON yang ditampilkan di bawah. Untuk menjalankan permintaan di APIs Explorer, tetapkan nilai properti id untuk mengidentifikasi komentar yang Anda perbarui. Permintaan harus diotorisasi oleh penulis komentar.

{
  "id": "COMMENT_ID",
  "snippet": {
    "textOriginal": "That is true."
  }
}

Menetapkan status moderasi komentar

Untuk menetapkan status moderasi komentar, panggil metode comments.setModerationStatus. Tindakan ini digunakan saat pemilik channel memoderasi komentar di channel atau video channel.

Saat memanggil metode ini, tetapkan nilai parameter id untuk mengidentifikasi komentar. Tetapkan juga parameter moderationStatus ke status yang diinginkan. Status komentar hanya dapat disesuaikan oleh pemilik channel tempat komentar muncul.

  • Langkah 1: Ambil komentar yang ditahan untuk ditinjau

    Panggil metode commentThreads.list untuk mengambil komentar untuk channel atau video. Tetapkan nilai parameter moderationStatus ke heldForReview. Respons API dapat digunakan untuk menampilkan daftar komentar dengan opsi bagi pemilik channel untuk memublikasikan atau menolak setiap komentar.

  • Langkah 2: Perbarui status moderasi komentar

    Panggil metode comments.setModerationStatus untuk memperbarui status komentar. Gunakan nilai parameter id untuk menentukan ID unik komentar. Tetapkan parameter moderationStatus ke published atau rejected. Jika menolak komentar, Anda juga dapat menetapkan parameter banAuthor ke true untuk mencegah penulis membuat komentar tambahan di channel atau video.

Catatan: API tidak menyediakan cara untuk mencantumkan atau menemukan komentar yang ditolak. Namun, Anda masih dapat mengubah status moderasi komentar yang ditolak menjadi published jika ID unik komentar diketahui. Selain itu, setelah status moderasi komentar diperbarui menjadi published atau rejected, status moderasi tidak dapat diubah kembali menjadi heldForReview.

Menghapus komentar

Contoh ini menunjukkan cara menghapus komentar. Contoh ini memiliki langkah-langkah berikut:

  • Langkah 1: Ambil ID komentar

    Ikuti langkah-langkah di atas untuk mengambil daftar komentar untuk video atau channel. Ingatlah bahwa komentar hanya dapat dihapus oleh penulisnya, jadi Anda harus membandingkan nilai properti snippet.authorChannelId.value resource comment dengan ID channel pengguna yang diautentikasi untuk menentukan apakah pengguna dapat menghapus komentar tertentu tersebut.

  • Langkah 2: Hapus komentar atau rangkaian komentar

    Setelah mengidentifikasi ID rangkaian komentar atau komentar yang Anda hapus, panggil metode comments.delete untuk menghapus komentar tersebut. Gunakan nilai parameter id untuk mengidentifikasi ID komentar atau ID rangkaian komentar yang Anda hapus. Permintaan harus diotorisasi menggunakan OAuth 2.0. Jika Anda menguji kueri ini di APIs Explorer, Anda harus mengganti ID komentar atau ID rangkaian komentar yang valid untuk nilai parameter id dalam permintaan di bawah.

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.comments.delete?
id=COMMENT_ID