Method: files.listLabels

Bir dosyadaki etiketleri listeler.

HTTP isteği

GET https://www.googleapis.com/drive/v3/files/{fileId}/listLabels

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
fileId

string

Dosyanın kimliği.

Sorgu parametreleri

Parametreler
maxResults

integer

Sayfa başına döndürülecek maksimum etiket sayısı. Ayarlanmazsa varsayılan olarak 100 değerine ayarlanır.

pageToken

string

Sonraki sayfada önceki bir liste isteğini devam ettirmek için kullanılan jeton. Bu, "nextPageToken" değerine ayarlanmalıdır. bu soruyu yanıtlar:

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Bir dosyaya uygulanan etiketlerin listesi.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi
{
  "labels": [
    {
      object (Label)
    }
  ],
  "nextPageToken": string,
  "kind": string
}
Alanlar
labels[]

object (Label)

Etiket listesi.

nextPageToken

string

Sonraki etiket sayfası için sayfa jetonu. Listenin sonuna ulaşıldıysa bu alan eksik olacaktır. Jeton herhangi bir nedenle reddedilirse silinmeli 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 beklediğiniz sonuçlar farklılık gösterebilir.

kind

string

Bu her zaman drive#labelList'tir

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.metadata
  • https://www.googleapis.com/auth/drive.metadata.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.