Cómo inhabilitar, habilitar y borrar una etiqueta

En este documento, se describe cómo realizar estas tareas relacionadas con las etiquetas:

  • Inhabilitar una etiqueta
  • Habilitar una etiqueta
  • Cómo borrar una etiqueta

Inhabilitar una etiqueta

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

Una vez inhabilitada, los usuarios aún pueden aplicar esta etiqueta a través de la API de Google Drive Labels. La etiqueta aún aparece donde ya se aplicó y en los resultados de la búsqueda. Se puede borrar una etiqueta inhabilitada.

Para inhabilitar una etiqueta publicada, usa el disable método en el recurso labels.

También debes especificar lo siguiente:

  • Un recurso labels que representa la etiqueta. Contiene un name y un id, que es un identificador único a nivel global para la etiqueta.

  • El parámetro de consulta useAdminAccess se establece en true para usar las credenciales de administrador del usuario. Antes de permitir el acceso, el servidor verifica que el usuario tenga los privilegios de administrador de Manage Classification Labels requeridos.

En la siguiente muestra de código, se muestra cómo usar el id de la etiqueta para inhabilitar la etiqueta correcta:

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

Reemplaza ID por el ID de la etiqueta que se inhabilitará.

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 de Drive Labels. Sin embargo, una etiqueta inhabilitada no se muestra en una IU, a menos que se configure el campo el showInApply del objeto DisabledPolicy.

Habilitar una etiqueta

Cuando se habilita una etiqueta inhabilitada, se restablece a su estado publicado. Esto 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 nueva revisión 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 enable método en el labels recurso.

También debes especificar lo siguiente:

  • Un recurso labels que representa la etiqueta. Contiene un name y un id, que es un identificador único a nivel global para la etiqueta.

  • El parámetro de consulta useAdminAccess se establece en true para usar las credenciales de administrador del usuario. Antes de permitir el acceso, el servidor verifica que el usuario tenga los privilegios de administrador de Manage Classification Labels requeridos.

En la siguiente muestra de código, se muestra cómo usar el id de la etiqueta para habilitar la etiqueta correcta:

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

Reemplaza ID por el ID de la etiqueta que se habilitará.

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 de Drive Labels.

Cómo borrar una etiqueta

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

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

También debes especificar lo siguiente:

  • Un recurso labels que representa la etiqueta. Contiene un name y un id, que es un identificador único a nivel global para la etiqueta.

  • El parámetro de consulta useAdminAccess se establece en true para usar las credenciales de administrador del usuario. Antes de permitir el acceso, el servidor verifica que el usuario tenga los privilegios de administrador de Manage Classification Labels requeridos.

En la siguiente muestra de código, se muestra cómo usar el id de la etiqueta para borrar la etiqueta correcta:

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

Reemplaza ID por el ID de la etiqueta que se borrará.

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 borran definitivamente. Para obtener más información, consulta Ciclo de vida de las etiquetas.