Dyski współdzielone korzystają z różnych modeli organizacji, udostępniania i własności w sekcji Mój dysk. Jeśli Twoja aplikacja ma tworzyć pliki na dyskach współdzielonych i nimi zarządzać, musisz w niej wdrożyć obsługę dysków współdzielonych. Złożoność implementacji zależy od funkcji aplikacji.
Na początek musisz uwzględniać w żądaniach parametr zapytania supportsAllDrives=true
, gdy aplikacja wykonuje wymienione poniżej operacje:
Interfejs API Dysku 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 API Dysku 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 bądź muszą przeszukiwać wiele korpusów, wymagają dodatkowych funkcji dysku współdzielonego. W pozostałej części tego dokumentu znajdziesz informacje o dodatkowych zmianach wymaganych do wykonania tych zadań.
Wyszukiwanie treści na dysku współdzielonym
Aby wyszukać dyski współdzielone, użyj metody files.list
. W tej sekcji omawiamy pola związane z dyskiem współdzielonym w metodzie files.list
. Instrukcje dotyczące wyszukiwania dysku współdzielonego znajdziesz w artykule Wyszukiwanie plików i folderów.
Metoda files.list
zawiera te pola i tryby zapytań związane z dyskiem współdzielonym:
driveId
– identyfikator dysku współdzielonego do przeszukania.includeItemsFromAllDrives
– określa, czy w wynikach mają być uwzględniane elementy z dysków współdzielonych. Jeśli zasada nie jest dostępna lub ma wartość fałsz, elementy z dysku współdzielonego nie są zwracane.corpora
– elementy elementów (plików/dokumentów), do których odnosi się zapytanie. Obsługiwane treści touser
,domain
,drive
iallDrives
. Ze względu na wydajność wybierajuser
lubdrive
zamiastallDrives
.supportsAllDrives
– określa, czy aplikacja żądająca obsługuje zarówno Mój dysk, jak i dyski współdzielone. Jeśli zasada ma wartość Fałsz, w odpowiedzi elementy z dysków współdzielonych nie są uwzględniane.
Poniższe tryby zapytań są specyficzne dla dysków współdzielonych:
includeItemsFromAllDrives |
corpora |
Opis zapytania |
---|---|---|
true |
user |
Zapytania dotyczące plików, do których użytkownik miał dostęp, w tym plików na dysku współdzielonym i na Moim dysku. |
true |
drive |
Sprawdza wszystkie elementy na określonym dysku współdzielonym. W żądaniu musi być określony parametr driveId. |
true |
allDrives |
Zapytania dotyczące plików, do których użytkownik miał dostęp, oraz wszystkich dysków współdzielonych, do których należy. Pamiętaj, że odpowiedź może zawierać ciąg incompleteSearch : true , co oznacza, że niektóre korpusy nie zostały wyszukane dla tego żądania. |
true |
domain |
Zapytania dotyczące plików udostępnionych w domenie – zarówno pliki na dysku współdzielonym, jak i na Moim dysku. |
Śledzenie zmian na dysku współdzielonym
Aby śledzić zmiany na dysku współdzielonym, skorzystaj z metody changes.list
. W tej sekcji omawiamy pola związane z dyskiem współdzielonym w metodzie changes.list
. Więcej informacji znajdziesz w artykule Śledzenie zmian dotyczących użytkowników i dysków współdzielonych.
Metoda changes.list
zawiera te pola i tryby zapytań związane z dyskiem współdzielonym:
driveId
– dysk współdzielony, z którego zwracane są zmiany. Jeśli identyfikatory zmian są określone, 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 dysku współdzielonego, jako identyfikatora musisz użyć zarówno identyfikatora dysku współdzielonego, jak i identyfikatora zmiany.supportsAllDrives
– określa, czy aplikacja żądająca obsługuje dyski współdzielone. Jeśli zasada ma wartość Fałsz, elementy z dysków współdzielonych, w tym dyski współdzielone i pliki na tym dysku, nie są zwracane.includeItemsFromAllDrives
– określa, czy na liście zmian mają zostać uwzględnione zmiany lub pliki z dysków współdzielonych.
Poniższe tryby zapytań są specyficzne dla dysków współdzielonych:
includeItemsFromAllDrives |
driveId |
Opis zapytania |
---|---|---|
true |
Nie | Zmiany odzwierciedlają zmiany w plikach znajdujących się na dyskach współdzielonych i poza nimi, do których użytkownik miał dostęp, a także zmiany na dyskach współdzielonych, do których należy użytkownik. |
true |
Tak | Zmiany odzwierciedlają zmiany na konkretnym dysku współdzielonym oraz w elementach na tym dysku. |
Więcej informacji o działaniu w historii zmian znajdziesz w artykule Logi zmian.
Włącz obsługę dysków współdzielonych 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 Konsoli interfejsów API Google. Więcej informacji znajdziesz w artykule Konfigurowanie integracji z interfejsem 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 widoku dysków współdzielonych w selektorze plików znajdziesz w artykule Google Picker API.
Dalsze kroki
Jeśli potrzebujesz pomocy w tworzeniu dysków współdzielonych i zarządzaniu uprawnieniami tych dysków, przejdź do artykułu Zarządzanie dyskami współdzielonymi.