อัปเดตสถานะการอ่านพื้นที่ทำงานของผู้ใช้

Python

• Python 3.6 ขึ้นไป
• เครื่องมือการจัดการแพ็กเกจ pip

• ไลบรารีของไคลเอ็นต์ Google ล่าสุดสำหรับ Python หากต้องการติดตั้งหรืออัปเดต ให้เรียกใช้คำสั่งต่อไปนี้ในอินเทอร์เฟซบรรทัดคำสั่ง

  pip3 install --upgrade google-api-python-client google-auth-oauthlib
  

• โปรเจ็กต์ Google Cloud ที่เปิดใช้และกำหนดค่า Google Chat API โปรดดูขั้นตอนที่หัวข้อสร้างแอป Google Chat

• การกําหนดค่าการให้สิทธิ์สําหรับแอป Chat การดูรายละเอียดเกี่ยวกับสถานะการอ่านของผู้ใช้ภายในพื้นที่ทำงานต้องใช้การตรวจสอบสิทธิ์ผู้ใช้ที่มีขอบเขตการให้สิทธิ์ chat.users.readstate

Node.js

• Node.js และ npm

• ไลบรารีของไคลเอ็นต์ Google ล่าสุดสำหรับ Node.js หากต้องการติดตั้ง ให้เรียกใช้คำสั่งต่อไปนี้ในอินเทอร์เฟซบรรทัดคำสั่ง

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

• โปรเจ็กต์ Google Cloud ที่เปิดใช้และกำหนดค่า Google Chat API โปรดดูขั้นตอนที่หัวข้อสร้างแอป Google Chat

• การกําหนดค่าการให้สิทธิ์สําหรับแอป Chat การดูรายละเอียดเกี่ยวกับสถานะการอ่านของผู้ใช้ภายในพื้นที่ทำงานต้องใช้การตรวจสอบสิทธิ์ผู้ใช้ที่มีขอบเขตการให้สิทธิ์ chat.users.readstate

Apps Script

• บัญชี Google Workspace ที่มีสิทธิ์เข้าถึง Google Chat
• แอป Chat ที่เผยแพร่แล้ว หากต้องการสร้าง แอป Chat ให้ทำตาม quickstartนี้
• การกําหนดค่าการให้สิทธิ์สําหรับแอป Chat การดูรายละเอียดเกี่ยวกับสถานะการอ่านของผู้ใช้ภายในพื้นที่ทำงานต้องใช้การตรวจสอบสิทธิ์ผู้ใช้ที่มีขอบเขตการให้สิทธิ์ chat.users.readstate

Python

1. สร้างไฟล์ชื่อ chat_spaceReadState_update.py ในไดเรกทอรีการทำงาน

2. ใส่รหัสต่อไปนี้ใน chat_spaceReadState_update.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"]
   
   def main():
       '''
       Authenticates with Chat API via user credentials,
       then updates the space 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().updateSpaceReadState(
   
           # The space read state to update.
           #
           # 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/spaceReadState',
           updateMask='lastReadTime',
           body={'lastReadTime': f'{datetime.datetime(2000, 1, 3).isoformat()}Z'}
   
         ).execute()
   
       # Prints the API's response.
       print(result)
   
   if __name__ == '__main__':
       main()
   

3. ในโค้ด ให้แทนที่ส่วนต่อไปนี้

   • SPACE: ชื่อพื้นที่ทำงาน ซึ่งคุณดูได้จากเมธอด spaces.list ใน Chat API หรือจาก URL ของพื้นที่ทำงาน

4. สร้างและเรียกใช้ตัวอย่างในไดเรกทอรีการทำงาน

   python3 chat_spaceReadState_update.py
   

Node.js

1. สร้างไฟล์ชื่อ chat_spaceReadState_update.js ในไดเรกทอรีการทำงาน

2. ใส่รหัสต่อไปนี้ใน chat_spaceReadState_update:

   const chat = require('@googleapis/chat');
   const {authenticate} = require('@google-cloud/local-auth');
   
   /**
   * Authenticates with Chat API via user credentials,
   * then updates the space read state for the calling user.
   * @return {!Promise<!Object>}
   */
   async function updateSpaceReadState() {
   
     /**
     * Authenticate with Google Workspace
     * and get user authorization.
     */
     const scopes = [
       'https://www.googleapis.com/auth/chat.users.readstate',
     ];
   
     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.updateSpaceReadState({
   
       /**
       * The space read state to update.
       *
       * 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/spaceReadState',
       updateMask: 'lastReadTime',
       requestBody: {
         lastReadTime: '{datetime.datetime(2000, 1, 3).isoformat()}Z'
       }
     });
   }
   
   /**
   * Use the service endpoint to call Chat API.
   */
   getSpaceReadState().then(console.log);
   

3. ในโค้ด ให้แทนที่ส่วนต่อไปนี้

   • SPACE: ชื่อพื้นที่ทำงาน ซึ่งคุณดูได้จากเมธอด spaces.list ใน Chat API หรือจาก URL ของพื้นที่ทำงาน

4. สร้างและเรียกใช้ตัวอย่างในไดเรกทอรีการทำงาน

   node chat_spaceReadState_update.js
   

Apps Script

ตัวอย่างนี้จะเรียก Chat API โดยใช้บริการ Chat ขั้นสูง

1. เพิ่มขอบเขตการให้สิทธิ์ chat.users.readstate ลงในไฟล์ appsscript.json ของโปรเจ็กต์ Apps Script ดังนี้

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

2. เพิ่มฟังก์ชันที่คล้ายกับฟังก์ชันนี้ในโค้ดของโปรเจ็กต์ Apps Script:

   /**
   * Authenticates with Chat API via user credentials,
   * then updates the space read state for the calling user.
   * @param {string} spaceReadStateName The resource name of the space read state.
   */
   function updateSpaceReadState(spaceReadStateName) {
     try {
       const time = new Date('January 1, 2000')).toJSON();
       const body = {'lastReadTime': time};
       Chat.Users.Spaces.updateSpaceReadState(spaceReadStateName, body);
     } catch (err) {
       // TODO (developer) - Handle exception
       console.log('Failed to update read state with error %s', err.message);
     }
   }