Poziom umiejętności programowania: średnio zaawansowany
Czas trwania: 25 minut
Typ projektu: aplikacja Google Chat
Cele
- Dowiedz się, na czym polega działanie rozwiązania.
- Dowiedz się, jak usługi Apps Script działają w ramach rozwiązania.
- skonfigurować środowisko,
- Skonfiguruj skrypt.
- Uruchom skrypt.
Informacje o rozwiązaniu
Zaplanuj spotkanie w Kalendarzu Google z poziomu wiadomości na czacie lub pokoju w Google Chat. Możesz określić konkretne szczegóły spotkania, takie jak temat, godzina rozpoczęcia lub czas trwania, albo użyć ustawień domyślnych do planowania spotkań błyskawicznych.
Jak to działa
Skrypt aplikacji do czatu korzysta z komend z cudzysłowu i dialogów, aby uzyskać od użytkowników szczegóły spotkania i zaplanować wydarzenie w Kalendarzu. Skrypt zawiera domyślne ustawienia spotkania, które można dostosować do swoich potrzeb.
Usługi Apps Script
To rozwiązanie korzysta z tych usług:
- Usługa kalendarza – tworzy wydarzenie w kalendarzu na podstawie podanych informacji o spotkaniu.
- Usługa podstawowa – korzysta z klasy
Session
, aby uzyskać strefę czasową skryptu. Kalendarz używa tej strefy czasowej podczas planowania wydarzenia. - Usługa Utilities – formatuje datę wydarzenia w kalendarzu i koduje identyfikator wydarzenia, aby ułatwić uzyskanie adresu URL wydarzenia.
Wymagania wstępne
- Konto Google Workspace w wersji Business lub Enterprise z dostępem do Google Chat.
- Utwórz projekt Google Cloud.
Konfigurowanie środowiska
Otwieranie projektu Cloud w konsoli Google Cloud
Jeśli nie jest jeszcze otwarty, otwórz projekt Cloud, którego chcesz użyć w przypadku tej próbki:
- 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 płatności.
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ć 1 lub więcej interfejsów API.W projekcie Cloud włącz interfejs Google Chat API.
Konfigurowanie ekranu zgody OAuth
Wszystkie aplikacje do czatu wymagają konfiguracji ekranu zgody. Konfigurując ekran zgody OAuth aplikacji, określasz, co Google ma wyświetlać użytkownikom, oraz rejestrujesz aplikację, aby móc ją później opublikować.
- W konsoli Google Cloud kliknij Menu > Interfejsy API i usługi > Ekran zgody OAuth.
- W polu Typ użytkownika wybierz Wewnętrzny, a następnie 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ę.
- Sprawdź podsumowanie rejestracji aplikacji. Aby wprowadzić zmiany, kliknij Edytuj. Jeśli rejestracja aplikacji wygląda dobrze, kliknij Powrót do panelu.
Konfigurowanie skryptu
Tworzenie projektu Apps Script
- Kliknij ten przycisk, aby otworzyć projekt Apps Script Planowanie spotkań w Google Chat.
Otwórz projekt - Kliknij Przegląd .
- Na stronie przeglądu kliknij Utwórz kopię .
Skopiuj numer projektu Cloud
- W konsoli Google Cloud kliknij Menu > Administracja > Ustawienia.
- W polu Numer projektu skopiuj wartość.
Ustawianie projektu Google Cloud w projekcie Apps Script
- W skopiowanym projekcie 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 Ustaw projekt.
Tworzenie testowego wdrożenia
- W skopiowanym projekcie Apps Script kliknij Wdróż > Testuj wdrożenia.
- Skopiuj identyfikator wdrożenia głównego, aby użyć go w następnym kroku, i kliknij Gotowe.
Konfigurowanie interfejsu Chat API
- W konsoli Google Cloud otwórz stronę Chat API.
Otwórz stronę Chat API - Kliknij Konfiguracja.
- Skonfiguruj interfejs Chat API, podając te informacje:
- Nazwa:
Meeting Scheduler
- URL awatara: dodaj adres URL, który wskazuje obraz o minimalnym rozmiarze 256 x 256 pikseli.
- Opis:
Quickly create meetings.
- Funkcjonalność: zaznacz oba pola, aby umożliwić użytkownikom wysyłanie wiadomości bezpośrednio do aplikacji i dodawanie jej do pokoju.
- Ustawienia połączenia: kliknij Apps Script i wpisz identyfikator wdrożenia w Google Apps.
- Polecenia po ukośniku: dodaj polecenia po ukośniku dla
/help
i/schedule_Meeting
, wykonując te czynności:- Kliknij Dodaj polecenie po ukośniku i skonfiguruj je, podając te informacje:
- Nazwa:
/help
- Identyfikator polecenia:
1
- Opis:
Learn what this app does.
- Nazwa:
- Ponownie kliknij Dodaj polecenie po ukośniku i skonfiguruj je, podając te informacje:
- Nazwa:
/schedule_Meeting
- Identyfikator polecenia:
2
- Opis:
Schedule a meeting.
- Zaznacz pole Otwiera okno.
- Nazwa:
- Kliknij Dodaj polecenie po ukośniku i skonfiguruj je, podając te informacje:
- Uprawnienia: wybierz Określone osoby i grupy w Twojej domenie i wpisz swój adres e-mail.
- Nazwa:
- Kliknij Zapisz i odśwież stronę.
- Na stronie konfiguracji w sekcji Stan aplikacji ustaw stan na Dostępne – dostępne dla użytkowników.
- Kliknij Zapisz.
Uruchamianie skryptu
- Otwórz Google Chat.
- Kliknij Rozpocznij czat .
- Wyszukaj nazwę aplikacji,
Meeting Scheduler
. - Wyślij pierwszą wiadomość, np.
hello
, aby zachęcić do autoryzacji. Gdy aplikacja odpowie, kliknij Konfiguruj i zatwierdź aplikację. Jeśli na ekranie zgody OAuth pojawi się ostrzeżenie Ta aplikacja nie została zweryfikowana, kontynuuj, wybierając Zaawansowane > Przejdź do {Nazwa projektu} (niebezpieczne).
Wyślij
/schedule_Meeting
do aplikacji.W oknie dodaj co najmniej 1 adres e-mail osoby z zaproszeniem. Możesz zaktualizować inne pola lub użyć wpisów domyślnych.
Kliknij Prześlij.
Aby wyświetlić spotkanie, kliknij Otwórz wydarzenie w kalendarzu.
Sprawdzanie kodu
Aby sprawdzić kod Apps Script tego rozwiązania, kliknij Wyświetl kod źródłowy poniżej:
Pokaż kod źródłowy
Code.gs
Dialog.gs
Utilities.gs
Dalsze kroki
- Informacje dla deweloperów dotyczące Google Chat
- Tworzenie aplikacji Google Chat za pomocą Apps Script