Krótkie wprowadzenie 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. Przed uruchomieniem przykładowej aplikacji każde krótkie wprowadzenie wymaga włączenia uwierzytelniania i autoryzacji. Jeśli nie wiesz, jak uwierzytelnić i autoryzować interfejsy API Google Workspace, przeczytaj artykuł Omówienie uwierzytelniania i autoryzacji.
Jako administrator Google Workspace możesz korzystać z interfejsu Alert Center API, aby uzyskiwać dostęp do alertów w przypadku problemów z domeną.
Cele
- skonfigurować środowisko,
- skonfigurować i uruchomić próbkę,
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 włączyć je 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ę. Konto usługi pozwala uzyskać dostęp do danych lub wykonywać działania na koncie robota albo uzyskiwać dostęp 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.
- Podaj szczegóły konta usługi, a następnie 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 anulowanie dostępu do zasobów.
- Kliknij Dalej.
- Opcjonalnie: wpisz użytkowników lub grupy, którzy mogą zarządzać kontem i wykonywać na nim działania. Więcej informacji znajdziesz w artykule Zarządzanie personifikacją konta usługi.
- Kliknij Gotowe.
Tworzenie danych logowania dla konta usługi
Musisz je uzyskać w postaci pary kluczy: publicznego i prywatnego. Twoje dane logowania są używane przez Twój kod 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, a następnie kliknij Utwórz.
Nowa para kluczy publicznych/prywatnych zostanie wygenerowana i pobrana na komputer jako nowy plik. Ten plik to jedyna kopia tego klucza. Informacje o tym, jak bezpiecznie przechowywać klucz, znajdziesz w artykule Zarządzanie kluczami konta usługi.
- Kliknij Zamknij.
Konfigurowanie i uruchamianie przykładu
Uzyskaj dane logowania:
Utwórz instancję klienta:
Wyświetl wszystkie alerty:
Przesyłanie opinii na temat danego alertu: