Drive Etiketler API'ye genel bakış

Etiketler, kullanıcıların Google Drive'daki dosyaları düzenlemesine, bulmasına ve bu dosyalara politika uygulamasına yardımcı olmak için tanımladığınız meta verilerdir. Drive Labels API, Drive dosyalarınıza meta veriler ekleyerek iş süreçlerini destekleyen bir RESTful API'dir. Bu API'nin yaygın kullanım alanları:

  • Bilgi yönetimi stratejisini izlemek için içeriği sınıflandırma: Hassas veya özel işlem uygulanması gereken içeriği ya da verileri tanımlamak için etiket oluşturun. Örneğin, "Çok Gizli", "Gizli" ve "Herkese Açık" değerlerini içeren "Hassasiyet" adlı rozetli bir etiket (renk kodlu seçenek değerlerine sahip bir etiket) oluşturabilirsiniz.

  • Drive'daki öğelere politika uygulama: Drive içeriğini yaşam döngüsü boyunca yönetmek ve kuruluşunuzun kayıt saklama uygulamalarına uygun olmasını sağlamak için etiketler oluşturun. Örneğin, "Hassasiyet" etiketi "Çok Gizli" olarak ayarlanmış dosyaların bilgisayara indirilememesini sağlayan bir veri kaybını önleme (DLP) politikasını yönetmek için etiketleri kullanabilirsiniz.

  • Dosyaları düzenleme ve bulma: Kuruluşunuzdaki kullanıcıların öğeleri etiketlere ve alanlarına göre bulmasını sağlayarak şirketinizin içeriklerinin aranabilirliğini artırmak için etiketler oluşturun. Örneğin, kuruluşunuzdaki bir çalışan, belirli bir tarihe kadar imzalanması gereken tüm sözleşmeleri bulmak için Drive arama seçeneklerini kullanabilir.

Drive Labels API'de kullanılan yaygın terimlerin listesini aşağıda bulabilirsiniz:

Etiket

Drive dosyasına yerleştirilen yapılandırılmış meta veriler. Drive kullanıcıları, dosyalara etiket atayabilir ve etiket alan değerlerini ayarlayabilir. Etiketler şunlardan oluşur:

Etiket adı
Etiketin kaynak adı. Etiket kimliği, etiket adının bir bölümünü oluşturur. İsteğe bağlı olarak ad, labels/{id} veya labels/{id}@{revisionId} biçimindedir. Daha fazla bilgi için aşağıdaki Etiket düzeltme bölümüne bakın.
Etiket kimliği
Etiket için genel düzeyde benzersiz tanımlayıcı. Kimlik, etiket adının bir bölümünü oluşturur ancak adın aksine, revizyonlar arasında tutarlıdır.

2 tür etiket stili vardır:

Rozetli etiket

Önemi belirtmek için renk kodlarıyla işaretlenebilen seçenekler içeren bir SelectionOptions alan türüne sahip etiket. Bu işlem, Choice öğesinin Properties aracılığıyla badgeConfig ayarlanarak yapılır.

Drive, her dosya için seçilen seçeneğin rengini gösterir. Böylece kullanıcılar, dosyanın durumunu veya sınıflandırmasını net bir şekilde anlayabilir. Örneğin, "Gizlilik" rozetli etiketi için "Çok Gizli" seçeneği kırmızı renkte gösterilebilir. Belirli bir etikette yalnızca bir rozetli alan olabilir ancak birden fazla rozetli etiket olabilir.

Standart etiket

Sıfır veya daha fazla alan türü içeren bir etiket. Standart bir etikette "Project Moonshot" gibi bir etiket başlığı olabilir ve projeyle ilgili tüm dosyalar belirtilebilir. Standart bir etikette de çeşitli yapılandırılmış alanlar olabilir. Örneğin, "Sözleşme" başlıklı bir etiket "Şirket", "Son Tarih", "Durum" ve "İmza Sahipleri" alanlarını içerebilir. Her alan belirli bir türdedir (metin, tarih, seçim veya kullanıcı).

