Method: labels.disable

Veröffentlichte Labels deaktivieren Weitere Informationen finden Sie unter Label deaktivieren, aktivieren und löschen.

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 auf Grundlage des neuesten Entwurfs ein neuer deaktivierter Entwurf erstellt. Ältere Versionen von Entwürfen 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 zu aktualisierenden Felder. Es muss mindestens ein Feld angegeben werden. Der Stamm disabledPolicy ist impliziert und sollte nicht angegeben werden. Ein einzelnes * kann als Kurzform 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 Administrator des Labels ist, bevor er den Zugriff zulässt.
writeControl

object (WriteControl)

Bietet Kontrolle darüber, wie Schreibanfragen ausgeführt werden. Standardmäßig nicht festgelegt. Das bedeutet, dass der letzte Schreibvorgang ausgeführt wird.
disabledPolicy

object (DisabledPolicy)

Deaktivierte Richtlinie zur Verwendung.
languageCode

string

Der BCP-47-Sprachcode, der zum Auswerten lokalisierter Feldlabels verwendet werden soll. Wenn nichts angegeben ist, 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 Autorisierungsleitfaden.