Wyświetlanie informacji o pokoju

Z tego przewodnika dowiesz się, jak używać metody get w przypadku zasobu Space interfejsu Google Chat API do wyświetlania szczegółowych informacji o pokoju, takich jak wyświetlana nazwa, opis i wytycznych.

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ę.

Uwierzytelnianie za pomocą uwierzytelnianie aplikacji umożliwia aplikacji Google Chat dostęp do pokoi, do aplikacji Google Chat, do której ma dostęp w Google Chat (np. pokoi, do których należy ta aplikacja). Uwierzytelnianie za pomocą uwierzytelnianie użytkownika, umożliwia uzyskanie dostępu do pokoi, do których ma dostęp uwierzytelniony użytkownik.

Wymagania wstępne

Python

Node.js

Zamów pokój

Aby uzyskać pokój w Google Chat, przekaż w swoim żądanie:

Uzyskiwanie szczegółów pokoju dzięki uwierzytelnianiu użytkowników

Aby uzyskać szczegółowe informacje o pokoju za pomocą: uwierzytelnianie użytkownika:

Python

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

  2. Umieść w pliku chat_space_get_user.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.readonly"]

def main():
    '''
    Authenticates with Chat API via user credentials,
    then gets details about a specified 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().get(

          # The space to get.
          #
          # Replace SPACE with a space name.
          # Obtain the space name from the spaces resource of Chat API,
          # or from a space's URL.
          name='spaces/SPACE'

      ).execute()

    # Prints details about the space.
    print(result)

if __name__ == '__main__':
    main()

  3. W kodzie zastąp SPACE nazwą pokoju, która który znajdziesz w Metoda spaces.list w interfejsie Chat API lub z adresu URL pokoju.

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

    python3 chat_space_get_user.py

Node.js

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

  2. Umieść w pliku get-space.js ten kod:

    const chat = require('@googleapis/chat');
const {authenticate} = require('@google-cloud/local-auth');

/**
* Gets details about a Chat space by name.
* @return {!Object}
*/
async function getSpace() {
  const scopes = [
    'https://www.googleapis.com/auth/chat.spaces.readonly',
  ];

  const authClient =
      await authenticate({scopes, keyfilePath: 'client_secrets.json'});

  const chatClient = await chat.chat({version: 'v1', auth: authClient});

  return await chatClient.spaces.get({name: 'spaces/SPACE'});
}

getSpace().then(console.log);

  3. W kodzie zastąp SPACE nazwą pokoju, która który znajdziesz w Metoda spaces.list w interfejsie Chat API lub z adresu URL pokoju.

  4. W katalogu roboczym uruchom przykładowy kod:

    node get-space.js

Interfejs Chat API zwraca instancję Space ze szczegółowymi informacjami o wybranym pokoju.

Dowiedz się więcej o pokoju dzięki uwierzytelnianiu aplikacji

Aby uzyskać szczegółowe informacje o pokoju za pomocą: uwierzytelnianie aplikacji:

Python

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

  2. Umieść w pliku chat_space_get_app.py ten kod:

    from google.oauth2 import service_account
from apiclient.discovery import build

# Specify required scopes.
SCOPES = ['https://www.googleapis.com/auth/chat.bot']

# Specify service account details.
CREDENTIALS = (
    service_account.Credentials.from_service_account_file('credentials.json')
    .with_scopes(SCOPES)
)

# Build the URI and authenticate with the service account.
chat = build('chat', 'v1', credentials=CREDENTIALS)

# Use the service endpoint to call Chat API.
result = chat.spaces().get(

    # The space to get.
    #
    # Replace SPACE with a space name.
    # Obtain the space name from the spaces resource of Chat API,
    # or from a space's URL.
    name='spaces/SPACE'

).execute()

print(result)

  3. W kodzie zastąp SPACE nazwą pokoju, która który znajdziesz w metoda spaces.list() w z interfejsu Chat API lub z adresu URL pokoju.

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

    python3 chat_space_get_app.py

Node.js

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

  2. Umieść w pliku app-get-space.js ten kod:

    const chat = require('@googleapis/chat');

/**
* Gets details about a Chat space by name.
* @return {!Promise<!Object>}
*/
async function getSpace() {
  const scopes = [
    'https://www.googleapis.com/auth/chat.bot',
  ];

  const auth = new chat.auth.GoogleAuth({
    scopes,
    keyFilename: 'credentials.json',
  });

  const authClient = await auth.getClient();
  const chatClient = await chat.chat({version: 'v1', auth: authClient});

  return await chatClient.spaces.get({name: 'spaces/SPACE'});
}

getSpace().then(console.log);

  3. W kodzie zastąp SPACE nazwą pokoju, która który znajdziesz w Metoda spaces.list w interfejsie Chat API lub z adresu URL pokoju.

  4. W katalogu roboczym uruchom przykładowy kod:

    node app-get-space.js

Interfejs Chat API zwraca instancję Space z informacjami o danej przestrzeni.