En esta página, se describe cómo realizar estas tareas con etiquetas:
- Cómo inhabilitar una etiqueta
- Habilita una etiqueta
- Borrar una etiqueta
Cómo inhabilitar una etiqueta
La inhabilitación de una etiqueta genera una nueva revisión publicada inhabilitada en función de la revisión publicada actual. Si hay una revisión en borrador, se crea una nueva revisión de borrador inhabilitada basada en la revisión de borrador más reciente. Se borran los borradores de revisiones 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 aplicó 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
Name
yID
, que es un identificador único a nivel global para la etiqueta.useAdminAccess
estrue
para usar las credenciales de administrador del usuario. El servidor verifica que el usuario sea un 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 el ID de revisión de la etiqueta se incrementa. 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 volverá a su estado publicado. Da como resultado una nueva revisión publicada basada en la revisión publicada que está inhabilitada actualmente. 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
Name
yID
, que es un identificador único a nivel global para la etiqueta.useAdminAccess
estrue
para usar las credenciales de administrador del usuario. El servidor verifica que el usuario sea un 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 el ID de revisión de la etiqueta se incrementa. Los usuarios pueden ver y aplicar la etiqueta a los archivos mediante la API.
Borrar una etiqueta
Solo se pueden borrar las etiquetas inhabilitadas y en borrador. Cuando se borra una etiqueta, todas las instancias en las que se aplicó anteriormente la etiqueta, incluidos los valores de campo correspondientes ingresados por 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
Name
yID
, que es un identificador único a nivel global para la etiqueta.useAdminAccess
estrue
para usar las credenciales de administrador del usuario. El servidor verifica que el usuario sea un 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 el ID de revisión de la etiqueta se incrementa. 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.