Publikowanie aplikacji Google Chat

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Po utworzeniu aplikacji do obsługi czatu możesz ją opublikować, aby była dostępna dla wybranych osób lub grup, wszystkich osób w organizacji lub użytkowników Google Chat.

Aby opublikować aplikację Google Chat i udostępnić ją innym osobom, musisz wykonać te czynności:

  1. Włączanie i konfigurowanie interfejsu Google Chat API Podczas konfigurowania interfejsu API możesz dodać maksymalnie 5 adresów e-mail, aby umożliwić dostęp do aplikacji Google Chat na potrzeby testów.
  2. Opublikuj aplikację za pomocą pakietu SDK Google Workspace Marketplace. Możesz skonfigurować aplikację Google Chat tak, aby była dostępna tylko dla użytkowników w Twojej organizacji Google Workspace lub dla wszystkich użytkowników Google Chat.
  3. Jeśli Twoja organizacja Google Workspace zarządza dostępem do aplikacji Google Chat, poproś administratora Google Workspace o dodanie aplikacji do listy dozwolonych organizacji.

Jak użytkownicy korzystają z aplikacji Google Chat i je instalują

Po opublikowaniu aplikacji do obsługi czatu użytkownicy Google Chat mogą rozpocząć czat z aplikacją lub dodać ją do pokoju, wybierając ją z listy proponowanych adresatów, jak pokazano poniżej.

Użytkownicy mogą również zawęzić proponowaną listę odbiorców, @wstawiając nazwę aplikacji. Jeśli na przykład opublikujesz aplikację o nazwie „Bot harmonogram” i użytkownik w Twojej organizacji wpisze „@sch”, Google Chat zaproponuje Twoją aplikację jako jedną z opcji autouzupełniania.

Administratorzy Google Workspace mogą też znaleźć aplikacje do obsługi czatu w Google Workspace Marketplace i zainstalować je dla użytkowników w swojej organizacji. Gdy administrator zainstaluje aplikację Google Chat, pojawi się ona w panelu czatów użytkowników.

Administratorzy Google Workspace mogą również zarządzać aplikacjami Google Chat i umieszczać je na liście dozwolonych w organizacji Google Workspace. Jeśli tworzysz aplikację do obsługi czatu w organizacji, która korzysta z list dozwolonych, musisz poprosić administratora o dodanie Twojej aplikacji do listy dozwolonych, aby użytkownicy mogli ją znaleźć i korzystać z niej. Więcej informacji znajdziesz w dokumentacji pomocy dla administratorów Google Workspace w artykule Zezwalanie użytkownikom na instalowanie aplikacji na czacie.

Włączanie i konfigurowanie interfejsu Google Chat API

skonfigurować projekt dla aplikacji w Google API Console i włączyć interfejs Google Chat API;

  1. Użyj przycisku poniżej, aby utworzyć nowy projekt (lub wybrać istniejący) i dodać do niego konto usługi. Przypisz kontu usługi rolę Właściciel projektu.
    Włącz API
  2. Zapisz pobrany klucz JSON. Twoja aplikacja może używać tego klucza do uwierzytelniania wiadomości wysyłanych asynchronicznie w pokojach.
  3. Otwórz projekt w API Console. Na liście interfejsów API kliknij Google Chat API.
  4. Wybierz kartę Konfiguracja i wpisz informacje dotyczące aplikacji zgodnie z opisem poniżej.

Gdy zapiszesz konfigurację aplikacji, stanie się ona dostępna dla określonych użytkowników w organizacji.

Konfiguracja aplikacji

Pole Opis
Nazwa aplikacji Nazwa, z której korzystają użytkownicy podczas korzystania z Twojej aplikacji.
URL awatara Adres URL HTTPS wskazujący kwadratowy obraz (np. PNG lub JPEG) o rozmiarze co najmniej 128 x 128 pikseli, który będzie widoczny jako awatar aplikacji.
Opis Opis funkcji aplikacji pod nazwą aplikacji.
Funkcje Zbiór pól określających, jakie zdarzenia mogą aktywować aplikację:
  • Otrzymywanie wiadomości 1:1: użytkownicy mogą znaleźć aplikację i wysłać do niej wiadomość bezpośrednio w Google Chat.
  • Odbieranie zdarzeń dotyczących instalacji przez administratora: gdy administrator Google Workspace zainstaluje lub odinstaluje aplikację w organizacji, z Google Chat będą otrzymywać zdarzenia ADDED_TO_SPACE lub REMOVED_FROM_SPACE. Domyślnie aplikacja nie otrzymuje tych zdarzeń, chyba że wyrazisz na nie zgodę, ponieważ może to skutkować wzrostem liczby zapytań na sekundę.
  • Dołączanie do pokoi i rozmów grupowych: aplikacja może dołączać do pokoi i rozmów grupowych, gdy zostaną do nich dodane.
Ustawienia połączenia Punkt końcowy aplikacji, czyli jeden z tych elementów:
  • URL aplikacji: punkt końcowy HTTPS, w którym hostowana jest aplikacja.
  • Projekt Apps Script: identyfikator wdrożenia projektu Apps Script, który implementuje aplikację.
  • Nazwa tematu Cloud Pub/Sub: temat Cloud Pub/Sub zasubskrybowany przez aplikację jako punkt końcowy.
  • Dialogflow: rejestruje aplikację przy użyciu integracji Dialogflow. Więcej informacji znajdziesz w dokumentacji Dialogflow dotyczącej integracji z Google Chat.
Polecenia rozpoczynające się ukośnikiem Polecenia, które mogą być wyświetlane użytkownikom w Google Chat. Pozwala użytkownikom wyświetlać w Google Chat podstawowe działania związane z Twoją aplikacją i wybierać konkretne działania, z którymi chcą współpracować.
Rozwijanie linków Wzorce adresów URL rozpoznawane i dostarczane przez aplikację, gdy użytkownicy wysyłają linki. Więcej informacji znajdziesz w artykule Linki w usłudze Unfurl.
Widoczność Określone przez dewelopera uprawnienia do wyświetlania i instalowania aplikacji. Możesz dodać maksymalnie 5 osób fizycznych, aby wyświetlać i instalować aplikację Google Chat. Aby aplikacja była widoczna i możliwa do zainstalowania dla więcej niż 5 użytkowników, musisz opublikować aplikację za pomocą pakietu SDK Google Workspace Marketplace.

Przyznaj uprawnienia do konfigurowania aplikacji

Dostęp do strony konfiguracji aplikacji możesz przyznać określonym użytkownikom. Aby to zrobić, użyj uprawnień Właściciel aplikacji Google Chat i Wyświetlający aplikacje do obsługi czatu. Użytkownicy z tymi rolami nie mogą przechodzić do strony konfiguracji aplikacji za pomocą panelu interfejsów API i usług, ale mogą uzyskać dostęp do strony konfiguracji w konsoli projektu w następujący sposób:

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

Publikowanie aplikacji przy użyciu pakietu SDK Google Workspace Marketplace

Za pomocą pakietu SDK Google Workspace Marketplace możesz:

  • Opublikuj aplikację publicznie i pozwól każdemu użytkownikowi Google Chat dodać ją do pokoju.
  • Opublikuj aplikację w organizacji.
  • Udostępnij aplikację administratorom Google Workspace, aby mogli ją zainstalować dla użytkowników w organizacji. Aby aplikacja była widoczna dla administratorów Google Workspace, musi zawierać funkcję czatu.

Zanim opublikujesz aplikację przy użyciu pakietu SDK Google Workspace Marketplace, wykonaj te czynności:

  1. Przetestuj aplikację Google Chat, instalując ją z Google Chat. Upewnij się, że aplikacja jest w pełni funkcjonalna i nie jest w toku.
  2. Sprawdź wymagania dotyczące publikacji i upewnij się, że Twoja aplikacja je wszystkie spełnia. Zobacz Obszary weryfikacji.
  3. Zapisz numer wersji aplikacji – jest on potrzebny do skonfigurowania pakietu SDK Google Workspace Marketplace.

Gdy aplikacja będzie gotowa do publikacji, przeczytaj artykuł Omówienie: publikowanie aplikacji.

Wyłącz aplikację

Po zapisaniu strony konfiguracji pojawi się pole Stan aplikacji. To pole pozwala określić, czy aplikacja ma być aktywna czy wyłączona.

Aby wyłączyć aplikację do obsługi czatu:

  1. Otwórz konsolę Google Cloud.
  2. W razie potrzeby wybierz projekt Google Cloud hostujący aplikację Google Chat:
    1. Obok opcji „Google Cloud” kliknij strzałkę w dół . Pojawi się okno z listą bieżących projektów.
    2. Wybierz projekt, który hostuje przeniesioną aplikację Google Chat.
    3. Kliknij Otwórz.
  3. Wyszukaj interfejs „Google Chat API” i kliknij Google Chat API.
  4. Kliknij Zarządzaj.
  5. Kliknij Konfiguracja.
  6. W sekcji „Stan aplikacji” wybierz Wyłączona.
  7. Kliknij Zapisz.