Administrar metadatos de archivos

En este documento, se abordan las consideraciones importantes para nombrar archivos y trabajar con metadatos como miniaturas y texto indexable. Para comenzar a insertar y recuperar archivos, consulta Referencia de archivos.

Especificar nombres de archivo y extensiones

Las apps deben especificar una extensión de archivo en la propiedad de título cuando se insertan archivos con la API. Por ejemplo, una operación para insertar un archivo JPEG debe especificar algo como "name": "cat.jpg" en los metadatos.

Las respuestas GET posteriores pueden incluir la propiedad fileExtension de solo lectura propagada con la extensión que se especificó originalmente en la propiedad name. Cuando un usuario de Google Drive solicita descargar un archivo o cuando este se descarga a través del cliente de sincronización, Drive crea un nombre de archivo completo (con extensión) basado en el título. Cuando falta la extensión, Drive intenta determinar la extensión en función del tipo MIME del archivo.

Cómo guardar texto indexable

Drive indexa automáticamente los documentos para la búsqueda cuando reconoce el tipo de archivo, incluidos los documentos de texto, los PDF, las imágenes con texto y otros tipos comunes. Si tu app guarda otros tipos de archivos (como dibujos, videos y accesos directos), puedes proporcionar texto indexable en el campo contentHints.indexableText del archivo para mejorar la visibilidad.

El texto indexable se indexa como HTML. Si guardas la string de texto indexable <section attribute="value1">Here's some text</section>, se indexa "Aquí hay texto", pero no "valor1". Debido a esto, guardar XML como texto indexable no es tan útil como guardar HTML.

Cuando especifiques indexableText, también debes tener en cuenta lo siguiente:

  • El límite de tamaño para contentHints.indexableText es de 128 KB.
  • Captura los términos y conceptos clave que esperas que busque un usuario.
  • No intentes ordenar el texto por orden de importancia, ya que el indexador lo hace de manera eficiente.
  • Tu aplicación debe actualizar el texto indexable con cada guardado.
  • Asegúrese de que el texto esté relacionado con el contenido o los metadatos del archivo.

Este último punto parece obvio, pero es importante. No es una buena idea agregar términos que se buscan con frecuencia para forzar a un archivo a aparecer en los resultados de la búsqueda. Esto puede frustrar a los usuarios, y hasta puede motivarlos a borrar el archivo.

Subir miniaturas

Drive genera miniaturas automáticamente para muchos tipos de archivos comunes. Para los accesos directos y otros tipos de archivos que Drive no puede renderizar, puedes proporcionar una imagen en miniatura generada por la aplicación. Para subir una miniatura, configura la propiedad contentHints.thumbnail en el recurso Files durante una llamada create o update de la siguiente manera:

  • Establece contentHints.thumbnail.image en la imagen codificada en Base64 segura para URL (consulta la sección 5 de RFC 4648).
  • Configura contentHints.thumbnail.mimeType en el tipo adecuado para el formato de imagen.

Si Drive puede generar una miniatura a partir del archivo, usa la que se generó e ignora cualquier carga que hayas subido. Si no puede generar una miniatura, siempre usará la tuya si proporcionaste una. Aspectos para tener en cuenta:

  • Las miniaturas se pueden subir en formato PNG, GIF o JPG.
  • El ancho recomendado es de 1,600 píxeles.
  • El tamaño máximo de archivo para una miniatura es de 2 MB.
  • El ancho mínimo de las miniaturas es de 220 píxeles.
  • Tu aplicación debe actualizar las miniaturas con cada guardado.

Para obtener más información, consulta la referencia de Archivos.