Method: labels.publish

Alle Entwurfsänderungen unter dem Label veröffentlichen Nach der Veröffentlichung kann das Label nicht mehr in den Entwurfsstatus zurückversetzt werden. Weitere Informationen findest du unter google.apps.drive.labels.v2.Lifecycle.

Das Veröffentlichen eines Labels führt zu einer neuen veröffentlichten Version. Alle vorherigen Entwürfe werden gelöscht. Zuvor veröffentlichte Versionen bleiben erhalten, werden aber bei Bedarf automatisch gelöscht.

Nach der Veröffentlichung sind einige Änderungen nicht mehr zulässig. Grundsätzlich wird jede Änderung abgelehnt, die bestehende Metadaten in Bezug auf das Label ungültig macht oder neue Einschränkungen verursacht. Beispielsweise werden die folgenden Änderungen an einem Label nach der Veröffentlichung des Labels abgelehnt: * Das Label kann nicht direkt gelöscht werden. Sie muss zuerst deaktiviert und dann gelöscht werden. * „Field.FieldType“ kann nicht geändert werden. * Durch Änderungen an den Optionen für die Feldvalidierung können zuvor akzeptierte Elemente nicht abgelehnt werden. * Die maximale Anzahl von Einträgen wird reduziert.

HTTP-Anfrage

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

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 
{
  "useAdminAccess": boolean,
  "writeControl": {
    object (WriteControl)
  },
  "languageCode": string
}
Felder
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.
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.