Uwierzytelnianie i autoryzowanie aplikacji do obsługi czatu oraz żądań do interfejsu Google Chat API

Uwierzytelnianie i autoryzacja to mechanizmy służące odpowiednio do weryfikacji tożsamości i dostępu do zasobów. W tym dokumencie opisano, jak działa uwierzytelnianie i autoryzacja w przypadku aplikacji Google Chat i żądań do interfejsu API Google Chat.

Omówienie procesu

Na diagramie poniżej widać ogólne etapy uwierzytelniania i autoryzacji w Google Chat:

Ogólne instrukcje dotyczące uwierzytelniania i autoryzacji w Google Chat
Rysunek 1. Ogólne instrukcje dotyczące uwierzytelniania i autoryzacji w Google Chat.

  1. Skonfiguruj projekt Google Cloud, włącz Chat API i skonfiguruj aplikację Google Chat: podczas tworzenia aplikacji utwórz 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 Programowanie w Google Workspace i Tworzenie aplikacji do Google Chat.

  2. 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ę.

  3. Żądanie zasobów: aplikacja prosi o dostęp do zakresów określonych podczas konfigurowania uwierzytelniania.

  4. 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.

  5. Wysyłanie zatwierdzonej prośby o zasoby: jeśli użytkownik wyrazi zgodę na zakresy autoryzacji, 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.

  6. 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.

  7. 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.

  8. 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.

  9. Prośba o dostęp do dodatkowych zasobów: jeśli aplikacja potrzebuje większego dostępu, prosi użytkownika o przyznanie nowych zakresów, co powoduje wysłanie nowej prośby o token dostępu (kroki 3–6).

Kiedy aplikacje do obsługi czatu wymagają uwierzytelniania

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 Google Chat nie wymagają uwierzytelniania, aby odpowiadać na interakcje użytkownika, chyba że podczas przetwarzania odpowiedzi wywołują 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ć i synchronicznie odpowiadać na interakcje użytkownika.

Aplikacje do Google Chat otrzymują obiekty zdarzeń za każdym razem, gdy użytkownik wejdzie w interakcję z aplikacją do 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 obsługi czatu.

Na poniższym diagramie przedstawiono sekwencję żądanie-odpowiedź między użytkownikiem Google Chat a aplikacją do Google Chat:

Brak konieczności autoryzacji interakcji użytkownika z aplikacją do Google Chat
Rysunek 2. Interakcje użytkowników z aplikacją do Google Chat nie wymagają uwierzytelniania.

  1. Użytkownik wysyła wiadomość do aplikacji Google Chat w Google Chat.
  2. Google Chat przekazuje wiadomość do aplikacji.
  3. Aplikacja odbiera wiadomość, przetwarza ją i zwraca odpowiedź do Google Chat.
  4. 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 przerwy w działaniu serwera aplikacja do Google Chat może wywołać interfejs Chat API, aby:

  • Utwórz pokój czatu przeznaczony do analizowania i rozwiązywania problemów 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 usługi.

Poniższy diagram przedstawia sekwencję wiadomości asynchronicznych między aplikacją Google Chat a pokojem czatu:

Uwierzytelnianie wymagane w przypadku wiadomości asynchronicznych
Rysunek 3. Wiadomości asynchroniczne wymagają uwierzytelniania.

  1. Aplikacja do Google Chat tworzy wiadomość, wywołując interfejs Chat API za pomocą metody spaces.messages.create, i dołącza dane logowania użytkownika do żądania HTTP.
  2. Google Chat uwierzytelnia aplikację do Google Chat za pomocą konta usługi lub danych logowania użytkownika.
  3. Google Chat renderuje wiadomość aplikacji w określonym pokoju czatu.

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 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.readonly

Wyświetlanie uczestników 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.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:

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 Google Workspace API znajdziesz w artykule Konfigurowanie ekranu zgody OAuth i wybieranie zakresów.

Typy wymaganego uwierzytelniania

Aplikacje Google Chat mogą uwierzytelniać i autoryzować żądania do interfejsu Chat API na 2 sposoby:

