Z tego przewodnika dowiesz się, jak używać metody create
w zasobie Space
interfejsu Google Chat API do utworzenia nazwanego pokoju.
Space
zasób
to miejsce, w którym użytkownicy i aplikacje do obsługi czatu mogą wysyłać wiadomości,
udostępniać pliki i współpracować. Jest kilka rodzajów pokoi:
- Czaty to rozmowy między 2 użytkownikami lub użytkownikiem aplikacji do obsługi 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ę.
Nazwany pokój to miejsce, w którym użytkownicy mogą wysyłać wiadomości, udostępniać pliki i
współpracować. Pokoje nazwane mogą obejmować aplikacje do obsługi czatu. Pokoje nazwane
Zawierają dodatkowe funkcje, takie jak czaty grupowe i czaty bez nazwy
których nie ma, np. menedżerowie pokoju, którzy mogą stosować ustawienia administracyjne,
opisów, a także dodawać i usuwać osoby lub aplikacje. Po utworzeniu pokoju nazwanego
jedynym użytkownikiem pokoju jest uwierzytelniony użytkownik. Pokój nie
zawierać innych osób lub aplikacji; nawet aplikacji Google Chat
który go tworzy. Aby dodać osoby, utwórz członkostwo w pokoju, wywołując
Metoda create
w
Member
zasób.
Aby dowiedzieć się, jak to zrobić, zobacz Tworzenie subskrypcji.
Aby utworzyć nazwany pokój z wieloma osobami – czat grupowy bez nazwy co najmniej trzy osoby, rozmowa na czacie między dwiema osobami albo i aplikacja Google Chat wywołująca Interfejs Chat API – konfigurowanie pokoju .
Wymagania wstępne
Python
- 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 Python Biblioteka klienta interfejsów API Google.
-
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.
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 Node.js Biblioteka klienta interfejsów API Google.
-
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.
Tworzenie nazwanego pokoju
Aby utworzyć pokój nazwany, przekaż w żądaniu te informacje:
- Określ zakres autoryzacji
chat.spaces.create
lubchat.spaces
. - Wywołaj funkcję
Metoda
create
wSpace
zasób. - Ustaw
spaceType
doSPACE
. - Ustaw
displayName
z nazwą pokoju widoczną dla użytkowników. W tym przykładziedisplayName
jest ustawiona naAPI-made
. - Opcjonalnie ustaw inne atrybuty pokoju, takie jak
spaceDetails
(opis pokoju widoczny dla użytkowników i zestaw wytycznych dotyczących pokoju).
Aby utworzyć nazwany pokój:
Python
- W katalogu roboczym utwórz plik o nazwie
chat_space_create_named.py
. Umieść w pliku
chat_space_create_named.py
ten kod:from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient.discovery import build # Define your app's authorization scopes. # When modifying these scopes, delete the file token.json, if it exists. SCOPES = ["https://www.googleapis.com/auth/chat.spaces.create"] def main(): ''' Authenticates with Chat API via user credentials, then creates a Chat space. ''' # Authenticate with Google Workspace # and get user authorization. flow = InstalledAppFlow.from_client_secrets_file( 'client_secrets.json', SCOPES) creds = flow.run_local_server() # Build a service endpoint for Chat API. chat = build('chat', 'v1', credentials=creds) # Use the service endpoint to call Chat API. result = chat.spaces().create( # Details about the space to create. body = { # To create a named space, set spaceType to SPACE. 'spaceType': 'SPACE', # The user-visible name of the space. 'displayName': 'API-made' } ).execute() # Prints details about the created space. print(result) if __name__ == '__main__': main()
W katalogu roboczym skompiluj i uruchom przykład:
python3 chat_space_create_named.py
Node.js
- W katalogu roboczym utwórz plik o nazwie
create-space.js
. Umieść w pliku
create-space.js
ten kod:const chat = require('@googleapis/chat'); const {authenticate} = require('@google-cloud/local-auth'); /** * Creates a new chat space. * @return {!Promise<!Object>} */ async function createSpace() { const scopes = [ 'https://www.googleapis.com/auth/chat.spaces.create', ]; const authClient = await authenticate({scopes, keyfilePath: 'client_secrets.json'}); const chatClient = await chat.chat({version: 'v1', auth: authClient}); return await chatClient.spaces.create( {requestBody: {spaceType: 'SPACE', displayName: 'API-made'}}); } createSpace().then(console.log);
W katalogu roboczym uruchom przykładowy kod:
node create-space.js
Zostanie utworzony nazwany pokój. Aby przejść do pokoju, użyj jego identyfikatora zasobu
aby utworzyć adres URL pokoju. Identyfikator zasobu znajdziesz w pokoju
name
w treści odpowiedzi Google Chat. Jeśli na przykład w pokoju
name
to spaces/1234567
. Możesz przejść do pokoju, korzystając z tych opcji
Adres URL: https://mail.google.com/chat/u/0/#chat/space/1234567
.
Powiązane artykuły
- Dodaj osoby i aplikacje do pokoju przez tworzenie użytkowników.
- Opublikuj wiadomość w pokoju przez tworzenie wiadomości.
- Wyświetlanie informacji o pokoju
- Pokoje listy.
- Aktualizowanie pokoju.
- Usuwanie pokoju
- Skonfiguruj pokój.
- Znajdź pokój czatu.
- Ustawianie pokoju jako wykrywalnego dla określonych użytkowników