Tę lub inną metodę uwierzytelniania należy wywołać przed ee.initialize().
Pamiętaj, że jeśli użytkownik nie przyznał wcześniej dostępu aplikacji zidentyfikowanej przez identyfikator klienta, domyślnie pojawi się okno z prośbą o przyznanie wymaganych uprawnień. To wyskakujące okienko może jednak zostać zablokowane przez przeglądarkę. Aby tego uniknąć, określ wywołanie zwrotne opt_onImmediateFailed i wyrenderuj w nim przycisk logowania na stronie, a następnie wywołaj ee.data.authenticateViaPopup() z modułu obsługi zdarzeń kliknięcia tego przycisku. Dzięki temu przeglądarka nie zablokuje wyskakującego okienka, ponieważ będzie ono bezpośrednim wynikiem działania użytkownika.
Token uwierzytelniający będzie w miarę możliwości odświeżany automatycznie. Możesz bezpiecznie założyć, że wszystkie wywołania asynchroniczne będą wysyłane z odpowiednimi danymi logowania. W przypadku wywołań synchronicznych sprawdź jednak, czy jest dostępny token uwierzytelniania, używając funkcji ee.data.getAuthToken(), a jeśli go nie ma, wywołaj ręcznie funkcję ee.data.refreshAuthToken(). Operacja odświeżania tokena jest asynchroniczna i nie można jej wykonać w tle na żądanie przed wywołaniami synchronicznymi.
| Wykorzystanie | Zwroty |
|---|---|
ee.data.authenticateViaOauth(clientId, success, error, extraScopes, onImmediateFailed, suppressDefaultScopes) |
| Argument | Typ | Szczegóły |
|---|---|---|
clientId | Ciąg znaków | Identyfikator klienta OAuth aplikacji lub wartość null, aby wyłączyć wywołania uwierzytelnione. Możesz go uzyskać w Google Developers Console. Projekt musi mieć źródło JavaScript, które odpowiada domenie, w której działa skrypt. |
success | Funkcja | Funkcja, która ma zostać wywołana, jeśli uwierzytelnianie się powiedzie. |
error | Funkcja (opcjonalnie) | Funkcja, którą należy wywołać w przypadku nieudanego uwierzytelniania, przekazała komunikat o błędzie. Jeśli uwierzytelnianie w trybie natychmiastowym (w tle) się nie powiedzie i określono opt_onImmediateFailed, zamiast opt_error wywoływana jest ta funkcja. |
extraScopes | List<String>, opcjonalnie | Dodatkowe zakresy protokołu OAuth, o które chcesz poprosić. |
onImmediateFailed | Funkcja (opcjonalnie) | Funkcja, która ma zostać wywołana, jeśli automatyczne uwierzytelnianie w tle się nie powiedzie. Domyślnie jest to funkcja ee.data.authenticateViaPopup() powiązana z przekazanymi funkcjami wywołania zwrotnego. |
suppressDefaultScopes | Wartość logiczna, opcjonalna | Jeśli ma wartość „true”, żądane są tylko zakresy określone w parametrze opt_extraScopes. Zakresy domyślne nie są żądane, chyba że zostały wyraźnie określone w parametrze opt_extraScopes. |