Rozetli etiket şeması.
Şekil 1. Rozetli etiket
Standart etiket şeması.
Şekil 2. Standart etiket
Alan

Bir etiketin yazılmış, ayarlanabilir bağımsız bileşeni. Bir etiketle ilişkili alan olmayabilir veya birden fazla alan olabilir.

Alan türü
Alanla ilişkili değerin veri türü. Metin, tam sayı, tarih, kullanıcı veya seçim olarak yapılandırılabilir. Alanı ListOptions ile yapılandırırsanız kullanıcı ve seçim alanlarını birden fazla değerle ayarlayabilirsiniz. Seçilen tür, hem Drive öğeleri için geçerli değerleri hem de kullanılabilen arama sorgusu seçeneklerini etkiler.
Seçim

Kullanıcının bir SelectionOptions alandan seçebileceği seçeneklerden biri.

Etiket türü

Tüm etiketlerde LabelType bulunur. 2 tür etiket vardır:

Yönetici

Yöneticiye ait etiketleri oluşturmak ve düzenlemek için Etiketleri Yönetme ayrıcalığına sahip bir hesap yöneticisi olmanız gerekir.

Yöneticiler, yönetici etiketlerini herhangi bir kullanıcıyla paylaşarak bu kullanıcının etiketleri görüntülemesini ve Drive öğelerine uygulamasını sağlayabilir. Drive öğelerindeki etiket değerlerini değiştirme veya okuma için aşağıdaki izinler gerekir:

  • Değiştirme: Bir kullanıcının belirli bir etiketle ilgili Drive öğesi meta verilerini değiştirebilmesi için uygun izin düzeylerine sahip olması gerekir:

    • Drive öğesi: EDITOR
    • Etiket: APPLIER

  • Okuma: Bir kullanıcının belirli bir etiketle ilgili Drive öğesi meta verilerini okuması veya araması için uygun izin düzeylerine sahip olması gerekir:

    • Drive öğesi: READER
    • Etiket: READER
Paylaşılan

Yönetici olmayan kullanıcılar, diğer kullanıcıların Drive öğelerine uygulayabileceği paylaşılan etiketler oluşturabilir. Ekipler, yöneticiye ihtiyaç duymadan ekip içinde kullanmak üzere kendi etiketlerini oluşturup düzenleyebilir.

Etiket sınıflandırması

Kullanıcıların Drive dosyalarına uygulayabileceği, şu anda yapılandırılmış etiket alanları. Etiket şeması olarak da bilinir.

Örnek etiket sınıflandırmaları:

  • Hassasiyet: Kırmızı, Turuncu, Sarı, Yeşil
  • Durum: Başlatılmadı, Taslak, İncelemede, Nihai
  • İçerik türü: Sözleşme, Tasarım Dokümanı, Model
  • Departman: Pazarlama, Finans, İnsan Kaynakları, Satış
Etiket yaşam döngüsü

Etiketler, oluşturulma, yayınlanma ve güncellenme gibi bir yaşam döngüsünden geçer. Bir etiket yaşam döngüsünü tamamladıkça etiket düzeltmesi artırılır. Daha fazla bilgi için Etiket yaşam döngüsü konusuna bakın.

Etiket düzeltmesi

Etiketin bir örneği. Bir etiket oluşturulduğunda, güncellendiğinde, yayınlandığında veya kullanımdan kaldırıldığında etiket düzeltmesi artar.

Taslak düzeltme
Etiketin mevcut taslak örneğinin düzeltme numarası. Yayınlanan sürümü etkilemeden bir etikette birden fazla güncelleme yapabilir ve her güncellemede taslak sürüm numarasını artırabilirsiniz. Taslak etiketler oluşturma özelliği, etiket güncellemelerini yayınlamadan önce test etmenize olanak tanır.
Yayınlanan düzeltme
Bir etiketin yayınlanmış sürümünün revizyon numarası. Yayınlanan etiket, şu anda kullanıcılar tarafından kullanılabilen etiket örneğidir.