Panduan ini menjelaskan cara menggunakan metode list
pada resource Message
Google Chat API untuk melihat daftar pesan yang telah dipaginasi dan dapat difilter dalam ruang.
Resource Message
mewakili pesan
teks
atau
kartu
di Google Chat. Anda dapat
create
, get
, update
, atau delete
pesan di Google Chat API dengan memanggil
metode yang sesuai. Untuk mempelajari pesan teks dan kartu lebih lanjut, lihat Ringkasan pesan Google Chat.
Prasyarat
Python
- Python 3.6 atau yang lebih baru
- Alat pengelolaan paket pip
Library klien Google terbaru untuk Python. Untuk menginstal atau mengupdatenya, jalankan perintah berikut di antarmuka command line Anda:
pip3 install --upgrade google-api-python-client google-auth-oauthlib
- Project Google Cloud dengan Google Chat API yang diaktifkan dan dikonfigurasi. Untuk mengetahui langkah-langkahnya, lihat Mem-build aplikasi Google Chat.
Otorisasi dikonfigurasi untuk aplikasi Chat. Listingan pesan memerlukan Autentikasi pengguna dengan cakupan otorisasi
chat.messages.readonly
atauchat.messages
.
Membuat daftar pesan
Untuk menampilkan daftar pesan dengan autentikasi pengguna, teruskan kode berikut dalam permintaan Anda:
- Tentukan cakupan otorisasi
chat.messages.readonly
atauchat.messages
. - Panggil
metode
list
di resourceMessage
.
Contoh berikut mencantumkan pesan dalam ruang Chat yang dikirim setelah 16 Maret 2023:
Python
- Di direktori kerja Anda, buat file bernama
chat_messages_list.py
. Sertakan kode berikut di
chat_messages_list.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.messages.readonly"] def main(): ''' Authenticates with Chat API via user credentials, then lists messages in a space sent after March 16, 2023. ''' # 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().messages().list( # The space for which to list messages. parent = 'spaces/SPACE', # An optional filter that returns messages # created after March 16, 2023. filter = 'createTime > "2023-03-16T00:00:00-00:00"' ).execute() # Prints the list of messages. print(result) if __name__ == '__main__': main()
Dalam kode, ganti
SPACE
dengan nama ruang, yang dapat Anda peroleh dari metodespaces.list
di Chat API, atau dari URL ruang.Di direktori kerja Anda, buat dan jalankan contoh:
python3 chat_messages_list.py
Google Chat API menampilkan daftar pesan yang dikirim di ruang yang ditentukan setelah 16 Maret 2023.
Topik terkait
- Memformat pesan.
- Menghapus pesan.
- Mendapatkan detail tentang pesan.
- Memperbarui pesan.
- Mengirim pesan.