Foldery to pliki zawierające tylko metadane, których można używać do porządkowania plików na Dysku Google. Mają one te właściwości:
- Folder to plik o typie MIME
application/vnd.google-apps.folder
, który nie ma rozszerzenia. - Aliasa
root
można używać do odwoływania się do folderu katalogu głównego w dowolnym miejscu, w którym podany jest identyfikator pliku.
Więcej informacji o ograniczeniach dotyczących folderów na Dysku znajdziesz w artykule Ograniczenia dotyczące plików i folderów.
Z tego przewodnika dowiesz się, jak wykonywać podstawowe czynności związane z folderami.
Utwórz folder
Aby utworzyć folder, użyj metody files.create
z typem application/vnd.google-apps.folder
MIME i tytułem. Ten przykładowy kod pokazuje, jak utworzyć folder za pomocą biblioteki klienta:
Java
Python
Node.js
PHP
.NET
Tworzenie pliku w określonym folderze
Aby utworzyć plik w określonym folderze, użyj metody files.create
i określ identyfikator folderu w właściwości parents
pliku.
Właściwość parents
zawiera identyfikator folderu nadrzędnego, w którym znajduje się plik.
Właściwości parents
można używać podczas tworzenia plików w folderze najwyższego poziomu lub dowolnym innym folderze.
Plik może mieć tylko jeden folder nadrzędny. Nie można określić wielu folderów nadrzędnych.
Ten przykładowy kod pokazuje, jak utworzyć plik w określonym folderze za pomocą biblioteki klienta:
Java
Python
Node.js
PHP
.NET
Przenoszenie plików między folderami
Aby przenieść pliki, musisz zaktualizować identyfikator usługi parents
.
Aby dodać lub usunąć rodziców istniejącego pliku, użyj metody files.update
z parametrami zapytania addParents
i removeParents
.
Plik może mieć tylko 1 folder nadrzędny. Nie można określić wielu folderów nadrzędnych.
Poniższy przykładowy kod pokazuje, jak przenosić pliki między folderami za pomocą biblioteki klienta:
Java
Python
Node.js
PHP
.NET
Limity liczby plików i folderów
Pliki i foldery na Dysku mają limity miejsca.
Limit użytkowników i elementów
Każdy użytkownik może mieć maksymalnie 500 milionów elementów utworzonych na tym koncie. Po osiągnięciu limitu użytkownik nie może już tworzyć ani przesyłać elementów na Dysku. Nadal może wyświetlać i edytować istniejące elementy. Aby utworzyć pliki ponownie, użytkownicy muszą trwale usunąć elementy lub użyć innego konta. Więcej informacji znajdziesz w artykule Przenoszenie plików i folderów do Kosza lub ich usuwanie.
Do tego limitu wliczają się te obiekty:
- elementy utworzone lub przesłane przez użytkownika na Dysku,
- elementy utworzone przez użytkownika, które należą teraz do kogoś innego;
- Elementy w koszu
- Skróty
- Skróty innych firm
Do tego limitu nie wliczają się te obiekty:
- trwale usunięte elementy,
- elementy udostępnione użytkownikowi, ale należące do kogoś innego;
- elementy należące do użytkownika, ale utworzone przez kogoś innego;
Próby dodania więcej niż 500 milionów elementów zwracają kod stanu HTTP activeItemCreationLimitExceeded
.
Pamiętaj, że chociaż nie ma limitu liczby elementów, które może mieć konto usługi, limit 500 milionów elementów dotyczy liczby elementów, które może utworzyć konto usługi.
Limit elementów folderu
Każdy folder na Moim dysku użytkownika może zawierać maksymalnie 500 tysięcy elementów. Ten limit nie dotyczy folderu głównego „Mój dysk”. Do tego limitu wliczają się:
- Foldery
- Pliki. wszystkie typy plików, niezależnie od tego, kto jest ich właścicielem.
- Skróty. Jest liczony jako pojedynczy element w folderze, nawet jeśli prowadzi do elementu, który się w tym folderze nie znajduje. Więcej informacji znajdziesz w artykule Tworzenie skrótu do pliku na Dysku.
- Skróty innych firm. Jest liczony jako pojedynczy element w folderze, nawet jeśli prowadzi do elementu, który się w tym folderze nie znajduje. Więcej informacji znajdziesz w artykule Tworzenie pliku skrótu do treści przechowywanych przez aplikację.
Więcej informacji o limitach folderów znajdziesz w artykule Ograniczenia dotyczące folderów na Dysku Google.
Limit głębokości folderów
Mój dysk użytkownika może zawierać maksymalnie 100 poziomów zagnieżdżonych folderów. Oznacza to, że folder podrzędny nie może być przechowywany w folderze o więcej niż 99 poziomach. To ograniczenie dotyczy tylko folderów podrzędnych. Plik podrzędny o innym typie MIME niż application/vnd.google-apps.folder
jest zwolniony z tego ograniczenia.
Na przykład na poniższym schemacie nowy folder może być zagnieżdżony w folderze o numerze 99, ale nie w folderze o numerze 100. Jednak w folderze o numerze 100 mogą być przechowywane pliki, tak jak ma to miejsce w każdym innym folderze na Dysku:
Próby dodania więcej niż 100 poziomów folderów zwracają kod stanu HTTP myDriveHierarchyDepthLimitExceeded
.