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 zaimplementować w niej obsługę dysków współdzielonych. Złożoność implementacji zależy od funkcjonalności aplikacji.

Na początek musisz dodać parametr zapytania supportsAllDrives=true do żądań, gdy aplikacja wykonuje te 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 v2

  • 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 wyszukują w wielu korpusach, wymagają dodatkowych funkcji dysku współdzielonego. W pozostałej części tego dokumentu opisujemy dodatkowe zmiany wymagane do wykonania tych zadań.

Wyszukiwanie treści na dysku współdzielonym

Aby znaleźć pliki użytkownika na dyskach współdzielonych, użyj metody list w zasobie files. Aby wyszukać dysk współdzielony, przeczytaj artykuł Wyszukiwanie dysków współdzielonych.

Metoda list zawiera te parametry zapytania dotyczące dysków współdzielonych:

  • driveId: identyfikator dysku współdzielonego, na którym ma być prowadzone wyszukiwanie.

  • corpora: korpusy elementów (plików lub dokumentów), do których odnosi się zapytanie. Obsługiwane korpusy to user, domain, drive i allDrives. Aby zwiększyć wydajność, używaj korpusów user lub drive zamiast allDrives. Domyślnie korpusy są ustawione na user.

  • includeItemsFromAllDrives: informacja o tym, czy w wynikach mają być uwzględniane elementy z Mojego dysku i dysków współdzielonych. Jeśli ten parametr nie jest obecny lub ma wartość false, elementy z dysków współdzielonych nie są zwracane.

  • supportsAllDrives: informacja o tym, czy aplikacja wysyłająca żądanie obsługuje Mój dysk i dyski współdzielone. Jeśli wartość to false, elementy z dysków współdzielonych nie są uwzględniane w odpowiedzi.

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

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

Śledzenie zmian na dysku współdzielonym

Aby śledzić zmiany na dysku współdzielonym, użyj metody list w zasobie changes. Więcej informacji znajdziesz w artykule Śledzenie zmian u użytkowników i na dyskach współdzielonych.

Metoda list zawiera te parametry zapytania dotyczące dysków współdzielonych:

  • driveId: dysk współdzielony, z którego mają być zwracane zmiany. Jeśli ten parametr jest określony, identyfikatory zmian odnoszą się do zmian elementów na dysku współdzielonym, które odzwierciedlają bieżący stan pliku. Aby odwołać się do konkretnej zmiany na dysku współdzielonym, należy użyć identyfikatora dysku współdzielonego i identyfikatora zmiany.

  • includeItemsFromAllDrives: informacja o tym, czy pliki lub zmiany na dysku współdzielonym mają być uwzględniane na liście zmian.

  • supportsAllDrives: informacja o tym, czy aplikacja wysyłająca żądanie obsługuje dyski współdzielone. Jeśli wartość to false, elementy z dysków współdzielonych, w tym dyski współdzielone i pliki na dysku współdzielonym, nie są zwracane.

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

includeItemsFromAllDrives driveId Opis zapytania
true Nie Zmiany odzwierciedlają zmiany plików wewnątrz i na zewnątrz dysków współdzielonych, do których użytkownik miał dostęp, oraz zmiany na dyskach współdzielonych, których użytkownik jest członkiem.
true Tak Zmiany odzwierciedlają zmiany na określonym dysku współdzielonym i elementach na tym dysku.

Więcej informacji o działaniu dziennika zmian znajdziesz w artykule Śledzenie zmian u użytkowników i na dyskach współdzielonych.

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

Aby uzyskać dostęp do treści dysku współdzielonego za pomocą interfejsu Dysku, upewnij się, że w konsoli Google Cloud na karcie Integracja z interfejsem Dysku w interfejsie Google Drive API masz zaznaczone pole Obsługa dysków współdzielonych. Więcej informacji znajdziesz w artykule Konfigurowanie integracji z interfejsem Dysku.

Korzystanie z Google Picker z dyskami współdzielonymi

Google Picker umożliwia wybieranie elementów na dyskach współdzielonych. Szczegółowe informacje o włączaniu obsługi dysków współdzielonych i dodawaniu widoków dysków współdzielonych w selektorze znajdziesz w artykule Interfejs Google Picker API.