Method: files.modifyLabels

Ändert die Labels, die auf eine Datei angewendet werden. Gibt eine Liste der Labels zurück, die hinzugefügt oder geändert wurden.

HTTP-Anfrage

POST https://www.googleapis.com/drive/v2/files/{fileId}/modifyLabels

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
fileId

string

Die ID der Datei, zu der die Labels gehören.

Anfragetext

Der Anfragetext enthält eine Instanz von ModifyLabelsRequest.

Antworttext

Antwort auf eine files.modifyLabels-Anfrage. Sie enthält nur die Labels, die durch die Anfrage hinzugefügt oder aktualisiert wurden.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung
{
  "modifiedLabels": [
    {
      object (Label)
    }
  ],
  "kind": string
}
Felder
modifiedLabels[]

object (Label)

Die Liste der Labels, die durch die Anfrage hinzugefügt oder aktualisiert wurden.

kind

string

Dies ist immer drive#modifyLabelsResponse

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata

Einige Bereiche sind eingeschränkt und erfordern eine Sicherheitsprüfung, damit Ihre App sie verwenden kann. Weitere Informationen finden Sie im Leitfaden zur Autorisierung.

ModifyLabelsRequest

Ein Request zum Ändern der Labels einer Datei. Diese Anfrage kann viele Änderungen enthalten, die entweder alle erfolgreich sind oder alle atomar fehlschlagen.

JSON-Darstellung
{
  "labelModifications": [
    {
      object (LabelModification)
    }
  ],
  "kind": string
}
Felder
labelModifications[]

object (LabelModification)

Die Liste der Änderungen, die auf die Labels in der Datei angewendet werden sollen.

kind

string

Dies ist immer drive#modifyLabelsRequest.

LabelModification

Eine Änderung eines Labels in einer Datei. Mit LabelApproval können Sie ein Label auf eine Datei anwenden, ein vorhandenes Label aktualisieren oder aus einer Datei entfernen.

JSON-Darstellung
{
  "labelId": string,
  "fieldModifications": [
    {
      object (FieldModification)
    }
  ],
  "removeLabel": boolean,
  "kind": string
}
Felder
labelId

string

Die ID des Labels, das geändert werden soll.

fieldModifications[]

object (FieldModification)

Die Liste der Änderungen an den Feldern dieses Labels.

removeLabel

boolean

Bei „true“ wird das Label aus der Datei entfernt.

kind

string

Dies ist immer drive#labelModification.

FieldModification

Eine Änderung am Feld eines Labels.

JSON-Darstellung
{
  "fieldId": string,
  "kind": string,
  "setDateValues": [
    string
  ],
  "setTextValues": [
    string
  ],
  "setSelectionValues": [
    string
  ],
  "setIntegerValues": [
    string
  ],
  "setUserValues": [
    string
  ],
  "unsetValues": boolean
}
Felder
fieldId

string

Die ID des Felds, das geändert werden soll.

kind

string

Dies ist immer drive#labelFieldModification.

setDateValues[]

string

Ersetzt den Wert eines date-Felds durch diese neuen Werte. Der String muss im vollständigen RFC 3339-Format vorliegen: JJJJ-MM-TT.

setTextValues[]

string

Legt den Wert eines text-Felds fest.

setSelectionValues[]

string

Ersetzt das Feld selection durch diese neuen Werte.

setIntegerValues[]

string (int64 format)

Ersetzt den Wert eines integer-Felds durch diese neuen Werte.

setUserValues[]

string

Ersetzt das Feld user durch diese neuen Werte. Die Werte müssen gültige E-Mail-Adressen sein.

unsetValues

boolean

Hebt die Festlegung der Werte für dieses Feld auf.