Method: labels.list

Etiket listesini görüntüleyin.

HTTP isteği

GET https://drivelabels.googleapis.com/v2beta/labels

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

Sorgu parametreleri

Parametreler
publishedOnly

boolean

Sonuçlara yalnızca yayınlanmış etiketlerin dahil edilip edilmeyeceğini belirtir.

  • true olduğunda yalnızca şu anda yayınlanmış etiket düzeltmeleri döndürülür. Devre dışı olan etiketler dahildir. Döndürülen etiket kaynak adları, yayınlanan düzeltmeye (labels/{id}/{revisionId}) referans verir.
  • false olduğunda, geçerli etiket revizyonları döndürülür. Bu revizyonlar yayınlanmayabilir. Döndürülen etiket kaynak adları belirli bir düzeltmeye atıfta bulunmuyor (labels/{id}).
customer

string

Bu liste isteği kapsamına alınacak müşteri. Örneğin: "customers/abcd1234". Ayarlanmamışsa mevcut müşterideki tüm etiketleri döndürür.
languageCode

string

Yerelleştirilmiş alan etiketlerini değerlendirmek için kullanılacak BCP-47 dil kodu. Belirtilmediği takdirde, varsayılan olarak yapılandırılan dildeki değerler kullanılır.
pageSize

integer

Sayfa başına döndürülecek maksimum etiket sayısı. Varsayılan değer: 50. En fazla: 200.
pageToken

string

Döndürülecek sayfanın jetonu.
view

enum (LabelView)

Belirtildiğinde yalnızca belirtilen görünüme ait belirli alanlar döndürülür.

Birlik parametresi access.

access yalnızca aşağıdakilerden biri olabilir:
useAdminAccess

boolean

Kullanıcının yönetici kimlik bilgilerini kullanmak için true olarak ayarlayın. Bu işlem, müşterideki tüm etiketleri döndürür.
minimumRole

enum (LabelRole)

Kullanıcının döndürülen etiketlere sahip olması gereken erişim düzeyini belirtir. Kullanıcının bir etikette sahip olması gereken minimum rol. Varsayılan olarak READER değerine ayarlanır.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Etiket listelemesi için yanıt.

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

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

object (Label)

Etiketler.
nextPageToken

string

Yanıttaki sonraki sayfanın jetonu.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/drive.labels
  • https://www.googleapis.com/auth/drive.labels.readonly
  • https://www.googleapis.com/auth/drive.admin.labels
  • https://www.googleapis.com/auth/drive.admin.labels.readonly

Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.