Łączenie aplikacji Google Chat z innymi usługami i narzędziami

Na tej stronie dowiesz się, jak połączyć aplikację Google Chat z usługą lub narzędzia spoza Google Chat. Aplikacje do obsługi czatu działają samodzielnie, często współdziałają z innymi systemami i wymagają aplikacje towarzyszące do łączenia kont, autoryzacja dostępu do danych, wyświetlanie wyświetlić dodatkowe dane lub skonfigurować preferencje użytkownika.

Wymagania wstępne

Aplikacja Google Chat, w której można korzystać z funkcji interaktywnych. Aby utworzyć interaktywna aplikacja do obsługi czatu, wykonaj jedno z tych krótkich wprowadzeń dotyczące architektury aplikacji, której chcesz używać:

Wysyłanie do użytkownika prośby o konfigurację aplikacji do obsługi czatu

Jeśli wykonanie żądania wymaga dodatkowej konfiguracji, której nie można bezpośrednio w aplikacji Google Chat, zwróć adres URL konfiguracji użytkownikowi w ramach zwykłej odpowiedzi lub prezentuj go prywatnie, w następującej formie:

{
  "actionResponse": {
    "type": "REQUEST_CONFIG",
    "url": "CONFIGURATION_URL"
  }
}

Dzięki temu Google Chat wyświetli użytkownikowi prywatny prompt, w którym CONFIGURATION_URL to link który użytkownik może odwiedzić w celu dodatkowego uwierzytelnienia, autoryzacji lub konfiguracji. Odpowiedź REQUEST_CONFIG wzajemnie się wyklucza z wartością standardową z odpowiedzią. Tekst, karty i inne atrybuty są ignorowane.

Wykonaj żądanie konfiguracji

Co MESSAGE zdarzenie interakcji które otrzymuje aplikacja Google Chat, zawiera też pole configCompleteRedirectUrl Musisz zakodować ten adres URL w Adres URL konfiguracji, który zostanie użyty po zakończeniu procesu. Przekierowanie Adres URL sygnalizuje Google Chat, że prośba o konfigurację została zrealizowana.

Po uruchomieniu aplikacji Google Chat przebieg procesu zależy od odebrano konkretną wiadomość. W odpowiedzi na wiadomość taką jak @app help Aplikacja do obsługi czatu powinna odpowiedzieć, wysyłając wiadomość bez wymagają dodatkowej konfiguracji.

Gdy użytkownik zostanie przekierowany do strony configCompleteRedirectUrl podane w oryginalnej wiadomości, Google Chat wykona te czynności:

  1. Usuń prompt wyświetlany użytkownikowi inicjującego.
  2. Konwertuj oryginalną wiadomość na publiczną, aby była widoczna dla innych członków w pomieszczeniu.
  3. Wyślij oryginalną wiadomość do tej samej aplikacji Google Chat po raz drugi.

Odwiedzenie strony configCompleteRedirectUrl ma wpływ tylko na 1 wiadomość użytkownika. Jeśli użytkownik kilka razy próbował wysłać wiadomość do aplikacji Google Chat W rezultacie otrzymywała wiele próśb, klikała i ukończenie procesu uwierzytelniania i konfiguracji ma wpływ tylko z daną wiadomością. Pozostałe komunikaty się nie zmienią.

Gdy zdarzenie interakcji MESSAGE jest ponownie wysyłane w ten sposób, powinno być identyczne do pierwotnego wydarzenia; są jednak sytuacje, w których MESSAGE mogą być różne. Jeśli na przykład wiadomość zawiera wzmiankę o obu aplikacje Google Chat A i B Chat, użytkownik może edytować wiadomość, jeśli aplikacja Google Chat A odpowiada zwykłą wiadomością przed uwierzytelnieniem przy użyciu Aplikacja B do czatu. W tym przypadku Aplikacja do obsługi czatu B otrzymuje edytowany tekst wiadomości po użytkownik przeprowadza uwierzytelnianie i konfigurację.

Uwierzytelnianie użytkownika Google Chat poza Google Chat

W niektórych przypadkach, np. w przypadku żądania autoryzacji OAuth dla interfejsu API, aplikacja musi odsyłać użytkowników do adresu URL poza Google Chat przy jednoczesnym zachowaniu tożsamości. W takich przypadkach najlepszym sposobem na zidentyfikowanie użytkownika jest zabezpieczenie aplikacji docelowej za pomocą logowania przez Google.

Użyj token tożsamości wysyłanych podczas logowania, aby uzyskać identyfikator użytkownika. Roszczenie sub zawiera dane użytkownika unikalny identyfikator i można go skorelować z identyfikatorem użytkownika z Google Chat.

Chociaż nie są one identyczne, mogą zostać zmienione. Do przekuj wartość roszczenia sub na users/{user} Google Chat, dodaj na początku wartość z users/. Na przykład wartość deklaracji 123 jest równoważna użytkownikowi users/123 w wiadomościach wysyłanych do aplikacja Google Chat.