Z tego przewodnika dowiesz się, jak używać zasobu revisions do zarządzania wersjami plików, np. pobierania wersji pliku i publikowania wersji Google Workspace. Interfejs Google Drive API umożliwia też pobieranie wersji. Więcej informacji o terminologii związanej z wersjami znajdziesz w artykule Zmiany i wersje.
Aby uzyskać dostęp do historii zmian, użytkownik musi mieć uprawnienia role na poziomie owner, organizer, fileOrganizer lub writer.
Aby określić pola, które mają być zwracane w odpowiedzi, możesz ustawić fields
parametr systemowy w dowolnej metodzie zasobu revisions. Jeśli pominiesz ten parametr, serwer zwróci domyślny zestaw pól. Na przykład metoda revisions.list zwraca tylko pola id, mimeType, kind i modifiedTime. Aby zwrócić inne pola, zobacz Zwracanie określonych pól.
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.
Jeśli używasz starszej wersji interfejsu Drive API 2, użyj pola pinned zasobu revisions zamiast keepForever.
Pobieranie wersji pliku
Aby uzyskać metadane lub zawartość wersji pliku, użyj metody get w zasobie revisions z parametrami ścieżki fileId i revisionId. Jeśli nie znasz identyfikatora wersji, możesz wyświetlić listę wszystkich wersji pliku za pomocą metody list.
Metoda zwraca metadane wersji jako instancję zasobu revisions.
Aby potwierdzić ryzyko pobrania znanego złośliwego oprogramowania lub innych szkodliwych plików, ustaw parametr zapytania acknowledgeAbuse na true. To pole ma zastosowanie tylko wtedy, gdy ustawiony jest parametr alt=media, a użytkownik jest właścicielem pliku lub organizatorem dysku współdzielonego, na którym znajduje się plik.
Wyświetlanie listy wersji pliku
Aby wyświetlić listę wersji pliku, użyj metody list w zasobie revisions z parametrem ścieżki fileId. Metoda zwraca listę wersji pliku.
Przekaż te parametry zapytania, aby dostosować paginację lub filtrowanie wersji:
pageSize: maksymalna liczba wersji do zwrócenia na stronę.pageToken: token strony otrzymany z poprzedniego wywołania listy. Podaj ten token, aby pobrać następną stronę.
Aktualizowanie wersji pliku
Aby zaktualizować wersję pliku, użyj metody update w zasobie revisions z parametrami ścieżki fileId i revisionId.
Metoda zwraca instancję zasobu revisions.
Pobieranie wersji
Możesz pobrać tylko te wersje plików binarnych, które są 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 pliku
Aby trwale usunąć wersję pliku, użyj metody delete w zasobie revisions z parametrami ścieżki fileId i revisionId.
Możesz usuwać tylko wersje plików blob z treściami binarnymi na Dysku, takich jak obrazy, filmy i pliki PDF. Możesz usunąć wersję pliku binarnego, gdy jest ona oznaczona jako „Zachowaj na zawsze”. Wersji innych plików, takich jak Dokumenty lub Arkusze Google, oraz ostatniej pozostałej wersji pliku binarnego nie można usunąć.
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.
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 zawsze ma wartość false.
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.
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.