Przegląd selektora Google

W tym dokumencie przedstawiamy selektor Google i interfejs Google Picker API. Pomoże Ci też zdecydować, które podejście jest najlepsze w przypadku Twojej aplikacji.

Selektor Google udostępnia 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 aplikacji.

Google Picker API to interfejs techniczny używany do implementowania selektora Google w aplikacji. Za pomocą Google Picker API możesz utworzyć znany interfejs, który obsługuje złożoność uwierzytelniania i przeglądania plików, a po dokonaniu wyboru przez użytkownika zwraca do aplikacji określone metadane plików (takie jak identyfikatory i adresy URL).

Kluczowe przypadki użycia

Selektor Google jest wszechstronny i można go dostosować do różnych przepływów pracy aplikacji:

  • Alternatywne przesyłanie plików: użytkownicy mogą przesyłać pliki na Dysk bezpośrednio za pomocą selektora Google.
  • Narzędzia do współpracy: umożliwiają użytkownikom łączenie konkretnych Dokumentów Google lub Arkuszy Google z zadaniem w ramach zarządzania projektem lub udostępnionym wydarzeniem w kalendarzu.
  • Załączniki do komponentów: używaj selektora Google, aby użytkownicy mogli dołączać dokumentację pomocniczą 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. Poniższa tabela porównawcza zawiera różnice techniczne i funkcjonalne między implementacją w przypadku aplikacji internetowych a aplikacji na komputery i urządzenia mobilne.

Funkcja Aplikacje internetowe Aplikacje na komputery i urządzenia mobilne
Technologia podstawowa Biblioteka JavaScript po stronie klienta. Parametry URL OAuth 2.0 i przekierowania HTTP.
Renderowanie Integracja 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 komponencie WebView.
Przepływ uwierzytelniania Wymaga przekazania określonego tokena dostępu za pomocą parametru setOAuthToken. Wywoływane przez dodanie parametru trigger_onepick=true do żądania OAuth.
Metoda odpowiedzi bezpośrednie wywołania zwrotne JavaScriptu, Identyfikatory URI przekierowania lub niestandardowe schematy adresów URL.
Zakresy Elastyczny; można używać symboli drive.file, drive.readonly itp. Ścisły: dozwolony jest tylko zakres drive.file, którego nie można łączyć z innymi zakresami.
Konfiguracja Korzysta z interfejsu PickerBuilder w JavaScript. Używa parametrów ciągu zapytania w adresie URL autoryzacji.

Pamiętaj, że aby użyć zakresu drive.file, użytkownik musi być zalogowany podczas uzyskiwania dostępu do selektora Google.

Główne różnice strategiczne to:

  • Aplikacje internetowe są przeznaczone do interakcji na wysokim poziomie i zaawansowanego dostosowywania (np. wyświetlania określonych widoków według typu pliku i ograniczania widoku do konkretnych folderów na Dysku).
  • Aplikacje na komputery i urządzenia mobilne zostały zaprojektowane z myślą o bezpieczeństwie i prostocie. Wykorzystują przeglądarkę systemową do obsługi uwierzytelniania i wybierania plików w ramach jednego, ujednoliconego procesu.