Method: comments.list

Mencantumkan komentar file.

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 atau tidak. 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 'ModifyTime' untuk komentar hasil (RFC 3339 date-time).

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 tambahan hasil harus diambil.

nextPageToken

string

Token halaman untuk halaman komentar berikutnya. Fitur ini tidak akan tersedia 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 valid selama beberapa jam. Namun, jika item baru ditambahkan atau dihapus, hasil yang Anda harapkan 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.readonly

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