Labels deaktivieren, aktivieren und löschen

Auf dieser Seite wird beschrieben, wie Sie die folgenden Aufgaben mit Labels ausführen:

• Label deaktivieren
• Label aktivieren
• Labels löschen

Label deaktivieren

Wenn Sie ein Label deaktivieren, wird eine neue deaktivierte veröffentlichte Version auf Grundlage der aktuellen veröffentlichten Version erstellt. Wenn es einen Entwurf gibt, wird ein neuer deaktivierter Entwurf auf Grundlage des letzten Entwurfs 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 in den Suchergebnissen und dort angezeigt, wo es bereits angewendet wird. Ein deaktiviertes Label kann gelöscht werden.

Wenn Sie ein veröffentlichtes Label deaktivieren möchten, verwenden Sie die Methode disable für die Sammlung labels.

Außerdem müssen Sie Folgendes angeben:

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

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

In diesem Beispiel wird 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 die State von DISABLED und die Revisions-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 Methode disabledPolicy konfiguriert ist.

Label aktivieren

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

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

Außerdem müssen Sie Folgendes angeben:

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

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

In diesem Beispiel wird 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 die State von PUBLISHED und die Revisions-ID des Labels wird erhöht. Nutzer können das Label über die API ansehen und auf Dateien anwenden.

Labels löschen

Nur Labels mit dem Status „Entwurf“ oder „Deaktiviert“ können gelöscht werden. Wenn ein Label gelöscht wird, wird es überall dort, wo es zuvor angewendet wurde, einschließlich aller von Nutzern eingegebenen Feldwerte, endgültig gelöscht und aus den entsprechenden Drive-Dateien entfernt.

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

Außerdem müssen Sie Folgendes angeben:

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

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

In diesem Beispiel wird 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 die State von DELETED und die Revisions-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.