Method: files.listLabels

Bir dosyada bulunan etiketleri listeler. Daha fazla bilgi için Dosyadaki etiketleri listeleme başlıklı makaleyi inceleyin.

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ı. Ayarlanmadığında varsayılan olarak 100 değerine ayarlanı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.

İ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)

Etiketlerin listesi.
nextPageToken

string

Etiketlerin sonraki sayfası için sayfa jetonu. Listenin sonuna ulaşıldıysa bu alan bulunmaz. 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ılık gösterebilir.
kind

string

Bu her zaman "drive#labelList" olur.

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 yapılması gerekir. Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.