คำแนะนำนี้จะอธิบายวิธีใช้เมธอด get
ในSpaceEvent
ทรัพยากรของ Google Chat API เพื่อดูรายละเอียดเกี่ยวกับกิจกรรมจากพื้นที่ใน Google Chat
ทรัพยากร SpaceEvent
แสดงถึงการเปลี่ยนแปลงของพื้นที่ทำงานหรือทรัพยากรย่อย เช่น ข้อความ รีแอ็กชัน และการเป็นสมาชิก ดูข้อมูลเกี่ยวกับประเภทเหตุการณ์ที่รองรับได้ที่ช่อง eventType
ในเอกสารอ้างอิงสำหรับแหล่งข้อมูล SpaceEvent
คุณขอกิจกรรมได้สูงสุด 28 วันก่อนเวลาที่ขอ เหตุการณ์นี้มีทรัพยากรเวอร์ชันล่าสุดที่มีการเปลี่ยนแปลง เช่น หากคุณขอเหตุการณ์เกี่ยวกับข้อความใหม่ แต่ข้อความได้รับการอัปเดตในภายหลัง เซิร์ฟเวอร์จะส่งกลับทรัพยากร Message
ที่อัปเดตแล้วในเพย์โหลดของเหตุการณ์
หากต้องการเรียกใช้วิธีการนี้ คุณต้องใช้การตรวจสอบสิทธิ์ผู้ใช้ หากต้องการรับเหตุการณ์ ผู้ใช้ที่ตรวจสอบสิทธิ์แล้วต้องเป็นสมาชิกของพื้นที่ทำงานที่เกิดเหตุการณ์ขึ้น
ข้อกำหนดเบื้องต้น
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 แล้ว การรับ กิจกรรมพื้นที่ทำงานจะต้องมีการตรวจสอบสิทธิ์ผู้ใช้ โดยมีขอบเขตที่รองรับประเภทเหตุการณ์ หากต้องการเลือกขอบเขต โปรดดูภาพรวมการตรวจสอบสิทธิ์และการให้สิทธิ์
ดูรายละเอียดเกี่ยวกับกิจกรรมในพื้นที่ทำงาน
หากต้องการดูรายละเอียดเกี่ยวกับ SpaceEvent
ใน Google Chat ให้ทำดังนี้
- เรียกเมธอด
get
ในทรัพยากรSpaceEvent
- ผ่าน
name
ของSpaceEvent
เพื่อรับ รับชื่อSpaceEvent
จากทรัพยากรSpaceEvent
ของ Google Chat - เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ระบุขอบเขตการให้สิทธิ์ที่รองรับประเภทเหตุการณ์ในคำขอ แนวทางปฏิบัติแนะนำคือขอบเขตที่จำกัดที่สุดซึ่งยังทำให้แอปทำงานได้อยู่
วิธีรับ SpaceEvent
ที่มีการตรวจสอบสิทธิ์ผู้ใช้มีดังนี้
Python
- สร้างไฟล์ชื่อ
chat_space_event_get.py
ในไดเรกทอรีการทำงาน ใส่รหัสต่อไปนี้ใน
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)
ในโค้ด ให้แทนที่ส่วนต่อไปนี้
SCOPE
: ขอบเขตการให้สิทธิ์โดยอิงตามประเภทเหตุการณ์ ตัวอย่างเช่น หากคุณได้รับกิจกรรมพื้นที่ทำงานเกี่ยวกับการเป็นสมาชิกใหม่ ให้ใช้ขอบเขตchat.memberships.readonly
ที่มีการจัดรูปแบบเป็นhttps://www.googleapis.com/auth/chat.memberships.readonly
คุณดูประเภทเหตุการณ์ได้จากเมธอดspaces.spaceEvents.list
หากต้องการดูวิธีใช้วิธีนี้ โปรดดูแสดงรายการเหตุการณ์จากพื้นที่ทำงานSPACE
: ชื่อพื้นที่ทำงาน ซึ่งคุณจะดูได้จากเมธอดspaces.list
ใน Chat API หรือจาก URL ของพื้นที่ทำงานSPACE_EVENT
: ชื่อของเหตุการณ์พื้นที่ทำงาน ซึ่งดูได้จากเมธอดspaces.spaceEvents.list
สร้างและเรียกใช้ตัวอย่างในไดเรกทอรีการทำงาน
python3 chat_space_event_get.py
Chat API จะส่งคืนอินสแตนซ์ของ SpaceEvent
พร้อมรายละเอียดเกี่ยวกับเหตุการณ์