Bir etiketi devre dışı bırakma, etkinleştirme ve silme

Bu sayfada, etiketleri içeren aşağıdaki görevlerin nasıl gerçekleştirileceği açıklanmaktadır:

• Etiketi devre dışı bırakma
• Etiketi etkinleştirme
• Etiketi silme

Etiketi devre dışı bırakma

Bir etiketin devre dışı bırakılması, yayınlanan mevcut düzeltmeye dayalı olarak yeni bir yayınlanmış düzeltmenin devre dışı bırakılmasıyla sonuçlanır. Taslak düzeltme varsa en son taslak düzeltmeye göre devre dışı bırakılmış yeni bir taslak düzeltmesi oluşturulur. Eski taslak düzeltmeler silinir. Daha fazla bilgi için Etiket yaşam döngüsü bölümüne bakın.

Devre dışı bırakıldığında, kullanıcılar bu etiketi API aracılığıyla uygulamaya devam edebilir. Etiket, uygulandığı yerlerde ve arama sonuçlarınızda görünmeye devam eder. Devre dışı bırakılan bir etiket silinebilir.

Yayınlanmış bir etiketi devre dışı bırakmak için labels koleksiyonunda disable yöntemini kullanın.

Şunları da belirtmeniz gerekir:

• Her etiketi temsil eden bir Etiket kaynağı. Etiket için genel olarak benzersiz tanımlayıcı olan Name ve ID kaynaklarını içerir.

• useAdminAccess, kullanıcının yönetici kimlik bilgilerini kullanmak için true değerine sahiptir. Sunucu, erişime izin vermeden önce kullanıcının etikette yönetici olduğunu doğrular.

Bu örnekte, doğru etiketi devre dışı bırakmak için ID kullanılmaktadır.

Python

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

Node.js

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

Etikette DISABLED State değeri bulunur ve etiketin düzeltme kimliği artar. Kullanıcılar, etiketi API aracılığıyla uygulayabilir. Bununla birlikte, disabledPolicy yönteminin showInApply özelliği yapılandırılmadığı sürece devre dışı bırakılmış etiket kullanıcı arayüzünde gösterilmez.

Etiketi etkinleştirme

Devre dışı bırakılmış bir etiket etkinleştirildiğinde etiket yayınlanmış durumuna geri yüklenir. Devre dışı bırakılan yayınlanmış düzeltmeye göre yeni yayınlanmış bir düzeltmeyle sonuçlanır. Devre dışı bırakılmış mevcut bir taslak düzeltme varsa söz konusu taslağa göre yeni bir düzeltme oluşturulur ve etkinleştirilir. Daha fazla bilgi için Etiket yaşam döngüsü bölümüne bakın.

Devre dışı bırakılmış bir etiketi etkinleştirmek için enable yöntemini kullanın.

Şunları da belirtmeniz gerekir:

• Her etiketi temsil eden bir Etiket kaynağı. Etiket için genel olarak benzersiz tanımlayıcı olan Name ve ID kaynaklarını içerir.

• useAdminAccess, kullanıcının yönetici kimlik bilgilerini kullanmak için true değerine sahiptir. Sunucu, erişime izin vermeden önce kullanıcının etikette yönetici olduğunu doğrular.

Bu örnekte, doğru etiketi etkinleştirmek için ID kullanılmaktadır.

Python

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

Node.js

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

Etikette PUBLISHED State değeri bulunur ve etiketin düzeltme kimliği artar. Kullanıcılar, etiketi API aracılığıyla görüntüleyebilir ve dosyalara uygulayabilir.

Etiketi silme

Yalnızca taslak olan ve devre dışı bırakılan etiketler silinebilir. Bir etiket silindiğinde, kullanıcılar tarafından girilen karşılık gelen alan değerleri de dahil olmak üzere etiketin daha önce uygulandığı tüm örnekler kalıcı olarak silinir ve söz konusu Drive dosyalarından kaldırılır.

Bir etiketi silmek için önce etiketi devre dışı bırakmalı, ardından delete yöntemini kullanmalısınız.

Şunları da belirtmeniz gerekir:

• Her etiketi temsil eden bir Etiket kaynağı. Etiket için genel olarak benzersiz tanımlayıcı olan Name ve ID kaynaklarını içerir.

• useAdminAccess, kullanıcının yönetici kimlik bilgilerini kullanmak için true değerine sahiptir. Sunucu, erişime izin vermeden önce kullanıcının etikette yönetici olduğunu doğrular.

Bu örnekte, doğru etiketi silmek için ID kullanılmaktadır.

Python

response = service.labels().delete(
  name='labels/ID',
  useAdminAccess=True).execute()

Node.js

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

Etikette DELETED State değeri bulunur ve etiketin düzeltme kimliği artar. Etiket uygulanamaz ve silinen etiketler sonunda kalıcı olarak silinir. Daha fazla bilgi için Etiket yaşam döngüsü bölümüne bakın.