Planowanie spotkań w Google Chat

Poziom kodowania: średnio zaawansowany
Czas trwania: 25 minut
Typ projektu: dodatek do Google Workspace rozszerzający Chat.

Cele

• Dowiedz się, co robi rozwiązanie.
• Dowiedz się, jakie funkcje pełnią usługi Apps Script w ramach rozwiązania.
• skonfigurować środowisko,
• Skonfiguruj skrypt.
• Uruchom skrypt.

Informacje o rozwiązaniu

Planowanie spotkania w Kalendarzu Google z poziomu wiadomości na czacie lub pokoju w Google Chat. Możesz ustawić szczegóły spotkania, takie jak temat, godzina rozpoczęcia lub czas trwania, albo użyć ustawień domyślnych, aby zaplanować spotkanie natychmiastowe.

Jak to działa

Skrypt aplikacji Google Chat używa poleceń z ukośnikiem i okien, 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 własnych potrzeb.

Usługi Apps Script

To rozwiązanie korzysta z tych usług:

• Usługa Kalendarz – tworzy wydarzenie w kalendarzu na podstawie podanych informacji o spotkaniu.
• Usługa podstawowa – używa klasy Session, aby uzyskać strefę czasową skryptu. Kalendarz używa tej strefy czasowej podczas planowania wydarzenia.
• Usługa narzędziowa – 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.

• Projekt Google Cloud. Aby go utworzyć, przeczytaj artykuł Tworzenie projektu Google Cloud.

Konfigurowanie środowiska

Otwórz projekt w Google Cloud Console.

Otwórz projekt w Google Cloud, którego chcesz użyć w tym przykładzie:

1. W konsoli Google Cloud otwórz stronę Wybierz projekt.

   Wybierz projekt w chmurze

2. 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 utworzysz projekt Google Cloud, może być konieczne włączenie płatności za ten projekt.

Włączanie interfejsu API

Zanim zaczniesz korzystać z interfejsów Google API, musisz je włączyć w projekcie Google Cloud. W jednym projekcie Google Cloud możesz włączyć co najmniej 1 interfejs API.

• Włącz interfejs Google Chat API w projekcie Cloud.

  Włączanie interfejsu API

Konfigurowanie ekranu zgody OAuth

Wszystkie aplikacje do obsługi Google Chat wymagają konfiguracji ekranu zgody. Skonfigurowanie ekranu zgody OAuth aplikacji określa, co Google wyświetla użytkownikom, i rejestruje aplikację, aby można ją było później opublikować.

1. W konsoli Google Cloud otwórz Menu  > Google Auth platform > Branding.

   Otwórz Branding

2. Jeśli masz już skonfigurowany Google Auth platform, możesz skonfigurować te ustawienia ekranu zgody OAuth w sekcjach Branding, Odbiorcy i Dostęp do danych. Jeśli zobaczysz komunikat Google Auth platform Jeszcze nie skonfigurowano, kliknij Rozpocznij:
1. W sekcji Informacje o aplikacji w polu Nazwa aplikacji wpisz nazwę aplikacji.
2. W polu Adres e-mail dla użytkowników potrzebujących pomocy wybierz adres e-mail, na który użytkownicy mogą pisać, aby się z Tobą skontaktować w sprawie pytań o ich zgodę.
3. Kliknij Dalej.
4. W sekcji Odbiorcy wybierz Wewnętrzny.
5. Kliknij Dalej.
6. W sekcji Dane kontaktowe wpisz adres e-mail, na który będziesz otrzymywać powiadomienia o zmianach w projekcie.
7. Kliknij Dalej.
8. W sekcji Zakończ zapoznaj się z zasadami dotyczącymi danych użytkownika w usługach interfejsu API Google, a jeśli je akceptujesz, kliknij Akceptuję zasady dotyczące danych użytkownika w usługach interfejsu API Google.
9. Kliknij Dalej.
10. Kliknij Utwórz.
3. Na razie możesz pominąć dodawanie zakresów. W przyszłości, gdy będziesz tworzyć aplikację do użytku poza organizacją Google Workspace, musisz zmienić Typ użytkownika na Zewnętrzny. Następnie dodaj zakresy autoryzacji wymagane przez aplikację. Więcej informacji znajdziesz w pełnym przewodniku Konfigurowanie zgody OAuth.

Konfigurowanie skryptu

Tworzenie projektu Apps Script

1. Kliknij przycisk poniżej, aby otworzyć projekt Apps Script Planowanie spotkań w Google Chat.
   Otwórz projekt
2. Kliknij Przegląd .
3. Na stronie przeglądu kliknij Utwórz kopię .

Tworzenie wdrożenia testowego

1. W skopiowanym projekcie Apps Script kliknij Wdróż > Testuj wdrożenia.
2. Skopiuj identyfikator wdrożenia Head, aby użyć go w późniejszym kroku, i kliknij Gotowe.

Konfigurowanie interfejsu Chat API

1. W konsoli Google Cloud otwórz stronę Chat API.
   Otwórz Chat API
2. Kliknij Konfiguracja.
3. Skonfiguruj Chat API, podając te informacje:
   • Nazwa: Meeting Scheduler
   • Adres URL awatara: https://goo.gle/3SfMkjb.
   • Opis: Quickly create meetings.
   • Funkcje: zaznacz oba pola, aby umożliwić użytkownikom wysyłanie wiadomości bezpośrednio do aplikacji i dodawanie jej do pokoi.
   • Ustawienia połączenia: kliknij Apps Script i wpisz identyfikator wdrożenia head.
   • Polecenia: dodaj polecenia po ukośniku dla /help i /schedule_Meeting wykonując te czynności:
     1. Kliknij Dodaj polecenie i skonfiguruj je, podając te informacje:
        • Identyfikator polecenia: 1.
        • Opis: Learn what this app does.
        • Typ polecenia: Slash command.
        • Nazwa polecenia po ukośniku: /help.
     2. Ponownie kliknij Dodaj polecenie i skonfiguruj je, podając te informacje:
        • Identyfikator polecenia: 2.
        • Opis: Schedule a meeting.
        • Typ polecenia: Slash command.
        • Nazwa polecenia po ukośniku: /schedule_Meeting.
        • Zaznacz pole Otwiera okno.
   • Uprawnienia: wybierz Określeni użytkownicy i grupy w Twojej domenie i wpisz swój adres e-mail.
4. Kliknij Zapisz.

Uruchamianie skryptu

1. Otwórz Google Chat.

   Otwórz Google Chat

2. Kliknij Rozpocznij czat .

3. Wyszukaj nazwę aplikacji, Meeting Scheduler.

4. Wyślij pierwszą wiadomość, np. hello, aby poprosić o autoryzację.

5. Gdy aplikacja odpowie, kliknij Skonfiguruj i autoryzuj aplikację. Jeśli na ekranie zgody OAuth pojawi się ostrzeżenie Ta aplikacja nie została zweryfikowana, kliknij Zaawansowane > Otwórz {Project Name} (niebezpieczne).

6. Wyślij /schedule_Meeting do aplikacji.

7. W oknie dialogowym dodaj co najmniej jeden adres e-mail zaproszonej osoby. Możesz zaktualizować inne pola lub użyć domyślnych wpisów.

8. Kliknij Prześlij.

9. Aby wyświetlić spotkanie, kliknij Otwórz wydarzenie w Kalendarzu.

Sprawdź kod

Kliknij, aby przejrzeć kod Apps Script tego rozwiązania hostowanego w GitHubie:

Wyświetl w GitHubie

Dalsze kroki

• Rozszerzanie Google Chat
• Tworzenie aplikacji Google Chat za pomocą Apps Script