Disattivare, attivare ed eliminare un'etichetta

Questo documento descrive come eseguire queste attività che riguardano le etichette:

• Disattivare un'etichetta
• Attivare un'etichetta
• Eliminare un'etichetta

Disattivare un'etichetta

La disattivazione di un'etichetta comporta la creazione di una nuova revisione pubblicata disattivata basata sulla revisione pubblicata corrente. Se è presente una revisione bozza, viene creata una nuova revisione bozza disattivata basata sull'ultima revisione bozza. Le revisioni bozza precedenti vengono eliminate. Per maggiori informazioni, consulta Ciclo di vita delle etichette.

Una volta disattivate, gli utenti possono comunque applicare queste etichette tramite l'API Google Drive Labels. L'etichetta viene comunque visualizzata dove è già stata applicata e nei risultati di ricerca. Un'etichetta disattivata può essere eliminata.

Per disattivare un'etichetta pubblicata, utilizza il disable metodo sulla risorsa labels.

Devi anche specificare:

• Una risorsa labels che rappresenta l'etichetta. Contiene un name e un id, che è un identificatore univoco globale per l'etichetta.

• Il parametro di query useAdminAccess è impostato su true per utilizzare le credenziali di amministratore dell'utente. Prima di consentire l'accesso, il server verifica che l'utente disponga di i privilegi di amministratore Gestisci classificazione Etichette richiesti.

Il seguente esempio di codice mostra come utilizzare l'id dell'etichetta per disattivare l'etichetta corretta:

Python

service.labels().disable(
    name='labels/ID',
    body={
        'useAdminAccess': True
    }
).execute()

Node.js

service.labels.disable({
  name: 'labels/ID',
  requestBody: {
    useAdminAccess: true
  }
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

Sostituisci ID con l'ID dell'etichetta da disattivare.

L'etichetta ha lo State di DISABLED e l'ID di revisione dell'etichetta viene incrementato. Gli utenti possono applicare l'etichetta tramite l'API Drive Labels. Tuttavia, un'etichetta disattivata non viene visualizzata in un'interfaccia utente a meno che non sia configurato il campo showInApply dell'oggetto DisabledPolicy.

Attivare un'etichetta

L'attivazione di un'etichetta disattivata ne ripristina lo stato pubblicato. Comporta la creazione di una nuova revisione pubblicata basata sulla revisione pubblicata disattivata corrente. Se esiste una revisione bozza disattivata, viene creata una nuova revisione basata su quella bozza e viene attivata. Per maggiori informazioni, consulta Ciclo di vita delle etichette.

Per attivare un'etichetta disattivata, utilizza il enable metodo sulla risorsa labels.

Devi anche specificare:

• Una risorsa labels che rappresenta l'etichetta. Contiene un name e un id, che è un identificatore univoco globale per l'etichetta.

• Il parametro di query useAdminAccess è impostato su true per utilizzare le credenziali di amministratore dell'utente. Prima di consentire l'accesso, il server verifica che l'utente disponga di i privilegi di amministratore Gestisci classificazione Etichette richiesti.

Il seguente esempio di codice mostra come utilizzare l'id dell'etichetta per attivare l'etichetta corretta:

Python

service.labels().enable(
    name='labels/ID',
    body={
        'useAdminAccess': True
    }
).execute()

Node.js

service.labels.enable({
  name: 'labels/ID',
  requestBody: {
    useAdminAccess: true
  }
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

Sostituisci ID con l'ID dell'etichetta da attivare.

L'etichetta ha lo State di PUBLISHED e l'ID di revisione dell'etichetta viene incrementato. Gli utenti possono visualizzare e applicare l'etichetta ai file tramite l'API Drive Labels.

Eliminare un'etichetta

È possibile eliminare solo le etichette bozza e disattivate. Quando un'etichetta viene eliminata, tutte le istanze in cui era stata applicata in precedenza, inclusi gli eventuali valori di campo corrispondenti inseriti dagli utenti, vengono eliminate definitivamente e rimosse dai file di Drive.

Per eliminare un'etichetta, devi prima disattivarla e poi utilizzare il delete metodo sulla risorsa labels.

Devi anche specificare:

• Una risorsa labels che rappresenta l'etichetta. Contiene un name e un id, che è un identificatore univoco globale per l'etichetta.

• Il parametro di query useAdminAccess è impostato su true per utilizzare le credenziali di amministratore dell'utente. Prima di consentire l'accesso, il server verifica che l'utente disponga di i privilegi di amministratore Gestisci classificazione Etichette richiesti.

Il seguente esempio di codice mostra come utilizzare l'id dell'etichetta per eliminare l'etichetta corretta:

Python

response = service.labels().delete(
    name='labels/ID',
    useAdminAccess=True
).execute()

Node.js

service.labels.delete({
  name: 'labels/ID',
  useAdminAccess: true
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

Sostituisci ID con l'ID dell'etichetta da eliminare.

L'etichetta ha lo State di DELETED e l'ID di revisione dell'etichetta viene incrementato. L'etichetta non può essere applicata e le etichette eliminate vengono eliminate definitivamente. Per maggiori informazioni, consulta Ciclo di vita delle etichette.