Etiket oluşturma ve yayınlama

Bu belgede, Google Drive Labels API kullanılarak etiketlerin nasıl oluşturulacağı ve yayınlanacağı açıklanmaktadır.

Etiket oluşturma

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

Ayrıca şunları da belirtmeniz gerekir:

Aşağıdaki kod örneğinde, belirtilen başlığa ve iki Choice nesnesi içeren bir SelectionOptions Field ile standart bir yönetici etiketi oluşturmak için create yönteminin nasıl kullanılacağı gösterilmektedir.

Python

label_body = {
    'labelType': 'ADMIN',
    'properties': {
        'title': 'TITLE'
    },
    'fields': [{
        'properties': {
            'displayName': 'DISPLAY_NAME'
        },
        'selectionOptions': {
            'listOptions': {},
            'choices': [{
                'properties': {
                    'displayName': 'CHOICE_1'
                }
            }, {
                'properties': {
                    'displayName': 'CHOICE_2'
                }
            }]
        }
    }]
}
response = service.labels().create(
    body=label_body, useAdminAccess=True).execute()

Node.js

var label = {
  'labelType': 'ADMIN',
  'properties': {
    'title': 'TITLE'
  },
  'fields': [{
    'properties': {
      'displayName': 'DISPLAY_NAME'
    },
    'selectionOptions': {
      'listOptions': {},
      'choices': [{
        'properties': {
          'displayName': 'CHOICE_1'
        }
      }, {
        'properties': {
          'displayName': 'CHOICE_2'
        }
      }]
    }
  }]
};

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

Aşağıdakini değiştirin:

  • TITLE: Etiketin başlığı.
  • DISPLAY_NAME: Alanın görünen adı.
  • CHOICE_1: SelectionOptions alanındaki ilk seçenek.
  • CHOICE_2: SelectionOptions alanındaki ikinci seçenek.

Etiket, UNPUBLISHED_DRAFT State içinde oluşturulur. Etiketin, kullanıcılar tarafından görülebilmesi ve dosyalarda kullanılabilmesi için PUBLISHED olması gerekir. Daha fazla bilgi için Etiket yaşam döngüsü başlıklı makaleyi inceleyin.

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

Etiketlerdeki alanlarla çalışma

Aşağıdaki tabloda, etikete ekleyebileceğiniz alan türleri, kullanıcıların bu alanlarla nasıl etkileşim kurduğu, biçimle ilgili dikkat edilmesi gereken noktalar ve sınırlamalar açıklanmaktadır:

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
ListOptions bölümünde yapılandırıldığı gibi, bir dosya için 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çme (İsteğe bağlı) DateFormat "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

Drive Labels API, tamamlandıktan sonra taslak etiketi yayınlamanıza olanak tanır. Etiket, kullanıcılar tarafından görülebilir ve dosyalara uygulanabilir.

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

  • Her etiketi temsil eden bir labels kaynağı. Bir kaynak name ve bir id içerir. Bu, plak şirketinin genel olarak benzersiz tanımlayıcısıdır.

  • Kullanıcının yönetici kimlik bilgilerini kullanmak için useAdminAccess sorgu parametresi true olarak ayarlanır. Sunucu, erişime izin vermeden önce kullanıcının gerekli Sınıflandırma Etiketlerini Yönetme yönetici ayrıcalıklarına sahip olduğunu doğrular.

Aşağıdaki kod örneğinde, doğru etiketi tanımlayıp yayınlamak için etiketin id özelliğinin nasıl kullanılacağı gösterilmektedir.

Python

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

Node.js

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

ID yerine yayınlanacak etiketin kimliğini girin.

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ılar tarafından görülebilir ve dosyalara uygulanabilir. Daha fazla bilgi için Etiket yaşam döngüsü konusuna bakın.

Etiket yayınlarken uygulanan kısıtlamalar

Etiketleri yayınlamaya hazırlanırken aşağıdaki kısıtlamalara dikkat edin:

  • 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. Genel olarak 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 aşağıdaki etiket değişikliklerine izin verilmez:

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