Krótkie wprowadzenia wyjaśniają, 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 dla własnych aplikacji. W tym krótkim wprowadzeniu wykorzystaliśmy uproszczone podejście do uwierzytelniania odpowiednie dla środowiska testowego. W przypadku środowiska produkcyjnego zalecamy zapoznanie się z informacjami o uwierzytelniania i autoryzacji przed wybraniem danych logowania odpowiednich dla Twojej aplikacji.
Jako administrator Google Workspace możesz korzystać z interfejsu Alert Center API, aby uzyskiwać dostęp do alertów dotyczących problemów z Twoją domeną.
Cele
- skonfigurować środowisko,
- skonfigurować i uruchomić przykładowy kod,
Wymagania wstępne
- Java 1.8 lub nowsza.
- Projekt Google Cloud
- konto Google;
Konfigurowanie środowiska
Włączanie interfejsu 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ć jeden lub więcej interfejsów API.W konsoli Google Cloud włącz interfejs Alert Center API.
Tworzenie konta usługi
Konto usługi to specjalne konto używane przez aplikację, a nie osobę. Konta usługi możesz używać do uzyskiwania dostępu do danych i wykonywania działań przez konto robota, a także do uzyskiwania dostępu do danych w imieniu użytkowników Google Workspace lub Cloud Identity. Więcej informacji znajdziesz w artykule Omówienie kont usługi.- W konsoli Google Cloud kliknij Menu > Administracja > Konta usługi.
- Kliknij Utwórz konto usługi.
- Wpisz szczegóły konta usługi, a potem kliknij Utwórz i kontynuuj.
- Opcjonalnie: przypisz role do konta usługi, aby przyznać dostęp do zasobów projektu Google Cloud. Więcej informacji znajdziesz w artykule Przyznawanie, zmienianie i cofanie dostępu do zasobów.
- Kliknij Dalej.
- Opcjonalnie: wpisz użytkowników lub grupy, które mogą zarządzać kontem usługi i wykonywać na nim czynności. Więcej informacji znajdziesz w artykule Zarządzanie personifikacją na koncie usługi.
- Kliknij Gotowe. Zanotuj adres e-mail konta usługi.
Tworzenie danych logowania dla konta usługi
Musisz uzyskać dane logowania w postaci pary kluczy publiczny/prywatny. Kody służą do autoryzacji działań konta usługi w aplikacji.- W konsoli Google Cloud kliknij Menu > Administracja > Konta usługi.
- Wybierz konto usługi.
- Kliknij Klucze > Dodaj klucz > Utwórz nowy klucz.
- Wybierz JSON i kliknij Utwórz.
Nowa para kluczy publiczny/prywatny zostanie wygenerowana i pobrana na komputer jako nowy plik. Ten plik jest jedyną kopią tego klucza. Informacje o tym, jak bezpiecznie przechowywać klucz, znajdziesz w sekcji Zarządzanie kluczami konta usługi.
- Kliknij Zamknij.
Konfigurowanie i uruchamianie przykładu
Uzyskaj dane logowania:
Utwórz instancję klienta:
Wyświetl wszystkie alerty:
Przekazywanie opinii na temat danego alertu: