Foldery to pliki, które zawierają tylko metadane i mogą służyć 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. - Alias
root
może służyć do odwoływania się do folderu głównego wszędzie tam, gdzie podany jest identyfikator pliku.
Więcej informacji o limitach dotyczących folderów Dysku znajdziesz w artykule Limity dotyczące plików i folderów.
W tym przewodniku objaśniono sposób wykonywania podstawowych zadań związanych z folderami.
Utwórz folder
Aby utworzyć folder, użyj metody files.create
z typem MIME i tytułem application/vnd.google-apps.folder
. Poniższy 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 podaj identyfikator folderu we właściwości parents
pliku. Właściwość parents
zawiera identyfikatory folderów nadrzędnych, które zawierają plik. Poniższy przykładowy kod pokazuje, jak za pomocą biblioteki klienta utworzyć plik w określonym folderze:
Java
Python
Node.js
PHP
.NET
właściwości parents
można używać podczas tworzenia plików w folderze najwyższego poziomu lub dowolnym innym folderze.
Przenoszenie plików między folderami
Aby przenieść pliki, musisz zaktualizować identyfikator usługi parents
.
Aby dodać lub usunąć elementy nadrzędne w istniejącym pliku, użyj metody files.update
z parametrami zapytania addParents
i removeParents
. Poniższy przykładowy kod pokazuje, jak przenosić plik między folderami za pomocą biblioteki klienta:
Java
Python
Node.js
PHP
.NET
Limity dotyczące plików i folderów
Pliki i foldery na Dysku mają pewne limity miejsca.
Limit elementów użytkownika
Każdy użytkownik może mieć do 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. Będą oni nadal mogli wyświetlać i edytować istniejące elementy. Aby ponownie utworzyć pliki, użytkownicy muszą trwale usunąć elementy lub użyć innego konta. Więcej informacji znajdziesz w artykule Kosz i usuwanie plików i folderów.
Obiekty wliczające się do tego limitu:
- elementów utworzonych lub przesłanych na Dysk przez użytkownika;
- Elementy utworzone przez użytkownika, ale teraz należące do kogoś innego
- Elementy w koszu
- Skróty
- Skróty innych firm
Obiekty, które nie wliczają się do tego limitu, to:
- Elementy usunięte na stałe
- elementy udostępnione użytkownikowi, które należą do kogoś innego;
- elementów należących do użytkownika, ale utworzonych przez kogoś innego;
Próba dodania ponad 500 milionów elementów zwraca odpowiedź z kodem 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 to konto może utworzyć.
Limit elementów w folderze
Każdy folder na Moim dysku użytkownika może zawierać maksymalnie 500 tysięcy elementów. Ten limit nie dotyczy folderu głównego Mojego dysku. Limit ten obejmuje następujące elementy:
- Foldery
- Pliki. Wszystkie typy plików niezależnie od własności.
- Skróty Są zliczane jako pojedynczy element w folderze, nawet jeśli element, do którego prowadzi, nie znajduje się w tym folderze. Więcej informacji znajdziesz w sekcji Tworzenie skrótu do pliku na Dysku.
- Skróty innych firm. Są zliczane jako pojedynczy element w folderze, nawet jeśli element, do którego prowadzi, nie znajduje się w tym folderze. Więcej informacji znajdziesz w artykule Tworzenie pliku skrótu do treści przechowywanej przez aplikację.
Więcej informacji o limitach dotyczących folderów znajdziesz w artykule Limity dotyczące folderów na Dysku Google.
Limit głębokości folderów
Mój dysk użytkownika nie może zawierać więcej niż 100 poziomów zagnieżdżonych folderów. Oznacza to, że folderu podrzędnego nie można przechowywać w folderze, który ma więcej niż 99 poziomów. To ograniczenie dotyczy tylko folderów podrzędnych. Ograniczenie to nie obowiązuje w przypadku pliku podrzędnego z typem MIME innym niż application/vnd.google-apps.folder
.
Na przykład na poniższym diagramie nowy folder może być zagnieżdżony w folderze numer 99, ale nie w folderze numer 100. Folder 100 może jednak przechowywać pliki tak jak każdy inny folder na Dysku:
Próba dodania ponad 100 poziomów folderów zwraca odpowiedź kodu stanu HTTP myDriveHierarchyDepthLimitExceeded
.