Etiket oluşturma ve yayınlama

Bu sayfada, etiket oluşturma ve yayınlama işlemleri açıklanmaktadır.

Etiket oluşturma

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

Ayrıca şunları da belirtmeniz gerekir:

• LabelType.

• property yöntemiyle title etiketi.

• useAdminAccess, kullanıcının yönetici kimlik bilgilerini kullanmak için true. 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 ve 2 Choices içeren bir SelectionOptions Field ile standart bir yönetici 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. PUBLISHED Dosyalarda kullanılmalı ve kullanıcılar tarafından görülebilmelidir. Daha fazla bilgi için Etiket yaşam döngüsü konusuna bakın.

Etiket sınırları

Etiket oluşturma ve uygulama sırasında 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ığı gibi 10'dur.
IntegerOptions	Sayısal bir değer girin	Yalnızca tam sayılar desteklenir
DateOptions	Bir takvim tarihi seçme	(İsteğe bağlı) Date format "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şileri'nden bir veya daha fazla kullanıcı seçin.	Bir dosya için maksimum kullanıcı girişi sayısı, ListOptions bölümünde yapılandırıldığı gibi 10'dur.

Etiket yayınlama

Labels API, tamamlandıktan sonra taslak etiketi yayınlamanıza olanak tanır.

Etiket yayınlamak için publish yöntemini kullanın ve şunları belirtin:

• Her etiketi temsil eden bir etiket kaynağı. Bir kaynak Name ve ID içerir. Bu, etiket için genel olarak benzersiz bir tanımlayıcıdır.

• useAdminAccess, kullanıcının yönetici kimlik bilgilerini kullanmak için true. 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ılı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 bölümüne taşınır ve etiketin düzeltme kimliği artırılır. Etiket, kullanıcılara görünür hale gelir ve dosyalara uygulanabilir. Daha fazla bilgi için Etiket yaşam döngüsü konusuna bakın.

Etiket yayınlarken uygulanan kısıtlamalar

• Yayınlanan etiketler orijinal taslak durumuna döndürülemez. Daha fazla bilgi için Etiket yaşam döngüsü başlıklı makaleyi inceleyin.

• Bir etiket yayınladığınızda yeni bir yayınlanmış düzeltme oluşturulur. Önceki tüm taslak düzeltmeler silinir. Daha önce yayınlanmış düzeltmeler saklanır ancak gerektiğinde otomatik olarak silinebilir.

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

  • Etiket doğrudan silinir. (Önce devre dışı bırakılmalı, ardından silinmelidir.)
  • Field.FieldType değiştirildi.
  • Alan doğrulama seçeneklerindeki güncellemeler, daha önce kabul edilen bir şeyi reddediyor.
  • Maksimum giriş sayısında azalma.