La API de Google Drive proporciona el recurso Revisiones para que puedas descargar y publicar revisiones de archivos. Para obtener más detalles sobre la terminología de revisión, consulta Descripción general de cambios y revisiones.
Cómo especificar revisiones para guardar desde la eliminación automática
Google Drive borra automáticamente las revisiones anteriores que ya no son de interés para el usuario. Para evitar que esto suceda, puedes establecer la marca booleana keepRevisionForever en true para marcar las revisiones que no deseas que Drive borre definitivamente.
Descargar una revisión
Puedes usar el valor del campo headRevisionId del recurso Archivos para descargar la última revisión.
Esto recupera la revisión que corresponde a los metadatos del archivo que recuperaste antes. Para descargar los datos de todas las revisiones anteriores del archivo que todavía están almacenados en la nube, puedes llamar a revisions.list, que obtiene todos los reviewIds.
Para descargar el contenido de la revisión, debes llamar al método revisions.get con el parámetro alt=media. No se pueden descargar revisiones de Documentos, Hojas de cálculo y Presentaciones de Google.
Las revisiones de Documentos, Dibujos y Presentaciones de Google aumentan automáticamente la cantidad de revisiones. Sin embargo, las series de números pueden tener brechas si se eliminan las revisiones, por lo que no debes confiar en los números secuenciales al recuperar revisiones.
Publica una revisión
Para publicar una revisión de Documentos, Hojas de cálculo y Presentaciones de Google, debes configurar la propiedad published para ese archivo en la propiedad Revisiones. No se puede configurar esta propiedad para las revisiones de Google Sites mediante la API de Drive.
Si el archivo se crea en un dominio Google Workspace , la propiedad publishedOutsideDomain indica si cualquier persona puede acceder a la revisión o si está restringida a los usuarios del dominio. Para los archivos de Google Sites, esta propiedad indica si existe un permiso type=anyone.
Las revisiones publicadas no reflejan los cambios realizados en un archivo, a menos que se configure la propiedad publishAuto. Si esta propiedad se configura como verdadera, las revisiones más recientes de un archivo se publicarán automáticamente y se reemplazarán las anteriores. Este comportamiento también se controla a través de la casilla de verificación "Volver a publicar automáticamente cuando se realicen cambios" en la IU de Drive. Para los archivos de Google Sites, publishAuto siempre es false.