Method: comments.list

Dosyadaki yorumları listeler.

HTTP isteği

GET https://www.googleapis.com/drive/v2/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

Ayarlanırsa silinen yorumlar ve yanıtlar (içerik kaldırılmış olarak) dahil olmak üzere tüm yorumlar ve yanıtlar döndürülür.
maxResults

integer

Yanıta dahil edilecek ve sayfalama için kullanılan maksimum tartışma sayısıdır.
pageToken

string

Büyük sonuç grupları arasında sayfa görüntülemek için kullanılan devam jetonu. Sonraki sonuç sayfasını almak için bu parametreyi önceki yanıtın "nextPageToken" değerine ayarlayın.
updatedMin

string

Yalnızca bu zaman damgasından sonra güncellenen tartışmalar döndürülür. RFC 3339 zaman damgası olarak biçimlendirilmiştir.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Google Drive'da bir dosyaya yapılan yorumların listesi.

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

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

string

Bu her zaman drive#commentList olur.
items[]

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.

Yetkilendirme kapsamları

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

  • https://www.googleapis.com/auth/docs
  • 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.