Rimuovere un'etichetta da un file

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

Per rimuovere i metadati dell'etichetta del file da un file, utilizza il files.modifyLabels metodo. Il corpo della richiesta contiene un'istanza di ModifyLabelsRequest per modificare l'insieme di etichette su un file. La richiesta potrebbe contenere diverse modifiche applicate in modo atomico. Ciò significa che, se una delle modifiche non è valida, l'intero aggiornamento non va a buon fine e non viene applicata nessuna delle modifiche (potenzialmente dipendenti).

Il ModifyLabelsRequest contiene un'istanza di LabelModification ovvero una modifica a un'etichetta su un file. Potrebbe contenere anche un'istanza di FieldModification , ovvero 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. Queste esistono all'interno di un modifiedLabels oggetto 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 sia campi di testo sia campi utente, la rimozione di un'etichetta elimina sia i campi di testo sia i campi utente associati all'etichetta. Al contrario, l'annullamento dell'impostazione del campo di testo lo rimuove dall'etichetta, ma lascia invariato il campo utente. Per saperne di più, consulta Annullare l'impostazione di un campo etichetta su 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 su un file, utilizza il files.listLabels metodo.
• FILE_ID: il fileId del file per il quale vengono modificate le etichette.