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:
- Utwórz subskrypcję, aby dodać użytkownika lub aplikację do pokoju.
- Kup subskrypcję, aby zobaczyć szczegółowe informacje o subskrypcji.
- Członkostwo na liście, aby wyświetlić dzieloną na strony listę użytkowników w pokoju, którą można filtrować.
- zaktualizować subskrypcję, aby zmienić atrybuty pokoju, np. użytkownika pokoju lub zmienić jego menedżera w osobę w pokoju.
- usunąć subskrypcję, aby usunąć użytkownika lub aplikację z pokoju.
- 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:
- Utwórz wiadomość, aby opublikować tekst lub kartę. Możesz też rozpocząć wątek wiadomości lub na niego odpowiedzieć.
- Odbierz wiadomość, aby dowiedzieć się więcej o wiadomości, na przykład kiedy została wysłana lub jaka jest jej treść.
- Wyświetl listę wiadomości, aby wyświetlić dzieloną na strony listę wiadomości z możliwością filtrowania.
- Aktualizuj wiadomość, aby zmienić jej atrybuty, np. jej treść. Możesz też dołączyć tekst do wiadomości na karcie lub do wiadomości tekstowej.
- Usuń wiadomość, gdy nie jest już potrzebna.
- 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:
- Utwórz reakcję, aby dołączyć emotikon do wiadomości.
- Lista reakcji, aby wyświetlić dzielona na strony i filtrowaną listę reakcji na wiadomość.
- Usuń reakcję, aby usunąć emotikon z wiadomości.
- 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:
- Prześlij multimedia jako załącznik, aby przesłać multimedia do Google Chat, a następnie załączyć je do wiadomości.
- Pobierz multimedia jako załącznik, aby pobrać multimedia z Google Chat jako plik binarny.
- Pobierz załącznik, aby pobrać metadane załącznika wiadomości.
- 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:
- Pobierz zdarzenie w pokoju, aby uzyskać szczegółowe informacje o zdarzeniu, które miało miejsce w pokoju.
- Wyświetl listę zdarzeń w pokoju, aby uzyskać listę zdarzeń, które wystąpiły w pokoju.
- Stany odczytu użytkownika
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:
- Pobierz stan odczytu pokoju, aby zwrócić informacje o stanie odczytu użytkownika w pokoju.
- Aktualizuj stan odczytu pokoju, aby zaktualizować stan odczytu użytkownika w pokoju.
- Pobierz stan przeczytania wątku, aby zwrócić informacje o stanie przeczytania wątku przez użytkownika.