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. Komentar yang dihapus tidak akan menyertakan konten aslinya.
pageSize

integer

Jumlah maksimum komentar untuk ditampilkan per halaman.
pageToken

string

Token untuk melanjutkan permintaan daftar sebelumnya di halaman berikutnya. Ini harus disetel ke nilai 'nextPageToken' dari respons sebelumnya.
startModifiedTime

string

Nilai minimum 'ModifiedTime' untuk komentar hasil (tanggal-waktu 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. Pesan ini tidak akan ditampilkan jika daftar komentar telah mencapai akhir. 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 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.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.