Uwierzytelnianie użytkowników
Uwierzytelnianie użytkownika umożliwia aplikacji 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 przekazywania dostępu w całej domenie, przy pierwszym działaniu w imieniu użytkownika musi on autoryzować aplikację do Google Chat za pomocą ekranu zgody OAuth.
Uwierzytelnianie aplikacji

Uwierzytelnianie aplikacji umożliwia aplikacji Google Chat używanie danych logowania konta usługi, uzyskiwanie dostępu do danych i wykonywanie działań we własnym imieniu. Aplikacja 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 Google Chat. Nie możesz też dodawać do ekranu zgody OAuth zakresów autoryzacji OAuth, które obsługują autoryzację aplikacji.

Uwierzytelnianie aplikacji obsługują 2 typy zakresów autoryzacji OAuth:

  • https://www.googleapis.com/auth/chat.bot: Twoja 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ą Twoją aplikację do Google Chat. Aplikacja 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ład chat.app.spaces.create zezwala aplikacjom na tworzenie pokoi czatu.

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 te 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żytkownika:
  • chat.spaces.create
  • chat.spaces
  • chat.import
Z uwierzytelnianiem aplikacji i zatwierdzeniem przez administratora:
  • chat.app.spaces.create
  • chat.app.spaces
Konfigurowanie pokoju – W przypadku uwierzytelniania użytkownika:
  • chat.spaces.create
  • chat.spaces
Pobieranie pokoju W przypadku uwierzytelniania użytkownika:
  • chat.spaces.readonly
  • chat.spaces
Uwierzytelnianie użytkowników przy użyciu uprawnień administratora:
  • chat.admin.spaces.readonly
Za pomocą uwierzytelniania aplikacji:
  • chat.bot
Z uwierzytelnianiem aplikacji i zatwierdzeniem przez administratora:
  • chat.app.spaces
Wyświetlanie listy pokoi W przypadku uwierzytelniania użytkownika:
  • chat.spaces.readonly
  • chat.spaces
Za pomocą uwierzytelniania aplikacji:
  • chat.bot
Obszary wyszukiwania – W przypadku uwierzytelniania użytkownika za pomocą uprawnień administratora:
  • chat.admin.spaces.readonly
Aktualizowanie pokoju W przypadku uwierzytelniania użytkownika:
  • chat.spaces
  • chat.import
Uwierzytelnianie użytkowników przy użyciu uprawnień administratora:
  • chat.admin.spaces
Z uwierzytelnianiem aplikacji i zatwierdzeniem przez administratora:
  • chat.app.spaces
Usuwanie pokoju W przypadku uwierzytelniania użytkownika:
  • chat.delete
  • chat.import
Uwierzytelnianie użytkowników przy użyciu uprawnień administratora:
  • chat.admin.delete
Z uwierzytelnianiem aplikacji i zatwierdzeniem przez administratora:
  • chat.app.delete
Kończenie procesu importowania pokoju – W przypadku uwierzytelniania użytkownika:
  • chat.import
Znajdowanie czatu W przypadku uwierzytelniania użytkownika:
  • chat.spaces.readonly
  • chat.spaces
Za pomocą uwierzytelniania aplikacji:
  • chat.bot
Uczestnicy  
Tworzenie użytkownika W przypadku uwierzytelniania użytkownika:
  • chat.memberships
  • chat.memberships.app
  • chat.import
Uwierzytelnianie użytkowników przy użyciu uprawnień administratora:
  • chat.admin.memberships
Z uwierzytelnianiem aplikacji i zatwierdzeniem przez administratora:
  • chat.app.memberships
Pobieranie informacji o użytkowniku W przypadku uwierzytelniania użytkownika:
  • chat.memberships.readonly
  • chat.memberships
Za pomocą uwierzytelniania aplikacji:
  • chat.bot
Uwierzytelnianie użytkowników przy użyciu uprawnień administratora:
  • chat.admin.memberships.readonly
Członkowie grupy W przypadku uwierzytelniania użytkownika:
  • chat.memberships.readonly
  • chat.memberships
  • chat.import
Za pomocą uwierzytelniania aplikacji:
  • chat.bot
Uwierzytelnianie użytkowników przy użyciu uprawnień administratora:
  • chat.admin.memberships.readonly
