Przenoszenie do kosza lub usuwanie plików i folderów

Możesz usuwać pliki i foldery z Dysku Google zarówno z Mojego dysku, jak i z dysków współdzielonych. Możesz to zrobić na 2 sposoby: przenieść do kosza lub usunąć.

Możesz przenosić pliki i foldery do kosza, a następnie je przywracać (w ciągu 30 dni od przeniesienia do kosza). Usunięcie plików i folderów jest nieodwracalne. Jeśli usuniesz, przywrócisz albo trwale usuniesz wiele plików lub folderów naraz, zmiany mogą być widoczne dopiero po jakimś czasie.

Uwaga: w tym dokumencie „pliki” oznaczają zarówno pliki, jak i foldery. Foldery to pliki, które zawierają tylko metadane i mogą służyć do porządkowania plików na Dysku. Folder to plik o typie MIME application/vnd.google-apps.folder i bez rozszerzenia. Więcej informacji znajdziesz w artykule Tworzenie folderów i wypełnianie ich zawartością.

Z tego przewodnika dowiesz się, jak usuwać pliki z Dysku.

Kosz

Aby usunąć pliki z Dysku, możesz przenieść je do kosza. Pliki w koszu są automatycznie usuwane po 30 dniach. Możesz przywrócić pliki z kosza przed upływem 30-dniowego okresu.

Tylko właściciel pliku może przenieść go do kosza, a inni użytkownicy nie mogą wyświetlać plików w koszu właściciela. Jeśli spróbujesz przenieść do kosza plik, którego nie jesteś właścicielem, pojawi się komunikat o błędzieinsufficientFilePermissions. Więcej informacji znajdziesz w sekcji Uprawnienia.

Aby potwierdzić, że jesteś właścicielem pliku, wywołaj metodę files.get z parametrami fileId i fields ustawionymi na wartość logiczną pola ownedByMe. Pole ownedByMe nie jest wypełniane w przypadku plików na dyskach współdzielonych, ponieważ należą one do dysku współdzielonego, a nie do poszczególnych użytkowników. Więcej informacji o zwracaniu pól za pomocą parametru fields znajdziesz w artykule Zwracanie określonych pól w przypadku pliku.

Jeśli nie jesteś właścicielem pliku, ale chcesz mieć jego kopię, wykonaj jedną z tych czynności:

• utwórz jego kopię,
• Skontaktuj się z właścicielem i poproś o przywrócenie pliku z kosza.

Przenoszenie pliku do kosza

Aby przenieść plik do kosza, użyj metody files.update i ustaw pole trashed na True. Aby przenieść plik z dysku współdzielonego do kosza, musisz też ustawić parametr zapytania supportsAllDrives na True. Więcej informacji znajdziesz w artykule Wdrażanie obsługi dysków współdzielonych.

Jeśli operacja się uda, treść odpowiedzi będzie zawierała instancję zasobu files.

Uwaga: jeśli używasz poprzedniej wersji interfejsu Drive API v2, użyj metody files.trash. Dowiedz się, jak przeprowadzić migrację do interfejsu Drive API w wersji 3.

Poniższy przykładowy kod pokazuje, jak użyć parametru fileId, aby oznaczyć plik jako przeniesiony do kosza:

Python

body_value = {'trashed': True}

response = drive_service.files().update(fileId="FILE_ID", body=body_value).execute()

Node.js

const body_value = {
  'trashed': true
};

const response = await drive_service.files.update({
      fileId: 'FILE_ID',
      requestBody: body_value,
    });
    return response;

Zastąp FILE_ID identyfikatorem fileId pliku, który chcesz przenieść do kosza.

Sprawdzanie właściwości pliku w koszu

Gdy plik zostanie przeniesiony do kosza, możesz pobrać dodatkowe właściwościfiles. Możesz użyć metody files.get i uwzględnić te pola w parametrze fields. Więcej informacji znajdziesz w artykule Zwracanie określonych pól pliku.

W przypadku wszystkich plików wypełniane są te pola:

• trashed: czy plik został usunięty do kosza, bezpośrednio lub z usuniętego do kosza folderu nadrzędnego. Pamiętaj, że użycie trashed z metodą files.update ustawia stan pliku, a metoda files.get pobiera stan pliku.
• explicitlyTrashed: czy plik został usunięty do kosza bezpośrednio, a nie rekursywnie z folderu nadrzędnego.

Te pola są wypełniane tylko w przypadku plików znajdujących się na dysku współdzielonym:

• trashedTime: czas przeniesienia elementu do kosza w formacie daty i godziny RFC 3339. Jeśli używasz poprzedniej wersji interfejsu Drive API v2, to pole nazywa się trashedDate.
• trashingUser: jeśli plik został wyraźnie przeniesiony do kosza, użytkownik, który to zrobił.

Przywracanie pliku z kosza

Aby przywrócić plik z kosza, użyj metody files.update i ustaw pole trashed na False. Aby przywrócić plik z dysku współdzielonego, musisz też ustawić parametr zapytania supportsAllDrives na True. Więcej informacji znajdziesz w artykule Wdrażanie obsługi dysków współdzielonych.

Jeśli operacja się uda, treść odpowiedzi będzie zawierała instancję zasobu files.

Uwaga: jeśli używasz poprzedniej wersji interfejsu Drive API v2, użyj metody files.untrash. Dowiedz się, jak przeprowadzić migrację do interfejsu Drive API w wersji 3.

Poniższy przykładowy kod pokazuje, jak użyć fileId, aby oznaczyć plik jako nieusunięty:

Python

body_value = {'trashed': False}

response = drive_service.files().update(fileId="FILE_ID", body=body_value).execute()

