W tej sekcji dowiesz się, jak aplikacja Google Chat może nawiązać połączenie interfejs Chat API, który umożliwia aplikacjom Google Chat wykonywanie takich czynności jak utworzyć grupę, dodać do niej osoby i publikować wiadomości Zdarzenie interakcji z aplikacją do obsługi czatu.
Uwierzytelnianie
Asynchroniczne 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.
Zasoby i metody interfejsu API
Zasoby i metody REST przyznają asynchroniczny dostęp do Google Chat pokoje, osoby w pokoju, wiadomości, reakcje na wiadomości i załączniki do wiadomości.
- 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ę.
spaces
zasób oznacza przestrzeń.Pokoje obsługują te metody:
- Utwórz pokój, miejsce, w którym ludzie i aplikacje mogą rozmawiać i udostępniać pliki.
- Konfigurowanie pokoju aby utworzyć pokój i dodać do niego osoby oraz aplikacje Google Chat kosmosu.
- Zrób pokój , aby wyświetlić szczegółowe informacje o pokoju.
- Pokoje listy aby zobaczyć podzieloną na strony listę pokoi z możliwością filtrowania.
- Aktualizowanie pokoju aby zmienić atrybuty pokoju, takie jak wyświetlana nazwa widoczna dla użytkowników opis i wytyczne.
- Usuwanie pokoju gdy nie są już potrzebne.
- Znajdowanie czatu odesłanie czatu między 2 użytkownikami lub rozmowy między użytkownikiem a użytkownikiem komunikatory;
- 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.
spaces.members
zasób reprezentuje użytkownika.Członkowie obsługują te metody:
- Tworzenie subskrypcji aby dodać użytkownika lub aplikację do pokoju.
- Jak rozpocząć subskrypcję , aby wyświetlić szczegóły subskrypcji.
- Członkostwo na liście aby wyświetlić podzieloną na strony, możliwą do filtrowania listę członkostwa w pokoju.
- Jak zaktualizować subskrypcję , aby zmienić atrybuty subskrypcji, takie jak zmiana członka pokoju na menedżerem pokoju lub zmianę menedżera na osobę w pokoju.
- Usuwanie subskrypcji aby usunąć użytkownika lub aplikację z pokoju.
- 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.
spaces.messages
zasób oznacza wiadomość.Wiadomości obsługują te metody:
- Tworzenie wiadomości aby opublikować tekst lub karty. Możesz też rozpocząć wątek wiadomości lub odpowiedzieć na niego.
- Odbierz wiadomość by poznać szczegóły wiadomości, np. datę jej wysłania lub treść.
- Wyświetlanie listy wiadomości
- Aktualizowanie wiadomości aby zmienić jego atrybuty, np. treść wiadomości. Możesz też dołączyć tekst do wiadomość na karcie, lub kartę w SMS-em.
- Usuwanie wiadomości gdy nie są już potrzebne.
- Reakcje
Reakcje reprezentują emotikony, których użytkownicy używają podczas reagowania na wiadomość, na przykład: 👍, 🚲 i 🌞.
spaces.messages.reactions
zasób oznacza reakcję.Reakcje obsługują te metody:
- Tworzenie reakcji , aby dołączyć emotikon do wiadomości.
- Lista reakcji aby wyświetlić podzieloną na strony, możliwą do filtrowania listę reakcji na wiadomość.
- Usuwanie reakcji aby usunąć emotikon z wiadomości.
- Multimedia i załączniki
Multimedia reprezentują plik przesłany do Google Chat, np. obrazy, filmy dokumenty.
media
zasób reprezentuje multimedia dołączoną do wiadomości.Załączniki to wystąpienia multimediów (plików) załączonych do wiadomości.
spaces.messages.attachments
zasób jest załącznikiem. Załącznik zawiera multimedia i powiązane metadanych dołączone do wiadomości.Nośniki i załączniki obsługują te metody:
- Przesyłanie multimediów jako załącznika aby przesłać multimedia do Google Chat, a następnie załączyć je do wiadomości.
- Pobieranie multimediów jako załącznika aby pobrać multimedia z Google Chat jako plik binarny.
- Pobieranie załącznika aby pobrać metadane dotyczące załącznika wiadomości.
- 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.
spaces.spaceEvent
reprezentuje wydarzenie kosmiczne.Zdarzenia w pokoju obsługują te metody:
- Zamów wydarzenie dotyczące pokoju aby zwrócić szczegółowe informacje o zdarzeniu, które miało miejsce w pokoju.
- Wyświetlanie listy wydarzeń w pokoju , aby uzyskać listę zdarzeń, które wystąpiły w pokoju.
- 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.
users.spaces
reprezentuje stan odczytu użytkownika w pokoju.users.spaces.threads
reprezentuje stan odczytu użytkownika w wątku.Stany odczytu użytkownika obsługują te metody:
- Pobieranie stanu odczytu pokoju aby zwrócić informacje o stanie odczytu użytkownika w pokoju.
- Aktualizowanie stanu odczytu pokoju , aby zaktualizować stan odczytu użytkownika w pokoju.
- Uzyskiwanie stanu odczytu wątku aby zwrócić szczegółowe informacje o stanie odczytu użytkownika w wątku.