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, członków pokoi, wiadomości, reakcji na wiadomości, załączników do wiadomości, wydarzeń w pokoju i stanów odczytu 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 rodzajów pokoi. Czaty to rozmowy indywidualne 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ć.

Odwołanie do zasobu:

Przykłady użycia znajdziesz w tych artykułach:

Członkowie

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

Odwołanie do zasobu:

Przykłady użycia znajdziesz w tych artykułach:

Wiadomości

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

Odwołanie do zasobu:

Przykłady użycia znajdziesz w tych artykułach:

Reakcje

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

Odwołanie do zasobu:

Przykłady użycia znajdziesz w tych artykułach:

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.

Odwołanie do zasobu:

Przykłady użycia znajdziesz w tych artykułach:

Multimedia i załączniki

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

Odwołanie do zasobu multimedialnego (niedostępne w RPC):

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

Odwołanie do zasobu:

Przykłady użycia znajdziesz w tych artykułach:

Wydarzenia w Space

Zdarzenia w pokoju reprezentują zmiany w pokoju lub jego zasobach podrzędnych, w tym w członkach, wiadomościach i reakcjach.

Odwołanie do zasobu:

Przykłady użycia znajdziesz w tych artykułach:

Stan odczytu użytkownika

Stany odczytu użytkownika to pojedyncze zasoby, które zawierają szczegółowe informacje o ostatniej przeczytanej wiadomości przez określonego użytkownika w pokoju Google Chat lub w wątku wiadomości.

Dokumentacja zasobu stanu odczytu przestrzeni:

Dokumentacja zasobu stanu odczytu wątku:

Przykłady użycia znajdziesz w tych artykułach:

Ustawienia powiadomień w przestrzeni użytkownika

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

Odwołanie do zasobu:

Uwierzytelnianie

Wywoływanie interfejsu Chat API wymaga uwierzytelnienia. Każda metoda interfejsu Chat API wymaga uwierzytelnienia użytkownika (aby wykonywać działania lub uzyskiwać dostęp do danych w imieniu użytkownika) albo uwierzytelnienia aplikacji (aby wykonywać działania lub uzyskiwać dostęp do danych jako aplikacja do czatu). 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 deweloperów jest korzystanie z naszych oficjalnie obsługiwanych bibliotek klienta Cloud w wybranym języku, np. Python, Java lub Node.js.

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

Tworzenie aplikacji Google Chat

Interfejs Chat API umożliwia tworzenie aplikacji Google Chat, które integrują Twoje usługi i zasoby z Google Chat. Aplikacje do czatowania możesz tworzyć w celu wykonywania tych czynności:

  • Pobieranie informacji na podstawie zapytań w formie uporządkowanego lub swobodnego tekstu wprowadzonych przez użytkownika.
  • generować raporty o incydentach lub inne artefakty na podstawie informacji podanych przez użytkownika;
  • Usprawnianie współpracy w zespole, np. poprzez zapewnianie „pamięci zespołu” lub planowanie zasobów.

Aplikację do obsługi czatu możesz zaprojektować w kilku różnych stylach architektury, w tym:

  • Aplikacje interaktywne: reagują na interakcje użytkowników, takie jak @wzmianki czy polecenia z ukośnikiem, i prezentują informacje lub prowadzą użytkowników przez przepływ pracy za pomocą kart i okien dialogowych.
  • Aplikacje wiersza poleceń lub webhooki: wysyłanie do pokoju proaktywnych wiadomości, takich jak alarmy lub powiadomienia, z innego systemu. Użytkownicy nie mogą bezpośrednio wchodzić w interakcje z tego typu aplikacjami.
  • Aplikacje oparte na zdarzeniach: subskrybuj aktywność w pokoju w 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.

Więcej informacji 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 informacjami o najnowszych funkcjach.