Z tego przewodnika dowiesz się, jak użyć metody setUp()
w zasobach Space
interfejsu Google Chat API, aby skonfigurować pokój Google Chat. Skonfigurowanie pokoju powoduje utworzenie pokoju i dodanie do niego określonych użytkowników.
Space
Zasób to miejsce, w którym użytkownicy i aplikacje czatu mogą wysyłać wiadomości, udostępniać pliki i współpracować. Jest kilka rodzajów pokoi:
- Czaty to rozmowy między dwoma użytkownikami lub użytkownikiem a aplikacją czatu.
- Czaty grupowe to rozmowy między co najmniej 3 użytkownikami komunikatory;
- Pokoje nazwane to trwałe miejsca, w których użytkownicy wysyłają wiadomości, udostępniają pliki i współpracę.
Podczas konfigurowania pokoju weź pod uwagę te kwestie:
- Dzwoniący (uwierzytelniony) użytkownik jest automatycznie dodawany do pokoju, więc nie musisz określać jego członkostwa w żądaniu.
- Jeśli podczas tworzenia czatu istnieje 2 użytkowników, po wysłaniu wiadomości pojawi się czat. W przeciwnym razie zostanie utworzony czat.
- podczas tworzenia czatu grupowego, jeśli nie wybrano żadnego członkostwa wymienionego w prośbie. zostaną dodani do czatu grupowego (np. problem z uprawnieniami), a potem może zostać utworzony pusty czat grupowy (z którym tylko użytkownik dzwoni).
- Nie możesz konfigurować pokoi z odpowiedziami w wątku ani dodawać osób spoza Google Workspace.
- Zduplikowane subskrypcje (w tym użytkownik dzwoniący) podane w prośbie. są odfiltrowywane, a nie powodują błędu żądania.
Wymagania wstępne
Node.js
- Firmy lub przedsiębiorstwa Konto Google Workspace z dostępem do Google Chat.
- Skonfiguruj środowisko:
- Utwórz projekt Google Cloud.
- Skonfiguruj ekran zgody OAuth
- Włącz i skonfiguruj interfejs Google Chat API pod nazwą. ikonę i opis aplikacji Google Chat.
- Zainstaluj bibliotekę klienta Cloud dla Node.js.
-
Utwórz dane uwierzytelniające OAuth dla identyfikatora klienta w przypadku aplikacji komputerowej. Aby uruchomić przykładowy skrypt w tym przewodniku, zapisz dane logowania jako plik JSON o nazwie
client_secrets.json
w katalogu lokalnym.
- Wybierz zakres autoryzacji, który obsługuje uwierzytelnianie użytkowników.
Python
- Konto Google Workspace w wersji Business lub Enterprise z dostępem do Google Chat.
- Skonfiguruj środowisko:
- Utwórz projekt Google Cloud.
- Skonfiguruj ekran zgody OAuth
- Włącz i skonfiguruj interfejs Google Chat API, podając nazwę, ikonę i opis aplikacji Google Chat.
- Zainstaluj bibliotekę klienta Cloud w Pythonie.
-
Utwórz dane uwierzytelniające OAuth dla identyfikatora klienta w przypadku aplikacji komputerowej. Aby uruchomić przykładowy skrypt w tym przewodniku, zapisz dane logowania jako plik JSON o nazwie
client_secrets.json
w katalogu lokalnym.
- Wybierz zakres autoryzacji, który obsługuje uwierzytelnianie użytkowników.
Java
- Konto Google Workspace w wersji Business lub Enterprise z dostępem do Google Chat.
- Skonfiguruj środowisko:
- Utwórz projekt Google Cloud.
- Skonfiguruj ekran zgody OAuth
- Włącz i skonfiguruj interfejs Google Chat API, podając nazwę, ikonę i opis aplikacji Google Chat.
- Zainstaluj Java Biblioteka klienta Cloud.
-
Utwórz dane logowania na podstawie identyfikatora klienta OAuth dla aplikacji komputerowej. Aby uruchomić próbkę w tym
Przewodnika, zapisz dane logowania w pliku JSON o nazwie
client_secrets.json
katalog lokalny.
- Wybierz zakres autoryzacji, który obsługuje uwierzytelnianie użytkowników.
Google Apps Script
- Konto Google Workspace w wersji Business lub Enterprise z dostępem do Google Chat.
- Skonfiguruj środowisko:
- Utwórz projekt Google Cloud.
- Skonfiguruj ekran zgody OAuth.
- Włącz i skonfiguruj interfejs Google Chat API, podając nazwę, ikonę i opis aplikacji Google Chat.
- Utwórz samodzielny projekt Apps Script i włącz zaawansowaną usługę Google Chat.
- Wybierz zakres autoryzacji, który obsługuje uwierzytelnianie użytkowników.
Konfigurowanie pokoju
Aby skonfigurować pokój, w swojej prośbie podaj te informacje:
- Określ zakres autoryzacji
chat.spaces.create
lubchat.spaces
. - Wywołaj funkcję
SetUpSpace()
. - Przekaż
space
jako instancjęSpace
z wszystkimi niezbędnymi polami, np.displayName
lubspaceType
. - Przekaż parametr
memberships
jako tablicę instancjiMembership
. W przypadku każdego wystąpienia:- Określ
users/{user}
, aby dodać użytkownika jako użytkownika pokoju, gdzie{user}
to{person_id}
dlaperson
z interfejsu People API lub identyfikatoruser
w interfejsie Directory API. Jeśli na przykład osoba korzystająca z interfejsu People APIresourceName
topeople/123456789
. Możesz dodać użytkownika do pokoju, wykonując: w tym członkostwo zusers/123456789
jakomember.name
. - Określ
groups/{group}
, aby dodać grupę jako użytkownika pokoju.{group}
to identyfikator grupy, dla której chcesz utworzyć członkostwo. Identyfikator grupy można pobrać za pomocą Cloud Identity API Na przykład, jeśli plik Cloud Identity API zwraca grupę o nazwiegroups/123456789
, a następnie ustawionomembership.groupMember.name
dogroups/123456789
. Grupy dyskusyjne Google nie mogą została dodana do czatu grupowego lub czatu, ale tylko do nazwanego pokoju.
- Określ
Aby utworzyć czat między użytkownikiem łączącym się a innym użytkownikiem, podaj na liście użytkowników, których dotyczy prośba.
Aby utworzyć czat między użytkownikiem dzwoniącym a aplikacją do rozmów, ustaw
space.singleUserBotDm
do true
i nie określaj żadnych członkostwa. Dostępne opcje
tej metody należy użyć tylko do skonfigurowania czatu z aplikacją do rozmów. Aby dodać połączenie
jako członka pokoju lub istniejącego czatu między 2 użytkownikami, patrz
utworzyć subskrypcję.
W poniższym przykładzie tworzymy pokój nazwany i jedną subskrypcję dla 2 użytkowników (uwierzytelnionego użytkownika i jednego innego użytkownika).
Node.js
Python
Java
Google Apps Script
Aby uruchomić przykład, zastąp:
DISPLAY_NAME
: wyświetlana nazwa nowego pokoju.USER_NAME
: identyfikator innego użytkownika, do którego chcesz dodać parametr dla domeny.
Aby otworzyć pokój, utwórz jego adres URL na podstawie identyfikatora jego zasobu.
Identyfikator zasobu możesz znaleźć w name
w treści odpowiedzi w Google Chat. Jeśli na przykład name
w Twoim pokoju to spaces/1234567
, możesz
do pokoju pod tym adresem URL:
https://mail.google.com/chat/u/0/#chat/space/1234567
Powiązane artykuły
- Utwórz pokój.
- Wyświetlanie informacji o pokoju
- Pokoje listy.
- Zaktualizuj pokój.
- Usuwanie pokoju.
- Znajdź pokój czatu.
- Ustawianie pokoju jako możliwego do znalezienia dla określonych użytkowników.