Utwórz pokój

Z tego przewodnika dowiesz się, jak użyć metody create w zasobie Space interfejsu Google Chat API do utworzenia pokoju nazwanego.

Zasób Space wskazuje 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 typów pokoi:

  • Czaty to rozmowy między 2 użytkownikami lub użytkownikiem i aplikacją Google Chat.
  • Czaty grupowe to rozmowy między co najmniej 3 użytkownikami i aplikacjami Google Chat.
  • Pokoje nazwane to trwałe miejsca, w których użytkownicy wysyłają wiadomości, udostępniają pliki i współpracują.

Pokój nazwany to miejsce, w którym użytkownicy mogą wysyłać wiadomości, udostępniać pliki i współpracować. Pokoje z nazwą mogą zawierać aplikacje Google Chat. Pokoje z nazwą obejmują dodatkowe funkcje, których nie mają w rozmowach grupowych ani czatach bez nazwy. Mogą to być na przykład menedżerowie pokoi, którzy mogą stosować ustawienia administracyjne i opisy oraz dodawać i usuwać osoby i aplikacje. Po utworzeniu pokoju nazwanego jego jedynym użytkownikiem jest uwierzytelniony użytkownik. W pokoju nie ma innych osób ani aplikacji, ani nawet aplikacja Google Chat, która go utworzyła. Aby dodać osoby, utwórz członkostwo w pokoju, wywołując metodę create w zasobie Member. Aby dowiedzieć się, jak to zrobić, przeczytaj artykuł Tworzenie subskrypcji.

Aby utworzyć pokój nazwany z wieloma osobami – czat grupowy bez nazwy z co najmniej 3 osobami, czat między 2 osobami lub osoba i aplikacja do obsługi czatu wywołująca interfejs Chat API – skonfiguruj pokój.

Wymagania wstępne

Python

  • Python 3.6 lub nowszy
  • Narzędzie do zarządzania pakietami pip

  • Najnowsze biblioteki klienta Google dla języka Python. Aby je zainstalować lub zaktualizować, uruchom w interfejsie wiersza poleceń to polecenie:

    pip3 install --upgrade google-api-python-client google-auth-oauthlib
  • Projekt Google Cloud z włączonym i skonfigurowanym interfejsem Google Chat API. Instrukcje znajdziesz w artykule Tworzenie aplikacji Google Chat.

  • Autoryzacja dla aplikacji Google Chat została skonfigurowana. Utworzenie pokoju wymaga uwierzytelniania użytkownika z zakresem autoryzacji chat.spaces.create lub chat.spaces.

Node.js

  • Node.js i npm

  • Najnowsze biblioteki klienta Google dla środowiska Node.js. Aby je zainstalować, uruchom w interfejsie wiersza poleceń to polecenie:

    npm install @google-cloud/local-auth @googleapis/chat
  • Projekt Google Cloud z włączonym i skonfigurowanym interfejsem Google Chat API. Instrukcje znajdziesz w artykule Tworzenie aplikacji Google Chat.

  • Autoryzacja dla aplikacji Google Chat została skonfigurowana. Utworzenie pokoju wymaga uwierzytelniania użytkownika z zakresem autoryzacji chat.spaces.create lub chat.spaces.

Tworzenie pokoju nazwanego

Aby utworzyć pokój nazwany, przekaż w swojej prośbie te dane:

  • Określ zakres autoryzacji chat.spaces.create lub chat.spaces.
  • Wywołaj metodę create w zasobie Space.
  • Ustaw spaceType na SPACE.
  • Ustaw displayName na nazwę pokoju widoczną dla użytkownika. W tym przykładzie displayName ma wartość API-made.
  • Opcjonalnie ustaw inne atrybuty pokoju, takie jak spaceDetails (opis widoczny dla użytkowników oraz zestaw wytycznych dotyczących pokoju).

Aby utworzyć pokój nazwany:

Python

  1. W katalogu roboczym utwórz plik o nazwie chat_space_create_named.py.

  2. Umieść ten kod w elemencie chat_space_create_named.py:

    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 membership.
    print(result)

if __name__ == '__main__':
    main()

  3. W katalogu roboczym skompiluj i uruchom przykład:

    python3 chat_space_create_named.py

Node.js

  1. W katalogu roboczym utwórz plik o nazwie create-space.js.

  2. Umieść ten kod w elemencie create-space.js:

    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);

  3. W katalogu roboczym uruchom przykład:

    node create-space.js

Zostanie utworzony pokój nazwany. Aby przejść do pokoju, utwórz jego adres URL za pomocą jego identyfikatora zasobu. Identyfikator zasobu z pokoju name znajdziesz w treści odpowiedzi Google Chat. Jeśli na przykład name Twojego pokoju to spaces/1234567, możesz do niego przejść, korzystając z tego adresu URL: https://mail.google.com/chat/u/0/#chat/space/1234567.