Administrar metadatos de archivos

Este documento abarca consideraciones importantes para nombrar archivos y trabajar con metadatos, como texto indexable y miniaturas. Para insertar y recuperar archivos, consulta el recurso files.

Especifica nombres de archivo y extensiones

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

Las respuestas GET posteriores pueden incluir la propiedad fileExtension de solo lectura. Se debe completar con la extensión que se especificó originalmente en la propiedad name. Cuando un elemento Solicitudes de usuarios de Google Drive para descargar un archivo o cuando se descarga a través del cliente de sincronización, Drive crea un nombre de archivo completo (con extensión) según el título. En los casos en que falta la extensión, Drive intenta determinar la extensión en función de la extensión Es el tipo de MIME.

Guarda 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 y otros tipos comunes. Si tu app guarda otros tipos de archivos (como dibujos, videos y accesos directos), puedes mejorar la visibilidad si proporcionas texto indexable en el campo contentHints.indexableText del archivo.

El texto indexable se indexa como HTML. Si guardas la cadena de texto indexable <section attribute="value1">Here's some text</section> y luego "Aquí tienes algunas de texto". está indexada, pero “value1” no lo es. Por este motivo, guardar XML como indexable el texto no es tan útil como guardar HTML.

Cuando especifiques indexableText, ten 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 realicen los usuarios.
  • No intentes ordenar el texto en orden de importancia porque el indexador lo hace. de forma eficiente.
  • Tu aplicación debe actualizar el texto indexable cada vez que se guarda la información.
  • 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. Esta puede frustrar a los usuarios y motivarlos a borrar el archivo.

Subir miniaturas

Drive genera automáticamente miniaturas para muchos archivos de Google, como Documentos, Hojas de cálculo y Presentaciones de Google. Las miniaturas ayudan al usuario a identificar mejor los archivos de Drive.

Para los tipos de archivo que Drive no puede generar una miniatura estándar puedes proporcionar una imagen en miniatura generada por tu aplicación. Durante creación o actualización de archivos, sube una miniatura estableciendo Campo contentHints.thumbnail en el recurso files.

En particular, haz lo siguiente:

  • Configura el campo contentHints.thumbnail.image de modo que la URL y el nombre de archivo sean seguros imagen codificada en base64 (consulta la sección RFC 4648), 5).
  • Establece el campo contentHints.thumbnail.mimeType con el tipo de MIME adecuado. para la miniatura.

Si Drive puede generar una miniatura a partir del archivo, utiliza el que se generó automáticamente e ignora los que se hayan subido. Si no puede una miniatura, se usará la que proporciones.

Las miniaturas deben cumplir con estas reglas:

  • Se pueden subir en formato PNG, GIF o JPG.
  • El ancho recomendado es de 1,600 píxeles.
  • El ancho mínimo es 220 píxeles.
  • El tamaño máximo permitido del archivo es de 2 MB.
  • La aplicación debe actualizarlos cada vez que se los guarda.

Para obtener más información, consulta el recurso files.

Recuperar miniaturas

Puedes recuperar los metadatos, incluidas las miniaturas, de los archivos de Drive. La información de la miniatura se aloja en el campo thumbnailLink de la files.

Cómo mostrar una miniatura específica

En la siguiente muestra de código, se muestra un Solicitud del método files.get con varios campos como parámetro de consulta para devolver los metadatos thumbnailLink de a un archivo específico. Para obtener más información, consulta Cómo devolver campos específicos para un predeterminado.

GET https://www.googleapis.com/drive/v3/files/FILE_ID?fields=id,name,mimeType,thumbnailLink

Reemplaza FILE_ID por el fileId del archivo que deseas. encontrar.

Si está disponible, la solicitud muestra una URL de corta duración a la miniatura del archivo. Por lo general, el vínculo dura varias horas. El campo solo se completa cuando la app solicitante puede acceder al contenido del archivo. Si el archivo no se comparte públicamente, la URL que se muestra en thumbnailLink se debe recuperar con un solicitud con credenciales.

Mostrar una lista de miniaturas

En la siguiente muestra de código, se muestra un Solicitud del método files.list con varios campos como parámetro de consulta para devolver los metadatos thumbnailLink de una lista de archivos. Para obtener más información, consulta Busca archivos y carpetas.

GET https://www.googleapis.com/drive/v3/files/?fields=files(id,name,mimeType,thumbnailLink)

Para restringir los resultados de búsqueda a un tipo de archivo específico, aplica una cadena de consulta a establecer el tipo de MIME. En la siguiente muestra de código, se indica cómo limitar el a archivos de Hojas de cálculo de Google. Para obtener más información sobre los tipos de MIME, consulta MIME compatible con Google Workspace y Google Drive de la API de Google Ads.

GET https://www.googleapis.com/drive/v3/files/q=mimeType='application/vnd.google-apps.spreadsheet'&fields=files(id,name,mimeType,thumbnailLink)