Method: files.modifyLabels

Ändert die Gruppe von 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. Dieser 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 für Ihre App, damit sie verwendet werden können. Weitere Informationen finden Sie im Autorisierungsleitfaden.

ModifyLabelsRequest

Ein Request zum Ändern der Labels für eine 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 an einem Label für eine Datei. Mit einem LabelModification-Vorgang kann ein Label auf eine Datei angewendet, ein vorhandenes Label für eine Datei aktualisiert oder ein Label aus einer Datei entfernt werden.

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

object (FieldModification)

Die Liste der Änderungen an den Feldern dieses Labels.
labelId

string

Die ID des zu ändernden Labels.
removeLabel

boolean

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

string

Dies ist immer drive#labelModification.

FieldModification

Eine Änderung an einem Feld eines Labels.

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

string

Ersetzt den Wert eines date-Felds durch diese neuen Werte. Der String muss im RFC 3339-Format für vollständige Datumsangaben angegeben werden: JJJJ-MM-TT.
setTextValues[]

string

Legt den Wert eines text-Felds fest.
setSelectionValues[]

string

Ersetzt ein selection-Feld durch diese neuen Werte.
setIntegerValues[]

string (int64 format)

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

string

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

string

Die ID des zu ändernden Felds.
kind

string

Dies ist immer drive#labelFieldModification.
unsetValues

boolean

Entfernt die Werte für dieses Feld.