Konfigurowanie interfejsu Google Chat API

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

Wymagania wstępne

Wybieranie nazwy wyświetlanej, awatara i opisu aplikacji Google Chat

Gdy włączysz Chat API, skonfigurujesz szczegóły aplikacji Google Chat, które będą widoczne dla użytkowników w Google Chat, w tym nazwę wyświetlaną, awatar i opis. Te szczegóły są widoczne tylko w Google Chat. Aby opublikować aplikację Google Chat w Marketplace, musisz też podać szczegóły, które będą widoczne w jej ofercie w Marketplace.

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

Pole Opis Format
Nazwa aplikacji Nazwa wyświetlana aplikacji Google Chat. Do 25 znaków alfanumerycznych
URL awatara Obraz wyświetlany jako awatar aplikacji Google Chat avatar. Adres URL HTTPS prowadzący do kwadratowego obrazu graficznego (PNG lub JPEG). Zalecany rozmiar to co najmniej 256 × 256 pikseli.
Opis Krótki opis celu aplikacji Google Chat. Do 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 w Chat API Google Chat używa tych informacji do przypisywania działań wykonywanych przez aplikację Google Chat w Google Chat.

Jeśli na przykład wywołasz metodę spaces.create(), Google Chat uwzględni nazwę aplikacji Google 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. Komunikat o przypisaniu, który Google Chat wyświetla, gdy metoda spaces.create() służy do tworzenia pokoju w imieniu użytkownika.

Aby wchodzić w interakcje z aplikacjami Google Chat, użytkownicy mogą też wyświetlać te informacje i korzystać z nich w następujący sposób:

  • Wywoływanie aplikacji Google Chat przez @wzmiankę jej nazwy.
  • Znajdowanie i rozpoczynanie czatu 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 Google Chat oraz wyświetlać ich nazwę, awatar i opis.

Konfigurowanie aplikacji Google Chat w konsoli Google Cloud

Gdy masz już szczegóły aplikacji Google Chat, otwórz projekt w chmurze i skonfiguruj Chat API:

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

    Otwórz stronę konfiguracji 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 aplikacji Google Chat. Możesz to skonfigurować później. Więcej informacji o konfigurowaniu i tworzeniu funkcji interaktywnych znajdziesz w artykule Odbieranie i odpowiadanie na interakcje użytkowników.

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

  5. Kliknij Zapisz.

Przyznawanie innym osobom uprawnień do konfigurowania Chat API

Możesz przyznać określonym użytkownikom dostęp do strony konfiguracji aplikacji Google Chat, przypisując im rolę Właściciel aplikacji Google Chat lub Przeglądający aplikacje Google Chat Google Cloud Identity Access Management (IAM). Użytkownicy z tymi rolami nie mogą przejść do strony konfiguracji aplikacji Google Chat za pomocą panelu Interfejsy API i usługi , ale mogą uzyskać dostęp do strony konfiguracji, otwierając konsolę Google Cloud w projekcie w chmurze, w którym hostowana jest aplikacja 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, w którym hostowana jest aplikacja Google Chat.