Rimuovere un'etichetta da un file

Questa pagina descrive come rimuovere un'etichetta da un singolo file di Google Drive.

Per rimuovere i metadati delle etichette dei file da un file, utilizza il metodo files.modifyLabels. Il corpo della richiesta contiene un'istanza di ModifyLabelsRequest per modificare l'insieme di etichette in un file. La richiesta potrebbe contenere diverse modifiche applicate in modo atomico. In altre parole, se le modifiche non sono valide, l'intero aggiornamento non va a buon fine e nessuna delle modifiche (potenzialmente dipendenti) viene applicata.

ModifyLabelsRequest contiene un'istanza di LabelModification che è una modifica a un'etichetta in un file. Potrebbe anche contenere un'istanza di FieldModification, che è una modifica al campo di un'etichetta. Per rimuovere l'etichetta dal file, imposta FieldModification.removeLabel su True.

In caso di esito positivo, il corpo della risposta contiene le etichette aggiunte o aggiornate dalla richiesta. Esistono all'interno di un oggetto modifiedLabels di tipo Label.

Esempio

L'esempio di codice seguente mostra come utilizzare labelId per rimuovere tutti i campi associati all'etichetta utilizzando fileId. Ad esempio, se un'etichetta contiene sia campi di testo che campi utente, la rimozione di un'etichetta comporta l'eliminazione di entrambi i campi di testo e utente associati all'etichetta. Se invece imposti il campo di testo su un valore vuoto, questo viene rimosso dall'etichetta, ma il campo utente rimane invariato. Per ulteriori informazioni, vedi Reimpostare un campo dell'etichetta in un file.

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;
  }

Sostituisci quanto segue:

  • LABEL_ID: il labelId dell'etichetta da modificare. Per individuare le etichette in un file, utilizza il metodo files.listLabels.
  • FILE_ID: il fileId del file per cui vengono modificate le etichette.