- HTTP-Anfrage
- Pfadparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- ModifyLabelsRequest
- LabelModification
- FieldModification
- Testen!
Ä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/v3/files/{fileId}/modifyLabels
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
fileId |
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 ( |
Felder | |
---|---|
modifiedLabels[] |
Die Liste der Labels, die durch die Anfrage hinzugefügt oder aktualisiert wurden. |
kind |
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 ( |
Felder | |
---|---|
labelModifications[] |
Die Liste der Änderungen, die auf die Labels in der Datei angewendet werden sollen. |
kind |
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 ( |
Felder | |
---|---|
labelId |
Die ID des Labels, das geändert werden soll. |
fieldModifications[] |
Die Liste der Änderungen an den Feldern dieses Labels. |
removeLabel |
Bei „true“ wird das Label aus der Datei entfernt. |
kind |
Das ist immer „drive#labelÄnderung“. |
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 |
Die ID des Felds, das geändert werden soll. |
kind |
Das ist immer „drive#labelFieldModify“. |
setDateValues[] |
Ersetzt den Wert eines |
setTextValues[] |
Legt den Wert eines |
setSelectionValues[] |
Ersetzt das Feld |
setIntegerValues[] |
Ersetzt den Wert eines |
setUserValues[] |
Ersetzt das Feld |
unsetValues |
Hebt die Festlegung der Werte für dieses Feld auf. |