Wdrażanie obsługi dysków współdzielonych

Dyski współdzielone są zależne od ustawień organizacji i własności tych dysków oraz innych ustawień udostępniania modele z Mojego dysku. Jeśli Twoja aplikacja będzie tworzyć pliki i zarządzać nimi w udostępnionych plikach musisz zaimplementować obsługę dysków współdzielonych w swojej aplikacji. Złożoność implementacja zależy od funkcji aplikacji.

Na początek musisz uwzględnić parametr zapytania supportsAllDrives=true w parametrze żądań, gdy aplikacja wykonuje wymienione poniżej operacje:

Interfejs Drive API w wersji 3

  • files.get
  • files.list
  • files.create
  • files.update
  • files.copy
  • files.delete
  • changes.list
  • changes.getStartPageToken
  • permissions.list
  • permissions.get
  • permissions.create
  • permissions.update
  • permissions.delete

Interfejs Drive API w wersji 2

  • files.get
  • files.list
  • files.insert
  • files.update
  • files.patch
  • files.copy
  • files.trash
  • files.untrash
  • files.delete
  • files.touch
  • children.insert
  • parents.insert
  • changes.list
  • changes.getStartPageToken
  • changes.get
  • permissions.list
  • permissions.get
  • permissions.insert
  • permissions.update
  • permissions.patch
  • permissions.delete

Parametr supportsAllDrives=true informuje Dysk Google, że Twoje została zaprojektowana do obsługi plików na dyskach współdzielonych.

aplikacje, które odczytują lub modyfikują uprawnienia, śledzą zmiany lub muszą wyszukiwanie w wielu korpusach wymaga dodatkowych funkcji dysku współdzielonego. W pozostałej części tego dokumentu opisujemy dodatkowe zmiany, które są wymagane te zadania.

Wyszukiwanie treści na dysku współdzielonym

Użyj metody files.list, aby wyszukać: dysków współdzielonych. W tej sekcji omówione zostaną pola dotyczące dysku współdzielonego w Metoda files.list. Aby wyszukać dysk współdzielony, zapoznaj się z artykułem Wyszukaj pliki i foldery.

Metoda files.list zawiera te udostępniane pola dotyczące dysku i tryby zapytań:

  • driveId – identyfikator dysku współdzielonego do przeszukania;

  • includeItemsFromAllDrives – określa, czy należy uwzględnić elementy z dysku współdzielonego w wynikach wyszukiwania. Jeśli nie ma tej wartości lub ma wartość Fałsz, elementy na dysku współdzielonym nie są zwracane.

  • corpora – zwłoki (pliki/dokumenty) do które ma zastosowanie w przypadku danego zapytania. Obsługiwane treści to user, domain, drive i allDrives. Ze względu na wydajność preferuj user lub drive: allDrives.

  • supportsAllDrives – określa, czy aplikacja, która wysłała żądanie, obsługuje zarówno z Mojego dysku, jak i dysków współdzielonych. Jeśli ma wartość false (fałsz), elementy na dysku współdzielonym nie są uwzględnione w odpowiedzi.

Te tryby zapytań są specyficzne dla dysków współdzielonych:

includeItemsFromAllDrives corpora Opis zapytania
true user Wyszukuje pliki, do których użytkownik miał dostęp, w tym pliki na dysku współdzielonym i pliki z Mojego dysku.
true drive Wykonuje zapytania dotyczące wszystkich elementów na podanym dysku współdzielonym. W żądaniu należy określić driveId.
true allDrives Wyszukuje pliki, do których użytkownik miał dostęp i na wszystkich dyskach współdzielonych, do których jest użytkownikiem. Pamiętaj, że odpowiedź może zawierać ciąg incompleteSearch : true, co oznacza, że dla tego żądania nie przeszukano niektórych korpusów.
true domain Wyszukuje pliki udostępnione w domenie, w tym pliki na dysku współdzielonym i pliki z Mojego dysku.

Śledzenie zmian na dysku współdzielonym

Używanie metody changes.list do śledzenia zmian na dysku współdzielonym. W tej sekcji omówione zostaną pola dotyczące dysku współdzielonego w Metoda changes.list. Więcej informacji: Śledzenie zmian wprowadzonych przez użytkowników i na dyskach współdzielonych Metoda changes.list zawiera te udostępniane pola dotyczące dysku i tryby zapytań:

  • driveId – dysk współdzielony, z którego są zwracane zmiany. Jeśli identyfikatory zmian odnoszą się do zmian na dysku współdzielonym, a nie zmiany w plikach wyświetlanych użytkownikowi. Odwołanie do konkretnego dysku współdzielonego musisz używać zarówno identyfikatora dysku współdzielonego, jak i identyfikatora zmiany.
  • supportsAllDrives – określa, czy aplikacja, która prosi o dostęp, obsługuje udostępnianie przejazdy. Jeśli ma wartość false (fałsz), elementy na dysku współdzielonym, w tym zarówno dyski współdzielone, znajdujące się na dysku współdzielonym, nie są zwracane.
  • includeItemsFromAllDrives – określa, czy pliki lub zmiany na dysku współdzielonym mają być uwzględniono na liście zmian.

Te tryby zapytań są specyficzne dla dysków współdzielonych:

includeItemsFromAllDrives driveId Opis zapytania
true Nie Zmiany obejmują zmiany w plikach na dyskach współdzielonych lub poza nimi, do których użytkownik uzyskał dostęp, a także zmiany na dyskach współdzielonych, do których użytkownik jest użytkownikiem.
true Tak Zmiany odzwierciedlają zmiany na konkretnym dysku współdzielonym i elementy na tym dysku.

Więcej informacji o działaniu historii zmian znajdziesz tutaj: Dzienniki zmian.

Włącz obsługę dysku współdzielonego w interfejsie Dysku

Aby uzyskać dostęp do treści na dysku współdzielonym za pomocą interfejsu Dysku, zaznacz „Obsługa dysków współdzielonych” w Konsola interfejsów API Google. Więcej informacji: Skonfiguruj integrację interfejsu Dysku.

Używanie selektora plików na dyskach współdzielonych

Selektor plików umożliwia wybieranie elementów na dyskach współdzielonych. Szczegółowe informacje o włączaniu obsługi dysków współdzielonych i dodawaniu tych dysków do widoku w selektorze plików skorzystaj z interfejsu Google Picker API.

Dalsze kroki

Przejdź do sekcji Zarządzanie dyskami współdzielonymi dla użytkownika pomoc w tworzeniu dysków współdzielonych i zarządzaniu ich uprawnieniami.