Labelfeld in einer Datei festlegen

Auf dieser Seite wird beschrieben, wie Sie ein Label festlegen Field pro 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 Festlegung 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, den fieldId, rufen Sie das Label mithilfe der Google Drive Labels API
  • VALUE: Die neue value für dieses Feld.
  • LABEL_ID: Die labelId des zu ändernden Labels.
  • 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 an fieldModifications 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 Fehler 400: Bad Request.
  • Legen Sie den richtigen Werttyp für die ausgewählte Field fest (z. B. Ganzzahl, Text, Nutzer usw.), andernfalls erhalten Sie den Fehler 400: Bad Request. Sie können den Datentyp des Feldes mit der Methode Drive Labels API