Usuwanie użytkownika W przypadku uwierzytelniania użytkownika:
  • chat.memberships
  • chat.memberships.app
  • chat.import
Uwierzytelnianie użytkowników przy użyciu uprawnień administratora:
  • chat.admin.memberships
Z uwierzytelnianiem aplikacji i zatwierdzeniem przez administratora:
  • chat.app.memberships
Aktualizowanie użytkownika W przypadku uwierzytelniania użytkownika:
  • chat.memberships
  • chat.import
Uwierzytelnianie użytkowników przy użyciu uprawnień administratora:
  • chat.admin.memberships
Z uwierzytelnianiem aplikacji i zatwierdzeniem przez administratora:
  • chat.app.memberships
Wiadomości  
Tworzenie wiadomości W przypadku uwierzytelniania użytkownika:
  • chat.messages.create
  • chat.messages
  • chat.import
Za pomocą uwierzytelniania aplikacji:
  • chat.bot
Odbieranie wiadomości W przypadku uwierzytelniania użytkownika:
  • chat.messages.readonly
  • chat.messages
Za pomocą uwierzytelniania aplikacji:
  • chat.bot
Z uwierzytelnianiem aplikacji i zatwierdzeniem przez administratora:
  • chat.app.messages.readonly
Wyświetlanie listy wiadomości W przypadku uwierzytelniania użytkownika:
  • chat.messages.readonly
  • chat.messages
  • chat.import
Z uwierzytelnianiem aplikacji i zatwierdzeniem przez administratora:
  • chat.app.messages.readonly
Wyszukiwanie wiadomości – W przypadku uwierzytelniania użytkownika:
  • chat.messages.readonly
  • chat.messages
Aktualizowanie wiadomości W przypadku uwierzytelniania użytkownika:
  • chat.messages
  • chat.import
Za pomocą uwierzytelniania aplikacji:
  • chat.bot
Usuwanie wiadomości W przypadku uwierzytelniania użytkownika:
  • chat.messages
  • chat.import
Za pomocą uwierzytelniania aplikacji:
  • chat.bot
Przypinanie wiadomości – W przypadku uwierzytelniania użytkownika:
  • chat.spaces.pins
  • chat.spaces
Odpinanie wiadomości – W przypadku uwierzytelniania użytkownika:
  • chat.spaces.pins
  • chat.spaces
Wyświetlanie listy przypiętych wiadomości – W przypadku uwierzytelniania użytkownika:
  • chat.spaces.pins.readonly
  • chat.spaces.readonly
  • chat.spaces.pins
  • chat.spaces
Aktualizowanie kart w wiadomości – W przypadku uwierzytelniania aplikacji:
  • chat.bot
Reakcje  
Tworzenie reakcji – W przypadku uwierzytelniania użytkownika:
  • chat.messages.reactions.create
  • chat.messages.reactions
  • chat.messages
  • chat.import
Wyświetlanie listy reakcji – W przypadku uwierzytelniania użytkownika:
  • chat.messages.reactions.readonly
  • chat.messages.reactions
  • chat.messages.readonly
  • chat.messages
Usuwanie reakcji – W przypadku uwierzytelniania użytkownika:
  • chat.messages.reactions
  • chat.messages
  • chat.import
niestandardowe emotikony,  
Tworzenie niestandardowego emotikonu – W przypadku uwierzytelniania użytkownika:
  • chat.customemojis
Usuwanie niestandardowego emotikonu – W przypadku uwierzytelniania użytkownika:
  • chat.customemojis
Uzyskiwanie niestandardowego emotikonu – W przypadku uwierzytelniania użytkownika:
  • chat.customemojis
  • chat.customemojis.readonly
Wyświetlanie listy niestandardowych emotikonów – W przypadku uwierzytelniania użytkownika:
  • chat.customemojis
  • chat.customemojis.readonly
Multimedia i załączniki  
Przesyłanie multimediów jako załącznika do pliku – W przypadku uwierzytelniania użytkownika:
  • chat.messages.create
  • chat.messages
  • chat.import
