Konfigurowanie interfejsu Google Chat API

Każda aplikacja Google Chat, którą utworzysz, musi mieć własną Projekt Google Cloud z włączonym i skonfigurowanym interfejsem Chat API. Ta strona pokazuje, jak skonfigurować interfejs Chat API.

Wymagania wstępne

Wybierz wyświetlaną nazwę, awatara i opis aplikacji Google Chat

Aby wywoływać interfejs Chat API, musisz skonfigurować aplikacji Google Chat z tymi informacjami:

Pole Opis Format
Nazwa aplikacji Wyświetlana nazwa aplikacji Google Chat. Maksymalnie 25 znaków alfanumerycznych
URL awatara Obraz wyświetlany jako obraz aplikacji Google Chat awatarem. Adres URL HTTPS wskazujący kwadratowy obraz grafiki (PNG lub JPEG). Zalecany rozmiar to 256 x 256 pikseli lub więcej.
Opis Krótki opis, że cel aplikacja Google Chat. Do 40 znaków alfanumerycznych

Nazwa, awatar i opis aplikacji Google Chat to wyświetlane użytkownikom w interfejsie Google Chat. W przypadku niektórych interfejsów Chat API żądań zapisu, Google Chat używa tych informacji do przypisywania czynności wykonywane przez aplikację do obsługi czatu w Google Chat.

Jeśli na przykład wywołasz metodę spaces.create(), Google Chat zawiera nazwę aplikacji Google Chat w sekcji opis osoby, która utworzyła pokój, np. na tej ilustracji:

Aplikacja Google Chat tworzy pokój dla użytkownika.
Rysunek 1. Przekaz podany przez Google Chat wyświetla się, gdy metoda spaces.create() jest używana do utworzenia w imieniu użytkownika.

Aby wejść w interakcję z aplikacjami do obsługi czatu, użytkownicy mogą też zobaczyć lub użyć tej funkcji 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 do obsługi czatu.
  • Na pasku tworzenia wiadomości użytkownicy mogą przeglądać aplikacje Google Chat oraz nazwę, awatara i opis użytkownika.

Konfigurowanie aplikacji Google Chat w konsoli Google Cloud

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

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

    Otwórz stronę konfiguracji interfejsu Chat API

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

  3. W sekcji Funkcje interaktywne kliknij przełącznik Włącz funkcje interaktywne. do pozycji wyłączonej, aby wyłączyć funkcje interaktywne dla aplikacja Google Chat. Możesz to skonfigurować później. Aby dowiedzieć się więcej o: konfigurowania i tworzenia funkcji interaktywnych, zobacz Otrzymywanie interakcji użytkowników i reagowanie na nie

  4. Opcjonalnie: w sekcji Logi zaznacz pole wyboru Rejestruj błędy w usłudze Logging, aby korzystać z Google Cloud Logging. Więcej informacji: Dzienniki błędów zapytań dotyczących aplikacji Google Chat

  5. Kliknij Zapisz.

Przyznawanie innym osobom uprawnień do konfigurowania aplikacji Google Chat

Dostępne opcje przyznawać dostęp określonym użytkownikom na stronie konfiguracji aplikacji Google Chat. Użyj Uprawnienia właściciela aplikacji do obsługi czatu i wyświetlającego aplikacje do obsługi czatu role. Użytkownicy o tych rolach nie mogą przechodzić do aplikacji Google Chat za pomocą interfejsu API usług, ale możesz otwórz stronę konfiguracji w konsoli Google Cloud Główny projekt Cloud aplikacji do obsługi czatu:

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

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