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

Döndürülecek maksimum yorum sayısı. Hizmet, bu değerden daha az sonuç döndürebilir.

Belirtilmezse en fazla 20 yorum döndürülür.

Maksimum değer 100'dür. 100'den yüksek değerler 100'e zorlanır.
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 metni

İstek metni boş olmalıdır.

Yanıt metni

Bir dosyadaki 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 öğe 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 geçerlidir. Ancak yeni öğeler eklenir veya kaldırılırsa beklenen sonuçlarınız farklılık gösterebilir.

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.