Pobieranie multimediów W przypadku uwierzytelniania użytkownika:
  • chat.messages.readonly
  • chat.messages
Za pomocą uwierzytelniania aplikacji:
  • chat.bot
Pobieranie załącznika do wiadomości – W przypadku uwierzytelniania aplikacji:
  • chat.bot
Stany odczytu użytkownika
Pobieranie stanu przeczytania pokoju przez użytkownika – W przypadku uwierzytelniania użytkownika:
  • chat.users.readstate
  • chat.users.readstate.readonly
Aktualizowanie stanu przeczytania pokoju przez użytkownika – W przypadku uwierzytelniania użytkownika:
  • chat.users.readstate
Pobieranie stanu przeczytania wątku przez użytkownika – W przypadku uwierzytelniania użytkownika:
  • chat.users.readstate
  • chat.users.readstate.readonly
Aktualizowanie stanu przeczytania wątku użytkownika – W przypadku uwierzytelniania użytkownika:
  • chat.users.readstate
Ustawienia pokoju użytkownika
Pobieranie ustawień powiadomień o pokoju użytkownika – W przypadku uwierzytelniania użytkownika:
  • chat.users.spacesettings
Aktualizowanie ustawień powiadomień użytkownika dotyczących pokoju – W przypadku uwierzytelniania użytkownika:
  • chat.users.spacesettings
Zdarzenia w pokoju
Pobieranie zdarzeń w pokoju – W przypadku uwierzytelniania użytkownika musisz użyć zakresu opartego na typie zdarzenia:
  • W przypadku zdarzeń dotyczących wiadomości:
    • chat.messages
    • chat.messages.readonly
  • W przypadku zdarzeń dotyczących reakcji:
    • chat.messages.reactions
    • chat.messages.reactions.readonly
    • chat.messages
    • chat.messages.readonly
  • Wydarzenia dotyczące wspierania:
    • chat.memberships
    • chat.memberships.readonly
  • W przypadku zdarzeń dotyczących pokoju:
    • chat.spaces
    • chat.spaces.readonly
Wyświetlanie listy zdarzeń w pokoju – W przypadku uwierzytelniania użytkownika musisz użyć zakresu dla każdego typu zdarzenia uwzględnionego w żądaniu:
  • W przypadku zdarzeń dotyczących wiadomości:
    • chat.messages
    • chat.messages.readonly
  • W przypadku zdarzeń dotyczących reakcji:
    • chat.messages.reactions
    • chat.messages.reactions.readonly
    • chat.messages
    • chat.messages.readonly
  • Wydarzenia dotyczące wspierania:
    • chat.memberships
    • chat.memberships.readonly
  • W przypadku zdarzeń dotyczących pokoju:
    • chat.spaces
    • chat.spaces.readonly
Sekcje  
Tworzenie sekcji – W przypadku uwierzytelniania użytkownika:
  • chat.users.sections
Usuwanie sekcji – W przypadku uwierzytelniania użytkownika:
  • chat.users.sections
Sekcje listy – W przypadku uwierzytelniania użytkownika:
  • chat.users.sections
  • chat.users.sections.readonly
Aktualizowanie sekcji – W przypadku uwierzytelniania użytkownika:
  • chat.users.sections
Pozycjonowanie sekcji – W przypadku uwierzytelniania użytkownika:
  • chat.users.sections
Elementy sekcji  
Przenoszenie elementu sekcji – W przypadku uwierzytelniania użytkownika:
  • chat.users.sections
Wyświetlanie listy elementów sekcji – W przypadku uwierzytelniania użytkownika:
  • chat.users.sections
  • chat.users.sections.readonly

Zdarzenia interakcji z aplikacją do Google Chat

W tej 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:
Zdarzenia interakcji z aplikacją do Google Chat – –
Wywołania zwrotne Apps Script – –
Google Cloud Pub/Sub – –
Odpowiadanie na wiadomości:
synchronicznie, za pomocą zdarzenia interakcji z aplikacją do Google Chat; – –
synchronicznie, za pomocą wartości zwracanej przez wywołanie zwrotne Apps Script; – –
Wysyłanie nowych wiadomości:
Za pomocą przychodzących webhooków. – –