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

Bu parametre ayarlanırsa silinen yorumlar ve yanıtlar da dahil olmak üzere tüm yorumlar ve yanıtlar (içerikleri kaldırılmış şekilde) döndürülür.
maxResults

integer

Sayfalama için kullanılan, yanıta dahil edilecek maksimum tartışma sayısı.
pageToken

string

Büyük sonuç kümelerinde sayfalama yapmak için kullanılan devam 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 
{
  "kind": string,
  "selfLink": string,
  "nextLink": string,
  "items": [
    {
      object (Comment)
    }
  ],
  "nextPageToken": string
}
Alanlar
kind

string

Bu değer her zaman drive#commentList olur.
items[]

object (Comment)

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

string

Yorumların bir sonraki sayfası için sayfa jetonu. Yorum listesinin sonuna ulaşıldıysa bu seçenek gösterilmez. Jeton herhangi bir nedenle reddedilirse atılmalıdır ve sayfalandırma, 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ıtlıdır ve uygulamanızın bunları kullanabilmesi için güvenlik değerlendirmesi gerekir. Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.