Membuat daftar pesan

Panduan ini menjelaskan cara menggunakan metode list pada resource Message di Google Chat API untuk melihat daftar pesan yang memiliki penomoran halaman dan dapat difilter dalam ruang.

Resource Message merepresentasikan 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-httplib2 google-auth-oauthlib oauth2client
    
  • Aplikasi Chat yang dipublikasikan. Untuk membuat dan memublikasikan aplikasi Chat, lihat Mem-build aplikasi Google Chat.

  • Otorisasi dikonfigurasi untuk aplikasi Chat. Untuk menampilkan pesan, diperlukan Autentikasi pengguna dengan cakupan otorisasi chat.messages.readonly atau chat.messages.

Membuat daftar pesan

Untuk menampilkan daftar pesan dengan autentikasi pengguna, teruskan hal berikut dalam permintaan Anda:

Contoh berikut mencantumkan pesan di ruang Chat yang dikirim setelah 16 Maret 2023:

Python

  1. Di direktori kerja, buat file bernama chat_messages_list.py.
  2. Sertakan kode berikut di chat_messages_list.py:

    import os.path
    
    from google.auth.transport.requests import Request
    from google.oauth2.credentials import Credentials
    from google_auth_oauthlib.flow import InstalledAppFlow
    from googleapiclient.discovery import build
    from googleapiclient.errors import HttpError
    
    # 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 details about the created membership.
        print(result)
    
    if __name__ == '__main__':
        main()
    
  3. Dalam kode, ganti SPACE dengan nama ruang, yang dapat Anda peroleh dari metode spaces.list di Chat API, atau dari URL ruang.

  4. Di direktori kerja Anda, build dan jalankan contoh:

    python3 chat_messages_list.py
    

Google Chat API menampilkan daftar pesan yang dikirim di ruang yang ditentukan setelah 16 Maret 2023.