Konfigurowanie aplikacji Google Chat

Na tej stronie dowiesz się, jak skonfigurować i wdrożyć aplikację Google Chat jako dodatek do Google Workspace.

Aby wdrożyć i przetestować dodatek do Google Workspace, który rozszerza funkcje Google Chat, musisz włączyć i skonfigurować aplikację Google Chat za pomocą interfejsu Google Chat API. W ustawieniach konfiguracji interfejsu Chat API możesz określić wszystkie szczegóły aplikacji do obsługi czatu, w tym nazwę, awatar, wdrożenie i funkcje interaktywne, których chcesz używać.

Wymagania wstępne

Wybieranie nazwy wyświetlanej, awatara i opisu aplikacji Chat

Nazwa, awatar i opis aplikacji Google Chat są wyświetlane użytkownikom w interfejsie Google Chat. Aby wchodzić w interakcje z aplikacjami do czatowania, użytkownicy widzą lub wykorzystują te informacje w następujący sposób:

  • Użyj @wzmianki, aby dodać aplikację do pokoju lub wysłać do niej wiadomość.
  • Znajdź i rozpocznij czat z aplikacją Google Chat. W menu Aplikacje czaty wyświetlają nazwę i awatar aplikacji Google Chat.
  • Na pasku tworzenia wiadomości użytkownicy mogą przeglądać aplikacje do Google Chat i wyświetlać ich nazwy, awatary i opisy.

Zanim skonfigurujesz aplikację Chat, musisz przygotować te informacje:

Pole Opis Format
Nazwa aplikacji Wyświetlana nazwa aplikacji Google Chat. Do 25 znaków alfanumerycznych
URL awatara Obraz, który wyświetla się jako awatar aplikacji Chat. Adres URL HTTPS prowadzący do kwadratowego obrazu (PNG lub JPEG). Zalecany rozmiar to co najmniej 256 x 256 pikseli.
Opis Krótki opis celu aplikacji Chat. Maksymalnie 40 znaków alfanumerycznych

W następnej sekcji podasz te informacje w ustawieniach konfiguracji interfejsu Chat API.

Konfigurowanie aplikacji do obsługi czatu w konsoli Google Cloud

W konsoli Google Cloud możesz skonfigurować szczegóły aplikacji do obsługi czatu, które będą wyświetlane użytkownikom w Google Chat, w tym nazwę wyświetlaną, awatar i opis. Te informacje pojawiają się tylko w Google Chat. Aby opublikować aplikację Google Chat w Marketplace, musisz też podać szczegóły, które będą widoczne w informacjach o aplikacji w Marketplace.

