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 create yöntemini labels koleksiyonu. Etiketler isteğe bağlı olarak bir veya daha fazla Fields.

Ayrıca aşağıdakileri de belirtmeniz gerekir:

• LabelType.

• Bir etiket title - property yöntemini kullanabilirsiniz.

• useAdminAccess, kullanıcının yönetici kimlik bilgilerini kullanmak için true durumda. İlgili içeriği oluşturmak için kullanılan sunucu, kullanıcının "Etiketleri Yönet" seçeneğiyle bir yönetici olduğunu doğrular ayrıcalık inceleyin.

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

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 içinde oluşturuldu. State PUBLISHED olmalıdır dosyalarda kullanmak ve kullanıcılara görünür olmasını sağlamak için. Daha fazla bilgi için Etiket yaşam döngüsü boyunca geçerlidir.

Etiket sınırları

Etiket oluşturulurken ve uygulanırken 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 belirleyin	Desteklenen maksimum seçenek sayısı 200'dür Bir dosya için ListOptions yapılandırmasında yapılandırıldığı şekliyle maksimum seçim sayısı 10'dur.
IntegerOptions	Sayısal bir değer girin	Yalnızca tam sayılar desteklenir
DateOptions	Bir takvim tarihi seçin	(İ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 ListOptions kapsamında yapılandırıldığı şekliyle maksimum kullanıcı girişi sayısı 10'dur.

Etiket yayınlama

Etiketler API'sı, bir taslak etiket tamamlandıktan sonra yayınlamanıza olanak tanır.

Etiket yayınlamak için publish yöntemini seçin ve şunu belirtin:

• Etiket kaynağı anlamına gelir. Name ve ID kaynaklarını içerir. ise, 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 durumda. İlgili içeriği oluşturmak için kullanılan sunucu, kullanıcının "Etiketleri Yönet" seçeneğiyle bir yönetici olduğunu doğrular ayrıcalık inceleyin.

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 bölümüne taşınır State ve etiketin düzeltmesi Kimlik artar. Bu şekilde etiket kullanıcılar tarafından görülebilir ve dosyası olarak da kaydedebilir. Daha fazla bilgi için Etiket yaşam döngüsü boyunca geçerlidir.

Etiket yayınlarken yaşanan kısıtlamalar

• Bir etiket, yayınlandıktan sonra orijinal taslak durumuna geri dönemez. Daha fazla Etiket yaşam döngüsü bölümüne bakın.

• Bir etiket yayınlandığında yeni yayınlanan bir düzeltme oluşturulur. Önceki taslakların tümü düzeltmeler silindi. Daha önce yayınlanan düzeltmeler saklanır ancak gerektiği şekilde otomatik olarak silinebilir.

• Yayınlandıktan sonra bazı değişikliklere artık izin verilmez. Genellikle bu, mevcut kısıtlamalara ilişkin yeni kısıtlamaları geçersiz kılan veya tetikleyen herhangi bir değişiklik Etiketle ilgili meta veriler reddedildi. Örneğin, bir etiket yayınlandıktan sonra etikette değişiklik yapılmasına izin verilmez:

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