La API de Google Drive proporciona el recurso revisions para que puedas descargar y publicar revisiones de archivos. Para obtener más detalles sobre la terminología de las revisiones, consulta la Descripción general de los cambios y las revisiones.
En esta guía, se explica cómo administrar las revisiones de archivos con la API de Google Drive.
Cómo especificar las revisiones que se guardarán de la eliminación automática
Google Drive borra automáticamente las revisiones más antiguas que ya no son de interés para el usuario.
Una revisión de archivo blob se puede establecer como "Conservar para siempre", lo que significa que no se puede purgar automáticamente. Se pueden establecer hasta 200 revisiones como "Conservar para siempre", y estas se incluyen en tu límite de almacenamiento. La revisión principal nunca se borra automáticamente.
Se puede purgar cualquier revisión de archivo BLOB, excepto la revisión principal, que no esté designada como "Conservar para siempre". Por lo general, las versiones que se pueden purgar se conservan durante 30 días, pero se pueden purgar antes si un archivo tiene 100 versiones que no están designadas como "Conservar para siempre" y se sube una versión nueva.
Puedes establecer el campo booleano keepForever del recurso revisions en true para marcar las revisiones que no quieres que Drive borre. Una vez que una revisión de archivo BLOB se establece como "Keep Forever", solo se puede descargar o borrar. Para obtener más información, consulta Cómo descargar una revisión o Cómo borrar una revisión.
Descarga una revisión
Solo puedes descargar las revisiones de contenido de archivos BLOB marcadas como "Conservar para siempre". Si quieres descargar una revisión, primero asegúrate de establecerla como "Conservar para siempre". Para obtener más información, consulta Cómo especificar las revisiones que se deben guardar de la eliminación automática.
Para descargar una revisión de contenido de un archivo blob o exportar una revisión de contenido de un documento de Google Workspace, consulta Descarga y exporta archivos.
Cómo borrar una revisión
Puedes llamar al método revisions.delete para borrar de forma permanente una revisión de archivo BLOB, incluso cuando esté marcada como "Conservar para siempre".
Si usas la versión 2 anterior de la API de Drive, usa el campo pinned del recurso revisions en su lugar.
Publica una revisión
Para publicar una revisión de Documentos, Hojas de cálculo y Presentaciones de Google, establece la propiedad published para ese archivo en el recurso revisions. Esta propiedad no se puede establecer para las revisiones de Google Sites con la API de Drive.
Presentaciones y Dibujos de Google no admiten la publicación de revisiones específicas. Solo se admite la republicación automática de la revisión más reciente. Para publicar Presentaciones y Dibujos, también establece publishAuto en true.
Si el archivo se crea en un dominio de Google Workspace, la propiedad publishedOutsideDomain indica si cualquier persona puede acceder a la revisión o si está restringida a los usuarios del dominio. En el caso de los archivos de Sites, esta propiedad indica si existe un permiso de type=anyone. Para obtener más información, consulta el campo type en el recurso permissions.
Las revisiones publicadas no reflejan los cambios realizados en un archivo, a menos que se establezca la propiedad publishAuto. Si la propiedad está configurada como true, las revisiones más recientes de un archivo se publican automáticamente y reemplazan las anteriores.
Las Presentaciones y los Dibujos solo admiten la republicación automática y requieren que la propiedad publishAuto se establezca en true. Para los archivos de Sites, publishAuto siempre es false.
La publicación automática también se controla con la casilla de verificación "Volver a publicar automáticamente cuando se realicen cambios" en la IU de Documentos y Hojas de cálculo. Para obtener más información, consulta Cómo publicar archivos de Documentos, Hojas de cálculo, Presentaciones y Formularios de Google.