Różnice między interfejsem My Drive API a dyskami współdzielonymi

Dyski współdzielone korzystają z różnych modeli organizacji, udostępniania i własności, które znajdują się na Moim dysku. W związku z tym niektóre operacje na moim dysku nie są dozwolone w przypadku treści na dysku współdzielonym. Ten dokument przedstawia różnice w interfejsie API dotyczące dysków współdzielonych.

Files zasób

Te pola są wypełniane tylko w przypadku plików znajdujących się na dysku współdzielonym:

  • hasAugmentedPermissions – czy jakiejkolwiek użytkownik ma bezpośredni dostęp do tego pliku.
  • capabilities/canAddFolderFromAnotherDrive – 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ć podfoldery 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 przenosić podfoldery tego folderu na dysku współdzielonym.
  • capabilities/canMoveItemWithinDrive – określa, czy bieżący użytkownik może przenieść ten element dysku współdzielonego na tym dysku.
  • capabilities/canReadDrive – określa, czy bieżący użytkownik ma dostęp do odczytu do dysku współdzielonego, do którego należy ten plik.
  • capabilities/canTrashChildren – określa, czy bieżący użytkownik może usunąć podfoldery tego folderu.
  • driveId – identyfikator dysku współdzielonego, na którym znajduje się plik.
  • trashingUser – jeśli plik został usunięty, użytkownik, który go usunął.

  • trashedTime – czas, w którym element został przeniesiony do kosza.

W przypadku plików na dysku współdzielonym te pola nie są wypełniane:

  • permissions – ze względu na potencjalny rozmiar listy kontroli dostępu dysku współdzielonego uprawnienia nie są zwracane w ramach plików. Aby wyświetlić listę uprawnień do pliku na dysku współdzielonym lub do samego dysku współdzielonego, użyj metody permissions.list, która obsługuje podział na strony.
  • owners, ownerNames, ownedByMe – pliki na dysku współdzielonym są własnością tego dysku, a nie poszczególnych użytkowników.
  • folderColorRgb – folderów nie można oznaczać kolorami pojedynczo.
  • shared – wszystkie elementy na dysku współdzielonym są udostępnione.
  • writersCanShare – obecnie nie można ograniczyć udostępniania według ról na dyskach współdzielonych.

Te pola są ustawiane tylko wtedy, gdy użytkownik ma uprawnienia dostępu do plików dotyczące danego elementu:

  • sharedWithMeDate
  • sharingUser

Następujące pola wymagają szczególnej uwagi podczas korzystania z dysków współdzielonych:

  • parents.isRoot – to pole ma wartość true tylko w przypadku folderu głównego Mojego dysku. W przypadku folderu najwyższego poziomu dysku współdzielonego ma ono wartość false.

  • parents – element nadrzędny nie pojawia 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. Dodatkowo, z wyjątkiem folderu najwyższego poziomu, lista rodziców musi zawierać dokładnie jeden element, jeśli plik znajduje się na dysku współdzielonym.

  • capabilities/canRemoveChildren – użyj właściwości capabilities/canDeleteChildren lub capabilities/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ę skróconych uprawnień, które są ustawione lub odziedziczone przez plik na dysku współdzielonym. To pole służy tylko do wyświetlania elementów na dysku współdzielonym. Reklamy

  • zdefiniowano 2 nowe role: organizer i fileOrganizer.
  • Funkcja permissions.list obsługuje teraz podział na strony.

Changes zasób

W zasobie Changes dysku współdzielonego są dostępne te nowe pola:

  • changeType – typ zmiany. Możliwe wartości to file i drive.
  • driveId – identyfikator dysku współdzielonego powiązanego z tą zmianą.
  • drive – zaktualizowany stan dysku współdzielonego. Wyświetlany, jeśli changeType to drive, a użytkownik nadal należy do 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 Śledzenie zmian dla użytkowników i dysków współdzielonych.