Interfejs Google Drive API udostępnia zasób Wersje, który umożliwia pobieranie i publikowanie wersji plików. Więcej informacji na temat terminologii znajdziesz w artykule Omówienie zmian i wersji.
Określ wersje do zapisania z automatycznego usuwania
Dysk Google automatycznie usuwa starsze wersje, które już nie interesują użytkownika. Aby temu zapobiec, możesz ustawić flagę wartości logicznej keepRevisionForever na true, aby oznaczać wersje, których Dysk nie powinien trwale usunąć.
Pobieranie wersji
Aby pobrać najnowszą wersję, możesz użyć wartości pola headRevisionId z zasobu Pliki.
Spowoduje to pobranie wersji, która odpowiada metadanym pobranego wcześniej pliku. Aby pobrać dane wszystkich poprzednich wersji pliku, które są nadal przechowywane w chmurze, możesz wywołać metodę revisions.list, która pobierze wszystkie identyfikatory wersji.
Aby pobrać treść wersji, musisz wywołać
revisions.get z parametrem alt=media. Nie można pobierać wersji Dokumentów, Arkuszy ani Prezentacji Google.
Wersje Dokumentów, Rysunków i Prezentacji Google automatycznie zwiększają numer wersji. Jednak w przypadku usunięcia wersji w serii liczb mogą występować luki, dlatego przy pobieraniu wersji nie należy polegać na numerach sekwencyjnych.
Opublikuj wersję
Aby opublikować wersję Dokumentów, Arkuszy lub Prezentacji Google, ustaw właściwość published dla danego pliku we właściwości Wersje. Tej usługi nie można ustawić dla wersji Witryn Google za pomocą interfejsu Drive API.
Jeśli plik został utworzony w Google Workspace domenie,
właściwość publishedOutsideDomain wskazuje, czy dana wersja
każdy może mieć dostęp lub jeśli dostęp jest ograniczony do użytkowników domeny. Dla Google
witryn, ta właściwość wskazuje, czy istnieją uprawnienia type=anyone.
Wersje opublikowane nie odzwierciedlają zmian wprowadzonych w pliku, jeśli nie jest ustawiona właściwość publishAuto. Jeśli ta właściwość ma wartość true (prawda), nowsze wersje pliku są automatycznie publikowane i zastępują poprzednie. Zależy to również od ustawienia „Automatycznie opublikuj ponownie po wprowadzeniu zmian”. w interfejsie Dysku. W przypadku plików Witryn Google atrybut publishAuto zawsze ma wartość false.