Utwórz aplikację wiersza poleceń w języku Java, która wysyła żądania do interfejsu Google Chat API.
Przewodniki Szybki start wyjaśniają, jak skonfigurować i uruchomić aplikację, która wywołuje interfejs Google Workspace API. W tym krótkim wprowadzeniu użyjemy uproszczonego podejścia do uwierzytelniania, które jest odpowiednie w środowisku testowym. W przypadku środowiska produkcyjnego zalecamy zapoznanie się z informacjami o uwierzytelnianiu i autoryzacji przed wybraniem danych logowania odpowiednich dla Twojej aplikacji.
W tym przewodniku Szybki start używane są zalecane biblioteki klienta interfejsu API Google Workspace, które obsługują niektóre szczegóły procesu uwierzytelniania i autoryzacji.
Cele
- skonfigurować środowisko,
- Skonfiguruj próbkę.
- Uruchom przykład.
Wymagania wstępne
- Java 11 lub nowsza.
- Gradle w wersji 7.0 lub nowszej.
- Projekt Google Cloud.
- Konto Google Workspace w wersji Business lub Enterprise z dostępem do Google Chat.
Konfigurowanie środowiska
Aby ukończyć ten przewodnik, skonfiguruj środowisko.
Włącz API
Zanim zaczniesz korzystać z interfejsów Google API, musisz je włączyć w projekcie Google Cloud. W jednym projekcie Google Cloud możesz włączyć co najmniej 1 interfejs API.Włącz interfejs Google Chat API w konsoli Google Cloud.
Konfigurowanie ekranu zgody OAuth
Jeśli do wykonania zadań z tego krótkiego wprowadzenia posłużył Ci nowy projekt Google Cloud, skonfiguruj ekran akceptacji OAuth. Jeśli ten krok został już wykonany w przypadku Twojego projektu w Cloud, przejdź do następnej sekcji.
- W konsoli Google Cloud otwórz Menu > > Branding.
- Jeśli masz już skonfigurowany , możesz skonfigurować te ustawienia ekranu zgody OAuth w sekcjach Branding, Odbiorcy i Dostęp do danych. Jeśli zobaczysz komunikat Jeszcze nie skonfigurowano, kliknij Rozpocznij:
- W sekcji Informacje o aplikacji w polu Nazwa aplikacji wpisz nazwę aplikacji.
- W sekcji Adres e-mail pomocy dla użytkowników wybierz adres e-mail, na który użytkownicy mogą pisać, jeśli mają pytania dotyczące ich zgody.
- Kliknij Dalej.
- W sekcji Odbiorcy wybierz Wewnętrzny.
- Kliknij Dalej.
- W sekcji Dane kontaktowe wpisz adres e-mail, na który będziemy wysyłać powiadomienia o wszelkich zmianach w Twoim projekcie.
- Kliknij Dalej.
- W sekcji Zakończ zapoznaj się z zasadami dotyczącymi danych użytkownika w usługach interfejsów API Google i jeśli je akceptujesz, kliknij Akceptuję zasady dotyczące danych użytkownika w usługach interfejsów API Google.
- Kliknij Dalej.
- Kliknij Utwórz.
- Na razie możesz pominąć dodawanie zakresów. W przyszłości, gdy będziesz tworzyć aplikację do użytku poza organizacją Google Workspace, musisz zmienić Typ użytkownika na Zewnętrzny. Następnie dodaj zakresy autoryzacji wymagane przez aplikację. Więcej informacji znajdziesz w pełnym przewodniku Konfigurowanie zgody OAuth.
Autoryzowanie danych logowania do aplikacji na komputer
Aby uwierzytelniać użytkowników i uzyskiwać dostęp do danych użytkowników w aplikacji, musisz utworzyć co najmniej 1 identyfikator klienta OAuth 2.0. Identyfikator klienta wskazuje konkretną aplikację na serwerach OAuth Google. Jeśli Twoja aplikacja działa na kilku platformach, musisz utworzyć osobny identyfikator klienta dla każdej z nich.- W konsoli Google Cloud otwórz Menu > > Klienci.
- Kliknij Utwórz klienta.
- Kliknij Typ aplikacji > Aplikacja na komputer.
- W polu Nazwa wpisz nazwę danych logowania. Ta nazwa jest widoczna tylko w konsoli Google Cloud.
- Kliknij Utwórz.
Nowo utworzone dane logowania pojawią się w sekcji „Identyfikatory klientów OAuth 2.0”.
- Zapisz pobrany plik JSON jako
credentials.json
i przenieś go do katalogu roboczego.
Konfigurowanie aplikacji Google Chat
Aby wywołać interfejs Google Chat API, musisz skonfigurować aplikację Google Chat. W przypadku wszystkich żądań zapisu Google Chat przypisuje aplikację Google Chat w interfejsie za pomocą tych informacji:
W konsoli Google Cloud otwórz stronę Konfiguracja interfejsu Chat API:
W sekcji Informacje o aplikacji wpisz te informacje:
- W polu Nazwa aplikacji wpisz
Chat API quickstart app
. - W polu Adres URL awatara wpisz
https://developers.google.com/chat/images/quickstart-app-avatar.png
. - W polu Opis wpisz
Quickstart for calling the Chat API
.
- W polu Nazwa aplikacji wpisz
W sekcji Funkcje interaktywne kliknij przełącznik Włącz funkcje interaktywne, aby wyłączyć funkcje interaktywne aplikacji do obsługi czatu.
Kliknij Zapisz.
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 nie zalogowano się na konto Google, pojawi się prośba o zalogowanie. Jeśli logujesz się na wiele kont, wybierz jedno z nich, aby użyć go do autoryzacji.
- Kliknij Accept (Zaakceptuj).
Aplikacja w Javie działa i wywołuje interfejs Google Chat 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ę.