Rimuovere un'etichetta da un file

In questa pagina viene descritto come rimuovere un'etichetta da un singolo file di Google Drive.

Per rimuovere i metadati dell'etichetta da un file, utilizza la classe files.modifyLabels. La corpo della richiesta contiene un'istanza di ModifyLabelsRequest: per modificare l'insieme di etichette in un file. La richiesta può contenere diversi modifiche applicate a livello atomico. Vale a dire se eventuali modifiche non valida, l'intero aggiornamento non andrà a buon fine e nessuno dei problemi (potenzialmente dipendenti) vengono applicate.

ModifyLabelsRequest contiene un'istanza di LabelModification ovvero la modifica di un'etichetta in un file. Potrebbe anche contenere un'istanza di FieldModification ovvero una modifica al campo di un'etichetta. Per rimuovere l'etichetta dal file: imposta FieldModification.removeLabel su True.

Se l'esito è positivo, la risposta body contiene le etichette aggiunte o aggiornate dalla richiesta. Questi si trovano all'interno di Oggetto modifiedLabels di tipo Label.

Esempio

Il seguente esempio di codice mostra come utilizzare labelId per rimuovere tutti i campi associati all'etichetta utilizzando fileId. Ad esempio, se un'etichetta contiene campi di testo e utente, la rimozione di un'etichetta elimina sia il testo sia l'utente campi associati all'etichetta. Se annulli l'impostazione del campo di testo, questo viene rimosso dall'etichetta, ma lascia invariato il campo utente. Per ulteriori informazioni, vedi Annulla l'impostazione di un campo di 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: labelId dell'etichetta da modificare. Per individuare le etichette di un file, utilizza files.listLabels.
  • FILE_ID: i valori fileId del file per cui si trovano le etichette modificato.