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 uwzględnić parametr zapytania supportsAllDrives=true w żądaniach, 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 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 wyszukują informacje 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

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 chcesz wyszukać pliki.

  • corpora: treść elementów (plików lub dokumentów), do których odnosi się zapytanie. Obsługiwane typy to user, domain, drive i allDrives. Preferuj user lub drive zamiast allDrives, aby oszczędzać energię. Domyślnie korpusy są ustawione na user.

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

  • supportsAllDrives: czy aplikacja wysyłająca żądanie obsługuje zarówno Mój dysk, jak i dysk współdzielony. Jeśli ma wartość 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 domain Wyszukuje pliki udostępnione w domenie, w tym pliki na dyskach współdzielonych i na Moim dysku.
true drive Wysyła zapytanie o wszystkie elementy na określonym dysku współdzielonym. W żądaniu należy podać wartość 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.

Śledzenie zmian na dysku współdzielonym

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

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

  • driveId: dysk współdzielony, z którego zwracane są zmiany. Jeśli podano identyfikatory zmian, odnoszą się one do zmian w elementach na dysku współdzielonym, które zawierają aktualny stan pliku. Aby odwołać się do konkretnej zmiany na dysku współdzielonym, musisz użyć identyfikatora dysku współdzielonego i identyfikatora zmiany.

  • includeItemsFromAllDrives: czy pliki na dysku współdzielonym lub zmiany powinny być uwzględnione na liście zmian.

  • 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.

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 dziennika zmian znajdziesz w artykule Śledzenie zmian wprowadzanych przez 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 na dysku współdzielonym za pomocą interfejsu Dysku, upewnij się, że na karcie Integracja interfejsu Dysku interfejsu Google Drive API w konsoli Google Cloud zaznaczono pole Obsługa dysków współdzielonych. Więcej informacji znajdziesz w artykule Konfigurowanie integracji interfejsu Dysku.

Korzystanie z selektora Google na dyskach współdzielonych

Selektor Google 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.