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 belirtir. Silinen yorumlarda orijinal içerik bulunmaz.
pageSize

integer

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

string

Sonraki sayfada önceki liste isteğine devam etmek için kullanılan jeton. Bu, önceki yanıtın "nextPageToken" değerine ayarlanmalıdır.
startModifiedTime

string

Sonuç yorumları için minimum "modifiedTime" değeri (RFC 3339 tarih-saat).

İ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 dize "drive#commentList".
comments[]

object (Comment)

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

string

Sonraki yorum sayfası için sayfa jetonu. Yorum listesinin sonuna ulaşıldıysa bu bilgi bulunmaz. Jeton herhangi bir nedenle reddedilirse silinir ve sayfalara ayırma işlemi ilk sonuç sayfasından yeniden başlatılmalıdır. Sayfa jetonu genellikle birkaç saat boyunca geçerlidir. Ancak yeni öğeler eklenir veya kaldırılırsa beklenen sonuçlar farklı olabilir.

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.readonly

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