Method: labels.disable

Veröffentlichtes Label deaktivieren Wenn Sie ein Label deaktivieren, wird eine neue deaktivierte veröffentlichte Überarbeitung auf Grundlage der aktuell veröffentlichten Überarbeitung erstellt. Wenn es einen Überarbeitungsentwurf gibt, wird ein neuer deaktivierter Überarbeitungsentwurf auf der Grundlage des letzten Überarbeitungsentwurfs erstellt. Ältere Überarbeitungen des Entwurfs werden gelöscht.

Nach dem Deaktivieren 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. Label-Ressourcenname.

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. Mit nur einer * können Sie schnell alle Felder aktualisieren.
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 der Zugriff zugelassen wird.
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)

Zu verwendende Richtlinie deaktiviert.
languageCode

string

Der BCP-47-Sprachcode zur Auswertung von lokalisierten Feldlabels. Wenn keine Angabe erfolgt, werden Werte in der konfigurierten Standardsprache 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.