บริการเหตุการณ์ของ Google Workspace ขั้นสูงช่วยให้คุณใช้ Google Workspace Events API ใน Apps Script ได้ API นี้ช่วยให้คุณสามารถสมัครใช้บริการทรัพยากรของ Google Workspace เพื่อรับกิจกรรมที่เกี่ยวข้องซึ่งคุณสนใจ เหตุการณ์แสดงถึงการเปลี่ยนแปลงของทรัพยากร เช่น เมื่อมีการสร้าง อัปเดต หรือลบทรัพยากร
ข้อกำหนดเบื้องต้น
- โปรเจ็กต์ Apps Script ที่ใช้โปรเจ็กต์ Google Cloud มาตรฐานแทนโปรเจ็กต์เริ่มต้นที่ Apps Script สร้างขึ้นโดยอัตโนมัติ
- หัวข้อ Pub/Sub ที่สร้างขึ้นในโปรเจ็กต์ Google Cloud เดียวกันเพื่อรับเหตุการณ์การสมัครใช้บริการ หากต้องการสร้างหัวข้อ Pub/Sub โปรดดูที่สร้างและสมัครรับข้อมูลหัวข้อ Pub/Sub
- หากต้องการสมัครใช้บริการกิจกรรมใน Chat คุณต้องกำหนดค่าแอป Google Chat ไว้ในหน้าการกำหนดค่า Chat API ในคอนโซล Google Cloud หากต้องการสร้างแอป Google Chat โปรดดูหัวข้อสร้างแอป Google Chat ด้วย Apps Script
เพิ่มขอบเขตการให้สิทธิ์ที่จำเป็นลงในไฟล์
appsscript.json
ของโปรเจ็กต์ Apps Script แล้ว ขอบเขตที่จำเป็นจะขึ้นอยู่กับประเภททรัพยากรและเหตุการณ์เป้าหมายของการสมัครใช้บริการ โปรดดูรายละเอียดที่หัวข้อ เลือกขอบเขต Google Workspace Events API เช่น"oauthScopes": [ "https://www.googleapis.com/auth/chat.messages.readonly" ]
ข้อมูลอ้างอิง
โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับบริการนี้ในเอกสารอ้างอิง Google Workspace Events API บริการเหตุการณ์ Google Workspace ใช้ออบเจ็กต์ เมธอด และพารามิเตอร์เดียวกันกับ API สาธารณะ เช่นเดียวกับบริการขั้นสูงทั้งหมดใน Apps Script
รหัสตัวอย่าง
ตัวอย่างเหล่านี้จะแสดงวิธีดำเนินการทั่วไปกับ Google Workspace Events API โดยใช้บริการขั้นสูง
สร้างการสมัครใช้บริการ
หากต้องการสร้างการสมัครใช้บริการทรัพยากร Google Workspace ให้เพิ่มฟังก์ชันต่อไปนี้ลงในโค้ดของโปรเจ็กต์ Apps Script
แสดงรายการการสมัครใช้บริการ
หากต้องการแสดงการสมัครใช้บริการที่กรองตามประเภทเหตุการณ์และทรัพยากรเป้าหมาย ให้เพิ่มฟังก์ชันต่อไปนี้ลงในโค้ดของโปรเจ็กต์ Apps Script
รับการสมัครใช้บริการ
หากต้องการดูข้อมูลเกี่ยวกับการสมัครใช้บริการ ให้เพิ่มฟังก์ชันต่อไปนี้ในโค้ดของโปรเจ็กต์ Apps Script
อัปเดตการสมัครใช้บริการ
หากต้องการอัปเดตหรือต่ออายุการสมัครใช้บริการ ให้เพิ่มฟังก์ชันต่อไปนี้ลงในโค้ดของโปรเจ็กต์ Apps Script
เปิดใช้งานการสมัครใช้บริการอีกครั้ง
หากต้องการเปิดใช้งานการสมัครใช้บริการอีกครั้ง ให้เพิ่มฟังก์ชันต่อไปนี้ลงในโค้ดของโปรเจ็กต์ Apps Script
ลบการสมัครใช้บริการ
หากต้องการลบการสมัครใช้บริการ ให้เพิ่มฟังก์ชันต่อไปนี้ลงในโค้ดของโปรเจ็กต์ Apps Script
รับการดำเนินงาน
เมธอดของ Google Workspace Events API ส่วนใหญ่จะแสดงการดำเนินการที่ใช้เวลานาน
หากต้องการระบุสถานะของการดำเนินการ ให้ใช้เมธอด operations.get()
หากต้องการดูข้อมูลเกี่ยวกับการดำเนินการ ให้เพิ่มฟังก์ชันต่อไปนี้ลงในโค้ดของโปรเจ็กต์ Apps Script
หากต้องการทราบชื่อของการดำเนินการ ให้ใช้ค่าจากช่อง name
ที่แสดงจากเมธอดของ Google Workspace Event API รายการใดรายการหนึ่ง เช่น subscriptions.create()
หรือ subscriptions.patch()