Method: comments.list

Dosyadaki yorumları 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

Ayarlanırsa silinen yorumlar ve yanıtlar da (içeriği çıkarılmış olarak) dahil tüm yorumlar ve yanıtlar döndürülür.

maxResults

integer

Sayfalara ayırma için kullanılan, yanıta dahil edilecek maksimum tartışma sayısı.

pageToken

string

Büyük sonuç kümelerinde gezinmek için kullanılan devam jetonu. Sonraki sonuç sayfasını almak için bu parametreyi "nextPageToken" değerine ayarlayın. bu soruyu yanıtlar:

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'da bir dosyaya yapılan 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 her zaman drive#commentList.

items[]

object (Comment)

Yorum listesi. nextPageToken doldurulursa bu liste eksik olabilir ve ek bir sonuç sayfası getirilmelidir.

nextPageToken

string

Bir sonraki yorum sayfası için sayfa jetonu. Yorum listesinin sonuna gelindiğinde bu adım mevcut değildir. Jeton herhangi bir nedenle reddedilirse silinmeli 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 gerekir. Daha fazla bilgi için Yetkilendirme kılavuzunu inceleyin.