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
rootmoże służyć do odwoływania się do folderu głównego wszędzie tam, gdzie podawany jest identyfikator pliku.
Więcej informacji o limitach folderów na Dysku znajdziesz w artykule Limity liczby plików i folderów.
Z tego przewodnika dowiesz się, jak wykonywać podstawowe zadania związane z folderami.
Tworzenie folderu
Aby utworzyć folder, użyj files.create()
metody z parametrem mimeType ustawionym na application/vnd.google-apps.folder i parametrem name.
Ten przykładowy kod pokazuje, jak utworzyć folder za pomocą biblioteki klienta:
Java
Python
Node.js
PHP
.NET
curl
curl -X POST 'https://www.googleapis.com/drive/v3/files' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"name": "FOLDER_NAME",
"mimeType": "application/vnd.google-apps.folder"
}'
Zastąp te elementy:
- ACCESS_TOKEN: token OAuth 2.0 Twojej aplikacji.
- FOLDER_NAME: nazwa folderu, który chcesz utworzyć.
Tworzenie pliku w określonym folderze
Aby utworzyć plik w określonym folderze, użyj metody files.create() i określ identyfikator folderu we właściwości
parents pliku.
Właściwość parents zawiera identyfikator folderu nadrzędnego, w którym znajduje się plik.
Właściwość parents można używać podczas tworzenia plików w folderze najwyższego poziomu lub w dowolnym innym folderze.
Plik może mieć tylko 1 folder nadrzędny. Określanie wielu folderów nadrzędnych nie jest obsługiwane. Jeśli pole parents nie jest określone, plik jest umieszczany bezpośrednio w folderze Mój dysk użytkownika.
Ten przykładowy kod pokazuje, jak utworzyć plik w określonym folderze za pomocą biblioteki klienta:
Java
Python
Node.js
PHP
.NET
curl
curl -X POST 'https://www.googleapis.com/drive/v3/files' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"name": "photo.jpg",
"parents": [
"FOLDER_ID"
]
}'
Zastąp te elementy:
- ACCESS_TOKEN: token OAuth 2.0 Twojej aplikacji.
- FOLDER_ID: identyfikator folderu, w którym chcesz utworzyć plik.
Przenoszenie plików między folderami
Aby przenieść pliki, musisz zaktualizować identyfikator właściwości parents.
Aby dodać lub usunąć foldery nadrzędne istniejącego pliku, użyj metody files.update() z parametrami zapytania addParents i
removeParents.
Plik może mieć tylko 1 folder nadrzędny. Określanie wielu folderów nadrzędnych nie jest obsługiwane.
.Ten przykładowy kod pokazuje, jak przenieść plik między folderami za pomocą biblioteki klienta:
Java
Python
Node.js
PHP
.NET
curl
curl -X PATCH 'https://www.googleapis.com/drive/v3/files/FILE_ID?addParents=NEW_PARENT_ID&removeParents=PREVIOUS_PARENT_ID' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Accept: application/json'
Zastąp te elementy:
- FILE_ID: identyfikator pliku, który chcesz przenieść.
- NEW_PARENT_ID: identyfikator folderu, do którego chcesz przenieść plik.
- PREVIOUS_PARENT_ID: lista rozdzielona przecinkami folderów nadrzędnych, z których chcesz usunąć plik.
- ACCESS_TOKEN: token OAuth 2.0 Twojej aplikacji.
Limity liczby 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ć 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 Dysk. Nadal może 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 i folderów do kosza lub ich usuwanie.
Obiekty, które są wliczane do tego limitu:
- elementy utworzone lub przesłane przez użytkownika na Dysk;
- elementy utworzone przez użytkownika, które należą teraz do kogoś innego;
- elementy w koszu;
- skróty;
- skróty innych firm.
Obiekty, które nie są wliczane do tego limitu:
- 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 spowodują zwrócenie
activeItemCreationLimitExceeded
kodu stanu HTTP.
Pamiętaj, że konta usług nie mogą być właścicielami żadnych plików. Zamiast tego muszą przesyłać pliki i foldery na dyski współdzielone lub używać protokołu OAuth 2.0 do przesyłania elementów w imieniu użytkownika.
Limit elementów w folderze
Każdy folder na Moim dysku użytkownika ma limit 500 tys. elementów. Ten limit nie dotyczy folderu głównego Mojego dysku. Elementy, które są wliczane do tego limitu:
- foldery;
- pliki. Wszystkie typy plików, niezależnie od ich właściciela.
- skróty. Są liczone jako pojedynczy element w folderze, nawet jeśli prowadzą 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. Są liczone jako pojedynczy element w folderze, nawet jeśli prowadzą 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 Limity 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 folder podrzędny nie może być przechowywany w folderze, który jest głębszy 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 jest zwolniony z tego ograniczenia.
Na przykład na tym diagramie nowy folder można zagnieździć w folderze nr 99, ale nie w folderze nr 100. Folder nr 100 może jednak przechowywać pliki tak jak każdy inny folder na Dysku:
Próby dodania więcej niż 100 poziomów folderów spowodują zwrócenie kodu stanu
myDriveHierarchyDepthLimitExceeded
HTTP.
Powiązane artykuły
- Tworzenie plików i zarządzanie nimi
- Zarządzanie metadanymi plików
- Limity liczby plików i folderów na dyskach współdzielonych