Method: comments.list

Dosyadaki yorumları listeler.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
fileId

string

Dosyanın kimliği.

Sorgu parametreleri

Parametreler
includeDeleted

boolean

Silinen yorumların dahil edilip edilmeyeceğini belirler. Silinen yorumlara özgün içerik dahil edilmez.

pageSize

integer

Sayfa başına döndürülecek maksimum yorum sayısı.

pageToken

string

Sonraki sayfada önceki bir liste isteğini devam ettirmek için kullanılan jeton. Bu, "nextPageToken" değerine ayarlanmalıdır. bu soruyu yanıtlar:

startModifiedTime

string

Minimum "modifiedTime" değeri (RFC 3339 tarih-saat) kaldırın.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Bir dosyadaki yorumların listesi.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi
{
  "kind": string,
  "comments": [
    {
      object (Comment)
    }
  ],
  "nextPageToken": string
}
Alanlar
kind

string

Bunun ne tür bir kaynak olduğunu tanımlar. Değer: sabit "drive#commentList" dizesi.

comments[]

object (Comment)

Yorum listesi. nextPageToken doldurulursa bu liste eksik olabilir ve ek bir sonuç sayfası getirilmelidir.

nextPageToken

string

Bir sonraki yorum sayfası için sayfa jetonu. Yorum listesinin sonuna gelindiğinde bu adım mevcut değildir. Jeton herhangi bir nedenle reddedilirse silinmeli ve sayfalara ayırma işlemi sonuçların ilk sayfasından yeniden başlatılmalıdır. Sayfa jetonu genellikle birkaç saat geçerlidir. Ancak yeni öğeler eklenir veya kaldırılırsa beklediğiniz sonuçlar farklılık gösterebilir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • 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

Bazı kapsamlar kısıtlanmıştır ve uygulamanızın bunları kullanabilmesi için güvenlik değerlendirmesi gerekir. Daha fazla bilgi için Yetkilendirme kılavuzunu inceleyin.