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, 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 metni

İstek metni boş olmalıdır.

Yanıt metni

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 değer her zaman drive#commentList olur.
nextPageToken

string

Sonraki yorum sayfası için sayfa jetonu. Yorum listesinin sonuna ulaşıldıysa bu seçenek 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.