Method: comments.list

Bir dosyanın yorumlarını listeler. Daha fazla bilgi için Yorumları ve yanıtları yönetme başlıklı makaleyi inceleyin.

Zorunlu: fields parametresi ayarlanmalıdır. Tam olarak ihtiyacınız olan alanları döndürmek için Belirli alanları döndürme bölümüne bakın.

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ği. Silinen yorumların orijinal içeriği gösterilmez.
pageSize

integer

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

string

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

string

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

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Bir dosyada bulunan 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

Bu kaynağın ne tür olduğunu tanımlar. Değer: "drive#commentList" sabit dizesi.
comments[]

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. Sayfa jetonu genellikle birkaç saat boyunca geçerlidir. Ancak yeni öğeler eklenirse veya kaldırılırsa beklediğiniz 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.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.