Disattivare, attivare ed eliminare un'etichetta

Questa pagina descrive come eseguire le seguenti attività relative alle 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 in base alla revisione pubblicata corrente. Se esiste una revisione della bozza, viene creata una nuova revisione della bozza disattivata in base all'ultima revisione della bozza. Le revisioni delle bozze precedenti vengono eliminate. Per ulteriori informazioni, consulta la sezione Ciclo di vita delle etichette.

Una volta disattivata, gli utenti possono comunque applicare questa etichetta tramite l'API. L'etichetta continuerà 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 anche 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.

In questo esempio viene utilizzato 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 ne ripristina lo stato pubblicato. Il risultato è una nuova revisione pubblicata basata sulla revisione pubblicata attualmente disattivata. Se esiste già una revisione della bozza disattivata, viene creata una nuova revisione in base a quella bozza e viene attivata. Per ulteriori informazioni, consulta la sezione Ciclo di vita delle etichette.

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

Devi anche 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.

In questo esempio viene utilizzato 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 di 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 anche 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.

In questo esempio viene utilizzato 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 ulteriori informazioni, consulta la sezione Ciclo di vita delle etichette.