Dyski współdzielone korzystają z różnych modeli organizacji, udostępniania i własności, które znajdują się na Moim dysku. Z tego powodu niektóre operacje na Moim dysku nie są dozwolone w przypadku treści przechowywanych na dysku współdzielonym. Ten dokument przedstawia różnice między interfejsami API dysków współdzielonych.
Files
zasób
Te pola są wypełniane tylko w przypadku plików na dysku współdzielonym:
hasAugmentedPermissions
– określa, czy dowolny użytkownik otrzymał dostęp bezpośrednio do tego pliku.capabilities/canAddFolderFromAnotherDrive
– określa, czy bieżący użytkownik może dodać do tego folderu folder z innego dysku (innego dysku współdzielonego lub Mojego dysku).capabilities/canDeleteChildren
– określa, czy bieżący użytkownik może usuwać elementy podrzędne tego folderu.capabilities/canMoveChildrenOutOfDrive
– określa, czy bieżący użytkownik może przenieść elementy podrzędne tego folderu poza dysk współdzielony.capabilities/canMoveChildrenWithinDrive
– określa, czy bieżący użytkownik może przenieść elementy podrzędne tego folderu w obrębie dysku współdzielonego.capabilities/canMoveItemWithinDrive
– określa, czy bieżący użytkownik może przenieść ten element na dysku współdzielonym w obrębie dysku współdzielonego.capabilities/canReadDrive
– określa, czy bieżący użytkownik ma uprawnienia do odczytu dysku współdzielonego, do którego należy ten plik.capabilities/canTrashChildren
– określa, czy bieżący użytkownik może przenieść do kosza elementy podrzędne z tego folderu.driveId
– identyfikator dysku współdzielonego, na którym znajduje się plik.trashingUser
– jeśli plik został przeniesiony do kosza, użytkownik, który go umieszczał w koszu.trashedTime
– czas usunięcia elementu do kosza.
Te pola nie są wypełniane w przypadku plików na dysku współdzielonym:
permissions
– ze względu na potencjalny rozmiar list kontroli dostępu dysków współdzielonych, uprawnienia nie są zwracane jako część plików. Użyj metodypermissions.list
, która obsługuje podział na strony, aby wyświetlić listę uprawnień pliku na dysku współdzielonym lub samego dysku współdzielonego.owners
,ownerNames
,ownedByMe
– pliki na dysku współdzielonym należą do dysku współdzielonego, a nie do poszczególnych użytkowników.folderColorRgb
– foldery nie mogą mieć różnych kolorówshared
– wszystkie elementy na dysku współdzielonym są udostępnione.writersCanShare
– obecnie nie można ograniczać udostępniania według roli na dyskach współdzielonych.
Te pola są ustawiane tylko wtedy, gdy użytkownikowi przyznano uprawnienia dostępu do plików w elemencie:
sharedWithMeDate
sharingUser
Szczególną uwagę należy zwrócić na poniższe pola, gdy używasz ich na dyskach współdzielonych:
parents.isRoot
– to pole ma wartość true (prawda) tylko w przypadku folderu głównego Mojego dysku. Ma wartość false (fałsz) w przypadku folderu najwyższego poziomu na dysku współdzielonym.parents
– element nadrzędny nie pojawi się na liście elementów nadrzędnych, jeśli użytkownik wysyłający prośbę nie jest użytkownikiem dysku współdzielonego i nie ma dostępu do konta nadrzędnego. Poza tym, jeśli plik znajduje się na dysku współdzielonym, lista elementów nadrzędnych musi zawierać dokładnie 1 element (z wyjątkiem folderu najwyższego poziomu).capabilities/canRemoveChildren
– użyjcapabilities/canDeleteChildren
lubcapabilities/canTrashChildren
.
Permissions
zasób
Pole permissionDetails
jest wypełniane tylko w przypadku plików znajdujących się na dysku współdzielonym. To pole zawiera listę połączonych uprawnień, które są w tym pliku na dysku współdzielonym lub przez niego odziedziczone. To pole służy tylko do wyświetlania
elementów na dysku współdzielonym. Reklamy
- zdefiniowano 2 nowe role:
organizer
ifileOrganizer
. - Funkcja
permissions.list
obsługuje teraz podział na strony.
Changes
zasób
W zasobie Changes
dysku współdzielonego dostępne są te nowe pola:
changeType
– typ zmiany. Możliwe wartości tofile
idrive
.driveId
– identyfikator dysku współdzielonego powiązanego z tą zmianą.drive
– zaktualizowany stan dysku współdzielonego. Widoczny, jeślichangeType
ma wartośćdrive
, a użytkownik nadal jest użytkownikiem dysku współdzielonego.
W przypadku aplikacji, które muszą synchronizować treści z dyskami współdzielonymi lub śledzić aktywność, mogą być wymagane dodatkowe zmiany. Szczegółowe informacje znajdziesz w artykule na temat śledzenia zmian w przypadku użytkowników i dysków współdzielonych.