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
- Business atau Enterprise Akun Google Workspace yang memiliki akses ke Google Chat.
- Menyiapkan lingkungan Anda:
- Buat project Google Cloud.
- Konfigurasi layar izin OAuth.
- Aktifkan dan konfigurasikan Google Chat API dengan nama, ikon, dan deskripsi untuk aplikasi Chat Anda.
-
Membuat kredensial client ID OAuth untuk aplikasi desktop. Untuk menjalankan
sampel dalam
panduan, simpan kredensial sebagai file JSON bernama
client_secrets.json
ke direktori lokal.
- Pilih cakupan otorisasi yang mendukung autentikasi pengguna.
Mendapatkan detail tentang acara ruang angkasa
Untuk mendapatkan detail tentang SpaceEvent
di Google Chat, lakukan hal berikut:
- Panggil metode
get
padaSpaceEvent
Google Workspace for Education. - Teruskan
name
dariSpaceEvent
untuk mendapatkannya. Mendapatkan namaSpaceEvent
dariSpaceEvent
resource dari Google Chat. - Dengan pengguna autentikasi, tentukan cakupan otorisasi yang mendukung jenis peristiwa dalam permintaan Anda. Sebagai seorang sebagai praktik terbaik, pilih cakupan yang paling ketat yang masih mengizinkan aplikasi berfungsi.
Berikut cara mendapatkan SpaceEvent
dengan
autentikasi pengguna:
Python
- Di direktori kerja, buat file bernama
chat_space_event_get.py
. 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)
Dalam kode, ganti kode berikut:
SCOPE
: Cakupan otorisasi berdasarkan jenis peristiwa tersebut. Misalnya, jika Anda mendapatkan acara ruang angkasa tentang keanggotaan baru, gunakan cakupanchat.memberships.readonly
, diformat sebagaihttps://www.googleapis.com/auth/chat.memberships.readonly
. Anda bisa mendapatkan jenis peristiwa dari Metodespaces.spaceEvents.list
. Untuk mempelajari cara menggunakan metode ini, lihat Mencantumkan peristiwa dari ruang.SPACE
: Nama ruang, yang dapat Anda peroleh dari metodespaces.list
di Chat API, atau dari URL ruang.SPACE_EVENT
: Nama ruang yang dapat diperoleh dari Metodespaces.spaceEvents.list
.
Dalam direktori kerja, build dan jalankan contoh:
python3 chat_space_event_get.py
Chat API menampilkan instance
SpaceEvent
dengan detail
tentang peristiwa tersebut.