Etiket oluşturma ve yayınlama

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

Etiket oluşturma

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

Ayrıca şu bilgileri de belirtmeniz gerekir:

• Bir LabelType.

• property yöntemi aracılığıyla bir etiket title.

• useAdminAccess, kullanıcının yönetici kimlik bilgilerini kullanmak için true olmalıdır. 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 bir başlığa sahip standart bir yönetici etiketi ve 2 Choices içeren bir SelectionOptions Field oluşturulur.

PythonNode.js

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()

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ılabilmesi ve kullanıcıların görebileceği şekilde PUBLISHED olmalıdır. Daha fazla bilgi için Etiket yaşam döngüsü başlıklı makaleyi inceleyin.

Etiket sınırları

Etiket oluştururken ve uygularken aşağıdaki sınırlamalar 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'te yapılandırıldığı gibi 10'dur
IntegerOptions	Sayısal bir değer girme	Yalnızca tam sayılar desteklenir
DateOptions	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şilerinden bir veya daha fazla kullanıcı seçin.	Bir dosya için maksimum kullanıcı girişi sayısı, ListOptions içinde yapılandırıldığı gibi 10'dur.

Etiket yayınlama

Labels API, tamamlanan bir taslak etiketi yayınlamanıza olanak tanır.

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

• Her etiketi temsil eden bir etiket kaynağı. Etiket için dünya genelinde benzersiz bir tanımlayıcı olan Name ve ID kaynağını içerir.

• useAdminAccess, kullanıcının yönetici kimlik bilgilerini kullanmak için true olmalıdır. 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.

PythonNode.js

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

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 alanına taşınır ve etiketin düzeltme kimliği artırılır. Etiket, kullanıcılar tarafından görülebilir ve dosyalara uygulanabilir. Daha fazla bilgi için Etiket yaşam döngüsü başlıklı makaleyi inceleyin.

Etiket yayınlarken karşılaşılan kısıtlamalar

• Etiketler yayınlandıktan sonra orijinal taslak durumuna geri döndürülemez. Daha fazla bilgi için Etiket yaşam döngüsü başlıklı makaleyi inceleyin.

• Etiket yayınladığınızda yeni bir düzeltme yayınlanır. Önceki tüm taslak düzeltmeleri silinir. Daha önce yayınlanan düzeltmeler saklanır ancak gerektiğinde otomatik olarak silinir.

• Yayınlandıktan sonra bazı değişikliklere izin verilmez. Genel olarak bu, etiketle ilgili mevcut meta verilerde yeni kısıtlamaları tetikleyen veya geçersiz kılan tüm değişikliklerin reddedildiği anlamına gelir. Örneğin, bir 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şti.
  • Alan doğrulama seçeneklerinde yapılan güncellemeler, daha önce kabul edilen bir değeri reddeder.
  • Maksimum giriş sayısında azalma.