Z tego przewodnika dowiesz się, jak zarządzać wersjami plików za pomocą zasobu revisions
, np. jak pobrać wersję pliku i
opublikować wersję Google Workspace. Interfejs Google Drive API umożliwia też pobieranie wersji. Więcej informacji o terminologii związanej z wersjami znajdziesz w artykule Omówienie zmian
i wersji.
Aby uzyskać dostęp do historii zmian, użytkownik musi mieć role 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, przeczytaj artykuł 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ć jako "Zachowaj na zawsze", co oznacza, że nie można jej automatycznie usunąć. Do 200 wersji można ustawić jako „Zachowaj na zawsze”. Wliczają się one do limitu miejsca na dane. Głównej wersji nigdy nie można automatycznie usunąć.
Każdą wersję pliku blob, która nie jest wersją główną i nie jest oznaczona jako „Zachowaj na zawsze”, można usunąć. 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”, i zostanie przesłana nowa wersja.
Aby oznaczyć wersje, których nie chcesz usuwać z Dysku, możesz ustawić wartość true w polu logicznym keepForever zasobu revisions. Gdy wersja pliku blob zostanie ustawiona jako „Zachowaj 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 w wersji 2, zamiast pola
keepForever użyj pola pinned zasobu
revisions.
Pobieranie wersji pliku
Aby pobrać 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. Jeśli podasz parametr alt=media, odpowiedź będzie zawierać zawartość wersji w treści odpowiedzi. Aby pobrać plik blob, przeczytaj artykuł
Pobieranie zawartości pliku blob w starszej wersji.
Aby potwierdzić ryzyko pobrania znanego złośliwego oprogramowania lub innych
szkodliwych plików, ustaw
acknowledgeAbuse parametr zapytania 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 list
metody w zasobie revisions z
fileId parametrem ścieżki. Metoda zwraca listę wersji pliku.
Aby dostosować stronicowanie lub filtrowanie wersji, przekaż te parametry zapytania:
pageSize: maksymalna liczba wersji do zwrócenia na stronie.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 wersje zawartości plików blob oznaczone jako „Zachowaj na zawsze”. Jeśli chcesz pobrać wersję, najpierw ustaw ją jako „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 blob lub wyeksportować wersję zawartości dokumentu Google Workspace przeczytaj artykuł 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 path
parameters.
Możesz usuwać tylko wersje plików BLOB z zawartością binarną na Dysku, takich jak obrazy, filmy i pliki PDF. Możesz usunąć wersję pliku blob, gdy jest oznaczona jako „Zachowaj na zawsze”. Nie można usuwać wersji innych plików, takich jak Dokumenty lub Arkusze Google, ani ostatniej pozostałej wersji pliku binarnego.
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ą automatycznie publikowane, zastępując poprzednie.
Prezentacje i Rysunki obsługują tylko automatyczne ponowne publikowanie i wymagają ustawienia właściwości publishAuto na true. W przypadku plików Witryn właściwość publishAuto ma zawsze 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 opisie pola
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, Arkuszów, Prezentacji i Formularzy Google .