Method: labels.disable

Deaktivieren Sie ein veröffentlichtes Label. Wenn Sie ein Label deaktivieren, wird eine neue deaktivierte veröffentlichte Version basierend auf der aktuellen veröffentlichten Version erstellt. Wenn es eine Entwurfsversion gibt, wird eine neue deaktivierte Entwurfsversion basierend auf der neuesten Entwurfsversion erstellt. Ältere Entwurfsversionen werden gelöscht.

Deaktivierte Labels können 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. Name der Labelressource.

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 zu aktualisierenden Felder. Es muss mindestens ein Feld angegeben werden. Der Stamm disabledPolicy ist implizit und sollte nicht angegeben werden. Eine einzelne * kann als Kurzschreibweise für die Aktualisierung aller Felder 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 der Zugriff gewährt wird.
writeControl

object (WriteControl)

Steuert, wie Schreibanfragen ausgeführt werden. Standardmäßig ist der Wert nicht festgelegt. Das bedeutet, dass der letzte Schreibvorgang ausgeführt wird.
disabledPolicy

object (DisabledPolicy)

Deaktivierte Richtlinie, die verwendet werden soll.
languageCode

string

Der BCP-47-Sprachcode, der für die Auswertung lokalisierter Feldlabels verwendet werden soll. 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.