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 Google Chat, musisz włączyć i skonfigurować aplikację Google Chat za pomocą interfejsu Google Chat API. W ustawieniach konfiguracji interfejsu Chat API określasz wszystkie szczegóły dotyczące aplikacji Google Chat, w tym nazwę, awatar, wdrożenie i funkcje interaktywne, których chcesz używać.

Wymagania wstępne

Wybieranie wyświetlanej nazwy, awatara i opisu aplikacji Google Chat

Nazwa, awatar i opis aplikacji Google Chat są wyświetlane użytkownikom w interfejsie Google Chat. Aby korzystać z aplikacji Google Chat, użytkownicy mogą wyświetlać te informacje lub używać ich w następujący sposób:

  • Wzmianka @ o aplikacji Google Chat, aby dodać ją do pokoju lub wysłać do niej wiadomość.
  • Znajdowanie i rozpoczynanie czatu 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 Google Chat i wyświetlać ich nazwę, awatar i opis.

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

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

W następnej sekcji określisz te informacje w ustawieniach konfiguracji w interfejsie Chat API.

Konfigurowanie aplikacji Google Chat w konsoli Google Cloud

W konsoli Google Cloud skonfiguruj szczegóły dotyczące aplikacji Google Chat, które będą widoczne dla użytkowników w Google Chat, w tym wyświetlaną nazwę, awatar i opis. Te szczegóły są widoczne tylko w Google Chat. Aby opublikować aplikację Google Chat w Marketplace, musisz też podać szczegóły, które będą widoczne w jej ofercie w Marketplace.

Gdy masz już szczegóły aplikacji Google Chat, otwórz projekt w chmurze i skonfiguruj interfejs Chat API:

  1. W konsoli Google Cloud otwórz stronę interfejsu 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łączaj do pokoi i rozmów grupowych, aby umożliwić instalowanie i używanie aplikacji Google Chat.

      Domyślnie użytkownicy mogą instalować aplikację Google Chat i wysyłać do niej wiadomości w specjalnym pokoju między użytkownikiem a aplikacją Google Chat. Użytkownicy mogą też dodawać aplikację Google Chat do pokoi z wieloma osobami i korzystać z niej w tych pokojach.

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

      • Aby używać usługi HTTP, kliknij Adres URL punktu końcowego HTTP i podaj adres URL.
      • Aby używać projektu Google Apps Script, kliknij Apps Script i podaj identyfikator wdrożenia projektu.
      • Aby używać agenta Dialogflow, kliknij Dialogflow, wybierz Dialogflow CX lub Dialogflow ES i podaj nazwę zasobu agenta.
      • Aby używać Pub/Sub, kliknij Cloud Pub/Sub i wpisz nazwę tematu.

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

      • 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 Google Chat. Na przykład wysyła wiadomość na czacie do aplikacji Google Chat lub @wspomina o aplikacji Google Chat w pokoju z wieloma osobami.
      • Usunięto z pokoju: użytkownik odinstalowuje lub usuwa aplikację Google Chat z pokoju.
      • Polecenie aplikacji: użytkownik używa szybkiego polecenia lub polecenia po ukośniku z aplikacji Google Chat.

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

    5. W sekcji Widoczność podaj swój adres e-mail, aby móc zainstalować i przetestować aplikację Google Chat przed opublikowaniem jej w Google Workspace Marketplace. Możesz podać maksymalnie 5 osób lub co najmniej 1 grupę Google z organizacji Google Workspace.

  4. Opcjonalnie: w sekcji Logi zaznacz pole Rejestruj błędy w Cloud Logging, aby używać Google Cloud Logging. Więcej informacji znajdziesz w artykule Wykonywanie zapytań o logi błędów aplikacji Google Chat w dokumentacji interfejsu Chat API.

  5. Kliknij Zapisz.

Po zapisaniu konfiguracji każda osoba, którą określisz w ustawieniu Widoczność interfejsu Chat API, może zainstalować, przetestować lub używać aplikacji Google Chat. Aby rozpocząć testowanie i debugowanie aplikacji Google Chat, przeczytaj artykuł Testowanie funkcji interaktywnych aplikacji Google Chat w dokumentacji interfejsu Chat API.

Wskazówki dotyczące istniejących dodatków do Google Workspace

Aplikacje Google Chat 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, podczas konfigurowania aplikacji Google Chat weź pod uwagę te wymagania:

  • Zarówno osoby, jak i administratorzy Google Workspace muszą mieć możliwość zainstalowania Twojego dodatku z Marketplace. Te ustawienia instalacji konfigurujesz w pakiecie SDK Google Workspace Marketplace.
  • Aplikacje Google Chat nie używają nazwy i logo, które konfigurujesz dla innych aplikacji Google Workspace w obiekcie addons.common w manifeście.
  • 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 Google Chat będzie dostępna dla wszystkich dotychczasowych użytkowników. Aby zaktualizować ofertę w Marketplace, możesz utworzyć wersję roboczą przed przesłaniem zmian.

  • Jeśli dodatek został utworzony za pomocą Apps Script:

  • Jeśli dodatek został utworzony za pomocą usługi HTTP, pomiń wszelkie szczegóły konfiguracji aplikacji Google Chat w manifeście i wdrożeniach utworzonych za pomocą interfejsu Google Workspace Add-ons API. Wdrożenia HTTP, które określisz w pakiecie SDK Google Workspace Marketplace, będą używane tylko w innych aplikacjach Google Workspace.