Las etiquetas son metadatos que defines para ayudar a los usuarios a organizar, encontrar y aplicar política a los archivos de Google Drive. La API de Drive Labels es una API de RESTful adjunta metadatos a tu unidad de Drive para admitir los procesos empresariales archivos. Estos son los usos comunes de esta API:
Clasificar el contenido para seguir una estrategia de control de la información: Crea una etiqueta para identificar contenido sensible o datos que requieren un manejo especial. Por ejemplo, puedes crear una etiqueta con distintivo (una etiqueta con código de color valores de opción) titulado "Sensibilidad" con los valores de "Secreto absoluto", "Confidencial", y "Público".
Aplica políticas a elementos en Drive: Crea etiquetas para administrar Impulsar el contenido durante todo su ciclo de vida y garantizar que lo cumpla a las prácticas de conservación de registros de tu organización. Por ejemplo, usa etiquetas para administrar una política de pérdida de datos (DLP) con la que los archivos con un estado conjunto de etiquetas a "Secreto absoluto" no se pueden descargar en una computadora.
Seleccionar y encontrar archivos: Crea etiquetas para aumentar la capacidad de búsqueda de tus contenido de la empresa, ya que permite que los miembros de su organización encuentren elementos según las etiquetas y sus campos. Por ejemplo, alguien de tu organización podría usar Opciones de búsqueda de Drive para encontrar todos los contratos pendientes de firma por una fecha específica.
Esta es una lista de términos comunes que se usan en la API de Drive Labels:
- Etiqueta
Metadatos estructurados ubicados en un archivo de Drive Los usuarios de Drive pueden asignar etiquetas y establecer valores de campo de etiqueta para archivos. Las etiquetas constan de lo siguiente:
- Nombre de la etiqueta
- Es el nombre del recurso de la etiqueta. El ID de etiqueta constituye parte del
Nombre de la etiqueta. Según la solicitud, el nombre tiene el siguiente formato:
labels/{id}
olabels/{id}@{revisionId}
. Para obtener más información, consulta Revisión de la etiqueta a continuación. - ID de etiqueta
- Es un identificador único a nivel global para la etiqueta. El ID forma parte del nombre de la etiqueta, pero, a diferencia del nombre, es coherente entre revisiones.
Existen 2 estilos de etiquetas:
- Etiqueta con distintivo
Una etiqueta con un
SelectionOptions
tipo de campo que contenga opciones que pueden tener un código de colores para indicar importancia. Para ello, se debe configurarbadgeConfig
mediante laProperties
de unChoice
Drive muestra el color de la opción elegida para cada archivo para que los usuarios comprendan claramente el estado, la clasificación, etc., del archivo. Por ejemplo, la clave "Secreto" la opción "Sensibilidad" etiqueta con distintivo podría mostrarse en rojo. Solo puedes tener una etiqueta con insignia a la vez.
- Etiqueta estándar
Una etiqueta que contiene cero o más tipos de campo. Una etiqueta estándar podría tener un título de etiqueta, como "Proyecto Moonshot", e indicar todos los archivos relacionadas con el proyecto. Una etiqueta estándar también puede tener varias campos estructurados. Por ejemplo, una etiqueta con el título "Contrato" podría contienen los campos de "Empresa", "Fecha de vencimiento", "Estado" y "Firmantes". Cada campo es de un tipo específico (texto, fecha, selección o usuario).
|
|
- Campo
Un componente individual de tipo y configurable de una etiqueta. Una etiqueta puede tener cero o más campos asociados.
- Tipo de campo
- Es el tipo de datos del valor asociado con el campo. Configurable como
texto, número entero, fecha, usuario o selección. Si configuras el campo con
ListOptions
, puedes configurar los campos de usuario y selección con varias de salida. El tipo elegido afecta a los valores válidos aplicables a Elementos de Drive y opciones de búsqueda disponibles.
- Opción
Una de las varias opciones que un usuario puede elegir en un
SelectionOptions
.- Tipo de etiqueta
Todas las etiquetas incluyen un
LabelType
. Existen 2 tipos de etiquetas:- Administrador
Para crear y editar etiquetas de propiedad del administrador, debes ser una cuenta administrador con el Administrar etiquetas .
Los administradores pueden compartir etiquetas de administrador con cualquier usuario para otorgarle puedan verlos y aplicarlos a elementos de Drive. Modificar o leer los valores de etiquetas en los elementos de Drive requieren los siguientes permisos:
Modificación: Para que un usuario modifique los metadatos de un elemento de Drive relacionado con un etiqueta específica, el usuario debe tener los niveles de permiso adecuados:
- Elemento de Drive:
EDITOR
- Etiqueta:
APPLIER
- Elemento de Drive:
Lectura: Para que un usuario lea o busque metadatos de elementos de Drive relacionada con una etiqueta determinada, el usuario debe tener las de permisos:
- Elemento de Drive:
READER
- Etiqueta:
READER
- Elemento de Drive:
Los usuarios que no son administradores pueden crear etiquetas compartidas que otros pueden aplicar en elementos de Drive. Los equipos pueden crear y organizar sus propias etiquetas para usarlas en el equipo sin la necesidad de un administrador.
- Taxonomía de etiquetas
Los campos de etiquetas configurados actualmente están disponibles para que los usuarios los utilicen para Archivos de Drive También se conoce como esquema de etiquetas.
Ejemplo de taxonomías de etiquetas:
- Sensibilidad: rojo, naranja, amarillo, verde
- Estado: No iniciada, Borrador, En revisión, Final
- Tipo de contenido: contrato, documento de diseño, maqueta
- Departamento: Marketing, Finanzas, Recursos Humanos, Ventas
- Ciclo de vida de las etiquetas
Las etiquetas pasan por un ciclo de vida en el que se crean, publican, actualizan y así sucesivamente. Cuando una etiqueta pasa el ciclo de vida, su revisión de etiqueta es aumentarán. Para obtener más información, consulta Ciclo de vida de las etiquetas.
- Revisión de etiquetas
Una instancia de la etiqueta. Cada vez que se crea, actualiza, publica una etiqueta y dejará de estar disponible, se aumentará la revisión de las etiquetas.
- Revisión de borradores
- El número de revisión de la instancia de borrador actual de la etiqueta. Puedes hacer varias actualizaciones en una etiqueta y cada una incrementa su revisión de borrador sin afectar la revisión publicada. La capacidad de tener Las etiquetas en borrador te permiten probar las actualizaciones de las etiquetas antes de publicarlas.
- Revisión publicada
- Es el número de revisión de la versión publicada de una etiqueta. El sitio publicado label es la instancia de la etiqueta actualmente disponible para los usuarios.
Temas relacionados
Para aprender sobre el desarrollo con APIs de Google Workspace, incluido el manejo autenticación y autorización, consulta Primeros pasos como Google Workspace desarrollador.
Para aprender a configurar y ejecutar una app simple de la API de Labels, prueba la Guía de inicio rápido de Python.