Uzyskiwanie szczegółów o wydarzeniu w pokoju Google Chat

Z tego przewodnika dowiesz się, jak korzystać z Metoda get włączona SpaceEvent Interfejs Google Chat API do pobierania szczegółów wydarzenia z pokoju Google Chat.

Zasób SpaceEvent reprezentuje zmianę pokoju lub jego elementu podrzędnego zasobów takich jak wiadomości, reakcje i członkostwa. Aby się uczyć o obsługiwanych typach zdarzeń, zapoznaj się z polem eventType SpaceEvent zasób dokumentacji referencyjnej.

Możesz poprosić o wydarzenie do 28 dni przed datą wysłania prośby. Wydarzenie zawiera najnowszą wersję zmienionego zasobu. Na przykład, jeśli żądania zdarzenia dotyczącego nowej wiadomości, ale wiadomość została później zaktualizowana, serwer zwraca zaktualizowany zasób Message w ładunku zdarzenia.

Aby wywołać tę metodę, musisz użyć polecenia user Aby uzyskać , uwierzytelniony użytkownik musi być członkiem pokoju, w którym .

Wymagania wstępne

Python

  • Python w wersji 3.6 lub nowszej
  • narzędzie do zarządzania pakietami pip;
  • Najnowsze biblioteki klienta Google. Aby je zainstalować lub zaktualizować: uruchom następujące polecenie w interfejsie wiersza poleceń: 
    pip3 install --upgrade google-api-python-client google-auth-oauthlib

Sprawdzanie informacji o wydarzeniu dotyczącym pokoju

Aby uzyskać szczegółowe informacje o SpaceEvent w Google Chat:

  • Wywołaj metodę get w SpaceEvent .
  • Pokaż name z SpaceEvent, aby otrzymać. Uzyskaj nazwę dla: SpaceEvent z SpaceEvent zasób z Google Chat.
  • Z: user uwierzytelnianie, określ zakres autoryzacji, który obsługuje typ zdarzenia w żądaniu. Jako zgodnie ze sprawdzoną metodą wybierz najbardziej restrykcyjny zakres, który umożliwi aplikacji do działania.

Oto jak kupić SpaceEvent w uwierzytelnianie użytkownika:

Python

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

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

    """Gets a SpaceEvent resource from the Chat API."""

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 = ['SCOPE']

# 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()
    .spaceEvents()
    .get(
        # The space event 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.
        #
        # Replace SPACE_EVENT with a SpaceEvent name.
        # Obtain the spaceEvent name from the SpaceEvent resource of
        # Chat API.
        name='spaces/SPACE/spaceEvents/SPACE_EVENT'
    )
    .execute()
)

# Prints details about the created spaceEvent.
print(result)

  3. Zastąp w kodzie następujące elementy:

    • SCOPE: zakres autoryzacji na podstawie typ zdarzenia. Jeśli na przykład bierzesz udział w wydarzeniu kosmicznym, dotyczące nowej subskrypcji, użyj zakresu chat.memberships.readonly, w formacie https://www.googleapis.com/auth/chat.memberships.readonly. Rodzaj zdarzenia znajdziesz w Metoda spaces.spaceEvents.list. Aby dowiedzieć się, jak używać tej metody, zapoznaj się z artykułem Wyświetlanie listy zdarzeń z pokoju
    • SPACE: nazwa pokoju, którą możesz uzyskać z usługi metoda spaces.list w interfejsie Chat API lub z adresu URL pokoju.
    • SPACE_EVENT: nazwa pokoju Wydarzenie, które znajdziesz na stronie Metoda spaces.spaceEvents.list.

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

    python3 chat_space_event_get.py

Interfejs Chat API zwraca instancję SpaceEvent ze szczegółowymi informacjami na jego temat.