Tworzenie aplikacji w Google Chat

Na tej stronie znajdziesz omówienie interfejsu Google Chat API i aplikacji Google Chat.

Omówienie interfejsu Google Chat API

Chat API składa się z usług gRPC lub zasobów i metod REST, które zapewniają dostęp do Google Chat, w tym do pokoi, użytkowników pokoi, wiadomości, reakcji na wiadomości, załączników do wiadomości, zdarzeń w pokojach i stanów przeczytania przez użytkownika.

Pojęcia

W sekcji poniżej znajdziesz definicje usług, zasobów i metod interfejsu Chat API:

Pokoje

Pokoje to miejsca, w których użytkownicy i aplikacje mogą rozmawiać i udostępniać pliki. Istnieje kilka typów pokoi. Czaty to rozmowy między 2 użytkownikami lub użytkownikiem a aplikacją Google Chat. Czaty grupowe to rozmowy między co najmniej 3 użytkownikami a aplikacjami Google Chat. Pokoje z nazwami to trwałe miejsca, w których użytkownicy mogą wysyłać wiadomości, udostępniać pliki i współpracować.

Dokumentacja zasobów:

Przykłady użycia:

Uczestnicy

Uczestnicy to użytkownicy i aplikacje Google Chat, którzy dołączyli do pokoju lub zostali do niego zaproszeni.

Dokumentacja zasobów:

Przykłady użycia:

Wiadomości

Wiadomości obejmują tekst i komunikaty w postaci kart publikowane w pokojach. Do wiadomości można dołączać pliki. Użytkownicy mogą reagować na wiadomości, dodając do nich emotikony.

Dokumentacja zasobów:

Przykłady użycia:

Reakcje

Reakcje to emotikony, których użytkownicy używają do reagowania na wiadomości, np. 👍, 🚲 i 🌞.

Dokumentacja zasobów:

Przykłady użycia:

Niestandardowe emotikony

Niestandardowe emotikony to emotikony utworzone i udostępnione w organizacji w Google Chat. Niestandardowe emotikony można umieszczać w treści wiadomości lub używać do reagowania na wiadomości.

Dokumentacja zasobów:

Przykłady użycia:

Sekcje

Sekcje umożliwiają użytkownikom grupowanie rozmów i dostosowywanie listy pokoi wyświetlanej w panelu nawigacyjnym Google Chat. Dostępne są predefiniowane sekcje systemowe i niestandardowe sekcje zdefiniowane przez użytkownika.

Dokumentacja zasobów:

Przykłady użycia:

Multimedia i załączniki

Multimedia to plik przesłany do Google Chat, np. obraz, film lub dokument.

Dokumentacja zasobu multimediów (niedostępna w RPC):

Załączniki to instancje multimediów (plików) dołączonych do wiadomości.

Dokumentacja zasobów:

Przykłady użycia:

Zdarzenia w pokojach

Zdarzenia w pokojach to zmiany w pokoju lub jego zasobach podrzędnych, w tym w użytkownikach, wiadomościach i reakcjach.

Dokumentacja zasobów:

Przykłady użycia:

Stany przeczytania przez użytkownika

Stany przeczytania przez użytkownika to zasoby pojedyncze, które zawierają szczegóły dotyczące ostatniej przeczytanej wiadomości przez określonego użytkownika w pokoju Google Chat lub wątku.

Dokumentacja zasobu stanu przeczytania w pokoju:

Dokumentacja zasobu stanu przeczytania wątku:

Przykłady użycia:

Ustawienia powiadomień użytkownika w pokoju

Ustawienia powiadomień użytkownika w pokoju to zasoby pojedyncze, które zawierają ustawienia powiadomień określonego użytkownika w pokoju Google Chat.

Dokumentacja zasobów:

Uwierzytelnianie

Wywoływanie interfejsu Chat API wymaga uwierzytelnienia. Każda metoda interfejsu Chat API wymaga albo uwierzytelnienia użytkownika (aby wykonywać działania lub uzyskiwać dostęp do danych w jego imieniu), albo uwierzytelnienia aplikacji (aby wykonywać działania lub uzyskiwać dostęp do danych jako aplikacja Google Chat). Niektóre metody obsługują zarówno uwierzytelnianie użytkownika, jak i uwierzytelnianie aplikacji.

Więcej informacji o uwierzytelnianiu w Google Chat znajdziesz w artykule Omówienie uwierzytelniania.

Biblioteki klienta

Zalecanym sposobem wywoływania interfejsu Google Chat API dla większości programistów jest korzystanie z oficjalnie obsługiwanych bibliotek klienta Cloud w preferowanym języku, np. Python, Java lub Node.js.

Jeśli programujesz w Google Apps Script, zamiast instalować bibliotekę klienta, użyj usługi zaawansowanej Google Chat.

Tworzenie aplikacji Google Chat

Chat API umożliwia tworzenie aplikacji Google Chat, które przenoszą Twoje usługi i zasoby bezpośrednio do Google Chat. Aplikacje Google Chat mogą wykonywać te czynności:

  • pobierać informacje na podstawie zapytań w postaci tekstu strukturalnego lub dowolnego wprowadzonego przez użytkownika;
  • generować raporty o incydentach lub inne artefakty na podstawie informacji podanych przez użytkownika;
  • usprawniać współpracę w zespole, np. poprzez udostępnianie „pamięci zespołu” lub planowanie zasobów.

Aplikację Google Chat możesz zaprojektować, korzystając z kilku różnych stylów architektury, w tym z tych:

  • Aplikacje interaktywne: reagują na interakcje użytkownika, takie jak wzmianki @lub polecenia z ukośnikiem, i prezentują informacje lub prowadzą użytkowników przez proces za pomocą kart i okien dialogowych.
  • Aplikacje wiersza poleceń lub webhooki: wysyłają proaktywne wiadomości, np. alarmy lub powiadomienia, z innego systemu do pokoju. Użytkownicy nie mogą bezpośrednio wchodzić w interakcje z tego typu aplikacjami.
  • Aplikacje oparte na zdarzeniach: subskrybują aktywność w pokoju Google Chat i reagują na nią, np. na dołączenie nowego użytkownika. W odpowiedzi na zdarzenie aplikacja może wysłać wiadomość lub wykonać inne działanie.

Szczegółowe informacje o projektowaniu aplikacji Google Chat znajdziesz w artykule Wybieranie architektury aplikacji Google Chat.

Chcesz zobaczyć, jak działa interfejs Google Chat API?
Na kanale Google Workspace Developers znajdziesz filmy z poradami, wskazówkami i najnowszymi funkcjami.