Node.js

const body_value = {
  'trashed': false
};

const response = await drive_service.files.update({
      fileId: 'FILE_ID',
      requestBody: body_value,
    });
    return response;

Zastąp symbol FILE_ID symbolem fileId pliku, który chcesz przywrócić.

Opróżnij kosz

Możesz trwale usunąć wszystkie pliki z Dysku, które użytkownik przeniósł do kosza, korzystając z metody files.emptyTrash. Aby opróżnić kosz dysku współdzielonego, musisz też ustawić parametr zapytania driveId na identyfikator dysku współdzielonego.

Jeśli operacja się uda, treść odpowiedzi będzie zawierała pustą instancję.

Uwaga: jeśli używasz poprzedniej wersji interfejsu Drive API v2, użyj metody files.emptyTrash. Dowiedz się, jak przeprowadzić migrację do interfejsu Drive API w wersji 3.

Poniższy przykładowy kod pokazuje, jak użyć fileId, aby usunąć wszystkie pliki z kosza:

Python

response = drive_service.files().emptyTrash().execute()

Node.js

 const response = await drive_service.files.emptyTrash({
    });
    return response;

Usuń

Możesz trwale usunąć plik z Dysku bez przenoszenia go do kosza. Gdy usuniesz plik, każda osoba, której go udostępniono, utraci do niego dostęp. Jeśli chcesz, aby inne osoby nadal miały dostęp do pliku, przed jego usunięciem możesz przenieść własność na inną osobę.

Aby usunąć plik z dysku współdzielonego, użytkownik musi mieć uprawnienia role=organizer w folderze nadrzędnym. Jeśli usuwasz folder, wszystkie należące do użytkownika elementy podrzędne również zostaną usunięte. Więcej informacji znajdziesz w sekcji Uprawnienia.

Aby trwale usunąć plik należący do użytkownika bez przenoszenia go do kosza, użyj metody files.delete. Aby usunąć plik z dysku współdzielonego, musisz też ustawić parametr zapytania supportsAllDrives na True. Więcej informacji znajdziesz w artykule Wdrażanie obsługi dysków współdzielonych.

Jeśli operacja się uda, treść odpowiedzi będzie zawierała pustą instancję.

Uwaga: jeśli używasz poprzedniej wersji interfejsu Drive API v2, użyj metody files.delete. Dowiedz się, jak przeprowadzić migrację do interfejsu Drive API w wersji 3.

Poniższy przykładowy kod pokazuje, jak usunąć plik za pomocą fileId:

Python

response = drive_service.files().delete(fileId="FILE_ID").execute()

Node.js

 const response = await drive_service.files.delete({
      fileId: 'FILE_ID'
    });
    return response;

Zastąp symbol FILE_ID symbolem fileId pliku, który chcesz usunąć.

Uprawnienia

W tabeli poniżej przedstawiono uprawnienia wymagane do wykonania poszczególnych operacji. Pełną listę ról i operacji, które umożliwiają, znajdziesz w artykule Role i uprawnienia.

Dozwolona operacja	owner	organizer	fileOrganizer	writer	commenter	reader
Przenoszenie plików i folderów do kosza	✔	✔	✔
Przywracanie plików i folderów z kosza	✔	✔	✔
Opróżnij kosz.	✔	✔
Trwałe usuwanie pliku lub folderu	✔	✔
Usuwanie plików i folderów z dysku współdzielonego ^[*]		✔

[*] Wymaga roli organizer w bezpośrednim lub pośrednim elemencie nadrzędnym, a nie w samym elemencie.

Uprawnienia

Zasób files zawiera zbiór pól logicznych capabilities, które wskazują, czy można wykonać działanie na pliku.

Aby sprawdzić możliwości, wywołaj metodę files.get z parametrami fileId i fields ustawionymi na pole capabilities. Więcej informacji o zwracaniu pól za pomocą parametru fields znajdziesz w artykule Zwracanie określonych pól pliku.

W przypadku wszystkich plików wypełniane są te pola:

• capabilities.canTrash: czy bieżący użytkownik może przenieść ten plik do kosza.
• capabilities.canUntrash: czy bieżący użytkownik może przywrócić ten plik z kosza.
• capabilities.canDelete: określa, czy obecny użytkownik może usunąć ten plik.
• capabilities.canRemoveChildren: Określa, czy obecny użytkownik może usuwać elementy podrzędne z tego folderu. Wartość false, jeśli element nie jest folderem.

Te pola są wypełniane tylko w przypadku plików znajdujących się na dysku współdzielonym:

• capabilities.canTrashChildren: Określa, czy bieżący użytkownik może przenieść do kosza elementy podrzędne tego folderu. Wartość false, jeśli element nie jest folderem.
• capabilities.canDeleteChildren: Określa, czy obecny użytkownik może usuwać elementy podrzędne tego folderu. Wartość false, jeśli element nie jest folderem.

Limity liczby plików i folderów

Pliki i foldery na Dysku, a także foldery na dyskach współdzielonych mają pewne limity miejsca na dane.

Zwykle po osiągnięciu limitu elementów jedynym sposobem na zwolnienie miejsca jest trwałe usunięcie elementów lub użycie innego konta. Przeniesienie plików do kosza nie wystarczy, aby zwolnić miejsce.

Więcej informacji o limitach plików i folderów znajdziesz w tych artykułach:

• Limity liczby plików i folderów
• Limity liczby plików i folderów na dyskach współdzielonych

Powiązane artykuły

• Usuwanie plików na Dysku Google
• Różnice między interfejsami API dysku współdzielonego i Mojego dysku
• Role i uprawnienia