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. İhtiyacınız olan alanları döndürmek için Belirli alanları döndürme başlıklı makaleye 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 orijinal içeriklerini içermez.
pageSize

integer

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

string

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

string

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

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

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 
{
  "comments": [
    {
      object (Comment)
    }
  ],
  "kind": string,
  "nextPageToken": string
}
Alanlar
comments[]

object (Comment)

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

string

Bunun ne tür bir kaynak olduğunu tanımlar. Değer: Sabit dize "drive#commentList".
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. Sayfa jetonu genellikle birkaç saat boyunca geçerlidir. Ancak yeni öğeler eklenir veya kaldırılırsa beklenen sonuçlarınız 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ı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.