Method: comments.list

Mencantumkan komentar file. Untuk informasi selengkapnya, lihat Mengelola komentar dan balasan.

Wajib: Parameter fields harus ditetapkan. Untuk menampilkan kolom yang tepat yang Anda perlukan, lihat Menampilkan kolom tertentu.

Permintaan HTTP

GET https://www.googleapis.com/drive/v3/files/{fileId}/comments

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
fileId

string

ID file.

Parameter kueri

Parameter
includeDeleted

boolean

Apakah akan menyertakan komentar yang dihapus. Komentar yang dihapus tidak akan menyertakan konten aslinya.
pageSize

integer

Jumlah maksimum komentar yang akan ditampilkan per halaman.
pageToken

string

Token untuk melanjutkan permintaan daftar sebelumnya di halaman berikutnya. Nilai ini harus ditetapkan ke nilai 'nextPageToken' dari respons sebelumnya.
startModifiedTime

string

Nilai minimum 'modifiedTime' untuk komentar hasil (waktu tanggal RFC 3339).

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Daftar komentar pada file.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "kind": string,
  "comments": [
    {
      object (Comment)
    }
  ],
  "nextPageToken": string
}
Kolom
kind

string

Mengidentifikasi jenis resource ini. Nilai: string tetap "drive#commentList".
comments[]

object (Comment)

Daftar komentar. Jika nextPageToken diisi, daftar ini mungkin tidak lengkap dan halaman hasil tambahan harus diambil.
nextPageToken

string

Token halaman untuk halaman komentar berikutnya. Ini tidak akan ada jika akhir daftar komentar telah tercapai. Jika ditolak karena alasan apa pun, token harus dihapus, dan penomoran halaman harus dimulai ulang dari halaman pertama hasil. Token halaman biasanya berlaku selama beberapa jam. Namun, jika item baru ditambahkan atau dihapus, hasil yang diharapkan mungkin berbeda.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.readonly

Beberapa cakupan dibatasi dan memerlukan penilaian keamanan agar aplikasi Anda dapat menggunakannya. Untuk informasi selengkapnya, lihat Panduan otorisasi.