Etiketler, kullanıcıların Google Drive'daki dosyaları düzenlemesine, bulmasına ve bu dosyalara 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'sidir. Bu API'nin yaygın kullanım alanları şunlardır:
Bilgi yönetimi stratejisini izlemek için içeriği sınıflandırın: Özel işlem gerektiren hassas içerik veya verileri tanımlamak için bir etiket oluşturun. Örneğin, "Hassasiyet", "Gizli" ve "Herkese Açık" değerlerine sahip "Hassasiyet" başlıklı bir rozetli etiket (renk kodlu seçenek değerlerine sahip bir etiket) oluşturabilirsiniz.
Politikayı Drive'daki öğelere 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 indirilemediği bir veri kaybı politikasını (Veri Kaybını Önleme) yönetmek için etiketleri kullanın.
Seçme ve dosya bulma: Kuruluşunuzdaki kullanıcıların, etiketlere ve alanlarına göre öğeler bulmasına izin vererek şirket içeriğinizin aranabilirliğini artırmak için etiketler oluşturun. Örneğin, kuruluşunuzdaki bir kullanıcı, belirli bir tarihe kadar imza bekleyen tüm sözleşmeleri bulmak için Drive arama seçeneklerini kullanabilir.
Drive Labels API'de kullanılan yaygın terimlerin listesi aşağıda verilmiştir:
- Etiket
Bir Drive dosyasına yerleştirilmiş yapılandırılmış meta veri. Drive kullanıcıları, dosyalara etiket atayabilir ve etiket alanı değerleri belirleyebilir. Etiketler şunlardan oluşur:
- Etiket adı
- Etiketin kaynak adı. Etiket kimliği, Etiket adının bir kısmını oluşturur. İsteke bağlı olarak ad şu iki biçimden oluşur:
labels/{id}veya
labels/{id}@{revisionId}. Daha fazla bilgi için aşağıdaki Etiket düzeltmesi bölümüne bakın.
- Etiket kimliği
- Etiketin genel olarak benzersiz tanımlayıcısı. Kimlik, etiket adının bir kısmını oluşturur, ancak adın aksine düzeltmeler arasında tutarlıdır.
2 tür etiket vardır:
- Rozetli etiket
Önem derecesini belirtmek için renk kodlu seçenekler içeren bir
SelectionOptionsalan türüne sahip etiket. Bunun için
badgeConfig,
Choice'te yer alan
Propertiesüzerinden ayarlanır.
Drive, her bir dosya için belirlenen seçeneğin rengini görüntüler. Böylece kullanıcılar, dosyanın durumunu, sınıflandırmasını vs. net bir şekilde anlayabilir. Örneğin, "Hassasiyet" rozetli etiket için "Çok Gizli" seçeneği kırmızı renkte gösterilebilir. Tek seferde yalnızca bir rozetli etiketiniz olabilir.
- Standart etiket
Sıfır veya daha fazla alan türü içeren bir etiket. Standart bir etiketin "Project Moonshot" gibi bir etiket başlığı olabilir ve projeyle ilgili tüm dosyalar belirtilir. Bir standart etiketin birden fazla yapılandırılmış alanı da olabilir. Örneğin, "Sözleşme" başlığına sahip 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ı).
- Alan
Bir etiketin ayrı olarak yazılmış, ayarlanabilir bileşeni. Bir etiketle ilişkili olan sıfır veya daha fazla alan olabilir.
- Alan türü
- Alan ile ilişkilendirilen değerin veri türü. Metin, tam sayı, tarih, kullanıcı veya seçim olarak yapılandırılabilir. Alanı
ListOptionsile 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 olan geçerli değerleri hem de mevcut arama sorgusu seçeneklerini etkiler.
- Seçim
Kullanıcılar,
SelectionOptionsalanındaki birkaç seçenekten birini belirleyebilir.
- Etiket türü
Tüm etiketler
LabelTypeiçerir. 2 tür etiket vardır:
- Yönetici
Yöneticinin sahip olduğu etiketleri oluşturmak ve düzenlemek için Etiketleri Yönetme ayrıcalığına sahip bir hesap yöneticisi olmanız gerekir.
Yöneticiler herhangi bir kullanıcıyla yönetici etiketlerini paylaşarak bu kullanıcıya Drive öğelerini görüntüleme ve Drive öğelerinde uygulama olanağı verebilir. Drive öğelerindeki etiket değerlerini değiştirmek veya okumak 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 kullanıcının uygun izin seviyelerine sahip olması gerekir:
- Drive öğesi:
EDITOR
- Etiket:
APPLIER
- Drive öğesi:
Okuma: Kullanıcının belirli bir etiketle ilgili Drive öğesi meta verilerini okuyabilmesi veya arayabilmesi için uygun izin seviyelerine sahip olması gerekir:
- Drive öğesi:
READER
- Etiket:
READER
- Drive öğesi:
-
Yönetici olmayan kullanıcılar, diğer kullanıcıların Drive öğelerine uygulayabileceği paylaşılan etiketler oluşturabilir. Ekipler, yönetici gerektirmeden ekip içinde kullanılmak üzere kendi etiketlerini oluşturabilir ve düzenleyebilir.
- Etiket sınıflandırması
Kullanıcıların Drive dosyalarına uygulaması için kullanılabilen, yapılandırılmış mevcut 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, İnceleniyor, Nihai
- İçerik türü: Sözleşme, Tasarım Dokümanı, Örnek
- Bölüm: Pazarlama, Finans, İnsan Kaynakları, Satış
- Etiket yaşam döngüsü
Etiketler; oluşturulup oluşturulduğu, yayınlandığı, güncellendiği vb. bir yaşam döngüsü boyunca çalışır. Bir etiket yaşam döngüsü boyunca ilerlerken etiket düzeltmesi artar. Daha fazla bilgi için Etiket yaşam döngüsü bölümünü inceleyin.
- 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ı. Bir etikette birkaç düzeltme yapabilirsiniz. Bunların her biri, yayınlanan düzeltmeyi etkilemeden taslak düzeltme numarasını artırır. Taslak etiketlere sahip olma özelliği, etiket güncellemelerini yayınlamadan önce test etmenize olanak tanır.
- Yayınlanan düzeltme
- Bir etiketin yayınlanan sürümünün düzeltme numarası. Yayınlanan etiket, kullanıcılara sunulan etiketin örneğidir.
İlgili konular
Kimlik doğrulama ve yetkilendirme işlemleri de dahil olmak üzere Google Workspace API'leri ile geliştirme hakkında bilgi edinmek için Google Workspace geliştiricisi olarak başlama başlıklı makaleyi inceleyin.
Basit bir Labels API uygulamasını yapılandırmayı ve çalıştırmayı öğrenmek için Python hızlı başlangıç kılavuzunu deneyin.