W tej sekcji wyjaśniamy, jak aplikacja Google Chat może dzwonić interfejs Chat API, który umożliwia aplikacjom Google Chat wykonywanie takich czynności jak utworzyć grupę, dodać do niej osoby i opublikować wiadomość.
Uwierzytelnianie
Wywołanie interfejsu Chat API wymaga uwierzytelnienia. Każdy Metoda interfejsu Chat API wymaga: uwierzytelnianie użytkownika, (aby wykonywać działania lub otwierać danych w imieniu użytkownika) lub uwierzytelnianie aplikacji (aby wykonywać działania lub uzyskiwać dostęp do danych jako aplikacja Google Chat). Niektóre 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
Zalecany sposób wywoływania interfejsu Google Chat API przez większość deweloperów jest oficjalnie obsługiwany Biblioteki klienta Cloud na wybrany język, np. Pythona, Java czy Node.js.
Jeśli programujesz za pomocą Google Apps Script, użyj Zaawansowana usługa czatu zamiast instalować bibliotekę klienta.
Pojęcia związane z interfejsem Google Chat API
Usługi gRPC lub zasoby i metody REST przyznaj dostęp do pokoi czatu, użytkowników w pokoju, wiadomości, wiadomości reakcje, załączniki do wiadomości, zdarzenia w pokoju i stany odczytu przez użytkowników.
- Pokoje
Pokoje to miejsca, w których użytkownicy i aplikacje mogą rozmawiać i udostępniać pliki. OK jest kilka rodzajów pokoi. Czaty to rozmowy 1:1 między 2 użytkownikami lub użytkownikiem a aplikacją Google Chat. Grupuj czaty to rozmowy między co najmniej 3 użytkownikami, komunikatory; Pokoje nazwane to trwałe miejsca, do których użytkownicy wysyłają wiadomości wiadomości, udostępnianie plików i współpracę.
Materiały:
Przykłady użycia:
- Członkowie
Członkowie to użytkownicy i aplikacje Google Chat, którzy dołączyli lub należą do tej grupy zaprosił(a) Cię do pokoju.
Materiały:
Przykłady użycia:
- Wiadomości
Wiadomości obejmują tekst oraz karta wiadomości opublikowanych w pokojach. Do wiadomości można dołączać pliki. Użytkownicy mogą reagować na wiadomości, dołączając do nich emotikony.
Materiały:
Przykłady użycia:
- Reakcje
Reakcje reprezentują emotikony, których użytkownicy używają podczas reagowania na wiadomość, na przykład: 👍, 🚲 i 🌞.
Materiały:
Przykłady użycia:
- Multimedia i załączniki
Multimedia reprezentują plik przesłany do Google Chat, np. obrazy, filmy dokumenty.
Dokumentacja zasobów multimedialnych (niedostępna w RPC):
Załączniki to wystąpienia multimediów (plików) załączonych do wiadomości.
Materiały:
Przykłady użycia:
- Wydarzenia na temat pokoju
Zdarzenia dotyczące pokoju reprezentują zmiany w pokoju lub jego zasobów podrzędnych, w tym członków, wiadomości i reakcji.
Materiały:
Przykłady użycia:
- Stany odczytu użytkownika
Stany odczytu użytkownika to zasoby pojedynczych zasobów, które przedstawiają szczegóły ostatnia przeczytana wiadomość określonego użytkownika w pokoju Google Chat lub wiadomości w wątku.
Odwołanie do zasobu stanu odczytu pokoju:
Dokumentacja zasobu w stanie odczytu wątku:
Przykłady użycia:
Powiązane artykuły
- Zobacz przykładowe aplikacje Google Chat, aby: zacząć korzystać z interfejsu Chat API.
Oprócz wywoływania interfejsu Chat API aplikacje Google Chat mogą też:
- otrzymywać zdarzenia interakcji z aplikacją Google Chat i odpowiadać na nie, np. wiadomości wysyłane do aplikacji Google Chat w czasie rzeczywistym.
- Subskrybowanie wydarzeń w Google Chat podjąć działanie lub zareagować, aktywności i zmian w Google Chat, takich jak nowe wiadomości czy zmiany dotyczące subskrypcji.