Z tego artykułu dowiesz się, jak aplikacja Google Chat może wywoływać interfejs API Google Chat, który umożliwia aplikacjom Google Chat wykonywanie takich czynności jak tworzenie pokoju, dodawanie do niego osób i publikowanie wiadomości.
Uwierzytelnianie
Wywoływanie interfejsu Chat API wymaga uwierzytelnienia. Każda metoda interfejsu Chat API wymaga uwierzytelniania użytkownika (aby wykonywać działania lub uzyskiwać dostęp do danych w imieniu użytkownika) lub uwierzytelniania 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 aplikacji.
Więcej informacji o uwierzytelnianiu w Google Chat znajdziesz w artykule Omówienie uwierzytelniania.
Biblioteki klienta
Zalecany sposób wywoływania interfejsu Google Chat API przez większość deweloperów to użycie oficjalnie obsługiwanych bibliotek klienta Cloud w wybranym języku, np. Python, Java lub Node.js.
Jeśli kodujesz za pomocą Google Apps Script, zamiast instalować bibliotekę klienta, użyj usługi Google Chat zaawansowanej.
Pojęcia związane z Google Chat API
Usługi gRPC lub zasoby i metody REST przyznają dostęp do pokoi Google Chat, osób w pokoju, wiadomości, reakcji na wiadomości, załączników wiadomości, zdarzeń w pokoju oraz stanów przeczytania wiadomości przez użytkowników.
- 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 1:1 między dwoma użytkownikami lub użytkownikiem a aplikacją do czatu. Czaty grupowe to rozmowy między 3 lub większą liczbą użytkowników i aplikacji do czatu. Nazwane pokoje to trwałe miejsca, w których użytkownicy wysyłają wiadomości, udostępniają pliki i współpracują.
Odwołania do zasobów:
Przykładowe zastosowania:
- Uczestnicy
Użytkownicy to użytkownicy i aplikacje Google Chat, którzy dołączyli do pokoju lub zostali do niego zaproszeni.
Odwołania do zasobów:
Przykładowe zastosowania:
- Wiadomości
Wiadomości obejmują tekst i karty z komunikatami opublikowanymi w pokojach. Do wiadomości można załączać pliki. Użytkownicy mogą reagować na wiadomości, dodając do nich emotikony.
Odwołania do zasobów:
Przykładowe zastosowania:
- Reakcje
Reakcje to emotikony, których ludzie używają, aby wyrazić swoje uczucia w odpowiedzi na wiadomość, np. 👍, 🚲 i 🌞.
Odwołania do zasobów:
Przykładowe zastosowania:
- Niestandardowe emotikony (wersja dla programistów)
Niestandardowe emotikony to emotikony utworzone i udostępnione w organizacji w Google Chat. Niestandardowe emotikony można dodawać do treści wiadomości lub używać ich do reakcji na wiadomości.
Odwołania do zasobów:
- Multimedia i załączniki
Multimedia to pliki przesłane do Google Chat, takie jak obrazy, filmy i dokumenty.
Odwołania do zasobu multimedialnego (niedostępne w RPC):
Załączniki to instancje multimediów (plików) dołączonych do wiadomości.
Odwołania do zasobów:
Przykładowe zastosowania:
- Zdarzenia w pokoju
Zdarzenia dotyczące pokoju to zmiany w pokoju lub jego podrzędnych zasobach, w tym w jego użytkownikach, wiadomościach i reakcjach.
Odwołania do zasobów:
Przykładowe zastosowania:
- Stany odczytu przez użytkownika
Stany odczytania przez użytkownika to zasoby pojedyncze, które zawierają informacje o ostatniej przeczytanej wiadomości określonego użytkownika w pokoju Google Chat lub wątku wiadomości.
Odczyt stanu pokoju – odniesienie do zasobu:
Odniesienie do zasobu stanu odczytu wątku:
Przykładowe zastosowania:
- Ustawienia powiadomień w przestrzeni użytkownika (wersja dla deweloperów)
Ustawienia powiadomień w pokoju użytkownika to zasoby pojedyncze, które reprezentują określone ustawienia powiadomień użytkownika w pokoju Google Chat.
Odwołania do zasobów:
Powiązane artykuły
- Zobacz przykłady aplikacji Google Chat, aby rozpocząć korzystanie z interfejsu API Google Chat.
Oprócz wywoływania interfejsu API Google Chat aplikacje Google Chat mogą też:
- Otrzymuj zdarzenia interakcji z aplikacją Google Chat i odpowiadaj na nie, na przykład wiadomości wysyłane do aplikacji Google Chat, w czasie rzeczywistym.
- Subskrybować zdarzenia Google Chat, aby podejmować działania lub reagować, gdy w Google Chat pojawią się określone aktywności lub zmiany, takie jak nowe wiadomości i zmiany członkostwa.