Supprimer un libellé d'un fichier

Cette page explique comment supprimer un libellé dans un seul fichier Google Drive.

Pour supprimer les métadonnées de libellé de fichier d'un fichier, utilisez la méthode files.modifyLabels. La corps de la requête contient une instance de ModifyLabelsRequest pour modifier l'ensemble d'étiquettes d'un fichier. La requête peut contenir plusieurs des modifications appliquées de manière atomique. Autrement dit, si des modifications est valide, cela signifie que la mise à jour échoue dans son intégralité et qu'aucune dépendantes) sont appliquées.

Le ModifyLabelsRequest contient une instance de LabelModification qui est une modification d'un libellé dans un fichier. Il peut également contenir une instance de FieldModification qui est une modification du champ d'un libellé. Pour supprimer le libellé du fichier, définissez FieldModification.removeLabel sur True.

Si l'opération réussit, la réponse corps contient les étiquettes ajoutées ou mises à jour par la requête. Celles-ci existent dans un Objet modifiedLabels de type Label.

Exemple

L'exemple de code suivant montre comment utiliser labelId pour supprimer tous les champs associé au libellé à l'aide de fileId. Par exemple, si une étiquette contient à la fois des champs de texte et des champs utilisateur, la suppression d'un libellé entraîne la suppression à la fois du texte et de l'utilisateur associés au libellé. La réinitialisation du champ de texte le supprime du libellé sans modifier le champ de l'utilisateur. Pour en savoir plus, consultez Non défini dans un champ de libellé dans un fichier.

Java

ModifyLabelsRequest modifyLabelsRequest =
  new ModifyLabelsRequest()
      .setLabelModifications(
          ImmutableList.of(
              new LabelModification()
                .setLabelId("LABEL_ID")
                .setRemoveLabel(true)));

ModifyLabelsResponse modifyLabelsResponse = driveService.files().modifyLabels("FILE_ID", modifyLabelsRequest).execute();

Python

label_modification = {'labelId':'LABEL_ID', 'removeLabel': True]}

modified_labels = drive_service.files().modifyLabels(fileId="FILE_ID", body = {'labelModifications' : [label_modification]}).execute();

Node.js

/**
* Remove a label on a Drive file
* @return{obj} updated label data
**/
async function removeLabel() {
  // 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 labelModification = {
    'labelId': 'LABEL_ID',
    'removeLabel': True,
  };
  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;
  }

Remplacez les éléments suivants :

  • LABEL_ID: labelId du libellé à modifier. Pour localiser les étiquettes d'un fichier, utilisez la files.listLabels.
  • FILE_ID: le fileId du fichier pour lequel les libellés sont modifiées.