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:
property
yöntemiyletitle
etiketi.useAdminAccess
, kullanıcının yönetici kimlik bilgilerini kullanmak içintrue
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
veID
kaynaklarını içerir.useAdminAccess
, kullanıcının yönetici kimlik bilgilerini kullanmak içintrue
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.