Konfigurowanie interfejsu Google Chat API

Każda aplikacja Google Chat, którą utworzysz, wymaga własnego projektu Google Cloud z włączonym i skonfigurowanym interfejsem Chat API. Z tej strony dowiesz się, jak skonfigurować interfejs Chat API.

Wymagania wstępne

Konfigurowanie interfejsu Chat API

  1. W konsoli Google Cloud wyszukaj „Google Chat API” i kliknij Google Chat API, a następnie Zarządzaj.

    Przejdź do interfejsu Chat API

  2. Kliknij kartę Konfiguracja i wpisz te wymagane informacje:

    • Nazwa aplikacji: nazwa, z której korzystają użytkownicy podczas interakcji z Twoją aplikacją Google Chat.
    • Adres URL awatara: adres URL HTTPS prowadzący do kwadratowego obrazu graficznego (np. w formacie PNG lub JPEG o wymiarach co najmniej 128 x 128 pikseli), który jest wyświetlany jako awatar w aplikacji Google Chat.
    • Opis: opis przeznaczenia aplikacji Google Chat widoczny pod jej nazwą.

  3. Aby włączyć funkcje interaktywne, kliknij przełącznik Włącz funkcje interaktywne, które umożliwiają użytkownikom interakcję z Twoją aplikacją Google Chat, i użyj tej tabeli do zakończenia konfiguracji:

    Pole Opis
    Funkcjonalność Zbiór pól, które określają, jak aplikacja do obsługi czatu może wchodzić w interakcje z użytkownikami:
    • Odbieranie wiadomości 1:1: użytkownicy mogą znaleźć aplikację Google Chat i wysłać do niej wiadomość bezpośrednio w Google Chat.
    • Dołączanie do pokoi i rozmów grupowych: użytkownicy mogą dodawać aplikację Google Chat do pokoi i rozmów grupowych.
    Ustawienia połączenia Punkt końcowy aplikacji Google Chat, który jest jednym z tych:
    • App URL: punkt końcowy HTTPS, który hostuje implementację aplikacji Google Chat.
    • Projekt Apps Script: identyfikator wdrożenia projektu Apps Script, w którym zaimplementowano aplikację Google Chat.
    • Nazwa tematu Cloud Pub/Sub: temat Pub/Sub subskrybowany przez aplikację Google Chat jako punkt końcowy.
    • Dialogflow: rejestruje aplikację Google Chat przy użyciu integracji Dialogflow. Więcej informacji znajdziesz w artykule Tworzenie aplikacji Dialogflow do Google Chat rozumiejącej język naturalny.
    Polecenia rozpoczynające się ukośnikiem Polecenia, które mogą wyświetlać się użytkownikom w Google Chat. Umożliwia użytkownikom wyświetlanie głównych działań w aplikacji Google Chat w Google Chat i wybieranie określonych działań. Więcej informacji znajdziesz w artykule Odpowiadanie na polecenia po ukośniku jako aplikacja do obsługi czatu.
    Podgląd linków Wzorce adresów URL rozpoznawane przez aplikację Google Chat i udostępniające dodatkowe treści, gdy użytkownicy wysyłają linki. Więcej informacji znajdziesz w sekcji Podgląd linków.
    Widoczność Maksymalnie 5 osób lub co najmniej 1 grupa dyskusyjna Google, która może wyświetlać i zainstalować Twoją aplikację Google Chat. Użyj tego pola, aby przetestować aplikację Google Chat lub udostępnić ją swojemu zespołowi. Więcej informacji znajdziesz w artykule Ustawienia widoczności i publikowania aplikacji Google Chat.

  4. Aby rejestrować błędy w Cloud Logging za każdym razem, gdy aplikacja Google Chat zwraca błąd, zaznacz pole wyboru Rejestruj błędy w usłudze Logging. Więcej informacji znajdziesz w artykule na temat wysyłania logów błędów dotyczących aplikacji Google Chat.

  5. Kliknij Zapisz. Gdy zapiszesz konfigurację aplikacji Google Chat, będzie ona dostępna dla określonych użytkowników w Twojej organizacji Google Workspace.

Przyznawanie innym osobom uprawnień do konfigurowania aplikacji Google Chat

Możesz przyznać dostęp określonym użytkownikom do strony konfiguracji aplikacji Google Chat. Użyj ról uprawnień Właściciel aplikacji do obsługi czatu i Wyświetlający aplikacje do obsługi czatu. Użytkownicy o tych rolach nie mogą otwierać strony konfiguracji aplikacji Google Chat przy użyciu panelu Interfejsy API i usługi, ale mogą uzyskać dostęp do strony konfiguracji po przejściu do konsoli Google Cloud głównego projektu Cloud aplikacji Google Chat w ten sposób:

https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=PROJECT_ID

Gdzie PROJECT_ID to identyfikator projektu Google Cloud hostującego aplikację Google Chat.