Interfejs Google Drive API udostępnia zasób Wersje, dzięki któremu możesz pobierać i publikować wersje plików. Więcej informacji o terminologii związanej z wersjami znajdziesz w artykule Omówienie zmian i wersji.
Określ wersje do zapisania z automatycznego usuwania
Dysk Google automatycznie usuwa starsze wersje, które nie są już interesujące dla użytkownika. Aby temu zapobiec, możesz ustawić flagę wartości logicznej keepRevisionForever na true, aby oznaczyć wersje, których nie chcesz usuwać z Dysku.
Pobieranie wersji
Aby pobrać najnowszą wersję, możesz użyć wartości pola headRevisionId z zasobu Files.
Spowoduje to pobranie wersji odpowiadającej 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 pobiera wszystkie identyfikatory wersji.
Aby pobrać treść wersji, musisz wywołać metodę revisions.get z parametrem alt=media. Nie można pobierać wersji Dokumentów, Arkuszy ani Prezentacji Google.
W wersjach Dokumentów, Rysunków i Prezentacji Google numery wersji są automatycznie zwiększane. W przypadku usunięcia wersji seria liczb może jednak zawierać luki, dlatego nie należy korzystać z kolejnych numerów podczas pobierania wersji.
Publikowanie wersji
Aby opublikować wersję Dokumentów, Arkuszy lub Prezentacji Google, ustaw właściwość published tego pliku we właściwości Wersje. Tej właściwości 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 wersja jest dostępna dla wszystkich użytkowników, czy też jest ona ograniczona do użytkowników w domenie. W przypadku plików Witryn Google ta właściwość wskazuje, czy istnieje uprawnienie type=anyone.
Opublikowane wersje nie odzwierciedlają zmian wprowadzonych w pliku, chyba że jest ustawiona właściwość publishAuto. Jeśli ta właściwość ma wartość Prawda, nowsze wersje pliku są automatycznie publikowane i zastępują poprzednie. To działanie jest też zależne od pola wyboru „Automatycznie opublikuj ponownie po wprowadzeniu zmian” w interfejsie Dysku. W przypadku plików Witryn Google publishAuto to zawsze false.