Etiket oluşturma ve yayınlama

Bu sayfada, etiket oluşturma ve yayınlama hakkında bilgi verilmektedir.

Etiket oluştur

Etiket oluşturmak için labels koleksiyonunda create yöntemini kullanın. Etiketler isteğe bağlı olarak bir veya daha fazla Fields içerebilir.

Şunları da belirtmeniz gerekir:

• LabelType.

• property yöntemiyle title etiketi.

• useAdminAccess, kullanıcının yönetici kimlik bilgilerini kullanmak için true değerine sahiptir. Sunucu, erişime izin vermeden önce kullanıcının "Etiketleri Yönetme" ayrıcalığına sahip bir yönetici olduğunu doğrular.

Bu örnekte, belirtilen başlığa sahip standart bir yönetici etiketi ve 2 Choices içeren bir SelectionOptions Field etiketi oluşturulur.

Python

label_body = {
'label_type': 'ADMIN',
'properties': {
    'title': 'TITLE'
},
'fields': [{
    'properties': {
        'display_name': 'DISPLAY_NAME'
    },
    'selection_options': {
        'list_options': {},
        'choices': [{
            'properties': {
                'display_name': 'CHOICE_1'
            }
        }, {
            'properties': {
                'display_name': 'CHOICE_2'
            }
        }]
    }
}]
}
response = service.labels().create(
    body=label_body, useAdminAccess=True).execute()

Node.js

var label = {
'label_type': 'ADMIN',
'properties': {
    'title': 'TITLE'
},
'fields': [{
    'properties': {
    'display_name': 'DISPLAY_NAME'
    },
    'selection_options': {
    'list_options': {},
    'choices': [{
        'properties': {
        'display_name': 'CHOICE_1'
        }
    }, {
        'properties': {
        'display_name': 'CHOICE_2'
        }
    }]
    }
}]
};

service.labels.create({
  'resource': label,
  'use_admin_access': true
}, (err, res) => {
if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

Etiket, UNPUBLISHED_DRAFT State içinde oluşturulur. Dosyalarda kullanılması ve kullanıcılara görünür olması için PUBLISHED olmalıdır. Daha fazla bilgi için Etiket yaşam döngüsü bölümüne bakın.

Etiket sınırları

Etiket oluşturma ve uygulama için aşağıdaki sınırlar geçerlidir:

• Standart etiketler: 150
• Etiket başına alan sayısı: 10
• Dosya başına kullanıcı tarafından uygulanan etiket sayısı: 5

Etiketlerdeki alanlarla çalışma

Field Type	Kullanıcılar neler yapabilir?	Biçimle ilgili dikkat edilmesi gereken noktalar ve sınırlar
SelectionOptions	Listeden bir veya daha fazla seçenek belirleme	Desteklenen maksimum seçenek sayısı 200'dür Bir dosya için maksimum seçim sayısı, ListOptions bölümünde yapılandırıldığı üzere 10'dur
IntegerOptions	Sayısal bir değer girin	Yalnızca tam sayılar desteklenir
DateOptions	Takvim tarihi seçin	(İsteğe bağlı) Date format için "Uzun: GG Ay YYYY" veya "Kısa: GG/AA/YY" olarak ayarlanabilir.
TextOptions	Metin kutusuna metin girme	Desteklenen maksimum karakter sayısı 100'dür
UserOptions	Google Workspace kişilerinden bir veya daha fazla kullanıcı seçin.	ListOptions'de yapılandırılan şekilde bir dosya için maksimum kullanıcı girişi sayısı 10'dur.

Etiket yayınlama

Etiketler API, işlem tamamlandıktan sonra taslak etiket yayınlamanıza olanak tanır.

Etiket yayınlamak için publish yöntemini kullanarak şunları belirtin:

• Her etiketi temsil eden bir Etiket kaynağı. Etiket için genel olarak benzersiz tanımlayıcı olan Name ve ID kaynaklarını içerir.

• useAdminAccess, kullanıcının yönetici kimlik bilgilerini kullanmak için true değerine sahiptir. Sunucu, erişime izin vermeden önce kullanıcının "Etiketleri Yönetme" ayrıcalığına sahip bir yönetici olduğunu doğrular.

Bu örnekte, doğru etiketi tanımlamak ve yayınlamak için ID kullanılmaktadır.

Python

service.labels().publish(
name='labels/ID',
body={
  'use_admin_access': True
}).execute()

Node.js

service.labels.publish({
  'resource': {
    'use_admin_access': true
},
'name': 'labels/ID'
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

Etiket yayınlandıktan sonra PUBLISHED State etiketine taşınır ve etiketin düzeltme kimliği artar. Ardından etiket, kullanıcılar tarafından görülebilir ve dosyalara uygulanabilir. Daha fazla bilgi için Etiket yaşam döngüsü bölümüne bakın.

Etiketleri yayınlarken kısıtlamalar

• Etiket yayınlandıktan sonra orijinal taslak durumuna geri dönemez. Daha fazla bilgi için Etiket yaşam döngüsü bölümünü inceleyin.

• Etiket yayınladığınızda yeni yayınlanmış bir düzeltme oluşturulur. Önceki tüm taslak düzeltmeler silinir. Önceden yayınlanan düzeltmeler saklanır ancak gerektiğinde otomatik olarak silinir.

• Yayınlandıktan sonra bazı değişikliklere artık izin verilmez. Genellikle bu, etiketle ilgili mevcut meta verilerde yeni kısıtlamaları geçersiz kılan veya tetikleyen tüm değişikliklerin reddedileceği anlamına gelir. Örneğin, etiket yayınlandıktan sonra etikette yapılan aşağıdaki değişikliklere izin verilmez:

  • Etiket doğrudan silinir. (Önce devre dışı bırakılıp ardından silinmesi gerekir.)
  • Field.FieldType değiştirildi.
  • Alan doğrulama seçeneklerinde yapılan güncellemeler, daha önce kabul edilen bir öğeyi reddeder.
  • Maksimum giriş sayısında azalma.