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
metodo files.modifyLabels
. Il
corpo della richiesta
contiene un'istanza di
ModifyLabelsRequest
per modificare l'insieme di etichette di un file. La richiesta potrebbe contenere diverse modifiche applicate in modo atomico. ovvero, se una modifica non è
valida, 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 su 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. Questi esistono all'interno di un 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
sia campi di testo che campi utente, la rimozione di un'etichetta elimina sia il testo che i campi utente associati all'etichetta. mentre l'annullamento dell'impostazione del campo di testo lo rimuove
dall'etichetta, ma lascia invariato il campo utente. Per saperne di più, vedi Rimuovere un campo etichetta da 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 metodofiles.listLabels
. - FILE_ID: Il
fileId
del file per cui vengono modificate le etichette.