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. Slajdów i rysunków nie można automatycznie ponownie publikować. Właściwość publishAuto
musi mieć wartość true
. W przypadku plików Witryn publishAuto
jest zawsze false
.