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 za pomocą interfejsu Google Drive API.
Jeśli chcesz określić pola, które mają być zwracane w odpowiedzi, możesz ustawić fields
parametr system
w dowolnej metodzie zasobu drives
. Jeśli nie określisz parametru fields
, serwer zwróci domyślny zestaw pól
specyficzny dla danej metody. Na przykład metoda list
zwraca tylko pola kind
, id
i name
dla każdego dysku współdzielonego. Więcej informacji znajdziesz w sekcji Zwracanie określonych pól.
Więcej informacji o limitach dotyczących folderów na dyskach współdzielonych znajdziesz w artykule Limity dotyczące folderów na dyskach współdzielonych.
Tworzenie dysku współdzielonego
Aby utworzyć dysk współdzielony, użyj metody create
w zasobie drives
z parametrem requestId
.
Parametr requestId
identyfikuje logiczną próbę idempotentnego utworzenia dysku współdzielonego. Jeśli żądanie przekroczy limit czasu lub zwróci nieokreślony błąd backendu, można je powtórzyć bez tworzenia duplikatów. requestId
i treść żądania muszą pozostać bez zmian.
Poniższy przykładowy kod pokazuje, jak utworzyć dysk współdzielony:
Java
Python
Node.js
PHP
.NET
Wywołania metody create
są idempotentne.
Jeśli dysk współdzielony został utworzony w ramach poprzedniego żądania lub w wyniku ponowienia próby, metoda zwraca instancję zasobu drives
. Czasami, np. po dłuższym czasie lub jeśli zmieni się treść żądania, może zostać zwrócony błąd 409
, który wskazuje, że należy odrzucić requestId
.
Uzyskiwanie dysku współdzielonego
Aby uzyskać metadane dysku współdzielonego, użyj metody get
w zasobie drives
z parametrem ścieżki driveId
. Jeśli nie znasz identyfikatora dysku, możesz wyświetlić listę wszystkich dysków współdzielonych za pomocą metody list
.
Metoda get
zwraca dysk współdzielony jako instancję zasobu drives
.
Aby wysłać żądanie jako administrator domeny, ustaw parametr zapytania useDomainAdminAccess
na true
. Więcej informacji znajdziesz w artykule Zarządzanie dyskami współdzielonymi jako administrator domeny.
Wyświetlanie listy dysków współdzielonych
Aby wyświetlić listę dysków współdzielonych użytkownika, użyj metody list
w zasobie drives
. Metoda zwraca listę dysków współdzielonych.
Przekaż te parametry zapytania, aby dostosować stronicowanie dysków współdzielonych lub je filtrować:
pageSize
: maksymalna liczba dysków współdzielonych do zwrócenia na stronie.pageToken
: token strony otrzymany z poprzedniego wywołania listy. Podaj ten token, aby pobrać następną stronę.q
: ciąg zapytania do wyszukiwania dysków współdzielonych. Więcej informacji znajdziesz w artykule Wyszukiwanie dysków współdzielonych.useDomainAdminAccess
: ustaw natrue
, aby wysłać żądanie jako administrator domeny i zwrócić wszystkie dyski współdzielone w domenie, w której osoba wysyłająca żądanie jest administratorem. Więcej informacji znajdziesz w artykule Zarządzanie dyskami współdzielonymi jako administrator domeny.
Aktualizowanie dysku współdzielonego
Aby zaktualizować metadane dysku współdzielonego, użyj metody update
w zasobie drives
z parametrem ścieżki driveId
.
Metoda zwraca dysk współdzielony jako instancję zasobu drives
.
Aby wysłać żądanie jako administrator domeny, ustaw parametr zapytania useDomainAdminAccess
na true
. Więcej informacji znajdziesz w artykule Zarządzanie dyskami współdzielonymi jako administrator domeny.
Ukrywanie i odkrywanie dysku współdzielonego
Aby ukryć dysk współdzielony w widoku domyślnym, użyj metody hide
w zasobie drives
z parametrem driveId
.
Gdy dysk współdzielony jest ukryty, Dysk oznacza zasób dysku współdzielonego jako hidden=true
. Ukryte dyski współdzielone nie pojawiają się w interfejsie Dysku ani na liście zwróconych plików.
Aby przywrócić domyślny widok dysku współdzielonego, użyj metody unhide
w zasobie drives
z parametrem driveId
.
Obie metody zwracają dysk współdzielony jako instancję zasobu drives
.
Usuwanie dysku współdzielonego
Aby trwale usunąć dysk współdzielony, użyj metody delete
w zasobie drives
z parametrem driveId
.
Zanim usuniesz dysk współdzielony, musisz przenieść całą jego zawartość do kosza lub ją usunąć. Użytkownik musi mieć też role=organizer
w folderze dysku współdzielonego. Więcej informacji znajdziesz w artykule Przenoszenie plików i folderów do kosza lub usuwanie ich.
Przekaż te parametry zapytania, aby filtrować dyski współdzielone:
useDomainAdminAccess
: ustaw natrue
, aby wysłać żądanie jako administrator domeny i zwrócić wszystkie dyski współdzielone w domenie, w której osoba wysyłająca żądanie jest administratorem. Więcej informacji znajdziesz w artykule Zarządzanie dyskami współdzielonymi jako administrator domeny.allowItemDeletion
: ustaw natrue
, aby usunąć elementy z dysku współdzielonego. Obsługiwane tylko wtedy, gdy parametruseDomainAdminAccess
ma wartośćtrue
.
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 uprawnienia na dysku współdzielonym. Metody uprawnień można też stosować do poszczególnych plików na dysku współdzielonym, aby przyznawać użytkownikom dodatkowe uprawnienia lub zezwalać osobom niebędącym użytkownikami dysku 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.
Zarządzanie dyskami współdzielonymi jako administrator domeny
Zastosuj parametr useDomainAdminAccess
z zasobami drives
i permissions
, aby zarządzać dyskami współdzielonymi w organizacji.
Użytkownicy wywołujący te metody z parametrem useDomainAdminAccess=true
muszą mieć Drive and Docs
uprawnienia administratora.
Administratorzy mogą wyszukiwać dyski współdzielone lub aktualizować uprawnienia do dysków współdzielonych należących do organizacji, niezależnie od tego, czy administrator jest użytkownikiem danego dysku współdzielonego.
Podczas korzystania z kont usług może być konieczne podszywanie się pod uwierzytelnionego administratora za pomocą podszywania się pod konto usługi. Pamiętaj, że konta usługi nie należą do Twojej domeny Google Workspace, w przeciwieństwie do kont użytkowników. Jeśli udostępniasz zasoby Google Workspace, takie jak dokumenty czy wydarzenia, całej domenie Google Workspace, nie są one udostępniane kontom usługi. Więcej informacji znajdziesz w artykule Omówienie kont usługi.
Odzyskiwanie dysku współdzielonego, który nie ma organizatora
Poniższy przykładowy kod pokazuje, jak odzyskać dyski współdzielone, które nie mają już organizatora.
Java
Python
Node.js
PHP
.NET
Uniemożliwianie użytkownikom pobierania, drukowania i kopiowania pliku
Możesz ograniczyć sposoby pobierania, drukowania i kopiowania plików przez użytkowników na dyskach współdzielonych.
Aby sprawdzić, czy użytkownik może zmienić ograniczenia pobierania zastosowane przez organizatora na dysku współdzielonym, sprawdź pole logiczne capabilities.canChangeDownloadRestriction
. Jeśli
capabilities.canChangeDownloadRestriction
ma wartość true
, można zastosować ograniczenia pobierania do dysku współdzielonego. Więcej informacji znajdziesz w artykule Omówienie możliwości plików.
Zasób drives
zawiera zbiór pól
boolean restrictions
używanych do określania, czy można wykonać działanie na dysku współdzielonym.
Ograniczenia dotyczą dysku współdzielonego lub elementów na nim.
Ograniczenia można ustawić za pomocą metody drives.update
.
Aby zastosować ograniczenia pobierania na dysku współdzielonym, menedżer dysku współdzielonego może ustawić pole restrictions.downloadRestriction
zasobu drives
za pomocą obiektu DownloadRestriction
.
Ustawienie pola logicznego restrictedForReaders
na true
oznacza, że pobieranie i kopiowanie są ograniczone dla czytelników. Ustawienie pola logicznego restrictedForWriters
true
oznacza, że zarówno pobieranie, jak i kopiowanie są ograniczone dla autorów. Pamiętaj, że jeśli pole restrictedForWriters
ma wartość true
, pobieranie i kopiowanie jest również ograniczone dla czytelników. Podobnie ustawienie restrictedForWriters
na true
i restrictedForReaders
na false
jest równoznaczne z ustawieniem zarówno restrictedForWriters
, jak i restrictedForReaders
na true
.
Zgodność wsteczna
Wraz z wprowadzeniem obiektu DownloadRestriction
zaktualizowaliśmy działanie pola logicznego restrictions.copyRequiresWriterPermission
.
Teraz ustawienie wartości restrictions.copyRequiresWriterPermission
na true
aktualizuje pole logiczne restrictedForReaders
obiektu DownloadRestriction
na true
, aby zadeklarować, że zarówno pobieranie, jak i kopiowanie są ograniczone dla czytelników.
Ustawienie pola copyRequiresWriterPermission
na false
powoduje zaktualizowanie pól restrictedForWriters
i restrictedForReaders
do wartości false
. Oznacza to, że ustawienia ograniczeń pobierania lub kopiowania zostaną usunięte w przypadku wszystkich użytkowników.
Pola, które kontrolują funkcje pobierania, drukowania i kopiowania
W tabeli poniżej znajdziesz listę pól zasobu drives
, które wpływają na funkcje pobierania, drukowania i kopiowania:
Pole | Opis | Wersja |
---|---|---|
capabilities.canCopy |
Określa, czy bieżący użytkownik może kopiować pliki na dysku współdzielonym. | wersje 2 i 3 |
capabilities.canDownload |
Określa, czy bieżący użytkownik może pobierać pliki z dysku współdzielonego. | wersje 2 i 3 |
capabilities.canChangeCopyRequiresWriterPermission |
Określa, czy bieżący użytkownik może zmienić copyRequiresWriterPermission ograniczenia dysku współdzielonego. |
wersje 2 i 3 |
capabilities.canResetDriveRestrictions |
Określa, czy bieżący użytkownik może przywrócić domyślne ograniczenia dysku współdzielonego. | wersje 2 i 3 |
capabilities.canChangeDownloadRestriction |
Określa, czy bieżący użytkownik może zmienić ograniczenie pobierania dysku współdzielonego. | Tylko wersja 3 |
restrictions.copyRequiresWriterPermission |
Czy opcje kopiowania, drukowania i pobierania plików na dysku współdzielonym są wyłączone dla osób z uprawnieniami do odczytu i komentowania. Gdy true , w przypadku każdego pliku na tym dysku współdzielonym ustawia pole o podobnej nazwie na true . |
wersje 2 i 3 |
restrictions.downloadRestriction |
Ograniczenia pobierania zastosowane przez menedżerów dysku współdzielonego. | Tylko wersja 3 |
Limity liczby folderów
Foldery na dyskach współdzielonych 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
Dysk współdzielony każdego użytkownika może zawierać maksymalnie 500 tys. elementów, w tym plików, folderów i skrótów.
Po osiągnięciu limitu dysk współdzielony nie będzie mógł już przyjmować elementów. Aby ponownie zacząć otrzymywać pliki, użytkownicy muszą trwale usunąć elementy z dysku współdzielonego. Pamiętaj, że elementy w koszu wliczają się 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 folderu
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, który jest zagnieżdżony na więcej niż 99 poziomach. To ograniczenie dotyczy tylko folderów podrzędnych.
Próba dodania więcej niż 100 poziomów folderów zwraca kod stanu HTTP teamDriveHierarchyTooDeep
.