Przegląd selektora Google

W tym dokumencie przedstawiamy narzędzie do wybierania plików Google i interfejs Google Picker API. Pomoże Ci też zdecydować, które rozwiązanie jest najlepsze dla Twojej aplikacji.

Narzędzie do wybierania plików Google to dopracowane okno „Otwórz plik” do informacji przechowywanych na Dysku Google. Umożliwia użytkownikom wybieranie lub przesyłanie zdjęć, filmów i dokumentów z konta na Dysku bez opuszczania Twojej aplikacji.

Interfejs Google Picker API to interfejs techniczny używany do implementowania narzędzia do wybierania plików Google w aplikacji. Dzięki niemu możesz utworzyć znany interfejs, który obsługuje złożone procesy uwierzytelniania i przeglądania plików, a po dokonaniu wyboru przez użytkownika zwraca do aplikacji określone metadane pliku (takie jak identyfikatory i adresy URL).

Główne przypadki użycia

Narzędzie do wybierania plików Google jest wszechstronne i można je dostosować do różnych procesów w aplikacji:

  • Alternatywa dla przesyłania plików: użytkownicy mogą przesyłać pliki na Dysk bezpośrednio za pomocą narzędzia do wybierania plików Google.
  • Narzędzia do współpracy: umożliwiają użytkownikom łączenie konkretnych Dokumentów Google lub Arkuszów Google z zadaniem w systemie zarządzania projektami lub udostępnionym wydarzeniem w kalendarzu.
  • Załączniki: narzędzie do wybierania plików Google umożliwia użytkownikom dołączanie dokumentacji pomocniczej z Dysku do raportu wydatków lub zgłoszenia.

Porównanie aplikacji internetowych z aplikacjami na komputery i urządzenia mobilne

Podstawowa funkcjonalność pozostaje taka sama, ale implementacja interfejsu Google Picker API różni się w zależności od tego, gdzie działa aplikacja. W poniższej tabeli porównawczej znajdziesz różnice techniczne i funkcjonalne między implementacją w aplikacjach internetowych a aplikacjach na komputery i urządzenia mobilne.

Funkcja Aplikacje internetowe Aplikacje na komputery i urządzenia mobilne
Podstawowa technologia Biblioteka JavaScript po stronie klienta. Parametry adresu URL OAuth 2.0 i przekierowania HTTP.
Renderowanie Integruje się z istniejącym układem interfejsu aplikacji. Otwiera się w nowej karcie domyślnej przeglądarki systemowej użytkownika. Nie można już wyświetlać w osadzonym widoku WebView.
Przepływ uwierzytelniania Wymaga konkretnego tokena dostępu przekazywanego przez setOAuthToken. Jest wywoływany przez dodanie trigger_onepick=true do żądania OAuth.
Metoda odpowiedzi Bezpośrednie wywołania zwrotne JavaScript. Identyfikatory URI przekierowania lub niestandardowe schematy adresów URL.
Zakresy Elastyczne; można używać drive.file, drive.readonly itp. Ścisłe; dozwolony jest tylko zakres drive.file, którego nie można łączyć z innymi zakresami.
Konfiguracja Używa płynnego interfejsu PickerBuilder w JavaScript. Używa parametrów ciągu zapytania w adresie URL autoryzacji.

Aby używać zakresu drive.file, użytkownik musi być zalogowany podczas uzyskiwania dostępu do narzędzia do wybierania plików Google.

Główne różnice strategiczne:

  • Aplikacje internetowe są przeznaczone do wysokiej interaktywności i głębokiego dostosowywania (np. określonych widoków według typu pliku i ograniczania widoku do określonych folderów na Dysku).
  • Aplikacje na komputery i urządzenia mobilne są przeznaczone do zapewniania bezpieczeństwa i prostoty. Wykorzystują przeglądarkę systemową do obsługi uwierzytelniania i wybierania plików w jednym, ujednoliconym procesie.