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.getfiles.listfiles.createfiles.updatefiles.copyfiles.deletechanges.listchanges.getStartPageTokenpermissions.listpermissions.getpermissions.createpermissions.updatepermissions.delete
Drive API w wersji 2
files.getfiles.listfiles.insertfiles.updatefiles.patchfiles.copyfiles.trashfiles.untrashfiles.deletefiles.touchchildren.insertparents.insertchanges.listchanges.getStartPageTokenchanges.getpermissions.listpermissions.getpermissions.insertpermissions.updatepermissions.patchpermissions.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 touser,domain,driveiallDrives. PreferujuserlubdrivezamiastallDrives, aby oszczędzać energię. Domyślnie korpusy są ustawione nauser.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.