Method: files.listLabels

Bir dosyanın etiketlerini 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ı. Ayarlanmamışsa varsayılan olarak 100 değerine ayarlanır.
pageToken

string

Önceki liste isteğine sonraki sayfada devam etmek için kullanılan jeton. Bu parametre, ö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

Sonraki etiket sayfasının sayfa jetonu. Listenin sonuna ulaşıldıysa bu alan bulunmaz. Jeton herhangi bir nedenle reddedilirse atılmalıdır ve sayfalandırma, sonuçların ilk sayfasından yeniden başlatılmalıdır. Sayfa jetonu genellikle birkaç saat boyunca geçerlidir. Ancak yeni öğeler eklenirse veya kaldırılırsa beklediğiniz sonuçlar farklı olabilir.
kind

string

Bu değer 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ıtlıdır ve uygulamanızın bunları kullanabilmesi için güvenlik değerlendirmesi gerekir. Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.