Ten przewodnik zawiera zadania związane z zarządzaniem dyskami współdzielonymi, takie jak tworzenie dysków współdzielonych oraz zarządzanie użytkownikami i uprawnieniami.
Więcej informacji o limitach folderów na dysku współdzielonym znajdziesz w artykule Limity folderów.
Tworzenie dysków współdzielonych
Aby utworzyć dysk współdzielony, użyj metody drives.create
.
Java
Python
Node.js
PHP
.NET
Wywołania metody drives.create
są idempotentne.
Parametr requestId
wskazuje logiczną próbę utworzenia udostępnionego dysku. Jeśli żądanie zostanie odrzucone z nieokreślonym błędem serwera lub upłynie limit czasu jego przetwarzania, można je powtórzyć. requestId
i treść żądania muszą pozostać takie same.
Jeśli dysk współdzielony został utworzony w ramach poprzedniego żądania lub w wyniku ponownego próby, zwracana jest normalna odpowiedź. Czasami, np. po długim czasie lub gdy treść żądania ulegnie zmianie, może zostać zwrócony błąd 409
, który wskazuje, że requestId
należy odrzucić.
Dodawanie i usuwanie użytkowników dysku współdzielonego
Dodawaj i usuwaj użytkowników dysku współdzielonego za pomocą zasobu permissions
.
Aby dodać użytkownika, utwórz uprawnienie na dysku współdzielonym. Metody przyznawania uprawnień można też stosować w przypadku poszczególnych plików na dysku współdzielonym, aby przyznać użytkownikom dodatkowe uprawnienia lub zezwolić użytkownikom spoza zespołu na współpracę nad określonymi elementami.
Więcej informacji i przykładowy kod znajdziesz w artykule Udostępnianie plików, folderów i dysków.
Usuwanie dysku współdzielonego
Aby usunąć dysk współdzielony, użyj metody drives.delete
. Przed usunięciem dysku współdzielonego należy przenieść wszystkie jego treści do kosza lub usunąć je.
Zarządzanie dyskami współdzielonymi przez administratorów domen
Aby zarządzać dyskami współdzielonymi w całej organizacji, zastosuj parametr useDomainAdminAccess
z zasobami drives
i permissions
.
Użytkownicy wywołujący te metody za pomocą useDomainAdminAccess=true
muszą mieć Drive and Docs
uprawnienia administratora.
Administratorzy mogą wyszukiwać dyski współdzielone lub aktualizować uprawnienia dysków współdzielonych należących do ich organizacji niezależnie od tego, czy administrator jest członkiem danego dysku współdzielonego.
Przywracanie dysku współdzielonego, który nie ma organizatora
W tym przykładzie pokazujemy, jak użyć tych zasobów do odzyskania dysków współdzielonych, które nie mają już organizatora.
Java
Python
Node.js
PHP
.NET
Limity liczby folderów
Foldery na dysku współdzielonym mają pewne limity miejsca na dane. Więcej informacji znajdziesz w artykule Ograniczenia związane z dyskami współdzielonymi na Dysku Google.
Limit elementów
Każdy folder na dysku współdzielonym użytkownika może zawierać maksymalnie 500 tysięcy elementów, w tym plików, folderów i skrótów.
Po osiągnięciu limitu dysk współdzielony nie może już przyjmować elementów. Aby ponownie otrzymywać pliki, użytkownicy muszą trwale usunąć elementy z folderu. Pamiętaj, że elementy w koszu są wliczane do limitu, ale trwale usunięte elementy nie. Więcej informacji znajdziesz w artykule Przenoszenie plików i folderów do Kosza lub ich usuwanie.
Limit głębokości folderów
Folder na dysku współdzielonym nie może zawierać więcej niż 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.
Próby dodania więcej niż 100 poziomów folderów zwracają kod stanu HTTP teamDriveHierarchyTooDeep
.