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

Dyski współdzielone mają inne modele organizacji, udostępniania i własności niż Mój dysk. Jeśli Twoja aplikacja ma tworzyć pliki na dyskach współdzielonych i nimi zarządzać, musisz w niej zaimplementować obsługę dysków współdzielonych. Złożoność implementacji zależy od funkcjonalności aplikacji.

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

Drive API v3

  • 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

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 Twoja aplikacja jest przeznaczona do obsługi plików na dyskach współdzielonych.

Aplikacje, które odczytują lub modyfikują uprawnienia, śledzą zmiany lub muszą wyszukiwać w wielu korpusach, wymagają dodatkowych funkcji dysku współdzielonego. W pozostałej części tego dokumentu opisujemy dodatkowe zmiany, które należy wprowadzić, aby wykonać te zadania.

Wyszukiwanie treści na dysku współdzielonym

Użyj metody files.list, aby wyszukać dyski współdzielone. Ta sekcja zawiera pola specyficzne dla dysku współdzielonego w metodzie files.list. Aby wyszukać dysk współdzielony, zapoznaj się z artykułem Wyszukiwanie plików i folderów.

Metoda files.list zawiera te pola i tryby zapytań dotyczące dysków współdzielonych:

  • driveId – identyfikator dysku współdzielonego, który ma zostać przeszukany.

  • includeItemsFromAllDrives – czy w wynikach mają być uwzględniane elementy z dysków współdzielonych. Jeśli nie jest obecny lub ma wartość Fałsz, elementy dysku współdzielonego nie są zwracane.

  • corpora – treść elementów (plików/dokumentów), do których odnosi się zapytanie. Obsługiwane typy to user, domain, drive i allDrives. Aby oszczędzać energię, wybieraj user lub drive zamiast allDrives.

  • supportsAllDrives – czy aplikacja wysyłająca żądanie obsługuje zarówno Mój dysk, jak i dyski współdzielone. Jeśli wartość to „false”, elementy na dysku współdzielonym nie są uwzględniane w odpowiedzi.

W przypadku dysków współdzielonych dostępne są te tryby zapytań:

includeItemsFromAllDrives corpora Opis zapytania
true user Wyszukuje pliki, do których użytkownik miał dostęp, w tym pliki z dysku współdzielonego i Mojego dysku.
true drive Wysyła zapytanie o wszystkie elementy na określonym dysku współdzielonym. W żądaniu musi być podany parametr driveId.
true allDrives Wyszukuje pliki, do których użytkownik miał dostęp, oraz wszystkie dyski współdzielone, do których należy. Pamiętaj, że odpowiedź może zawierać symbol incompleteSearch : true, co oznacza, że w przypadku tego żądania nie przeszukano niektórych korpusów.
true domain Wyszukuje pliki udostępnione w domenie, w tym pliki na dyskach współdzielonych i na Moim dysku.

Śledzenie zmian na dysku współdzielonym

Użyj metody changes.list, aby śledzić zmiany na dysku współdzielonym. Ta sekcja zawiera pola specyficzne dla dysku współdzielonego w metodzie changes.list. Więcej informacji znajdziesz w artykule Śledzenie zmian użytkowników i dysków współdzielonych. Metoda changes.list zawiera te pola i tryby zapytań dotyczące dysków współdzielonych:

  • driveId – dysk współdzielony, z którego zwracane są zmiany. Jeśli zostanie podany, identyfikatory zmian odnoszą się do zmian na dysku współdzielonym, a nie do zmian w plikach wyświetlanych użytkownikowi. Aby odwołać się do konkretnej zmiany na dysku współdzielonym, musisz użyć zarówno identyfikatora dysku współdzielonego, jak i identyfikatora zmiany.
  • supportsAllDrives – czy aplikacja wysyłająca żądanie obsługuje dyski współdzielone. Jeśli wartość to „false”, elementy dysku współdzielonego, w tym dyski współdzielone i pliki na dysku współdzielonym, nie są zwracane.
  • includeItemsFromAllDrives – czy pliki na dysku współdzielonym lub zmiany na nim powinny być uwzględnione na liście zmian.

W przypadku dysków współdzielonych dostępne są te tryby zapytań:

includeItemsFromAllDrives driveId Opis zapytania
true Nie Zmiany odzwierciedlają zmiany w plikach na dyskach współdzielonych i poza nimi, do których użytkownik ma dostęp, a także zmiany na dyskach współdzielonych, których jest użytkownikiem.
true Tak Zmiany odzwierciedlają zmiany na określonym dysku współdzielonym i elementach na nim.

Więcej informacji o działaniu historii zmian znajdziesz w sekcji Historia zmian.

Włączanie obsługi dysków współdzielonych w interfejsie Dysku

Aby uzyskać dostęp do treści na dysku współdzielonym za pomocą interfejsu Dysku, upewnij się, że w Konsoli interfejsów API Google masz zaznaczoną opcję „Obsługa dysków współdzielonych”. Więcej informacji znajdziesz w artykule Konfigurowanie integracji interfejsu Dysku.

Korzystanie z 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 widoku dysków współdzielonych w selektorze plików znajdziesz w artykule Interfejs Google Picker API.

Dalsze kroki

Aby dowiedzieć się więcej o tworzeniu dysków współdzielonych i zarządzaniu uprawnieniami do nich, kliknij Zarządzanie dyskami współdzielonymi.