Disattivare, attivare ed eliminare un'etichetta

Questa pagina descrive come eseguire le seguenti attività che coinvolgono le etichette:

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

Disattivare un'etichetta

La disattivazione di un'etichetta comporta la pubblicazione di una nuova revisione disattivata basata sulla revisione pubblicata corrente. Se esiste una revisione bozza, viene creata una nuova revisione bozza disattivata in base all'ultima revisione bozza. Le revisioni precedenti della bozza vengono eliminate. Per maggiori informazioni, consulta la sezione Ciclo di vita dell'etichetta.

Una volta disattivata, gli utenti possono comunque applicare questa etichetta tramite l'API. L'etichetta continua a essere visualizzata dove è già stata applicata e nei risultati di ricerca. Un'etichetta disattivata può essere eliminata.

Per disattivare un'etichetta pubblicata, utilizza il metodo disable nella raccolta labels.

Devi inoltre specificare:

  • Una risorsa Etichetta che rappresenta ogni etichetta. Contiene una risorsa Name e ID, che è un identificatore univoco globale per l'etichetta.

  • useAdminAccess è true per utilizzare le credenziali di amministratore dell'utente. Il server verifica che l'utente sia un amministratore dell'etichetta prima di consentire l'accesso.

Questo esempio utilizza ID per disattivare l'etichetta corretta.

Python

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

Node.js

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

L'etichetta ha il State di DISABLED e l'ID revisione dell'etichetta viene incrementato. Gli utenti possono applicare l'etichetta tramite l'API. Tuttavia, un'etichetta disattivata non viene visualizzata in un'interfaccia utente a meno che non sia configurata la proprietà showInApply del metodo disabledPolicy.

Attivare un'etichetta

L'attivazione di un'etichetta disattivata la ripristina allo stato pubblicato. Viene creata una nuova revisione pubblicata basata sulla revisione pubblicata disattivata corrente. Se esiste una revisione della bozza disabilitata, viene creata una nuova revisione basata su quella bozza e viene abilitata. Per maggiori informazioni, consulta la sezione Ciclo di vita dell'etichetta.

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

Devi inoltre specificare:

  • Una risorsa Etichetta che rappresenta ogni etichetta. Contiene una risorsa Name e ID, che è un identificatore univoco globale per l'etichetta.

  • useAdminAccess è true per utilizzare le credenziali di amministratore dell'utente. Il server verifica che l'utente sia un amministratore dell'etichetta prima di consentire l'accesso.

Questo esempio utilizza ID per attivare l'etichetta corretta.

Python

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

Node.js

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

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

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 metodo delete.

Devi inoltre specificare:

  • Una risorsa Etichetta che rappresenta ogni etichetta. Contiene una risorsa Name e ID, che è un identificatore univoco globale per l'etichetta.

  • useAdminAccess è true per utilizzare le credenziali di amministratore dell'utente. Il server verifica che l'utente sia un amministratore dell'etichetta prima di consentire l'accesso.

Questo esempio utilizza ID per eliminare l'etichetta corretta.

Python

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

Node.js

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

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