Interfejs Google Drive API 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 wersjami znajdziesz w artykule Omówienie zmian i wersji.
Z tego przewodnika dowiesz się, jak zarządzać wersjami plików za pomocą interfejsu Google Drive API.
Określanie wersji, które mają być zapisywane przed automatycznym usunięciem
Dysk Google automatycznie usuwa starsze wersje, które nie są już interesujące dla użytkownika.
Wersję pliku blob można ustawić na „Keep Forever” (Zachowaj na zawsze), co oznacza, że nie można jej automatycznie usunąć. Maksymalnie 200 wersji można ustawić jako „Przechowuj bezterminowo”. Wliczają się one do limitu miejsca na dane. Główna wersja nigdy nie jest automatycznie usuwana.
Każda wersja pliku binarnego, która nie jest wersją główną i nie jest oznaczona jako „Zachowaj na zawsze”, może zostać usunięta. Wersje, które można usunąć, są zwykle przechowywane przez 30 dni, ale można je usunąć wcześniej, jeśli plik ma 100 wersji, które nie są oznaczone jako „Zachowaj na zawsze”, a nowa wersja zostanie przesłana.
Możesz ustawić wartość logiczną keepForever pola zasobu revisions na true, aby oznaczyć wersje, których nie chcesz usuwać z Dysku. Gdy wersja pliku binarnego zostanie ustawiona na „Przechowuj na zawsze”, można ją tylko pobrać lub usunąć. Więcej informacji znajdziesz w artykułach Pobieranie wersji i Usuwanie wersji.
Pobieranie wersji
Możesz pobrać tylko wersje treści plików binarnych oznaczone jako „Zachowaj na zawsze”. Jeśli chcesz pobrać wersję, najpierw ustaw ją na „Zachowaj na zawsze”. Więcej informacji znajdziesz w artykule Określanie wersji, które mają być zapisywane przed automatycznym usunięciem.
Aby pobrać wersję zawartości pliku binarnego lub wyeksportować wersję zawartości dokumentu Google Workspace, zapoznaj się z artykułem Pobieranie i eksportowanie plików.
Usuwanie wersji
Możesz wywołać metodę revisions.delete, aby trwale usunąć wersję pliku blob, nawet jeśli jest ona oznaczona jako „Zachowaj na zawsze”.
Jeśli używasz starszej wersji interfejsu Drive API v2, użyj pola pinned zasobu revisions.
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 Witryn Google za pomocą interfejsu Drive API.
Prezentacje Google i Rysunki Google nie obsługują publikowania określonych wersji. Obsługiwane jest tylko automatyczne ponowne publikowanie najnowszej wersji. Aby opublikować Prezentacje i Rysunki, ustaw też wartość 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 witryn ta właściwość wskazuje, czy istnieje uprawnienie type=anyone. Więcej informacji znajdziesz w polu type w zasobie permissions.
Opublikowane wersje nie odzwierciedlają zmian wprowadzonych w pliku, chyba że ustawiona jest właściwość
publishAuto. Jeśli właściwość ma wartość true, nowsze wersje pliku są publikowane automatycznie, zastępując poprzednie.
Slajdy i Rysunki obsługują tylko automatyczne ponowne publikowanie i wymagają, aby właściwość publishAuto miała wartość true. W przypadku plików z Witryn publishAuto jest zawsze false.
Automatyczne publikowanie jest też kontrolowane przez pole wyboru „Automatycznie opublikuj ponownie po wprowadzeniu zmian” w interfejsie Dokumentów i Arkuszy. Więcej informacji znajdziesz w artykule Publikowanie plików Dokumentów, Arkuszy, Prezentacji i Formularzy Google.