Mendapatkan detail tentang acara ruang Google Chat

Panduan ini menjelaskan cara menggunakan Metode get aktif SpaceEvent referensi dari Google Chat API untuk mendapatkan detail tentang acara dari ruang Google Chat.

Resource SpaceEvent mewakili perubahan pada ruang atau turunannya resource, seperti pesan, reaksi, dan keanggotaan. Untuk mempelajari tentang jenis peristiwa yang didukung, lihat kolom eventType pada kolom SpaceEvent referensi dokumentasi referensi.

Anda dapat meminta acara hingga 28 hari sebelum waktu permintaan. Acara berisi versi terbaru dari sumber daya yang berubah. Misalnya, jika Anda meminta peristiwa tentang pesan baru, tetapi pesan tersebut kemudian diperbarui, server menampilkan resource Message yang diperbarui dalam payload peristiwa.

Untuk memanggil metode ini, Anda harus menggunakan user autentikasi. Untuk mendapatkan peristiwa, pengguna yang diautentikasi harus menjadi anggota ruang tempat peristiwa terjadi.

Prasyarat

Python

  • Python 3.6 atau yang lebih baru
  • Alat pengelolaan paket pip
  • Library klien Google terbaru. Untuk menginstal atau memperbaruinya, jalankan perintah berikut di antarmuka command line Anda: 
    pip3 install --upgrade google-api-python-client google-auth-oauthlib

Mendapatkan detail tentang acara ruang angkasa

Untuk mendapatkan detail tentang SpaceEvent di Google Chat, lakukan hal berikut:

Berikut cara mendapatkan SpaceEvent dengan autentikasi pengguna:

Python

  1. Di direktori kerja, buat file bernama chat_space_event_get.py.

  2. Sertakan kode berikut di chat_space_event_get.py:

    """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. Dalam kode, ganti kode berikut:

    • SCOPE: Cakupan otorisasi berdasarkan jenis peristiwa tersebut. Misalnya, jika Anda mendapatkan acara ruang angkasa tentang keanggotaan baru, gunakan cakupan chat.memberships.readonly, diformat sebagai https://www.googleapis.com/auth/chat.memberships.readonly. Anda bisa mendapatkan jenis peristiwa dari Metode spaces.spaceEvents.list. Untuk mempelajari cara menggunakan metode ini, lihat Mencantumkan peristiwa dari ruang.
    • SPACE: Nama ruang, yang dapat Anda peroleh dari metode spaces.list di Chat API, atau dari URL ruang.
    • SPACE_EVENT: Nama ruang yang dapat diperoleh dari Metode spaces.spaceEvents.list.

  4. Dalam direktori kerja, build dan jalankan contoh:

    python3 chat_space_event_get.py

Chat API menampilkan instance SpaceEvent dengan detail tentang peristiwa tersebut.