คู่มือนี้จะอธิบายถึงวิธีใช้
เมธอด get
เปิดอยู่
SpaceEvent
แหล่งข้อมูลของ
Google Chat API เพื่อดูรายละเอียดเกี่ยวกับกิจกรรมจากพื้นที่ใน Google Chat
ทรัพยากร SpaceEvent
แสดงถึงการเปลี่ยนแปลงในพื้นที่ทำงานหรือย่อยของพื้นที่ทำงาน
เช่น ข้อความ รีแอ็กชัน และการเป็นสมาชิก เพื่อเรียนรู้
เกี่ยวกับประเภทเหตุการณ์ที่รองรับ โปรดดูช่อง eventType
ของ
แหล่งข้อมูล SpaceEvent
รายการ
เอกสารอ้างอิง
คุณขอกิจกรรมได้สูงสุด 28 วันก่อนเวลาที่ขอ กิจกรรม
มีทรัพยากรเวอร์ชันล่าสุดที่มีการเปลี่ยนแปลง ตัวอย่างเช่น หาก
คุณขอกิจกรรมเกี่ยวกับข้อความใหม่ แต่ข้อความได้รับการอัปเดตในภายหลัง
เซิร์ฟเวอร์ส่งทรัพยากร Message
ที่อัปเดตแล้วในเพย์โหลดของเหตุการณ์
หากต้องการเรียกวิธีนี้ คุณต้องใช้ user การตรวจสอบสิทธิ์ หากต้องการ ผู้ใช้ที่ตรวจสอบสิทธิ์แล้วจะต้องเป็นสมาชิกของพื้นที่ทํางานที่เกิดเหตุการณ์ เกิดขึ้น
ข้อกำหนดเบื้องต้น
Python
- ธุรกิจหรือองค์กร บัญชี Google Workspace ที่มีสิทธิ์เข้าถึง Google Chat
- ตั้งค่าสภาพแวดล้อมโดยทำดังนี้
- สร้างโปรเจ็กต์ Google Cloud
- กำหนดค่าหน้าจอขอความยินยอม OAuth
- เปิดใช้และกำหนดค่า Google Chat API โดยใช้ชื่อ ไอคอนและคำอธิบายสำหรับแอป Chat ของคุณ
-
สร้างข้อมูลเข้าสู่ระบบรหัสไคลเอ็นต์ OAuth สำหรับแอปพลิเคชันบนเดสก์ท็อป หากต้องการเรียกใช้ตัวอย่างใน
ให้บันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
client_secrets.json
ลงในไฟล์ ไดเรกทอรีในเครื่อง
- เลือกขอบเขตการให้สิทธิ์ที่รองรับการตรวจสอบสิทธิ์ผู้ใช้
ดูรายละเอียดเกี่ยวกับกิจกรรมในพื้นที่ทำงาน
หากต้องการดูรายละเอียดเกี่ยวกับ 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
พร้อมรายละเอียดเกี่ยวกับกิจกรรม