Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Dysk Google automatycznie zapisuje historię zmian, co pomaga użytkownikom śledzić zmiany w plikach i wersjach treści. W historii zmian użytkownicy mogą zobaczyć, jakie zmiany zostały wprowadzone, i przywrócić konkretną wersję pliku z określonymi zmianami.
Poniższe terminy odnoszą się do zasobów zmian i wersji interfejsu Google Drive API:
Lista kontroli dostępu (ACL)
Lista wszystkich zasobów uprawnień powiązanych z plikiem, folderem lub dyskiem współdzielonym.
Zmień
Zmiana zawartości lub metadanych pliku albo dysku współdzielonego.
Historia zmian użytkownika
Zapis wszystkich zmian wprowadzonych przez użytkownika w każdym edytowalnym pliku na jego Dysku, np. w Dokumentach, Arkuszach lub Prezentacjach Google. W przypadku użytkowników dysku współdzielonego dziennik zmian użytkownika zawiera też wpisy dotyczące użytkowników dysku współdzielonego, poziomów dostępu użytkowników do elementów na tym dysku współdzielonym oraz zmian nazwy dysku współdzielonego.
Historia zmian na dysku współdzielonym
Rejestr wszystkich zmian na dysku współdzielonym, takich jak dodawanie i usuwanie użytkowników oraz zmiany dotyczące elementów na tym dysku. Zmiana elementu na dysku współdzielonym jest widoczna zarówno w dzienniku zmian użytkownika, jak i w dzienniku zmian dysku współdzielonego.
Wpis w historii zmian
Zapis zmiany wprowadzonej w treści pliku lub metadanych pliku lub dysku współdzielonego. Wpis w dzienniku zmian zawiera informacje o użytkowniku, który wprowadził zmianę, sygnaturę czasową i identyfikator. W dzienniku zmian może być tylko 1 wpis dotyczący danego pliku lub dysku współdzielonego. Za każdym razem, gdy plik lub dysk współdzielony ulegnie zmianie, tworzony jest nowy identyfikator tego wpisu, który zastępuje poprzedni wpis.
Wersja
Wersja pliku reprezentująca zmianę zawartości pliku (nie metadanych). Każda wersja jest dostępna za pomocą zasobu revisions w interfejsie Drive API.
Wersja główna
najnowsza wersja pliku; Dostęp do headRevisionId można uzyskać za pomocą zasobu files w interfejsie Drive API. Funkcja headRevisionId jest dostępna tylko w przypadku plików binarnych na Dysku.
Wersja obiektu blob
Wersja pliku binarnego, którego nie można zmodyfikować, takiego jak obraz, film czy plik PDF. Jeśli wersja obiektu blob jest jedyną wersją pliku binarnego, nie można jej usunąć. Nowy obiekt blob można przesłać jako nową wersję, która stanie się nową wersją główną tego pliku.
Każda wersja pliku binarnego, z wyjątkiem wersji głównej, która 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.
Rejestr wszystkich wersji pliku w kolejności chronologicznej. Zmiana w pliku Dokumentów, Arkuszy lub Prezentacji powoduje utworzenie nowej wersji. Za każdym razem, gdy zawartość się zmieni, Dysk utworzy nowy wpis w historii zmian tego pliku. Wersje plików edytora mogą jednak zostać połączone, więc odpowiedź interfejsu API może nie zawierać wszystkich zmian w pliku.
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.
[null,null,["Ostatnia aktualizacja: 2025-08-21 UTC."],[],[],null,["# Changes and revisions overview\n\nGoogle Drive maintains an automatic history of modifications, which can help\nusers track file changes and content revisions. In the revision history, users\ncan see what edits have been made and can revert to a specific version of a file\nwith specific edits.\n\nThe following terms are relevant to the changes and revisions resources of the\nGoogle Drive API:\n\n*Access Control List (ACL)*\n: The list of all permission resources associated with a file, folder, or shared\n drive.\n\n*Change*\n: An alteration made to a file's content or metadata of a file or shared drive.\n\n*User change log*\n\n: A record of all changes that a user made to every editable file in their My\n Drive, such as a Google Docs, Sheets, or a\n Slides. For members of a shared drive, the user change log\n also includes entries about shared drive membership, user access levels to\n items in that shared drive, and shared drive name changes.\n\n | **Note:** Even if several users can access the same file, not all changes to that file are reflected in every users' change log. For example, when a user opens the file for the first time, or marks the file as Starred, those changes only appear in that users' change log. As another example, when a file's ACL is changed, it's only reflected in the change log of the following users: The file's owner, any service accounts on the ACL, and any users directly impacted by the ACL change.\n\n*Shared drive change log*\n\n: A record of all changes to a shared drive, such as additions or removals of\n users, and all changes to items on that shared drive. A change to an item\n within a shared drive appears in both the *user change log* and shared drive\n change log.\n\n*Change log entry*\n\n: A record of a change made to a file's content or metadata of a file or shared\n drive. A change log entry indicates the user who made the change, the\n timestamp, and an ID. There can only be one entry per file or shared drive\n in the change log at a time. Each time that file or shared drive changes, a\n new ID is created for that entry, and it replaces the previous entry.\n\n*Revision*\n\n: A version of the file representing a change to the file's contents (not\n metadata). Each revision can be accessed using the [`revisions`](/workspace/drive/api/reference/rest/v3/revisions) resource within the Drive API.\n\n*Head revision*\n\n: The most current version of a file. The `headRevisionId` can be accessed using\n the [`files`](/workspace/drive/api/reference/rest/v3/files) resource within the\n Drive API. The `headRevisionId` is only available for blob files\n in Drive.\n\n*Blob revision*\n\n: A version of an unmodifiable binary file, such as an image, video, or PDF. If\n the blob revision is the only revision of the binary file, it cannot be\n deleted. A new blob can be uploaded as a new *revision* , which becomes the\n new *head revision* of that file.\n\n Any blob file revision, other than the head revision, that's not designated\n as \"Keep Forever\" is purgeable. Purgeable revisions are typically preserved\n for 30 days, but can be purged earlier if a file has 100 revisions that\n aren't designated as \"Keep Forever\" and a new revision is uploaded.\n\n For more information on setting blob revisions as \"Keep Forever\", see\n [Specify revisions to save from auto\n delete](/workspace/drive/api/guides/manage-revisions#specify-revisions).\n\n*Revision history*\n\n: A record of all revisions of a file in chronological order. A change to a\n Docs, Sheets, or Slides file\n gets a new revision. Each time the content changes, Drive\n creates a new revision history entry for that file. However, these editor\n file revisions may be merged together, so the API response might not show\n all changes to a file.\n\nRelated topics\n--------------\n\n- To identify where the change you want to track is recorded, see [Identify\n which change log to track](/workspace/drive/api/guides/about-changelogs).\n- To set up change tracking for users and shared drives, see [Track changes\n for users and shared drives](/workspace/drive/api/guides/about-changes).\n- To download a blob file content revision or to export a Google Workspace document content revision, see [Download and export\n files](/workspace/drive/api/guides/manage-downloads).\n- To publish a revision, see [Manage file\n revisions](/workspace/drive/api/guides/manage-revisions).\n- To set up change notifications, see [Notifications for resource changes](/workspace/drive/api/guides/push)."]]
