Omówienie interfejsu Google Chat API

W tej sekcji wyjaśnimy, jak aplikacja Google Chat może wywoływać interfejs Chat API, który umożliwia aplikacjom Google Chat tworzenie pokoju, dodawanie do niego osób i publikowanie wiadomości bez pytania o zdarzenie interakcji z aplikacją Google Chat.

Uwierzytelnianie

Asynchroniczne wywoływanie interfejsu Chat API wymaga uwierzytelniania. Każda metoda interfejsu Chat API wymaga uwierzytelniania użytkownika (wykonywania działań lub dostępu do danych w imieniu użytkownika) lub uwierzytelniania aplikacji (wykonywania działań lub uzyskiwania dostępu do danych jako aplikacji Google Chat). Niektóre metody obsługują zarówno uwierzytelnianie użytkowników, jak i uwierzytelnianie aplikacji.

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

Zasoby i metody interfejsu API

Zasoby i metody REST przyznają asynchroniczny dostęp do pokoi czatu, użytkowników pokoi, wiadomości, reakcji na wiadomości i załączników do wiadomości.

Pokoje

Pokoje to miejsca, w których użytkownicy i aplikacje mogą rozmawiać i udostępniać pliki. Jest kilka rodzajów pokoi. Czaty to rozmowy 1:1 między 2 użytkownikami lub użytkownikiem a aplikacją Google Chat. Czaty grupowe to rozmowy między co najmniej 3 użytkownikami w aplikacjach Google Chat. Pokoje nazwane to trwałe miejsca, w których użytkownicy wysyłają wiadomości, udostępniają pliki i współpracują.

Zasób spaces reprezentuje pokój.

Pokoje obsługują te metody:

  • Utwórz pokój, czyli miejsce, w którym użytkownicy i aplikacje mogą rozmawiać i udostępniać pliki.
  • Skonfiguruj pokój, aby utworzyć pokój i dodać do niego osoby oraz aplikacje Google Chat.
  • Zarezerwuj pokój, aby wyświetlić szczegółowe informacje na jego temat.
  • Utwórz listę pokoi, aby wyświetlić listę pokoi z podziałem na strony i możliwością filtrowania.
  • Zaktualizuj pokój, aby zmienić atrybuty pokoju, takie jak jego wyświetlana nazwa widoczna dla użytkowników, opis i wytyczne.
  • usunąć pokój, gdy nie jest już potrzebny.
  • Znajdź czat, aby zwrócić czat między dwoma użytkownikami lub wiadomość między użytkownikiem a aplikacjami do rozmów.
Członkowie

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

Zasób spaces.members reprezentuje użytkownika.

Użytkownicy mogą korzystać z tych metod:

Wiadomości

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

Zasób spaces.messages reprezentuje wiadomość.

Wiadomości obsługują te metody:

Reakcje

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

Zasób spaces.messages.reactions reprezentuje reakcję.

Reakcje obsługują te metody:

Multimedia i załączniki

Multimedia to pliki przesłane do Google Chat, takie jak obrazy, filmy czy dokumenty.

Zasób media reprezentuje pliki multimedialne załączone do wiadomości.

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

Zasób spaces.messages.attachments reprezentuje załącznik. Załącznik zawiera multimedia i powiązane z nimi metadane, które są dołączone do wiadomości.

Multimedia i załączniki obsługują te metody:

Wydarzenia dotyczące pokoju

Zdarzenia w pokoju reprezentują zmiany wprowadzone w pokoju lub jego zasobach podrzędnych, w tym jego członków, wiadomości i reakcje.

Zasób spaces.spaceEvent reprezentuje wydarzenie kosmiczne.

Zdarzenia dotyczące pokoju obsługują te metody:

Stany odczytu użytkownika (wersja przedpremierowa dla programistów)

Stany odczytu użytkownika to pojedyncze zasoby, które reprezentują szczegóły ostatniej przeczytanej wiadomości użytkownika w pokoju Google Chat lub wątku wiadomości.

Zasób users.spaces reprezentuje stan odczytu w pokoju przez użytkownika.

Zasób users.spaces.threads reprezentuje stan przeczytany przez użytkownika w wątku wiadomości.

Stany odczytu użytkownika obsługują te metody: