En este documento, se abarcan consideraciones importantes para nombrar archivos y trabajar con metadatos, como miniaturas y texto indexable. Para comenzar a insertar y recuperar archivos, consulta la Referencia de archivos.
Especifica extensiones y nombres de archivos
Las apps deben especificar una extensión de archivo en la propiedad de título cuando 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 especificada originalmente en la
propiedad name. Cuando un usuario de Google Drive solicita descargar un archivo o cuando el archivo se descarga mediante el cliente de sincronización, Drive crea un nombre de archivo completo (con extensión) basado en el título. En los casos en que falta la extensión, Drive intenta determinarla en función del tipo de MIME del archivo.
Guarda texto indexable
Drive indexa de forma automática 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 mejorar la visibilidad proporcionando texto indexable en el campo contentHints.indexableText del archivo.
El texto indexable se indexa como HTML. Si guardas la string de texto indexable <section attribute="value1">Here's some text</section>, se indexa “Here’s some text”, pero “value1” no. Por este motivo, guardar el archivo XML como texto indexable no es tan útil como guardar HTML.
Cuando especifiques indexableText, también ten en cuenta lo siguiente:
- El límite de tamaño de
contentHints.indexableTextes de 128 KB. - Captura los términos y conceptos clave que esperas que el usuario busque.
- No intentes ordenar el texto en orden de importancia, ya que el indexador lo hace de manera eficiente.
- Tu aplicación debe actualizar el texto indexable con cada guardado.
- Asegúrate de que el texto esté relacionado con el contenido o los metadatos del archivo.
Este último punto puede parecer obvio, pero es importante. No es una buena idea agregar términos de búsqueda frecuentes para forzar la aparición de un archivo en los resultados de la búsqueda. Esto puede frustrar a los usuarios y podría motivarlos a borrar el archivo.
Subir miniaturas
Drive genera automáticamente miniaturas 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 que genere tu aplicación. Para subir una miniatura, configura la propiedad contentHints.thumbnail en el recurso de archivos durante una llamada create o update de la siguiente manera:
- Configura
contentHints.thumbnail.imagecomo la imagen codificada en Base64 segura para URL (consulta la sección 5 de RFC 4648). - Configura
contentHints.thumbnail.mimeTypeen el tipo adecuado para el formato de imagen.
Si Drive puede generar una miniatura a partir del archivo, usará la que se generó y omitirá las que hayas subido. Si no puede generar una miniatura, siempre usará tu miniatura si proporcionaste una. Aspectos que debes 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 permitido para una miniatura es de 2 MB.
- El ancho mínimo de las miniaturas es de 220 píxeles.
- Tu aplicación debería actualizar las miniaturas con cada vez que se guarde.
Para obtener más información, consulta la Referencia de Archivos.