Supprimer un libellé d'un fichier

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

Pour supprimer les métadonnées de libellé de fichier d'un fichier, utilisez la files.modifyLabels méthode. Le corps de la requête contient une instance de ModifyLabelsRequest pour modifier l'ensemble de libellés d'un fichier. La requête peut contenir plusieurs modifications qui sont appliquées de manière atomique. Autrement dit, si des modifications ne sont pas valides, la mise à jour échoue et aucune des modifications (potentiellement dépendantes) n'est appliquée.

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

Si l'opération réussit, le corps de la réponse contient les libellés ajoutés ou mis à jour par la requête. Ils existent dans un modifiedLabels objet de type Label.

Exemple

L'exemple de code suivant montre comment utiliser labelId pour supprimer tous les champs associés au libellé à l'aide de fileId. Par exemple, si un libellé contient à la fois des champs de texte et des champs utilisateur, la suppression d'un libellé supprime à la fois les champs de texte et les champs utilisateur associés au libellé. En revanche, si vous supprimez le champ de texte, il est supprimé du libellé, mais le champ utilisateur reste inchangé. Pour en savoir plus, consultez la section Supprimer un champ de libellé sur 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 libellés sur un fichier, utilisez la files.listLabels méthode.
  • FILE_ID : Le fileId du fichier pour lequel les libellés sont modifiés.