Konfigurowanie interfejsu Google Chat API

Każda tworzona przez Ciebie aplikacja Google Chat wymaga własnego projektu Google Cloud z włączonym i skonfigurowanym interfejsem API Google Chat. Na tej stronie dowiesz się, jak skonfigurować interfejs Chat API.

Wymagania wstępne

Wybieranie nazwy, awatara i opisu aplikacji Google Chat

Aby wywołać interfejs Chat API, musisz skonfigurować aplikację Google Chat, podając te informacje:

Pole Opis Format
Nazwa aplikacji Wyświetlana nazwa aplikacji Google Chat. Maks. 25 znaków alfanumerycznych
URL awatara Obraz, który wyświetla się jako awatar w aplikacji Google Chat. Adres URL HTTPS wskazujący na kwadratowy obraz graficzny (PNG lub JPEG). Zalecany rozmiar to co najmniej 256 × 256 pikseli.
Opis Krótki opis celu aplikacji Google Chat. Maks. 40 znaków alfanumerycznych

Nazwa, awatar i opis aplikacji Google Chat są wyświetlane użytkownikom w interfejsie Google Chat. W przypadku niektórych żądań zapisu interfejsu Chat API Chat używa tych informacji do przypisywania działań, które aplikacja Chat wykonuje w Chat.

Jeśli na przykład wywołasz metodę spaces.create(), Google Chat podaje nazwę aplikacji Google Chat w opisie osoby, która utworzyła pokój, jak pokazano na poniższym obrazku:

Aplikacja Google Chat tworzy pokój dla użytkownika.
Rysunek 1. Komunikat informujący o pochodzeniu, który wyświetla się w Google Chat, gdy do utworzenia pokoju w imieniu użytkownika użyto metody spaces.create().

Aby korzystać z aplikacji na czacie, użytkownicy mogą też wyświetlać te informacje lub używać ich w następujący sposób:

  • Wywołaj aplikację Google Chat, podając jej nazwę.
  • Znajdź i rozpocznij czat w aplikacji Google Chat. W menu Aplikacje na czacie wyświetla się nazwa i awatar aplikacji Google Chat.
  • Na pasku tworzenia użytkownicy mogą przeglądać aplikacje Google Chat oraz wyświetlać swoje imię i nazwisko, awatar i opis.

Konfigurowanie aplikacji Google Chat w konsoli Google Cloud

Gdy masz już informacje o aplikacji Google Chat, otwórz projekt Cloud i skonfiguruj interfejs Chat API:

  1. W konsoli Google Cloud otwórz stronę interfejsu API czatu i kliknij Konfiguracja:

    Otwórz stronę konfiguracji interfejsu Chat API

  2. W sekcji Informacje o aplikacji wypełnij pola Nazwa aplikacji, URL awatara i Opis.

  3. W sekcji Funkcje interaktywne kliknij przełącznik Włącz funkcje interaktywne, aby wyłączyć funkcje interaktywne w aplikacji Google Chat. Możesz to skonfigurować później. Więcej informacji o konfigurowaniu i tworzeniu funkcji interaktywnych znajdziesz w artykule Otrzymywanie interakcji z użytkownikiem i reagowanie na nie.

  4. Opcjonalnie: w sekcji Logi zaznacz pole wyboru Logowanie błędów w Logowaniu, aby używać Google Cloud Logging. Więcej informacji znajdziesz w artykule na temat wysyłania logów błędów dotyczących aplikacji Google Chat.

  5. Kliknij Zapisz.

Przyznawanie innym osobom uprawnień do konfigurowania interfejsu Chat API

Możesz przypisać określonym użytkownikom dostęp do strony konfiguracji aplikacji do obsługi czatu, przyznając im rolę Google Cloud Identity Management (IAM) Właściciel aplikacji do obsługi czatu lub Wyświetlający aplikacje do obsługi czatu. Użytkownicy z tymi rolami nie mogą przejść na stronę konfiguracji aplikacji Google Chat za pomocą panelu Interfejsy API i usługi, ale mogą otworzyć stronę konfiguracji, przechodząc do konsoli Google Cloud projektu hosta aplikacji Google Chat w następujący 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, który hostuje aplikację Google Chat.