Method: comments.list

Bir dosyanın yorumlarını 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

Ayarlanmışsa 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ıtın sayfalandırılması için kullanılan ve yanıta dahil edilecek maksimum tartışma sayısı.
pageToken

string

Büyük sonuç kümelerinde sayfalandırma için kullanılan devamlılık jetonu. Sonuçların bir sonraki sayfasını almak için bu parametreyi önceki yanıttaki "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çimlendirilir.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Google Drive'daki bir dosyayla ilgili yorumların listesi.

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

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

object (Comment)

Yorum listesi. nextPageToken doldurulmuşsa bu liste eksik olabilir ve ek bir sonuç sayfası getirilmelidir.
kind

string

Bu her zaman drive#commentList olur.
nextPageToken

string

Yorumların sonraki sayfası için sayfa jetonu. Yorum listesinin sonuna ulaşıldıysa bu düğme gösterilmez. Jeton herhangi bir nedenle reddedilirse atılmalı ve sayfalara ayırma işlemi sonuçların ilk 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.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 yapılması gerekir. Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.