Przewodniki szybkiego startu wyjaśniają, jak skonfigurować i uruchamiać aplikację, która wywołuje interfejs Google Workspace API.
Szybkie porady dotyczące Google Workspace korzystają z bibliotek klienta interfejsu API do obsługi niektórych szczegółów procesu uwierzytelniania i autoryzacji. Zalecamy używasz bibliotek klienta we własnych aplikacjach. W tym krótkim wprowadzeniu użyjemy uproszczonego podejścia do uwierzytelniania, które jest odpowiednie dla środowiska testowego. W przypadku środowiska produkcyjnego zalecamy zapoznanie się z informacjami na temat uwierzytelniania i autoryzacji, zanim wybierzesz odpowiednie dla swojej aplikacji poświadczenia dostępu.
utworzyć aplikację wiersza poleceń w języku Java, która wysyła żądania do interfejsu Google Chat 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 Workspace Business lub Enterprise z dostępem do Google Chat.
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 Chat API.
Konfigurowanie ekranu zgody OAuth
Jeśli korzystasz z nowego projektu Google Cloud, skonfiguruj ekranu zgody OAuth i dodaj siebie jako użytkownika testowego. Jeśli masz już konto Google ten krok został wykonany w Twoim projekcie Cloud, 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.
Możesz pominąć dodawanie zakresów i kliknąć Zapisz i kontynuuj. Gdy w przyszłości będziesz tworzyć aplikację do użytku poza 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 aplikacja z rejestracji wszystko jest w porządku, kliknij Back to Dashboard (Powrót do panelu).
Autoryzowanie danych logowania do aplikacji na komputer
Aby uwierzytelniać użytkowników i uzyskiwać dostęp do ich danych w aplikacji, musisz: utwórz co najmniej jeden 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 kliknij Menu > Interfejsy API i usługi > Dane logowania.
- Kliknij Utwórz dane logowania > Identyfikator klienta OAuth.
- Kliknij Typ aplikacji > Aplikacja na komputer.
- 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ś plik do katalogu roboczego.
Konfigurowanie aplikacji Google Chat
Aby wywołać interfejs Google Chat API, musisz skonfigurować aplikację Google Chat. W przypadku żądań zapisu Google Chat przypisuje aplikację Google Chat w interfejsie użytkownika za pomocą tych informacji:
W konsoli Google Cloud otwórz stronę Konfiguracja interfejsu API Chat:
W sekcji Informacje o aplikacji podaj te dane:
- W polu Nazwa aplikacji wpisz
Chat API quickstart app
. - W polu 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 Włącz funkcje interaktywne. ustaw w pozycji wyłączonej, aby wyłączyć funkcje interaktywne w aplikacja Google Chat.
Kliknij Zapisz.
Przygotowanie 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ść plikiem ten kod:
Konfigurowanie próbki
W katalogu
src/main/java/
utwórz nowy plik Java o nazwie pasuje do wartościmainClassName
w plikubuild.gradle
.W nowym pliku Java umieść ten kod:
Uruchamianie przykładu
Uruchom przykład:
gradle run
-
Gdy uruchomisz próbkę po raz pierwszy, pojawi się prośba o autoryzację dostępu:
- Jeśli nie zalogowano się na konto Google, zaloguj się, gdy pojawi się taka prośba. Jeśli używasz wielu kont, wybierz jedno konto do autoryzacji.
- Kliknij Accept (Zaakceptuj).
Twoja aplikacja w Javie działa i wywołuje interfejs Google Chat API.
Informacje autoryzacyjne są przechowywane w systemie plików, więc następnym razem, gdy uruchomisz przykładowy kod, nie pojawi się prośba o autoryzację.