Cómo inhabilitar, habilitar y borrar una etiqueta

En esta página, se describe cómo realizar las siguientes tareas relacionadas con las etiquetas:

• Cómo inhabilitar una etiqueta
• Cómo habilitar una etiqueta
• Cómo borrar una etiqueta

Cómo inhabilitar una etiqueta

Si inhabilitas una etiqueta, se generará una nueva revisión publicada inhabilitada basada en la revisión publicada actual. Si hay una revisión en borrador, se crea una nueva revisión en borrador inhabilitada basada en la revisión en borrador más reciente. Se borran las revisiones de borrador más antiguas. Para obtener más información, consulta Ciclo de vida de las etiquetas.

Una vez inhabilitada, los usuarios podrán seguir aplicando esta etiqueta a través de la API. La etiqueta seguirá apareciendo donde ya se haya aplicado y en los resultados de la búsqueda. Se puede borrar una etiqueta inhabilitada.

Para inhabilitar una etiqueta publicada, usa el método disable en la colección labels.

También debes especificar lo siguiente:

• Es un recurso Label que representa cada etiqueta. Contiene un recurso Name y ID, que es un identificador único a nivel global para la etiqueta.

• useAdminAccess es true para usar las credenciales de administrador del usuario. El servidor verifica que el usuario sea administrador de la etiqueta antes de permitir el acceso.

En este ejemplo, se usa ID para inhabilitar la etiqueta correcta.

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);
});

La etiqueta tiene el State de DISABLED y se incrementa el ID de revisión de la etiqueta. Los usuarios pueden aplicar la etiqueta a través de la API. Sin embargo, no se muestra una etiqueta inhabilitada en una IU, a menos que se configure la propiedad showInApply del método disabledPolicy.

Cómo habilitar una etiqueta

Habilitar una etiqueta inhabilitada la restablece a su estado publicado. Se genera una nueva revisión publicada basada en la revisión publicada inhabilitada actual. Si hay una revisión de borrador inhabilitada existente, se crea una revisión nueva basada en ese borrador y se habilita. Para obtener más información, consulta Ciclo de vida de las etiquetas.

Para habilitar una etiqueta inhabilitada, usa el método enable.

También debes especificar lo siguiente:

• Es un recurso Label que representa cada etiqueta. Contiene un recurso Name y ID, que es un identificador único a nivel global para la etiqueta.

• useAdminAccess es true para usar las credenciales de administrador del usuario. El servidor verifica que el usuario sea administrador de la etiqueta antes de permitir el acceso.

En este ejemplo, se usa ID para habilitar la etiqueta correcta.

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);
});

La etiqueta tiene el State de PUBLISHED y se incrementa el ID de revisión de la etiqueta. Los usuarios pueden ver y aplicar la etiqueta a los archivos a través de la API.

Cómo borrar una etiqueta

Solo se pueden borrar las etiquetas en borrador y las inhabilitadas. Cuando se borra una etiqueta, se borran de forma permanente todas las instancias en las que se aplicó anteriormente, incluidos los valores de campo correspondientes que ingresaron los usuarios, y se quitan de esos archivos de Drive.

Para borrar una etiqueta, primero debes inhabilitarla y, luego, usar el método delete.

También debes especificar lo siguiente:

• Es un recurso Label que representa cada etiqueta. Contiene un recurso Name y ID, que es un identificador único a nivel global para la etiqueta.

• useAdminAccess es true para usar las credenciales de administrador del usuario. El servidor verifica que el usuario sea administrador de la etiqueta antes de permitir el acceso.

En este ejemplo, se usa ID para borrar la etiqueta correcta.

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);
});

La etiqueta tiene el State de DELETED y se incrementa el ID de revisión de la etiqueta. La etiqueta no se puede aplicar y las etiquetas borradas se quitan de forma definitiva. Para obtener más información, consulta Ciclo de vida de las etiquetas.