Las propiedades de archivos personalizadas son pares clave-valor que se usan para almacenar metadatos personalizados para un archivo de Google Drive (como etiquetas), IDs de otros almacenes de datos, información compartida entre aplicaciones de flujo de trabajo, etcétera. Por ejemplo, puedes agregar propiedades de archivo a todos los documentos que generó el departamento de ventas en el 1ᵉʳ trimestre.
Para agregar propiedades visibles para todas las aplicaciones, usa el campo properties del recurso files. Para agregar propiedades restringidas a tu app, usa el campo appProperties del recurso files.
Las propiedades también se pueden usar en expresiones de búsqueda.
Esta es la estructura de una propiedad típica que se podría usar para almacenar el ID de la base de datos de un archivo de Drive en el archivo.
API de Drive v3
"appProperties": {
"additionalID": "ID",
}
API de Drive v2
{
'key': 'additionalID',
'value': 'ID',
'visibility': 'PRIVATE'
}
Cómo trabajar con propiedades de archivos personalizadas
En la sección, se explica cómo realizar algunas tareas relacionadas con las propiedades de archivos personalizados que afectan a todas las aplicaciones.
Cómo agregar o actualizar propiedades de archivos personalizadas
Para agregar o actualizar propiedades visibles para todas las aplicaciones, usa el método files.update para configurar el campo properties del recurso files.
PATCH https://www.googleapis.com/drive/v3/files/FILE_ID{
"properties": {
"name": "wrench",
"mass": "1.3kg",
"count": "3"
}
}También puedes agregar una propiedad personalizada a un archivo con el servicio avanzado de Drive en Google Apps Script. Para obtener más información, consulta Cómo agregar propiedades personalizadas.
Cómo obtener o enumerar propiedades de archivos personalizados
Para ver las propiedades visibles para todas las aplicaciones, usa el método files.get para recuperar las propiedades del archivo personalizadas.
GET https://www.googleapis.com/drive/v3/files/FILE_ID?fields=propertiesLa respuesta consta de un objeto properties que contiene una colección de
pares clave-valor.
{
"properties": {
"name": "wrench",
"mass": "1.3kg",
"count": "3"
}
}Cómo borrar propiedades de archivos personalizadas
Para borrar los valores de propiedad visibles para todas las aplicaciones, usa el método files.update para establecer el campo properties del recurso files en nulo.
PATCH https://www.googleapis.com/drive/v3/files/FILE_ID{
"name": null
}Para ver el cambio, llama al método files.get para recuperar el objeto properties del archivo.
{
"properties": {
"mass": "1.3kg",
"count": "3"
}
}Límites de las propiedades de archivos personalizadas
Las propiedades personalizadas tienen los siguientes límites:
- Un máximo de 100 propiedades personalizadas por archivo, en total de todas las fuentes
- Un máximo de 30 propiedades públicas por archivo, en total de todas las fuentes
- Un máximo de 30 propiedades privadas por archivo de cualquier aplicación
- Un máximo de 124 bytes por cadena de propiedad (incluida la clave y el valor) en codificación UTF-8 Por ejemplo, una propiedad con una clave de 10 caracteres solo puede tener 114 caracteres en el valor. Del mismo modo, una propiedad que requiere 100 caracteres para el valor puede usar hasta 24 caracteres para la clave.
Para obtener más información, consulta el recurso files. Para la API de Drive v2, consulta el recurso properties.
Accede a propiedades de archivos personalizados privados
Solo puedes recuperar propiedades privadas con el campo appProperties a través de una solicitud autenticada que use un token de acceso obtenido con un ID de cliente de OAuth 2.0. No puedes usar una clave de API para recuperar propiedades privadas.