Las propiedades de archivo personalizadas son pares clave-valor que se usan para almacenar metadatos personalizados de un archivo, como etiquetas, ID de otros almacenes de datos, información compartida entre aplicaciones de flujo de trabajo, etcétera.
Si deseas agregar propiedades visibles para todas las apps, usa el campo properties del recurso files. Para agregar propiedades restringidas a tu app, usa el campo appProperties en el recurso files.
Las propiedades también se pueden usar en las expresiones de búsqueda.
Esta es la estructura de una propiedad típica que podría usarse a fin de almacenar el ID de tu base de datos para un archivo de Drive en el archivo.
API de Drive v3
"appProperties": {
"additionalID": "8e8aceg2af2ge72e78",
}
API de Drive v2
{
'key': 'additionalID',
'value': '8e8aceg2af2ge72e78',
'visibility': 'PRIVATE'
}
Las propiedades personalizadas tienen los siguientes límites:
- Se admite un máximo de 100 propiedades personalizadas por archivo en total para todas las fuentes.
- Se permite un máximo de 30 propiedades públicas por archivo, en total desde todas las fuentes.
- Un máximo de 30 propiedades privadas por archivo desde cualquier aplicación
- Tamaño máximo de 124 bytes por string (incluida la clave y el valor) en la codificación UTF-8 Por ejemplo, una propiedad con una clave de diez caracteres solo puede tener 114 caracteres en el valor. Una propiedad que requiere 100 caracteres en el valor puede usar hasta 24 caracteres para la clave.
- Escribir una propiedad de archivo tiene las mismas implicaciones de rendimiento que otras operaciones de escritura.
Para obtener más información, consulta el recurso files.
Cómo acceder a propiedades de archivos personalizados
Estas propiedades solo se pueden recuperar mediante una solicitud autenticada. Una solicitud autenticada usa un token de acceso obtenido con un ID de cliente de OAuth 2. No puedes usar una clave de API para recuperar propiedades privadas.