Interfejs API Dysku Google udostępnia zasób revisions, dzięki któremu możesz pobierać i publikować wersje plików. Więcej informacji o terminologii związanej z rewizjami znajdziesz w artykule Omówienie zmian i rewizji.
Określ wersje, które mają być chronione przed automatycznym usuwaniem
Dysk Google automatycznie usuwa starsze wersje, które nie są już interesujące dla użytkownika. Aby temu zapobiec, możesz ustawić logiczną flagę keepRevisionForever na true, aby oznaczyć wersje, których nie chcesz usuwać z Dysku.
Pobieranie wersji
Aby pobrać najnowszą wersję, użyj metody files.download. Więcej informacji znajdziesz w artykule Zarządzanie długotrwałymi operacjami.
Publikowanie wersji
Aby opublikować wersję Dokumentów, Arkuszy lub Prezentacji Google, ustaw właściwość published dla tego pliku w zasobie revisions. Nie można ustawić tej właściwości w przypadku wersji Witryny Google za pomocą interfejsu Drive API.
Prezentacje Google i Rysunki Google nie obsługują publikowania konkretnych wersji. Obsługiwana jest tylko automatyczna ponowna publikacja najnowszej wersji. Aby opublikować Prezentacje i Rysunki, ustaw też parametr publishAuto na true.
Jeśli plik został utworzony w domenie Google Workspace, właściwość publishedOutsideDomain wskazuje, czy wersja jest dostępna dla wszystkich, czy tylko dla użytkowników domeny. W przypadku plików Sites ta właściwość wskazuje, czy istnieje uprawnienie type=anyone.
Opublikowane wersje nie odzwierciedlają zmian wprowadzonych w pliku, chyba że właściwość publishAuto jest ustawiona. Jeśli to ustawienie ma wartość true, nowsze wersje pliku są publikowane automatycznie, zastępując poprzednie.
To zachowanie jest również kontrolowane przez pole wyboru „Automatycznie opublikuj ponownie po wprowadzeniu zmian” w interfejsie Dysku. Arkusze i rysunki obsługują tylko automatyczne ponowne publikowanie i wymagają, aby właściwość publishAuto miała wartość true. W przypadku plików Witryn publishAuto jest zawsze false.