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

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:

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 to user, domain, drive i allDrives. Ze względu na wydajność wybieraj user lub drive zamiast allDrives.

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