Method: labels.disable

Deaktivieren Sie ein veröffentlichtes Label. Wenn Sie ein Label deaktivieren, wird eine neue deaktivierte veröffentlichte Version auf Grundlage der aktuell veröffentlichten Version erstellt. Wenn es einen Versionsentwurf gibt, wird auf der Grundlage der letzten Entwurfsversion ein neuer deaktivierter Entwurf erstellt. Ältere Entwurfsversionen werden gelöscht.

Nach der Deaktivierung kann ein Label mit labels.delete gelöscht werden.

HTTP-Anfrage

POST https://drivelabels.googleapis.com/v2/{name=labels/*}:disable

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Erforderlich. Ressourcenname des Labels.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{
  "updateMask": string,
  "useAdminAccess": boolean,
  "writeControl": {
    object (WriteControl)
  },
  "disabledPolicy": {
    object (DisabledPolicy)
  },
  "languageCode": string
}
Felder
updateMask

string (FieldMask format)

Die Felder, die aktualisiert werden sollen. Es muss mindestens ein Feld angegeben werden. Die Stamm-disabledPolicy ist impliziert und sollte nicht angegeben werden. Eine einzelne * kann als Abkürzung zum Aktualisieren jedes Felds verwendet werden.

useAdminAccess

boolean

Legen Sie true fest, 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 gewährt.

writeControl

object (WriteControl)

Bietet Kontrolle darüber, wie Schreibanfragen ausgeführt werden. Die Standardeinstellung ist nicht festgelegt, d. h., der letzte Schreibvorgang hat Vorrang.

disabledPolicy

object (DisabledPolicy)

Deaktivierte Richtlinie.

languageCode

string

Der BCP-47-Sprachcode für die Auswertung lokalisierter Feldlabels. Wenn keine Angabe erfolgt, werden Werte in der standardmäßig konfigurierten Sprache verwendet.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Label.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/drive.labels
  • https://www.googleapis.com/auth/drive.admin.labels

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.