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 Descripción general de los cambios y las revisiones.
Especifica las revisiones que se guardarán de 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 quieres que Drive borre definitivamente.
Descargar una revisión
Puedes usar el valor del campo headRevisionId del recurso Files 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 aún están almacenadas en la nube, puedes llamar a revisions.list, que obtiene todos los revisionIds.
Para descargar el contenido de la revisión, debes llamar a
El método revisions.get con el parámetro alt=media No se pueden descargar las revisiones de Documentos, Hojas de cálculo y Presentaciones de Google.
Las revisiones de Documentos de Google, Dibujos y Presentaciones de Google aumentan automáticamente los números de las 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 las revisiones.
Publica una revisión
Para publicar una revisión de Documentos, Hojas de cálculo y Presentaciones de Google, debes establecer la propiedad published para ese archivo en la propiedad Revisiones. No se puede establecer 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 la revisión
accesible para todos o si está restringido a los usuarios del dominio. Para 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 esa propiedad se establece como verdadera, se publicarán automáticamente las revisiones más nuevas de un archivo y se reemplazarán las anteriores. Este comportamiento también se controla con la opción "Volver a publicar automáticamente cuando se realicen cambios" en la IU de Drive. En el caso de los archivos de Google Sites, publishAuto siempre es false.