Konfigurowanie interfejsu Google Chat API

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

Wymagania wstępne

Wybieranie nazwy wyświetlanej, awatara i opisu aplikacji Chat

Gdy włączysz interfejs Chat API, skonfigurujesz szczegóły aplikacji do obsługi czatu, które będą widoczne dla użytkowników czatu, w tym nazwę wyświetlaną, awatar i opis. Te informacje pojawiają się tylko w Google Chat. Aby opublikować aplikację Google Chat w Marketplace, musisz też podać szczegóły, które będą wyświetlane w informacjach o aplikacji w Marketplace.

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. Do 25 znaków alfanumerycznych
URL awatara Obraz, który wyświetla się jako awatar aplikacji Chat. Adres URL HTTPS prowadzący do kwadratowego obrazu (PNG lub JPEG). Zalecany rozmiar to co najmniej 256 x 256 pikseli.
Opis Krótki opis przeznaczenia aplikacji Chat. Maksymalnie 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 do interfejsu Chat API usługa Chat używa tych informacji do przypisywania działań, które aplikacja Google Chat wykonuje w Google Chat.

Jeśli na przykład wywołasz metodę spaces.create(), Chat uwzględni nazwę aplikacji Chat w opisie osoby, która utworzyła pokój, jak pokazano na tym obrazie:

Aplikacja Google Chat tworzy pokój dla użytkownika.
Rysunek 1. Wiadomość o atrybucji, która jest wyświetlana w Google Chat, gdy do utworzenia pokoju w imieniu użytkownika używana jest metoda spaces.create().

Aby korzystać z aplikacji do obsługi czatu, użytkownicy mogą też wyświetlać lub wykorzystywać te informacje w następujący sposób:

  • Wywołaj aplikację Google Chat, wywołując ją za pomocą znaku @.
  • Znajdź i rozpocznij czat z aplikacją Google Chat. W menu Aplikacje czaty wyświetlają nazwę i awatar aplikacji Google Chat.
  • Na pasku tworzenia wiadomości użytkownicy mogą przeglądać aplikacje do Google Chat i wyświetlać ich nazwy, awatary i opisy.

Konfigurowanie aplikacji do obsługi czatu w konsoli Google Cloud

Gdy będziesz mieć szczegóły aplikacji Google Chat, otwórz projekt Cloud i skonfiguruj interfejs Chat API:

  1. W konsoli Google Cloud otwórz stronę Chat API i kliknij stronę 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 Chat. Możesz to skonfigurować później. Więcej informacji o konfigurowaniu i tworzeniu funkcji interaktywnych znajdziesz w artykule Otrzymywanie odpowiedzi na interakcje użytkowników i odpowiadanie na nie.

  4. Opcjonalnie: w sekcji Logi zaznacz pole wyboru Loguj błędy w Cloud Logging, aby korzystać z Google Cloud Logging. Więcej informacji znajdziesz w artykule Dzienniki błędów zapytań w aplikacjach Google Chat.

  5. Kliknij Zapisz.

Przyznawanie innym osobom uprawnień do konfigurowania interfejsu Chat API

Możesz przyznać określonym użytkownikom dostęp do strony konfiguracji aplikacji do obsługi czatu, przypisując im rolę właściciela aplikacji do obsługi czatu lub rolę wyświetlającego aplikacje do obsługi czatu w Google Cloud Identity Access Management (IAM). Użytkownicy z tymi rolami nie mogą przejść na stronę konfiguracji aplikacji do obsługi czatu za pomocą panelu Interfejsy API i usługi, ale mogą uzyskać dostęp do strony konfiguracji, przechodząc do konsoli Google Cloud dla projektu hosta aplikacji do obsługi czatu 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, w którym jest hostowana aplikacja do obsługi czatu.