En esta página, se describe cómo realizar estas tareas relacionadas con las etiquetas:
- Inhabilita una etiqueta
- Habilita una etiqueta
- Borrar una etiqueta
Inhabilita una etiqueta
Si inhabilitas una etiqueta, se creará una nueva revisión publicada inhabilitada según la revisión publicada actual. Si hay una revisión de borrador, se crea una nueva revisión de borrador inhabilitada según la revisión de borrador más reciente. Se borran las revisiones de borradores 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. La etiqueta seguirá apareciendo donde ya se haya aplicado y en los resultados de la búsqueda. Una etiqueta inhabilitada se puede borrar.
Para inhabilitar una etiqueta publicada, usa el método disable en la colección labels.
También debes especificar lo siguiente:
Un recurso de etiqueta que representa cada etiqueta. Contiene un recurso
NameyID, que es un identificador único a nivel global para la etiqueta.useAdminAccessestruepara 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.
Habilita una etiqueta
Si habilitas una etiqueta inhabilitada, esta se restablece a su estado publicado. Se genera una revisión publicada nueva según 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:
Un recurso de etiqueta que representa cada etiqueta. Contiene un recurso
NameyID, que es un identificador único a nivel global para la etiqueta.useAdminAccessestruepara 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.
Borrar una etiqueta
Solo se pueden borrar las etiquetas de borrador y de 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 método delete.
También debes especificar lo siguiente:
Un recurso de etiqueta que representa cada etiqueta. Contiene un recurso
NameyID, que es un identificador único a nivel global para la etiqueta.useAdminAccessestruepara 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 purgan con el tiempo. Para obtener más información, consulta Ciclo de vida de las etiquetas.