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ı şunlardır:

  • Bilgi yönetimi stratejisini izlemek için içeriği sınıflandırabilirsiniz: Hassas veya özel işlem uygulanması gereken içeriği ya da verileri tanımlamak için bir etiket oluşturun. Örneğin, "Gizli," "Gizli" ve "Herkese Açık" değerlerine sahip "Hassasiyet" başlıklı bir rozet etiketi (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 uyması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ı (DLP) yönetmek için etiketleri kullanabilirsiniz.

  • Dosyaları seçip bulma: Kuruluşunuzdaki kullanıcıların etiketlere ve alanlarına göre öğeleri bulmasına olanak tanıyarak şirketinizin içeriğinin aranabilirliğini artırmak için etiketler oluşturun. Örneğin, kuruluşunuzdaki bir çalışan, 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

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 şunları içerir:

Etiket adı
Etiketin kaynak adı. Etiket kimliği, etiket adının bir parçasıdır. İsim, isteğe bağlı olarak şu biçimlerdedir: labels/{id} veya labels/{id}@{revisionId}. Daha fazla bilgi için aşağıdaki Etiket düzeltme bölümüne bakın.
Etiket kimliği
Etiket için dünya genelinde benzersiz bir tanımlayıcı. Kimlik, etiket adının bir bölümünü oluşturur ancak addan farklı olarak düzeltmelerde tutarlıdır.

2 etiket stili vardır:

Rozetli etiket

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

Drive, kullanıcıların dosyanın durumunu, sınıflandırmasını vb. net bir şekilde anlayabilmesi için her dosya için seçilen seçeneğin rengini gösterir. Örneğin, "Hassasiyet" rozeti etiketi için "Çok Gizli" seçeneği kırmızı renkte gösterilebilir. Aynı anda yalnızca bir rozetli etiketiniz olabilir.

Standart etiket

Sıfır veya daha fazla alan türü içeren bir etiket. Standart bir etiketin "Proje Ay" gibi bir etiket başlığı olabilir ve projeyle ilgili tüm dosyaları belirtebilir. Standart etiketler birden fazla yapılandırılmış alana da sahip olabilir. Örneğin, "Sözleşme" başlıklı bir etikette "Şirket", "Son Tarih", "Durum" ve "İmzalayanlar" alanları bulunabilir. 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

Etiketin yazılmış ve ayarlanabilir bağımsız bir bileşeni. Bir etiketin sıfır veya daha fazla alanı olabilir.

Alan türü
Alan ile 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 olan geçerli değerleri hem de kullanılabilen arama sorgusu seçeneklerini etkiler.
Seçim

Kullanıcının bir SelectionOptions alanından seçebileceği birkaç seçenekten biri.

Etiket türü

Tüm etiketler bir LabelType içerir. 2 tür etiket vardır:

Yönetici

Yöneticiye ait etiketler 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ıya etiketleri görüntüleme ve Drive öğelerine uygulama olanağı verebilir. Drive öğelerindeki etiket değerlerini değiştirmek veya okumak için aşağıdaki izinlere sahip olmanız gerekir:

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

    • Drive öğesi: EDITOR
    • Etiket: APPLIER

  • Okuma: Kullanıcının belirli bir etiketle ilgili Drive öğesi meta verilerini okuyabilmesi veya araabilmesi 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 ortak 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 uygulamak için kullanabileceğ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şturuldukları, yayınlandıkları, güncellendikleri vb. bir yaşam döngüsü geçirir. Bir etiket yaşam döngüsünü tamamladıkça etiket düzeltmesi artar. Daha fazla bilgi için Etiket yaşam döngüsü başlıklı makaleyi inceleyin.

Etiket düzeltme

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

Taslak düzeltme
Etiketin mevcut taslak örneğinin düzeltme numarası. Bir etikette, yayınlanmış düzeltmeyi etkilemeden birden fazla güncelleme yapabilirsiniz. Her güncelleme, taslak düzeltme numarasını artırır. 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 düzeltme numarası. Yayınlanan etiket, şu anda kullanıcıların kullanımına sunulan etiket örneğidir.