Uwierzytelnianie i autoryzacja to mechanizmy służące odpowiednio do weryfikacji tożsamości i dostępu do zasobów. W tym dokumencie opisujemy, jak działa uwierzytelnianie i autoryzacja w przypadku aplikacji Google Chat i żądań do interfejsu Chat API.
Omówienie procesu
Na diagramie poniżej widać ogólne etapy uwierzytelniania i autoryzacji w Google Chat:
Skonfiguruj projekt Google Cloud, włącz interfejs Chat API i skonfiguruj aplikację Google Chat: podczas tworzenia aplikacji tworzysz projekt Google Cloud. W projekcie Google Cloud włączasz interfejs Chat API, konfigurujesz aplikację do Google Chat i konfigurujesz uwierzytelnianie. Więcej informacji znajdziesz w artykułach Tworzenie aplikacji w Google Workspace i Tworzenie aplikacji do Google Chat.
Wywołanie interfejsu Chat API: gdy aplikacja wywołuje interfejs Chat API, wysyła do niego dane uwierzytelniające. Jeśli aplikacja uwierzytelnia się za pomocą konta usługi, dane logowania są wysyłane jako część kodu aplikacji. Jeśli aplikacja wymaga wywołania interfejsu Chat API przy użyciu uwierzytelniania użytkownika, które nie zostało jeszcze przyznane, wyświetli się prośba o zalogowanie się.
Prośba o zasoby: aplikacja prosi o dostęp do zakresów określonych podczas konfigurowania uwierzytelniania.
Prośba o zgodę: jeśli aplikacja uwierzytelnia się jako użytkownik, Google wyświetla ekran zgody OAuth, aby użytkownik mógł zdecydować, czy chce przyznać aplikacji dostęp do żądanych danych. Uwierzytelnianie za pomocą konta usługi nie wymaga zgody użytkownika.
Wysyłanie zatwierdzonej prośby o zasoby: jeśli użytkownik wyrazi zgodę na zakresy uprawnień, aplikacja połączy dane logowania i zatwierdzone przez użytkownika zakresy w prośbę. Żądanie jest wysyłane do serwera autoryzacji Google w celu uzyskania tokena dostępu.
Google zwraca token dostępu: token dostępu zawiera listę przyznanych zakresów. Jeśli zwrócona lista zakresów jest bardziej restrykcyjna niż żądane zakresy, aplikacja wyłącza wszystkie funkcje ograniczone przez token.
Uzyskiwanie dostępu do żądanych zasobów: aplikacja używa tokena dostępu od Google, aby wywołać interfejs Chat API i uzyskać dostęp do jego zasobów.
Uzyskiwanie tokena odświeżania (opcjonalnie): jeśli aplikacja musi mieć dostęp do interfejsu Google Chat API po upływie okresu ważności pojedynczego tokena dostępu, może uzyskać token odświeżania. Więcej informacji znajdziesz w artykule o używaniu protokołu OAuth 2.0 na potrzeby dostępu do interfejsów API Google.
Żądanie dostępu do dodatkowych zasobów: jeśli aplikacja potrzebuje dostępu do dodatkowych zasobów, prosi użytkownika o przyznanie nowych zakresów, co powoduje wysłanie nowego żądania tokena dostępu (kroki 3–6).
Kiedy aplikacje do obsługi czatu wymagają uwierzytelnienia
Aplikacje do Google Chat mogą wysyłać wiadomości w odpowiedzi na interakcję użytkownika lub asynchronicznie. Mogą też wykonywać zadania w imieniu użytkownika, takie jak tworzenie pokoju czatu lub pobieranie listy osób w pokoju czatu.
Aplikacje do obsługi czatu nie wymagają uwierzytelniania, aby odpowiadać na interakcje użytkownika, chyba że podczas przetwarzania odpowiedzi aplikacja wywołuje interfejs Chat API lub inny interfejs API Google.
Aby wysyłać wiadomości asynchroniczne lub wykonywać zadania w imieniu użytkownika, aplikacje do Google Chat wysyłają żądania RESTful do interfejsu Chat API, które wymagają uwierzytelnienia i autoryzacji.
Odpowiedzi na interakcje użytkowników nie wymagają uwierzytelniania.
Aplikacje do Google Chat nie muszą uwierzytelniać się jako użytkownik ani aplikacja do Google Chat, aby otrzymywać interakcje użytkowników i odpowiadać na nie synchronicznie.
Aplikacje Google Chat otrzymują obiekty zdarzeń za każdym razem, gdy użytkownik wejdzie w interakcję z aplikacją Google Chat lub ją wywoła, m.in.:
- Użytkownik wysyła wiadomość do aplikacji do Google Chat.
- Użytkownik @wzmiankuje aplikację do Google Chat.
- Użytkownik wywołuje jedno z poleceń aplikacji do Google Chat.
Na poniższym diagramie przedstawiono sekwencję żądanie-odpowiedź między użytkownikiem Google Chat a aplikacją do Google Chat:
- Użytkownik wysyła wiadomość do aplikacji Google Chat w Google Chat.
- Google Chat przekazuje wiadomość do aplikacji.
- Aplikacja odbiera wiadomość, przetwarza ją i zwraca odpowiedź do Google Chat.
- Google Chat renderuje odpowiedź dla użytkownika lub w pokoju.
Ta sekwencja powtarza się w przypadku każdej interakcji użytkownika z aplikacją Google Chat.
Wiadomości asynchroniczne wymagają uwierzytelniania
Wiadomości asynchroniczne są wysyłane, gdy aplikacja Google Chat wysyła żądanie do interfejsu Chat API, które wymaga uwierzytelnienia i autoryzacji.
Wywołując interfejs Chat API, aplikacje do Google Chat mogą publikować wiadomości w Google Chat lub wykonywać zadania i uzyskiwać dostęp do danych w imieniu użytkownika. Na przykład po wykryciu awarii serwera aplikacja do obsługi czatu może wywołać interfejs Chat API, aby:
- Utwórz pokój czatu przeznaczony do analizowania i rozwiązywania problemu z przerwą w działaniu usługi.
- Dodaj osoby do pokoju czatu.
- Opublikuj wiadomość w pokoju czatu, aby podać szczegóły dotyczące przerwy w działaniu.
Na poniższym diagramie przedstawiono sekwencję wiadomości asynchronicznych między aplikacją Google Chat a pokojem czatu:
- Aplikacja do Google Chat tworzy wiadomość, wywołując interfejs Chat API za pomocą metody
spaces.messages.create, i dołącza do żądania HTTP dane logowania użytkownika. - Google Chat uwierzytelnia aplikację Google Chat za pomocą konta usługi lub danych logowania użytkownika.
- Google Chat renderuje wiadomość aplikacji w określonym pokoju Google Chat.
Zakresy interfejsu Chat API
Skonfiguruj ekran zgody OAuth i wybierz zakresy, aby określić, jakie informacje mają być wyświetlane użytkownikom i recenzentom aplikacji, oraz zarejestruj aplikację, aby móc ją później opublikować.
Aby określić poziom dostępu przyznany aplikacji, musisz zidentyfikować i zadeklarować zakresy autoryzacji. Zakres autoryzacji to ciąg znaków identyfikatora URI OAuth 2.0, który zawiera nazwę aplikacji Google Workspace, rodzaj danych, do których ma dostęp, oraz poziom dostępu.
Zakresy niewrażliwe
| Kod zakresu | Opis |
|---|---|
https://www.googleapis.com/auth/chat.bot
|
Umożliwia aplikacjom do Google Chat wyświetlanie czatów i wysyłanie wiadomości. Ten zakres obsługuje tylko uwierzytelnianie aplikacji za pomocą kont usługi. Nie możesz uwierzytelniać za pomocą danych logowania użytkownika ani przekazywania dostępu w całej domenie przy użyciu tego zakresu. |
Zakresy wrażliwe
| Kod zakresu | Opis |
|---|---|
https://www.googleapis.com/auth/chat.spaces
|
Tworzenie rozmów i pokoi oraz wyświetlanie i edytowanie metadanych (w tym ustawień historii i ustawień dostępu) w Google Chat. |
https://www.googleapis.com/auth/chat.spaces.create
|
tworzyć nowe rozmowy w Google Chat, |
https://www.googleapis.com/auth/chat.spaces.readonly
|
Wyświetlanie czatu i pokoi w Google Chat. |
https://www.googleapis.com/auth/chat.memberships
|
Wyświetlanie, dodawanie, aktualizowanie i usuwanie uczestników rozmów w Google Chat. |
https://www.googleapis.com/auth/chat.memberships.app
|
Dodawanie siebie do rozmowy w Google Chat i usuwanie siebie z rozmowy. |
https://www.googleapis.com/auth/chat.memberships.readonly
|
Wyświetlanie uczestników rozmów w Google Chat. |
https://www.googleapis.com/auth/chat.messages.create
|
Tworzenie i wysyłanie wiadomości w Google Chat. |
https://www.googleapis.com/auth/chat.messages.reactions
|
Wyświetlanie, dodawanie i usuwanie reakcji na wiadomości w Google Chat. |
https://www.googleapis.com/auth/chat.messages.reactions.create
|
dodawać reakcje do wiadomości w Google Chat, |
https://www.googleapis.com/auth/chat.messages.reactions.readonly
|
wyświetlać reakcje na wiadomość w Google Chat; |
https://www.googleapis.com/auth/chat.users.readstate
|
Wyświetlanie i modyfikowanie czasu ostatniego odczytu rozmów w Google Chat. |
https://www.googleapis.com/auth/chat.users.readstate.readonly
|
Wyświetlanie czasu ostatniego odczytu rozmów w Google Chat. |
https://www.googleapis.com/auth/chat.admin.spaces.readonly
|
Wyświetlanie czatu i pokoi należących do domeny administratora w Google Chat. |
https://www.googleapis.com/auth/chat.admin.spaces
|
Wyświetlanie i edytowanie czatów i pokoi należących do domeny administratora w Google Chat. |
https://www.googleapis.com/auth/chat.admin.memberships.readonly
|
Wyświetlanie użytkowników i menedżerów w rozmowach należących do domeny administratora w Google Chat. |
https://www.googleapis.com/auth/chat.admin.memberships
|
Wyświetlanie, dodawanie, aktualizowanie i usuwanie użytkowników oraz menedżerów w rozmowach należących do domeny administratora w Google Chat. |
https://www.googleapis.com/auth/chat.app.spaces
|
Tworzenie rozmów i pokoi oraz wyświetlanie i aktualizowanie metadanych (w tym ustawień historii i ustawień dostępu) w Google Chat jako aplikacja do Google Chat. Wymaga zatwierdzenia przez administratora. Ten zakres obsługuje tylko uwierzytelnianie aplikacji za pomocą kont usługi. Nie możesz uwierzytelniać za pomocą danych logowania użytkownika ani przekazywania dostępu w całej domenie przy użyciu tego zakresu. |
https://www.googleapis.com/auth/chat.app.spaces.readonly
|
Wyświetlanie metadanych (w tym ustawień historii) w Google Chat jako aplikacja do Google Chat. Wymaga zatwierdzenia przez administratora. Ten zakres obsługuje tylko uwierzytelnianie aplikacji za pomocą kont usługi. Nie możesz uwierzytelniać za pomocą danych logowania użytkownika ani przekazywania dostępu w całej domenie przy użyciu tego zakresu. |
https://www.googleapis.com/auth/chat.app.spaces.create
|
Tworzenie nowych rozmów i pokoi w Google Chat jako aplikacja do Google Chat. Wymaga zatwierdzenia przez administratora. Ten zakres obsługuje tylko uwierzytelnianie aplikacji za pomocą kont usługi. Nie możesz uwierzytelniać za pomocą danych logowania użytkownika ani przekazywania dostępu w całej domenie przy użyciu tego zakresu. |
https://www.googleapis.com/auth/chat.app.memberships
|
Wyświetlanie, dodawanie, aktualizowanie i usuwanie uczestników rozmów i pokoi w Google Chat jako aplikacja Google Chat. Wymaga zatwierdzenia przez administratora. Ten zakres obsługuje tylko uwierzytelnianie aplikacji za pomocą kont usługi. Nie możesz uwierzytelniać za pomocą danych logowania użytkownika ani przekazywania dostępu w całej domenie przy użyciu tego zakresu. |
https://www.googleapis.com/auth/chat.app.memberships.readonly
|
Wyświetlanie użytkowników w rozmowach i pokojach w Google Chat jako aplikacja do Google Chat. Wymaga zatwierdzenia przez administratora. Ten zakres obsługuje tylko uwierzytelnianie aplikacji za pomocą kont usługi. Nie możesz uwierzytelniać za pomocą danych logowania użytkownika ani przekazywania dostępu w całej domenie przy użyciu tego zakresu. |
https://www.googleapis.com/auth/chat.customemojis
|
Wyświetlanie, tworzenie i usuwanie niestandardowych emotikonów w Google Chat. |
https://www.googleapis.com/auth/chat.customemojis.readonly
|
Wyświetlanie niestandardowych emotikonów w Google Chat. |
https://www.googleapis.com/auth/chat.users.spacesettings
|
Wyświetlanie i aktualizowanie ustawień pokoju użytkownika Google Chat. |
https://www.googleapis.com/auth/chat.users.sections
|
Wyświetlanie, tworzenie, aktualizowanie i usuwanie sekcji w Google Chat; przenoszenie i wyświetlanie elementów sekcji w Google Chat. |
https://www.googleapis.com/auth/chat.users.sections.readonly
|
Wyświetlanie sekcji i ich elementów w Google Chat. |
Zakresy z ograniczeniami
| Kod zakresu | Opis |
|---|---|
https://www.googleapis.com/auth/chat.delete
|
Usuwanie rozmów i pokoi oraz odbieranie dostępu do powiązanych plików w Google Chat. |
https://www.googleapis.com/auth/chat.import
|
Importowanie pokoi, wiadomości i subskrypcji do Google Chat. Więcej informacji znajdziesz w artykule Autoryzowanie aplikacji Google Chat do importowania danych. |
https://www.googleapis.com/auth/chat.messages
|
Wyświetlanie, tworzenie, wysyłanie, aktualizowanie i usuwanie wiadomości oraz dodawanie, wyświetlanie i usuwanie reakcji na wiadomości. |
https://www.googleapis.com/auth/chat.messages.readonly
|
Wyświetlanie wiadomości i reakcji w Google Chat. |
https://www.googleapis.com/auth/chat.app.messages.readonly
|
Wyświetlanie wiadomości i reakcji w Google Chat jako aplikacja do Google Chat. Wymaga zatwierdzenia przez administratora. Ten zakres obsługuje tylko uwierzytelnianie aplikacji za pomocą kont usługi. Nie możesz uwierzytelniać za pomocą danych logowania użytkownika ani przekazywania dostępu w całej domenie przy użyciu tego zakresu. |
https://www.googleapis.com/auth/chat.admin.delete
|
Usuwanie rozmów i pokoi należących do domeny administratora oraz odbieranie dostępu do powiązanych plików w Google Chat. |
https://www.googleapis.com/auth/chat.app.delete
|
Usuwanie rozmów i pokoi oraz odbieranie dostępu do powiązanych plików w Google Chat jako aplikacja do Google Chat. Wymaga zatwierdzenia przez administratora. Ten zakres obsługuje tylko uwierzytelnianie aplikacji za pomocą kont usługi. Nie możesz uwierzytelniać za pomocą danych logowania użytkownika ani przekazywania dostępu w całej domenie przy użyciu tego zakresu. |
Zakresy w poprzednich tabelach wskazują ich poufność zgodnie z tymi definicjami:
Niewrażliwe – te zakresy zapewniają najmniejszy zakres dostępu i wymagają tylko podstawowej weryfikacji aplikacji. Więcej informacji o tym wymaganiu znajdziesz w sekcji Kroki, które należy wykonać, aby przygotować się do weryfikacji.
Poufne – te zakresy uprawnień dają aplikacji dostęp do danych Google konkretnego użytkownika po uzyskaniu od niego autoryzacji. Wymaga to dodatkowej weryfikacji aplikacji. Więcej informacji o tym wymaganiu znajdziesz w artykule Kroki dla aplikacji, które proszą o dostęp do zakresów poufnych.
Z ograniczeniami – te zakresy zapewniają szeroki dostęp do danych użytkowników Google i wymagają przejścia procesu weryfikacji zakresu z ograniczeniami. Więcej informacji o tym wymaganiu znajdziesz w artykułach Zasady dotyczące danych użytkownika w usługach interfejsu API Google i Dodatkowe wymagania dotyczące określonych zakresów interfejsu API. Zobacz też Czynności, które należy wykonać w przypadku aplikacji proszących o dostęp do zakresów z ograniczeniami.
Jeśli Twoja aplikacja wymaga dostępu do innych interfejsów API Google, możesz dodać również te zakresy. Więcej informacji o zakresach interfejsów API Google znajdziesz w artykule Używanie protokołu OAuth 2.0 na potrzeby dostępu do interfejsów API Google.
Więcej informacji o zakresach interfejsów API Google Workspace znajdziesz w artykule Konfigurowanie ekranu zgody OAuth i wybieranie zakresów.
Typy wymaganych metod uwierzytelniania
Aplikacje do obsługi czatu mogą uwierzytelniać i autoryzować żądania do interfejsu Chat API na 2 sposoby:
- Uwierzytelnianie użytkowników
- Uwierzytelnianie użytkownika umożliwia aplikacji do Google Chat dostęp do danych użytkownika i wykonywanie działań w jego imieniu. Zakresy OAuth określają autoryzowane dane i działania. Jeśli aplikacja do Google Chat nie została zainstalowana przez administratora lub nie ma przekazanych uprawnień na całą domenę, przy pierwszym działaniu w imieniu użytkownika musi on autoryzować aplikację do Google Chat na ekranie zgody OAuth.
- Uwierzytelnianie aplikacji
Uwierzytelnianie aplikacji umożliwia aplikacji Google Chat używanie danych logowania konta usługi oraz uzyskiwanie dostępu do danych i wykonywanie działań we własnym imieniu. Aplikacja do Google Chat używa własnych danych logowania, aby uzyskiwać dostęp do zasobów i pracować z nimi, dlatego użytkownicy nie muszą zatwierdzać wywołań interfejsu API aplikacji do Google Chat. Nie możesz też dodawać zakresów autoryzacji OAuth, które obsługują autoryzację aplikacji, do ekranu zgody OAuth.
Uwierzytelnianie aplikacji obsługują 2 typy zakresów autoryzacji OAuth:
https://www.googleapis.com/auth/chat.bot: aplikacja do Google Chat może wywoływać metody interfejsu Google Chat API, które obsługują ten zakres autoryzacji, aby tworzyć, aktualizować, pobierać, wyświetlać lub usuwać zasoby, do których ma dostęp, takie jak wiadomości w pokojach, do których użytkownicy dodają aplikację do Google Chat. Aplikacja do Google Chat może samodzielnie przyznać sobie ten zakres autoryzacji, bez konieczności autoryzacji przez administratora lub użytkownika.https://www.googleapis.com/auth/chat.app.*: Używanie tych zakresów wymaga jednorazowego zatwierdzenia przez administratora. Aby uzyskać zatwierdzenie administratora, przygotuj konto usługi aplikacji Google Chat do zatwierdzenia przez administratora, tworząc klienta OAuth zgodnego z Google Workspace Marketplace i konfigurując aplikację w pakiecie SDK Google Workspace Marketplace. Te zakresy umożliwiają aplikacji Google Chat wywoływanie określonych metod interfejsu Google Chat API. Na przykładchat.app.spaces.createpozwala aplikacjom tworzyć pokoje Google Chat.
Jeśli metoda obsługuje zarówno uwierzytelnianie użytkownika, jak i aplikacji, interfejs Chat API zwraca różne wyniki w zależności od używanego typu uwierzytelniania:
- W przypadku uwierzytelniania aplikacji metody zwracają tylko zasoby, do których aplikacja Google Chat ma dostęp.
- W przypadku uwierzytelniania użytkownika metody zwracają tylko zasoby, do których użytkownik ma dostęp.
Na przykład wywołanie metody spaces.list() z autoryzacją aplikacji zwraca listę pokoi, do których należy aplikacja Google Chat.
Wywołanie metody spaces.list() z autoryzacją użytkownika zwraca listę pokoi, do których należy użytkownik. W praktyce podczas wywoływania interfejsu Chat API możesz używać obu typów uwierzytelniania, w zależności od projektu i funkcji aplikacji Google Chat.
Asynchroniczne wywołania interfejsu Chat API
W tabeli poniżej znajdziesz listę metod interfejsu Chat API i obsługiwanych przez nie zakresów autoryzacji:
| Metoda | Obsługiwane uwierzytelnianie użytkowników | Obsługiwane uwierzytelnianie aplikacji | Obsługiwane zakresy autoryzacji | |
|---|---|---|---|---|
| Pokoje | ||||
| Tworzenie pokoju |
W przypadku uwierzytelniania użytkowników:
|
|||
| Konfigurowanie pokoju | – |
W przypadku uwierzytelniania użytkowników:
|
||
| Pobieranie pokoju |
W przypadku uwierzytelniania użytkowników:
|
|||
| Wyświetlanie listy pokoi |
W przypadku uwierzytelniania użytkowników:
|
|||
| Obszary wyszukiwania | – |
W przypadku uwierzytelniania użytkowników przy użyciu uprawnień administratora:
|
||
| Aktualizowanie pokoju |
W przypadku uwierzytelniania użytkowników:
|
|||
| Usuwanie pokoju |
W przypadku uwierzytelniania użytkowników:
|
|||
| Kończenie procesu importowania pokoju | – |
W przypadku uwierzytelniania użytkowników:
|
||
| Znajdowanie czatu |
W przypadku uwierzytelniania użytkowników:
|
|||
| Uczestnicy | ||||
| Tworzenie użytkownika |
W przypadku uwierzytelniania użytkowników:
|
|||
| Pobieranie informacji o użytkowniku |
W przypadku uwierzytelniania użytkowników:
|
|||
| Członkowie grupy |
W przypadku uwierzytelniania użytkowników:
|
|||
| Usuwanie użytkownika |
W przypadku uwierzytelniania użytkowników:
|
|||
| Aktualizowanie użytkownika |
W przypadku uwierzytelniania użytkowników:
|
|||
| Wiadomości | ||||
| Tworzenie wiadomości |
W przypadku uwierzytelniania użytkowników:
|
|||
| Odbieranie wiadomości |
W przypadku uwierzytelniania użytkowników:
|
|||
| Wyświetlanie listy wiadomości |
W przypadku uwierzytelniania użytkowników:
|
|||
| Wyszukiwanie wiadomości | – |
W przypadku uwierzytelniania użytkowników:
|
||
| Aktualizowanie wiadomości |
W przypadku uwierzytelniania użytkowników:
|
|||
| Usuwanie wiadomości |
W przypadku uwierzytelniania użytkowników:
|
|||
| Przypinanie wiadomości | – |
W przypadku uwierzytelniania użytkowników:
|
||
| Odpinanie wiadomości | – |
W przypadku uwierzytelniania użytkowników:
|
||
| Wyświetlanie listy przypiętych wiadomości | – |
W przypadku uwierzytelniania użytkowników:
|
||
| Aktualizowanie kart w wiadomości | – |
W przypadku uwierzytelniania aplikacji:
|
||
| Reakcje | ||||
| Tworzenie reakcji | – |
W przypadku uwierzytelniania użytkowników:
|
||
| Wyświetlanie listy reakcji | – |
W przypadku uwierzytelniania użytkowników:
|
||
| Usuwanie reakcji | – |
W przypadku uwierzytelniania użytkownika:
|
||
| niestandardowe emotikony, | ||||
| Tworzenie niestandardowego emotikonu | – |
W przypadku uwierzytelniania użytkowników:
|
||
| Usuwanie niestandardowego emotikonu | – |
W przypadku uwierzytelniania użytkowników:
|
||
| Uzyskiwanie niestandardowego emotikonu | – |
W przypadku uwierzytelniania użytkowników:
|
||
| Wyświetlanie listy niestandardowych emotikonów | – |
W przypadku uwierzytelniania użytkowników:
|
||
| Multimedia i załączniki | ||||
| Przesyłanie multimediów jako załącznika do pliku | – |
W przypadku uwierzytelniania użytkowników:
|
||
| Pobieranie multimediów |
W przypadku uwierzytelniania użytkowników:
|
|||
| Pobieranie załącznika do wiadomości | – |
W przypadku uwierzytelniania aplikacji:
|
||
| Stany odczytu użytkownika | ||||
| Pobieranie stanu przeczytania pokoju przez użytkownika | – |
W przypadku uwierzytelniania użytkowników:
|
||
| Aktualizowanie stanu przeczytania pokoju przez użytkownika | – |
W przypadku uwierzytelniania użytkowników:
|
||
| Pobieranie stanu przeczytania wątku przez użytkownika | – |
W przypadku uwierzytelniania użytkowników:
|
||
| Ustawienia pokoju użytkownika | ||||
| Pobieranie ustawień powiadomień o pokoju użytkownika | – |
W przypadku uwierzytelniania użytkowników:
|
||
| Aktualizowanie ustawień powiadomień użytkownika dotyczących pokoju | – |
W przypadku uwierzytelniania użytkowników:
|
||
| Zdarzenia w pokoju | ||||
| Pobieranie zdarzeń dotyczących pokoju | – |
W przypadku uwierzytelniania użytkowników musisz użyć zakresu opartego na
typie zdarzenia:
|
||
| Wyświetlanie listy zdarzeń w pokoju | – |
W przypadku uwierzytelniania użytkownika musisz użyć zakresu dla każdego
typu zdarzenia uwzględnionego w żądaniu:
|
||
| Sekcje | ||||
| Tworzenie sekcji | – |
W przypadku uwierzytelniania użytkowników:
|
||
| Usuwanie sekcji | – |
W przypadku uwierzytelniania użytkowników:
|
||
| Wyświetlanie listy sekcji | – |
W przypadku uwierzytelniania użytkowników:
|
||
| Aktualizowanie sekcji | – |
W przypadku uwierzytelniania użytkowników:
|
||
| Pozycjonowanie sekcji | – |
W przypadku uwierzytelniania użytkowników:
|
||
| Elementy sekcji | ||||
| Przenoszenie elementu sekcji | – |
W przypadku uwierzytelniania użytkowników:
|
||
| Wyświetlanie listy elementów sekcji | – |
W przypadku uwierzytelniania użytkowników:
|
||
Zdarzenia interakcji z aplikacją do Google Chat
W poniższej tabeli znajdziesz typowe sposoby interakcji użytkowników z aplikacjami do Google Chat oraz informacje o tym, czy wymagane lub obsługiwane jest uwierzytelnianie:
| Scenariusz | Uwierzytelnianie nie jest wymagane | Obsługiwane uwierzytelnianie użytkowników | Obsługiwane uwierzytelnianie aplikacji | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Odbieraj wiadomości od: |
|
|||||||||||||||
| Odpowiadanie na wiadomości: |
|
|||||||||||||||
| Wysyłanie nowych wiadomości: |
|
|||||||||||||||
Powiązane artykuły
- Omówienie uwierzytelniania i autoryzacji w Google Workspace znajdziesz w artykule Informacje o uwierzytelnianiu i autoryzacji.
- Omówienie uwierzytelniania i autoryzacji w Google Cloud znajdziesz w artykule Omówienie uwierzytelniania.
- Więcej informacji o kontach usługi znajdziesz w artykule Konta usługi.
- Więcej informacji o tym, jak interfejsy API Google korzystają z protokołu OAuth 2.0, znajdziesz w artykule Używanie protokołu OAuth 2.0 na potrzeby dostępu do interfejsów API Google.
- Skonfiguruj uwierzytelnianie i autoryzację za pomocą danych logowania użytkownika lub konta usługi.
- Informacje o zarządzaniu szczegółowymi uprawnieniami OAuth znajdziesz w artykule Zarządzanie szczegółowymi uprawnieniami OAuth w aplikacjach do Google Chat.