Cómo borrar archivos y carpetas a la papelera o borrarlos

Puedes quitar archivos y carpetas de Google Drive de Mi unidad y de las unidades compartidas. Tienes dos opciones para hacerlo: enviar a la papelera o borrar.

Puedes mover archivos y carpetas a la papelera y, luego, restablecerlos (dentro de los 30 días posteriores a su eliminación). Si borras archivos y carpetas, se quitarán de forma permanente de Drive. Si envías a la papelera, restableces o borras definitivamente varios archivos o carpetas a la vez, es posible que los cambios tarden en reflejarse.

En esta guía, se explica cómo puedes eliminar archivos en Drive.

Papelera

Para quitar archivos de Drive, puedes moverlos a la papelera. Los archivos de la papelera se borran automáticamente después de 30 días. Puedes restablecer los archivos de la papelera antes de que pasen 30 días.

Solo el propietario del archivo puede enviarlo a la papelera, y los demás usuarios no pueden ver los archivos en la papelera del propietario. Si intentas enviar a la papelera un archivo que no te pertenece, recibirás un error insufficientFilePermissions. Para obtener más información, consulta Permisos.

Para verificar que eres el propietario del archivo, llama al método files.get con fileId y el parámetro fields configurado en el campo booleano ownedByMe. El campo ownedByMe no se propaga para los archivos en unidades compartidas porque son propiedad de la unidad compartida, no de usuarios individuales. Para obtener más información sobre cómo mostrar campos con el parámetro fields, consulta Cómo mostrar campos específicos de un archivo.

Si no eres el propietario del archivo, pero aún quieres una copia del archivo que se envió a la papelera, haz lo siguiente:

• Crea una copia del archivo.
• Comunícate con el propietario para que lo restablezca desde la papelera.

Cómo mover un archivo a la papelera

Para mover un archivo a la papelera, usa el método files.update y establece el campo trashed en True. Para enviar un archivo de unidad compartida a la papelera, también debes configurar el parámetro de consulta supportsAllDrives como True. Para obtener más información, consulta Cómo implementar la compatibilidad con la unidad compartida.

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia del recurso files.

En la siguiente muestra de código, se muestra cómo usar fileId para marcar el archivo como eliminado:

body_value = {'trashed': True}

response = drive_service.files().update(fileId="FILE_ID", body=body_value).execute()

const body_value = {
  'trashed': True
};

const response = await drive_service.files.update({
      fileId: 'FILE_ID',
      requestBody: body_value,
    });
    return response;

Reemplaza FILE_ID por el fileId del archivo que deseas enviar a la basura.

Determina las propiedades de un archivo en la papelera

Cuando un archivo se envía a la papelera, puedes recuperar propiedades files adicionales. Puedes usar el método files.get y, luego, incluir los siguientes campos en el parámetro fields. Para obtener más información, consulta Cómo mostrar campos específicos de un archivo.

Los siguientes campos se propagan para todos los archivos:

• trashed: Indica si el archivo se envió a la papelera, ya sea de forma explícita o desde una carpeta superior que se encuentra en la papelera. Ten en cuenta que, si bien usar trashed con el método files.update establece el estado del archivo, el método files.get recupera el estado del archivo.
• explicitlyTrashed: Indica si el archivo se envió a la papelera de forma explícita, en lugar de de forma recursiva, desde una carpeta superior.

Los siguientes campos solo se completan para los archivos ubicados en una unidad compartida:

• trashedTime: La hora en que se envió el elemento a la papelera en formato de fecha y hora RFC 3339. Si usas la versión anterior de la API de Drive v2, este campo se llama trashedDate.
• trashingUser: Si el archivo se envió a la papelera de forma explícita, el usuario que lo hizo.

Cómo recuperar un archivo de la papelera

Para recuperar un archivo de la papelera, usa el método files.update y establece el campo trashed en False. Para quitar un archivo de la papelera de una unidad compartida, también debes establecer el parámetro de consulta supportsAllDrives en True. Para obtener más información, consulta Cómo implementar la compatibilidad con la unidad compartida.

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia del recurso files.

En la siguiente muestra de código, se muestra cómo usar fileId para marcar el archivo como recuperado de la papelera:

body_value = {'trashed': False}

