Z krótkich wstępów dowiesz się, jak skonfigurować i uruchomić aplikację, która wywołuje interfejs Google Workspace API.
Krótkie wprowadzenia do Google Workspace wykorzystują biblioteki klienta API do obsługi niektórych szczegółów procesu uwierzytelniania i autoryzacji. Zalecamy używanie bibliotek klienta we własnych aplikacjach. W tym krótkim wprowadzeniu stosujemy uproszczone podejście do uwierzytelniania, które jest odpowiednie w środowisku testowym. W środowisku produkcyjnym zalecamy zapoznanie się z informacjami o uwierzytelnianiu i autoryzacji przed wybraniem danych logowania odpowiednich dla aplikacji.
Utworzenie aplikacji wiersza poleceń w Javie wysyłającej żądania do interfejsu Google Apps Script API.
Cele
- skonfigurować środowisko,
- Skonfiguruj sampel.
- Uruchom przykład.
Wymagania wstępne
- Java 1.8 lub nowsza.
- Gradle w wersji 7.0 lub nowszej.
- Projekt Google Cloud –
- konto Google z włączonym Dyskiem Google,
Konfigurowanie środowiska
Aby ukończyć to krótkie wprowadzenie, skonfiguruj środowisko.
Włącz API
Zanim zaczniesz korzystać z interfejsów API Google, musisz je włączyć w projekcie Google Cloud. W jednym projekcie Google Cloud możesz włączyć 1 lub więcej interfejsów API.W konsoli Google Cloud włącz interfejs Google Apps Script API.
Konfigurowanie ekranu zgody OAuth
Jeśli korzystasz z nowego projektu Google Cloud, aby ukończyć to krótkie wprowadzenie, skonfiguruj ekran zgody OAuth i dodaj siebie jako użytkownika testowego. Jeśli w Twoim projekcie Cloud ten krok masz już za sobą, przejdź do następnej sekcji.
- W konsoli Google Cloud otwórz Menu > Interfejsy API i usługi > Ekran zgody OAuth.
- Jako Typ użytkownika wybierz Wewnętrzny i kliknij Utwórz.
- Wypełnij formularz rejestracji aplikacji, a potem kliknij Zapisz i kontynuuj.
Na razie możesz pominąć dodawanie zakresów i kliknąć Zapisz i kontynuuj. W przyszłości, gdy utworzysz aplikację do użytku poza swoją organizacją Google Workspace, musisz zmienić Typ użytkownika na Zewnętrzny, a następnie dodać zakresy autoryzacji wymagane przez aplikację.
- Przejrzyj podsumowanie rejestracji aplikacji. Aby wprowadzić zmiany, kliknij Edytuj. Jeśli rejestracja aplikacji wygląda dobrze, kliknij Wróć do panelu.
Autoryzacja danych logowania w aplikacji komputerowej
Aby uwierzytelniać użytkowników i uzyskiwać dostęp do ich danych w aplikacji, musisz utworzyć co najmniej 1 identyfikator klienta OAuth 2.0. Identyfikator klienta służy do identyfikowania pojedynczej aplikacji na serwerach OAuth Google. Jeśli Twoja aplikacja działa na wielu platformach, musisz utworzyć oddzielny identyfikator klienta dla każdej z nich.- W konsoli Google Cloud otwórz Menu > Interfejsy API i usługi > Dane logowania.
- Kliknij Utwórz dane logowania > Identyfikator klienta OAuth.
- Kliknij Typ aplikacji > Aplikacja komputerowa.
- W polu Nazwa wpisz nazwę danych logowania. Ta nazwa jest wyświetlana tylko w konsoli Google Cloud.
- Kliknij Utwórz. Pojawi się ekran tworzenia klienta OAuth z nowym identyfikatorem klienta i tajnym kluczem klienta.
- Kliknij OK. Nowo utworzone dane logowania pojawią się w sekcji Identyfikatory klienta OAuth 2.0.
- Zapisz pobrany plik JSON jako
credentials.json
i przenieś go do katalogu roboczego.
Przygotowywanie obszaru roboczego
W katalogu roboczym utwórz nową strukturę projektu:
gradle init --type basic mkdir -p src/main/java src/main/resources
W katalogu
src/main/resources/
skopiuj pobrany wcześniej plikcredentials.json
.Otwórz domyślny plik
build.gradle
i zastąp jego zawartość tym kodem:
Konfigurowanie próbki
W katalogu
src/main/java/
utwórz nowy plik Java o nazwie zgodnej z wartościąmainClassName
w plikubuild.gradle
.W nowym pliku Java umieść ten kod:
Uruchamianie przykładu
Uruchom przykład:
gradle run
-
Przy pierwszym uruchomieniu przykładu pojawi się prośba o autoryzację dostępu:
- Jeśli wyświetli się prośba o zalogowanie się na konto Google, zaloguj się. Jeśli korzystasz z wielu kont, wybierz jedno z nich do autoryzacji.
- Kliknij Accept (Zaakceptuj).
Aplikacja w Javie uruchamia i wywołuje interfejs Google Apps Script API.
Informacje o autoryzacji są przechowywane w systemie plików, więc przy następnym uruchomieniu przykładowego kodu nie pojawi się prośba o autoryzację.
Dalsze kroki
- Dokumentacja interfejsu Apps Script API
- Dokumentacja klienta interfejsów API Google do języka Java
- Dokumentacja interfejsu Google Apps Script API w języku Javadoc