Mendapatkan detail tentang status pembacaan rangkaian pesan pengguna

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. Mendapatkan detail tentang status baca pengguna dalam ruang memerlukan autentikasi pengguna dengan cakupan otorisasi chat.users.readstate atau chat.users.readstate.readonly.

Node.js

• Node.js & npm

• Library klien Google terbaru untuk Node.js. Untuk menginstalnya, jalankan perintah berikut di antarmuka command line Anda:

  npm install @google-cloud/local-auth @googleapis/chat
  

• 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. Mendapatkan detail tentang status baca pengguna dalam ruang memerlukan autentikasi pengguna dengan cakupan otorisasi chat.users.readstate atau chat.users.readstate.readonly.

Apps Script

• Akun Google Workspace dengan akses ke Google Chat.
• Aplikasi Chat yang dipublikasikan. Untuk mem-build aplikasi Chat, ikuti quickstart ini.
• Otorisasi dikonfigurasi untuk aplikasi Chat. Mendapatkan detail tentang status baca pengguna dalam ruang memerlukan autentikasi pengguna dengan cakupan otorisasi chat.users.readstate atau chat.users.readstate.readonly.

Python

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

2. Sertakan kode berikut di chat_threadReadState_get.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.users.readstate.readonly"]
   
   def main():
       '''
       Authenticates with Chat API via user credentials,
       then gets the thread read state for the calling user.
       '''
   
       # 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.users().spaces().threads().getThreadReadState(
   
           # The thread read state to get.
           #
           # Replace USER with the calling user's ID, Workspace email,
           # or the alias me.
           #
           # Replace SPACE with a space name.
           # Obtain the space name from the spaces resource of Chat API,
           # or from a space's URL.
           #
           # Replace THREAD with a thread name.
           # Obtain the thread name from the messages resource of Chat API.
           name='users/me/spaces/SPACE/threads/THREAD/threadReadState'
   
         ).execute()
   
       # Prints the API's response.
       print(result)
   
   if __name__ == '__main__':
       main()
   

3. Dalam kode, ganti kode berikut:

   • SPACE: nama ruang, yang dapat Anda peroleh dari metode spaces.list di Chat API, atau dari URL ruang.

   • THREAD: nama thread, yang dapat Anda peroleh dari metode spaces.messages.get di Chat API.

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

   python3 chat_threadReadState_get.py
   

Node.js

1. Di direktori kerja, buat file bernama chat_threadReadState_get.js.

2. Sertakan kode berikut di chat_threadReadState_get:

   const chat = require('@googleapis/chat');
   const {authenticate} = require('@google-cloud/local-auth');
   
   /**
   * Authenticates with Chat API via user credentials,
   * then gets the thread read state for the calling user.
   * @return {!Promise<!Object>}
   */
   async function getThreadReadState() {
   
     /**
     * Authenticate with Google Workspace
     * and get user authorization.
     */
     const scopes = [
       'https://www.googleapis.com/auth/chat.users.readstate.readonly',
     ];
   
     const authClient =
         await authenticate({scopes, keyfilePath: 'client_secrets.json'});
   
     /**
     * Build a service endpoint for Chat API.
     */
     const chatClient = await chat.chat({version: 'v1', auth: authClient});
   
     /**
     * Use the service endpoint to call Chat API.
     */
     return await chatClient.users.spaces.threads.getThreadReadState({
   
       /**
       * The thread read state to get.
       *
       * Replace USER with the calling user's ID, Workspace email,
       * or the alias me.
       *
       * Replace SPACE with a space name.
       * Obtain the space name from the spaces resource of Chat API,
       * or from a space's URL.
       */
       name: 'users/me/spaces/SPACE/threads/THREADS/threadReadState'
     });
   }
   
   /**
   * Use the service endpoint to call Chat API.
   */
   getThreadReadState().then(console.log);
   

3. Dalam kode, ganti kode berikut:

   • SPACE: nama ruang, yang dapat Anda peroleh dari metode spaces.list di Chat API, atau dari URL ruang.

   • THREAD: nama thread, yang dapat Anda peroleh dari metode spaces.messages.get di Chat API.

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

   node chat_threadReadState_get.js
   

Apps Script

Contoh ini memanggil Chat API menggunakan Advanced Chat Service.

1. Tambahkan cakupan otorisasi chat.users.readstate.readonly ke file appsscript.json project Apps Script:

   "oauthScopes": [
     "https://www.googleapis.com/auth/chat.users.readstate.readonly"
   ]
   

2. Tambahkan fungsi seperti ini ke kode project Apps Script:

   /**
   * Authenticates with Chat API via user credentials,
   * then gets the thread read state for the calling user.
   * @param {string} threadReadStateName The resource name of the thread read state.
   */
   function getThreadReadState(threadReadStateName) {
     try {
       Chat.Users.Spaces.Threads.getThreadReadState(threadReadStateName);
     } catch (err) {
       // TODO (developer) - Handle exception
       console.log('Failed to get read state with error %s', err.message);
     }
   }