Disattivare, attivare ed eliminare un'etichetta

In questa pagina viene descritto come eseguire queste attività con le etichette:

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

Disattivare un'etichetta

La disabilitazione di un'etichetta comporta una nuova revisione pubblicata disattivata in base alla revisione pubblicata corrente. Se è presente una revisione della bozza, viene creata una nuova revisione della bozza disattivata in base all'ultima revisione della bozza. Le bozze delle revisioni meno recenti vengono eliminate. Per ulteriori informazioni, vedi 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à applicata e nei risultati di ricerca. Un'etichetta disabilitata 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.

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 State pari a DISABLED e l'ID revisione dell'etichetta viene incrementato. Gli utenti possono applicare l'etichetta tramite l'API. Tuttavia, un'etichetta disabilitata non viene mostrata in una UI a meno che non sia configurata la proprietà showInApply del metodo disabledPolicy.

Attivare un'etichetta

Se abiliti un'etichetta disattivata, verrà ripristinata allo stato di pubblicazione. Ne deriva una nuova revisione pubblicata in base alla revisione pubblicata attualmente disabilitata. Se è già presente una revisione della bozza disabilitata esistente, viene creata una nuova revisione in base a questa bozza, che viene abilitata. Per ulteriori informazioni, vedi Ciclo di vita delle etichette.

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.

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 State pari a 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 in stato di bozza e quelle disattivate. Quando un'etichetta viene eliminata, tutte le istanze in cui era stata applicata in precedenza, inclusi i valori del campo corrispondenti inseriti dagli utenti, vengono eliminate definitivamente e rimosse dai file di Drive.

Per eliminare un'etichetta, devi prima disabilitarla 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.

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 State pari a DELETED e l'ID revisione dell'etichetta viene incrementato. L'etichetta non può essere applicata e le etichette eliminate verranno eliminate definitivamente. Per maggiori informazioni, vedi Ciclo di vita delle etichette.