Przegląd selektora Google

W tym dokumencie przedstawiamy selektor Google i interfejs Google Picker API. Pomoże Ci on też zdecydować, które rozwiązanie jest najlepsze dla Twojej aplikacji.

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

Google Picker API to interfejs techniczny służący do implementowania selektora 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

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

  • Alternatywa dla przesyłania 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 lub Arkuszów Google z zadaniem zarządzania projektem lub wydarzeniem w kalendarzu udostępnionym.
  • Załączniki komponentów: selektor Google może służyć użytkownikom do dołączania 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 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 dotychczasowym 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 internetowym.
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 selektora Google.

Główne różnice strategiczne:

  • Aplikacje internetowe są przeznaczone do wysokiej interaktywności i głębokiego dostosowywania (np. do określonych widoków według typu pliku i ograniczania widoku do konkretnych 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 przepływie.