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

Bu sayfada, etiketlerle ilgili 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ı, mevcut yayınlanmış düzeltmeye dayalı yeni bir devre dışı yayınlanmış düzeltme oluşturulmasına neden olur. Taslak düzeltme varsa en son taslak düzeltmeye göre yeni bir devre dışı bırakılmış taslak düzeltme oluşturulur. Eski taslak düzeltmeleri silinir. Daha fazla bilgi için Etiket yaşam döngüsü başlıklı makaleyi inceleyin.

Devre dışı bırakıldıktan sonra kullanıcılar bu etiketi API üzerinden uygulamaya devam edebilir. Etiket, daha önce uygulandığı yerlerde ve arama sonuçlarınızda görünmeye devam eder. Devre dışı bırakılan etiketler silinebilir.

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

Ayrıca şu bilgileri de belirtmeniz gerekir:

  • 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 etiketin yöneticisi olduğunu doğrular.

Bu örnekte, doğru etiketi devre dışı bırakmak için ID kullanılı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);
});

Etiketin DISABLED State değeri vardır ve etiketin düzeltme kimliği artırılır. Kullanıcılar etiketi API üzerinden uygulayabilir. Ancak disabledPolicy yönteminin showInApply özelliği yapılandırılmadığı sürece devre dışı 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. Bu işlem, mevcut devre dışı yayınlanmış düzeltmeye dayalı yeni bir yayınlanmış düzeltmeyle sonuçlanır. Devre dışı bırakılmış mevcut bir taslak düzeltmesi varsa bu taslak temel alınarak yeni bir düzeltme oluşturulur ve etkinleştirilir. Daha fazla bilgi için Etiket yaşam döngüsü başlıklı makaleyi inceleyin.

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

Ayrıca şu bilgileri de belirtmeniz gerekir:

  • 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 etiketin yöneticisi olduğunu doğrular.

Bu örnekte, doğru etiketi etkinleştirmek için ID kullanılı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);
});

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

Etiketi silme

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

Bir etiketi silmek için önce etiketi devre dışı bırakmanız ve ardından delete yöntemini kullanmanız gerekir.

Ayrıca şu bilgileri de belirtmeniz gerekir:

  • 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 etiketin yöneticisi olduğunu doğrular.

Bu örnekte, doğru etiketi silmek için ID kullanılı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);
});

Etiketin DELETED State değeri vardır ve etiketin düzeltme kimliği artırılır. Etiket uygulanamaz ve silinen etiketler zaman içinde temizlenir. Daha fazla bilgi için Etiket yaşam döngüsü başlıklı makaleyi inceleyin.