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

Dyski współdzielone mają inną organizację, model udostępniania i model własności niż Mój dysk. W związku z tym niektóre operacje na moim dysku nie są dozwolone w przypadku treści na dysku współdzielonym. Ten dokument zawiera informacje o różnicach w interfejsie API w przypadku 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 – czy bieżący użytkownik może przenosić podfoldery 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 znajdujących się na dysku współdzielonym nie są wypełniane następujące pola:

  • permissions – ze względu na potencjalny rozmiar listy kontroli dostępu do dysku współdzielonego uprawnienia nie są zwracane w ramach plików. Aby wyświetlić listę uprawnień do pliku na dysku współdzielonym lub 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ą dysku współdzielonego, 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, gdy używasz ich na dyskach współdzielonych:

  • parents.isRoot – to pole jest ustawione na 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, który wysłał żądanie, nie jest użytkownikiem dysku współdzielonego i nie ma dostępu do elementu 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 to lista skróconych uprawnień, które są ustawione lub odziedziczone przez plik na dysku współdzielonym. To pole służy tylko do wyświetlania danych i jest dostępne tylko w przypadku elementów na dysku współdzielonym. Reklamy

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

Changes zasób

W przypadku zasobu Changes na dysku współdzielonym dostępne są 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.