Foldery to pliki zawierające tylko metadane. Mogą służyć do porządkowania plików na Dysku Google. Obejmują one te właściwości:
- Folder to plik z typem MIME
application/vnd.google-apps.folder
i nie ma rozszerzenia. - Aliasu
root
można używać do odwoływania się do folderu głównego wszędzie tam, gdzie podano identyfikator pliku.
Więcej informacji o limitach folderów na Dysku znajdziesz w artykule Limity plików i folderów.
W tym przewodniku wyjaśniono, jak wykonywać podstawowe zadania związane z folderami.
Utwórz folder
Aby utworzyć folder, użyj metody files.create
z typem MIME application/vnd.google-apps.folder
i tytułem. 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 utworzyć plik w określonym folderze za pomocą biblioteki klienta:
Java
Python
Node.js
PHP
.NET
Właściwość parents
może być używana podczas tworzenia plików w folderach najwyższego poziomu lub innych.
Przenoszenie plików między folderami
Aby przenieść pliki, musisz zaktualizować identyfikator właściwości parents
.
Aby dodać lub usunąć elementy nadrzędne w przypadku istniejącego pliku, użyj metody files.update
z parametrami zapytania addParents
i removeParents
. Poniższy przykładowy kod pokazuje, jak przenosić plik między folderami przy użyciu biblioteki klienta:
Java
Python
Node.js
PHP
.NET
Limity plików i folderów
Pliki i foldery na Dysku mają pewne limity miejsca na dane.
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. Nadal mogą wyświetlać i edytować istniejące elementy. Aby ponownie tworzyć pliki, użytkownicy muszą trwale usunąć elementy lub użyć innego konta. Więcej informacji znajdziesz w artykule Przenoszenie plików do kosza lub ich usuwanie.
Obiekty wliczane do tego limitu to:
- elementy utworzone lub przesłane przez użytkownika na Dysk;
- Elementy utworzone przez użytkownika, które stały się własnością kogoś innego
- Elementy w koszu
- Skróty
- Skróty innych firm
Obiekty, które nie wliczają się do tego limitu:
- Trwale usunięte elementy
- Elementy udostępnione użytkownikowi, ale będące własnością kogoś innego
- elementy należące do użytkownika, ale utworzone przez kogoś innego;
Próba dodania ponad 500 milionów elementów zwróci odpowiedź z kodem stanu HTTP activeItemCreationLimitExceeded
.
Limit elementów w folderze
Każdy folder na Moim dysku użytkownika może zawierać maksymalnie 500 tys. elementów. Ten limit nie dotyczy folderu głównego na Moim dysku. Limit ten wlicza się do:
- Foldery
- Pliki. wszystkich typów plików niezależnie od właściciela,
- Skróty Jest liczony jako pojedynczy element w folderze, nawet jeśli wskazany element nie znajduje się w tym folderze. 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 element, do którego prowadzi, nie znajduje się w tym folderze. Więcej informacji znajdziesz w artykule o tworzeniu pliku skrótu do treści przechowywanych przez aplikację.
Więcej informacji o limitach folderów znajdziesz w artykule Limity dotyczące folderów na Dysku Google.
Limit głębokości folderu
Mój dysk użytkownika może zawierać maksymalnie 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. Plik podrzędny o typie MIME innym niż application/vnd.google-apps.folder
nie dotyczy tego ograniczenia.
Na przykład na tym diagramie nowy folder może być zagnieżdżony w folderze o numerze 99, ale nie w folderze o numerze 100. W folderze o numerze 100 można jednak przechowywać pliki tak samo jak w każdym innym folderze na Dysku:
Próba dodania ponad 100 poziomów folderów spowoduje zwrócenie odpowiedzi z kodem stanu HTTP myDriveHierarchyDepthLimitExceeded
.