Auf dieser Seite wird beschrieben, wie Sie ein Label festlegen
Field
pro Person
Google Drive-Datei.
Um einer Datei Metadaten hinzuzufügen, indem Sie ein Dateilabel festlegen, verwenden Sie die
files.modifyLabels
-Methode. Die
Anfragetext
enthält eine Instanz von
ModifyLabelsRequest
um den Satz von Labels für eine Datei zu ändern. Die Anfrage kann mehrere
Änderungen, die in kleinstmöglichen Schritten angewendet werden. Das heißt, wenn Änderungen nicht
gültig ist, ist das gesamte Update fehlgeschlagen und keine der (potenziell
Änderungen angewendet werden.
ModifyLabelsRequest
enthält eine Instanz von
LabelModification
eine Änderung eines Labels in einer Datei. Es kann auch eine -Instanz enthalten,
von
FieldModification
eine Änderung am Feld eines Labels.
Bei Erfolg wird die -Antwort
Text enthält
die von der Anfrage hinzugefügten oder aktualisierten Labels. Diese befinden sich in einem
modifiedLabels
-Objekt vom Typ Label
.
Beispiel
Das folgende Codebeispiel zeigt, wie Sie mit der Funktion fieldId
eines Textfelds
einen Wert für dieses Field
auf einem
-Datei. Wenn das Label Field
anfänglich für eine Datei festgelegt ist, wird das Label auf
in der Datei. Sie können dann die Festlegung eines einzelnen Felds aufheben oder alle Felder entfernen, die mit
Label hinzufügen. Weitere Informationen finden Sie unter Festlegen eines Labelfelds auf einem
Datei und Entfernen eines Labels aus einem
Datei.
Java
LabelFieldModification fieldModification =
new LabelFieldModification().setFieldId("FIELD_ID").setSetTextValues(ImmutableList.of("VALUE"));
ModifyLabelsRequest modifyLabelsRequest =
new ModifyLabelsRequest()
.setLabelModifications(
ImmutableList.of(
new LabelModification()
.setLabelId("LABEL_ID")
.setFieldModifications(ImmutableList.of(fieldModification))));
ModifyLabelsResponse modifyLabelsResponse = driveService.files().modifyLabels("FILE_ID", modifyLabelsRequest).execute();
Python
field_modification = {'fieldId':'FIELD_ID','setTextValues':['VALUE']}
label_modification = {'labelId':'LABEL_ID', 'fieldModifications':[field_modification]}
modified_labels = drive_service.files().modifyLabels(fileId="FILE_ID", body = {'labelModifications' : [label_modification]}).execute()
Node.js
/**
* Set a label with a text field on a Drive file
* @return{obj} updated label data
**/
async function setLabelTextField() {
// Get credentials and build service
// TODO (developer) - Use appropriate auth mechanism for your app
const {GoogleAuth} = require('google-auth-library');
const {google} = require('googleapis');
const auth = new GoogleAuth({scopes: 'https://www.googleapis.com/auth/drive'});
const service = google.drive({version: 'v3', auth});
const fieldModification = {
'fieldId': 'FIELD_ID',
'setTextValues': ['VALUE'],
};
const labelModification = {
'labelId': 'LABEL_ID',
'fieldModifications': [fieldModification],
};
const labelModificationRequest = {
'labelModifications': [labelModification],
};
try {
const updateResponse = await service.files.modifyLabels({
fileId: 'FILE_ID',
resource: labelModificationRequest,
});
return updateResponse;
} catch (err) {
// TODO (developer) - Handle error
throw err;
}
}
Ersetzen Sie Folgendes:
- FIELD_ID: Die
fieldId
des Felds, das geändert werden soll. Um zu finden, denfieldId
, rufen Sie das Label mithilfe der Google Drive Labels API - VALUE: Die neue
value
für dieses Feld. - LABEL_ID: Die
labelId
des Labels, das geändert werden soll. - FILE_ID: Der
fileId
der Datei, für die die Labels verwendet werden. geändert.
Hinweise
- Wenn Sie ein Label ohne Felder festlegen möchten, wenden Sie
labelModifications
ohne Felder anfieldModifications
anwesend. - Verwenden Sie zum Festlegen von Werten für Auswahlfeldoptionen die Methode
Choice
-ID des Werts die Sie erhalten, indem Sie das Label-Schema im Drive Labels API. - Nur für eine
Field
, die Listen von Werten unterstützt, können mehrere Werte festgelegt werden. Andernfalls erhalten Sie den Fehler400: Bad Request
. - Legen Sie den richtigen Werttyp für die ausgewählte
Field
fest (z. B. Ganzzahl, Text, Nutzer usw.), andernfalls erhalten Sie den Fehler400: Bad Request
. Sie können den Felddatentyp mit der Drive Labels API