Gdy będziesz mieć szczegóły aplikacji Google Chat, otwórz projekt Cloud i skonfiguruj interfejs Chat API:

  1. W konsoli Google Cloud otwórz stronę Chat API i kliknij stronę Konfiguracja:

    Otwórz stronę konfiguracji interfejsu Chat API

  2. W sekcji Informacje o aplikacji wypełnij pola Nazwa aplikacji, URL awatara i Opis.

  3. W sekcji Funkcje interaktywne kliknij Włącz funkcje interaktywne, aby włączyć tę opcję, i wykonaj te czynności:

    1. W sekcji Funkcje wybierz Dołączanie do pokoi i rozmów grupowych, aby aplikacja na czacie była dostępna do zainstalowania i używania.

      Domyślnie użytkownicy mogą instalować aplikację Google Chat i wysyłać do niej wiadomości w przestrzeni przeznaczonej do komunikacji między użytkownikiem a aplikacją. Użytkownicy mogą też dodawać aplikację Google Chat do pokoi z wieloma osobami i wchodzić z nią w interakcje.

    2. W sekcji Ustawienia połączenia wybierz architekturę, której chcesz używać do odbierania obiektów zdarzeń z Chata:

      • Aby użyć usługi HTTP, kliknij Adres URL punktu końcowego HTTP i podaj adres URL.
      • Aby użyć projektu Google Apps Script, wybierz Apps Script i podaj identyfikator wdrożenia projektu.

    3. Opcjonalnie: aby otrzymywać obiekty zdarzeń do więcej niż 1 punktu końcowego lub funkcji, kliknij Ustawienia połączenia > Triggery i podaj lub zaktualizuj funkcje wywołania zwrotnego dla tych triggerów czatu:

      • Dodano do pokoju: użytkownik dodaje aplikację Google Chat do rozmowy grupowej lub pokoju albo instaluje aplikację Google Chat do wiadomości 1:1.
      • Wiadomość: użytkownik wysyła wiadomość do aplikacji Chat. Na przykład wysyła wiadomość na czacie do aplikacji Chat lub @wzmiankuje aplikację Chat w pokoju z wieloma osobami.
      • Usunięto z pokoju: użytkownik odinstalowuje lub usuwa aplikację Chat z pokoju.
      • Polecenie aplikacji: użytkownik używa szybkiego polecenia lub polecenia po ukośniku w aplikacji Google Chat.

    4. Opcjonalnie: dodaj inne funkcje interaktywne, takie jak szybkie polecenia, polecenia z ukośnikiem lub podgląd linków.

    5. W sekcji Widoczność podaj swój adres e-mail, aby móc zainstalować i przetestować aplikację do obsługi czatu przed opublikowaniem jej w Google Workspace Marketplace. Możesz określić maksymalnie 5 osób lub co najmniej jedną grupę Google z Twojej organizacji Google Workspace.

  4. Opcjonalnie: w sekcji Logi zaznacz pole wyboru Loguj błędy w Cloud Logging, aby korzystać z Google Cloud Logging. Więcej informacji znajdziesz w artykule Dzienniki błędów zapytań w aplikacjach Google Chat w dokumentacji interfejsu Chat API.

  5. Kliknij Zapisz.

Po zapisaniu konfiguracji każda osoba, którą wskażesz w ustawieniu Widoczność interfejsu Chat API, będzie mogła zainstalować, przetestować lub używać aplikacji do obsługi czatu. Aby rozpocząć testowanie i debugowanie aplikacji do obsługi czatu, zapoznaj się z artykułem Testowanie funkcji interaktywnych aplikacji do obsługi czatu w Google Chat w dokumentacji interfejsu Chat API.

Wskazówki dotyczące dotychczasowych dodatków do Google Workspace

Aplikacje do obsługi czatu wymagają innej konfiguracji niż dodatki do Google Workspace, które rozszerzają inne aplikacje Google Workspace. Jeśli Twój dodatek rozszerza inne aplikacje Google Workspace, weź pod uwagę te wymagania dotyczące konfigurowania aplikacji Google Chat:

  • Zarówno osoby prywatne, jak i administratorzy Google Workspace muszą mieć możliwość zainstalowania dodatku z Marketplace. Te ustawienia instalacji konfiguruje się w pakiecie SDK Google Workspace Marketplace.
  • Aplikacje do obsługi czatu nie używają nazwy i logo skonfigurowanych dla innych aplikacji Google Workspace w obiekcie addons.common manifestu.
  • W przypadku dodatków opublikowanych w Google Workspace Marketplace nie możesz zapisać wersji roboczej żadnych zmian w ustawieniach konfiguracji interfejsu Google Chat API. Po zaktualizowaniu i zapisaniu ustawień konfiguracji interfejsu Chat API zaktualizowana aplikacja do obsługi czatu będzie dostępna dla wszystkich dotychczasowych użytkowników. Aby zaktualizować wizytówkę w Marketplace, możesz utworzyć wersję roboczą przed przesłaniem zmian.

  • Jeśli dodatek został utworzony przy użyciu Apps Script:

  • Jeśli dodatek został utworzony przy użyciu usługi HTTP, pomiń w pliku manifestu i wdrożeniach utworzonych za pomocą interfejsu Google Workspace Add-ons API wszelkie szczegóły konfiguracji aplikacji Google Chat. Wdrożenia HTTP określone w pakiecie SDK Google Workspace Marketplace są używane tylko w innych aplikacjach Google Workspace.