Krótkie wprowadzenie wyjaśnia, jak skonfigurować i uruchomić aplikację, która wywołuje Interfejs Google Workspace API.
Krótkie wprowadzenie do Google Workspace wykorzystuje biblioteki klienta API do obsługi niektórych szczegóły procesu uwierzytelniania i autoryzacji. Zalecamy używasz bibliotek klienta we własnych aplikacjach. W tym krótkim wprowadzeniu użyto uproszczone metody uwierzytelniania odpowiednie do testowania dla środowiska. W środowisku produkcyjnym zalecamy zapoznanie się z uwierzytelnianie i autoryzacja przed wybór danych logowania odpowiednie dla Twojej aplikacji.
Utwórz Skrypt Google Apps Script który wysyła żądania do interfejsu Google Chat API.
Cele
- Skonfiguruj środowisko.
- Utwórz i skonfiguruj skrypt.
- Uruchom skrypt.
Wymagania wstępne
- konto Google Workspace Business lub Enterprise z dostępem do Google Chat.
Konfigurowanie projektu Cloud
Jeśli korzystasz z nowego projektu Google Cloud, aby ukończyć to krótkie wprowadzenie, musisz wykonać te czynności: skonfiguruj go i dodaj siebie jako użytkownika testowego. Jeśli masz już konto Google te czynności w Twoim projekcie Cloud zostały wykonane, przejdź do następnej sekcji.
Otwieranie projektu Cloud w konsoli Google Cloud
Jeśli projekt Cloud nie jest jeszcze otwarty, otwórz go, którego chcesz używać. dla tego przykładu:
- W konsoli Google Cloud otwórz stronę Wybierz projekt.
- Wybierz projekt Google Cloud, którego chcesz użyć. Możesz też kliknąć Utwórz projekt i postępować zgodnie z instrukcjami wyświetlanymi na ekranie. Jeśli tworzysz projekt Google Cloud, konieczne może być włączenie dla niego płatności.
Włączanie interfejsu Chat 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
- 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 swoim Google Workspace, musisz zmienić Typ użytkownika na Zewnętrzny, a następnie: dodaj 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).
Konfigurowanie aplikacji Google Chat
Aby wywołać interfejs Google Chat API, musisz skonfigurować aplikacji Google Chat. W przypadku wszelkich żądań zapisu Google Chat atrybut aplikacji Google Chat w interfejsie za pomocą atrybutu poniższe informacje.
W konsoli Google Cloud otwórz stronę Konfiguracja interfejsu Chat API:
W sekcji Application info (Informacje o aplikacji) wpisz te informacje:
- 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.
Tworzenie skryptu
- Utwórz nowy skrypt na stronie script.google.com/create.
- Zastąp zawartość edytora skryptów tym kodem:
- Kliknij Zapisz .
- Kliknij Projekt bez tytułu, wpisz Szybki start i kliknij Zmień nazwę.
Konfigurowanie skryptu
Kopiuj numer projektu Cloud
- W konsoli Google Cloud otwórz menu > Administracja Administracja > Ustawienia. .
- Skopiuj wartość z pola Numer projektu.
Połącz swój projekt Google Cloud
- Otwórz projekt Apps Script.
- Kliknij Ustawienia projektu .
- W sekcji Projekt Google Cloud Platform (GCP) kliknij Zmień projekt.
- W polu Numer projektu GCP wklej numer projektu Google Cloud.
- Kliknij Set project (Ustaw projekt).
Włączanie interfejsu Google Chat API
- Otwórz projekt Apps Script.
- Kliknij Ustawienia projektu .
- W sekcji Ustawienia ogólne włącz opcję Pokaż plik „appsscript.json” plik manifestu w edytorze.
- Kliknij Edytor
appscript.json
i zastąp zawartość następującym kodem:
, wybierz
Uruchamianie przykładu
W edytorze Apps Script kliknij Uruchom.
Przy pierwszym uruchomieniu przykładu pojawi się prośba o autoryzację dostępu:
- Kliknij Sprawdź uprawnienia.
- Wybierz konto.
- Kliknij Zezwól.
Dziennik wykonywania skryptu pojawi się u dołu okna.