response = drive_service.files().update(fileId="FILE_ID", body=body_value).execute()

const body_value = {
  'trashed': False
};

const response = await drive_service.files.update({
      fileId: 'FILE_ID',
      requestBody: body_value,
    });
    return response;

Reemplaza FILE_ID por el fileId del archivo que quieres recuperar.

Vaciar la papelera

Puedes borrar de forma permanente todos los archivos de Drive que el usuario movió a la papelera con el método files.emptyTrash. Para vaciar la papelera de una unidad compartida, también debes establecer el parámetro de consulta driveId en el ID de la unidad compartida.

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia vacía.

En la siguiente muestra de código, se muestra cómo usar fileId para borrar todos los archivos de la papelera:

response = drive_service.files().emptyTrash().execute()

 const response = await drive_service.files.emptyTrash({
    });
    return response;

Borrar

Puedes borrar definitivamente un archivo de Drive sin moverlo a la papelera. Una vez que borres un archivo, las personas con las que lo hayas compartido perderán el acceso a él. Si quieres que otras personas conserven el acceso al archivo, puedes transferir la propiedad a otra persona antes de borrarlo.

Para borrar un archivo de la unidad compartida, el usuario debe tener role=organizer en la carpeta superior. Si borras una carpeta, también se borran todos los elementos secundarios que pertenezcan al usuario. Para obtener más información, consulta Permisos.

Para borrar de forma permanente un archivo que pertenece al usuario sin moverlo a la papelera, usa el método files.delete. Para borrar un archivo de la unidad compartida, también debes configurar el parámetro de consulta supportsAllDrives como True. Para obtener más información, consulta Cómo implementar la compatibilidad con la unidad compartida.

Si se ejecuta correctamente, el cuerpo de la respuesta contiene una instancia vacía.

En la siguiente muestra de código, se muestra cómo usar fileId para borrar el archivo:

response = drive_service.files().delete(fileId="FILE_ID").execute()

 const response = await drive_service.files.delete({
      fileId: 'FILE_ID'
    });
    return response;

Reemplaza FILE_ID por el fileId del archivo que deseas borrar.

Permisos

En la siguiente tabla, se muestran los permisos de roles necesarios para realizar cada operación. Para obtener una lista completa de los roles y las operaciones que permite cada uno, consulta Roles y permisos.

Funciones

Un recurso files contiene una colección de campos capabilities booleanos que se usan para indicar si se puede realizar una acción en un archivo.

Para verificar las capacidades, llama al método files.get con fileId y el parámetro fields configurado en el campo capabilities. Para obtener más información sobre cómo mostrar campos con el parámetro fields, consulta Cómo mostrar campos específicos de un archivo.

Los siguientes campos se propagan para todos los archivos:

• capabilities.canTrash: Indica si el usuario actual puede mover este archivo a la papelera.
• capabilities.canUntrash: Indica si el usuario actual puede restablecer este archivo desde la papelera.
• capabilities.canDelete: Indica si el usuario actual puede borrar este archivo.
• capabilities.canRemoveChildren: Indica si el usuario actual puede quitar elementos secundarios de esta carpeta. Es falso cuando el elemento no es una carpeta.

Los siguientes campos solo se completan para los archivos ubicados en una unidad compartida:

• capabilities.canTrashChildren: Indica si el usuario actual puede enviar a la papelera los elementos secundarios de esta carpeta. Es falso cuando el elemento no es una carpeta.
• capabilities.canDeleteChildren: Indica si el usuario actual puede borrar las carpetas secundarias de esta carpeta. Es falso cuando el elemento no es una carpeta.

Límites de archivos y carpetas

Los archivos y las carpetas de Drive, junto con las carpetas de unidades compartidas, tienen algunos límites de almacenamiento.

Por lo general, después de alcanzar el límite de elementos, la única forma de crear más espacio es borrar elementos de forma permanente o usar una cuenta diferente. Mover archivos a la papelera no es suficiente para liberar espacio.

Para obtener más información sobre los límites de archivos y carpetas, consulta lo siguiente:

• Límites de archivos y carpetas en archivos
• Límites de archivos y carpetas en unidades compartidas

Temas relacionados

• Cómo borrar archivos en Google Drive
• Diferencias entre la API de Shared Drive y la de Mi unidad
• Funciones y permisos