Cómo crear y administrar archivos

En esta guía, se explica cómo crear y administrar archivos en Google Drive con la API de Google Drive.

Crear archivo

Para crear un archivo en Drive que no contenga metadatos ni contenido, usa el método files.create sin parámetros. El archivo recibe un kind de drive.file, un id, un name de "Sin título" y un mimeType de application/octet-stream. El uploadType está marcado como obligatorio, pero el valor predeterminado es media, por lo que no es necesario que lo proporciones.

Para obtener más información sobre los límites de los archivos de Drive, consulta Límites de archivos y carpetas.

Crea archivos solo con metadatos

Los archivos que solo contienen metadatos no incluyen contenido. Los metadatos son datos (como name, mimeType y createdTime) que describen el archivo. Los campos como name son independientes del usuario y aparecen de la misma manera para cada usuario, mientras que los campos como viewedByMeTime contienen valores específicos del usuario.

Un ejemplo de un archivo que solo contiene metadatos es una carpeta con el tipo MIME application/vnd.google-apps.folder. Para obtener más información, consulta Crea y completa carpetas. Otro ejemplo es un acceso directo que apunta a otro archivo en Drive con el tipo MIME application/vnd.google-apps.shortcut. Para obtener más información, consulta Cómo crear un acceso directo a un archivo de Drive.

Administra imágenes en miniatura

Las miniaturas ayudan a los usuarios a identificar los archivos de Drive. Drive puede generar automáticamente miniaturas para los tipos de archivos comunes, o bien puedes proporcionar una imagen de miniatura generada por tu app. Para obtener más información, consulta Cómo subir miniaturas.

Cómo copiar un archivo existente

Para copiar un archivo y aplicar las actualizaciones solicitadas, usa el método files.copy. Para encontrar el fileId que se copiará, usa el método files.list.

Ten en cuenta que debes usar un alcance de la API de Drive adecuado para autorizar la llamada. Para obtener más información sobre los permisos de Drive, consulta Elige permisos para la API de Google Drive.

Límites y consideraciones

Mientras te preparas para copiar archivos, ten en cuenta estos límites y consideraciones:

  • Permisos:

    • El objeto DownloadRestrictionsMetadata del recurso files determina quién puede copiar el archivo. Para obtener más información, consulta Cómo evitar que los usuarios descarguen, impriman o copien tu archivo.
    • El recurso de campo capabilities.canCopy determina si el usuario puede copiar un archivo. Para obtener más información, consulta Información sobre las capacidades de los archivos.
    • El usuario que creó la copia es el propietario del archivo copiado. No se replican otros parámetros de configuración de uso compartido del archivo fuente. Si la copia se crea en una carpeta compartida, hereda los permisos de esa carpeta.
    • Es posible que cambie la propiedad de un archivo copiado y que la copia no herede la configuración de uso compartido del archivo original. Es posible que debas restablecer estos parámetros de configuración.

  • Administración de archivos:

    • Algunos archivos, como los accesos directos de terceros, nunca se pueden copiar.
    • Solo puedes copiar un archivo en una carpeta principal. No se admite la especificación de varios elementos principales. Si no se especifica el campo parents, el archivo hereda cualquier elemento superior detectable del archivo fuente.
    • Aunque una carpeta es un tipo de archivo, no puedes copiarla. En su lugar, crea una carpeta de destino y configura el campo parents de los archivos existentes en la carpeta de destino. Luego, puedes borrar la carpeta de origen original.
    • A menos que se especifique un nombre de archivo nuevo, el método files.copy produce un archivo con el mismo nombre que el original.
    • El uso excesivo de files.copy puede provocar que se superen los límites de cuota de la API de Drive. Para obtener más información, consulta Límites de uso.

Aquí hay algunos pasos que puedes seguir: