Method: labels.list

Etiketleri listeleme.

HTTP isteği

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

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

Sorgu parametreleri

Parametreler
publishedOnly

boolean

Sonuçlara yalnızca yayınlanan etiketlerin eklenip eklenmeyeceğini belirtir.

  • true olduğunda yalnızca yayınlanmış mevcut etiket düzeltmeleri döndürülür. Devre dışı bırakılan etiketler dahil edilir. Döndürülen etiket kaynağı adları, yayınlanan düzeltmeye (labels/{id}/{revisionId}) başvuruyor.
  • false olduğunda mevcut etiket düzeltmeleri döndürülür ve bunlar yayınlanmayabilir. Döndürülen etiket kaynağı adları belirli bir düzeltmeye (labels/{id}) referans vermiyor.
customer

string

Bu liste isteğinin kapsamının ayarlanacağı müşteri. Örneğin: "customers/abcd1234". Politika ayarlanmazsa mevcut müşteri içindeki tüm etiketleri döndürür.

languageCode

string

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

pageSize

integer

Sayfa başına döndürülecek maksimum etiket sayısı. Varsayılan: 50. Maks.: 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.

Birleştirme parametresi access.

access şunlardan yalnızca biri olabilir:

useAdminAccess

boolean

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

minimumRole

enum (LabelRole)

Kullanıcının döndürülen Etiketler'de sahip olması gereken erişim düzeyini belirtir. Kullanıcının bir etiket üzerinde 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

Etiketleri listelemek 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 bir 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ılavuzu'na bakın.