Labels deaktivieren, aktivieren und löschen

Auf dieser Seite wird beschrieben, wie Sie folgende Aufgaben im Zusammenhang mit Labels ausführen:

  • Label deaktivieren
  • Label aktivieren
  • Label löschen

Label deaktivieren

Wenn Sie ein Label deaktivieren, wird eine neue deaktivierte veröffentlichte Überarbeitung auf Grundlage der aktuellen veröffentlichten Überarbeitung erstellt. Wenn eine Entwurfsüberarbeitung vorhanden ist, wird eine neue deaktivierte Entwurfsüberarbeitung auf Grundlage der letzten Entwurfsüberarbeitung erstellt. Ältere Entwurfsüberarbeitungen werden gelöscht. Weitere Informationen finden Sie unter Label Lebenszyklus.

Nach der Deaktivierung können Nutzer dieses Label weiterhin über die API anwenden. Das Label wird weiterhin dort angezeigt, wo es bereits angewendet wurde, und in Ihren Suchergebnissen. Ein deaktiviertes Label kann gelöscht werden.

Verwenden Sie die disable Methode für die labels Sammlung, um ein veröffentlichtes Label zu deaktivieren.

Außerdem müssen Sie Folgendes angeben:

  • Eine Label-Ressource die jedes Label darstellt. Sie enthält einen Ressourcen-Name und eine ID, die eine global eindeutige Kennung für das Label ist.

  • useAdminAccess ist true, um die Administratoranmeldedaten des Nutzers zu verwenden. Der Server prüft, ob der Nutzer ein Administrator für das Label ist, bevor er den Zugriff zulässt.

In diesem Beispiel wird die ID verwendet, um das richtige Label zu deaktivieren.

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);
});

Das Label hat den State von DISABLED und die Überarbeitungs-ID des Labels wird erhöht. Nutzer können das Label über die API anwenden. Ein deaktiviertes Label wird jedoch nur dann in einer Benutzeroberfläche angezeigt, wenn die showInApply Eigenschaft der disabledPolicy Methode konfiguriert ist.

Label aktivieren

Wenn Sie ein deaktiviertes Label aktivieren, wird es in den veröffentlichten Zustand zurückversetzt. Es wird eine neue veröffentlichte Überarbeitung auf Grundlage der aktuellen deaktivierten veröffentlichten Überarbeitung erstellt. Wenn eine deaktivierte Entwurfsüberarbeitung vorhanden ist, wird eine neue Überarbeitung auf Grundlage dieses Entwurfs erstellt und aktiviert. Weitere Informationen finden Sie unter Label Lebenszyklus.

Verwenden Sie die enable Methode, um ein deaktiviertes Label zu aktivieren.

Außerdem müssen Sie Folgendes angeben:

  • Eine Label-Ressource die jedes Label darstellt. Sie enthält einen Ressourcen-Name und eine ID, die eine global eindeutige Kennung für das Label ist.

  • useAdminAccess ist true, um die Administratoranmeldedaten des Nutzers zu verwenden. Der Server prüft, ob der Nutzer ein Administrator für das Label ist, bevor er den Zugriff zulässt.

In diesem Beispiel wird die ID verwendet, um das richtige Label zu aktivieren.

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);
});

Das Label hat den State von PUBLISHED und die Überarbeitungs-ID des Labels wird erhöht. Nutzer können das Label über die API ansehen und auf Dateien anwenden.

Label löschen

Nur Entwurfs- und deaktivierte Labels können gelöscht werden. Wenn ein Label gelöscht wird, werden alle Instanzen, in denen das Label zuvor angewendet wurde, einschließlich aller von Nutzern eingegebenen Feldwerte, endgültig gelöscht und aus diesen Drive-Dateien entfernt.

Wenn Sie ein Label löschen möchten, müssen Sie es zuerst deaktivieren und dann die delete Methode verwenden.

Außerdem müssen Sie Folgendes angeben:

  • Eine Label-Ressource die jedes Label darstellt. Sie enthält einen Ressourcen-Name und eine ID, die eine global eindeutige Kennung für das Label ist.

  • useAdminAccess ist true, um die Administratoranmeldedaten des Nutzers zu verwenden. Der Server prüft, ob der Nutzer ein Administrator für das Label ist, bevor er den Zugriff zulässt.

In diesem Beispiel wird die ID verwendet, um das richtige Label zu löschen.

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);
});

Das Label hat den State von DELETED und die Überarbeitungs-ID des Labels wird erhöht. Das Label kann nicht angewendet werden und gelöschte Labels werden schließlich entfernt. Weitere Informationen finden Sie unter Label-Lebenszyklus.